API UPS

Globe Pickup Points s’intègre à UPS, transporteur de colis mondial, 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 UPS directement depuis Shopify
Imprimer des étiquettes d’expédition dans Shopify
Expédier avec 15 services UPS nationaux, européens et mondiaux
Envoyer des colis internationaux avec des données douanières générées automatiquement à partir de vos produits Shopify

UPS est activé boutique par boutique, sur demande. Si vous ne voyez pas UPS dans la liste des transporteurs, contactez le support Globe et nous l’activerons pour votre boutique.

Activer l’intégration API UPS

Dans votre administration Shopify, ouvrez Globe Pickup Points et accédez à Étiquettes d’expédition. Ajoutez un nouveau transporteur et sélectionnez UPS.
Saisissez votre Numéro de compte — votre numéro de compte expéditeur UPS, indiqué dans les informations de votre compte de facturation UPS.
Renseignez les coordonnées de l’expéditeur : Nom de l’expéditeur, Rue de l’expéditeur, Ville de l’expéditeur, Code postal de l’expéditeur, Pays de l’expéditeur et Téléphone de l’expéditeur. L’Email de l’expéditeur est facultatif.
L’État/province de l’expéditeur est un code d’état ou de province (par exemple NY, CA). Il est obligatoire pour les expéditions depuis les États-Unis ou le Canada et peut rester vide ailleurs.
Cliquez sur Connecter le compte UPS. Une fenêtre UPS s’ouvre : connectez-vous avec vos identifiants UPS et autorisez Globe. Une fois de retour, la connexion est enregistrée et le jeton d’accès est renouvelé automatiquement — vous n’avez à saisir ni clé API ni mot de passe.
Configurez les options de traitement et de tag selon vos besoins.
Associez vos méthodes d’expédition Shopify aux services UPS dont vous disposez sur votre compte.

Vous pouvez déconnecter le compte UPS à tout moment depuis le même écran ; l’export est bloqué tant qu’il n’est pas reconnecté.

Export des commandes et impression des étiquettes

Vous pouvez exporter vos commandes vers UPS et imprimer les étiquettes d’expédition directement depuis Shopify, par lots ou une par une. Pour le fonctionnement des étiquettes lui-même, consultez Créer des étiquettes d’expédition.

Chaque expédition reçoit un numéro de suivi UPS, et l’image de l’étiquette est enregistrée avec la commande afin de pouvoir être réimprimée plus tard sans recontacter UPS. Si Globe ne dispose plus de l’image enregistrée, elle est récupérée auprès du service de récupération d’étiquettes UPS à l’aide du numéro de suivi. Les colis se suivent sur https://www.ups.com/track?tracknum=<tracking number>.

Types de services

Sélectionnez le service correspondant à votre contrat UPS lors de l’export d’une commande :

Code	Service	Usage typique
03	UPS Ground	Routier national (États-Unis)
11	UPS Standard	Livraison routière en Europe
01	UPS Next Day Air	Aérien national, lendemain
02	UPS 2nd Day Air	Aérien national, deux jours
12	UPS 3 Day Select	Aérien national, trois jours
13	UPS Next Day Air Saver	National, lendemain en fin de journée
14	UPS Next Day Air Early	National, lendemain tôt le matin
59	UPS 2nd Day Air A.M.	National, deux jours, livraison le matin
07	UPS Worldwide Express	Express international
08	UPS Worldwide Expedited	International, jour garanti
54	UPS Worldwide Express Plus	International, tôt le matin
65	UPS Worldwide Saver	Express international, fin de journée
96	UPS Worldwide Express Freight	Fret palettisé international
71	UPS Worldwide Economy DDU	Économique, droits non acquittés
72	UPS Worldwide Economy DDP	Économique, droits acquittés

Tous les services ne sont pas disponibles sur tous les comptes ni depuis tous les pays d’origine — UPS rejette une expédition utilisant un service pour lequel votre compte n’a pas de contrat.

Livraison à domicile et en entreprise uniquement

Les étiquettes UPS créées dans Globe sont toujours adressées à l’adresse personnelle ou professionnelle du client, reprise de la commande Shopify. La livraison vers les UPS Access Point n’est pas prise en charge — un point de retrait sélectionné au paiement n’est pas transmis à UPS, et le colis sera livré à l’adresse de livraison. N’associez pas une méthode d’expédition de type point de retrait à un service UPS. Les étiquettes de retour ne sont pas prises en charge non plus.

Options d’expédition avancées

Ces options se définissent par expédition dans la fenêtre d’export. Ce ne sont pas des paramètres du transporteur — le compte transporteur UPS ne permet pas d’enregistrer de valeurs par défaut pour ces options, définissez-les donc sur les expéditions concernées.

Option	Description
Type d’emballage	Emballage propre (par défaut), Lettre UPS, Tube, PAK, UPS Express Box, UPS 25KG Box, UPS 10KG Box
Description du contenu	Description de l’envoi imprimée sur l’étiquette et utilisée sur les formulaires douaniers. Valeur par défaut : `Goods`.
Code SH	Code SH utilisé sur les formulaires douaniers de cette expédition, lorsqu’un produit n’a pas de code SH dans Shopify.

Douanes et envois internationaux

Les formulaires douaniers (une facture commerciale) sont ajoutés automatiquement lorsque le pays de l’expéditeur et le pays de destination diffèrent et que l’expédition n’est pas un mouvement intra-UE. Globe construit la facture à partir des lignes de la commande :

Titre du produit, quantité, prix unitaire et SKU
Code SH issu de l’article d’inventaire Shopify du produit, à défaut le Code SH saisi pour cette expédition dans la fenêtre d’export
Pays d’origine issu de l’article d’inventaire Shopify du produit, à défaut le pays de l’expéditeur
Poids de l’article issu de Shopify, converti dans l’unité de poids de l’expédition

Le numéro de facture est le numéro de commande Shopify, le motif d’exportation est SALE et la devise est celle de la commande. Les poids sont envoyés en kilogrammes, sauf pour les expéditeurs situés aux États-Unis, à Porto Rico et dans les îles Vierges américaines, où les livres sont utilisées.

Paiement à la livraison (PDL)

UPS ne prend pas en charge le paiement à la livraison dans Globe. Aucun montant n’est transmis à UPS : une commande en paiement à la livraison exportée vers UPS est donc expédiée comme un colis prépayé ordinaire et aucun montant n’est encaissé à la livraison. Utilisez un transporteur qui prend en charge le paiement à la livraison pour ces commandes, ou faites passer le client à un moyen de paiement prépayé avant l’export.

Statut de livraison

L’intégration UPS ne synchronise pas les statuts de livraison vers Shopify. Le numéro de suivi et le lien de suivi restent tout de même attachés au traitement de la commande (lorsque le traitement automatique est activé), ce qui permet de suivre la livraison sur ups.com.

Impression des étiquettes

UPS renvoie une image d’étiquette de 4×6 pouces, que Globe convertit en PDF et pivote en portrait pour l’impression. Les formats suivants sont disponibles :

Format	Positions par feuille
A6	1
A6 sur A4	4

Lors de l’impression d’étiquettes A6 sur A4, vous pouvez choisir la position de départ sur la feuille (positions 1–4) pour réutiliser des planches partiellement utilisées.

Dépannage

Problème	Solution
Le compte UPS n’est pas connecté	Ouvrez les paramètres du transporteur et cliquez sur Connecter le compte UPS pour finaliser la connexion UPS.
Échec de l’authentification UPS — le jeton a peut-être expiré	L’autorisation UPS enregistrée n’a pas pu être renouvelée. Déconnectez puis reconnectez le compte UPS.
Session invalide ou expirée pendant la connexion	La connexion UPS doit être finalisée dans un délai de 10 minutes. Fermez la fenêtre et relancez la connexion.
Échec de la création de l’expédition avec un message UPS	Le message provient directement d’UPS. Le plus souvent, le service n’est pas activé sur votre compte, l’adresse du destinataire est incomplète, ou le numéro de compte ne correspond pas à l’adresse de l’expéditeur.
État/province manquant ou invalide	Les expéditeurs et destinataires américains et canadiens ont besoin d’un code d’état ou de province valide. Renseignez l’État/province de l’expéditeur et vérifiez l’adresse du client.
Aucune étiquette n’a pu être récupérée depuis UPS	L’image d’étiquette enregistrée est absente et la récupération a échoué. Vérifiez que l’expédition possède un numéro de suivi et que le compte UPS est toujours connecté.
Commande en paiement à la livraison livrée sans encaissement	C’est le comportement attendu — les expéditions UPS dans Globe ne sont jamais en paiement à la livraison. Voir Paiement à la livraison (PDL) ci-dessus.

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