NF-e (Produto)

Criar / Emitir Devolução de NF-e

Gera automaticamente uma NF-e de devolução (finalidade 4) com inversão de destinatário/remetente, CFOP de retorno e vínculo à chave referenciada da NF-e original. Suporta emissão imediata na SEFAZ com transmitir: true ou criação de rascunho.

POST
https://api.nfer.me
/v1/nfe/{id}/devolucao

Authorizations

X-API-Key
string
header
required

Chave de API emitida no painel NFER enviada no header da requisição.

Path Parameters

id
string<uuid>
required

ID da NF-e autorizada original.

Exemplo:b7c2930a-48a1-4fd8-879e-4a671cfbd992

Query Parameters

transmitir
boolean
opcional

Se true, autoriza e transmite imediatamente a NF-e de devolução na SEFAZ.

Body

application/json
transmitir
boolean
opcional
default:false

Se true, assina e transmite imediatamente a NF-e de devolução para a SEFAZ. Se false ou omitido, salva como rascunho pronto para envio posterior.

itens
object[]
opcional

Itens parciais a devolver: [{ numeroItem: number, quantidade?: number }]. Se omitido, devolve 100% dos itens da nota original.

Response

application/json

NF-e de devolução criada (ou autorizada na SEFAZ se transmitir=true).

id
string<uuid>
opcional

Identificador único do recurso.

Exemplo:c8d3041b-59b2-4fe9-980f-5b782dfce003
finalidade
integer
opcional

Finalidade da emissão (1: Normal, 2: Complementar, 3: Ajuste, 4: Devolução).

Exemplo:4
tipo_operacao
string
opcional

Tipo da operação (0: Entrada, 1: Saída).

Exemplo:0
natureza_operacao
string
opcional

Natureza da operação fiscal.

Exemplo:DEVOLUCAO DE MERCADORIA
status
string
opcional

Status atual do processamento da nota.

Exemplo:processando
chaveAcesso
string
opcional

Exemplo retornado: "35261057924771000192550010000000221000000224"

Exemplo:35261057924771000192550010000000221000000224
numero
integer
opcional

Número da nota fiscal.

Exemplo:22
serie
integer
opcional

Série da nota fiscal.

Exemplo:1
valor_total
number
opcional

Valor total da nota fiscal.

Exemplo:149.9
Criar / Emitir Devolução de NF-e
curl --request POST \
  --url https://api.nfer.me/v1/nfe/{id}/devolucao \
  --header 'X-API-Key: <sua_chave_api>' \
  --header 'Content-Type: application/json' \
  --data '{
  "transmitir": "false",
  "itens": []
}'
{
  "id": "c8d3041b-59b2-4fe9-980f-5b782dfce003",
  "finalidade": 4,
  "tipo_operacao": "0",
  "natureza_operacao": "DEVOLUCAO DE MERCADORIA",
  "status": "processando",
  "chaveAcesso": "35261057924771000192550010000000221000000224",
  "numero": 22,
  "serie": 1,
  "valor_total": 149.9
}