Partita IVA (VAT)

Validazione di una partita IVA all'interno dell'Unione Europea

Controlla la validità di una partita IVA

POST https://api.gsped.it/[ISTANZA]/validation/vat

Headers

Name	Type	Description
x-api-key*	String	APIKEY fornita da Gsped

Request Body

Name	Type	Description
country*	String	Nazione c.f. in ISO-2 code
value*	String	Valore p.iva da controllare

200: OK Chiamata corretta

Chiamata effettuata, verificare se valido dalla risposta (campo isValid)

{
    "result": {
        "isValid": true, // riepilogo se valido
        "infos": {
            "userError": "VALID",
            "name": "'GSPED SOCIETA' COOPERATIVA'",
            "address": "CORSO FELICE CAVALLOTTI 15 \n15121 ALESSANDRIA AL\n",
            "originalVatNumber": "02554360061",
            "vatNumber": "02554360061",
            "statusCode": 200 // codice risposta servizio interrogato
        }
    },
    "code": 200 // codice risposta Gsped ripetuto nel payload
}

400: Bad Request Dati non corretti

Campo error con descrizione dell'errore

{
    "error": "country: This value should have exactly 2 characters.",
    "code": 400
}

500: Internal Server Error Errore durante la validazione

{
    "error": "Errore durante il processo di validazione",
    "code": 500
}