⚡ API REST · 15 Endpoints · Bearer Auth

Integre o LUPPA
nas suas ferramentas.

Auditoria fiscal, reconciliação bancária e análise CFO directamente via API. Sem negociações. Sem burocracia. Documentação completa e acesso imediato.

Ver Documentação Completa Gerar Chave API
15
Endpoints públicos
lup_*
Autenticação por Bearer token
150MB+
SAF-T suportado por streaming
O que consegue fazer com a API
Todas as capacidades do LUPPA acessíveis programaticamente.
🧾
Processar SAF-T
Ingira ficheiros SAF-T de qualquer ERP português. Suporta FINAL e INTERCALAR, frameworks NCRF-PE e NC-ME, ficheiros até 150 MB via streaming.
🔍
Auditoria Determinística
Valide NIFs por checksum, detecte gaps de numeração, erros matemáticos em faturas e anomalias SNC. 100% determinístico — sem alucinações de IA.
🏦
Reconciliação Bancária
Motor de 4 camadas determinísticas + IA só para resíduos genuinamente ambíguos. Suporta extratos CSV, XLSX e PDF dos principais bancos portugueses.
📊
Relatórios CFO
Aceda ao balanço, P&L, rácios financeiros e findings de auditoria de qualquer import via API. Resultados persistidos e consultáveis a qualquer momento.
📄
Gerar Anexos NCRF
Gere o Anexo ao Relatório & Contas (NCRF-PE ou NC-ME) directamente em format Word (.docx) ou JSON estruturado. Sem abrir o LUPPA.
🏛️
Descodificador AT
Envie notificações da Autoridade Tributária (PDF ou imagem) e receba prazos, referências de pagamento e rascunho de email em JSON estruturado.
Endpoints disponíveis
Autenticação por Authorization: Bearer lup_*
🔑

Uma chave, uma empresa

Cada chave API tem escopo para uma empresa específica. Gere as suas chaves em Definições → API & Integrações dentro do LUPPA. A chave é mostrada uma única vez — guarde-a em local seguro.

Base
GET /api/v1/ping Verificar ligação e validar chave API
Determinístico
POST /api/saft/ingest Importar SAF-T XML (streaming SSE, até 150 MB+)
Determinístico
Conta
GET /api/v1/company Dados públicos da empresa associada à chave
Determinístico
GET /api/v1/apikeys Listar chaves API activas da empresa
Determinístico
Imports & Relatórios
GET /api/v1/imports Listar os últimos 50 imports SAF-T da empresa
Determinístico
GET /api/v1/imports/:importId Status e metadados de um import específico
Determinístico
GET /api/v1/reports/:importId Relatório CFO completo — findings, resumo financeiro e balancete
Determinístico
Auditoria
POST /api/v1/tax-audit Auditoria fiscal SAF-T — NIFs, gaps de série, erros matemáticos
Determinístico
POST /api/v1/audit/invoice Auditoria de facturas PDF/imagem — NIF, matrícula, IVA, tributações autónomas
✦ IA
POST /api/v1/decoder Descodificador AT — notificação PDF/imagem → prazo, pagamento, email
✦ IA
Reconciliação
POST /api/v1/reconcile Reconciliação SAF-T vs e-Fatura (CSV do Portal das Finanças)
Determinístico
POST /api/v1/reconcile-bank Reconciliação bancária — motor 4 camadas + IA para ambíguos
✦ IA opcional
POST /api/v1/reconcile-third-party Reconciliação de terceiros — SAF-T vs extrato de conta-corrente
✦ IA
Análise & Documentos
POST /api/v1/cfo-insights Análise CFO rápida a partir de SAF-T — métricas e observações
✦ IA
POST /api/v1/annex/generate Gerar Anexo NCRF-PE / NC-ME em Word (.docx) ou JSON
Determinístico
Começar em 3 passos
Do zero ao primeiro resultado em menos de 5 minutos.

1 — Validar a chave

curl
curl https://app.luppaia.pt/api/v1/ping \ -H "Authorization: Bearer lup_xxxx"

2 — Importar SAF-T

curl
curl https://app.luppaia.pt/api/saft/ingest \ -H "Authorization: Bearer lup_xxxx" \ -F "saft_file=@empresa_2025.xml" \ -F "framework=NCRF-PE" # Resposta (SSE — último evento): { "type": "done", "importId": "uuid" }

3 — Obter relatório

curl
curl https://app.luppaia.pt/api/v1/reports/{importId} \ -H "Authorization: Bearer lup_xxxx" # Resposta: { "audit": { "findings": [...], "executive_summary": "..." }, "financial_summary": { "sales": 480000, "net_income": 90000 }, "balances": { /* bucket_id: amount */ } }

📖 Referência completa

Todos os contratos de request/response, exemplos e limites na documentação técnica.

Ver documentação técnica →

Pronto para integrar?

Gere a sua chave API em Definições. Sem aprovações, sem contratos, sem espera.

Gerar Chave API →