Quanto custa a API da Délfica?

A API está incluída em todos os planos, a partir de R$ 149,90/mês no Starter. Não há cobrança adicional por chamada, por nota emitida ou por webhook recebido.

Sim. A especificação segue OpenAPI 3.1 e está disponível em /api/openapi.json para geração de SDKs em qualquer linguagem.

Como funciona a autenticação?

Há dois caminhos: contas de serviço com escopos granulares (Bearer token) e OAuth 2.0 + PKCE para apps de terceiros com consentimento do usuário final.

Existe SDK Python oficial?

Sim. O SDK Python inicial está em /developers/sdk-python.py e em github.com/delfica/sdk-python, com helpers de retry, HMAC e tratamento de falhas SEFAZ.

Como recebo webhooks de eventos?

Cadastre o endpoint no console ou via POST /api/v1/webhooks. Receba eventos de emissão, rejeição, cancelamento e atualização com assinatura HMAC.

Quantos webhooks cada plano libera?

Starter não inclui webhooks (somente leitura via API). Pro libera 5 webhooks por empresa. Enterprise libera webhooks ilimitados, com SSO/SAML e gerente dedicado.

Documentação para desenvolvedores

API Fiscal Délfica — REST, OpenAPI 3.1, webhooks e SDK Python

Integre NF-e, NFC-e, NFS-e, CT-e e MDF-e em ERP, PDV e e-commerce com a mesma base usada pelo portal da Délfica. OpenAPI 3.1, Bearer token, OAuth 2.0 + PKCE e webhooks com assinatura HMAC — a partir de R$ 149,90/mês.

Abrir API interativa Ver referência completa

curl -H "Authorization: Bearer $TOKEN" \
  "$HOST/api/v1/customers"

POST /api/v1/invoices/issue
GET  /api/v1/invoices/{id}/xml
POST /api/v1/webhooks

OpenAPI 3.1Bearer tokenWebhooks

Links rápidos

Documentação publicada

Os mesmos artefatos usados pelo contrato da aplicação ficam expostos no site e no container Docker.

API interativaTeste endpoints e autorize com Bearer token. Referência navegávelLeia o contrato completo por domínio. OpenAPI JSONGere SDKs e valide contratos automaticamente. Coleção PostmanImporte no Postman e teste todos os endpoints. Status da APILatência e uptime em tempo real dos endpoints públicos. Referência MarkdownArquivo gerado a partir do OpenAPI atual. AutenticaçãoContas de serviço, escopos, rotação e revogação. OAuth 2.0 + PKCEApps de terceiros com consentimento do usuário. API de Statushealthz, readiness e SEFAZ público. Emissão fiscalFluxo recomendado para NF-e, NFC-e e NFS-e. ExemplosCurl e Python para primeiras integrações. Checklist pré-produção9 gates antes de subir para produção. SDK PythonBiblioteca inicial com helpers de retry e HMAC.

Primeira integração

Caminho recomendado

Comece pequeno, valide os dados fiscais e só então automatize a emissão em produção.

1. Crie o app

Use o console para gerar uma conta de serviço com os escopos mínimos.

2. Cadastre dados

Sincronize clientes, produtos ou serviços antes da emissão.

3. Emita e acompanhe

Envie a nota, consulte rejeições e baixe XML ou DANFE.

4. Receba eventos

Configure webhooks para avisos de emissão, rejeição e atualização.

Domínios da API

Rotas organizadas por operação

Cadastros/api/v1/customers/api/v1/products/api/v1/services

Notas fiscais/api/v1/invoices/issue/api/v1/nfse/issue/api/v1/invoices/{id}/xml

Fiscal em produção/api/v1/sefaz/status/{uf}?ambiente=producao/api/v1/tax/*/api/v1/compliance/*

Operação/api/v1/stock/*/api/v1/sales/*/api/v1/webhooks

Segurança

Chaves técnicas, escopos e auditoria

Usuários humanos acessam o portal. Integrações usam contas de serviço, token Bearer e escopos granulares para reduzir risco operacional.

Cabeçalho padrão

Authorization: Bearer cbz_p_sua_chave

Escopos comuns

read:customers
write:customers
read:invoices
write:nfe
write:nfse
read:sefaz
# monitoramento SEFAZ em producao

Próximo passo

Abra o contrato, gere sua chave e opere em produção.

Acessar console Ver status da API

Fontes oficiais

Para consulta direta, use os portais públicos do governo federal e do Comitê Gestor do IBS: