Descrizione
Questo metodo può essere utilizzato per ottenere la lista delle classi di tassa presenti all'interno del sistema.
Utilizzo
I parametri richiesti da questa funzione sono:
- taxClassId: Id dell'aliquota di imposta di cui si vogliono ottenere informazioni, se impostato a false verranno ritornati tutte le aliquote d'imposta presenti.
- languageId: Id della lingua in cui si volgliono ottenere il nome e la descrizione del gruppo utenti, per le lingue disponibile vedere il metodo getAvailableLanguages.
In caso di successo ritorna un'array di oggetti così strutturati:
- taxClassId: Id della classe di tassa.
- taxClassName: Nome della classe di tassa.
- taxClassDescription: Descrizione della classe di tassa.
- taxRules: Array di oggetti che rappresentano le regole di calcolo della classe di tassa, così composti:
- taxRateId: Id dell'aliquota d'imposta associata alla regola.
- based: Elemento in base a cui viene calcola la regola (shipping = Indirizzo di spedizione, payment = Indirizzo di fatturazione, store = Indirizzo del negozio).
- priority: Numero che rappresenza l'ordine di esecuzione della regola.
- dateCreated: Stringa contenente la data in cui è stato creato il task nel formato YYYY-MM-DD HH:MM:SS.
- dateUpdated: Stringa contenente la data in cui è stato modificato il task nel formato YYYY-MM-DD HH:MM:SS.
Gestione errori
In caso di errore il metodo genererà un'eccezione che riporterà uno dei seguenti codici di errore:
- ERROR_INVALID_PARAMS: Uno dei parametri inviati non è valido.
- ERROR_INVALID_TOKEN: Non è stato effettuato nessun login in precedenza o la sessione è scaduta per inutilizzo.
- ERROR_INVALID_IP: L'indirizzo ip del server che sta effettuando la chiamata non valido perchè non inserito nella whitelist associata alle credenziali.
- ERROR_SERVER_UNAVAILABLE: Il server non è disponibile o si è verificato un errore di comunicazione generico.
PHP
require "vendor/autoload.php"
try {
$ezPrintSDK = new ezPrintSDKWrapper('http://demo.ezprint.it');
$apiToken = $ezPrintSDK->cLoginAPI('1WHm0icsupAEm9fil9en','yCHZ0nKiyn1MU0DhpgmG');
$availableLanguages = $ezPrintSDK->backOffice->bGetAvailableLanguages();
$taxClasses = $ezPrintSDK->backOffice->bGetTaxClasses(false, $availableLanguages[0]['languageId']);
foreach($taxClasses as $taxClass) {
echo $taxClass['taxClassId'], ' ', $taxClass['taxClassName'];
}
} catch (Exception $e) {
echo 'Error Code: ', $e->getMessage();
}
Node.js
try {
var util = require('util');
var ezPrintSDK = require('ezprint-sdk-wrapper');
ezPrintSDK.initializeWrapper('http://demo.ezprint.it');
var apiToken = ezPrintSDK.cLoginAPI('1WHm0icsupAEm9fil9en','yCHZ0nKiyn1MU0DhpgmG');
var availableLanguages = ezPrintSDK.backOffice.bGetAvailableLanguages();
var taxClasses = ezPrintSDK.backOffice.bGetTaxClasses(false, availableLanguages[0].languageId);
taxClasses.forEach(function(taxClass) {
console.log(taxClass.taxClassId);
console.log(taxClass.taxClassName);
});
} catch (ex) {
console.log(ex);
}
.NET (C#)
try {
ezPrintSDKWrapper.Client ezPrintSDK = new ezPrintSDKWrapper.Client("http://demo.ezprint.it");
ezPrintSDK.cLoginAPI("1WHm0icsupAEm9fil9en","yCHZ0nKiyn1MU0DhpgmG");
List<ezPrintSDKWrapper.Structures.languageItem> availableLanguages = ezPrintSDK.BackOffice.bGetAvailableLanguages();
List<ezPrintSDKWrapper.Structures.taxClassItem> taxClasses = ezPrintSDK.BackOffice.bGetTaxClasses(false, availableLanguages[0].languageId);
System.Console.WriteLine("Tax Class {0}: {1}", taxClasses[0].taxClassId, taxClasses[0].taxClassName);
} catch (ezPrintException ex) {
string ErrorMessage = ex.Message;
}