Versione	Data	Descrizione
1.1.16	2024-04-12	Aggiornata la chiamata API order con l'aggiunta del campo destinatario->codicefiscale richiesto per le spedizioni estere.
1.1.15	2024-01-25	Aggiunta la nuova chiamata API order-fast che, con una unica chiamata, effettua una "quotation", a seguire una "order" e successivamente una "getwaybill", restituendo direttamente la lettera di vettura prodotta, anche in formato Base64. Aggiunta anche la nuova chiamata API getwaybill che restituisce la lettera di vettura, anche in Base64, di uno specifico ordine.
1.1.14	2023-10-17	Aggiornata la risposta alla chiamata getorder con l'aggiunta del campo contrassegno_modalita che riporta "C" per contanti e "A" per assegno.
1.1.13	2023-02-08	Aggiornata la risposta alla chiamata getorder con l'aggiunta del campo url_bordero che riporta l'URL dove scaricare il borderò da consegnare all'autista che ritira la spedizione.
1.1.12	2022-08-31	Aggiornata la risposta alla chiamata order con l'aggiunta del campo id_ordine che riporta l'ID numerico del nuovo ordine creato.
1.1.11	2022-07-14	Aggiornata la chiamata listorder con l'aggiunta della paginazione. E' possibile ora passare 2 nuovi dati: paginazione che definisce la dimesione della lista restituita (default 10, max. 100) e pagina che identifica la pagina da visualizzare (default 1). E' stato anche invertito l'ordine di visualizzazione, dall'ordine più recente al più vecchio. Nella risposta vengono restituiti rispettivamente il numero globale di ordini, il valore della paginazione e la pagina restituita.
1.1.10	2022-06-29	Aggiornata la chiamata listorder con l'aggiunta del nuovo campo di filtro idcustomer che consente di ottenere la lista degli ordini del singolo utente. Nella risposta sono stati aggiunti anche i dettagli dei colli, con misure e pesi.
1.1.9	2022-05-13	Aggiunto errore 132 nella chiamata order per vettori non acquistabili via API.
1.1.8	2022-04-14	Aggiornata la spiegazione della chiamata newcustom con una più corretta descrizione dei campi obbligatori e/o opzionali.
1.1.7	2021-09-16	Aggiornata la chiamata quotation con l'aggiunta del tipo_spedizione = I (import) e del cosa_spedire = P (pallets). Aggiornata la chiamata order che ora accetta il parametro coupon per applicare sconti previsti in apposite campagne. Aggiornata la chiamata tracking che ora accetta come parametro anche il numero di lettera di vettura (ldv). Aggiunta la nuova chiamata checkcoupon che consente di verificare la correttezza e la validità del coupon.
1.1.6	2021-02-18	Aggiornata la chiamata quotation con l'aggiunta del limite massimo per contrassegno e assicurazione.
1.1.5	2021-02-17	Aggiornata la chiamata order con l'aggiunta dei campi di richiesta ritiro spedizione. Aggiornata la risposta della chiamata getorder con l'aggiunta del campo di codice_ritiro spedizione se richiesto.
1.1.4	2021-01-25	Aggiunte le seguenti nuove chiamate: newcustomer, addfund e balance.
1.1.3	2020-05-25	Aggiornata la risposta della chiamata getorder con l'aggiunta dei campi nome_vettore e logo_vettore che contengono rispettivamente il nome del vettore e il suo logo.
1.1.2	2020-05-21	Aggiornata la risposta della chiamata tracking con l'aggiunta del campo codice_prenotazione che sarà compilato solo in caso di richiesta ritiro e solo quando verrà effettivamente lanciato dai sistema automatici.
1.1.1	2020-04-23	Aggiornata la risposta della chiamata quotation per uniformarla alle altre. E' stato aggiunto il campo opzionale version per forzare una risposta in una determinata versione. In caso di assenza, verrà fornita la risposta in base alla versione della APIKEY attivata. Per richiedere un aggiornamento della versione dell'APIKEY, contattateci.
1.1	2020-03-31	Aggiunte le nuove chiamate GetOrder, ListOrder e Tracking.
1.0	2019-12-01	Prima uscita sistema API.

$ch = curl_init("https://api.easyparcel.it/apikeyinfo/c2fbbf11fdb3b18a20d543eeebdb057232c9c20b9ce850d60ce74ec36b0a8a77");                                                                      
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");                        
curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonRequest);                        
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);                        
curl_setopt($ch, CURLOPT_HTTPHEADER, array
	(
		'Content-Type: application/json',
		'Content-Length: ' . strlen($jsonRequest)
	)
);                        
$jsonResult = curl_exec($ch);

{
	"call":"apikeyinfo"
}

Livello 1	Tipo	Valore	Obbligatorio	Descrizione
call	string	apikeyinfo	S	Inserire "apikeyinfo"

La risposta JSON contiene la data di attivazione del servizio e la data della prossima scadenza della licenza d'uso del sistema Easy Parcel API. Contiene anche due parametri di configurazione del pacchetto acquistato che prevedono il blocco del sistema su specifici indirizzi IP dei server dove è installato il sistema del cliente e l'eventuale limite giornaliero di chiamate di tipo "quotation". Contiene anche il credito residuo prepagato che consente di poter procedere con la chiamata API "order" per finalizzare l'acquisto della spedizione, con addebito sul prepagato.

---

N.B.
Il valore del campo live identifica la modalità operativa; in caso sia "false" le chiamate di tipo "order" non perfezionano alcun vero ordine e quindi non decurtano il credito.
Il campo ldv_api può contenere opzionalmente l'indirizzo di un web service del cliente al quale inviare i dati relativi al link del tracking e al link della LDV (lettera di vettura). Sarà a cura del cliente l'operazione di memorizzazione di queste informazioni sul proprio gestionale. La risposta sarà di tipo JSON e conterrà i seguenti campi:

{
	"result": "OK",
	"errorcode": "0",
	"errormessage": "WEBHOOK OK",
	"codice_offerta": "6513ffbc66222",
	"custom": "4102000000001348000003333002",
	"lettera_vettura": "288364I031083",
	"url_ldv": "https://api.easyparcel.it/ldv/LDV_demo.pdf",
	"url_tracking": "https://www.poste.it/cerca/index.html#/risultati-spedizioni/288364I031083"
}
					

La chiamata verrà effettuata al momento della generazione della LDV (nel giro di un paio di minuti dall'ordine).

$ch = curl_init("https://api.easyparcel.it/quotation/c2fbbf11fdb3b18a20d543eeebdb057232c9c20b9ce850d60ce74ec36b0a8a77");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonRequest);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
	'Content-Type: application/json',
	'Content-Length: ' . strlen($jsonRequest))
);
$jsonResult = curl_exec($ch);

{
	"call":"quotation",
	"dettagli":{
		"tipo_spedizione":"N",
		"cosa_spedire":"M",
		"contenuto":"BISCOTTI",
		"accessori":{
			"contrassegno_importo":500
		}
	},
	"colli":[
		{
			"peso":3.000,
			"larghezza":30,
			"profondita":20,
			"altezza":15,
			"nr_colli":1
		}
	],
	"mittente":{
		"cap":"00175",
		"localita":"ROMA",
		"provincia":"RM",
		"nazione":"IT"
	},
	"destinatario":{
		"cap":"20121",
		"localita":"MILANO",
		"provincia":"MI",
		"nazione":"IT"
	}
}

Livello 1	Livello 2	Livello 3	Tipo	Esempio	Obbligatorio	Descrizione
call			string	quotation	S	Inserire quotation
dettagli	idcustomer		numeric	12345	optional	In questo campo può essere indicato l'id del cliente del proprio network sul cui listino calcolare il preventivo.
	tipo_spedizione		string	N	S	N = nazionale E = estero I = import
	cosa_spedire		string	M	S	D = documenti M = merce/pacchi P = pallets
	contenuto		string	BISCOTTI	S	Inserire la descrizione del contenuto
	accessori	contrassegno_importo	decimal	250.00	optional	Indicare l'importo del contrassegno Il servizio potrebbe non essere previsto per alcuni vettori
		assicurazione_importo	decimal	350.00	optional	Indicare l'importo dell'assicurazione Il servizio potrebbe non essere previsto per alcuni vettori
		consegnaalpiano	string	S	optional	S = acquistare N = non acquistare Il servizio potrebbe non essere previsto per alcuni vettori
		consegnasuappuntamento	string	S	optional	S = acquistare N = non acquistare Il servizio potrebbe non essere previsto per alcuni vettori
		priornotice	string	S	optional	S = acquistare N = non acquistare Il servizio "Prior Notice" è acquistabile solo per spedizioni estere dirette negli USA
colli	peso		decimal	3.000	S	Peso complessivo di questa serie di colli, in kg
	larghezza		integer	30	S	Larghezza del singolo collo di questa serie di colli (in cm)
	profondita		integer	20	S	Profondità del singolo collo di questa serie di colli (in cm)
	altezza		integer	15	S	Altezza del singolo collo di questa serie di colli (in cm)
	nr_colli		integer	1	S	Numero di colli con stesse dimensioni di questa serie di colli
mittente	cap		string	00175	S	CAP del mittente
	localita		string	ROMA	S	Località del mittente
	provincia		string	RM	S	Provincia del mittente
	nazione		string	IT	S	Inserire IT
destinatario	cap		string	20121	S	CAP del destinatario
	localita		string	MILANO	S	Località del destinatario
	provincia		string	MI	S	Provincia del destinatario, se spedizione internazionale inserire --
	country		string	IT	Obbligatorio solo su internazionale verso USA e Canada	Country del destinatario, da valorizzare solo per USA (link) e Canada (link)
	nazione		string	IT	S	Nazione del destinatario, usare il codice ISO 3166-1 Alpha-2 (link)

$ch = curl_init("https://api.easyparcel.it/order/c2fbbf11fdb3b18a20d543eeebdb057232c9c20b9ce850d60ce74ec36b0a8a77");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonRequest);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
	'Content-Type: application/json',
	'Content-Length: ' . strlen($jsonRequest))
);
$jsonResult = curl_exec($ch);

{
	"call":"order",
	"dettagli":{
		"codice_offerta":"5dcc4a53b00fc",
		"note_cliente":"ACQUISTO DI TEST",
		"custom":"XYZ123456",
		"accessori":{
			"trackingavanzato":"S"
		}
	},
	"mittente":{
		"nominativo":"Rossi Mario",
		"indirizzo":"Via del Colosseo, 1",
		"email":"mario@rossi.it",
		"telefono":"",
		"cellulare":"3471111111",
		"contatto":"Rossi Mario",
		"codicefiscale":"RSSMRA80A01H501U"
	},
	"destinatario":{
		"nominativo":"Verdi Giuseppe",
		"indirizzo":"Piazza Duomo, 1",
		"email":"giuseppe@verdi.it",
		"telefono":"",
		"cellulare":"3472222222",
		"contatto":"Verdi Giuseppe"
	},
	"ritiro":{
		"prenotazione":"S",
		"dettagli":{
			"ritirodove":"M",
			"disponibile_dal":"2024-04-25",
			"disponibile_ora":"08:00",
			"ritiro_mattina_dalle":"08:00",
			"ritiro_mattina_alle":"12:00",
			"ritiro_pomeriggio_dalle":"14:00",
			"ritiro_pomeriggio_alle":"18:00"
		}
	}
}

Livello 1	Livello 2	Livello 3	Tipo	Esempio	Obbligatorio	Descrizione
call			string	order	S	Inserire order
dettagli	codice_offerta		string	5dcc4a53b00fc	S	Inserire un codice_offerta fra quelli ricevuti in risposta alla precedente chiamata "quotation"
	note_cliente		string	ACQUISTO DI TEST	optional	Inserire un testo di descrizione dell'acquisto
	custom		string	XYZ123456	optional	Campo custom a testo libero per eventuale ricerca ordine
	coupon		string	ILOVEUSA21	optional	Inserire il codice di un eventuale coupon di sconto. N.B. Il coupon dovrebbe prima essere verificato con la chiamata CheckCoupon.
	accessori	contrassegno	string	S	optional	S = acquistare N = non acquistare Il servizio potrebbe non essere previsto per alcuni vettori
		assicurazione	string	S	optional	S = acquistare N = non acquistare Il servizio potrebbe non essere previsto per alcuni vettori
		consegnaalpiano	string	S	optional	S = acquistare N = non acquistare Il servizio potrebbe non essere previsto per alcuni vettori
		consegnasuappuntamento	string	S	optional	S = acquistare N = non acquistare Il servizio potrebbe non essere previsto per alcuni vettori
		trackingavanzato	string	S	optional	S = acquistare N = non acquistare
		priornotice	string	S	optional	S = acquistare N = non acquistare Il servizio "Prior Notice" è acquistabile solo per spedizioni estere dirette negli USA
mittente	nominativo		string	Rossi Mario	S	Nominativo del mittente
	indirizzo		string	Via del Colosseo, 1	S	Indirizzo del mittente
	email		string	mario@rossi.it	S	Indirizzo email del mittente
	telefono		string	0611111111	optional	Telefono fisso del mittente
	cellulare		string	3471111111	S	Cellulare del mittente
	contatto		string	Rossi Mario	S	Contatto del mittente
	codicefiscale		string	RSSMRA80A01H501U	S	Codice fiscale del mittente
destinatario	nominativo		string	Verdi Giuseppe	S	Nominativo del destinatario
	indirizzo		string	Piazza Duomo, 1	S	Indirizzo del destinatario
	email		string	giuseppe@verdi.it	S	Indirizzo email del destinatario
	telefono		string	0222222222	optional	Telefono fisso del destinatario
	cellulare		string	34722222222	S	Cellulare del destinatario
	contatto		string	Verdi Giuseppe	S	Contatto del destinatario
	codicefiscale		string	VRDGPP80A01H501U	optional	Codice fiscale del mittente
ritiro	prenotazione		string	S	optional	S = richiesto N = non richiesto Il servizio consiste nel ritiro della spedizione presso il mittente.
	dettagli	ritirodove	string	M	S	M = presso l'indirizzo del Mittente P = presso l'indirizzo del Point, indicato nel campo idcustomer della chiamata quotation.
		disponibile_dal	date	2024-04-25	S	Data (nel formato AAAA-MM-DD) che identifica da quando la spedizione è disponibile per essere ritirata.
		disponibile_ora	time	08:00	S	Orario (nel formato HH:MM) che identifica da quando la spedizione è disponibile per essere ritirata.
		ritiro_mattina_dalle	time	08:00	S	Orario (nel formato HH:MM) che identifica da quando la spedizione è disponibile per essere ritirata.
		ritiro_mattina_alle	time	12:00	S	Orario (nel formato HH:MM) che identifica da quando la spedizione è disponibile per essere ritirata.
		ritiro_pomeriggio_dalle	time	14:00	S	Orario (nel formato HH:MM) che identifica da quando la spedizione è disponibile per essere ritirata.
		ritiro_pomeriggio_alle	time	18:00	S	Orario (nel formato HH:MM) che identifica da quando la spedizione è disponibile per essere ritirata.

{
	"result":"OK",
	"errorcode":"0",
	"errormessage":"ACQUISTO OK",
	"codice_offerta":"5dcc4a53b00fc",
	"custom":"XYZ123456",
	"ordine":"EAS-5dcc4a53b00fc",
	"id_ordine":"1234567",
	"importo":"6.90",
	"timestamp":"2024-04-25 09:27:54",
	"version":"1.1.16"}

$ch = curl_init("https://api.easyparcel.it/order-fast/c2fbbf11fdb3b18a20d543eeebdb057232c9c20b9ce850d60ce74ec36b0a8a77");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonRequest);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
	'Content-Type: application/json',
	'Content-Length: ' . strlen($jsonRequest))
);
$jsonResult = curl_exec($ch);

{
	"call":"order-fast",
	"details":{
		"client_notes":"TEST-SPEDIZIONE",
		"content_notes":"TEST-CONTENUTO",
		"return_waybill_file":true,
		"customer_id":12345,
		"carrier_code":"SDAM",
		"what_to_ship":"M",
		"custom":"TEST-CUSTOM",
		"accessories":{
			"cash_on_delivery_amount":1000,
			"insurance_amount":500
		},
		"shipment_type":"N"
	},
	"packages":[
		{
			"weight":3.000,
			"width":30,
			"depth":20,
			"height":15,
			"number_of_packages":1
		}
	],
	"sender":{
		"name":"ROSSI MARIO",
		"address":"VIA COLOSSEO, 1",
		"postal_code":"00175",
		"city":"ROMA",
		"province":"RM",
		"country_code":"IT",
		"email":"mario@rossi.it",
		"phone":"",
		"mobile":"3471111111",
		"contact":"ROSSI MARIO",
		"tax_code":"RSSMRA80A01H501U"
	},
	"recipient":{
		"name":"VERDI GIUSEPPE",
		"address":"PIAZZA DUOMO, 1",
		"postal_code":"20121",
		"city":"MILANO",
		"province":"MI",
		"country_code":"IT",
		"email":"giuseppe@verdi.it",
		"phone":"",
		"mobile":"3472222222",
		"contact":"VERDI GIUSEPPE",
		"tax_code":""
	}
}

Livello 1	Livello 2	Livello 3	Tipo	Esempio	Obbligatorio	Descrizione
call			string	order-fast	S	Inserire order-fast
	shipment_type		string	N	S	N = nazionale E = estero I = import
	customer_id		string	12345	opzionale	In questo campo può essere indicato l'id del cliente del proprio network sul cui listino calcolare il preventivo e a cui addebitare l'ordine.
	carrier_code		string	SDAM	S	Inserire il codice del vettore codificato sulla piattaforma.
	what_to_ship		string	M	S	D = documenti M = merce/pacchi P = pallets
	content_notes		string	BISCOTTI	S	Inserire la descrizione del contenuto
	coupon		string	ILOVEUSA21	optional	Inserire il codice di un eventuale coupon di sconto. N.B. Il coupon dovrebbe prima essere verificato con la chiamata CheckCoupon.
	accessories	cash_on_delivery_amount	decimal	250.00	optional	Indicare l'importo del contrassegno Il servizio potrebbe non essere previsto per alcuni vettori
		insurance_amount	decimal	350.00	optional	Indicare l'importo dell'assicurazione Il servizio potrebbe non essere previsto per alcuni vettori
		floor_delivery	string	S	optional	Servizio di "consegna al piano", che potrebbe non essere previsto per alcuni vettori. S = acquistare N = non acquistare (default)
		appointment_delivery	string	S	optional	Servizio di "consegna su appuntamento", che potrebbe non essere previsto per alcuni vettori. S = acquistare N = non acquistare (default)
		trackingavanzato	string	S	optional	S = acquistare N = non acquistare
		prior_notice	string	S	optional	Il servizio "Prior Notice" è acquistabile solo per spedizioni estere dirette negli USA. S = acquistare N = non acquistare (default)
packages	weight		decimal	3.000	S	Peso complessivo di questa serie di colli, in kg
	width		integer	30	S	Larghezza del singolo collo di questa serie di colli (in cm)
	depth		integer	20	S	Profondità del singolo collo di questa serie di colli (in cm)
	height		integer	15	S	Altezza del singolo collo di questa serie di colli (in cm)
	number_of_packages		integer	1	S	Numero di colli con stesse dimensioni di questa serie di colli
sender	name		string	Rossi Mario	S	Nominativo del mittente
	address		string	Via del Colosseo, 1	S	Indirizzo del mittente
	postal_code		string	00175	S	CAP del mittente
	city		string	ROMA	S	Località del mittente
	province		string	RM	S	Provincia del mittente
	country_code		string	IT	S	Inserire IT
	email		string	mario@rossi.it	S	Indirizzo email del mittente
	phone		string	0611111111	optional	Telefono fisso del mittente
	mobile		string	3471111111	S	Cellulare del mittente
	contact		string	Rossi Mario	S	Contatto del mittente
	tax_code		string	RSSMRA80A01H501U	S	Codice fiscale del mittente
recipient	name		string	Verdi Giuseppe	S	Nominativo del destinatario
	address		string	Piazza Duomo, 1	S	Indirizzo del destinatario
	postal_code		string	20121	S	CAP del destinatario
	city		string	MILANO	S	Località del destinatario
	province		string	MI	S	Provincia del destinatario, se spedizione internazionale inserire --
	state_code		string	IT	Obbligatorio solo su internazionale verso USA e Canada	Stato del destinatario, da valorizzare solo per USA (link) e Canada (link)
	country_code		string	IT	S	Nazione del destinatario, usare il codice ISO 3166-1 Alpha-2 (link)
	email		string	giuseppe@verdi.it	S	Indirizzo email del destinatario
	phone		string	0222222222	optional	Telefono fisso del destinatario
	mobile		string	34722222222	S	Cellulare del destinatario
	contact		string	Verdi Giuseppe	S	Contatto del destinatario
pickup	reservation		string	Y	optional	Y = richiesto N = non richiesto (default) Il servizio consiste nel ritiro della spedizione presso il mittente (per alcuni vettori il servizio ha un costo).
	details	pickup_where	string	M	S	M = presso l'indirizzo del Mittente P = presso l'indirizzo del Point, indicato nel campo idcustomer della chiamata quotation.
		available_from	date	2024-04-25	S	Data (nel formato AAAA-MM-DD) che identifica da quando la spedizione è disponibile per essere ritirata.
		available_time	time	08:00	S	Orario (nel formato HH:MM) che identifica da quando la spedizione è disponibile per essere ritirata.
		pickup_morning_from	time	08:00	S	Orario (nel formato HH:MM) che identifica da quando la spedizione è disponibile per essere ritirata.
		pickup_morning_to	time	12:00	S	Orario (nel formato HH:MM) che identifica da quando la spedizione è disponibile per essere ritirata.
		pickup_afternoon_from	time	14:00	S	Orario (nel formato HH:MM) che identifica da quando la spedizione è disponibile per essere ritirata.
		pickup_afternoon_to	time	18:00	S	Orario (nel formato HH:MM) che identifica da quando la spedizione è disponibile per essere ritirata.

$ch = curl_init("https://api.easyparcel.it/getwaybill/c2fbbf11fdb3b18a20d543eeebdb057232c9c20b9ce850d60ce74ec36b0a8a77");                                                                      
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");                        
curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonRequest);                        
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);                        
curl_setopt($ch, CURLOPT_HTTPHEADER, array
	(
		'Content-Type: application/json',
		'Content-Length: ' . strlen($jsonRequest)
	)
);                        
$jsonResult = curl_exec($ch);

{
	"call":"getwaybill",
	"details": {
		"order_id":1234567,
		"waybill_base64":"N"
	}
}

Livello 1	Livello 2	Tipo	Valore	Obbligatorio	Descrizione
call		string	getwaybill	S	Inserire "getwaybill"
details	order_id	numeric	1234567	S	In questo campo dev'essere indicato l'ID dell'ordine per il quale richiedere la lettera di vettura (waybill).
	waybill_base64	string	N	optional	Y = restituisce il contenuto del file della waybill codificato in base64 N = non restituisce il contenuto del file della waybill N.B.Di default se non passato, questo valore viene assunto come N.

La risposta JSON contiene tutti i dati, se presenti, relativi alla Waybill (lettera di vettura), comprensivi del suo numero e della URL dove poter scaricarla. Se nella chiamata è stato inserito il parametro waybill_base64 con il valore Y, allora nella risposta sarà presente anche il campo waybill_base64 che conterrà il contenuto del file della waybill codificato nello standard "base64" che potrà essere salvato e reso disponibile ai clienti.

$ch = curl_init("https://api.easyparcel.it/getorder/c2fbbf11fdb3b18a20d543eeebdb057232c9c20b9ce850d60ce74ec36b0a8a77");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonRequest);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
	'Content-Type: application/json',
	'Content-Length: ' . strlen($jsonRequest))
);
$jsonResult = curl_exec($ch);

{
	"call":"getorder",
	"dettagli":{
		"codice_offerta":"5dcc4a53b00fc",
		"custom":"XYZ123456"
	}
}

Livello 1	Livello 2	Tipo	Esempio	Obbligatorio	Descrizione
call		string	getorder	S	Inserire getorder
dettagli	codice_offerta	string	5dcc4a53b00fc	optional	Inserire un codice_offerta fra quelli ricevuti in risposta ad una precedente chiamata "order". N.B. Se non inserito, diventa obbligatorio il campo custom.
	custom	string	XYZ123456	optional	Inserire un custom fra quelli indicati in una precedente chiamata "order". N.B. Se non inserito, diventa obbligatorio il campo codice_offerta.

{
	"result":"OK",
	"errorcode":0,
	"errormessage":"GETORDER OK",
	"order":{
		"codice_offerta":"5dcc4a53b00fc",
		"data":"2024-01-03 10:41:08",
		"utente":"0",
		"ragionesociale":"ROSSI MARIO",
		"indirizzo":"VIA DEL COLOSSEO, 1",
		"cap":"00175",
		"localita":"ROMA",
		"provincia":"RM",
		"codicefiscale":"RSSMRA80A01H501U",
		"partitaiva":"",
		"telefono":"",
		"cellulare":"3471111111",
		"email":"mario@rossi.it",
		"cosa":"MERCE",
		"peso_totale":"1.000",
		"tipo_spedizione":"N",
		"vettore":"SDAM",
		"nome_vettore":"SDA",
		"logo_vettore":"https://www.easyparcel.it/api/loghi/logo_sda.png",
		"mittente_nominativo":"ROSSI MARIO",
		"mittente_indirizzo":"VIA DEL COLOSSEO, 1",
		"mittente_localita":"ROMA",
		"mittente_provincia":"RM",
		"mittente_cap":"00175",
		"mittente_email":"mario@rossi.it",
		"mittente_telefono":"",
		"mittente_cellulare":"3471111111",
		"mittente_contatto":"ROSSI MARIO",
		"mittente_cf":"RSSMRA80A01H501U",
		"destinatario_nominativo":"VERDI GIUSEPPE",
		"destinatario_indirizzo":"PIAZZA DUOMO, 1",
		"destinatario_localita":"MILANO",
		"destinatario_cap":"20121",
		"destinatario_provincia":"MI",
		"destinatario_nazione":"IT",
		"destinatario_esterocap":null,
		"destinatario_country":null,
		"destinatario_email":"giuseppe@verdi.it",
		"destinatario_telefono":"",
		"destinatario_cellulare":"3472222222",
		"destinatario_contatto":"VERDI GIUSEPPE",
		"consegna":"E",
		"totale_dovuto":"6.90",
		"percentualeiva":"22",
		"importo_tariffa":"10.62",
		"peso_volumetrico":"1.000",
		"contrassegno":"N",
		"contrassegno_importo":"0.00",
		"contrassegno_modalita":"C",
		"assicurazione":"N",
		"assicurazione_importo":"0.00",
		"consegnaalpiano":"N",
		"appuntamento":"N",
		"priornotice":"N",
		"ritiro":"N",
		"ritiro_dove":null,
		"ritiro_disp_data":null,
		"ritiro_disp_ora":null,
		"ritiro_matt_da":null,
		"ritiro_matt_a":null,
		"ritiro_pom_da":null,
		"ritiro_pom_a":null,
		"note_cliente":"ACQUISTO DI TEST",
		"note_contenuto":"BISCOTTI",
		"custom":"XYZ123456",
		"lettera_vettura":null,
		"url_ldv":null,
		"codice_ritiro":null,
		"live":"0",
		"idordine":1234567,
		"url_bordero":"https://api.easyparcel.it/tmp/1234_bordero_20230208160810.pdf"
	},
	"dettagli":[
		{
			"peso":"3.000",
			"larghezza":"30",
			"profondita":"20",
			"altezza":"15",
			"nr_colli":"1"
		}
	],
	"timestamp":"2024-04-25 09:27:54",
	"version":"1.1.16"
}

$ch = curl_init("https://api.easyparcel.it/listorder/c2fbbf11fdb3b18a20d543eeebdb057232c9c20b9ce850d60ce74ec36b0a8a77");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonRequest);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
	'Content-Type: application/json',
	'Content-Length: ' . strlen($jsonRequest))
);
$jsonResult = curl_exec($ch);

{
	"call":"listorder",
	"dettagli":{
		"data_inizio":"2024-01-01",
		"data_fine":"2024-01-15",
		"idcustomer":"12345",
		"paginazione":25,
		"pagina":3
	}
}

Livello 1	Livello 2	Tipo	Esempio	Obbligatorio	Descrizione
call		string	listorder	S	Inserire listorder
dettagli	data_inizio	string	2024-01-01	optional	Inserire una data di inizio periodo nel formato AAAA-MM-GG. N.B. Se non inserita, viene considerata la data odierna.
	data_fine	string	2024-01-15	optional	Inserire una data di fine periodo nel formato AAAA-MM-GG. N.B. Se non inserita, viene considerata la data odierna.
	idcustomer	numeric	12345	optional	Inserire l'ID di un utente sotto la propria rete. N.B. Se non inserito, viene mostrata la lista di tutti gli ordini.
	paginazione	numeric	25	optional	Inserire la dimensione della paginazione ossia il numero di ordini che verranno restituiti dalla chiamata. N.B. Se non inserito, viene mostrata la lista dei primi 10 ordini; la massima paginazione è di 100 ordini.
	pagina	numeric	2	optional	Inserire il numero della pagina da visualizzare. N.B. Se non inserito, viene mostrata la prima pagina della lista degli ordini.

{
	"result":"OK",
	"errorcode":0,
	"errormessage":"LISTORDER OK",
	"nrordini":38,
	"paginazione":25,
	"pagina":2,
	"orders":[
		{
			"codice_offerta":"5dcc4a53b00fc",
			"data":"2020-04-14 18:41:08",
			"cosa":"MERCE",
			"peso_totale":"1.000",
			"tipo_spedizione":"N",
			"vettore":"SDAM",
			"nome_vettore":"SDA",
			"logo_vettore":"https://www.easyparcel.it/api/loghi/logo_sdam.png",				
			"mittente_nominativo":"Rossi Mario",
			"mittente_localita":"ROMA",
			"mittente_provincia":"RM",
			"mittente_cap":"00175",
			"destinatario_nominativo":"Verdi Giuseppe",
			"destinatario_localita":"MILANO",
			"destinatario_cap":"20121",
			"destinatario_provincia":"MI",
			"destinatario_nazione":"IT",
			"destinatario_esterocap":null,
			"destinatario_country":null,
			"consegna":"E",
			"totale_dovuto":"6.90",
			"peso_volumetrico":"1.000",
			"note_cliente":"ACQUISTO DI TEST",
			"note_contenuto":"BISCOTTI",
			"custom":"XYZ123456",
			"lettera_vettura":null,
			"idcustomer":"12345",
			"live":"0",
			"colli":[
				{
					"nr_colli":"1",
					"lunghezza":"10",
					"larghezza":"20",
					"altezza":"30",
					"peso":"3.500"
				}
			]
		},
		{
			"codice_offerta":"5dcc4a53b00fg",
			"data":"2020-04-14 18:55:32",
			"cosa":"MERCE",
			"peso_totale":"3.000",
			"tipo_spedizione":"N",
			"vettore":"SDAM",
			"nome_vettore":"SDA",
			"logo_vettore":"https://www.easyparcel.it/api/loghi/logo_sdam.png",				
			"mittente_nominativo":"Rossi Maria",
			"mittente_localita":"ROMA",
			"mittente_provincia":"RM",
			"mittente_cap":"00178",
			"destinatario_nominativo":"Verdi Giuseppina",
			"destinatario_localita":"MILANO",
			"destinatario_cap":"20128",
			"destinatario_provincia":"MI",
			"destinatario_nazione":"IT",
			"destinatario_esterocap":null,
			"destinatario_country":null,
			"consegna":"E",
			"totale_dovuto":"8.20",
			"peso_volumetrico":"3.000",
			"note_cliente":"ACQUISTO DI TEST",
			"note_contenuto":"VESTITI",
			"custom":"XYZ123457",
			"lettera_vettura":null,
			"idcustomer":"12345",
			"live":"0",
			"colli":[
				{
					"nr_colli":"1",
					"lunghezza":"18",
					"larghezza":"28",
					"altezza":"3",
					"peso":"0.454"
				}
			]
		}
	],
	"timestamp":"2024-01-19 09:31:59"
}

$ch = curl_init("https://api.easyparcel.it/tracking/c2fbbf11fdb3b18a20d543eeebdb057232c9c20b9ce850d60ce74ec36b0a8a77");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonRequest);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
	'Content-Type: application/json',
	'Content-Length: ' . strlen($jsonRequest))
);
$jsonResult = curl_exec($ch);

{
	"call":"tracking",
	"dettagli":{
		"codice_offerta":"5dcc4a53b00fc",
		"custom":"XYZ123456"
	}
}

Livello 1	Livello 2	Tipo	Esempio	Obbligatorio	Descrizione
call		string	tracking	S	Inserire tracking
dettagli	codice_offerta	string	5dcc4a53b00fc	optional	Inserire un codice_offerta fra quelli ricevuti in risposta ad una precedente chiamata "order". N.B. E' obbligatorio indicare un codice_offerta, un custom oppure una ldv.
	custom	string	XYZ123456	optional	Inserire un custom fra quelli indicati in una precedente chiamata "order". N.B. E' obbligatorio indicare un codice_offerta, un custom oppure una ldv.
	ldv	string	288016E049120	optional	Inserire una ldv da ricercare. N.B. E' obbligatorio indicare un codice_offerta, un custom oppure una ldv.

{
	"result":"OK",
	"errorcode":0,
	"errormessage":"TRACKING OK",
	"tracking":{
		"codice_offerta":"5e95d42de07a6",
		"custom":"XYZ123456",
		"lettera_vettura":"288016E049120",
		"url_tracking":"https://www.poste.it/cerca/index.html#/risultati-spedizioni/288364I031083",
		"codice_prenotazione":"CP1234567890"
	},
	"dettagli":[
		{
			"evento_data":"2020-04-15",
			"evento_ora":"12:41",
			"rif_spedizione":"255887",
			"status":"RIT",
			"descrizione":"RITIRATA",
			"note":"LA SPEDIZIONE E' STATA RITIRATA PRESSO IL MITTENTE",
			"filiale":"Catanzaro"
		},
		{
			"evento_data":"2020-04-15",
			"evento_ora":"16:10",
			"rif_spedizione":"255887",
			"status":"PPP",
			"descrizione":"PARTITA",
			"note":"LA SPEDIZIONE E' PARTITA",
			"filiale":"Catanzaro"
		},
		{
			"evento_data":"2020-04-16",
			"evento_ora":"10:54",
			"rif_spedizione":"255887",
			"status":"PPP",
			"descrizione":"PARTITA",
			"note":"LA SPEDIZIONE E' PARTITA",
			"filiale":"Roma Hub Espresso"
		},
		{
			"evento_data":"2020-04-16",
			"evento_ora":"10:54",
			"rif_spedizione":"255887",
			"status":"THE",
			"descrizione":"SMISTATO HUB ED INOLTRATO",
			"note":"IN TRANSITO",
			"filiale":"Roma Hub Espresso"
		},
		{
			"evento_data":"2020-04-17",
			"evento_ora":"04:18",
			"rif_spedizione":"255887",
			"status":"PPP",
			"descrizione":"PARTITA",
			"note":"LA SPEDIZIONE E' PARTITA",
			"filiale":"Hub Espresso Piacenza"
		},
		{
			"evento_data":"2020-04-17",
			"evento_ora":"04:18",
			"rif_spedizione":"255887",
			"status":"THE",
			"descrizione":"SMISTATO HUB ED INOLTRATO",
			"note":"IN TRANSITO",
			"filiale":"Hub Espresso Piacenza"
		}
	],
	"timestamp":"2024-01-19 09:31:59"
}

$ch = curl_init("https://api.easyparcel.it/newcustomer/c2fbbf11fdb3b18a20d543eeebdb057232c9c20b9ce850d60ce74ec36b0a8a77");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonRequest);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
	'Content-Type: application/json',
	'Content-Length: ' . strlen($jsonRequest))
);
$jsonResult = curl_exec($ch);

{
	"call":"newcustomer",
	"dettagli":{
		"cognome":"ROSSI",
		"nome":"MARIO",
		"Indirizzo":"PIAZZA DUOMO, 1",
		"cap":"20121",
		"localita":"MILANO",
		"provincia":"MI",
		"nazione":"IT",
		"email":"mariorossi@gmail.com",
		"telefono":"0212345678",
		"cellulare":"3470123456",
		"ragionesociale":"ROSSI MARIO SLRS",
		"codicefiscale":"RSSMRA11A11A111A",
		"partitaiva":"01234567890",
		"fe_pec":"rossimario@pec.it",
		"fe_sdi":"0000000",
		"banca":null,
		"iban":null,
		"intestazioneconto":null,
		"username":"mariorossi",
		"password":"12345678"
	}
}

Livello 1	Livello 2	Tipo	Esempio	Obbligatorio	Descrizione
call		string	newcustomer	S	Inserire newcustomer
dettagli	cognome	string	ROSSI	S	Inserire il cognome del cliente.
	nome	string	MARIO	S	Inserire il nome del cliente.
	indirizzo	string	PIAZZA DUOMO, 1	S	Inserire l'indirizzo del cliente.
	cap	string	20121	S	Inserire il cap del cliente.
	localita	string	MILANO	S	Inserire la località del cliente.
	provincia	string	MI	S	Inserire la sigla della provincia italiana del cliente. N.B. In caso di cliente estero, compilare questo campo come segue: --
	nazione	string	IT	S	Inserire la sigla della nazione del cliente, usando il codice ISO 3166-1 Alpha-2 (link).
	email	string	mariorossi@gmail.com	S	Inserire l'email del cliente.
	telefono	string	0212345678	optional	Inserire il numero di telefono del cliente.
	cellulare	string	3470123456	optional	Inserire il numero di cellulare del cliente.
	ragionesociale	string	ROSSI MARIO SLRS	optional	Inserire l'eventuale ragione sociale del cliente.
	codicefiscale	string	RSSMRA11A11A111A	S	Inserire il codice fiscale del cliente.
	partitaiva	string	01234567890	optional	Inserire l'eventuale partita Iva del cliente. N.B. Campo obbligatorio se compilato il campo ragionesociale.
	fe_pec	string	marirossi@pec.it	optional	Inserire l'eventuale PEC del cliente. N.B. Campo obbligatorio se compilato il campo ragionesociale (non obbligatorio per cliente estero).
	fe_sdi	string	0000000	S	Inserire l'eventuale SDI del cliente (inserire 0000000 per privato).
	banca	string	CREDITO EMILIANO SPA	optional	Inserire il nome della banca del cliente.
	iban	string	IT1A12341234123412341234123	optional	Inserire l'eventuale IBAN del cliente. N.B. Campo necessario per rimessa contrassegni.
	intestazioneconto	string	ROSSI MARIO	optional	Inserire il nome esatto dell'intestazione del conto bancario del cliente.
	username	string	mariorossi	S	Inserire la username di accesso del cliente.
	password	string	12345678	S	Inserire la password di accesso del cliente.

{
	"result":"OK",
	"errorcode":0,
	"errormessage":"NEWCUSTOMER OK",
	"id_dva":3723,
	"timestamp":"2024-01-19 09:31:59"
	"version":"1.1.16"}

$ch = curl_init("https://api.easyparcel.it/addfund/c2fbbf11fdb3b18a20d543eeebdb057232c9c20b9ce850d60ce74ec36b0a8a77");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonRequest);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
	'Content-Type: application/json',
	'Content-Length: ' . strlen($jsonRequest))
);
$jsonResult = curl_exec($ch);

{
	"call":"addfund",
	"dettagli":{
		"idcustomer":3723,
		"amount":100.00
	}
}

Livello 1	Livello 2	Tipo	Esempio	Obbligatorio	Descrizione
call		string	addfund	S	Inserire addfund
dettagli	idcustomer	numeric	3723	S	Inserire l'ID del cliente al quale girare i fondi.
	amount	decimal	100.00	S	Inserire l'importo da girare al cliente. Il credito master del capofila deve essere maggiore o uguale all'importo da girare al cliente. In caso di importo decimale, utilizzare il PUNTO e non la VIRGOLA come separatore decimale.

{
	"result":"OK",
	"errorcode":0,
	"errormessage":"ADDFUND OK",
	"timestamp":"2024-01-19 09:31:59",
	"version":1.1.14}

$ch = curl_init("https://api.easyparcel.it/balance/c2fbbf11fdb3b18a20d543eeebdb057232c9c20b9ce850d60ce74ec36b0a8a77");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonRequest);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
	'Content-Type: application/json',
	'Content-Length: ' . strlen($jsonRequest))
);
$jsonResult = curl_exec($ch);

{
	"call":"balance",
	"dettagli":{
		"idcustomer":3723
	}
}

Livello 1	Livello 2	Tipo	Esempio	Obbligatorio	Descrizione
call		string	balance	S	Inserire balance
dettagli	idcustomer	numeric	3723	optional	Inserire eventualmente l'ID del cliente del quale si vuole conoscere il credito residuo.

{
	"result":"OK",
	"errorcode":0,
	"errormessage":"BALANCE OK",
	"balance_master":245.90,
	"balance_customer":23.75,
	"timestamp":"2024-01-19 09:31:59",
	"version":1.1.14}

$ch = curl_init("https://api.easyparcel.it/checkcoupon/c2fbbf11fdb3b18a20d543eeebdb057232c9c20b9ce850d60ce74ec36b0a8a77");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonRequest);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
	'Content-Type: application/json',
	'Content-Length: ' . strlen($jsonRequest))
);
$jsonResult = curl_exec($ch);

{
	"call":"checkcoupon",
	"dettagli":{
		"idcustomer":3723,
		"vettore":"UPS21S",
		"peso_totale":8.00,
		"tipo_spedizione":"E",
		"cosa_spedire":"M",
		"provincia":"RM",
		"nazione":"US",
		"coupon" => "ILOVEUSA21"
	}
}

Livello 1	Livello 2	Tipo	Esempio	Obbligatorio	Descrizione
call		string	checkcoupon	S	Inserire checkcoupon
dettagli	idcustomer	numeric	3723	S	Inserire l'ID del cliente proprietario del coupon.
	vettore	string	UPS21S	S	Inserire il codice del vettore.
	peso_totale	string	8.00	S	Inserire il peso complessivo della spedizione.
	tipo_spedizione	string	N	S	N = nazionale E = estero I = import
	cosa_spedire	string	M	S	D = documenti M = merce/pacchi P = pallets
	provincia	string	RM	S	Inserire la sigla della provincia italiana di partenza della spedizione. N.B. In caso di import indicare la provincia italiana di destinazione.
	nazione	string	US	S	Inserire la sigla della nazione di destinazione della spedizione. N.B. In caso di import indicare la nazione di partenza.
	coupon	string	ILOVEUSA21	S	Inserire il codice del coupon da applicare alla spedizione.

{
	"result":"OK",
	"errorcode":0,
	"errormessage":"CHECKCOUPON OK",
	"errordetails":"Previsto sconto del 5%",
	"timestamp":"2024-01-19 09:31:59",
	"version":"1.1.16"}

{
	"result" => "KO",
	"errorcode" => "110",
	"errormessage" => "JSON - Errore sui campi",
	"errordetails" => "Campo 'mittente->cap' mancante o non corretto",
	"timestamp":"2024-01-19 09:31:59"
}

ErrorCode	ErrorMessage	Descrizione
0	NESSUN ERRORE	L'operazione è stata eseguita correttamente.
101	APIKEY - Non valida	Il codice APIKEY utilizzato nella chiamata non risulta una chiave valida.
102	APIKEY - Chiave scaduta	Il codice APIKEY utilizzato nella chiamata è scaduto e necessita del rinnovo per poter continuare a funzionare.
103	APIKEY - Servizio non disponibile per questo indirizzo IP	La chiamata proviene da un indirizzo IP non autorizzato per questo codice APIKEY.
104	APIKEY - Limite giornaliero chiamate superato	La chiamata ha superato il limite giornaliero per questo codice APIKEY.
105	JSON - Manca il file	Manca il file JSON che dev'essere passato alla funzione via POST.
110	JSON - Errore sui campi	Il file JSON passato non rispetta i requisiti per la chiamata. Nel campo errordetails sono dettagliati i valori errati o mancanti.
120	USER Credito esaurito	Il credito residuo non consente di perfezionare l'acquisto.
130	ORDER Già memorizzato	Il codice offerta è già stato elaborato e quindi l'acquisto non è duplicabile. Acquisto non perfezionato.
131	ORDER Errore in fase di memorizzazione	La memorizzazione dell'acquisto non è andata a buon fine. Acquisto non perfezionato. Contattare l'assistenza.
132	ORDER Errore in fase di memorizzazione (2)	La memorizzazione dell'acquisto non è andata a buon fine perché è stato selezionato un vettore che al momento non consente un acquisto via API. Acquisto non perfezionato.
140	NEWCUSTOMER Funzione non disponibile	Funzione non disponibile per questo account.
141	NEWCUSTOMER Errore in fase di memorizzazione	La memorizzazione del nuovo cliente non è andata a buon fine. Contattare l'assistenza.
150	ADDFUND Funzione non disponibile	Funzione non disponibile per questo account.
151	ADDFUND Credito non sufficiente	L'account master non ha credito sufficiente per ricaricare il cliente.
152	ADDFUND Cliente non corretto	Il cliente indicato non esiste o non fa parte del network.
160	BALANCE Funzione non disponibile	Funzione non disponibile per questo account.
161	BALANCE Cliente non corretto	Il cliente indicato non esiste o non fa parte del network.