API v2

Documentação da API

Use esta área para integrar seu sistema à NF Integrada. A API é REST, recebe JSON e autentica com HTTP Basic. O ambiente (homologação ou produção) vem do token, não da URL.

O que já está disponível

Nesta versão documentamos a NF-e: emitir, consultar, baixar XML, baixar DANFE, enviar por e-mail e cancelar. NFC-e, NFS-e, CT-e, MDF-e, carta de correção e inutilização entram nas próximas fases.

URL base

Todas as rotas partem de:

https://api.nfintegrada.com.br

Exemplo: emitir uma NF-e em https://api.nfintegrada.com.br/v2/nfe?ref=pedido-1001. Troque o host se a sua conta usar outro endereço — o caminho /v2/... permanece o mesmo.

Primeiros passos

1
Cadastre a empresa e o certificado A1
A emissão usa o certificado digital ativo da empresa. Sem ele, a API responde certificado_ausente.
2
Gere um token
No painel, gere um token de homologação para testar e outro de produção quando for emitir notas reais. Cada token vale para uma empresa e um ambiente.
3
Faça a primeira chamada
Envie o token no HTTP Basic Auth (usuário = token, senha em branco) e um ref único do seu sistema.
4
Consulte até autorizar
Se a resposta vier com processando_autorizacao, consulte o mesmo ref até autorizado ou erro_autorizacao.

Navegue pelos tópicos

Autenticação HTTP Basic com o token da empresa. Conceitos ref, ambientes, status e formato de erro. NF-e Emitir, consultar, XML, DANFE e cancelar. POST /v2/nfe Enviar uma nota para a SEFAZ. GET /v2/nfe/{ref} Acompanhar o status da autorização. DELETE /v2/nfe/{ref} Cancelar uma NF-e autorizada.

Formato das respostas

Em sucesso, a API devolve JSON com o documento (status, chave_nfe, numero, caminhos de XML e PDF). Em erro, o corpo segue este padrão:

{
    "codigo": "token_invalido",
    "mensagem": "Informe o token no HTTP Basic Auth (usuário = token, senha em branco)."
}

Quando a validação do JSON falha, entra também o array erros, com campo e mensagem por item.