API Magyar Posta

Globe Pickup Points s’intègre à Magyar Posta (MPL), le transporteur postal national hongrois, ce qui permet d’exporter les commandes et d’imprimer les étiquettes d’expédition directement depuis Shopify. Avec cette intégration, vous pouvez :

Exporter vos commandes vers Magyar Posta via l’API MPL v2
Imprimer des étiquettes d’expédition dans Shopify, avec le manifeste EFJ obligatoire inclus dans le même PDF
Expédier vers les points PostaPont, les bureaux de poste, les casiers à colis ou à l’adresse du client
Prendre en charge le paiement à la livraison (PDL) et l’assurance de la valeur du colis
Livrer en Hongrie et dans 24 autres pays européens

Activer l’intégration API Magyar Posta

Dans votre administration Shopify, ouvrez Globe Pickup Points et accédez à Étiquettes d’expédition. Ajoutez un nouveau transporteur et sélectionnez Magyar Posta.
Saisissez votre Clé API et votre Secret API — vous trouverez les deux dans votre compte Magyar Posta. Utilisez Tester la connexion pour les vérifier avant d’enregistrer ; Globe demande un jeton OAuth2 et indique immédiatement si les identifiants sont valides.
Saisissez votre Contrat — votre numéro de contrat Magyar Posta.
Saisissez votre Numéro de compte — votre code comptable client Magyar Posta. Les exports sont rejetés si le numéro de contrat ou le numéro de compte est manquant.
Saisissez votre Numéro de compte bancaire — Magyar Posta l’utilise pour reverser les montants encaissés en paiement à la livraison. Saisissez les 24 chiffres, sans tirets ni espaces ; si votre numéro de compte comporte 16 chiffres (2×8), ajoutez 00000000 à la fin (par exemple 11733003-27329661 devient 117330032732966100000000).
Choisissez la Rétention des colis (jours) — le nombre de jours pendant lesquels Magyar Posta conserve le colis : 0, 5 ou 10.
Renseignez le bloc expéditeur : Nom de l’expéditeur, Rue de l’expéditeur, Code postal de l’expéditeur, Ville de l’expéditeur, Téléphone de l’expéditeur (format international, par exemple +36123456789) et Email de l’expéditeur.
Configurez Expédier les commandes automatiquement et Tagger les commandes avec le numéro de suivi selon vos besoins.
Associez vos méthodes d’expédition Shopify au produit Magyar Posta approprié.

Export des commandes et impression des étiquettes

Vous pouvez exporter vos commandes vers Magyar Posta et imprimer les étiquettes d’expédition directement depuis Shopify, par lots ou une par une. Consultez Créer des étiquettes d’expédition pour le fonctionnement complet.

Chaque colis exporté reçoit un numéro de suivi, utilisé pour le suivi du traitement de la commande et consultable sur la page de suivi Magyar Posta. Si la commande n’a pas de poids, Globe envoie une valeur par défaut de 100 g.

Manifeste (EFJ) et clôture quotidienne

Les coursiers Magyar Posta exigent qu’un manifeste EFJ (Elektronikus Feladójegyzék) leur soit remis avec les colis — sans lui, ils peuvent refuser de prendre l’envoi en charge. Globe s’en occupe pour vous : lorsque vous imprimez les étiquettes, il clôture les expéditions chez Magyar Posta et ajoute le manifeste au même PDF. Le fichier imprimé contient, dans l’ordre :

Les étiquettes d’expédition
Le bon de livraison — le reçu papier que le coursier signe
Le récapitulatif de la liste de dépôt (et une liste de dépôt palettes, si le lot contient des palettes)

Le PDF généré est conservé : les réimpressions sont donc instantanées et n’échouent jamais avec une erreur « déjà clôturé ». Si le manifeste ne peut pas être généré, Globe renvoie tout de même les étiquettes et vous avertit que le manifeste doit être produit séparément avant l’arrivée du coursier.

Produits

Associez chaque méthode d’expédition Shopify au produit Magyar Posta prévu dans votre contrat :

Produit	Code de service MPL	Description
Business Parcel	`A_175_UZL`	Service de colis professionnel sous contrat
Postal Parcel	`A_177_MPC`	Service de colis postal standard

Points de retrait ou livraison à domicile

Le mode de livraison est déduit automatiquement du point de retrait sélectionné par le client au paiement :

Choix du client	Mode de livraison MPL
PostaPont	`PP`
Bureau de poste	`PM`
Casier à colis (Csomagautomata)	`CS`
Aucun point de retrait — adresse de livraison	`HA` (livraison à domicile)

Les expéditions vers un casier à colis sont toujours déposées avec la taille de colis L, car Magyar Posta exige une taille pour les livraisons en casier.

Paiement à la livraison (PDL)

Magyar Posta prend en charge le paiement à la livraison. Lorsqu’une commande utilise un moyen de paiement à la livraison, Globe ajoute le service supplémentaire correspondant et transmet le montant du paiement à la livraison avec l’expédition. Les montants encaissés sont reversés par virement bancaire sur le numéro de compte bancaire configuré sur le transporteur — assurez-vous qu’il est saisi sur 24 chiffres.

Les commandes passées en HUF sont en outre assurées à hauteur de leur valeur (plafonnée au maximum Magyar Posta de 2 000 000 HUF). Les commandes dans d’autres devises sont exportées sans assurance de valeur.

Statut de livraison

La synchronisation des statuts de livraison n’est pas disponible pour Magyar Posta : les statuts des colis ne sont pas réécrits dans la commande. Les traitements Shopify comportent tout de même le numéro de suivi MPL et le lien vers la page de suivi Magyar Posta. Les étiquettes de retour ne sont pas prises en charge non plus.

Impression des étiquettes

Magyar Posta offre le plus grand choix de formats d’étiquettes de tous les transporteurs de Globe. Choisissez celui qui correspond à votre imprimante et à vos consommables :

Format	Description
`A4`	Étiquette d’adresse pleine page A4, 210 × 297 mm
`A5`	Étiquette A5 placée en haut d’une feuille A4
`A5inA4`	Deux étiquettes A5 paysage sur une feuille A4
`A5E`	Étiquette A5 paysage sans les deux volets supplémentaires
`A5E_EXTRA`	Étiquette A5 paysage avec les deux volets supplémentaires
`A5E_STAND`	Étiquette A5 portrait sans les deux volets supplémentaires
`A6`	Étiquette A6, 148,5 × 105 mm
`A6inA4`	Quatre étiquettes A6 sur une feuille A4
`A4ONE`	Étiquette et liste de dépôt d’un seul colis sur une feuille A4

Les étiquettes sont toujours produites au format PDF et l’impression commence toujours à la première position — il n’y a pas de décalage pour planche partiellement utilisée avec Magyar Posta. Le numéro de téléphone et l’adresse e-mail du destinataire sont imprimés sur l’étiquette.

Dépannage

Problème	Solution
Erreur d’authentification	La clé API ou le secret API est incorrect. Saisissez-les de nouveau et appuyez sur Tester la connexion — la connexion doit être signalée comme réussie.
Erreur de configuration — contrat ou numéro de compte manquant	Le Contrat et le Numéro de compte sont tous deux obligatoires. Renseignez-les et exportez de nouveau.
Ville / code postal / adresse / nom du destinataire manquant	L’adresse de livraison Shopify est incomplète. Complétez l’adresse sur la commande avant d’exporter.
Erreur de validation avec un paramètre et un code	Magyar Posta a rejeté les données de l’expédition. Le message indique le champ en cause — corrigez-le sur la commande ou dans les paramètres du transporteur, puis exportez de nouveau.
Aucun numéro de suivi trouvé — impossible d’imprimer les étiquettes	La commande n’a jamais été exportée correctement. Exportez-la d’abord, puis imprimez.
Avertissement : échec de la génération du manifeste	Les étiquettes ont été imprimées mais le manifeste EFJ est absent. Réimprimez, ou produisez le manifeste avant l’arrivée du coursier — Magyar Posta peut refuser les colis sans manifeste.
Montant du paiement à la livraison non reversé	Vérifiez le Numéro de compte bancaire — il doit comporter exactement 24 chiffres, sans tirets ni espaces.

Add Magyar Posta pickup points to your Shopify store — pricing, demo & setup →