Consulta de status da Importação
Status de Publicação
Depois da importação, os anúncios vão para a fila de importação da OLX para serem processados. Essa consulta retorna a confirmação de inserção do anúncio com sucesso, bem como informa e detalha um eventual erro no processo de importação de um anúncio.
Essa consulta de importação, lembrando que é o status daquela versão do anúncio por importação, ou seja, para uma atualização feita do anuncio, é criado um outro token. Caso o cliente OLX faça uma deleção ou alteração na OLX, não será refletido no mesmo token. Utilize a Consulta do status de Anúncios Publicados
Requisição de Status
A URL usada para fazer a requisição do arquivo JSON: https://apps.olx.com.br/autoupload/import/{token}. O token a ser inserido no final da URL é o retorno mencionado na importação.
A requisição feita para esta URL deve conter o access_token de cada anunciante, usando o método POST:
{
"access_token": "37812426ab5961d8a029b224b8e1288e192062ef"
}
Retorno Esperado
O formato do retorno de nosso servidor será do tipo JSON, que contém a seguinte estrutura:
| Parâmetro | Valores | Descrição |
|---|---|---|
autoupload_status | done, pending | Retorna o status dos anúncios. done: todos os anúncios foram processados (inseridos ou deletados) pending: Pelo menos um anúncio ainda está na fila de importação |
ads | array[] | Este parâmetro detalha o resultado de publicação de determinado anúncio, seguindo a descrição da tabela abaixo. |
A tabela abaixo detalha o retorno do parâmetro ads, que de fato explica o que houve com o anúncio em si:
| Parâmetro | Valores | Descrição |
|---|---|---|
status | pending, error, queued, accepted, refused | Retorna o status dos anúncios.pending: o anúncio será processado.error: o anúncio está com erro(s).queued: o anúncio foi inserido e será ativado em breveaccepted: o anúncio foi ativado. Caso a operação seja de deleção, significa que o anúncio foi deletado.refused: o anúncio não foi ativado |
operation | insert, delete | Operação utilizadainsert: inserção de anúnciodelete: deleção de anúncio |
message | Exemplos: ERROR_IMAGE_TOO_SMALL,ERROR_DOWNLOADING_IMAGE,ERROR_UPLOADING_IMAGE,NOT_ENOUGH_AD_SLOTS,REFUSED_SUSPECT_CATEGORY,REFUSED_SUSPECT_REGION,REFUSED_DENOUNCE,REFUSED_SUSPECT_AUTOS,REFUSED_SUSPECT_DUPLICATES,REFUSED_GENERIC | Mensagens de aviso sobre erros ocorridos |
list_id | string | Retorna o id do seu anúncio, caso o mesmo tenha sido aprovado 1 |
url | string | Url do anúncio gerada Olx2 |
imageErrors  | array | Array contendo informações de erros de processamento de imagens. Este campo aparece apenas quando houve erro(s) no processamento de imagens. Cada item contém: imageUrl (URL da imagem), status (ERROR, ERROR_DOWNLOADING_IMAGE ou ERROR_UPLOADING_IMAGE), errorMessage (detalhes do erro; campos podem vir nulos), processedAt (timestamp do processamento) 3 |
1 ATENÇÃO, é uma sugestão de armazenar esse campo list_id qualquer outra funcionalidade por API é o valor a ser utilizado.
2 Para um anúncio novo, a url é gerada porém pode levar alguns minutos para aparecer no site.
3 Este campo aparece apenas quando há erros no processamento de imagens (download, upload ou erro genérico de processamento). No objeto errorMessage, os campos statusCode e contentError podem vir null em alguns cenários.
Exemplos de retorno:
Para um anúncio inserido ou editado, que ainda não entrou na fila de ativação:
{
"autoupload_status": "pending",
"ads": {
"1111111111": {
"status": "pending",
"operation": "insert"
}
}
}
Para um anúncio editado antes de ter sido ativado:
{
"autoupload_status": "pending",
"ads": {
"1111111111": {
"status": "queued",
"operation": "edit",
"list_id": "8000000",
"message": []
}
}
}
Para anúncio inserido e aguardando ativação:
{
"autoupload_status": "pending",
"ads": {
"1111111111": {
"status": "queued",
"operation": "insert",
"message": []
}
}
}
Para um anúncio inserido com sucesso:
{
"autoupload_status": "done",
"ads": {
"1111111111": {
"status": "accepted",
"operation": "insert",
"message": [],
"url": "http://www.olx.com.br/vi/8000005.htm"
}
}
}
Para um anúncio que não foi inserido por algum motivo:
{
"autoupload_status": "done",
"ads": {
"1111111111": {
"status": "refused",
"operation": "insert",
"message": [
{
"error": "REFUSED_SUSPECT_PRICE"
}
]
}
}
}
Para um anúncio editado com sucesso:
{
"autoupload_status": "done",
"ads": {
"1111111111": {
"status": "accept",
"operation": "edit",
"list_id": "8000000",
"message": [],
"url": "http://www.olx.com.br/vi/8000005.htm"
}
}
}
Para um anúncio que teve uma edição recusada:
{
"autoupload_status": "done",
"ads": {
"1111111111": {
"status": "refused",
"operation": "edit",
"message": [
{
"error": "REFUSED_SUSPECT_DUPLICATES"
}
]
}
}
}
Para um anúncio removido com sucesso:
{
"autoupload_status": "done",
"ads": {
"1111111111": {
"status": "accepted",
"operation": "delete",
"message": []
}
}
}
Anúncio com Erros de Processamento de Imagem
{
"autoupload_status": "done",
"ads": {
"1111111111": {
"status": "accepted",
"operation": "insert",
"message": [],
"url": "https://www.olx.com.br/vi/1234.htm",
"list_id": "1234",
"image_errors": [
{
"image_url": "https://exemplo.com/imagem1.jpg",
"status": "ERROR_DOWNLOADING_IMAGE",
"error_message": {
"status": "ERROR_DOWNLOADING_IMAGE",
"status_code": 404,
"content_error": "Image not found"
},
"processed_at": "2024-07-05T11:08:25.000Z"
},
{
"image_url": "https://exemplo.com/imagem2.jpg",
"status": "ERROR_UPLOADING_IMAGE",
"error_message": {
"status": "ERROR_UPLOADING_IMAGE",
"status_code": 500,
"content_error": "Upload failed"
},
"processed_at": "2024-07-05T11:08:26.000Z"
}
]
}
}
}