Identificatori v1 / Vies

Statele din VIES

Statele membre pe care VIES le acceptă, cu prefixul de ţară şi forma codului de TVA din fiecare — înainte de a face o interogare care s-ar întoarce cu „stat necunoscut".

GET

https://oneapi.ro/api/identificatori/v1/vies/state

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Prefixul din codul de TVA NU e mereu codul ISO al țării. Grecia folosește EL, nu GR, iar XI e Irlanda de Nord, care a rămas în sistemul TVA al UE pentru bunuri după Brexit. De aceea răspunsul dă și prefixul, și codul ISO corespunzător.

La ce folosește

Verifici dacă un prefix de TVA e din sistemul VIES, înainte de a trimite codul la verificare.
Populezi un selector de țară într-un formular de facturare intracomunitară.

Structura răspunsului

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

CâmpTipDescriere

inregistrari integer Câte înregistrări are răspunsul.

state[].prefix string Prefixul folosit în codul de TVA.

state[].cod_iso string Codul ISO 3166-1 al țării, care poate diferi de prefix.

state[].nume string Numele țării, în română.

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/vies/state

{
    "data": {
        "inregistrari": 28,
        "state": [
            {
                "prefix": "AT",
                "cod_iso": "AT",
                "nume": "Austria"
            }
        ],
        "observatie": "Prefixul din codul de TVA nu e mereu codul ISO al țării: Grecia folosește `EL`, iar `XI` e Irlanda de Nord, rămasă în sistemul TVA al UE pentru bunuri după Brexit."
    }
}

Coduri de eroare

Cod	Slug	Când apare
401	neautentificat	Token lipsă, invalid, expirat sau revocat.
403	feature_indisponibil	Planul curent nu include funcţia de care ţine ruta.
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."
    }
}