Come collegare City Express a ShippyPro

City Express (City Express d.o.o., Belgrado) è un corriere espresso serbo che copre la consegna nazionale di pacchi in Serbia. Il connettore supporta la consegna a domicilio, la consegna presso parcel shop e locker, il contrassegno e il ritiro da parte del corriere. ✨

Indice:

Prima di iniziare
Configurazione del corriere
Opzioni aggiuntive
Errori e soluzioni

1. Prima di iniziare

Per procedere con il collegamento avrai bisogno di una API Key fornita da City Express. Questa chiave serve ad autenticare ogni richiesta e viene verificata in tempo reale quando salvi la configurazione su ShippyPro.

Contatta City Express per ottenere la tua API Key prima di procedere con la configurazione.

2. Configurazione del corriere

Vai nella sezione Corrieri e seleziona il logo di City Express. Puoi trovarlo velocemente digitando “City Express” nella barra di ricerca. Una volta individuato, clicca per collegare il corriere e compila i campi richiesti:

Etichetta
Un nome a tua scelta per questa configurazione, visualizzato nell’elenco dei tuoi corrieri su ShippyPro.

API Key
La chiave fornita da City Express. Viene verificata in tempo reale al salvataggio.

Servizio
Standard (l’unico servizio disponibile).

Tipo di etichetta
Scegli tra:

PDF A6 — un’etichetta per pagina (predefinito)
PDF A4 — quattro etichette per foglio

Crea etichetta di reso
Attiva questa opzione per allegare automaticamente un’etichetta di reso nel pacco a ogni spedizione in uscita. L’etichetta di reso riutilizza il barcode della spedizione in uscita ed è contrassegnata con la dicitura “POVRAT”, con mittente e destinatario invertiti.

Modalità test
L’ambiente di test e quello di produzione utilizzano lo stesso endpoint; cambia solo la API Key. Attiva questa opzione se stai usando la chiave di un account di test.

3. Opzioni aggiuntive

Destinazioni

Nazionali: solo Serbia (le spedizioni devono partire e arrivare in Serbia)
Internazionali: NO

Opzioni

Etichetta PDF: Disponibile (A6 e A4)
Etichetta ZPL: NO
Etichetta EPL: NO
Track & Trace: Disponibile
Paperless: NO
PickUp/DropOff (PUDO): Disponibile (circa 650 parcel shop e locker attivi in Serbia)
Contrassegno: Disponibile (solo RSD ed EUR)
Tariffe in tempo reale (Live Rates): Disponibile (una tariffa Standard in RSD, IVA inclusa)
Etichette di reso: Disponibile
Etichette di reso (nel pacco): Disponibile
Prenotazione/programmazione ritiro: Disponibile
Verifica indirizzo: NO
Opzioni corriere: Disponibile
Prova di consegna (POD): NO
Assicurazione: Disponibile (solo RSD ed EUR)
Multicollo: Disponibile
Cancellazione spedizione (Void): NO
CloseOut: NO
CN22: NO
CN23: NO
Verifica credenziali: Disponibile (controllo in tempo reale al salvataggio)

Opzioni corriere

Nome	Slug	Tipo	Descrizione
Consegna al sabato	`saturday_delivery`	checkbox	Richiede la consegna di sabato.
Consegna entro le 12:00	`delivery_until_12`	checkbox	Richiede la consegna entro le 12:00, in base alla disponibilità nella zona di consegna.
Consegna personale	`personal_delivery`	checkbox	Il pacco viene consegnato esclusivamente al destinatario indicato.
Apertura del pacco	`package_opening`	checkbox	Consente al destinatario di aprire e controllare il pacco prima di accettarlo.
Documento di ritorno	`return_document`	checkbox	Il corriere riporta indietro un documento firmato dal destinatario. Questa opzione comporta un aumento del prezzo ed è inclusa nel preventivo della tariffa in tempo reale.

Servizi del corriere

Codice servizio	Nome servizio	Note
`standard`	Standard	Consegna nazionale tramite corriere in Serbia, il giorno lavorativo successivo nella maggior parte delle zone.

Contrassegno

Il contrassegno è supportato solo in RSD ed EUR. Qualsiasi altra valuta verrà rifiutata prima della creazione della spedizione.

Assicurazione

L’assicurazione è supportata solo in RSD ed EUR. Il valore dichiarato viene stampato sull’etichetta come “Vrednost”.

Spedizioni di reso

Le etichette di reso sono supportate. In caso di reso, City Express ritira il pacco presso il cliente finale (mittente) e lo consegna al merchant (destinatario). Il ritiro da parte del corriere viene prenotato automaticamente da City Express al momento della creazione della spedizione di reso: non è necessaria alcuna chiamata aggiuntiva.

Etichetta di reso nel pacco

Quando nella configurazione è attiva l’opzione Crea etichetta di reso, a ogni spedizione in uscita viene allegata automaticamente un’etichetta di reso. L’etichetta di reso riutilizza lo stesso barcode della spedizione in uscita, quindi il codice di tracking del reso è identico a quello della spedizione in uscita.

Prenotazione del ritiro

Il ritiro può essere prenotato all’indirizzo della spedizione. Tieni presente che City Express non mette a disposizione un endpoint per l’annullamento dei ritiri: una volta prenotato, un ritiro non può essere annullato tramite API.

PickUp/DropOff (PUDO)

In Serbia sono disponibili circa 650 parcel shop e locker attivi. I locker sono identificati da un ID numerico, mentre i parcel shop utilizzano un ID alfanumerico. Il punto può essere selezionato tramite il flusso PUDO standard di ShippyPro.

Tariffe in tempo reale

Le tariffe in tempo reale restituiscono un’unica tariffa Standard in RSD, IVA inclusa (20%). Il preventivo include tutte le opzioni di consegna selezionate (contrassegno, documento di ritorno, consegna al sabato), quindi il prezzo visualizzato corrisponde al costo finale della spedizione.

4. Errori e soluzioni

Durante il collegamento o durante la spedizione dei tuoi ordini potresti riscontrare alcuni errori. Niente paura!

API Key non valida (errore 7000)

Se ricevi l’errore 7000, la tua API Key non è corretta o non è riconosciuta. Ricontrolla la chiave fornita da City Express e assicurati che non contenga spazi in eccesso. La chiave viene verificata in tempo reale al salvataggio della configurazione.

Spedizione internazionale non consentita (errore 7094)

City Express supporta solo spedizioni nazionali all’interno della Serbia. Se provi a effettuare una spedizione internazionale con un account nazionale, riceverai l’errore 7094 (DomesticUserInternationalShipmentNotAllowed). Assicurati che sia l’indirizzo del mittente sia quello del destinatario si trovino in Serbia.

Valuta non accettata per contrassegno o assicurazione

Il contrassegno e l’assicurazione sono supportati solo in RSD ed EUR. Se utilizzi una valuta diversa, la spedizione verrà rifiutata prima di essere inviata al corriere. Passa a una delle valute accettate per procedere.

La spedizione non può essere cancellata

La cancellazione è possibile solo prima che la spedizione venga confermata. Poiché ShippyPro conferma la spedizione immediatamente per recuperare l’etichetta, la cancellazione non è disponibile dopo la generazione dell’etichetta.

Errori di validazione in serbo

Alcuni messaggi di errore restituiti da City Express potrebbero essere in serbo. Se non riesci a identificare la causa di un errore, contatta il supporto ShippyPro per ricevere assistenza.