oneapi
Autentificare
Business v1 / Nomenclatoare

Un registru (global)

Toate intrările unui registru public, pe toată baza — nu doar pentru o firmă. Fiecare intrare cu încrederea potrivirii nume→CUI, fiindcă registrele publică nume, nu coduri fiscale.

GET
https://oneapi.ro/api/business/v1/registre/{key}

Parametri de cale

NumeTipDescriereExemplu
keyobligatoriu string Cheia registrului sectorial (ansvsa, ong, anmcs…). Lista completă e la /api/business/v1/registre.

Parametri de interogare

NumeTipDescriereValori acceptate
judetopțional string | null Opţional. Codul auto (CJ) ori numele judeţului. max 40 car.
uatopțional integer | null Opţional. Codul SIRUTA al UAT-ului. 1
localitateopțional integer | null Opţional. Codul SIRUTA al localităţii. 1

Cum se comportă

  • Intrările unui registru anume peste toate firmele (nu doar pentru o firmă), paginate. Cheia registrului o iei din lista de la /registre.
  • Filtrele geografice (judet, uat, localitate) lucrează pe loc: locul din registru când acesta îl publică (AFIR, şcoli, servicii sociale dau un cod SIRUTA — locul proiectului ori al unităţii), altfel sediul firmei potrivite. O intrare fără niciunul — fără SIRUTA în registru şi nepotrivită cu o firmă (cui: null) — iese din orice filtru geografic. De aceea registrele cu puţine potriviri (ANSVSA, ONG-uri, TED) întorc, filtrate, mult mai puţin decât au.
  • AFIR dă codul SIRUTA al UAT-ului, nu al satului: acolo filtrul localitate nu găseşte nimic, iar uat e cel potrivit.
  • Un filtru care nu se poate rezolva (judeţ scris greşit, SIRUTA inexistent) întoarce o listă goală, nu registrul întreg.

La ce folosește

  • Descărcarea completă a unui registru de autorizare, paginat.
  • Găsirea tuturor operatorilor autorizaţi dintr-un domeniu, indiferent de firmă.
  • Construirea unei baze proprii de furnizori autorizaţi.

Structura răspunsului

CâmpTipDescriere
data[].cui integer Codul fiscal.
data[].nume string Numele.
data[].incredere string Cât de sigură e potrivirea cu firma.
data[].atribute.judet string Judeţul.
data[].atribute.adresa string Adresa, din atributele brute ale registrului.
data[].atribute.categorie string Categoria.
data[].atribute.nr_autorizatie string Numărul autorizaţiei, din atributele brute.
data[].loc object Locul intrării, ori null când nu se cunoaşte: din registru (SIRUTA din atribute — locul activităţii), altfel sediul firmei potrivite.
data[].loc.judet string Codul auto al judeţului.
data[].loc.uat object UAT-ul {cod_siruta, nume}.
data[].loc.localitate object Localitatea {cod_siruta, nume}; null când registrul dă doar UAT-ul.
data[].loc.din string registru ori sediu_firma — de unde vine locul. Sursele nu se amestecă.
meta.paginare.pagina integer Pagina curentă, numărată de la 1.
meta.paginare.per_pagina integer Câte înregistrări are o pagină.
meta.paginare.total integer Totalul înregistrărilor care se potrivesc, dincolo de pagina curentă.
meta.paginare.pagini integer Câte pagini are lista.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/registre/ansvsa
{
    "data": [
        {
            "cui": 15695879,
            "nume": "Ianoşi Carn SRL",
            "incredere": "exact",
            "loc": {
                "judet": "AB",
                "uat": {
                    "cod_siruta": 1213,
                    "nume": "Aiud"
                },
                "localitate": {
                    "cod_siruta": 1222,
                    "nume": "Aiud"
                },
                "din": "adresa"
            },
            "atribute": {
                "judet": "alba",
                "adresa": "Aiud, str.Grădinii,nr.1",
                "categorie": "Carmangerie",
                "nr_autorizatie": "8/15.02.07"
            }
        }
    ],
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 451712,
            "pagini": 22586
        }
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
404negasitRegistrul [{key}] nu există.
422validareUn parametru nedeclarat ori o valoare care nu trece validarea (judet, uat, localitate). Câmpul vinovat e în detalii.
429cota_depasitaCota lunară a planului a fost depăşită (vezi Retry-After).

Toate erorile au aceeași formă. eroare.cod e stabil și e cel după care trebuie să ramifici în cod — nu după textul din mesaj, care se poate schimba.

{
    "eroare": {
        "cod": "validare",
        "mesaj": "Un parametru nedeclarat ori o valoare care nu trece validarea (judet, uat, localitate). Câmpul vinovat e în detalii.",
        "detalii": {
            "key": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}