Estamos a construir uma API REST com OAuth2 para pontuar PMEs em <2 segundos a partir dos últimos 90 dias de receivables reais. O sandbox público abre em Q3 2026; até lá, bank partners em conversação ativa têm acesso a um piloto privado mediante NDA + diagnóstico.
Para bank partners em diagnóstico: piloto privado já disponível mediante NDA. Inclui chamadas reais, dados anonimizados, e suporte técnico dedicado. Pedir diagnóstico →
Estes seis endpoints cobrem ~90% dos casos de uso visados para bank partners. A spec abaixo é estável e está a ser implementada — alterações ainda possíveis até GA. SDKs em Node/Python/Java/Go disponíveis a seguir ao sandbox público.
Submeta NIF + último ano de receivables (ou via integração ERP). Resposta inclui score 0-100, breakdown E/S/G, limit recomendado, spread sugerido, fatores de risco. P95 response <2s.
Re-score noturno automático para PMEs ativas no panel. Webhook notifica quando há mudança material (>5 pontos) ou alerta de deterioração.
OAuth flow para conectar TOC Online, Primavera, PHC, Sage, Holded, Odoo e outros 7 ERPs. Gera token reutilizável para refresh contínuo do score.
Submeta operação de factoring para o seu banco. Resposta inclui pricing dinâmico, modalidade sugerida (com/sem recurso), e timeline esperado de settlement.
Setup de programa de confirming para corporate âncora. Inclui supplier portal de white-label, scoring em massa de fornecedores, e settlement window.
Acesso programático aos benchmarks de spread por setor, dimensão e tipo de banco. Atualizado trimestralmente. Útil para pricing committees automatizados.
A chamada mais comum: passar um NIF, receber score + recomendação de pricing. Em produção em <2s.
# Score endpoint — POST /v1/score curl -X POST https://api.advanta.pt/v1/score \ -H "Authorization: Bearer $ADVANTA_KEY" \ -H "Content-Type: application/json" \ -d '{ "nif": "509123456", "country": "PT", "context": { "operation_type": "factoring", "amount_eur": 240000, "expected_term_days": 60 } }' # Response (P95 < 2s) { "score": 78, "tier": "A-", "breakdown": { "financial": 82, "behavioral": 75, "esg": 71 }, "recommendation": { "approved": true, "limit_eur": 240000, "suggested_spread_bps": 180, "modality": "non_recourse" }, "signals": [ { "factor": "DSO trending down", "weight": "+" }, { "factor": "Customer concentration high", "weight": "-" } ], "data_freshness": "2026-04-25T03:14:00Z" }
import { Advanta } from "@advanta/sdk"; const client = new Advanta({ apiKey: process.env.ADVANTA_KEY }); const { score, recommendation, signals } = await client.score({ nif: "509123456", country: "PT", context: { operation_type: "factoring", amount_eur: 240000, expected_term_days: 60 } }); console.log(`Score: ${score} · Suggested spread: ${recommendation.suggested_spread_bps} bps`);
from advanta import Advanta client = Advanta(api_key=os.environ["ADVANTA_KEY"]) result = client.score( nif="509123456", country="PT", context={ "operation_type": "factoring", "amount_eur": 240000, "expected_term_days": 60, }, ) print(f"Score: {result.score} · Spread: {result.recommendation.suggested_spread_bps} bps")
Construído para regulated workloads. PSD3-aligned desde a primeira linha. Targets abaixo refletem a spec final — alguns ítems já em produção interna, outros em finalização.
OAuth 2.1 client_credentials flow. Webhooks assinados com HMAC-SHA256. Per-bank tenant isolation via Row-Level Security. Audit log imutável.
Hosted em Supabase eu-west-1 (Dublin). Multi-region failover. Rate limit configurável por tenant (default 1000 req/min · 100k/dia).
Dados encriptados em rest e em transit. Sem transfer extra-UE. DORA-aligned operational resilience. Banco de Portugal/Banco de España friendly architecture.
Integrações com TOC Online, Primavera, PHC, Sage, Holded, Odoo, Dynamics, Jasmin, NetSuite, SAP. OpenAPI 3.1 spec disponível. SDKs auto-gerados.
Cada chamada aceita Idempotency-Key. Webhooks com retry exponencial (3 tentativas em 1h). Eventos: score.updated, operation.approved, deterioration.alert.
Dashboard de métricas por tenant (latency, error rate, score distribution). Alertas via webhook ou email. Postman collection para QA.
Sandbox público abre em Q3 2026. Bank partners em conversação ativa (diagnóstico de 2 semanas em curso) têm acesso a piloto privado já hoje, mediante NDA. Pré-cadastrados recebem documentação completa + sandbox key 2 semanas antes do GA público.