Recebimento de notificações
Opiniões sobre um produto
Publica produtos
Imagens nos anúncios
Análise e Benchmarking
Atualização das regras tributárias
Consulta das regras tributárias
Envio das mensagens de operação
Onboarding fulfillment
Fazendo o OPT-IN
Recebendo notificações
Trabalhar com reclamações
Trabalhar com Devoluções
Gerenciamento de moderações
Gerenciar descontos
Mensagens de pós venda
Mocks para mensagens por vendas de itens com FULL
Status de pedidos ME1
Convivência ME1/ME2
Guia para usuários avançados
Preditor de categorias
Dump de categorías
Guia para carrinho de compras
Gerenciamento de Ordens de Carrinho
Alguns eventos são produzidos apenas do lado do Mercado Livre e a única forma de conhecê-los é através de notificações. Com as notificações você terá um feed em tempo real das mudanças produzidas nos diferentes recursos da nossa API. Por exemplo, se você anunciou um item e mais tarde decidiu pausá-lo, se alguém formulou alguma pergunta, se compraram um item ou até se pagaram e/ou solicitaram o envio. Uma maneira eficiente sem ter que consultar permanentemente nossa API!
Topics Disponíveis
Quais eventos disparam notificações?
Acesso aos detalhes
API do histórico dos feeds
Se quiser começar a receber notificações, você deverá acessar seu gerenciador de aplicativos, onde você criou seu aplicativo pela primeira vez, editar os detalhes especificando quais são os topics que você receberá.
Aclaração: Caso você ainda não tenha criado seu aplicativo, acesse seção Criar a sua aplicação.
URL de retorno de chamada de notificação – Configure a URL pública do domínio onde você quer receber notificações sobre os diversos tópicos. Por exemplo: "http://myapp.com/notifications"
Tópicos: Selecione dentre os diferentes tópicos para receber notificações.
Nota: Tenha em conta que os topics orders, created_orders, payments e messages não são utilizados para imóveis, serviços e automóveis.
items - Você receberá notificações sobre qualquer mudança em um item que tiver publicado.
orders - Você receberá notificações a partir da criação e alterações realizadas em alguma de suas vendas confirmadas.
created_orders - Você receberá notificações de suas vendas recentemente criadas quando entram pelo fluxo do Mercado Pago obrigatório. Você só vai obter dados do produto e quantidade de unidades, pois a compra ainda não foi confirmada. Não deve realizar qualquer ação até não passar para "paid". Serve apenas para reserva de estoque, pois se o comprador finalmente pagar mas o item não tiver estoque, o pagamento será automaticamente devolvido e a venda cancelada.
Nota: Quando a ordem for paga, as notificações começarão a ser enviadas também a partir de "orders", portanto, sugerimos escolher apenas um dos topics para evitar eventos duplicados.
questions- Você receberá notificações de perguntas e respostas feitas.
payments- Você receberá notificações quando um pagamento for criado em uma ordem ou o status dela mudar.
pictures– Você somente receberá notificações das imagens que, por causa de algum erro, não estiverem disponíveis para download.
Nota: Ao mesmo tempo, será enviado um email automático para o vendedor, reunindo as imagens com problemas.
messages – Você receberá notificações sobre novas mensagens geradas com seu user_id como destinatário.
orders_v2 -Você receberá notificações a partir da criação e alterações realizadas em alguma de suas vendas confirmadas. (recomendável).
shipments – Você receberá notificações a partir da criação e alterações realizadas nos envios (shippings) de suas vendas confirmadas.
quotations - Você receberá notificações referente a cotações que ocorram nas publicações (aplicável apenas para integração de imóveis).
invoices – Você receberá notificações referente a invoices geradas (notas fiscais) através do faturamento automático feito pelo mercadolivre (aplicável somente a quem trabalha com o faturamento com mercado envios full).
claims – Você receberá notificações referente a reclamações que sejam feitas referente às vendas (Trabalhar com reclamações).
Aclaração:
Quando a ordem for paga, as notificações começarão a ser enviadas também a partir de "orders", portanto, sugerimos escolher apenas um dos topics para evitar eventos duplicados.
questions – Você receberá notificações de perguntas e respontas feitas.
pictures – Você somente receberá notificações das imagens que, por causa de algum erro, não estiverem disponíveis para download.
Ao mesmo tempo, será enviado um email automático para o vendedor, reunindo as imagens com problemas.
Tenha em conta que toda e qualquer mudança que houver no Json, em qualquer tópico, serão disparadas as notificações correspondentes às estas.
É importante que sempre escute as notificações e, em seguida, faça-se a consulta no recurso correspondente para verificar se há alguma mudança em relação à sua aplicação, pois as mudanças podem ocorrer também de outras fontes, como ação via front, Seller Central ou outras aplicações, etc.
As mensagens serão enviadas e novas tentativas de envio serão feitas durante um intervalo de 12 horas. Depois desse período, se não forem aceitas pelo aplicativo, elas serão excluídas.
Enviaremos um POST a sua URL, portanto, seu aplicativo deverá confirmar o recebimento com um código de status HTTP 200, caso contrário, a mensagem será considerada não entregue e haverá uma nova tentativa de envio.
Seu aplicativo deverá enviar uma resposta em 20 segundos, caso contrário, o tempo limite será atingido a notificação será considerada como não entregue e haverá uma nova tentativa de envio.
Depois de receber uma notificação sobre um tópico, você deverá fazer uma solicitação GET ao recurso para acessar os detalhes e, depois, se tiver salvado o JSON anterior, deverá comparar os dois.
Com essas informações, você poderá realizar um GET para o recurso de items:
curl -X GET https://api.mercadolibre.com/items/$ITEM_ID?access_token=$ACCESS_TOKEN
orders e created_orders
Com essas informações, você poderá realizar um GET para o recurso de orders e created_orders:
curl -X GET https://api.mercadolibre.com/orders/$ORDER_ID?access_token=$ACCESS_TOKEN
Com essas informações, você poderá realizar um GET para o recurso questions:
curl -X GET https://api.mercadolibre.com/questions/$QUESTION_ID?access_token=$ACCESS_TOKEN
Com essas informações, você poderá realizar um GET para o recurso picture:
curl -X GET https://api.mercadolibre.com/pictures/$PICTURE_ID/errors?access_token=$ACCESS_TOKEN
Você terá que identificar por que a imagem não foi corretamente processada. Ver "Considerações e melhores práticas para trabalhar com imagéns".
Um registro de seu histórico de notificações é salvo, e você pode acessá-lo a qualquer momento chamando nosso recurso feeds. Exemplo:
curl -X GET https://api.mercadolibre.com/myfeeds?app_id=$APP_ID&access_token=$ACCESS_TOKEN
Nota: Lembre que, por default, só serão mostradas 10 notificações, porém, você pode utilizar LIMIT e OFFSET para modificar o número que quer receber, como mostrado abaixo: