Como reenviar o XML da nota para a Amazon? – Página inicial

Este artigo interno explica como reenviar o XML da nota fiscal para a Amazon quando uma nota é recusada pelo marketplace ou quando é necessário reenviar o XML já registrado no ANYMARKET.

Algumas notas podem ser recusadas pela Amazon por diferentes motivos, como dados incorretos no XML, inconsistência fiscal ou instabilidade temporária na SEFAZ. Nesses cenários, é possível realizar ajustes internos para que o ANYMARKET reenvie o XML ao marketplace.

Neste artigo:

Pré-requisitos
Como funciona o reenvio do XML para a Amazon
Passo a passo para reenviar o XML
Boas práticas
Dúvidas comuns

Pré-requisitos

Antes de iniciar o procedimento, valide se:

O pedido é da Amazon;
A nota fiscal foi recusada pelo marketplace ou precisa ser reenviada;
Você possui acesso à ferramenta interna de suporte;
Você possui o ID do pedido no ANYMARKET;
Você possui o gumgaToken necessário para realizar as chamadas internas;
Você possui o XML correto da nota fiscal ou consegue localizar o XML já enviado anteriormente no Kibana;
Você possui acesso ao Kibana para validar o reenvio.

Importante: este é um procedimento interno e deve ser executado apenas por pessoas autorizadas.

Como funciona o reenvio do XML para a Amazon

Para que o ANYMARKET reenvie o XML da nota fiscal para a Amazon, não basta alterar apenas o status do pedido no ANYMARKET.

O fluxo exige dois ajustes antes do reenvio do XML:

Alterar o status_order do pedido para Pago pela ferramenta interna de suporte;
Alterar o campo status_in_marketplace para pago pela API interna.

Após esses ajustes, o XML deve ser reenviado pelo endpoint de NF-e do pedido. Com isso, o ANYMARKET fará uma nova chamada para a API da Amazon, reenviando o XML ao marketplace.

Passo a passo para reenviar o XML

1. Alterar o status do pedido no ANYMARKET para Pago

O primeiro passo é alterar o status_order do pedido para Pago por meio da ferramenta interna de suporte.

Após essa alteração, o status do pedido no marketplace ainda poderá permanecer como Faturado. Por isso, também será necessário atualizar o campo status_in_marketplace.

2. Alterar o statusInMarketplace pela API

Para ajustar o status no marketplace, utilize a chamada abaixo, informando o ID do pedido e o gumgaToken:

curl --location --request PUT 'http://api.anymarket.com.br/v2/orders/{id}/transmissionStatus' \
--header 'gumgaToken: {gumgaToken}' \
--header 'Content-Type: application/json' \
--data '{
  "transmissionStatus": "OK",
  "errorMsg": "",
  "orderMessage": null,
  "statusInMarketplace": "pago"
}'

Essa chamada atualiza o campo statusInMarketplace para pago, permitindo que o fluxo de reenvio do XML seja executado corretamente.

3. Obter o XML da nota fiscal

Após realizar os ajustes de status, será necessário ter o XML da nota fiscal.

Existem dois cenários possíveis:

XML corrigido: se o caso envolve correção do XML, solicite ao cliente o arquivo corrigido;
Reenvio do mesmo XML: se for apenas um reenvio do XML já registrado, localize o conteúdo no Kibana.

Para localizar o XML já enviado, busque pelo ID do pedido no Kibana, utilizando input v2oi ou input, conforme o ERP.

Localize uma chamada PUT para:

/v2/orders/{id}/nfe

Copie o conteúdo do request dessa requisição para reenviar o XML.

4. Reenviar o XML pela API

Com o XML em mãos, refaça a chamada via Postman ou ferramenta equivalente:

curl --location --globoff --request PUT 'http://api.anymarket.com.br/v2/orders/{id}/nfe' \
--header 'gumgaToken: {gumgaToken}' \
--header 'Content-Type: application/xml' \
--data '{conteudo_xml}'

Após essa chamada, o ANYMARKET atualizará o XML no pedido e fará o reenvio para a Amazon.

5. Validar o reenvio para a Amazon

Após a atualização do XML, o ANYMARKET fará uma chamada para a API da Amazon.

Para localizar essa chamada no Kibana, busque pelo:

ID do pedido no marketplace; ou
shipment id.

Ao localizar essa chamada, você terá a confirmação de que o XML foi reenviado ao marketplace.

Boas práticas

Confirme o motivo da recusa da nota antes de reenviar o XML.
Se houver erro no XML, solicite ao cliente o arquivo corrigido antes de reenviar.
Altere o status_order para Pago antes de atualizar o statusInMarketplace.
Atualize o statusInMarketplace para pago antes de reenviar o XML.
Ao recuperar o XML no Kibana, confira se o conteúdo pertence ao pedido correto.
Use o endpoint /v2/orders/{id}/nfe somente com o XML correto.
Após o PUT do XML, valide no Kibana se houve chamada para a API da Amazon.
Não exponha tokens em prints, artigos públicos ou registros compartilhados fora do ambiente autorizado.

Dúvidas comuns

Quando devo reenviar o XML da nota para a Amazon?
Quando a nota for recusada pela Amazon por inconsistência no XML, dados incorretos, instabilidade da SEFAZ ou quando for necessário reenviar o XML já registrado no ANYMARKET.

Apenas alterar o status do pedido para Pago reenvia o XML?
Não. Além de alterar o status_order para Pago, é necessário alterar o campo statusInMarketplace para pago.

Qual endpoint atualiza o statusInMarketplace?
Use o endpoint /v2/orders/{id}/transmissionStatus, enviando "statusInMarketplace": "pago" no body.

Qual endpoint reenvia o XML da NF-e?
Use o endpoint /v2/orders/{id}/nfe com o header Content-Type: application/xml.

De onde obtenho o XML para reenvio?
Se o XML foi corrigido, o cliente deve enviar o arquivo. Se for apenas reenvio, localize o XML no Kibana, buscando pelo ID do pedido e pela chamada PUT /v2/orders/{id}/nfe.

Como confirmo que o XML foi reenviado para a Amazon?
Após reenviar o XML, busque no Kibana pelo ID do pedido no marketplace ou pelo shipment id e valide a chamada realizada para a API da Amazon.

Posso usar o mesmo XML já enviado anteriormente?
Sim, desde que o XML esteja correto e a necessidade seja apenas reenviar o arquivo ao marketplace.

O que fazer se o XML anterior estava incorreto?
Solicite ao cliente o XML corrigido e utilize esse novo conteúdo no PUT para /v2/orders/{id}/nfe.

Esse procedimento pode ser feito por qualquer usuário?
Não. Este é um procedimento interno e deve ser executado apenas por pessoas autorizadas, com acesso às ferramentas internas, API e Kibana.

Relativo a