Passer au contenu principal

Prestataires de services de livraison : comment fonctionne cet écran

Ajoutez des comptes transporteurs comme UPS et PostNL, saisissez vos identifiants, choisissez les options d'impression des étiquettes et gérez les profils de méthodes avec lesquels vous expédiez.

H
Écrit par Hayko

Prestataires de services de livraison : comment fonctionne cet écran

L'écran Prestataires de services de livraison regroupe vos comptes transporteurs, par exemple UPS ou PostNL. Chaque compte indique à QrX quel transporteur utiliser, avec quels identifiants, et quelles méthodes d'expédition (profils de méthodes) vous pouvez choisir lorsque vous créez un envoi. Ce guide explique la liste et l'éditeur de compte.

Ce que vous voyez sur cet écran

  • Ajouter un prestataire (en haut à droite) : ajoutez un nouveau compte transporteur.

  • Recherche par nom, fournisseur… : commencez à taper et la liste se met à jour.

  • Actualiser (la flèche ronde) : recharge la liste.

  • Douane (sous la liste) : votre code SH par défaut pour les envois hors de l'UE (voir plus bas).

  • La liste des comptes : une ligne par compte transporteur. Cliquez sur une ligne pour l'ouvrir. La liste charge automatiquement d'autres comptes lorsque vous faites défiler. Les modifications faites ailleurs (par exemple par un collègue) apparaissent d'elles-mêmes.

Les colonnes de la liste

  • Le logo du transporteur.

  • Nom d'affichage : le nom que vous avez donné au compte, par exemple "Compte UPS Europe".

  • Fournisseur : le transporteur.

  • Canal : le canal commerçant auquel le compte est destiné, ou Tous les canaux.

  • Méthode par défaut : le profil de méthode utilisé par défaut pour les nouveaux envois avec ce compte.

  • Contrat : Contrat propre signifie que vous expédiez avec votre propre contrat transporteur. Tarifé par QrX signifie que le compte fonctionne sur un contrat transporteur de QrX et que QrX fixe le prix d'expédition.

  • Actif : l'interrupteur active ou désactive le compte. Les comptes inactifs ne peuvent pas servir à créer des envois. La modification est enregistrée immédiatement.

  • Mise à jour et Créé : la date de la dernière modification du compte et la date de son ajout.

Cliquez sur un titre de colonne (Nom d'affichage, Fournisseur, Mise à jour, Créé) pour trier la liste. Cliquez à nouveau pour inverser l'ordre.

Modifier ou supprimer un compte

Passez la souris sur une ligne pour voir les icônes à la fin de celle-ci :

  • Modifier (crayon) : ouvre le compte.

  • Supprimer (corbeille) : demande une confirmation, puis supprime le compte. Astuce : désactivez plutôt un compte avec l'interrupteur Actif si vous pourriez en avoir besoin plus tard.

Ajouter ou modifier un compte fournisseur

Cliquez sur Ajouter un prestataire ou sur un compte dans la liste. En haut, vous voyez Créer un compte fournisseur ou Modifier le compte fournisseur et deux boutons :

  • Enregistrer : enregistre le compte. Après la création d'un nouveau compte, il reste ouvert pour que vous puissiez ajouter des profils de méthodes.

  • Annuler ou la flèche de retour : revenir à la liste sans enregistrer.

Détails du compte

  • Prestataire de services de livraison (obligatoire) : le transporteur. Il ne peut plus être modifié une fois le compte créé.

  • Nom d'affichage (obligatoire) : un nom que vous reconnaissez.

  • Canal commerçant : liez le compte à un canal, ou laissez Aucun (tous les canaux).

  • Adresse de l’expéditeur (facultative) : l'adresse d'expéditeur des envois avec ce compte. Laissez Utiliser l’adresse d’expéditeur par défaut pour utiliser votre adresse par défaut. Un expéditeur choisi sur un envoi reste prioritaire. Vous gérez les adresses sur l'écran Adresses.

  • Actif : les comptes inactifs ne sont pas disponibles lorsque vous créez des envois.

  • Contrat propre du client (pour les transporteurs autres que UPS et PostNL) : laissez-le activé si vous expédiez avec votre propre contrat transporteur. QrX crée alors uniquement l'étiquette et ne tarife ni ne bloque l'envoi. Si QrX tarife ce transporteur pour vous, l'interrupteur est verrouillé et affiche "QrX tarife ce transporteur, contactez QrX pour modifier." Si vous le désactivez et cliquez sur Enregistrer, QrX demande d'abord Laisser QrX tarifer ce transporteur ?. Après confirmation avec Oui, laisser QrX tarifer, vous ne pouvez plus revenir vous-même à votre propre contrat ; seul le support QrX le peut. Les envois avec ce transporteur sont bloqués tant que QrX n'a pas de prix pour une liaison.

Paramètres du compte UPS

Pour un compte UPS, la partie droite affiche Paramètres du compte UPS. Le cadre en haut indique le type de contrat :

  • Votre propre contrat UPS : les étiquettes sont créées avec vos identifiants UPS. Renseignez ID client, Secret client, Numéro de compte et Numéro d'expéditeur depuis votre compte développeur UPS. Une fois le secret enregistré, le champ reste vide et affiche "Secret configuré. Laissez vide pour le conserver."

  • Paiement QrX UPS à la livraison : QrX gère le compte UPS pour vous. Vous ne pouvez modifier que les options d'impression.

Le type de contrat est marqué Verrouillé ; vous ne pouvez pas le modifier ici.

  • Mode test : utiliser l'environnement de test UPS. Sur un compte géré par QrX, seul le support QrX peut l'activer.

  • Format d'étiquette : Standard (4x6) ou Étendu (4x8 combiné).

  • Mode d'impression des étiquettes : ZPL (pour les imprimantes d'étiquettes) ou PDF.

  • Copies des documents du transporteur : le nombre de copies des documents du transporteur à imprimer (de 1 à 20).

  • Imprimer les documents du transporteur avec les étiquettes : envoyer les documents du transporteur à l'imprimante en même temps que les étiquettes d'expédition.

  • Accord UPS pour marchandises dangereuses (uniquement sur votre propre contrat UPS) : activez-le seulement si votre contrat UPS comprend un accord pour les marchandises dangereuses. Les colis contenant des marchandises dangereuses (par exemple des batteries au lithium) sont alors déclarés à UPS sur UPS Standard au sein de l'UE. QrX a besoin de la déclaration UPS de marchandises dangereuses de chaque article (Stock, l'article, onglet Stockage et marchandises dangereuses) ; une étiquette est refusée tant qu'une valeur demandée par UPS manque. Quand l'option est désactivée, les commandes avec des marchandises dangereuses suivent vos règles de marchandises dangereuses comme avant.

Le contrat UPS de QrX (Paiement QrX UPS à la livraison) ne peut pas expédier de marchandises dangereuses. Une commande avec des marchandises dangereuses n'obtient jamais d'étiquette sur ce contrat : choisissez un autre mode d'expédition pour ces commandes.

UPS Track Alert

Sur un compte UPS enregistré, vous voyez aussi la carte UPS Track Alert. Elle permet à UPS d'envoyer les mises à jour de suivi à QrX en temps réel. Avec votre propre contrat UPS, cliquez sur Afficher la configuration du webhook pour voir l'URL du webhook, l'ID client, le Secret client et le Point de terminaison du jeton. Collez-les dans votre application développeur UPS sous Manage Webhook Credentials, UPS Track Alert, choisissez OAuth 2.0 et enregistrez. Sur un compte géré par QrX, QrX s'en occupe pour vous.

Paramètres du compte PostNL

Pour un compte PostNL, la partie droite affiche Paramètres du compte PostNL.

  • Lors de la création du compte, choisissez Votre propre contrat PostNL ou, lorsqu'il est proposé, Compte PostNL de QrX (QrX gère alors les identifiants et l'environnement).

  • Pour votre propre contrat, renseignez Numéro client (jusqu'à 10 chiffres), Code client (jusqu'à 4 lettres), Clé API de test et Clé API de production. Une clé enregistrée affiche "Clé enregistrée. Laissez vide pour la conserver."

  • Environnement : Environnement de test (test) ou Production réelle (vrais envois). Chaque environnement utilise sa propre clé API.

  • Vérifier : contrôle votre compte et l'accès aux codes-barres en réservant un code-barres. Aucune étiquette ni aucun envoi n'est créé.

  • Format des étiquettes : PDF ou ZPL.

Autres transporteurs : paramètres JSON

Pour les autres transporteurs, la partie droite affiche Paramètres du fournisseur (JSON), les paramètres techniques du compte. QrX remplit un modèle lorsque vous choisissez le transporteur. Ne le modifiez que si vous connaissez les paramètres du transporteur ; un JSON invalide n'est pas enregistré. Lorsque QrX gère le compte, les paramètres sont verrouillés et seul QrX peut les modifier.

Profils de méthodes

Les profils de méthodes sont les méthodes d'expédition de ce compte, par exemple "Standard Ground" ou "Express". Vous choisissez un profil de méthode lorsque vous créez un envoi, et les règles d'expédition peuvent en définir un automatiquement. Cette section apparaît une fois le compte enregistré.

  • Le tableau affiche Nom, Code profil, Code, Service de transport, Actif, Par défaut et Mise à jour. Utilisez les interrupteurs pour activer ou désactiver un profil ou le définir par défaut.

  • Ajouter un profil ouvre la fenêtre Ajouter un profil de méthode :

    • Charger à partir du modèle : remplir le nom, le code et les paramètres à partir d'une méthode toute prête du transporteur.

    • Nom du profil (obligatoire) et Code profil (obligatoire, un code fixe pour les appels API, qui doit être unique dans votre compte).

    • Code et Code de service du transporteur : le code propre au transporteur pour ce service, par exemple UPS_GROUND.

    • Profil par défaut : utiliser ce profil par défaut pour les nouveaux envois.

    • Pour le fournisseur de livraison en interne (vos propres chauffeurs) : Étiquette ZPL interne, avec l'Étiquette ZPL, le Mode d'impression et le nombre de Copies à imprimer.

    • Fichier JSON des paramètres : paramètres techniques de la méthode.

  • Utilisez le crayon pour modifier un profil et la corbeille pour le supprimer.

Sur un compte géré par QrX, les profils de méthodes sont en lecture seule.

Douane : code SH par défaut

La carte Douane sous la liste contient les données douanières pour les envois hors de l'UE. Pour les envois UPS hors de l'UE, QrX envoie une facture commerciale avec le code SH de chaque ligne. Il prend d'abord le code SH de la ligne de commande, puis celui de l'article de stock.

  • Code SH par défaut : utilisé quand un produit n'a pas de code SH propre. De 6 à 10 chiffres ; les points et les espaces sont acceptés, par exemple 8507.60.00. Cliquez sur le X pour l'effacer.

  • Cliquez sur Enregistrer sur la carte. Il faut l'autorisation de gérer l'expédition pour le modifier ; les autres le voient en lecture seule.

  • Sans aucun code SH, l'étiquette est quand même achetée, et la commande affiche un avertissement douanier pour que vous puissiez vérifier la facture.

Conseils et questions fréquentes

  • "Veuillez sélectionner un transporteur." ou "Le nom d'affichage est obligatoire." : remplissez le champ et cliquez à nouveau sur Enregistrer.

  • "Les paramètres doivent être au format JSON valide." : le JSON des paramètres contient une faute de frappe, par exemple une virgule ou un guillemet manquant.

  • "Choisissez une adresse disponible pour ce client et ce canal." : l'adresse d'expéditeur choisie appartient à un autre canal. Choisissez-en une autre ou utilisez l'adresse par défaut.

  • "L'ID client est obligatoire.", "Le numéro de compte est obligatoire." : renseignez toutes les informations UPS pour votre propre contrat UPS.

  • "Le compte n’a pas pu être vérifié." (PostNL) : vérifiez le numéro client, le code client et la clé API de l'environnement choisi.

  • "Échec de la mise à jour du statut actif." : l'interrupteur est revenu en arrière. Réessayez ou actualisez la liste.

  • Quelqu'un d'autre a enregistré le compte en même temps : QrX affiche un message et vous permet de recharger la dernière version.

  • "Le code SH par défaut comporte de 6 à 10 chiffres." : saisissez uniquement les chiffres du code (les points et les espaces sont acceptés), au moins 6 et au plus 10.

  • "Les marchandises dangereuses UPS ne peuvent être déclarées que sur UPS Standard au sein de l'UE." : utilisez UPS Standard pour les colis avec des marchandises dangereuses au sein de l'UE, ou un autre mode d'expédition.

  • "Ce colis contient plus d'un article de marchandises dangereuses." ou "... dans un envoi de plus d'un colis." : expédiez chaque article de marchandises dangereuses dans son propre colis, en un seul colis par envoi.

  • Besoin d'aide ? Cliquez sur Chat en bas du centre d'aide.

Avez-vous trouvé la réponse à votre question ?