API Hrvatska pošta
Globe Pickup Points s’intègre à Hrvatska pošta, l’opérateur postal croate, via son API HP Shipping Service. Avec cette intégration, vous pouvez :
- Exporter vos commandes vers Hrvatska pošta directement depuis Shopify
- Imprimer des étiquettes d’expédition dans Shopify au format A6 ou A6 sur A4
- Expédier des colis Paket 24 vers des bureaux de poste, des consignes automatiques (paketomati) ou à l’adresse du client
- Encaisser le paiement à la livraison en EUR
- Suivre les colis sur la page de suivi de Hrvatska pošta
L’intégration couvre uniquement les colis à l’intérieur de la Croatie.
Activer l’intégration API Hrvatska pošta
Section intitulée « Activer l’intégration API Hrvatska pošta »- Dans votre administration Shopify, ouvrez Globe Pickup Points et accédez à Étiquettes d’expédition. Cliquez sur Ajouter une intégration transporteur et sélectionnez Hrvatska pošta.
- Saisissez votre Nom d’utilisateur et votre Mot de passe. Ce sont les identifiants API que Hrvatska pošta attribue à ses clients sous contrat. Demandez-les à votre conseiller commercial Hrvatska pošta ou écrivez à npa-3pdx@posta.hr.
- Laissez Environnement sur Production. Développement se connecte au système de test de Hrvatska pošta.
- Choisissez le Service : Paket 24 D+1, Paket 24 D+2 ou Paket 24 D+3. Il s’applique à tous les colis. Avec D+1, le colis est livré le jour ouvré suivant.
- Choisissez Comment vous remettez les colis à HP :
- Un coursier HP les récupère à mon adresse (présélectionné) : un coursier Hrvatska pošta enlève les colis à l’adresse de l’expéditeur. Si personne ne remet les colis, Hrvatska pošta clôture l’envoi. Ne gardez pas cette option si vous apportez vous-même les colis à Hrvatska pošta.
- Je les dépose dans un bureau de poste : saisissez le code postal du bureau de poste dans Bureau de poste ou consigne de dépôt.
- Je les dépose dans une consigne automatique : saisissez le code à 5 chiffres de la consigne dans Bureau de poste ou consigne de dépôt. Les colis déposés dans une consigne ne peuvent aller que vers un bureau de poste ou une consigne, pas vers une adresse, et ne doivent pas dépasser 30 kg.
- Renseignez les coordonnées de l’expéditeur : Nom de la société expéditeur (imprimé comme expéditeur sur chaque étiquette), Rue de l’expéditeur, Ville de l’expéditeur, Code postal de l’expéditeur (5 chiffres) et Téléphone de l’expéditeur sont obligatoires. Numéro de rue expéditeur et E-mail de l’expéditeur sont facultatifs. Le numéro de rue peut aussi être saisi dans Rue de l’expéditeur.
- Cliquez sur Afficher les paramètres avancés pour définir :
- Taille du casier en consigne : la taille de casier déclarée pour les colis livrés en consigne ou que vous déposez en consigne. Valeurs possibles : XS (9 x 16 x 64 cm), S (9 x 38 x 64 cm), M (19 x 38 x 64 cm) ou L (39 x 38 x 64 cm). M est présélectionné.
- Poids par défaut (kg) : utilisé lorsqu’une commande n’a pas de poids.
- Configurez le traitement et les tags : Expédier les commandes automatiquement (Jamais, Oui, envoyer l’e-mail d’expédition avec le numéro de suivi ou Oui, ne pas envoyer l’e-mail d’expédition), Tagger les commandes avec le numéro de suivi, Tag personnalisé après l’export et Tag personnalisé après impression.
- Sous Méthodes d’expédition, associez vos méthodes d’expédition Shopify aux types Hrvatska pošta décrits dans Types de service.
Export et impression des étiquettes
Section intitulée « Export et impression des étiquettes »Exportez vos commandes vers Hrvatska pošta et imprimez les étiquettes d’expédition directement depuis Shopify, par lots ou une par une. Voir Créer des étiquettes d’expédition.
- Chaque étiquette correspond à un colis avec un seul paquet.
- Le poids du colis est le poids de la commande dans Shopify, converti de grammes en kilogrammes. Si la commande n’a pas de poids, Globe utilise Poids par défaut (kg). Vous pouvez aussi saisir le poids dans le panneau de création d’étiquette, sous Avancé → Poids de l’envoi (kg).
- Hrvatska pošta n’a pas de deuxième ligne d’adresse : Globe ajoute donc la ligne d’adresse 2 à la rue.
- Le numéro de commande Shopify est imprimé sur l’étiquette.
Avant l’envoi d’une commande, Globe vérifie le pays de destination, le point de retrait, le nom, la rue, la ville, le code postal et le numéro de téléphone du destinataire, le poids et le montant contre remboursement. Une commande qui ne passe pas l’une de ces vérifications n’est pas envoyée, et le panneau de création d’étiquette en indique la raison. Des identifiants manquants, des coordonnées d’expéditeur incomplètes ou un code de dépôt manquant bloquent tout l’export.
Chaque colis reçoit un numéro de colis Hrvatska pošta. 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 de Hrvatska pošta : https://posiljka.posta.hr/hr/tracking/trackingdata?barcode=<parcel number>.
Globe ne relance pas un export de lui-même. Lorsqu’un export se termine sans réponse claire de Hrvatska pošta, le colis existe peut-être déjà. Vérifiez votre compte Hrvatska pošta avant de recréer l’étiquette.
Types de service
Section intitulée « Types de service »Choisissez le Type de chaque commande dans le panneau de création d’étiquette, ou associez un type à chaque méthode d’expédition dans les paramètres du transporteur. Chaque type utilise le délai de livraison Paket 24 défini dans Service.
| Type | Destination |
|---|---|
| Hrvatska pošta (post office or parcel locker if selected, otherwise address) | Le point (bureau de poste ou consigne) choisi par le client au checkout. Les commandes sans point de retrait partent à l’adresse de livraison. |
| Hrvatska pošta Paket 24 (address) | L’adresse de livraison du client. Un point de retrait présent dans la commande est ignoré. |
| Hrvatska pošta Paket 24 (post office or parcel locker) | Le point (bureau de poste ou consigne) indiqué dans la commande. Une commande sans point est refusée. |
Vous pouvez associer le premier type aussi bien aux méthodes d’expédition avec point de retrait qu’aux méthodes de livraison à domicile.
Le premier et le troisième type refusent une commande dont le point de retrait appartient à un autre transporteur. Globe n’envoie pas ce colis à l’adresse du client à la place. Choisissez un point Hrvatska pošta avec l’action Modifier le point de retrait, ou sélectionnez Hrvatska pošta Paket 24 (address) pour expédier à l’adresse.
Les services EasyReturn et d’envoi de palettes de Hrvatska pošta ne sont pas disponibles.
Points de retrait
Section intitulée « Points de retrait »Pour proposer les points Hrvatska pošta au checkout, ajoutez Hrvatska pošta comme transporteur de points de retrait dans Globe : voir Ajouter des transporteurs avec points de retrait. Globe charge les points depuis les données publiques de posta.hr :
- Bureaux de poste : bureaux de poste ordinaires et à temps partiel. Les bureaux de poste saisonniers et douaniers ne sont pas listés, pas plus que les bureaux sans horaires d’ouverture publiés, comme ceux qui sont temporairement fermés.
- Consignes automatiques : les paketomati de Hrvatska pošta.
Globe transmet avec le colis le code Hrvatska pošta à 5 chiffres du point : le code postal d’un bureau de poste, ou le code d’une consigne, qui commence par 6. Les points Hrvatska pošta qui proviennent du transporteur de points de retrait Packeta sont aussi acceptés.
Les livraisons en consigne ont des exigences supplémentaires :
- Le numéro de téléphone du destinataire doit être un numéro de mobile croate (091, 092, 095, 097, 098 ou 099). Hrvatska pošta y envoie le code PIN par SMS.
- Le colis ne doit pas dépasser 30 kg.
- La taille du casier est celle définie dans Taille du casier en consigne.
Les livraisons en bureau de poste et à l’adresse nécessitent aussi un numéro de téléphone, mais n’importe quel numéro est accepté.
Paiement à la livraison (PDL)
Section intitulée « Paiement à la livraison (PDL) »Hrvatska pošta encaisse le paiement à la livraison uniquement en EUR, jusqu’à 13 300 EUR par colis. Une commande en paiement à la livraison dans une autre devise, ou d’un montant supérieur, est refusée et aucun colis n’est créé. Le paiement à la livraison fonctionne pour les livraisons à l’adresse, en bureau de poste et en consigne.
- Globe préremplit le montant contre remboursement avec le montant restant dû de la commande lorsqu’il reconnaît le moyen de paiement comme un paiement à la livraison, par exemple Paiement à la livraison (COD) de Shopify.
- Si Globe ne reconnaît pas votre moyen de paiement à la livraison, par exemple un moyen de paiement portant un nom croate, aucun montant n’est prérempli et le panneau de création d’étiquette signale que la commande n’est pas payée. Saisissez le montant vous-même.
- Vous pouvez modifier le montant dans le panneau de création d’étiquette, sous Avancé → Montant contre remboursement.
Impression des étiquettes
Section intitulée « Impression des étiquettes »Les étiquettes sont récupérées auprès de Hrvatska pošta au format PDF au moment de l’impression. Les formats suivants sont disponibles :
| Format | Étiquettes par page |
|---|---|
| A6 | 1 |
| A6 on A4 | 4 (2×2) |
En A6 sur A4, l’impression commence toujours à la première position : il n’est pas possible de choisir une position de départ. Le format utilisé par défaut se règle avec Option d’impression par défaut dans les paramètres du transporteur.
Les étiquettes A6 s’impriment dans l’ordre de votre sélection lorsque toutes les étiquettes sont renvoyées. Sur les feuilles A4, Hrvatska pošta trie les étiquettes par numéro de colis. Les étiquettes des colis annulés et des colis qui ne figurent pas sur ce compte Hrvatska pošta sont omises sans message d’erreur.
Dépannage
Section intitulée « Dépannage »| Problème | Solution |
|---|---|
| Le nom d’utilisateur et le mot de passe ne sont pas renseignés ou Hrvatska pošta les a refusés | Vérifiez Nom d’utilisateur et Mot de passe dans les paramètres du transporteur. Aucun colis n’a été créé. |
| La connexion à Hrvatska pošta a échoué ou Globe n’a pas pu joindre Hrvatska pošta | Aucun colis n’a été créé. Réessayez dans une minute. |
| L’adresse de l’expéditeur est incomplète | Renseignez les champs de l’expéditeur indiqués dans le message. Le Code postal de l’expéditeur doit comporter 5 chiffres. |
| Paramètres incomplets : code postal du bureau de poste ou code de la consigne de dépôt | Saisissez le code à 5 chiffres dans Bureau de poste ou consigne de dépôt. |
| Hrvatska pošta livre uniquement en Croatie | La commande part vers un autre pays. Utilisez un autre transporteur pour cette commande. |
| Le point de retrait n’est ni un bureau de poste ni une consigne Hrvatska pošta | Le client a choisi le point d’un autre transporteur. Choisissez un point Hrvatska pošta avec l’action Modifier le point de retrait, ou sélectionnez Hrvatska pošta Paket 24 (address). |
| La commande n’a ni bureau de poste ni consigne Hrvatska pošta, ou son point n’a pas de code à 5 chiffres | Choisissez le point avec l’action Modifier le point de retrait, ou sélectionnez un type qui livre à l’adresse. |
| Les colis déposés dans une consigne ne peuvent pas aller vers une adresse | Pour expédier vers une adresse, réglez Comment vous remettez les colis à HP sur l’option bureau de poste ou coursier. |
| La commande n’a pas de poids | Renseignez le poids des produits dans Shopify, saisissez le poids dans le panneau de création d’étiquette ou définissez Poids par défaut (kg). |
| Les consignes acceptent 30 kg au maximum | La limite s’applique à la livraison en consigne et au dépôt en consigne. Envoyez un colis plus lourd vers un bureau de poste ou une adresse, et réglez Comment vous remettez les colis à HP sur l’option bureau de poste ou coursier. |
| Les consignes exigent un numéro de mobile croate ou le numéro de téléphone manque | Corrigez le numéro de téléphone de la commande. Pour une consigne, il doit s’agir d’un numéro de mobile croate (091, 092, 095, 097, 098 ou 099). |
| Code postal non croate, ou nom, rue ou ville du destinataire manquant | Complétez l’adresse de livraison de la commande. Le code postal doit comporter 5 chiffres. |
| Paiement à la livraison dans une autre devise que l’EUR ou supérieur à 13 300 EUR | Voir Paiement à la livraison (PDL). |
| Un message qui commence par « Hrvatska pošta: » | Hrvatska pošta a refusé le colis. Son texte, souvent en croate, indique le champ refusé. Corrigez la valeur et exportez à nouveau la commande. |
| Hrvatska pošta n’a pas répondu à temps, la connexion a été interrompue ou le colis n’a pas été confirmé | Le colis existe peut-être déjà. Vérifiez votre compte Hrvatska pošta avant de recréer l’étiquette. |
| Hrvatska pošta a créé le colis, mais Globe n’a pas pu l’enregistrer | Ne recréez pas l’étiquette : Hrvatska pošta créerait un deuxième colis. Écrivez à help@appfleece.com en indiquant le numéro du colis. |
| Le transporteur n’a pas renvoyé l’étiquette | Relancez l’impression dans un instant. Hrvatska pošta ne renvoie aucune étiquette pour un colis annulé ni pour un colis qui ne figure pas sur ce compte. Si l’impression échoue encore, vérifiez Nom d’utilisateur et Mot de passe. |
| Certaines étiquettes manquent dans le PDF | Hrvatska pošta omet les étiquettes des colis annulés et des colis qui ne figurent pas sur ce compte. |