API NF-e
Nota de Produto, modelo 55. Emissão, consulta, cancelamento, XML/DANFE e inutilização de faixa de numeração.
https://invo.work/api/nfe/v1API NFS-e
Nota de Serviço. Emissão (via RPS), consulta e cancelamento, integrada à prefeitura do município.
https://invo.work/api/nfse/v1Conceitos compartilhados
Autenticação HTTP Basic
api_key / api_secret da conta em HTTP Basic, idênticas para NF-e e NFS-e. Veja Autenticação.Seleção de empresa
O cabeçalho
X-Empresa-CNPJ define qual empresa emite. Ausente, usa a primeira empresa da conta.Emissão assíncrona
POST persiste e enfileira a nota, retornando 201 com situacao: "pendente". Acompanhe pelo GET de detalhes. Veja o Ciclo de vida.Respostas em JSON
Todos os corpos são
application/json (exceto os downloads de XML/DANFE da NF-e). Accept não-JSON recebe 406.O que difere entre as APIs
| API NF-e | API NFS-e | |
|---|---|---|
| Documento | Nota de Produto (modelo 55) | Nota de Serviço |
| Identificador | uuid (o id nunca é exposto) | id |
| Emissão | Direto à SEFAZ; veredito terminal autorizada / rejeitada / denegada | Via RPS enviado em lote à prefeitura; depois nfse.situacao: "emitida" |
| Extras | Inutilização síncrona de faixa; download de XML (nfeProc) e DANFE | codigo_verificacao da NFS-e na resposta |
| Acompanhamento | Polling ou webhooks nfe_* | Polling (sem webhooks) |
Primeiros passos
Autentique
Use a
api_key / api_secret da conta em HTTP Basic, e opcionalmente o cabeçalho X-Empresa-CNPJ. Veja Autenticação.Emita uma nota
- NF-e:
POST /notascom destinatário e itens — a resposta trazuuidechave_acessoestáveis (aba API NF-e). - NFS-e:
POST /notascom tomador e serviço — a resposta traz oide gera o RPS (aba API NFS-e).
Acompanhe o resultado
Faça polling no
GET de detalhes (/notas/{uuid} ou /notas/{id}). A NF-e também emite webhooks (nfe_*); a NFS-e é acompanhada por polling. Entenda os estados no Ciclo de vida.