Per iniziare
Endpoint di validazione IVA
Verifica l’autenticità delle partite IVA e recupera informazioni aziendali complete inclusi paese, ragione sociale, indirizzo e dettagli di registrazione.
Endpoint di calcolo IVA
Calcola prezzi conformi all’IVA in base alle normative specifiche per paese, al tipo di acquisto e al valore della transazione per calcoli finanziari accurati.
Endpoint categorie IVA
Accedi alle aliquote IVA attuali e alle categorie fiscali per paesi specifici per garantire la conformità alle normative fiscali locali.
Architettura REST
L’API di validazione IVA segue i principi REST, utilizzando URL prevedibili e orientati alle risorse e codici di stato HTTP standard per un’integrazione fluida e una gestione degli errori efficace. Tutti gli endpoint API devono terminare con una barra finale (/) e supportano solo richieste GET.Sicurezza HTTPS
Tutte le comunicazioni API sono protette con protocolli di crittografia TLS 1.2 o superiore per garantire integrità e privacy dei dati.Versionamento API
L’API di validazione IVA mantiene la retrocompatibilità tramite il versionamento, operando attualmente sulla versione 1 con miglioramenti futuri pianificati.Autenticazione
La tua chiave API funge da credenziale esclusiva per accedere all’API di validazione IVA. Ogni servizio Cleariflow richiede una chiave univoca, garantendo accesso sicuro e isolato tra le diverse API. L’API implementa limiti di frequenza per garantire un uso equo tra tutti gli utenti.Codici di risposta ed errore
Quando le richieste falliscono, l’API restituisce risposte di errore JSON strutturate con codici e descrizioni specifici per una risoluzione efficace dei problemi.| Code | Type | Details |
|---|---|---|
| 200 | OK | Tutto ha funzionato come previsto. |
| 400 | Bad request | Richiesta non valida. |
| 401 | Unauthorized | La richiesta non è stata accettata. Di solito a causa di una chiave API mancante o errata. |
| 422 | Quota reached | La richiesta è stata interrotta per crediti API insufficienti. (Piani gratuiti) |
| 429 | Too many requests | La richiesta è stata interrotta perché è stato raggiunto il numero di richieste consentite al secondo. Succede sui piani gratuiti poiché le richieste sono limitate a 1 al secondo. |
| 500 | Internal server error | La richiesta non è stata completata a causa di un errore lato server. |
| 503 | Service unavailable | Il server non era disponibile. |
Codici paese
Di seguito l’elenco dei paesi supportati dagli endpoint IVA| Country code | Country name |
|---|---|
| AT | Austria |
| BE | Belgium |
| BG | Bulgaria |
| CY | Cyprus |
| CZ | Czech Republic |
| DE | Germany |
| DK | Denmark |
| EE | Estonia |
| FI | Finland |
| FR | France |
| GB | United Kingdom |
| GR | Greece |
| HR | Croatia |
| HU | Hungary |
| IE | Ireland |
| IT | Italy |
| LT | Lithuania |
| LU | Luxembourg |
| LV | Latvia |
| MT | Malta |
| NL | The Netherlands |
| PL | Poland |
| PT | Portugal |
| RO | Romania |
| SE | Sweden |
| SI | Slovenia |
| SK | Slovakia |