Skip to main content
A Invo expõe duas APIs REST que cobrem o ciclo de vida completo das suas notas fiscais — emissão, consulta, cancelamento e download de documentos:

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/v1

API NFS-e

Nota de Serviço. Emissão (via RPS), consulta e cancelamento, integrada à prefeitura do município.https://invo.work/api/nfse/v1
As duas compartilham as mesmas credenciais e a mesma seleção de empresa: uma única conta opera os dois produtos. O que muda é o domínio fiscal (produto × serviço) e alguns detalhes de cada ciclo de vida.

​
Conceitos 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

​
Primeiros passos

1

Autentique

Use a api_key / api_secret da conta em HTTP Basic, e opcionalmente o cabeçalho X-Empresa-CNPJ. Veja Autenticação.
2

Emita uma nota

  • NF-e: POST /notas com destinatário e itens — a resposta traz uuid e chave_acesso estáveis (aba API NF-e).
  • NFS-e: POST /notas com tomador e serviço — a resposta traz o id e gera o RPS (aba API NFS-e).
3

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.
4

Baixe os documentos

Após a autorização da NF-e, baixe o XML autorizado (nfeProc) e o DANFE (PDF). A NFS-e expõe o codigo_verificacao para conferência na prefeitura.