Pular para conteudo principal
api rest · v1

integre CBS/IBS
no seu sistema.

REST simples, payload JSON, autenticação Bearer. Para escritórios que rodam Domínio, Alterdata, Contmatic ou fluxos internos próprios.

autenticação

API key por escritório, scoped por org.

Cada escritório gera sua key no painel. As chamadas sob /api/v1 passam por Authorization: Bearer dlai_live_… e ficam isoladas por org_id. Os endpoints de cálculo são públicos e não pedem chave.

# Apuração de uma NF-e (sem chave)
curl -X POST https://dualisia.com.br/api/calculadora \
-F "xml=@nota.xml" \
-F "ano=2027"
endpoints

quatro chamadas, todas no ar.

Esta é a superfície pública inteira. O contrato completo, com schemas e códigos de erro, está em /openapi.json.

POST /api/calculadora · Apura CBS e IBS de uma NF-e. Público.
POST /api/simulador · Projeta a carga ano a ano, 2026 a 2033. Público.
GET /api/v1/clients · Lista clientes PJ do escritório. Scope read:clients.
GET /api/v1/documents · Lista NF-e processadas. Scope read:documents.
erros

JSON com código estável, nunca HTML.

Todo erro traz code para ramificar em código e hint dizendo o que corrigir. Caminho inexistente sob /api responde 404 em JSON.

webhooks e sdks

ainda não existem.

Não emitimos webhooks de apuração para clientes, e não há SDK oficial em nenhuma linguagem. A API é REST puro — qualquer cliente HTTP serve. Diga em /contato o que você precisa primeiro; a fila é montada pelo que os escritórios pedem.

API key em 30 segundos.

Entre no painel, vá em Configurações → API keys e gere uma chave. Restrito ao owner do escritório.