Skip to main content
POST
Importar nota fiscal.

Authorizations

Authorization
string
header
required

Cabeçalho de autenticação Bearer no formato Bearer <token> onde <token> é seu TOKEN de autenticação

Headers

Idempotency-Key
string<uuid>

Chave de idempotência para requisições de criação/alteração (POST). Recomendada para /v1/order, /v1/order/invoice e /v1/order/start-cdc-sale.

Use um identificador único por tentativa lógica de operação (ex.: um UUID gerado pelo seu sistema antes de chamar a API). Reenviar a mesma chave com o mesmo corpo de requisição, dentro de 24 horas, retorna a resposta original em vez de repetir a operação — útil para reintentar com segurança após timeout ou erro de rede.

Reenviar a mesma chave com um corpo de requisição diferente retorna 409 Conflict. Uma segunda requisição com a mesma chave enquanto a primeira ainda está em processamento também retorna 409 Conflict.

CorrelationId
string

Identificador de correlação da requisição, usado para rastreamento em logs e suporte. Se não for enviado, a API gera um novo automaticamente.

O valor é sempre devolvido no cabeçalho de resposta CorrelationId e também no campo correlationId do corpo, em respostas de erro (ProblemDetails).

Body

application/json
pedidoId
string<uuid>
required

Identificador do pedido.

Example:

"00000000-0000-0000-0000-000000000000"

arquivoBase64
string
required

Conteúdo do arquivo da nota fiscal codificado em base64.

Minimum string length: 1
Example:

"JVBERi0xLjQKJeLjz9MKMSAwIG9iago..."

nomeArquivo
string
required

Nome do arquivo com extensão (ex: nota-fiscal.pdf).

Minimum string length: 1
Example:

"nota-fiscal.pdf"

Response

Nota fiscal importada com sucesso.