Come connettere Yamato v2 a ShippyPro

Vediamo come puoi integrare Yamato v2 con ShippyPro in pochi semplici passaggi e iniziare a spedire in tutto il Giappone con Yamato.

Sommario

Prima di iniziare
Step di connessione
Servizi supportati
Opzioni aggiuntive
Errori & Risoluzioni
FAQ

1. Prima di iniziare

Yamato v2 è la nuova integrazione con Yamato, uno dei principali corrieri nazionali giapponesi. Sostituisce la precedente integrazione Yamato e migliora la generazione delle etichette e il tracking.

Prima di connetterti, tieni presente che:

Yamato v2 supporta solo spedizioni nazionali in Giappone (Giappone → Giappone). Le spedizioni internazionali non sono disponibili.
È necessario un account business attivo con Yamato (servizio B2 Cloud).

Richiedi al tuo referente commerciale Yamato le seguenti credenziali:

Token (token API)
API User ID
Invoice Code
Classification Code
Freight Control Number

Se non hai questi dati, contatta il tuo account manager Yamato prima di procedere.

2. Step di connessione

Vai alla pagina Corrieri del tuo account ShippyPro.
Clicca sul logo Yamato v2.
Compila i campi di connessione:

Campo	Obbligatorio	Descrizione
Token	Sì	Il token API fornito da Yamato
API User ID	Sì	Il tuo identificativo utente API Yamato
Invoice Code	Sì	Il tuo codice cliente (invoice code) Yamato
Classification Code	Sì	Il codice di classificazione associato al tuo invoice code
Freight Control Number	Sì	Il tuo numero di controllo spedizioni Yamato
Label Type	Sì	Scegli tra PDF A6 o PDF A5
Service Type	Sì	Il servizio Yamato da utilizzare di default (vedi sezione 3)
Permanent Labels	No	Definisce se le etichette vengono generate come permanenti o nascoste
Test Mode	No	Connette l'ambiente di test di Yamato

Clicca su Connetti per salvare la configurazione.

Il tuo account Yamato v2 è ora connesso e pronto per spedire!

3. Servizi supportati

Servizio	Descrizione
Shipment	Consegna standard, con spese di spedizione prepagate dal mittente
Collect	Consegna con incasso del valore della merce dal destinatario (contrassegno)
Kuroneko Yu-mail	Servizio per invii postali leggeri come cataloghi e materiale stampato
Payment on delivery	Consegna con spese di spedizione a carico del destinatario
Kuroneko Yuupacket / Nekoposu	Servizio per pacchi piccoli e sottili consegnati in cassetta postale
TA-Q-BIN Compact	Servizio per pacchi piccoli con l'apposito box compatto Yamato
Compact Collect	TA-Q-BIN Compact con contrassegno

Yamato v2 supporta inoltre:

Etichette PDF in formato A6 o A5
Track & Trace, con link di tracking che rimanda alla pagina di tracking ShippyPro
Contrassegno, con importo convertito automaticamente in JPY

Non sono supportati: cancellazione delle spedizioni (Void), tariffe in tempo reale, prenotazione del ritiro, etichette di reso, spedizioni multicollo, etichette ZPL/EPL, assicurazione, spedizioni internazionali.

4. Opzioni aggiuntive

Test Mode

Attivando la Test Mode, le spedizioni vengono create nell'ambiente di test di Yamato.

⚠️ Importante: le etichette create in Test Mode non sono valide per spedizioni reali. Ricordati di disattivarla prima di iniziare a spedire.

Opzioni del corriere

Yamato v2 supporta anche i seguenti parametri opzionali a livello di spedizione:

Tax Amount: importo delle tasse inviato con la spedizione
Point ID: consegna presso un centro servizi Yamato invece che all'indirizzo del destinatario
Shipment Date: sovrascrive la data di spedizione (formato AAAAMMGG)
Delivery Date: data di consegna richiesta
Delivery Time Zone: codice della fascia oraria di consegna richiesta

Dati di spedizione

Il campo Note per il corriere viene inviato a Yamato e stampato sull'etichetta; il campo generico Note no.
Il nome dell'Azienda non viene inviato a Yamato, quindi assicurati che il nome del destinatario sia completo.
Se la Descrizione del contenuto è vuota, viene usato di default "Merchandise".
L'ID ordine viene riportato sull'etichetta come secondo riferimento.

5. Errori & Risoluzioni

Errore di autenticazione / Credenziali non valide

Verifica che Token e API User ID siano stati copiati correttamente, senza spazi aggiuntivi. Se l'errore persiste, chiedi a Yamato di confermare che l'accesso API sia attivo.

Invoice code / classification code / freight control number non validi

Questi tre valori devono corrispondere al tuo contratto Yamato. Verificali con il tuo referente commerciale Yamato.

Destinazione non supportata

Yamato v2 supporta solo spedizioni all'interno del Giappone. Le spedizioni verso altri paesi non possono essere create con questo corriere.

Errori sull'indirizzo

Assicurati che l'indirizzo sia completo e suddiviso correttamente: Provincia/Stato = prefettura, Città = città/quartiere, Via = via e numero civico. Campi mancanti o inseriti nel posto sbagliato possono causare il rifiuto della spedizione.

Etichetta non generata / in ritardo

Yamato genera i documenti in più passaggi. Se l'etichetta non è pronta in tempo, attendi qualche minuto e riprova.

Internal Server Error / problemi di connessione

Di solito si tratta di un problema temporaneo lato corriere. Riprova più tardi. Se il problema persiste, contatta il Supporto ShippyPro indicando i dettagli dell'ordine.

6. FAQ

Posso spedire all'estero con Yamato v2?

No, Yamato v2 supporta solo spedizioni nazionali in Giappone.

Dove trovo le mie credenziali?

Tutte le credenziali (Token, API User ID, Invoice Code, Classification Code, Freight Control Number) vengono fornite da Yamato. Contatta il tuo account manager Yamato.

Posso cancellare una spedizione creata con Yamato v2?

No, la cancellazione delle spedizioni non è supportata tramite ShippyPro. Contatta direttamente Yamato se devi annullare una spedizione.

Il contrassegno è supportato?

Sì. L'importo del contrassegno viene convertito automaticamente in yen giapponesi (JPY). Utilizza il servizio Collect o Compact Collect.

Quali formati di etichetta sono disponibili?

PDF A6 e PDF A5. I formati ZPL ed EPL non sono disponibili.

Come posso tracciare le mie spedizioni?

Il tracking è automatico. Una volta creata la spedizione, puoi seguirla da ShippyPro e condividere la pagina di tracking ShippyPro con i tuoi clienti.

Usavo la vecchia integrazione Yamato. Devo riconnettermi?

Sì, Yamato v2 è una nuova integrazione. Connettila dalla pagina Corrieri usando le tue credenziali Yamato.