Come connettere Yurtici Kargo a ShippyPro

Yurtici Kargo ("Soz Verdigimiz Gibi") è un corriere turco per spedizioni nazionali. Il connettore supporta solo spedizioni verso la Turchia e offre sia etichette per spedizioni in uscita che per i resi. ✨

Sommario:

Prima di iniziare
Configurazione corriere
Opzioni aggiuntive
Errori & Risoluzioni

1. Prima di iniziare

Per procedere con la connessione, avrai bisogno delle credenziali fornite da Yurtici Kargo:

Username e Password per il servizio SOAP
Customer ID — il tuo ID cliente mittente KOPS
Customer Project ID — utilizzato per la generazione del codice di tracking
Sender Address ID — il tuo indirizzo di ritiro registrato presso il corriere (obbligatorio per le spedizioni in uscita)

Contatta Yurtici Kargo per ottenere questi dati prima di procedere con la configurazione su ShippyPro.

2. Configurazione corriere

Accedi alla sezione Corrieri e seleziona il logo di Yurtici Kargo. Puoi trovarlo rapidamente digitando "Yurtici" nella barra di ricerca. Una volta individuato, clicca per collegare il corriere e compila i campi richiesti:

Username: Il tuo nome utente per il servizio SOAP, fornito dal corriere.
Password: La tua password per il servizio SOAP, fornita dal corriere.
Customer ID: Il tuo ID cliente mittente KOPS, utilizzato per le spedizioni in uscita e per il tracking.
Customer Project ID: Utilizzato per la generazione del codice di tracking.
Sender Address ID: Il tuo indirizzo di ritiro registrato presso il corriere (kopsSenderAddressId). Obbligatorio per le spedizioni in uscita — senza questo campo le spedizioni non andranno a buon fine. Non è necessario per i resi.
Shipping range: Intervallo di numerazione seriale per la generazione del codice di tracking. Compilato automaticamente con i valori 1–9999999.
Label Type: Scegli tra:
- PDF A6 (default)
- ZPL 100x100 203dpi
Service Type: Standard (unico servizio disponibile).
Test Mode: Attiva questa opzione per passare all'ambiente sandbox del corriere a scopo di test.

3. Opzioni aggiuntive

Destinazioni

Nazionale: Turchia (TR)
Internazionale: NO

Opzioni

Label PDF: Disponibile (A6)
Label ZPL: Disponibile (100x100 203dpi)
Label EPL: NO
Track & Trace: Disponibile
Paperless: NO
PickUp/DropOff (PUDO): NO
Cash On Delivery: NO
Live Rates: NO
Return Labels: Disponibile
Return Labels (in the box): NO
Book/Schedule Pickup: NO
Address Check: NO
Carrier Options: NO
Proof Of Delivery (POD): NO
Insurance: NO
Multiparcel: NO
Delete Shipment (Void): Disponibile
CloseOut: NO
CN22: NO
CN23: NO
Credentials Validation: NO

Servizi corriere

Codice servizio	Nome servizio
STA	Standard

Assicurazione

Il connettore non invia alcun valore dichiarato. Yurtici Kargo copre i pacchi fino a 20.000 TRY per impostazione predefinita.

Città di destinazione

La città di destinazione deve corrispondere a una delle 81 città turche supportate da Yurtici Kargo. I caratteri diacritici turchi vengono normalizzati automaticamente. Le città non riconosciute restituiranno un errore prima che la richiesta venga inviata al corriere.

4. Errori & Risoluzioni

Durante il tentativo di connessione o durante la spedizione dei tuoi ordini, potresti riscontrare alcuni errori. Niente panico!

La spedizione in uscita fallisce senza errore sul campo Sender Address ID

Le spedizioni in uscita richiedono che il campo Sender Address ID sia compilato. Questo campo è opzionale a livello di form per mantenere la compatibilità con le configurazioni precedenti, ma senza di esso le spedizioni in uscita non andranno a buon fine. Assicurati che sia sempre valorizzato.

Città non riconosciuta

La città di destinazione deve corrispondere esattamente a una delle 81 città turche supportate. Se la città non viene riconosciuta, la spedizione restituirà un errore prima di essere inviata al corriere. Verifica l'ortografia e rimuovi eventuali caratteri non supportati.

Timeout di connessione

Se la tua integrazione va in timeout durante la connessione al corriere, assicurati che il tuo client SOAP stia puntando all'endpoint https. Il corriere serve il servizio SOAP esclusivamente su https — le connessioni tentate su http andranno in timeout.