Come collegare TREU a ShippyPro

Vediamo come puoi integrare TREU con ShippyPro in pochi passaggi, e come usare il Dynamic Multiparcel per aggiungere colli alla stessa spedizione nel tempo.

Sommario

1. Prima di iniziare
2. Come collegare TREU
3. Servizi supportati
4. Dynamic Multiparcel
5. Opzioni aggiuntive e limitazioni
6. Risoluzione dei problemi ed errori
7. FAQ

1. Prima di iniziare

TREU (Treu Spedition) è uno spedizioniere austriaco. Le spedizioni vengono prenotate tramite ShippingNet e i colli viaggiano sulla rete GLS.

Prima di collegare TREU a ShippyPro, assicurati di avere:

• Un contratto TREU attivo. TREU ti fornisce quattro valori per il tuo account: API Key, Application Name, Pickup Carrier ID e Pickup Relation. Sono specifici per te e non puoi generarli in autonomia.
• Chiavi di test e di produzione separate, se vuoi fare prima dei test. Una API key di test non funziona in produzione, e una chiave di produzione non funziona in test.
• Accesso alle API di ShippyPro. TREU funziona solo con il Dynamic Multiparcel, che si attiva per singola spedizione nella richiesta Ship.

Nota: ogni spedizione TREU viene creata in sospeso. I tuoi colli partono solo quando esegui la closeout (vedi sezione 4.2).

2. Come collegare TREU

Vai alla pagina Carriers e clicca sul logo TREU. Compila i campi qui sotto e clicca su Save.

Nota: ShippyPro non può verificare le credenziali TREU al salvataggio. Se un valore è errato, vedrai l'errore alla creazione della prima spedizione.

Una volta salvato, TREU è disponibile tra i tuoi corrieri e puoi iniziare a creare spedizioni.

3. Servizi supportati

TREU non ha servizi da scegliere: ogni spedizione è di tipo ritiro e consegna, in cui TREU ritira i colli e li consegna.

• Destinazioni: Austria. Le tratte internazionali dipendono dall'instradamento che TREU configura per il tuo account.
• Etichette: etichette GLS in formato ZPL, 100x150 mm, 203 dpi, una per collo.
• Codice di tracking: ogni collo riceve un numero collo GLS. Gli eventi di tracking non sono disponibili in ShippyPro.

4. Dynamic Multiparcel

Con TREU il Dynamic Multiparcel è obbligatorio. Crei un collo per ogni chiamata Ship e ShippyPro raggruppa i colli in un'unica spedizione TREU. La closeout poi rilascia la spedizione.

• Primo collo → spedizione master. ShippyPro apre la spedizione su TREU, in sospeso, e registra il primo collo. Ricevi la sua etichetta e il numero collo GLS.
• Ogni collo successivo → entra nel master. Viene registrato sulla stessa spedizione TREU e riceve una propria etichetta e un proprio numero collo GLS.
• Closeout → spedizione rilasciata. ShippyPro rilascia ogni gruppo su TREU e i colli possono essere ritirati.

4.1 Creare una spedizione Dynamic Multiparcel

Passaggio 1 – Crea il primo collo

Invia una richiesta Ship con IsDynamicMultiparcel: true e un solo collo. ShippyPro apre la spedizione master e restituisce l'etichetta e il numero collo.

Passaggio 2 – Aggiungi i colli successivi

Invia una nuova richiesta Ship con IsDynamicMultiparcel: true per ogni collo aggiuntivo. Ogni collo entra nella spedizione master aperta e riceve una propria etichetta e un proprio numero collo.

Per le regole su quali colli possono entrare nella stessa spedizione master, consulta la documentazione API di ShippyPro – Ship.

Passaggio 3 – Esegui la closeout

Quando hai creato tutti i colli, esegui la closeout (CloseShipments). Solo allora la spedizione viene rilasciata su TREU. Vedi sezione 4.2.

4.2 Closeout

La closeout è obbligatoria per ogni spedizione TREU: finché non la esegui, la spedizione resta in sospeso.

• Ogni gruppo di colli viene rilasciato con una sola chiamata.
• I gruppi sono indipendenti: se un gruppo fallisce, gli altri vengono comunque rilasciati. Solo gli ordini del gruppo fallito mostrano un errore.
• TREU non restituisce alcun manifest o documento di chiusura.

Suggerimento: crea tutti i colli di un gruppo prima di eseguire la closeout. I colli creati dopo la closeout potrebbero non entrare nella spedizione già rilasciata.

Importante: le spedizioni TREU non possono essere cancellate con l'API Void. Per cancellare una spedizione, contatta direttamente TREU.

5. Opzioni aggiuntive e limitazioni

Test Mode

Seleziona Test per inviare le spedizioni all'ambiente di test di TREU. Usa la API key di test fornita da TREU: le chiavi di test e di produzione non sono intercambiabili.

Attenzione: ricordati di deselezionare Test e inserire la API key di produzione prima di iniziare a spedire davvero.

Custom label

Usa Custom label per dare a questo account TREU un nome facile da riconoscere, ad esempio se hai più di una configurazione.

Righe dell'indirizzo

A TREU viene inviata solo la prima riga dell'indirizzo (street1). Assicurati che via e numero civico siano completi nella prima riga.

Non supportato

Modifica o cancellazione delle spedizioni, eventi di tracking, tariffe in tempo reale, contrassegno, assicurazione, etichette di reso, prenotazione ritiri, punti di ritiro, documenti paperless, prova di consegna ed etichette PDF non sono disponibili con TREU.

6. Risoluzione dei problemi ed errori

7. FAQ

Dove trovo le mie credenziali TREU? Te le fornisce TREU: API Key, Application Name, Pickup Carrier ID e Pickup Relation per il tuo account.

Quando partono i miei colli? Solo dopo la closeout. Fino ad allora la spedizione resta in sospeso su TREU.

Posso creare una spedizione TREU senza Dynamic Multiparcel? No. Ogni spedizione TREU deve essere creata con IsDynamicMultiparcel: true, anche se ha un solo collo.

Posso cancellare una spedizione? Non da ShippyPro. Per cancellare una spedizione, contatta direttamente TREU.

Posso testare l'integrazione? Sì. Seleziona Test e usa la API key di test fornita da TREU.

Posso stampare etichette PDF? No. Le etichette TREU sono disponibili solo in ZPL.