Emitir
POST /nfe recebe a operação, o destinatário e os itens. A API monta o XML, assina com o certificado A1 e envia à SEFAZ.
Produto
API de NF-e.
A nota fiscal de produto sai do seu sistema em JSON. A montagem do XML, a assinatura e o envio à SEFAZ ficam do lado da API.
Consultar
GET /nfe/{id} devolve a nota pelo uuid da API ou pela identificação. O retorno traz status, chave, protocolo e o XML em base64.
Cancelar
POST /nfe/{id}/cancelar envia a justificativa. A nota autorizada passa a cancelada quando a SEFAZ aceita o evento.
Imprimir
GET /nfe/{id}/pdf entrega o DANFE. /pdf/simples gera o simplificado e /pdf/etiqueta gera a etiqueta.
Corpo da nota
O que vai no JSON.
A identificação é sua. A natureza da operação, a série e o número descrevem a nota. O destinatário é quem recebe. Cada item leva produto, CFOP e imposto.
O emitente sai do cadastro: razão social, endereço, inscrição estadual, regime e certificado. A API não escolhe a tributação: ela envia o que estiver no pedido e devolve o motivo da SEFAZ se a nota for recusada.
Ambientes
Homologação. A nota não tem valor fiscal. Serve para validar o JSON, o certificado e o retorno da SEFAZ.
Produção. Usa o mesmo endereço. O ambiente fica no cadastro do emitente, junto com o certificado A1.
O certificado aceito neste fluxo é o A1, em arquivo.
Status
Do envio até o arquivo.
- autorizada — chave, protocolo e XML estão disponíveis. O DANFE sai a partir desse XML.
- denegada — a SEFAZ denegou. O número fica gravado e não pode ser reutilizado.
- rejeitada — a SEFAZ recusou. A nota não é gravada e o motivo volta no JSON.
- cancelada — o cancelamento foi aceito. O XML do evento fica na consulta.
Eventos
Depois da autorização.
A carta de correção, o ator interessado e o comprovante de entrega saem em rotas próprias. A nota continua autorizada. GET /nfe/{id}/eventos lista o que esta API gravou, inclusive o cancelamento.
A chave do emitente libera o primeiro POST.
O cadastro pede o CNPJ, o certificado A1 e o ambiente da SEFAZ. A documentação prática da rota está em um só lugar.