Origination · Flagship API Beta · Internal

Advanta Score.
Risk scoring de PMEs em <2s.

A API flagship da Advanta. 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 <2s. Baseado em receivables reais dos últimos 90 dias — não financeiros de há 12 meses.

Pedir sandbox key ← Ver catálogo de 27 APIs

P95 <2sresponse time em produção

0-100scoring scale + tier breakdown

90 diasde receivables reais usados

13 ERPscobertura PT+ES integrada

Exemplo · POST /v1/score

A chamada mais comum: passar NIF, receber score + recomendação de pricing. Em produção em <2s. Suporta context para origination type, amount, term.

# 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} · 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")

Onde os bancos usam Advanta Score

Três contextos onde o score gera valor imediato. Embebível em qualquer um.

🏦

Branch onboarding

Gestor de relação introduz NIF no balcão · score in <2s · vê limite recomendado + spread + sinais de risco. Faz a venda na hora.

⚡

Origination flow

Embed no fluxo de submissão de operações de Factoring/Confirming · auto-aprova abaixo de threshold · escala humano para casos complexos.

🔄

Continuous monitoring

Refresh nightly de scores em PMEs ativas · webhook quando há mudança material (>5 pontos) ou sinal de deterioração 60 dias antes do default clássico.

Advanta Score.Risk scoring de PMEs em <2s.