Skip to main content
A Invo tem duas APIs REST. Com elas você emite, consulta e cancela notas fiscais e baixa os 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 por RPS, consulta e cancelamento, com envio à prefeitura do município.https://invo.work/api/nfse/v1
As duas APIs usam as mesmas credenciais e a mesma seleção de empresa, então uma conta opera os dois produtos. Elas diferem no tipo de documento fiscal e em alguns detalhes do ciclo de vida.

​
Conceitos compartilhados

Autenticação HTTP Basic

A conta usa o mesmo par api_key / api_secret em HTTP Basic na NF-e e na NFS-e. Veja Autenticação.

Seleção de empresa

O cabeçalho X-Empresa-CNPJ define a empresa que emite. Sem ele, a API usa a primeira empresa da conta.

Emissão assíncrona

O POST salva a nota, põe a emissão na fila e retorna 201 com situacao: "pendente". Acompanhe pelo GET de detalhes. Veja o Ciclo de vida.

Respostas em JSON

Os corpos são application/json, com exceção dos downloads de XML e DANFE da NF-e. Um Accept diferente de JSON recebe 406.

​
O que difere entre as APIs

​
Primeiros passos

1

Autentique

Use a api_key e a api_secret da conta em HTTP Basic. O cabeçalho X-Empresa-CNPJ é opcional. Veja Autenticação.
2

Emita uma nota

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

Acompanhe o resultado

Consulte o GET de detalhes (/notas/{uuid} ou /notas/{id}) até a nota mudar de estado. A NF-e também envia webhooks nfe_*. A NFS-e só tem polling. Os estados estão no Ciclo de vida.
4

Baixe os documentos

Depois que a NF-e for autorizada, baixe o XML autorizado (nfeProc) e o DANFE em PDF. A NFS-e traz o codigo_verificacao, que confere a nota no portal da prefeitura.