Come collegare EMX a ShippyPro

EMX è il corriere espresso di Emirates Post, l'operatore postale nazionale degli Emirati Arabi Uniti. Vediamo come puoi integrare EMX con ShippyPro in pochi semplici passaggi.

Sommario

Prima di iniziare
Come collegare EMX
Servizi supportati
Opzioni aggiuntive
Risoluzione problemi ed errori
FAQ

1. Prima di iniziare

Per collegare EMX ti serve un account business EMX attivo. Chiedi al tuo referente commerciale EMX le seguenti credenziali:

API Key (per le spedizioni)
Tracking API Key (una chiave separata, usata solo per il tracking)
Account Number
Password

Nota bene: EMX è disponibile solo per spedizioni nazionali all'interno degli Emirati Arabi Uniti. Le spedizioni internazionali non sono supportate.

2. Come collegare EMX

Vai alla pagina Corrieri e clicca sul logo EMX.
Compila il form di connessione con i campi indicati sotto.
Clicca su Connetti per salvare. ShippyPro verifica automaticamente le credenziali.

Campo	Descrizione
API Key	La chiave API fornita da EMX per creare e annullare le spedizioni.
Tracking API Key	La chiave API separata fornita da EMX per il tracking.
Account Number	Il tuo numero di account EMX.
Password	La password associata al tuo account EMX.
Service Type	Il servizio EMX da usare per questa connessione (vedi sezione 3).
Label Type	Il formato dell'etichetta. È disponibile solo PDF (A6).
Test mode	Selezionalo per collegarti all'ambiente di test EMX (vedi sezione 4).

Suggerimento: per usare più servizi EMX, aggiungi una connessione EMX per ogni servizio.

3. Servizi supportati

Servizio	Descrizione
Domestic	Consegna nazionale standard.
EMS	Consegna espressa.
Same Day	Consegna in giornata.
Next Day Delivery	Consegna il giorno lavorativo successivo.
Prime Registered	Consegna raccomandata con firma.
Prime Tracked	Consegna tracciata.
Prime Express	Consegna espressa tracciata.
Registered	Consegna raccomandata.
Parcel	Consegna pacchi standard.
Economy Parcel	Consegna pacchi economica.
Standard	Consegna standard.

Con EMX puoi anche usare:

Tracking delle spedizioni
Annullamento spedizione (Void)
Tariffe in tempo reale, IVA inclusa, in AED
Contrassegno (COD): applicato automaticamente quando l'ordine ha un importo in contrassegno
Assicurazione: applicata automaticamente quando l'ordine ha un valore assicurato

4. Opzioni aggiuntive

Test mode: se selezionato, tutte le richieste vanno all'ambiente di test EMX. Le etichette create in test mode non sono valide per spedizioni reali.

⚠️ Ricordati di deselezionare Test mode prima di spedire pacchi reali.

Etichetta personalizzata: puoi assegnare un nome personalizzato alla connessione, ad esempio per distinguere due account o servizi EMX.

Buono a sapersi:

Negli Emirati Arabi Uniti non esistono CAP, quindi il campo CAP può restare vuoto.
Ogni spedizione corrisponde a un solo collo. Le spedizioni multicollo non sono supportate.

5. Risoluzione problemi ed errori

Errore	Soluzione
Credenziali non valide in fase di connessione	Verifica le quattro credenziali con EMX. La Tracking API Key è diversa dall'API Key.
Spedizione internazionale non supportata	EMX spedisce solo negli Emirati Arabi Uniti. Usa un altro corriere per gli ordini internazionali.
Servizio non valido (HTTP 400)	Il servizio selezionato non è attivo sul tuo account EMX. Chiedi a EMX di attivarlo o scegli un altro servizio.
Campo obbligatorio mancante	Nome, telefono, indirizzo e città sono obbligatori per mittente e destinatario.
Internal Server Error	Problema temporaneo di EMX. Attendi qualche minuto e riprova. Se persiste, contatta il supporto ShippyPro.
Timeout di connessione	Verifica che Test mode corrisponda alle credenziali che stai usando, poi riprova.

6. FAQ

Posso spedire all'estero con EMX? No. L'integrazione supporta solo spedizioni nazionali negli Emirati Arabi Uniti.

Quali formati di etichetta sono disponibili? PDF in formato A6. ZPL e A4 non sono disponibili.

Perché servono due API key? EMX usa una chiave per spedizioni e annullamenti e una chiave separata per il tracking. Sono obbligatorie entrambe.

Come spedisco con Next Day Delivery? Seleziona Next Day Delivery nel campo Service Type della connessione EMX.

Posso prenotare un ritiro o usare punti di ritiro? Al momento no. Prenotazione ritiri, punti di ritiro/consegna, etichette di reso e borderò di fine giornata non sono supportati.

Collegare EMX ha un costo aggiuntivo? Collegare EMX a ShippyPro non ha costi aggiuntivi. Le tariffe di spedizione dipendono dal tuo contratto con EMX.

Posso testare l'annullamento in test mode? L'ambiente di test EMX può restituire errori sull'annullamento. Ti consigliamo di testarlo in produzione con una spedizione reale.