Envio de Nota Fiscal (PDF ou XML)

Este endpoint permite registrar a nota fiscal em um pacote do pedido e enviar o documento ao Marketplace. O endpoint não retorna body na resposta (void).

Documentação da API: /orders/{id}/fiscalDocument

Parâmetros

Parâmetro	Tipo	Obrigatoriedade	Descrição
id (path)	Long	Obrigatório	ID do pedido no ANYMARKET.
packageId (query)	UUID	Obrigatório quando o pedido possui pacotes; não deve ser informado quando o pedido não possui pacotes	Identificador do pacote do pedido ao qual a nota fiscal pertence.

Body (multipart/form-data)

Campo	Tipo	Obrigatoriedade	Descrição
file	File (PDF ou XML)	Obrigatório	Arquivo da nota fiscal.
number	String	Obrigatório	Número da nota fiscal.
date	String (ISO 8601)	Obrigatório	Data de emissão. Ex: 2026-05-05T10:00:00-03:00.
accessKey	String	Opcional	Chave de acesso da NF-e.
series	String	Opcional	Série da nota fiscal.
cfop	String	Opcional	Código Fiscal de Operações e Prestações.
companyStateTaxId	String	Opcional	Inscrição estadual da empresa emissora.
linkNfe	String	Opcional	URL para consulta da NF-e.
invoiceLink	String	Opcional	URL onde está armazenado o PDF ou XML da nota fiscal.
extraDescription	String	Opcional	Campo para observações.
operationType	String	Opcional	Tipo de operação fiscal.
emissionType	String	Opcional	Tipo de emissão da nota fiscal.
authorizationProtocol	String	Opcional	Protocolo de autorização da nota fiscal.
origin	String	Opcional	Responsável pela persistência da nota fiscal no armazenador de arquivo fiscal document. Valores: ORIGIN_ERP, ORIGIN_MARKETPLACE, UNKNOW. Quando não informado, o valor padrão é UNKNOW.

Importante: Pacotes faturados se tornam imutáveis — não podem ser editados, excluídos ou cancelados.

Códigos de retorno

Código	Descrição
200	NF registrada com sucesso no pacote.
400	packageId obrigatório — pedido possui pacotes e a requisição não informou packageId.
400	PACKAGE_ALREADY_INVOICED — pacote informado já possui NF associada.

Em caso de falha

Existem alguns casos, que o envio do documento não é aceito.

Caso seja retornado um erro 400 ao enviar o documento, será necessário realizar a atualização do status do Pedido para Faturado utilizando o endpoint normal JSON através /orders/{id}