Business v1 / Firme

Datorii la buget

Datoriile firmei la bugetul general (din registrul ANAF), defalcate pe tip de obligație.

GET

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

Parametri de cale

NumeTipDescriereExemplu

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

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

„Nu are” e un răspuns, nu o eroare. Când firma există, dar n-are ce cere ruta, răspunsul e 200 cu data: null şi motivul în meta.fara_date. 404 înseamnă doar că firma (CUI-ul) nu există — aşa poţi deosebi cele două cazuri şi poţi păstra în cache răspunsul negativ.
Datoriile firmei la bugetul de stat, din listele publice ANAF de debitori. Absenţa unei firme din listă nu garantează lipsa datoriilor — se publică doar ce apare în sursă.

La ce folosește

Verificarea de risc înainte de a acorda un termen de plată.
Trierea unui portofoliu de clienţi după expunerea la buget.
Monitorizarea partenerilor: alertă când apar în listele publice de debitori.

Structura răspunsului

CâmpTipDescriere

data.valabil_de_la string | null De când e valabilă situaţia raportată.

data.datorii.segment string Segmentul de contribuabil pe care îl raportează ANAF (mari, mijlocii, restul).

data.datorii.obligatii.stat.accesorii integer Accesorii (dobânzi, penalităţi) la bugetul de stat.

data.datorii.obligatii.stat.contestate integer Sume contestate la bugetul de stat.

data.datorii.obligatii.stat.principale integer Debit principal la bugetul de stat.

data.datorii.obligatii.somaj.accesorii integer Accesorii la fondul de şomaj.

data.datorii.obligatii.somaj.contestate integer Sume contestate la fondul de şomaj.

data.datorii.obligatii.somaj.principale integer Debit principal la fondul de şomaj.

data.datorii.obligatii.sanatate.accesorii integer Accesorii la fondul de sănătate.

data.datorii.obligatii.sanatate.contestate integer Sume contestate la fondul de sănătate.

data.datorii.obligatii.sanatate.principale integer Debit principal la fondul de sănătate.

data.datorii.obligatii.asig_sociale.accesorii integer Accesorii la asigurările sociale.

data.datorii.obligatii.asig_sociale.contestate integer Sume contestate la asigurările sociale.

data.datorii.obligatii.asig_sociale.principale integer Debit principal la asigurările sociale.

data.datorii.total_datorii integer Totalul datoriilor, în lei.

meta.fara_date string Doar când răspunsul e gol: de ce nu există date (de pildă „Firma nu are cod LEI înregistrat la GLEIF.”). Lipseşte când data e completat.

meta.fara_date_cod string Cuvântul scurt şi STABIL al motivului, pentru clienţii care comută pe el în cod: fara_date e proză şi se poate reformula, ăsta nu.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/firme/6719278/datorii

{
    "data": {
        "valabil_de_la": null,
        "datorii": {
            "segment": "mari",
            "obligatii": {
                "stat": {
                    "accesorii": 0,
                    "contestate": 24569530,
                    "principale": 24569530
                },
                "somaj": {
                    "accesorii": 0,
                    "contestate": 0,
                    "principale": 0
                },
                "sanatate": {
                    "accesorii": 0,
                    "contestate": 0,
                    "principale": 0
                },
                "asig_sociale": {
                    "accesorii": 0,
                    "contestate": 0,
                    "principale": 0
                }
            },
            "total_datorii": 24569530
        }
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/14399840/datorii

{
    "data": null,
    "meta": {
        "fara_date": "Firma nu apare în lista ANAF a datoriilor la bugetul general.",
        "fara_date_cod": "fara_date_fiscale"
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/199150/datorii

{
    "data": {
        "valabil_de_la": null,
        "datorii": {
            "segment": "mari",
            "obligatii": {
                "stat": {
                    "accesorii": 0,
                    "contestate": 0,
                    "principale": 667619
                },
                "somaj": {
                    "accesorii": 0,
                    "contestate": 0,
                    "principale": 0
                },
                "sanatate": {
                    "accesorii": 0,
                    "contestate": 0,
                    "principale": 0
                },
                "asig_sociale": {
                    "accesorii": 0,
                    "contestate": 0,
                    "principale": 0
                }
            },
            "total_datorii": 667619
        }
    }
}

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	Firma cu CUI [{cui}] nu a fost găsită.
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."
            ]
        }
    }
}