Fiscal Contora
Fiscal Contora Infraestrutura fiscal
Documentação / Visão geral v1
Quickstart OpenAPI IA Health
API REST fiscal

Integre emissão fiscal com um contrato claro, assíncrono e pronto para crescer.

Esta documentação descreve a versão pública atual da API fiscal da Contora, com base compartilhada de empresas, certificados, chaves, filas, webhooks e artefatos para NF-e, NFC-e, NFS-e, CT-e e MDF-e. NF-e, NFC-e e NFS-e operam em produção regular; CT-e e MDF-e em produção assistida e controlada.

Base URL https://fiscal.contora.com.br/api/v1
Autenticação Bearer token no header Authorization.
OpenAPI Baixar especificação JSON
Arquitetura Fluxo assíncrono (JSON) com webhooks e artefatos (XML/PDF).

Atualizado em .

Visão geral

A API fiscal da Contora foi desenhada para desacoplar a emissão fiscal do ERP e transformar o motor atual em uma plataforma de serviços. O padrão atual trabalha com documentos versionados, status previsíveis, histórico de tentativas, eventos fiscais e notificações por webhook.

Famílias já expostas publicamente Todas as famílias documentais já possuem superfície pública própria dentro da plataforma, compartilhando empresas, certificados, filas, webhooks e artefatos.
Disponibilidade em Produção NF-e, NFC-e e NFS-e operam em produção regular; CT-e e MDF-e em produção assistida e controlada, conforme o mapa abaixo.

Comece pelo console

A maneira mais rápida de colocar uma conta para operar é seguir o onboarding do próprio console do Fiscal Contora. Hoje o painel ja cobre empresas, certificados, documentos, webhooks, chaves e financeiro.

Onboarding da conta Criar conta, validar e-mail, gerar uma chave de homologação, cadastrar a empresa e subir o certificado A1.
Primeira integração Testar a autenticação, seguir o quickstart até o build, cadastrar um webhook e só então autorizar o primeiro documento.
Criar conta Seguir o quickstart Entrar Ver autenticação Ver webhooks

Ambientes

Produção
https://fiscal.contora.com.br
Versão atual da API
/api/v1
Health check
/api/health

Roteiro rápido de integração

  1. Criar a conta e validar o acesso ao console.
  2. Baixar a especificação OpenAPI da versão atual.
  3. Gerar uma chave de API de homologação.
  4. Criar a empresa fiscal no mesmo ambiente da chave.
  5. Enviar o certificado A1 da empresa.
  6. Cadastrar um webhook de teste.
  7. Criar o rascunho da NF-e ou NFC-e.
  8. Executar o build fiscal.
  9. Disparar a emissão assíncrona.
  10. Acompanhar por status, webhook e painel de documentos.
  11. Baixar XML e PDF quando autorizado.
  12. Usar cancelamento e CC-e como eventos posteriores.
Abrir OpenAPI Começar por autenticação Resiliência e Idempotência Ir para NF-e Ir para NFC-e

Padrão oficial da v1

Envelope de sucesso Rotas protegidas devolvem ok e, em regra, um bloco data com o recurso solicitado ou criado.
Envelope de erro Falhas passam a seguir ok=false, message e error.type, com detalhes de validação quando houver.

Mapa de disponibilidade

NF-e e NFC-e
Disponíveis na API v1 e no console em produção assistida.
CT-e
Fluxo técnico público disponível em produção assistida.
NFS-e
Emissão, consulta, cancelamento, XML e DANFSe disponíveis em homologação e produção; valide a cobertura e as regras do município emissor.
MDF-e
API pública em homologação controlada antes da abertura ampla em produção.

Leitura técnica recomendada

Para um integrador experiente, a melhor ordem costuma ser: autenticação, empresas, certificados, webhooks, limites, ciclo de NF-e/NFC-e, status, debug e erros. Para outras famílias fiscais, vale seguir por NFS-e, CT-e e MDF-e nas páginas dedicadas.

Ver limites e cotas Explorar serviços Abrir NFS-e Abrir debug