[INTERNO] Disponibilização notas fiscais fulfillment – Mercado Livre

    Uma vez consumidas e armazenadas as notas do fulfillment do Mercado Livre, chegamos à etapa final do fluxo, que se trata da disponibilização ao sistema do seller. Esse processo também ocorrerá de acordo com o tipo da nota assim como o armazenamento interno, sendo necessário a divisão entre as notas de vendas e notas de transporte de mercadorias:

1 - Notas de vendas

    Assim que as notas são armazenadas em nosso banco de dados conforme descrito no artigo [INTERNO] Armazenamento de notas fiscais Fulfillment - Mercado Livre, precisamos comunicar o seller sobre a existência delas. Notas de vendas o Meli além da notificação que informa sobre o documento,  também notificará sobre a atualização de status do pedido, portanto a disponibilização a call-back do seller será feita com base nessa mudança de status, assim sendo, podemos disparar uma notificação a call-back do seller ou incluir o pedido sobre o feed. Sobre o menu Configuração -> Parâmetros -> Notificações, tais métodos, feed ou call-back, deverão ter habilitado as notificações de atualização de status, em especial Faturado e Cancelado, para recebimento das notas de vendas autorizadas e canceladas:

Exemplo de configuração de call-back:

Exemplo de configuração de Feed:

Tal disponibilização, seja por feed ou call-back, será feita através do ID do pedido no ANY, desta forma para validar se foi disponibilizado ou não, seguimos o fluxo padrão já conhecido de ERP/PLATAFORMAS ativos com o ANY.  Em seguida o backoffice do seller realizará a consulta sobre o pedido em nossa API e poderá extrair a nota fiscal do campo InvoiceLink ou sobre o metadata no campo nfe_xml_sale.

2 -Notas de transporte de mercadorias

    Diferentemente das notas de vendas, essas não dependem de uma notificação do Meli sobre status, bem como a única forma possível de disponibilização é através da call-back, ou seja, o seller obrigatoriamente deverá cadastrar uma webhook caso deseje consumir esses arquivos. A configuração desta deve possuir as seguintes opções habilitadas:

    A notificação a call-back pode ser encontrada através do id da tabela mercado_livre_inbound_nfe em que a nota foi a armazenada, por exemplo:

1. A nota de identificador 2374620819 foi disponibilizada pelo Meli e armazenamos:

   SELECT * FROM mercado_livre_inbound_nfe mlin WHERE number_doc = '2374620819';

   
   

2. A notificação a call-back pode ser encontrada pesquisando sobre o logstash com o ID indicado pela flecha no print anterior, exemplo:
   
   11883941 AND "Push Delivered"
   
   
   Nota-se que o modelo de notificação (TYPE) para esse tipo de nota passa a ser INVOICE, diferentemente de notificações de atualizações de status de pedidos, que são do tipo ORDER.

   
   

    Por fim, o backoffice do seller poderá realizar o consumo dessa nota através do acionamento do endpoint /orders/{id}/inbound/marketplace/{marketplace}, conforme orientado em nossa documentação:

    https://developers.anymarket.com.br/api/v2/5a1cbfe1cc917-orders-id-inbound-marketplace-marketplace

    
    Fluxograma demonstrativo: