NF-e modelo 55 · API REST

Emita nota fiscal sem tocar em XML ou SEFAZ.

Uma API para assinar, transmitir e acompanhar NF-e — com certificado digital, DANFE e webhooks, com suporte a múltiplos CNPJs por conta.

Criar conta grátis → Ver documentação

NF-e · Modelo 55 Autorizada

Protocolo: 135260000123456
Chave de acesso: …5502 9001
Emitente (CNPJ): 42.123.456/0001-90
Valor total: R$ 2.480,00

202 Accepted

Como funciona

Uma API, todo o ciclo da nota

Emissão assíncrona: você chama a API, recebe 202 na hora, e acompanha o resultado por consulta ou webhook.

# cria a NF-e — responde 202 na hora, sem esperar a SEFAZ
curl -X POST https://fiscal-api.contratoonline.lat/api/v1/emitentes/{emitente}/nfe \
  -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
  -d '{"natureza_operacao": "Venda de mercadoria", "itens": [...], ...}'

# → 202 Accepted
{"id": "nfe_8f2a...", "status": "processando"}

# acompanha o processamento até a SEFAZ autorizar (ou rejeitar)
curl https://fiscal-api.contratoonline.lat/api/v1/emitentes/{emitente}/nfe/nfe_8f2a... \
  -H "Authorization: Bearer <token>"

# → 200 OK
{"id": "nfe_8f2a...", "status": "autorizada", "protocolo": "135260000123456", "danfe_url": "..."}

# notificação HMAC-assinada, enviada ao seu endpoint
POST /seu-webhook HTTP/1.1
X-Signature: sha256=...

{"event": "nfe.autorizada", "id": "nfe_8f2a...", "protocolo": "135260000123456"}

# cada código de retorno da SEFAZ já vem catalogado — sem você ter
# que traduzir "cStat 539" na mão
curl https://fiscal-api.contratoonline.lat/api/v1/emitentes/{emitente}/nfe/nfe_8f2a... \
  -H "Authorization: Bearer <token>"

# → 200 OK
{
  "status": "rejected",
  "codigo_status": "539",
  "motivo_status": "Duplicidade de NF-e",
  "sugestao_correcao": "Gere um novo número (nNF) e reenvie — esse par já foi autorizado.",
  "mensagem_usuario": "Detectamos uma duplicidade nesta venda. Tente novamente."
}

Recursos

Tudo que envolve emitir uma NF-e, numa API só

Feita para devs que querem praticidade: menos tempo lendo manual da SEFAZ e traduzindo código de rejeição, mais tempo no seu produto.

Erros catalogados, não só um código solto

Cada retorno da SEFAZ vem com uma sugestão de como corrigir e reenviar via API, e uma mensagem pronta pra mostrar ao seu cliente — sem você traduzir "cStat 539" na mão.

Emissão assíncrona

Envie o pedido e receba 202 na hora — o resultado (autorizada, rejeitada) chega por consulta ou webhook, sem sua aplicação travada esperando a SEFAZ responder.

Certificado digital A1

Cadastre por upload de arquivo ou colando o conteúdo em base64. Cifrado em repouso, um por CNPJ, com verificação automática de validade.

DANFE pronto

Baixe o PDF do documento auxiliar direto pela API assim que a nota é autorizada — sem gerar e formatar o layout você mesmo.

Webhooks assinados

Notificação HMAC-assinada para cada mudança de status (autorizada, rejeitada, cancelada) — sem precisar ficar consultando a API.

Multi-CNPJ por conta

Uma conta, vários emitentes — cada CNPJ com seu próprio certificado e sua própria franquia de documentos do plano.

Homologação e produção

Cada emitente escolhe o ambiente — teste à vontade em homologação antes de emitir valendo.

Assinatura self-service

Escolha e troque de plano quando quiser, direto no seu painel — pagamento via Stripe, sem contrato nem contato com time comercial.

Conta e API sem espera

Cadastro pelo site em menos de um minuto — o token de API aparece na hora, sem aprovação manual ou contato com nosso time.