Como enviar nota fiscal para a Via Varejo via API e qual é o formato aceito?

Quando você tenta enviar uma Nota Fiscal para a Via Varejo através da API do ANYMARKET, a requisição pode ser rejeitada se o formato utilizado não for compatível com o esperado pelo endpoint. A Via Varejo aceita exclusivamente o formato JSON para o envio de dados de faturamento. Este artigo orienta você sobre o formato correto e como resolver problemas de envio.

Neste artigo:

• Entendendo o cenário
• Como resolver passo a passo
• Pontos de atenção
• Referências

Entendendo o cenário

Quando você tenta enviar uma Nota Fiscal para a Via Varejo através da API do ANYMARKET, a requisição é rejeitada porque o formato utilizado não é compatível com o esperado pelo endpoint. A Via Varejo aceita exclusivamente o formato JSON para o envio de dados de faturamento, e qualquer tentativa de utilizar outro formato (como XML) resultará em erro na transmissão.

Cada marketplace define seus próprios padrões técnicos de integração. A Via Varejo foi configurada para receber informações de faturamento apenas no formato JSON através da API do ANYMARKET. O formato JSON é uma estrutura de dados leve e amplamente utilizada em integrações web, diferente do XML, que possui uma estrutura mais complexa.

Quando você envia os dados de Nota Fiscal para a Via Varejo, o ANYMARKET realiza uma requisição PUT (método HTTP para atualizar dados) no endpoint específico da API. Se o corpo dessa requisição não estiver formatado em JSON, a Via Varejo rejeita a comunicação, impedindo que a Nota Fiscal seja registrada no pedido.

Como resolver passo a passo

1. Acesse a documentação da API do ANYMARKET para o endpoint de faturamento:
   • Utilize a URL: https://developers.anymarket.com.br/api/v2/fxdj30l5v5nrh-orders-id-faturado (substitua id pelo identificador do pedido que deseja faturar)
2. Prepare os dados da Nota Fiscal no formato JSON:
   • Estruture as informações necessárias (chave da Nota Fiscal, série, número, data de emissão, valor, entre outros) seguindo o padrão JSON
   • Certifique-se de que a chave da Nota Fiscal está corrigida e sem espaçamentos
3. Envie a requisição PUT com o corpo em JSON:
   • Configure o método HTTP como PUT
   • Adicione os dados formatados em JSON no corpo da requisição
   • Inclua os headers necessários (como autenticação e tipo de conteúdo: application/json)
4. Valide a resposta da API:
   • Se o envio for bem-sucedido, você receberá uma confirmação do ANYMARKET
   • A Nota Fiscal será transmitida à Via Varejo e associada ao pedido

Pontos de atenção

• A Via Varejo não aceita XML para envio de Nota Fiscal via API — utilize exclusivamente JSON
• Certifique-se de que a chave da Nota Fiscal não possui espaçamentos antes de enviar — ela deve estar contínua e sem formatação
• Se você estiver utilizando um ERP integrado ao ANYMARKET, verifique se há uma opção de faturamento automático que possa simplificar esse processo
• Sempre valide os dados antes de enviar para evitar rejeições desnecessárias
• Teste agora o envio com o formato JSON correto e, se encontrar dificuldades técnicas na requisição, entre em contato com o suporte para validar a estrutura dos dados que você está enviando

Referências

• Documentação da API do ANYMARKET