Envio de informações de fatura e documento fiscal do pedido pelo endpoint order/fiscalDocument

Visão Geral

A etapa de fatura de um pedido no ANYMARKET consiste em enviar ao marketplace os dados da nota fiscal e o documento fiscal correspondente (XML ou PDF). Anteriormente, esse envio exigia duas chamadas distintas à API.

Com esta evolução, o endpoint POST order/fiscalDocument passou a aceitar tanto o documento fiscal quanto os campos de dados da nota em uma única requisição, simplificando a integração entre o ERP do seller e o marketplace. O fluxo anterior continua disponível — a adoção do formato consolidado é opcional.

Pré-requisitos

• Integração ativa com o ANYMARKET via API
• Token de autenticação (gumgaToken) válido
• Pedido já existente no ANYMARKET, em status apto a ser faturado
• Documento fiscal emitido no ERP do seller (XML para NF-e no Brasil; XML ou PDF em LATAM)

Como funciona

Fluxo anterior (duas chamadas)

Até então, faturar um pedido exigia dois passos separados:

Passo 1 — Enviar os dados da nota

PUT /orders/{id};faturado

Envio dos campos da nota (número, série, chave de acesso, valores, datas etc.).

Passo 2 — Enviar o documento fiscal

POST /orders/{id}/nfe             → Brasil
POST /orders/{id}/fiscalDocument  → LATAM

Envio do arquivo XML ou PDF do documento fiscal.

Fluxo novo (chamada única — recomendado)

Agora, os dados da nota e o documento fiscal são enviados juntos, em uma só requisição multipart/form-data:

POST /orders/{orderId}/fiscalDocument?packageId=

Exemplo de chamada:

curl 'https://sandbox-api.anymarket.com.br/v2/orders/{orderId}/fiscalDocument?packageId=' \
  --request POST \
  --header 'Content-Type: multipart/form-data' \
  --header 'gumgaToken: SEU_TOKEN' \
  --form 'file=@nota.xml' \
  --form 'number=12345' \
  --form 'date=2026-08-06T10:00:00-03:00' \
  --form 'accessKey=3525XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX' \
  --form 'series=1' \
  --form 'cfop=6108' \
  --form 'companyStateTaxId=123456789' \
  --form 'linkNfe=https://...' \
  --form 'invoiceLink=https://...' \
  --form 'extraDescription=' \
  --form 'operationType=' \
  --form 'emissionType=' \
  --form 'authorizationProtocol=' \
  --form 'origin=ORIGIN_ERP'

O ANYMARKET processa o recebimento consolidado automaticamente e conclui a etapa de fatura do pedido.

Campos aceitos pelo endpoint

Além do file (documento fiscal XML ou PDF), o POST order/fiscalDocument passou a aceitar os seguintes campos de dados da nota:

Há também o parâmetro de query packageId, usado quando o pedido está dividido em pacotes.

A obrigatoriedade de cada campo pode variar por país e por marketplace. Consulte a referência técnica do endpoint para o contrato completo.

Perguntas frequentes

Preciso migrar minha integração imediatamente?
Não. O fluxo anterior (PUT order;faturado + order/nfe ou order/fiscalDocument) continua funcionando normalmente. A chamada consolidada é uma opção para reduzir esforço, não uma obrigatoriedade.

Quais dados da nota posso enviar junto com o documento fiscal?
Além do arquivo (file), o endpoint aceita os campos: number, date, accessKey, series, cfop, companyStateTaxId, linkNfe, invoiceLink, extraDescription, operationType, emissionType, authorizationProtocol e origin.

A mudança vale para Brasil e LATAM?
Sim. O endpoint POST order/fiscalDocument consolida o envio nos dois cenários. No Brasil, tipicamente com XML da NF-e; em LATAM, com XML ou PDF conforme o marketplace.

Posso continuar enviando os dados e o documento em chamadas separadas?
Pode. As duas abordagens coexistem. Você escolhe a que melhor se encaixa na sua integração.

Preciso configurar algo no painel do ANYMARKET para usar o formato consolidado?
Não. Não há configuração adicional. Basta adequar a chamada da sua integração ao novo payload.

Para que serve o parâmetro packageId?
Ele identifica o pacote quando o pedido está dividido em mais de um envio. Utilize-o quando aplicável à sua operação.

O que acontece se eu enviar os dados da nota sem o documento fiscal (ou vice-versa)?
A etapa de fatura só é concluída quando o marketplace recebe as informações necessárias. Verifique os campos obrigatórios na referência técnica para garantir que a requisição está completa.

Precisa de ajuda?

Entre em contato com o suporte ANYMARKET pelo canal de atendimento habitual, informando o número do pedido e o endpoint utilizado para agilizar a análise.