Aller au contenu

API Nova Post

Globe Pickup Points s’intègre à Nova Post, ce qui permet d’exporter les commandes et d’imprimer les étiquettes d’expédition directement depuis Shopify pour les colis envoyés depuis un pays de l’UE. Avec cette intégration, vous pouvez :

  • Exporter vos commandes vers Nova Post directement depuis Shopify
  • Imprimer des étiquettes d’expédition dans Shopify
  • Expédier vers une agence Nova Post, une consigne ou un point PUDO choisi au checkout, ou à l’adresse du client
  • Envoyer des colis vers l’Ukraine, la Moldavie et le Royaume-Uni avec une facture douanière établie à partir de la commande
  • Encaisser le paiement à la livraison sur les trajets où Nova Post le propose

  1. 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 Nova Post.
  2. Saisissez votre Clé API. Créez-la sur my.novapost.com, dans Integrations → API keys, en vous connectant en tant que représentant autorisé désigné dans votre contrat Nova Post.
  3. Sélectionnez l’Environnement : Production pour les envois réels, Développement pour l’environnement de test de Nova Post. Une clé de production ne fonctionne qu’avec Production, une clé de test qu’avec Développement.
  4. Saisissez votre Numéro de contrat. Vous payez les envois en tant qu’expéditeur, et Nova Post les facture sur ce contrat. Si vous avez un contrat distinct pour l’international, saisissez-le dans Numéro de contrat international. Globe l’utilise alors pour les colis vers un autre pays.
  5. Saisissez votre Identifiant fiscal de l’entreprise : l’identifiant fiscal de l’organisation de votre contrat Nova Post, par exemple IČO, NIP ou Steuernummer. Il doit s’agir d’une organisation pour laquelle votre clé API a été créée.
  6. Renseignez Nom de la société expéditeur, Nom de l’expéditeur (la personne de contact indiquée sur l’étiquette), Téléphone de l’expéditeur (un numéro international complet, par exemple +420777123456), E-mail de l’expéditeur et Pays de l’expéditeur. Le pays de l’expéditeur doit se trouver dans l’UE.
  7. Indiquez comment vos colis parviennent à Nova Post :
    • En agence : renseignez le champ Agence Nova Post pour le dépôt des colis avec le numéro d’agence tel que Nova Post l’indique (par exemple 14/1) ou avec l’ID de l’agence (division ID).
    • Par coursier depuis votre adresse : laissez l’agence vide et renseignez Rue de l’expéditeur, Numéro de rue expéditeur, Code postal de l’expéditeur et Ville de l’expéditeur. Le numéro de rue peut aussi être saisi dans Rue de l’expéditeur.
  8. Renseignez la Longueur par défaut en mm, la Largeur par défaut en mm et la Hauteur par défaut en mm. Nova Post exige la longueur, la largeur et la hauteur de chaque colis et les utilise pour le poids volumétrique. Globe envoie ces valeurs pour tous les colis.
  9. Si vous proposez le paiement à la livraison, renseignez les paramètres décrits dans Paiement à la livraison (PDL).
  10. Sous Afficher les paramètres avancés, vous pouvez définir Conditions douanières (Incoterms), Numéro EORI de l’expéditeur, Description par défaut du contenu de l’envoi, Code SH par défaut et Poids par défaut (kg). Les paramètres douaniers sont décrits dans Douanes et envois internationaux.
  11. Configurez Expédier les commandes automatiquement, Tagger les commandes avec le numéro de suivi et Tag personnalisé après l’export selon vos besoins.
  12. Dans Méthodes d’expédition, associez vos méthodes d’expédition Shopify aux services Nova Post décrits dans Types de service. Les méthodes d’expédition peuvent être associées pour les 27 pays de l’UE, l’Ukraine, la Moldavie et le Royaume-Uni.

Exportez vos commandes vers Nova Post et imprimez les étiquettes d’expédition directement depuis Shopify, par lots ou une par une. Le fonctionnement général est décrit dans Créer des étiquettes d’expédition.

Avant l’envoi de la première commande, Globe vérifie les paramètres et se connecte à Nova Post avec votre clé API. Si un paramètre manque ou si la clé est refusée, aucune commande n’est envoyée. Globe vérifie aussi dans chaque commande les données que Nova Post refuserait, comme un numéro de téléphone ou un numéro de rue manquant. Une commande qui ne passe pas ces vérifications n’est pas envoyée : corrigez-la, puis exportez-la à nouveau.

Chaque commande est transmise sous la forme d’un envoi comprenant un colis :

  • Poids : le poids de la commande, arrondi à 10 g (au moins 10 g)
  • Dimensions : la longueur, la largeur et la hauteur par défaut des paramètres
  • Valeur d’assurance : la Valeur déclarée, par défaut le total de la commande, dans la devise de la commande
  • Contenu : la Description du contenu, ou les titres des produits de la commande lorsqu’elle est vide

Vous pouvez modifier le poids, la valeur déclarée, le montant contre remboursement, le code SH et la description du contenu d’un envoi sous Avancé lors de la création de l’étiquette.

Nova Post renvoie un numéro d’envoi tel que SHCZ0123456789. Globe l’enregistre comme numéro de suivi et télécharge l’étiquette depuis Nova Post à chaque impression. Le lien de suivi ouvre https://novapost.com/en-<country>/tracking/<shipment number>/ pour le pays du numéro d’envoi (par exemple en-pl pour SHPL…), ou en-cz lorsque ce pays n’a pas de page de suivi. Si Expédier les commandes automatiquement est activé, le traitement est créé avec le numéro d’envoi, le nom de transporteur Nova Post et ce lien.

Si Nova Post ne répond pas à temps ou si la connexion est interrompue, l’envoi existe peut-être chez Nova Post alors que Globe n’a pas de numéro pour celui-ci. Globe ajoute alors à la commande une note invitant à vérifier my.novapost.com avant de recréer l’étiquette, et arrête le lot avant la commande suivante. Les commandes qui n’ont pas été envoyées peuvent être exportées à nouveau sans risque.

Globe n’annule pas les envois chez Nova Post. Pour annuler un envoi, supprimez-le dans my.novapost.com.


Lors de l’association des méthodes d’expédition ou de la création d’une étiquette, choisissez l’un de ces services :

ServiceLivraison
Nova Post (branch or parcel locker if selected, otherwise address)À l’agence Nova Post, à la consigne ou au point PUDO choisi par le client au checkout. Une commande sans point de retrait part à l’adresse du client.
Nova Post courier (address)Toujours à l’adresse de livraison du client, même lorsque la commande comporte un point de retrait.
Nova Post branch or parcel lockerÀ l’agence Nova Post, à la consigne ou au point PUDO indiqué dans la commande. Une commande sans point est refusée.

Avec les deux services qui livrent à un point, une commande dont le point de retrait appartient à un autre transporteur est refusée, au lieu d’être expédiée à l’adresse du client. Choisissez un point Nova Post avec l’action Modifier le point de retrait, ou créez l’étiquette avec Nova Post courier (address).


Les services qui livrent à un point envoient le colis à l’agence Nova Post, à la consigne ou au point PUDO choisi par le client au checkout. Globe transmet l’identifiant Nova Post de ce point : le point doit donc provenir du réseau Nova Post dans le sélecteur de points de retrait de Globe. Pour proposer les points Nova Post au checkout, ajoutez Nova Post comme transporteur de points de retrait : voir Ajouter des transporteurs avec points de retrait. Les agences Nova Post qu’un autre transporteur liste dans son propre réseau, par exemple Packeta ou Boxpi, portent les identifiants de ce transporteur et sont refusées.

Nova Post n’a ni agences, ni consignes, ni points PUDO en Bulgarie, en Croatie, à Chypre, en Grèce, à Malte et en Slovénie. Les colis vers ces pays ne peuvent aller qu’à l’adresse du client.

Pour la livraison à l’adresse, Nova Post a besoin de la rue et du numéro de rue dans des champs séparés. Globe extrait le numéro de rue de la première ligne d’adresse (Vinohradská 12/34, 12 rue de la Paix) ou du début de la deuxième ligne, et transmet comme numéro d’appartement le numéro écrit après le numéro de rue (byt 4, m. 5, Apt 2B). Une adresse sans numéro de rue, rue, ville ou code postal est refusée.

Nova Post exige le numéro de téléphone du destinataire pour chaque envoi, y compris en agence et en consigne. Un numéro sans indicatif est considéré comme un numéro du pays de destination. Nova Post refuse un destinataire en Pologne sans numéro polonais (+48) et un destinataire en Ukraine sans numéro ukrainien (+380).


Les colis qui quittent l’UE (vers l’Ukraine, la Moldavie ou le Royaume-Uni) nécessitent une facture douanière. Globe remplit la facture commerciale propre à Nova Post à partir de la commande. Vous pouvez l’imprimer avec l’étiquette (voir Impression des étiquettes).

La facture indique la valeur totale des marchandises, la devise de la commande, le motif d’exportation Selling et les Conditions douanières (Incoterms) des paramètres : DAP (le client paie les droits d’importation), par défaut, ou DDP (vous payez les droits d’importation). Chaque ligne de produit expédiée et dotée d’un prix devient un article avec :

  • le titre du produit dans Shopify, comme nom de l’article et comme nom en anglais (Nova Post attend ce nom en anglais)
  • la quantité et le prix unitaire
  • le code SH du produit dans Shopify, ou à défaut le Code SH défini lors de la création de l’étiquette ou le Code SH par défaut
  • le pays d’origine du produit, s’il est renseigné
  • une part du poids du colis, au prorata du poids du produit, afin que la somme des poids des articles corresponde au poids du colis comme l’exige Nova Post

Les codes SH doivent comporter au moins 6 chiffres. Nova Post accepte 8 à 10 chiffres : Globe complète donc un code à 6 chiffres avec des zéros (610910 devient 61091000). Les colis vers la Moldavie reçoivent exactement 10 chiffres. Lorsqu’aucune ligne de produit ne remplit ces conditions, Globe déclare tout le colis comme un seul article avec la description du contenu (ou Goods), la valeur de la commande et le Code SH défini lors de la création de l’étiquette ou le Code SH par défaut.

Nova Post déclare en kilogrammes les marchandises relevant des codes SH 210690 (préparations alimentaires comme les compléments alimentaires) et 630900 (vêtements usagés). Globe convertit ces articles en kilogrammes à partir du poids du produit. Un colis ne peut contenir qu’un seul article de ce type, et 10 kg au maximum de cet article.

Les colis qui quittent l’UE nécessitent aussi l’adresse e-mail du client dans la commande. Les colis vers l’Ukraine nécessitent un Nom de l’expéditeur en caractères latins : les accents sont acceptés, les lettres cyrilliques ou grecques ne le sont pas. Le Numéro EORI de l’expéditeur est facultatif et recommandé pour les colis qui quittent l’UE.


Nova Post encaisse le paiement à la livraison en Tchéquie, en Pologne et en Allemagne, ainsi que depuis la Tchéquie, la Pologne, l’Allemagne et la Slovaquie vers l’Ukraine. Nova Post doit activer le paiement à la livraison sur votre contrat (un accord de contre-remboursement).

Lorsque le moyen de paiement de la commande est le paiement à la livraison, Globe ajoute le service contre remboursement de Nova Post avec le montant restant dû de la commande. Vous pouvez modifier le montant dans Montant contre remboursement lors de la création de l’étiquette.

Renseignez ces paramètres :

  • IBAN pour le contre remboursement : le compte sur lequel Nova Post verse l’argent encaissé. Le versement est fait à l’entreprise indiquée dans Identifiant fiscal de l’entreprise.
  • Numéro de l’accord de contre remboursement : le numéro de votre accord de contre-remboursement. Laissez-le vide si vous n’avez qu’un seul contrat.
  • Qui paie les frais de contre remboursement : Expéditeur (vous), par défaut, ou Destinataire. La valeur doit correspondre à votre accord de contre-remboursement.

Globe n’envoie le paiement à la livraison que lorsque la commande est dans la devise de votre pays d’expédition : CZK depuis la Tchéquie, PLN depuis la Pologne, EUR depuis l’Allemagne et la Slovaquie. Une commande en paiement à la livraison sur un trajet où Nova Post ne propose pas ce service, dans une autre devise ou sans IBAN valide est refusée avant toute création d’envoi.


Globe télécharge les étiquettes depuis Nova Post au format PDF lors de l’impression. Deux options d’impression sont disponibles :

Option d’impressionContenu imprimé
10x15 or 10x10 cm (size set by Nova Post)L’étiquette de l’envoi. Nova Post définit la taille de chaque envoi : 100 × 150 mm ou 100 × 100 mm.
Label + commercial invoice A4 (parcels leaving the EU)L’étiquette, suivie de la facture commerciale de Nova Post au format A4 pour chaque colis qui a quitté l’UE. Les colis à l’intérieur de l’UE ne reçoivent que l’étiquette.

Lorsque vous imprimez plusieurs envois, Globe réunit leurs documents dans un seul PDF, dans l’ordre des envois. Position sur papier vaut toujours 1.


ProblèmeSolution
« Nova Post settings are incomplete »Le message liste les paramètres manquants. Renseignez-les dans le compte transporteur et enregistrez.
« Globe creates Nova Post labels for senders in the EU »Réglez Pays de l’expéditeur sur le pays de l’UE depuis lequel vous expédiez.
« The sender phone must be a full international number »Saisissez Téléphone de l’expéditeur avec l’indicatif du pays, par exemple +420777123456.
« The sender address needs a house number »Saisissez Numéro de rue expéditeur, ou renseignez Agence Nova Post pour le dépôt des colis.
« Nova Post did not accept the API key » ou « Nova Post says the API key is not active »Vérifiez la Clé API et l’Environnement : une clé de production ne fonctionne qu’avec Production, une clé de test qu’avec Développement. Une clé inactive doit être activée dans my.novapost.com ou par votre interlocuteur Nova Post.
« Access to the company is forbidden by API key » ou « Nova Post refused the request for this API key »L’Identifiant fiscal de l’entreprise doit correspondre à une organisation pour laquelle votre clé API a été créée. Vérifiez la clé dans my.novapost.com.
« Recipient phone number is missing », « Nova Post needs a Polish phone number (+48) » ou « …a Ukrainian phone number (+380) »Ajoutez à l’adresse de livraison de la commande le numéro de téléphone du client avec l’indicatif du pays. Les destinataires en Pologne ont besoin d’un numéro polonais, ceux en Ukraine d’un numéro ukrainien.
« Nova Post needs the house number in its own field » ou « the shipping address needs a street, city and postcode »Complétez l’adresse de livraison de la commande, numéro de rue compris.
« Nova Post does not know the recipient’s city »Vérifiez le nom de la ville dans l’adresse de livraison.
« Order … has no weight »Renseignez le poids des produits dans Shopify, saisissez le poids lors de la création de l’étiquette, ou définissez Poids par défaut (kg) dans les paramètres avancés.
« has no Nova Post branch or parcel locker », « is not a Nova Post branch or parcel locker » ou « is not a Nova Post division id »Choisissez une agence ou une consigne Nova Post avec l’action Modifier le point de retrait, ou créez l’étiquette avec Nova Post courier (address) pour expédier à l’adresse du client.
« parcels to Ukraine need the sender name in Latin letters »Écrivez le Nom de l’expéditeur en caractères latins.
« Nova Post needs the customer’s e-mail for parcels leaving the EU »Ajoutez l’adresse e-mail du client à la commande.
« parcels leaving the EU need an HS code »Ajoutez le code SH au produit dans Shopify, ou définissez un Code SH par défaut dans les paramètres avancés.
Marchandises relevant des codes SH 210690 ou 630900 refuséesNova Post accepte un seul article de ce type par colis, au maximum 10 kg, et a besoin de son poids. Ajoutez le poids du produit dans Shopify, ou répartissez les marchandises en plusieurs colis dans my.novapost.com.
Paiement à la livraison refusé pour le trajet ou la deviseNova Post n’encaisse le paiement à la livraison que sur les trajets et dans les devises indiqués dans Paiement à la livraison (PDL). Utilisez un autre transporteur pour la commande, ou mettez le Montant contre remboursement à 0 lors de la création de l’étiquette.
« no valid IBAN for the collected money » ou « Nova Post refused the cash on delivery bank account »Vérifiez IBAN pour le contre remboursement et Numéro de l’accord de contre remboursement dans les paramètres.
« Nova Post did not answer in time », « did not confirm the shipment » ou « The connection to Nova Post broke off »L’envoi existe peut-être. Vérifiez my.novapost.com avant de recréer l’étiquette.
« Globe could not connect to Nova Post », « the Nova Post login did not answer » ou « Nova Post is limiting requests right now »Rien n’a été créé. Réessayez dans une minute.
« Do not create the label again »Nova Post a créé l’envoi, mais Globe n’a pas pu l’enregistrer. Imprimez l’étiquette dans my.novapost.com, ou supprimez-y l’envoi avant d’en créer un nouveau.
« Globe stopped before sending order … »Une commande précédente du lot n’a pas reçu de réponse exploitable ou n’a pas pu être enregistrée. Rien n’a été créé pour cette commande : son étiquette peut donc être recréée.
Autres messages commençant par « Nova Post: »Le texte provient de la validation de Nova Post et indique le champ refusé. Corrigez la commande ou les paramètres, puis exportez à nouveau la commande.
« Error printing Nova Post labels »Le détail indique le numéro d’envoi et la raison donnée par Nova Post, par exemple Shipment not found. Vérifiez l’envoi dans my.novapost.com.