Interface On · Fiscal — Testador

Cadastro da empresa

É o que a API vai usar ao emitir — vem do cadastro feito no Licença ON (aba Nota fiscal da empresa). Aqui é só leitura: se algo estiver errado, corrija lá e recarregue.

Informe a chave e escolha a empresa na aba ⚙ Configurações; esta aba carrega sozinha.

Consultar nota fiscal

Situação da nota na SEFAZ pela chave de acesso (cStat, protocolo, eventos).

Cancelar nota fiscal

Evento 110111. Aceito quando a SEFAZ devolve cStat 135/136 — o sistema de origem grava o cancelamento.

Carta de correção

Evento 110110. Não corrige valores, imposto nem destinatário — só informações acessórias.

Inutilizar numeração

Para faixas de números pulados (quebra de sequência). Aceita quando a SEFAZ devolve cStat 102.

XML pronto

Para quem já montou o XML em outro sistema: a API assina, valida e transmite («emitir-xml»). Ou gere o PDF (DANFE/DANFCe) de um XML autorizado.

APIs — referência e requisição livre

Todos os endpoints desta API, para consumir de qualquer sistema (Delphi, Python, n8n…). Clique numa rota para carregá-la na requisição livre abaixo. Documentação interativa completa: /api/docs (Swagger).

Como autenticar (em qualquer linguagem)

Toda chamada leva os cabeçalhos X-Api-Key: <sua chave> e, quando há corpo, Content-Type: application/json. Endereço no servidor: https://fiscal.interfaceon.com.br. Respostas sempre em JSON; erro vem com mensagem (e cstat/xmotivo quando é a SEFAZ).

Endpoints

Requisição livre (estilo Postman)

Exemplo de código — com o método, a rota e o corpo acima

O exemplo sai pronto com a sua chave e o endereço desta página — em produção troque pelo https://fiscal.interfaceon.com.br.

Configurações

A chave vem do script scripts/criar_consumidor.py da API (não existe em site nenhum). Chave e CNPJ ficam lembrados neste navegador.

Administração — é no Licença ON

Cadastro das empresas emitentes, certificado digital A1 e as chaves de API dos clientes ficam no Licença ON (cadastro da empresa, aba Nota fiscal). Aqui é só teste.

O testador manda sempre ambiente: "homologacao" em toda operação — mesmo com o cadastro do emitente em produção, daqui não sai nota de verdade. Na API ainda existe a trava PERMITIR_PRODUCAO=0: qualquer pedido de produção (de qualquer sistema) leva 403 até ser liberada.