Verifică TVA în VIES

Corpul cererii

Se trimite ca JSON, în corpul cererii (Content-Type: application/json) — nu în şirul de interogare.

{
    "tva": [
        "RO17621339"
    ]
}

{
    "tva": [
        "DE811234567"
    ],
    "solicitant": "RO17621339"
}

{
    "tva": [
        "RO17621339",
        "RO6719278"
    ]
}

Parametri de interogare

Cum se comportă

• Corpul are tva — o listă de cel mult 50 de coduri — și, opțional, solicitant, codul propriu al celui care întreabă.
• Trei stări, niciodată două. valid, invalid și indisponibil. La indisponibilitate se întoarce indisponibil, niciodată valid: false — un serviciu picat nu e o dovadă că firma nu există, iar un ERP care le confundă anulează facturi pe bune.
• Pana VIES nu e o eroare a rutei: răspunsul rămâne HTTP 200, iar codul afectat iese indisponibil cu motiv. Contează şi penele „deghizate”: VIES trimite MS_UNAVAILABLE ori o pagină de mentenanţă tot cu HTTP 200 — acelea NU sunt citite ca invalid.
• Dovada consultării. VIES întoarce un număr de consultare doar când primește codul solicitantului. Fără solicitant, primești marca de timp dar numar_consultare lipsește. Cu el, ai ce prezenta la control.
• Cache doar pe rezultatele valide, 10 minute, și niciodată pe cele invalide: un cod poate deveni valid mâine, iar un „invalid" ținut în cache ar respinge un client real. Câmpul din_cache spune dacă răspunsul e live sau memorat, iar consultat_la e marca de timp emisă de VIES, nu ora la care am răspuns noi. Cererile cu solicitant nu se servesc niciodată din cache — dovada trebuie să fie proaspătă.
• Codurile din afara sistemului VIES sunt respinse LOCAL, fără să lovim serviciul Comisiei. Prefixul nu e mereu codul ISO al țării: Grecia folosește EL, iar XI e Irlanda de Nord, rămasă în sistemul TVA al UE pentru bunuri după Brexit.
• Serviciul Comisiei e lent și pică des. De aceea avem ritm pe două niveluri (per utilizator și global) și un circuit care se închide după cinci eșecuri consecutive — dacă VIES e căzut, nu-l mai lovim câteva minute.

La ce folosește

• Verifici codul de TVA al unui client la momentul emiterii facturii, pentru taxare inversă.
• Reverifici periodic baza de clienți intracomunitari, în loturi.
• Obții dovada consultării — marca de timp și numărul de consultare — pentru un control fiscal.

Structura răspunsului

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

Exemple de răspuns

{
    "data": {
        "inregistrari": 1,
        "sumar": {
            "valid": 1,
            "invalid": 0,
            "indisponibil": 0
        },
        "rezultate": [
            {
                "cod": "RO17621339",
                "tara": "RO",
                "numar": "17621339",
                "stare": "valid",
                "denumire": "DANCO EXPRESS S.R.L.",
                "adresa": "MUNICIPIUL  BUCUREŞTI, SECTOR 2 00000 ŞOS. PANTELIMON Nr. 84 Bl. 409B Sc. A Ap. 2",
                "consultat_la": "2026-10-06T20: 39: 55.753Z",
                "din_cache": false
            }
        ],
        "observatie": null
    }
}

{
    "data": {
        "inregistrari": 1,
        "sumar": {
            "valid": 0,
            "invalid": 1,
            "indisponibil": 0
        },
        "rezultate": [
            {
                "cod": "DE811234567",
                "tara": "DE",
                "numar": "811234567",
                "stare": "invalid",
                "consultat_la": "2026-10-06T20: 39: 57.342Z",
                "din_cache": false
            }
        ],
        "observatie": null
    }
}

{
    "data": {
        "inregistrari": 2,
        "sumar": {
            "valid": 2,
            "invalid": 0,
            "indisponibil": 0
        },
        "rezultate": [
            {
                "cod": "RO17621339",
                "tara": "RO",
                "numar": "17621339",
                "stare": "valid",
                "denumire": "DANCO EXPRESS S.R.L.",
                "adresa": "MUNICIPIUL  BUCUREŞTI, SECTOR 2 00000 ŞOS. PANTELIMON Nr. 84 Bl. 409B Sc. A Ap. 2",
                "consultat_la": "2026-10-06T20: 39: 55.753Z",
                "din_cache": true
            }
        ],
        "observatie": null
    }
}

Coduri de eroare

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": "Lipsește tva, sau sunt peste 50 de coduri."
    }
}