O căutare, două moduri de conectare
Folosește API-ul JSON într-un script sau într-o aplicație. Pentru un agent care apelează instrumente, conectează serverul MCP. Ambele oferă aceleași șase operații și aceleași date, cu sursele incluse în răspuns.
Agentul tău poate configura conexiunea.
Copiază promptul de instalare și trimite-l agentului. Instrucțiunile includ configurarea MCP și o căutare de verificare pentru Ford.
Pentru agenți: deschide promptul →curl --get 'https://craiova.ro/api/v1/companies/search' \
--data-urlencode 'q=RO6488696'RO6488696, ro 6488696 și 6488696 caută exact același CUI. Poți căuta și după denumirea actuală sau anterioară. Fără un filtru de județ, căutarea acoperă întreaga țară.
Alege firma după denumire, numărul de înmatriculare și localitate, apoi folosește valoarea company_id din rezultat. Mai multe înregistrări pot avea același CUI; identificatorul ales le deosebește. Un rezultat lipsă înseamnă că firma nu este disponibilă în acest serviciu, fără să dovedească inexistența ei.
Ce date poți consulta
| Date | Ce include răspunsul |
|---|---|
| Căutare | Candidați după CUI sau denumire, locul înregistrării și motivul potrivirii. |
| Profilul firmei | Identitate, statut în registrul comerțului, data înregistrării și activități CAEN actuale. |
| Situații financiare | Raportări anuale, anul și formularul, indicatori financiari și numărul de salariați. |
| Stare fiscală | Observații ANAF despre TVA și inactivitate, plus înregistrarea din lista publicată de restanțe. |
| Contracte publice | Contracte ca furnizor sau cumpărător, cu contrapărți, loturi și valori raportate. |
| Urbanism | Autorizații și certificate asociate firmei, rolul acesteia și legătura către registru. |
Datele provin din înregistrările deja preluate de craiova.ro. Cererile nu declanșează o verificare nouă la instituția emitentă. Accesul este numai pentru citire și nu include căutarea persoanelor, reprezentanți, date de contact ori adrese stradale.
Citează datele împreună cu perioada lor
Fiecare răspuns include data, sources, warnings și meta. Citează profilul firmei și sursele indicate, cu anul raportării sau data observației. Momentul retrieved_at arată când ai primit răspunsul, nu când instituția a verificat firma. Metadatele necunoscute rămân null.
Sumele sunt șiruri zecimale exacte, cu currency: "RON" și unit: "lei". Păstrează precizia lor. Datele financiare și contractele asociate unui CUI pot fi comune mai multor înregistrări ale aceleiași firme.
- Absența dintr-o listă ANAF cu prag de publicare nu dovedește lipsa datoriilor.
- Valorile contractelor păstrează regulile sursei pentru republicări, loturi și acorduri-cadru; nu sunt cheltuieli efective.
- Valoarea unui document de urbanism este declarată în document. Un certificat de urbanism nu autorizează lucrări.
Un serviciu comun, cu cereri limitate
API-ul și MCP împart un buget de 60 de cereri pe minut, cu un vârf de până la 5 cereri și cel mult 2 cereri active în același timp, pentru întregul serviciu. Trimite cererile pe rând. La un răspuns 429, așteaptă numărul de secunde din Retry-After înainte de a reîncerca.
O cerere are cel mult 8 KiB, un răspuns complet cel mult 64 KiB, iar timpul maxim al unei cereri este de 8 secunde. Listele folosesc limite mici și, unde este disponibil, un cursor pentru pagina următoare. Detaliile sunt în ghidul API.
Pentru o eroare sau o întrebare despre date, contactează-ne cu adresa profilului și identificatorul cererii, request_id.