REFERÊNCIA DA API

NF-e

Notas de produtos, recebidas, CC-e e cancelamentos.

GET/homologation/nfe#

Listar documentos locais

Permissão necessária nfe:read

Parâmetros

pagequery · integer

per_pagequery · integer

searchquery · string

Respostas HTTP

200

Sucesso

Ver campos da resposta

dataarrayobrigatório

data[].idintegerobrigatório

data[].modelstringobrigatório

data[].environmentintegerobrigatório

data[].sourcestring

data[].seriesnullable

data[].numbernullable

data[].nfse_numbernullable

data[].statusstringobrigatório

data[].access_keynullable

data[].dps_idnullable

data[].recipient_namenullable

data[].recipient_documentnullable

data[].totalnullable

data[].issued_atnullable

metaobjectobrigatório

meta.pageintegerobrigatório

meta.per_pageintegerobrigatório

meta.totalintegerobrigatório

meta.last_pageintegerobrigatório

default

Erro seguro; 401/403/404/409/415/422/429/500/503. 429 inclui Retry-After.

Ver campos da resposta

errorobjectobrigatório

error.codestringobrigatório

error.messagestringobrigatório

errorsobject

curl 'https://api.nf3.app/api/v1/homologation/nfe' \
  -H 'Authorization: Bearer AQUI_VAI_A_CHAVE' \
  -H 'Accept: application/json'

Substitua os placeholders no seu servidor. Nenhuma requisição é executada aqui.

POST/homologation/nfe#

Preparar rascunho com XSD e certificado; não transmitir

Permissão necessária nfe:draft

Parâmetros

Idempotency-Keyheader · stringobrigatório

UUID obrigatório em POST/PATCH. Mesmo owner/ambiente/chave com operação ou conteúdo diferente retorna 409.

Respostas HTTP

201

Sucesso

Ver campos da resposta

dataobjectobrigatório

data.idintegerobrigatório

data.modelstringobrigatório

data.environmentintegerobrigatório

data.sourcestring

data.seriesnullable

data.numbernullable

data.nfse_numbernullable

data.statusstringobrigatório

data.access_keynullable

data.dps_idnullable

data.recipient_namenullable

data.recipient_documentnullable

data.totalnullable

data.issued_atnullable

data.reviewed_hashstring

data.reviewobject

Snapshot revisado de emitente, destinatário, serviço/itens e parâmetros, sem XML ou credenciais.

data.transmissionsarray

data.transmissions[].idintegerobrigatório

data.transmissions[].document_idintegerobrigatório

data.transmissions[].statestringobrigatório

data.transmissions[].resultnullableobrigatório

default

Erro seguro; 401/403/404/409/415/422/429/500/503. 429 inclui Retry-After.

Ver campos da resposta

errorobjectobrigatório

error.codestringobrigatório

error.messagestringobrigatório

errorsobject

curl 'https://api.nf3.app/api/v1/homologation/nfe' \
  -X POST \
  -H 'Authorization: Bearer AQUI_VAI_A_CHAVE' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: AQUI_VAI_O_UUID' \
  --data '"AQUI_VAI_O_VALOR"'

Substitua os placeholders no seu servidor. Nenhuma requisição é executada aqui.

Exemplo de estrutura: substitua IDs, valores e UUIDs pelos dados conferidos da sua operação. O portal não executa este código.

GET/homologation/nfe/{id}#

Documento e revisão local

Permissão necessária nfe:read

Parâmetros

idpath · integerobrigatório

Respostas HTTP

200

Sucesso

Ver campos da resposta

dataobjectobrigatório

data.idintegerobrigatório

data.modelstringobrigatório

data.environmentintegerobrigatório

data.sourcestring

data.seriesnullable

data.numbernullable

data.nfse_numbernullable

data.statusstringobrigatório

data.access_keynullable

data.dps_idnullable

data.recipient_namenullable

data.recipient_documentnullable

data.totalnullable

data.issued_atnullable

data.reviewed_hashstring

data.reviewobject

Snapshot revisado de emitente, destinatário, serviço/itens e parâmetros, sem XML ou credenciais.

data.transmissionsarray

data.transmissions[].idintegerobrigatório

data.transmissions[].document_idintegerobrigatório

data.transmissions[].statestringobrigatório

data.transmissions[].resultnullableobrigatório

default

Erro seguro; 401/403/404/409/415/422/429/500/503. 429 inclui Retry-After.

Ver campos da resposta

errorobjectobrigatório

error.codestringobrigatório

error.messagestringobrigatório

errorsobject

curl 'https://api.nf3.app/api/v1/homologation/nfe/{id}' \
  -H 'Authorization: Bearer AQUI_VAI_A_CHAVE' \
  -H 'Accept: application/json'

Substitua os placeholders no seu servidor. Nenhuma requisição é executada aqui.

PATCH/homologation/nfe/{id}#

Revisar NF-e ainda não enviada

Permissão necessária nfe:draft

Parâmetros

idpath · integerobrigatório

Idempotency-Keyheader · stringobrigatório

UUID obrigatório em POST/PATCH. Mesmo owner/ambiente/chave com operação ou conteúdo diferente retorna 409.

Respostas HTTP

200

Sucesso

Ver campos da resposta

dataobjectobrigatório

data.idintegerobrigatório

data.modelstringobrigatório

data.environmentintegerobrigatório

data.sourcestring

data.seriesnullable

data.numbernullable

data.nfse_numbernullable

data.statusstringobrigatório

data.access_keynullable

data.dps_idnullable

data.recipient_namenullable

data.recipient_documentnullable

data.totalnullable

data.issued_atnullable

data.reviewed_hashstring

data.reviewobject

Snapshot revisado de emitente, destinatário, serviço/itens e parâmetros, sem XML ou credenciais.

data.transmissionsarray

data.transmissions[].idintegerobrigatório

data.transmissions[].document_idintegerobrigatório

data.transmissions[].statestringobrigatório

data.transmissions[].resultnullableobrigatório

default

Erro seguro; 401/403/404/409/415/422/429/500/503. 429 inclui Retry-After.

Ver campos da resposta

errorobjectobrigatório

error.codestringobrigatório

error.messagestringobrigatório

errorsobject

curl 'https://api.nf3.app/api/v1/homologation/nfe/{id}' \
  -X PATCH \
  -H 'Authorization: Bearer AQUI_VAI_A_CHAVE' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: AQUI_VAI_O_UUID' \
  --data '"AQUI_VAI_O_VALOR"'

Substitua os placeholders no seu servidor. Nenhuma requisição é executada aqui.

Exemplo de estrutura: substitua IDs, valores e UUIDs pelos dados conferidos da sua operação. O portal não executa este código.

POST/homologation/nfe/{id}/transmissions#

Solicitar transmissão em fila

Permissão necessária nfe:transmit

Parâmetros

idpath · integerobrigatório

Idempotency-Keyheader · stringobrigatório

UUID obrigatório em POST/PATCH. Mesmo owner/ambiente/chave com operação ou conteúdo diferente retorna 409.

Corpo da requisição application/json · 2 campos

confirmedbooleanobrigatório

reviewed_hashstringobrigatório

Respostas HTTP

202

Aceito para processamento; não significa autorização fiscal.

Ver campos da resposta

dataobjectobrigatório

data.request_idintegerobrigatório

data.document_idintegerobrigatório

data.event_idinteger

default

Erro seguro; 401/403/404/409/415/422/429/500/503. 429 inclui Retry-After.

Ver campos da resposta

errorobjectobrigatório

error.codestringobrigatório

error.messagestringobrigatório

errorsobject

curl 'https://api.nf3.app/api/v1/homologation/nfe/{id}/transmissions' \
  -X POST \
  -H 'Authorization: Bearer AQUI_VAI_A_CHAVE' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: AQUI_VAI_O_UUID' \
  --data '{
  "confirmed": true,
  "reviewed_hash": "AQUI_VAI_O_VALOR"
}'

Substitua os placeholders no seu servidor. Nenhuma requisição é executada aqui.

Exemplo de estrutura: substitua IDs, valores e UUIDs pelos dados conferidos da sua operação. O portal não executa este código.

GET/homologation/nfe/{id}/transmissions#

Listar tentativas locais

Permissão necessária nfe:read

Parâmetros

idpath · integerobrigatório

Respostas HTTP

200

Sucesso

Ver campos da resposta

dataarrayobrigatório

data[].idintegerobrigatório

data[].document_idintegerobrigatório

data[].statestringobrigatório

data[].resultnullableobrigatório

default

Erro seguro; 401/403/404/409/415/422/429/500/503. 429 inclui Retry-After.

Ver campos da resposta

errorobjectobrigatório

error.codestringobrigatório

error.messagestringobrigatório

errorsobject

curl 'https://api.nf3.app/api/v1/homologation/nfe/{id}/transmissions' \
  -H 'Authorization: Bearer AQUI_VAI_A_CHAVE' \
  -H 'Accept: application/json'

Substitua os placeholders no seu servidor. Nenhuma requisição é executada aqui.

GET/homologation/nfe/{id}/transmissions/{attempt}#

Consultar tentativa local

Permissão necessária nfe:read

Parâmetros

idpath · integerobrigatório

attemptpath · integerobrigatório

Respostas HTTP

200

Sucesso

Ver campos da resposta

dataobjectobrigatório

data.idintegerobrigatório

data.document_idintegerobrigatório

data.statestringobrigatório

data.resultnullableobrigatório

default

Erro seguro; 401/403/404/409/415/422/429/500/503. 429 inclui Retry-After.

Ver campos da resposta

errorobjectobrigatório

error.codestringobrigatório

error.messagestringobrigatório

errorsobject

curl 'https://api.nf3.app/api/v1/homologation/nfe/{id}/transmissions/{attempt}' \
  -H 'Authorization: Bearer AQUI_VAI_A_CHAVE' \
  -H 'Accept: application/json'

Substitua os placeholders no seu servidor. Nenhuma requisição é executada aqui.

POST/homologation/nfe/{id}/transmissions/{attempt}/reconcile#

Consultar autorizador em fila, sem reenviar

Permissão necessária nfe:transmit

Parâmetros

idpath · integerobrigatório

attemptpath · integerobrigatório

Idempotency-Keyheader · stringobrigatório

UUID obrigatório em POST/PATCH. Mesmo owner/ambiente/chave com operação ou conteúdo diferente retorna 409.

Respostas HTTP

202

Aceito para processamento; não significa autorização fiscal.

Ver campos da resposta

dataobjectobrigatório

data.request_idintegerobrigatório

data.document_idintegerobrigatório

data.event_idinteger

default

Erro seguro; 401/403/404/409/415/422/429/500/503. 429 inclui Retry-After.

Ver campos da resposta

errorobjectobrigatório

error.codestringobrigatório

error.messagestringobrigatório

errorsobject

curl 'https://api.nf3.app/api/v1/homologation/nfe/{id}/transmissions/{attempt}/reconcile' \
  -X POST \
  -H 'Authorization: Bearer AQUI_VAI_A_CHAVE' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: AQUI_VAI_O_UUID' \
  --data '{}'

Substitua os placeholders no seu servidor. Nenhuma requisição é executada aqui.

Exemplo de estrutura: substitua IDs, valores e UUIDs pelos dados conferidos da sua operação. O portal não executa este código.

GET/homologation/nfe/{id}/xml#

Baixar arquivo local verificado

Permissão necessária nfe:read

Parâmetros

idpath · integerobrigatório

Respostas HTTP

200

Sucesso

default

Erro seguro; 401/403/404/409/415/422/429/500/503. 429 inclui Retry-After.

Ver campos da resposta

errorobjectobrigatório

error.codestringobrigatório

error.messagestringobrigatório

errorsobject

curl 'https://api.nf3.app/api/v1/homologation/nfe/{id}/xml' \
  -H 'Authorization: Bearer AQUI_VAI_A_CHAVE' \
  -H 'Accept: application/json'

Substitua os placeholders no seu servidor. Nenhuma requisição é executada aqui.

GET/homologation/nfe/{id}/danfe#

Baixar arquivo local verificado

Permissão necessária nfe:read

Parâmetros

idpath · integerobrigatório

Respostas HTTP

200

Sucesso

default

Erro seguro; 401/403/404/409/415/422/429/500/503. 429 inclui Retry-After.

Ver campos da resposta

errorobjectobrigatório

error.codestringobrigatório

error.messagestringobrigatório

errorsobject

curl 'https://api.nf3.app/api/v1/homologation/nfe/{id}/danfe' \
  -H 'Authorization: Bearer AQUI_VAI_A_CHAVE' \
  -H 'Accept: application/json'

Substitua os placeholders no seu servidor. Nenhuma requisição é executada aqui.

GET/homologation/nfe/received#

Listar recebidas locais; não consulta SEFAZ

Permissão necessária received:read

Parâmetros

pagequery · integer

per_pagequery · integer

searchquery · string

Respostas HTTP

200

Sucesso

Ver campos da resposta

dataarrayobrigatório

data[].idintegerobrigatório

data[].modelstring

data[].environmentintegerobrigatório

data[].seriesstring

data[].numberstring

data[].issuer_namestring

data[].issuer_documentstring

data[].totalstring

data[].statusstring

data[].access_keystring

data[].full_xmlbooleanobrigatório

data[].issued_atstring

metaobjectobrigatório

meta.pageintegerobrigatório

meta.per_pageintegerobrigatório

meta.totalintegerobrigatório

meta.last_pageintegerobrigatório

default

Erro seguro; 401/403/404/409/415/422/429/500/503. 429 inclui Retry-After.

Ver campos da resposta

errorobjectobrigatório

error.codestringobrigatório

error.messagestringobrigatório

errorsobject

curl 'https://api.nf3.app/api/v1/homologation/nfe/received' \
  -H 'Authorization: Bearer AQUI_VAI_A_CHAVE' \
  -H 'Accept: application/json'

Substitua os placeholders no seu servidor. Nenhuma requisição é executada aqui.

GET/homologation/nfe/received/{id}#

Resumo local de recebida

Permissão necessária received:read

Parâmetros

idpath · integerobrigatório

Respostas HTTP

200

Sucesso

Ver campos da resposta

dataobjectobrigatório

data.idintegerobrigatório

data.modelstring

data.environmentintegerobrigatório

data.seriesstring

data.numberstring

data.issuer_namestring

data.issuer_documentstring

data.totalstring

data.statusstring

data.access_keystring

data.full_xmlbooleanobrigatório

data.issued_atstring

default

Erro seguro; 401/403/404/409/415/422/429/500/503. 429 inclui Retry-After.

Ver campos da resposta

errorobjectobrigatório

error.codestringobrigatório

error.messagestringobrigatório

errorsobject

curl 'https://api.nf3.app/api/v1/homologation/nfe/received/{id}' \
  -H 'Authorization: Bearer AQUI_VAI_A_CHAVE' \
  -H 'Accept: application/json'

Substitua os placeholders no seu servidor. Nenhuma requisição é executada aqui.

GET/homologation/nfe/received/{id}/xml#

XML recebido quando já disponível

Permissão necessária received:read

Parâmetros

idpath · integerobrigatório

Respostas HTTP

200

Sucesso

default

Erro seguro; 401/403/404/409/415/422/429/500/503. 429 inclui Retry-After.

Ver campos da resposta

errorobjectobrigatório

error.codestringobrigatório

error.messagestringobrigatório

errorsobject

curl 'https://api.nf3.app/api/v1/homologation/nfe/received/{id}/xml' \
  -H 'Authorization: Bearer AQUI_VAI_A_CHAVE' \
  -H 'Accept: application/json'

Substitua os placeholders no seu servidor. Nenhuma requisição é executada aqui.

GET/homologation/nfe/{id}/corrections#

Listar eventos locais do documento

Permissão necessária nfe:correct

Parâmetros

idpath · integerobrigatório

pagequery · integer

per_pagequery · integer

Respostas HTTP

200

Sucesso

Ver campos da resposta

dataarrayobrigatório

data[].idintegerobrigatório

data[].document_idintegerobrigatório

data[].environmentintegerobrigatório

data[].typestringobrigatório

data[].sequenceintegerobrigatório

data[].statestringobrigatório

data[].reasonstringobrigatório

data[].reason_codeinteger | null

data[].reviewed_hashstringobrigatório

data[].created_atstringobrigatório

data[].resultnullableobrigatório

metaobjectobrigatório

meta.pageintegerobrigatório

meta.per_pageintegerobrigatório

meta.totalintegerobrigatório

meta.last_pageintegerobrigatório

default

Erro seguro; 401/403/404/409/415/422/429/500/503. 429 inclui Retry-After.

Ver campos da resposta

errorobjectobrigatório

error.codestringobrigatório

error.messagestringobrigatório

errorsobject

curl 'https://api.nf3.app/api/v1/homologation/nfe/{id}/corrections' \
  -H 'Authorization: Bearer AQUI_VAI_A_CHAVE' \
  -H 'Accept: application/json'

Substitua os placeholders no seu servidor. Nenhuma requisição é executada aqui.

POST/homologation/nfe/{id}/corrections#

Preparar evento assinado para revisão, sem transmissão

Permissão necessária nfe:correct

Parâmetros

idpath · integerobrigatório

Idempotency-Keyheader · stringobrigatório

UUID obrigatório em POST/PATCH. Mesmo owner/ambiente/chave com operação ou conteúdo diferente retorna 409.

Corpo da requisição application/json · 2 campos

reasonstringobrigatório

conditions_acceptedbooleanobrigatório

Respostas HTTP

201

Sucesso

Ver campos da resposta

dataobjectobrigatório

data.idintegerobrigatório

data.document_idintegerobrigatório

data.environmentintegerobrigatório

data.typestringobrigatório

data.sequenceintegerobrigatório

data.statestringobrigatório

data.reasonstringobrigatório

data.reason_codeinteger | null

data.reviewed_hashstringobrigatório

data.created_atstringobrigatório

data.resultnullableobrigatório

default

Erro seguro; 401/403/404/409/415/422/429/500/503. 429 inclui Retry-After.

Ver campos da resposta

errorobjectobrigatório

error.codestringobrigatório

error.messagestringobrigatório

errorsobject

curl 'https://api.nf3.app/api/v1/homologation/nfe/{id}/corrections' \
  -X POST \
  -H 'Authorization: Bearer AQUI_VAI_A_CHAVE' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: AQUI_VAI_O_UUID' \
  --data '{
  "reason": "AQUI_VAI_O_VALOR",
  "conditions_accepted": true
}'

Substitua os placeholders no seu servidor. Nenhuma requisição é executada aqui.

Exemplo de estrutura: substitua IDs, valores e UUIDs pelos dados conferidos da sua operação. O portal não executa este código.

GET/homologation/nfe/{id}/corrections/{event}#

Consultar evento local e hash de revisão

Permissão necessária nfe:correct

Parâmetros

idpath · integerobrigatório

eventpath · integerobrigatório

Respostas HTTP

200

Sucesso

Ver campos da resposta

dataobjectobrigatório

data.idintegerobrigatório

data.document_idintegerobrigatório

data.environmentintegerobrigatório

data.typestringobrigatório

data.sequenceintegerobrigatório

data.statestringobrigatório

data.reasonstringobrigatório

data.reason_codeinteger | null

data.reviewed_hashstringobrigatório

data.created_atstringobrigatório

data.resultnullableobrigatório

default

Erro seguro; 401/403/404/409/415/422/429/500/503. 429 inclui Retry-After.

Ver campos da resposta

errorobjectobrigatório

error.codestringobrigatório

error.messagestringobrigatório

errorsobject

curl 'https://api.nf3.app/api/v1/homologation/nfe/{id}/corrections/{event}' \
  -H 'Authorization: Bearer AQUI_VAI_A_CHAVE' \
  -H 'Accept: application/json'

Substitua os placeholders no seu servidor. Nenhuma requisição é executada aqui.

POST/homologation/nfe/{id}/corrections/{event}/transmissions#

Enfileirar envio do evento confirmado

Revalida credencial antes do envio. Evento já submetido é apenas observado, nunca reenviado. NF-e exige revisão com menos de 15 minutos; descarte e prepare novamente apenas eventos ainda não enviados.

Permissão necessária nfe:correct

Parâmetros

idpath · integerobrigatório

eventpath · integerobrigatório

Idempotency-Keyheader · stringobrigatório

UUID obrigatório em POST/PATCH. Mesmo owner/ambiente/chave com operação ou conteúdo diferente retorna 409.

Corpo da requisição application/json · 2 campos

confirmedbooleanobrigatório

reviewed_hashstringobrigatório

Respostas HTTP

202

Aceito para processamento, sem garantia de autorização fiscal.

Ver campos da resposta

dataobjectobrigatório

data.request_idintegerobrigatório

data.document_idintegerobrigatório

data.event_idinteger

default

Erro seguro; 401/403/404/409/415/422/429/500/503. 429 inclui Retry-After.

Ver campos da resposta

errorobjectobrigatório

error.codestringobrigatório

error.messagestringobrigatório

errorsobject

curl 'https://api.nf3.app/api/v1/homologation/nfe/{id}/corrections/{event}/transmissions' \
  -X POST \
  -H 'Authorization: Bearer AQUI_VAI_A_CHAVE' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: AQUI_VAI_O_UUID' \
  --data '{
  "confirmed": true,
  "reviewed_hash": "AQUI_VAI_O_VALOR"
}'

Substitua os placeholders no seu servidor. Nenhuma requisição é executada aqui.

Exemplo de estrutura: substitua IDs, valores e UUIDs pelos dados conferidos da sua operação. O portal não executa este código.

POST/homologation/nfe/{id}/corrections/{event}/reconcile#

Enfileirar consulta do evento, sem retransmissão

Permissão necessária nfe:correct

Parâmetros

idpath · integerobrigatório

eventpath · integerobrigatório

Idempotency-Keyheader · stringobrigatório

UUID obrigatório em POST/PATCH. Mesmo owner/ambiente/chave com operação ou conteúdo diferente retorna 409.

Respostas HTTP

202

Aceito para processamento, sem garantia de autorização fiscal.

Ver campos da resposta

dataobjectobrigatório

data.request_idintegerobrigatório

data.document_idintegerobrigatório

data.event_idinteger

default

Erro seguro; 401/403/404/409/415/422/429/500/503. 429 inclui Retry-After.

Ver campos da resposta

errorobjectobrigatório

error.codestringobrigatório

error.messagestringobrigatório

errorsobject

curl 'https://api.nf3.app/api/v1/homologation/nfe/{id}/corrections/{event}/reconcile' \
  -X POST \
  -H 'Authorization: Bearer AQUI_VAI_A_CHAVE' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: AQUI_VAI_O_UUID' \
  --data '{}'

Substitua os placeholders no seu servidor. Nenhuma requisição é executada aqui.

Exemplo de estrutura: substitua IDs, valores e UUIDs pelos dados conferidos da sua operação. O portal não executa este código.

POST/homologation/nfe/{id}/corrections/{event}/discard#

Descartar somente evento preparado e nunca enviado

Permissão necessária nfe:correct

Parâmetros

idpath · integerobrigatório

eventpath · integerobrigatório

Idempotency-Keyheader · stringobrigatório

UUID obrigatório em POST/PATCH. Mesmo owner/ambiente/chave com operação ou conteúdo diferente retorna 409.

Respostas HTTP

200

Sucesso

Ver campos da resposta

dataobjectobrigatório

data.idintegerobrigatório

data.document_idintegerobrigatório

data.environmentintegerobrigatório

data.typestringobrigatório

data.sequenceintegerobrigatório

data.statestringobrigatório

data.reasonstringobrigatório

data.reason_codeinteger | null

data.reviewed_hashstringobrigatório

data.created_atstringobrigatório

data.resultnullableobrigatório

default

Erro seguro; 401/403/404/409/415/422/429/500/503. 429 inclui Retry-After.

Ver campos da resposta

errorobjectobrigatório

error.codestringobrigatório

error.messagestringobrigatório

errorsobject

curl 'https://api.nf3.app/api/v1/homologation/nfe/{id}/corrections/{event}/discard' \
  -X POST \
  -H 'Authorization: Bearer AQUI_VAI_A_CHAVE' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: AQUI_VAI_O_UUID' \
  --data '{}'

Substitua os placeholders no seu servidor. Nenhuma requisição é executada aqui.

Exemplo de estrutura: substitua IDs, valores e UUIDs pelos dados conferidos da sua operação. O portal não executa este código.

GET/homologation/nfe/{id}/corrections/{event}/xml#

Baixar XML do evento autorizado e validado

Permissão necessária nfe:correct

Parâmetros

idpath · integerobrigatório

eventpath · integerobrigatório

Respostas HTTP

200

Sucesso

default

Erro seguro; 401/403/404/409/415/422/429/500/503. 429 inclui Retry-After.

Ver campos da resposta

errorobjectobrigatório

error.codestringobrigatório

error.messagestringobrigatório

errorsobject

curl 'https://api.nf3.app/api/v1/homologation/nfe/{id}/corrections/{event}/xml' \
  -H 'Authorization: Bearer AQUI_VAI_A_CHAVE' \
  -H 'Accept: application/json'

Substitua os placeholders no seu servidor. Nenhuma requisição é executada aqui.

GET/homologation/nfe/{id}/cancellations#

Listar eventos locais do documento

Permissão necessária nfe:cancel

Parâmetros

idpath · integerobrigatório

pagequery · integer

per_pagequery · integer

Respostas HTTP

200

Sucesso

Ver campos da resposta

dataarrayobrigatório

data[].idintegerobrigatório

data[].document_idintegerobrigatório

data[].environmentintegerobrigatório

data[].typestringobrigatório

data[].sequenceintegerobrigatório

data[].statestringobrigatório

data[].reasonstringobrigatório

data[].reason_codeinteger | null

data[].reviewed_hashstringobrigatório

data[].created_atstringobrigatório

data[].resultnullableobrigatório

metaobjectobrigatório

meta.pageintegerobrigatório

meta.per_pageintegerobrigatório

meta.totalintegerobrigatório

meta.last_pageintegerobrigatório

default

Erro seguro; 401/403/404/409/415/422/429/500/503. 429 inclui Retry-After.

Ver campos da resposta

errorobjectobrigatório

error.codestringobrigatório

error.messagestringobrigatório

errorsobject

curl 'https://api.nf3.app/api/v1/homologation/nfe/{id}/cancellations' \
  -H 'Authorization: Bearer AQUI_VAI_A_CHAVE' \
  -H 'Accept: application/json'

Substitua os placeholders no seu servidor. Nenhuma requisição é executada aqui.

POST/homologation/nfe/{id}/cancellations#

Preparar evento assinado para revisão, sem transmissão

Permissão necessária nfe:cancel

Parâmetros

idpath · integerobrigatório

Idempotency-Keyheader · stringobrigatório

UUID obrigatório em POST/PATCH. Mesmo owner/ambiente/chave com operação ou conteúdo diferente retorna 409.

Corpo da requisição application/json · 2 campos

reasonstringobrigatório

conditions_acceptedbooleanobrigatório

Respostas HTTP

201

Sucesso

Ver campos da resposta

dataobjectobrigatório

data.idintegerobrigatório

data.document_idintegerobrigatório

data.environmentintegerobrigatório

data.typestringobrigatório

data.sequenceintegerobrigatório

data.statestringobrigatório

data.reasonstringobrigatório

data.reason_codeinteger | null

data.reviewed_hashstringobrigatório

data.created_atstringobrigatório

data.resultnullableobrigatório

default

Erro seguro; 401/403/404/409/415/422/429/500/503. 429 inclui Retry-After.

Ver campos da resposta

errorobjectobrigatório

error.codestringobrigatório

error.messagestringobrigatório

errorsobject

curl 'https://api.nf3.app/api/v1/homologation/nfe/{id}/cancellations' \
  -X POST \
  -H 'Authorization: Bearer AQUI_VAI_A_CHAVE' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: AQUI_VAI_O_UUID' \
  --data '{
  "reason": "AQUI_VAI_O_VALOR",
  "conditions_accepted": true
}'

Substitua os placeholders no seu servidor. Nenhuma requisição é executada aqui.

Exemplo de estrutura: substitua IDs, valores e UUIDs pelos dados conferidos da sua operação. O portal não executa este código.

GET/homologation/nfe/{id}/cancellations/{event}#

Consultar evento local e hash de revisão

Permissão necessária nfe:cancel

Parâmetros

idpath · integerobrigatório

eventpath · integerobrigatório

Respostas HTTP

200

Sucesso

Ver campos da resposta

dataobjectobrigatório

data.idintegerobrigatório

data.document_idintegerobrigatório

data.environmentintegerobrigatório

data.typestringobrigatório

data.sequenceintegerobrigatório

data.statestringobrigatório

data.reasonstringobrigatório

data.reason_codeinteger | null

data.reviewed_hashstringobrigatório

data.created_atstringobrigatório

data.resultnullableobrigatório

default

Erro seguro; 401/403/404/409/415/422/429/500/503. 429 inclui Retry-After.

Ver campos da resposta

errorobjectobrigatório

error.codestringobrigatório

error.messagestringobrigatório

errorsobject

curl 'https://api.nf3.app/api/v1/homologation/nfe/{id}/cancellations/{event}' \
  -H 'Authorization: Bearer AQUI_VAI_A_CHAVE' \
  -H 'Accept: application/json'

Substitua os placeholders no seu servidor. Nenhuma requisição é executada aqui.

POST/homologation/nfe/{id}/cancellations/{event}/transmissions#

Enfileirar envio do evento confirmado

Permissão necessária nfe:cancel

Parâmetros

idpath · integerobrigatório

eventpath · integerobrigatório

Idempotency-Keyheader · stringobrigatório

UUID obrigatório em POST/PATCH. Mesmo owner/ambiente/chave com operação ou conteúdo diferente retorna 409.

Corpo da requisição application/json · 2 campos

confirmedbooleanobrigatório

reviewed_hashstringobrigatório

Respostas HTTP

202

Aceito para processamento, sem garantia de autorização fiscal.

Ver campos da resposta

dataobjectobrigatório

data.request_idintegerobrigatório

data.document_idintegerobrigatório

data.event_idinteger

default

Erro seguro; 401/403/404/409/415/422/429/500/503. 429 inclui Retry-After.

Ver campos da resposta

errorobjectobrigatório

error.codestringobrigatório

error.messagestringobrigatório

errorsobject

curl 'https://api.nf3.app/api/v1/homologation/nfe/{id}/cancellations/{event}/transmissions' \
  -X POST \
  -H 'Authorization: Bearer AQUI_VAI_A_CHAVE' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: AQUI_VAI_O_UUID' \
  --data '{
  "confirmed": true,
  "reviewed_hash": "AQUI_VAI_O_VALOR"
}'

Substitua os placeholders no seu servidor. Nenhuma requisição é executada aqui.

Exemplo de estrutura: substitua IDs, valores e UUIDs pelos dados conferidos da sua operação. O portal não executa este código.

POST/homologation/nfe/{id}/cancellations/{event}/reconcile#

Enfileirar consulta do evento, sem retransmissão

Permissão necessária nfe:cancel

Parâmetros

idpath · integerobrigatório

eventpath · integerobrigatório

Idempotency-Keyheader · stringobrigatório

UUID obrigatório em POST/PATCH. Mesmo owner/ambiente/chave com operação ou conteúdo diferente retorna 409.

Respostas HTTP

202

Aceito para processamento, sem garantia de autorização fiscal.

Ver campos da resposta

dataobjectobrigatório

data.request_idintegerobrigatório

data.document_idintegerobrigatório

data.event_idinteger

default

Erro seguro; 401/403/404/409/415/422/429/500/503. 429 inclui Retry-After.

Ver campos da resposta

errorobjectobrigatório

error.codestringobrigatório

error.messagestringobrigatório

errorsobject

curl 'https://api.nf3.app/api/v1/homologation/nfe/{id}/cancellations/{event}/reconcile' \
  -X POST \
  -H 'Authorization: Bearer AQUI_VAI_A_CHAVE' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: AQUI_VAI_O_UUID' \
  --data '{}'

Substitua os placeholders no seu servidor. Nenhuma requisição é executada aqui.

Exemplo de estrutura: substitua IDs, valores e UUIDs pelos dados conferidos da sua operação. O portal não executa este código.

POST/homologation/nfe/{id}/cancellations/{event}/discard#

Descartar somente evento preparado e nunca enviado

Permissão necessária nfe:cancel

Parâmetros

idpath · integerobrigatório

eventpath · integerobrigatório

Idempotency-Keyheader · stringobrigatório

UUID obrigatório em POST/PATCH. Mesmo owner/ambiente/chave com operação ou conteúdo diferente retorna 409.

Respostas HTTP

200

Sucesso

Ver campos da resposta

dataobjectobrigatório

data.idintegerobrigatório

data.document_idintegerobrigatório

data.environmentintegerobrigatório

data.typestringobrigatório

data.sequenceintegerobrigatório

data.statestringobrigatório

data.reasonstringobrigatório

data.reason_codeinteger | null

data.reviewed_hashstringobrigatório

data.created_atstringobrigatório

data.resultnullableobrigatório

default

Erro seguro; 401/403/404/409/415/422/429/500/503. 429 inclui Retry-After.

Ver campos da resposta

errorobjectobrigatório

error.codestringobrigatório

error.messagestringobrigatório

errorsobject

curl 'https://api.nf3.app/api/v1/homologation/nfe/{id}/cancellations/{event}/discard' \
  -X POST \
  -H 'Authorization: Bearer AQUI_VAI_A_CHAVE' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: AQUI_VAI_O_UUID' \
  --data '{}'

Substitua os placeholders no seu servidor. Nenhuma requisição é executada aqui.

Exemplo de estrutura: substitua IDs, valores e UUIDs pelos dados conferidos da sua operação. O portal não executa este código.

GET/homologation/nfe/{id}/cancellations/{event}/xml#

Baixar XML do evento autorizado e validado

Permissão necessária nfe:cancel

Parâmetros

idpath · integerobrigatório

eventpath · integerobrigatório

Respostas HTTP

200

Sucesso

default

Erro seguro; 401/403/404/409/415/422/429/500/503. 429 inclui Retry-After.

Ver campos da resposta

errorobjectobrigatório

error.codestringobrigatório

error.messagestringobrigatório

errorsobject

curl 'https://api.nf3.app/api/v1/homologation/nfe/{id}/cancellations/{event}/xml' \
  -H 'Authorization: Bearer AQUI_VAI_A_CHAVE' \
  -H 'Accept: application/json'

Substitua os placeholders no seu servidor. Nenhuma requisição é executada aqui.

POST/homologation/nfe/tax-preview#

Resolver grupos fiscais sem reservar número ou transmitir

Permissão necessária nfe:draft

Corpo da requisição application/json · 5 campos

customer_idintegerobrigatório

fiscal_operation_idinteger | null

itemsarrayobrigatório

items[].product_idintegerobrigatório

items[].tax_group_idinteger | null

Grupo explícito deste item; ausente/nulo usa o grupo da operação e depois o padrão opcional do produto. Não altera cadastros.

Respostas HTTP

200

data contém items resolvidos (incluindo st, ipi e fcp_rate do grupo quando aplicáveis), header e configuration_hash. Confirmar e usar em NfeCatalogCreate. Não enviar valores calculados. ST/IPI disponíveis somente por catálogo, com os limites documentados.

403

Sem permissão ou ambiente bloqueado.

422

Cadastro incompleto ou tratamento ainda não suportado.

curl 'https://api.nf3.app/api/v1/homologation/nfe/tax-preview' \
  -X POST \
  -H 'Authorization: Bearer AQUI_VAI_A_CHAVE' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: AQUI_VAI_O_UUID' \
  --data '{
  "customer_id": 1,
  "items": [
    {
      "product_id": 1
    }
  ]
}'

Substitua os placeholders no seu servidor. Nenhuma requisição é executada aqui.

Exemplo de estrutura: substitua IDs, valores e UUIDs pelos dados conferidos da sua operação. O portal não executa este código.