API Slovenská pošta

Globe Pickup Points s’intègre à Slovenská pošta, l’opérateur postal slovaque, via son API WebEPH, 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 votre compte Slovenská pošta (Moje zásielky)
Imprimer des étiquettes d’expédition dans Shopify, au format A6 ou A4
Expédier vers un bureau de poste, un casier BalíkoBOX ou à l’adresse du client
Prendre en charge le paiement à la livraison versé sur votre IBAN

L’intégration est proposée pour la Slovaquie et l’adresse de l’expéditeur est toujours une adresse slovaque.

Activer l’intégration API Slovenská pošta

Dans votre administration Shopify, ouvrez Globe Pickup Points et accédez à Étiquettes d’expédition. Ajoutez un nouveau transporteur et sélectionnez Slovenská pošta.
Saisissez votre ID utilisateur et votre Clé API — ce sont les identifiants de l’API WebEPH de votre compte Slovenská pošta. L’API WebEPH doit être activée sur le compte pour que l’authentification fonctionne.
Renseignez le bloc expéditeur : Nom de l’expéditeur, Rue de l’expéditeur, Ville de l’expéditeur et Code postal de l’expéditeur sont obligatoires. Organisation de l’expéditeur, Téléphone de l’expéditeur et Email de l’expéditeur sont facultatifs.
Choisissez la Méthode de réception — Remettre en bureau de poste ou Remettre au coursier — selon la façon dont vous remettez les colis.
Choisissez le Type de paiement de l’affranchissement : Crédit d’affranchissement, Machine de paiement, Timbres, Paiement par virement, Paiement en espèces, Objet postal, Facture ou En ligne.
Cochez Contrat si vous avez un contrat avec Slovenská pošta.
Si vous expédiez en paiement à la livraison, renseignez l’IBAN pour contre remboursement.
Vous pouvez également configurer Assurance d’expédition, Valeur d’assurance par défaut, Poids par défaut (kg), Expédier les commandes automatiquement, Tagger les commandes avec le numéro de suivi et Tag personnalisé après l’export.
Associez vos méthodes d’expédition Shopify aux produits Slovenská pošta convenus avec le transporteur.

Export des commandes et impression des étiquettes

Vous pouvez exporter vos commandes vers Slovenská pošta et imprimer les étiquettes d’expédition directement depuis Shopify, par lots ou une par une — voir Créer des étiquettes d’expédition.

Chaque export crée un hárok (feuille de dépôt) par type de produit : les commandes sont regroupées par produit sélectionné, un hárok est ouvert pour chaque groupe, les colis y sont ajoutés, puis le hárok est enregistré automatiquement. Si l’enregistrement échoue, les colis sont tout de même créés et le hárok peut être enregistré plus tard dans Moje zásielky.

Le poids de la commande est converti de grammes en kilogrammes, avec un minimum de 0,1 kg. Si vos commandes n’ont pas de poids, définissez un Poids par défaut (kg) dans les paramètres du transporteur.

Chaque colis reçoit un numéro de colis Slovenská pošta (par exemple EB534780848SK). Si Expédier les commandes automatiquement est activé, la commande est traitée avec ce numéro et un lien vers la page de suivi Slovenská pošta.

Slovenská pošta dispose d’un système de test WebEPH, mais celui-ci s’active au niveau du serveur et non par compte transporteur : les boutiques en production communiquent toujours avec l’API Moje zásielky réelle, et il n’existe pas d’option bac à sable dans les paramètres du transporteur.

Produits

Sélectionnez le produit correspondant à votre accord avec Slovenská pošta. Toutes les commandes exportées avec le même produit figurent sur le même hárok.

Produit	Description
Doporučený list	Lettre recommandée
Poistený list	Lettre assurée
Úradná zásielka	Envoi officiel (administratif)
Balík	Colis standard
Expres kuriér	Coursier express
EMS zásielka	Envoi express EMS
EPG – obchodný balík	Colis professionnel EPG
Balík – zmluvní zákazníci	Colis pour clients sous contrat
Balík – zmluvní zákazníci – Consignment	Colis clients sous contrat, en consignation
Balíček	Petit colis
Easy Expres 1	Easy Expres, livraison en 1 jour
Easy Expres 10	Easy Expres, livraison en 10 jours
Prime zásielka	Envoi Prime
List	Lettre ordinaire

Points de retrait ou livraison à domicile

Le type de livraison découle de la méthode d’expédition choisie par le client :

Point de retrait — lorsque le client sélectionne un point de retrait Slovenská pošta (un bureau de poste ou un casier BalíkoBOX) au paiement, l’adresse du destinataire sur le colis est remplacée par celle du point de retrait, et le colis est déposé avec le service de retrait. Le nom du point est ajouté à la ville afin d’être visible sur l’étiquette.
Livraison à domicile — le colis est adressé à l’adresse de livraison du client. Une deuxième ligne d’adresse est ajoutée à la rue.

Le nom, la rue, la ville et le code postal du destinataire sont obligatoires. Les commandes auxquelles il manque l’un de ces éléments sont rejetées lors de l’export.

Plages de numéros de colis (clients sous contrat)

Si Slovenská pošta vous a attribué votre propre plage de numéros de colis, renseignez les champs avancés Plage de numéros de colis – de et Plage de numéros de colis – à (par exemple EB534780848SK). Globe attribue alors les numéros de cette plage et enregistre le suivant dans Prochain numéro de colis après chaque export, que vous pouvez aussi corriger manuellement.

Les numéros suivent le format PPNNNNNNNN[C]SS — un préfixe de deux lettres, huit chiffres, un chiffre de contrôle facultatif et un suffixe de deux lettres. Globe calcule le chiffre de contrôle pour vous. Lorsque la plage est épuisée, les exports échouent jusqu’à ce que vous saisissiez une nouvelle plage. Laissez ces champs vides pour laisser Slovenská pošta attribuer les numéros.

Paiement à la livraison (PDL)

Le paiement à la livraison est pris en charge. Le montant du paiement à la livraison correspond au montant restant dû sur la commande, dans la devise de la commande, et il est envoyé sous forme de virement bancaire vers l’IBAN pour contre remboursement configuré sur le compte transporteur, avec un symbole variable dérivé des chiffres du numéro de commande. Sans IBAN valide, l’API rejette le colis.

Assurance

L’assurance est ajoutée lorsque la valeur de la commande est supérieure à zéro et que le produit est Poistený list ou que l’option Assurance d’expédition est activée dans les paramètres du transporteur. Le montant assuré correspond à la valeur de la commande dans la devise de la commande, ou à la Valeur d’assurance par défaut si vous en avez défini une.

Statut de livraison

La synchronisation des statuts de livraison n’est pas disponible pour Slovenská pošta : les statuts des colis ne sont pas réécrits dans Shopify, et les paiements à la livraison ne sont pas marqués comme payés automatiquement. Le numéro de colis et le lien vers la page de suivi Slovenská pošta restent tout de même attachés au traitement de la commande. Les étiquettes de retour et l’annulation depuis Globe d’un colis déjà exporté ne sont pas prises en charge non plus ; annulez les colis dans Moje zásielky.

Impression des étiquettes

Les étiquettes Slovenská pošta sont renvoyées au format PDF et peuvent être imprimées dans les formats suivants :

Format	Étiquettes par feuille	Position de départ
A6	1 (une étiquette par page)	–
A4	4 (grille 2×2)	1–4

Lors de l’impression sur des feuilles A4, choisissez la position de départ pour réutiliser des planches d’étiquettes partiellement utilisées. Le format utilisé par défaut se définit avec l’Option d’impression par défaut dans les paramètres du transporteur.

Dépannage

Problème	Solution
Échec de l’authentification	Vérifiez l’ID utilisateur et la Clé API, et assurez-vous que l’API WebEPH est activée sur votre compte Slovenská pošta.
Champs expéditeur obligatoires manquants	Nom de l’expéditeur, Rue de l’expéditeur, Ville de l’expéditeur et Code postal de l’expéditeur doivent tous être renseignés.
Nom, adresse, ville ou code postal du destinataire manquant	L’adresse de livraison Shopify est incomplète. Pour les commandes avec point de retrait, vérifiez que le client a bien sélectionné un point au paiement.
Format de numéro de colis invalide	Utilisez le format `PPNNNNNNNN[C]SS`, par exemple `EB534780848SK`, dans les champs de plage de numéros de colis.
Plage de numéros de colis épuisée	Tous les numéros attribués ont été utilisés. Demandez une nouvelle plage à Slovenská pošta et mettez à jour Plage de numéros de colis – de/à et Prochain numéro de colis.
Erreur de validation à l’export	L’API a rejeté une valeur du colis — le plus souvent un IBAN pour contre remboursement manquant, ou un montant d’assurance ou de paiement à la livraison que le produit n’autorise pas.
Aucun identifiant de colis trouvé dans les commandes	La commande n’a pas été exportée correctement, il n’y a donc rien à imprimer. Exportez-la à nouveau avant d’imprimer.
Type d’étiquette indisponible	L’étiquette n’est pas encore prête pour ce colis. Patientez un instant et réimprimez.
Impossible de se connecter à l’API SK Posta	L’API WebEPH est temporairement inaccessible. Relancez l’export ou l’impression plus tard.

Add Slovenská pošta pickup points to your Shopify store — pricing, demo & setup →