Documentação para desenvolvedores

API fiscal para sistemas que precisam emitir, consultar e automatizar.

Use a Délfica para integrar NF-e, NFC-e, NFS-e, cadastros, documentos fiscais, status SEFAZ, webhooks e rotinas tributárias em fluxos reais de operação.

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. Referência MarkdownArquivo gerado a partir do OpenAPI atual. AutenticaçãoContas de serviço, escopos, rotação e revogação. Emissão fiscalFluxo recomendado para NF-e, NFC-e e NFS-e. ExemplosCurl e Python para primeiras integrações. SDK PythonBiblioteca inicial para acelerar testes locais.

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/api/v1/sefaz/status/{uf}/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

Próximo passo

Abra o contrato, gere sua chave e teste em homologação.

Acessar console Ver situação pública