Business v1 / Firme

Cale între două firme

Dacă două firme sunt legate şi PRIN CINE: lanţul de persoane care le uneşte, cu rolul fiecăreia în fiecare firmă. Răspunsul spune drumul, nu doar că există.

GET

https://oneapi.ro/api/business/v1/firme/{cui}/conexe/{cui2}

Parametri de cale

NumeTipDescriereExemplu

cuiobligatoriu string Codul de identificare fiscală al firmei, fără prefixul RO (ex. 6719278).

cui2obligatoriu string CUI-ul celei de-a doua firme din pereche — legătura se descrie între {cui} şi {cui2}.

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Caută drumul în graful de conexiuni între două firme: lanţul de persoane comune care le leagă, până la o adâncime dată. Dacă nu există legătură sub prag, întoarce gol.
Aceeaşi căutare de cale, dar prin CUI-urile de capăt, e disponibilă şi la /graf/cale.

La ce folosește

Verificarea unei suspiciuni de afiliere între client şi furnizor.
Documentarea legăturii dintre două părţi ale unei tranzacţii, pentru preţuri de transfer.
Detectarea conflictelor de interese într-o procedură de achiziţie.

Structura răspunsului

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

CâmpTipDescriere

persoane[].id integer Identificatorul intern.

persoane[].nume string Numele.

persoane[].rol_1 string Rolul persoanei în prima firmă a perechii.

persoane[].rol_2 string Rolul persoanei în a doua firmă.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/firme/42154595/conexe/51015782

{
    "data": {
        "persoane": [
            {
                "id": 14208190,
                "nume": "ANCA CĂTĂLIN-DANIEL",
                "rol_1": "administrator",
                "rol_2": "administrator"
            }
        ]
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/6719278/conexe/16114842

{
    "data": {
        "persoane": [
            {
                "id": 16740925,
                "nume": "SPULBER MIHAI-ADRIAN",
                "rol_1": "administrator",
                "rol_2": "administrator"
            }
        ]
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/14399840/conexe/16114842

{
    "data": {
        "persoane": []
    }
}

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	Una din firme 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": {
            "cui": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}