Business v1 / Nomenclatoare

Nomenclator CPV

Codurile CPV (vocabularul comun al achizițiilor publice). ?q= caută după cod sau denumire. Paginat.

GET

https://oneapi.ro/api/business/v1/cpv

Parametri de interogare

NumeTipDescriereValori acceptate

qopțional string | null Cod sau text din denumire. ex. softwareex. Cluj

Cum se comportă

Nomenclatorul CPV (Common Procurement Vocabulary), filtrabil după q, paginat — vocabularul folosit la clasificarea contractelor de achiziţie.

La ce folosește

Popularea unui selector de cod CPV într-o aplicaţie de licitaţii.
Găsirea codului potrivit pornind de la o descriere în cuvinte.
Sincronizarea unui nomenclator local de achiziţii.

Structura răspunsului

CâmpTipDescriere

data[].cod string Codul.

data[].diviziune string | null Diviziunea din ierarhie.

data[].denumire string | null Denumirea.

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

meta.paginare.pagina integer Pagina curentă.

meta.paginare.per_pagina integer Rezultate pe pagină.

meta.paginare.total integer Total rezultate.

meta.paginare.pagini integer Număr de pagini.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/cpv?q=software

{
    "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"
        }
    ],
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 311,
            "pagini": 16
        }
    }
}

GEThttps://oneapi.ro/api/business/v1/cpv?per_pagina=3

{
    "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"
        }
    ],
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 3,
            "total": 9454,
            "pagini": 3152
        }
    }
}

GEThttps://oneapi.ro/api/business/v1/cpv?per_pagina=3&q=Cluj

{
    "data": [],
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 3,
            "total": 0,
            "pagini": 0
        }
    }
}

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	Un parametru nedeclarat ori o valoare care nu trece validarea (`q`). Câmpul vinovat e în `detalii`.
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": "Un parametru nedeclarat ori o valoare care nu trece validarea (q). Câmpul vinovat e în detalii.",
        "detalii": {
            "q": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}