API · Risk Scoring · Enterprise

Integre risk scoring no vosso stack
em 48 horas.

API REST com OAuth2 que pontua PMEs em <2 segundos a partir dos últimos 90 dias de receivables reais. Sandbox key disponível mediante NDA — sem RFP, sem committed usage. Enterprise pilots disponíveis hoje.

Endpoints disponíveis

Seis endpoints cobrem ~90% dos casos de uso de bank partners. SDKs em Node/Python/Java/Go disponíveis após sandbox access. Todas as chamadas são registadas no dashboard de observabilidade por tenant.

POST/v1/score

Score em tempo real

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.

POST/v1/score/refresh

Refresh de score

Re-score noturno automático para PMEs ativas no panel. Webhook notifica quando há mudança material (>5 pontos) ou alerta de deterioração.

GET/v1/erp/{provider}/connect

Connect ERP

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.

POST/v1/factoring/operation

Submeter operação

Submeta operação de factoring para o seu banco. Resposta inclui pricing dinâmico, modalidade sugerida (com/sem recurso), e timeline esperado de settlement.

POST/v1/confirming/anchor

Confirming anchor

Setup de programa de confirming para corporate âncora. Inclui supplier portal de white-label, scoring em massa de fornecedores, e settlement window.

GET/v1/index/spreads

Iberian Factoring Index data

Acesso programático aos benchmarks de spread por setor, dimensão e tipo de banco. Atualizado trimestralmente. Útil para pricing committees automatizados.

Exemplo · scorear uma PME via NIF

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")

Spec técnica · resumida

Construído para regulated workloads. PSD3-aligned desde a primeira linha. SLA tier-dependent (99.9% no Starter, 99.95% no Growth, 99.99% + 24/7 no Enterprise).

🔐

OAuth2 · JWT · HMAC webhooks

OAuth 2.1 client_credentials flow. Webhooks assinados com HMAC-SHA256. Per-bank tenant isolation via Row-Level Security. Audit log imutável.

P95 < 2s · 99.9% uptime SLA

Hosted em Supabase eu-west-1 (Dublin). Multi-region failover. Rate limit configurável por tenant (default 1000 req/min · 100k/dia).

🇪🇺

EU data residency · GDPR · DORA

Dados encriptados em rest e em transit. Sem transfer extra-UE. DORA-aligned operational resilience. Banco de Portugal/Banco de España friendly architecture.

🧩

65 ERPs · 67 países · OpenAPI 3.1

65 ERP adapters via factory pattern em 67 países (PT live · ES pilot · 65 markets roadmap). Iberian first (TOC Online · Cegid · PHC · Sage · Moloni · Holded), global registry (TOTVS · Yonyou · 1C · MYOB · Zoho · freee · MISA · Priority …). OpenAPI 3.1 spec · SDKs auto-gerados.

🔁

Idempotency · Webhooks

Cada chamada aceita Idempotency-Key. Webhooks com retry exponencial (3 tentativas em 1h). Eventos: score.updated, operation.approved, deterioration.alert.

📊

Observability incluída

Dashboard de métricas por tenant (latency, error rate, score distribution). Alertas via webhook ou email. Postman collection para QA.

Integre. Score. Aprove. Tudo em 48 horas.

Pricing sob consulta — depende do volume, modelo comercial e condições de parceria. Falem connosco e recebem proposta em 48 horas.