Descrizione
Questo metodo può essere utilizzato per ottenere la lista degli indirizzi associati ad uno specifico cliente all'interno del sistema.
Utilizzo
I parametri richiesti da questa funzione sono:
- customerId: Id del cliente di cui si vogliono ottenere gli indirizzi.
In caso di successo ritorna un'array di oggetti così strutturati:
- addressId: Id dell'indirizzo.
- customerFirstName: Nome del contatto definito nell'indirizzo
- customerLastName: Cognome del contatto definito nell'indirizzo.
- companyName: Nome dell'azienda a cui fa riferimento l'indirizzo.
- companyTaxId: Se impostato contiene la partita IVA dell'azienda.
- customerTaxId: Se impostato contiene il codice fiscale del contatto.
- addressLine1: Indirizzo di residenza o sede dell'azienda.
- addressLine2: Proseguimento dell'indirizzo di residenza o sede dell'azienda.
- cityName: Nome della città
- postCode: Codice di avviamento postale.
- countryId: Id della nazione a cui è associato l'indirizzo. Per ottenere informazioni e lista delle nazioni consultare bGetCountries.
- countryZoneId: Id della zona a cui è associato l'indirizzo. Per ottenere informazioni e lista delle zone consultare bGetCountryZones.
- isDefault: true se l'indirizzo è impostato come indirizzo di riferimento per il cliente, false in caso contrario.
Gestione errori
In caso di errore il metodo genererà un'eccezione che riporterà uno dei seguenti codici di errore:
- ERROR_INVALID_CUSTOMER_ID: L'id del cliente fornito 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'); $customers = $ezPrintSDK->backOffice->bGetCustomers(false); $customerAddresses = $ezPrintSDK->backOffice->bGetCustomerAddresses($customers[0]['customerId']); foreach($customerAddresses as $address) { echo $address['addressId'], ' ', $address['customerFirstName']; } } 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 customers = ezPrintSDK.backOffice.bGetCustomers(false); var customerAddresses = ezPrintSDK.backOffice.bGetCustomerAddresses(customers[0].customerId); customerAddresses.forEach(function(address) { console.log(address.addressId); console.log(address.customerFirstName); }); } 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.customerItem> customers = ezPrintSDK.BackOffice.bGetCustomers(false); List<ezPrintSDKWrapper.Structures.customerAddressItem> customerAddresses = ezPrintSDK.BackOffice.bGetCustomerAddresses(customers[0].customerId); System.Console.WriteLine("Customer Address {0}: {1}", customerAddresses[0].addressId, customerAddresses[0].customerFirstName); } catch (ezPrintException ex) { string ErrorMessage = ex.Message; }