Pular para o conteúdo principal

Envio de XML

Em alguns cenários de atualização do Pedido para Faturado, os Marketplaces necessitam que seja enviado o XML na atualização do Status do Pedido.

Como identificar um pedido que precisa de XML para o Mercado Livre?​

Ao consultar os detalhes do pedido, o seguinte campo constará no JSON, dentro do objeto metadata: needInvoiceXML: true

Exemplo:

{
  ...
    "metadata": {
        "needInvoiceXML": "true"
        ...
    }
  ...
}

Sobre o envio do XML: /orders/{id}/nfe

Ao realizar o envio do XML no endpoint acima, o pedido é atualizado para Faturado com os dados da nota. Não é preciso enviar as informações dos dados da nota através de JSON.

Em caso de falha​

Existem alguns casos, no Mercado Livre, em que o envio do XML é opcional e o campo é retornado ao ANYMARKET como um falso positivo. O campo constará no pedido como "needInvoiceXML: true", porém não aceitará o XML.

Caso seja retornado um erro 400 ao enviar o XML, por exemplo: "O Mercado Livre não permite o envio do XML da nota fiscal para a seguinte combinação de status e substatus do shipment do pedido no Mercado Livre", será necessário realizar a atualização do status do Pedido para Faturado utilizando o endpoint normal JSON através de /orders/{id}

Como identificar um pedido que precisa de XML para a B2W?​

Só é necessário enviar o XML para a B2W no formato B2W Direct.

Ao consultar os detalhes do pedido, o seguinte campo constará no JSON: B2WshippingType: "b2wentregadirect"

Para o cenário de impressão de etiqueta: caso precise alterar o número de volumes, antes de enviar o XML, é necessário realizar um PUT no endpoint /v2/orders/{Orderid}, alterando o valor do campo number-of-packages.

  • Exemplo: {"metadata":{"number-of-packages":"2"}}

Como identificar um pedido que precisa de XML para a Dafiti?​

Ao consultar os detalhes do pedido (metadata), o seguinte campo constará no JSON: needInvoiceXML: true

Sobre o envio do XML: /orders/{id}/nfe

Ao realizar o envio do XML no endpoint acima, o pedido é atualizado para Faturado com os dados da nota. Não é preciso enviar as informações dos dados da nota através de JSON.