Business v1 / Firme

Schelet de factură

Datele firmei pre-completate în forma cerută de e-Factura: denumire, cod fiscal, număr de înmatriculare, adresă, statut de plătitor. Se trimite direct la construirea facturii.

GET

https://oneapi.ro/api/business/v1/firme/{cui}/factura-schelet

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ă

Întoarce datele firmei în forma pregătită pentru un antet de factură (furnizor sau client): denumire, CUI, sediu, TVA. Se împerechează firesc cu modulul e-Factura, care construieşte XML-ul CIUS-RO.

La ce folosește

Pre-completarea antetului de factură cu datele oficiale ale partenerului.
Alimentarea directă a modulului e-Factura, care aşteaptă exact forma asta.
Reducerea erorilor de tastare la introducerea manuală a datelor de facturare.

Structura răspunsului

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

CâmpTipDescriere

cui integer Codul fiscal.

denumire string Denumirea.

nr_reg_com string Numărul de ordine în registrul comerţului.

platitor_tva boolean Plătitoare de TVA la ultima sincronizare.

adresa.judet string Judeţul.

adresa.localitate string Localitatea.

adresa.strada string Strada.

adresa.numar string Numărul de la adresă.

adresa.cod_postal string Codul poştal.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/firme/6719278/factura-schelet

{
    "data": {
        "cui": 6719278,
        "denumire": "MEGA IMAGE SRL",
        "nr_reg_com": "J1994027872407",
        "platitor_tva": true,
        "adresa": {
            "judet": "Bucureşti",
            "localitate": "Bucureşti Sectorul 6",
            "strada": "Timişoara",
            "numar": "26",
            "cod_postal": "61331"
        }
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/14399840/factura-schelet

{
    "data": {
        "cui": 14399840,
        "denumire": "DANTE INTERNATIONAL SA",
        "nr_reg_com": "J2002000372404",
        "platitor_tva": true,
        "adresa": {
            "judet": "Bucureşti",
            "localitate": "Bucureşti Sectorul 6",
            "strada": "Şos. VIRTUŢII",
            "numar": "148",
            "cod_postal": "60787"
        }
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/2054341/factura-schelet

{
    "data": {
        "cui": 2054341,
        "denumire": "SMIRODAVA S.A.",
        "nr_reg_com": "J27/24/1991",
        "platitor_tva": true,
        "adresa": {
            "judet": "Neamţ",
            "localitate": "Municipiul Roman",
            "strada": "B-dul REPUBLICII",
            "numar": "123-125",
            "cod_postal": "5550"
        }
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/24890577/factura-schelet

{
    "data": {
        "cui": 24890577,
        "denumire": "UNIVERS-ALL DISTRIBUTION SRL",
        "nr_reg_com": "J19/1161/2008",
        "platitor_tva": true,
        "adresa": {
            "judet": "Harghita",
            "localitate": "Municipiul Gheorgheni",
            "strada": "POMPIERILOR",
            "numar": "118",
            "cod_postal": "535500"
        }
    }
}

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 [{cui}] negă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."
            ]
        }
    }
}