Business v1 / Nomenclatoare

Detaliu cod CPV

Un cod CPV (vocabularul achizițiilor publice) cu denumirea RO/EN. 404 dacă nu există.

GET

https://oneapi.ro/api/business/v1/cpv/{cod}

Parametri de cale

NumeTipDescriereExemplu

codobligatoriu string Codul CPV al obiectului de achiziţie, cu cifra de control (ex. 03000000-1).

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Un singur cod CPV cu denumirea lui.

La ce folosește

Afişarea denumirii unui cod CPV lângă un contract.
Validarea unui cod primit într-un document.
Traducerea codurilor dintr-un export SEAP în etichete lizibile.

Structura răspunsului

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

CâmpTipDescriere

cod string Codul.

diviziune string | null Diviziunea din ierarhie.

denumire string | null Denumirea.

denumire_en string | null Denumirea în engleză, din nomenclatorul european.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/cpv/03000000-1

{
    "data": {
        "cod": "03000000-1",
        "diviziune": "03",
        "denumire": "Produse agricole, de fermă, de pescuit, de silvicultură şi produse conexe",
        "denumire_en": "Agricultural, farming, fishing, forestry and related products"
    }
}

GEThttps://oneapi.ro/api/business/v1/cpv/30000000-9

{
    "data": {
        "cod": "30000000-9",
        "diviziune": "30",
        "denumire": "Echipament informatic şi accesorii de birou, cu excepţia mobilierului şi a pachetelor software",
        "denumire_en": "Office and computing machinery, equipment and supplies except furniture and software packages"
    }
}

GEThttps://oneapi.ro/api/business/v1/cpv/45000000-7

{
    "data": {
        "cod": "45000000-7",
        "diviziune": "45",
        "denumire": "Lucrări de construcţii",
        "denumire_en": "Construction work"
    }
}

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.
404	negasit	Codul CPV [{cod}] nu există.
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.",
        "detalii": {
            "cod": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}