Comment connecter EMX à ShippyPro

EMX est le transporteur express d'Emirates Post, l'opérateur postal national des Émirats arabes unis. Voyons comment intégrer EMX à ShippyPro en quelques étapes.

Sommaire

Avant de commencer
Comment connecter EMX
Services pris en charge
Options supplémentaires
Dépannage et erreurs
FAQ

1. Avant de commencer

Pour connecter EMX, vous avez besoin d'un compte professionnel EMX actif. Demandez à votre commercial EMX les identifiants suivants :

API Key (pour les expéditions)
Tracking API Key (une clé distincte, utilisée uniquement pour le suivi)
Account Number
Password

À noter : EMX est disponible uniquement pour les envois nationaux à l'intérieur des Émirats arabes unis. Les envois internationaux ne sont pas pris en charge.

2. Comment connecter EMX

Rendez-vous sur la page Transporteurs et cliquez sur le logo EMX.
Remplissez le formulaire de connexion avec les champs ci-dessous.
Cliquez sur Connecter pour enregistrer. ShippyPro vérifie automatiquement vos identifiants.

Champ	Description
API Key	La clé API fournie par EMX pour créer et annuler les expéditions.
Tracking API Key	La clé API distincte fournie par EMX pour le suivi.
Account Number	Votre numéro de compte EMX.
Password	Le mot de passe associé à votre compte EMX.
Service Type	Le service EMX à utiliser pour cette connexion (voir section 3).
Label Type	Le format d'étiquette. Seul le format PDF (A6) est disponible.
Test mode	Cochez-le pour vous connecter à l'environnement de test EMX (voir section 4).

Astuce : pour utiliser plusieurs services EMX, ajoutez une connexion EMX par service.

3. Services pris en charge

Service	Description
Domestic	Livraison nationale standard.
EMS	Livraison express.
Same Day	Livraison le jour même.
Next Day Delivery	Livraison le jour ouvré suivant.
Prime Registered	Livraison recommandée avec signature.
Prime Tracked	Livraison suivie.
Prime Express	Livraison express suivie.
Registered	Livraison recommandée.
Parcel	Livraison de colis standard.
Economy Parcel	Livraison de colis économique.
Standard	Livraison standard.

Avec EMX, vous pouvez également utiliser :

Le suivi de vos expéditions
L'annulation d'expédition (Void)
Les tarifs en temps réel, TVA incluse, en AED
Le contre-remboursement (COD) : appliqué automatiquement lorsque la commande comporte un montant COD
L'assurance : appliquée automatiquement lorsque la commande comporte une valeur assurée

4. Options supplémentaires

Test mode : lorsqu'il est coché, toutes les requêtes sont envoyées à l'environnement de test EMX. Les étiquettes créées en mode test ne sont pas valables pour de vrais envois.

⚠️ Pensez à décocher Test mode avant d'expédier de vrais colis.

Étiquette personnalisée : vous pouvez donner un nom personnalisé à la connexion, par exemple pour distinguer deux comptes ou services EMX.

Bon à savoir :

Les Émirats arabes unis n'utilisent pas de codes postaux : le champ Code postal peut rester vide.
Chaque expédition correspond à un seul colis. Les envois multi-colis ne sont pas pris en charge.

5. Dépannage et erreurs

Erreur	Solution
Identifiants non valides lors de la connexion	Vérifiez les quatre identifiants auprès d'EMX. La Tracking API Key est différente de l'API Key.
Expédition internationale non prise en charge	EMX expédie uniquement aux Émirats arabes unis. Utilisez un autre transporteur pour les commandes internationales.
Service non valide (HTTP 400)	Le service sélectionné n'est pas activé sur votre compte EMX. Demandez à EMX de l'activer ou choisissez un autre service.
Champ obligatoire manquant	Le nom, le téléphone, l'adresse et la ville sont obligatoires pour l'expéditeur et le destinataire.
Internal Server Error	Problème temporaire côté EMX. Patientez quelques minutes et réessayez. Si le problème persiste, contactez le support ShippyPro.
Délai de connexion dépassé	Vérifiez que Test mode correspond aux identifiants utilisés, puis réessayez.

6. FAQ

Puis-je expédier à l'international avec EMX ? Non. L'intégration prend en charge uniquement les envois nationaux aux Émirats arabes unis.

Quels formats d'étiquette sont disponibles ? PDF au format A6. Les formats ZPL et A4 ne sont pas disponibles.

Pourquoi faut-il deux clés API ? EMX utilise une clé pour les expéditions et les annulations, et une clé distincte pour le suivi. Les deux sont obligatoires.

Comment expédier en Next Day Delivery ? Sélectionnez Next Day Delivery dans le champ Service Type de votre connexion EMX.

Puis-je réserver un enlèvement ou utiliser des points relais ? Pas pour le moment. La réservation d'enlèvements, les points relais, les étiquettes de retour et les manifestes de fin de journée ne sont pas pris en charge.

La connexion d'EMX est-elle payante ? Connecter EMX à ShippyPro n'entraîne aucun coût supplémentaire. Les tarifs d'expédition dépendent de votre contrat avec EMX.

Puis-je tester l'annulation en mode test ? L'environnement de test EMX peut renvoyer des erreurs lors de l'annulation. Nous vous conseillons de la tester en production avec un envoi réel.