Identificatori v1 / Identificatori

Acoperirea modulului

Ce poate modulul: tipurile de identificatori recunoscuţi, câte coduri avem în nomenclatoare şi ce state acceptă VIES. Punctul de intrare înainte de prima validare.

GET

https://oneapi.ro/api/identificatori/v1/acoperire

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Ruta e gratuită, ca orice rută de acoperire din platformă.
in_baza: false nu e o lipsă: modulul chiar NU are tabele. Toate validările sunt cifre de control și structuri de standard, care nu se importă de nicăieri. Singura sursă externă e VIES, iar singura dependență de alt modul e nomenclatorul de județe din Locations, pentru numerele de înmatriculare.

La ce folosește

Verifici ce tipuri de identificatori acoperim, înainte de a integra.
Afli că modulul n-are date proprii — totul e algoritm de standard, în afară de VIES.

Structura răspunsului

Toate câmpurile de mai jos sunt în data.

CâmpTipDescriere

tipuri integer Câte tipuri de identificatori recunoaștem.

coduri array Codurile lor, în ordinea de specificitate folosită la detecție.

vies.state integer Câte state sunt în sistemul VIES.

vies.maxim_pe_cerere integer Câte coduri de TVA se pot trimite într-o singură cerere.

vies.sursa string

in_baza boolean Mereu false: modulul nu are date proprii.

observatie string Precizare despre cum se citeşte răspunsul: o convenţie de calcul sau o limită a datelor.

Exemple de răspuns

GEThttps://oneapi.ro/api/identificatori/v1/acoperire

{
    "data": {
        "tipuri": 10,
        "coduri": [
            "vin",
            "lei",
            "isin",
            "iban",
            "bic",
            "cnp",
            "numar_auto",
            "eori",
            "gtin",
            "cui"
        ],
        "vies": {
            "state": 28,
            "maxim_pe_cerere": 50,
            "sursa": "Sistemul VIES al Comisiei Europene, interogat live"
        },
        "in_baza": false,
        "observatie": "Modulul NU are date proprii: toate validările sunt algoritmi de standard (cifre de control, structuri). Singura sursă externă e VIES, iar singura dependență de alt modul e nomenclatorul de județe din Locations, pentru numerele de înmatriculare."
    }
}

Coduri de eroare

Cod	Slug	Când apare
401	neautentificat	Token lipsă, invalid, expirat sau revocat.
403	modul_interzis	Tokenul nu are acces la modulul rutei.
422	validare	Ruta nu primeşte parametri, în afară de `lang`: orice alt parametru dă 422, nu e ignorat.
429	cota_depasita	Cota 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": "Ruta nu primeşte parametri, în afară de lang: orice alt parametru dă 422, nu e ignorat."
    }
}