API de integração Notavia

Integre seu ERP, e-commerce ou sistema interno ao Notavia para emitir NF-e, NFS-e e DC-e, registrar eventos e sincronizar cadastros por API REST.

🧾 NFS-e (Sistema Nacional) via API — disponível. Emissão de notas de serviço pelo padrão nacional gov.br, no mesmo modelo assíncrono: POST /nfse, cancelamento em POST /nfse/cancelamentos, downloads em GET /nfse/{chave}/xml|danfse — veja NFS-e.

📦 DC-e (modelo 99) via API — disponível. A emissão da Declaração de Conteúdo eletrônica segue o mesmo modelo assíncrono (job + polling + webhook) da NF-e: POST /dce, cancelamento em POST /dce/cancelamentos (por chave), downloads em GET /dce/{chave}/xml|dace — detalhes em Emissão e eventos assíncronos e exemplos prontos no sandbox.

Visão geral

Base URL: https://SEU-DOMINIO/api/integracao
Formato: JSON (camelCase) sobre HTTPS. UTF-8.
Autenticação: header X-Api-Key — detalhes.
Modelo assíncrono: emissão e eventos retornam 202 Accepted com um jobId; acompanhe por polling ou receba um webhook quando concluir.
Idempotência em tudo: cadastros via PUT (upsert) e operações com referenciaExterna única — repetir uma chamada nunca duplica nota ou cadastro.

Referência interativa

Esta documentação explica conceitos e fluxos. A referência completa de cada endpoint (schemas, exemplos, try-it) está no portal interativo:

/docs — referência OpenAPI navegável • /openapi/v1.json — spec para gerar clients

O fluxo típico

1. PUT  /produtos/{codigo}          ─┐
   PUT  /clientes/{cpfCnpj}          ├─ sincroniza cadastros (upsert, idempotente)
   PUT  /operacoes-fiscais/{codigo} ─┘
2. POST /emissoes                   → 202 { jobId }
3. GET  /emissoes/{jobId}           → status: Pendente → Processando → Concluido | Falha
   (ou aguarde o webhook)
4. GET  /notas/{chave}/xml          → XML autorizado
   GET  /notas/{chave}/danfe        → DANFE (PDF)

Páginas desta documentação

Página	Conteúdo
Autenticação e limites	API keys, header, rate limit por plano
Guia rápido	Da chave à primeira nota autorizada, em curl
Sandbox	Teste as chamadas direto do navegador, com a sua chave
Cadastros (upsert)	Produtos, clientes, grupos, operações
Emissão e eventos	Jobs assíncronos, polling, idempotência
NFS-e	Serviços, emissão, cancelamento e DANFSe pelo Sistema Nacional
Webhooks	Notificação de conclusão, assinatura HMAC, retries
Downloads	XML autorizado e DANFE por chave de acesso
Erros	Códigos HTTP, formato de erro, rejeições SEFAZ

Ambientes

O ambiente (homologação/produção) é definido no cadastro do emitente, no portal. Em homologação as notas não valem fiscalmente e não consomem cota — ideal para desenvolver a integração.