Facturare – Documentație | handelsregister.ai

Prețuri per endpoint și funcție

API-ul facturează în credite. Fiecare cerere costă prețul de bază al endpointului ei, plus funcțiile care returnează date și eventualele suprataxe alese. Prețurile sunt aceleași în orice plan. Planul tău decide ce funcții poți folosi.

Endpoint
Endpoint	Ce	Credite
fetch-organization	Profil companie cu datele de bază	5
fetch-organization	Funcții, vezi tabelul următor	1 până la 80
fetch-organization	Suprataxa pentru Modul AI, chiar și fără potrivire	+20
fetch-organization	Suprataxa pentru Timp real, pentru fiecare preluare live reușită	+10
fetch-person	Profil persoană, cu cercetarea web inclusă (de la Plus)	15
fetch-person	Funcția `shareholdings`, doar când returnează date	+5
fetch-person	Funcția `network` (Pro, Max), doar când returnează date	+25
search-organizations	O pagină de rezultate, chiar și una goală	1
fetch-document	Un document livrat	15
signals	O pagină de Signals sau un singur semnal	20
signals	Catalogul de teme `/v1/signals/catalog`	gratuit
account, auth	Cont, sold, consum, chei, tokenuri și endpointuri webhook	gratuit

Funcțiile fetch-organization le ceri pe rând. Fiecare costă doar când returnează date:

Funcție
Funcție	Conținut	Credite	Plan
related_persons	Administratori	2	orice cont
shareholders	Asociați (Beta)	5	orice cont
shareholders_deep	Asociați detaliat	80	Max
ubos	Beneficiari reali (UBO, Beta)	10	orice cont
shareholdings	Participații (Beta)	5	orice cont
mergers_and_acquisitions	Fuziuni & achiziții (M&A, Beta)	20	orice cont
network	Rețeaua companiei (Beta)	25	Pro, Max
publications	Istoric: publicațiile din registru	1	orice cont
financial_kpi	Indicatori financiari	1	orice cont
balance_sheet_accounts	Bilanț	3	orice cont
profit_and_loss_account	Cont de profit și pierdere	3	orice cont
annual_financial_statements	Situații financiare anuale (Markdown)	5	orice cont
annual_financial_statements__html	Situații financiare anuale (HTML)	5	orice cont
insolvency_publications	Publicații de insolvență	5	orice cont
news	Știri	10	orice cont
website_content	Conținutul site-ului · doar cu Modul AI	gratuit	orice cont

Cu toate funcțiile și ambele suprataxe, o cerere către fetch-organization costă cel mult 215 credite. Acest volum vine cu Max.

Un monitor costă un preț fix per perioadă de 30 zile, în funcție de intervalul de verificare. Crearea și prima bază de referință sunt gratuite.

Interval de verificare
Interval de verificare	Credite per 30 zile
în fiecare zi	50
la fiecare 3 zile	40
la fiecare 7 zile	20
la fiecare 30 zile	10
Fiecare verificare reușită suplimentară din perioadă	+2

Un interval între aceste trepte costă cât următoarea treaptă mai frecventă. Mai multe la account/monitors.

Plătești doar ce returnează date

O funcție fără date nu costă nimic. Dacă returnează null sau o listă goală, nu plătești pentru ea. Asta se aplică fiecărei funcții, inclusiv insolvency_publications: fără anunțuri de insolvență este gratuită.

Prețul de bază și suprataxele au regulile lor. Prețul de bază îl plătești pentru fiecare profil de companie livrat. Modul AI costă chiar și fără potrivire. Timp real costă la fiecare preluare live reușită, chiar dacă nu s-a schimbat nimic în registru. Mai multe la Suprataxe.

La unele funcții contează anumite conținuturi:

shareholders și shareholders_deep costă doar când există intrări actuale. Doar un istoric este gratuit.
mergers_and_acquisitions costă doar cu tranzacții, relații de control sau succesiuni juridice.
network costă doar cu cel puțin o legătură.
news costă de îndată ce lista conține cel puțin un articol.

fetch-organization omite o funcție pe care planul tău nu o include și nu o facturează.

La Căutare & Export, documente și Signals plătești cererea însăși: o pagină de rezultate, un document, o pagină de Signals. Și o căutare fără rezultate și o pagină goală de Signals se facturează.

O cerere eșuată sau respinsă nu costă nimic, vezi Erori.

Suprataxe pentru Modul AI și Timp real

fetch-organization are două suprataxe pe care le activezi per cerere.

Modul AI (ai_search=on-default, +20 credite) găsește compania chiar și din intrări vagi și caută pe web. Se facturează de îndată ce cercetarea a rulat, chiar dacă nu găsește nicio companie sau sursa de date raportează o eroare. Doar când API-ul întrerupe cererea cu 408 nu se facturează.

Timp real (realtime_mode=handelsregister-default, +10 credite) preia live persoanele înscrise din Handelsregister (registrul comerțului). Facturăm suprataxa când preluarea live reușește, indiferent ce returnează. Atunci _realtime_mode.status are valoarea success.

Orice altă valoare acolo înseamnă că preluarea live a eșuat. Primești atunci datele salvate și plătești restul cererii, fără suprataxa pentru Timp real. Dacă cererea durează prea mult, API-ul răspunde cu 408 și nu facturează nimic.

1{2  "name": "Hetzner Online GmbH",3  "_realtime_mode": {4    "mode": "handelsregister-default",5    "status": "success"6  },7  "meta": {8    "request_credit_cost": 15,9    "credits_remaining": 14510  }11}

200 · Răspuns exemplu pentru date de bază cu Timp real: preț de bază plus suprataxă

Costurile în răspuns

Fiecare răspuns îți spune cât a costat. În răspunsurile JSON asta se află în meta, la documente în headere.

Unde
Unde	Semnificație
meta.request_credit_cost	Cât a costat această cerere. La reîncercări cu cheie de idempotență și la aproape toate erorile, este `0`.
meta.credits_remaining	Soldul tău după cerere.
X-Credits-Charged	signals și un document livrat: cât a costat cererea, ca header.
X-Credits-Remaining	Un document livrat: soldul tău după cerere, ca header.

1{2  "name": "Hetzner Online GmbH",3  "meta": {4    "request_credit_cost": 5,5    "credits_remaining": 1456  }7}

200 · Finalul unui răspuns exemplu de la fetch-organization

Respingerile la autentificare (401, 403) și peste limită (429) vin de obicei fără meta. Nu costă niciodată nimic.

Fiecare debitare o găsești la Cont › Consum și prin API la GET /v1/account/usage/transactions, vezi account.

Credite insuficiente

Înainte ca API-ul să proceseze o cerere, verifică dacă soldul tău acoperă costul maxim posibil: prețul de bază, toate funcțiile cerute și suprataxele. Dacă nu, API-ul răspunde cu 402 și nu facturează nimic.

Răspunsul arată acest maxim în meta.request_credit_cost și soldul tău în meta.credits_remaining. Suma facturată ulterior este adesea mai mică, pentru că funcțiile fără date nu costă nimic.

Un exemplu: datele de bază cu Modul AI și funcția ubos au nevoie dinainte de 35 credite. Dacă ubos nu returnează date, cererea costă 25 credite.

signals răspunde cu Problem Details și codul INSUFFICIENT_CREDITS.

Abonament de credite și credite din reîncărcare

Fiecare cont nou primește 150 credite de start. Sunt valabile 30 zile.

Cu un abonament de credite (Plus, Pro, Max sau Enterprise) primești credite în fiecare lună. Sunt valabile până la sfârșitul perioadei de facturare. Dacă îți schimbi planul, iei creditele lunare nefolosite în noua perioadă. De la Plus poți folosi fetch-person; Pro și Max deblochează date suplimentare.

Creditele din reîncărcare le cumperi o singură dată, în plus. Fără abonament de credite sunt valabile 30 zile. Cât timp rulează un abonament de credite, nici creditele din reîncărcare, nici cele de start nu expiră.

Soldul și ce expiră când vezi la Cont › Credite și prin API la GET /v1/account/credits.

Toate planurile și prețurile sunt pe pagina de prețuri.