Passer au contenu principal

Créer une transaction ou une expédition dans PortalX

Comment créer manuellement une transaction ou une expédition dans PortalX, avec les types, le mode test, les étiquettes et les blocages possibles.

H
Écrit par Hayko

Créer une transaction ou une expédition dans PortalX

Vous pouvez créer manuellement dans PortalX une transaction Payment On Delivery, une expédition avec étiquette, ou les deux. Les commandes peuvent aussi arriver automatiquement depuis votre boutique Shopify, depuis un import CSV ou Excel, ou via l'API QrX.

Par où commencer

Allez dans Transactions et cliquez sur Create Transaction (créer une transaction), ou sur New Transaction / Shipment (nouvelle transaction / expédition). La page s'intitule « Create transaction / shipment ». Sur un téléphone, elle devient un assistant pas à pas : Order Info, Customer, Order Lines, Shipping, Review. Vous avez besoin de la permission Create Transactions ou Manage Shipping.

Champs obligatoires

Order ID, Merchant Channel, un montant supérieur à 0, prénom, nom, ligne d'adresse 1, code postal, ville, pays et au moins une ligne de commande avec un nom de produit. S'il manque quelque chose, vous voyez « Please fill in all required fields ». Facultatifs : identifiant de commande boutique, devise, langue, e-mail, téléphone, entreprise, numéro de TVA, adresse de facturation différente et type d'adresse de livraison (Business ou Residential).

Les lignes de commande peuvent être choisies dans votre catalogue de produits (Products > Catalog). Vous pouvez enregistrer un formulaire rempli comme Template (modèle) et le réutiliser.

Types de transaction

  • Payment (paiement) : le consommateur paie à la porte. Si votre canal exige un prépaiement, la commande démarre en Require Payment.

  • No payment (sans paiement) : étiquettes d'expédition uniquement, sans paiement.

  • OTP only (OTP uniquement) : la livraison est confirmée avec un PIN, sans paiement.

  • Data only (données uniquement) : enregistrée à titre de référence uniquement, sans paiement et sans mode test.

Mode test

Activez Test Mode (« Use PSP sandbox for payments », utiliser le sandbox du PSP pour les paiements) pour créer une transaction de test ; le bouton devient alors Create Test Transaction. Les paiements de test utilisent le sandbox du prestataire de paiement et aucun argent réel ne circule. Avec un compte transporteur sandbox, le mode test est toujours activé. En mode test, le coût d'expédition est affiché à titre indicatif uniquement et n'est pas facturé.

Expédition et étiquettes

  • Activez Create shipment/label with this transaction (créer l'expédition / l'étiquette avec cette transaction), puis choisissez le mode d'expédition et l'adresse d'expéditeur.

  • Ajoutez un ou plusieurs colis (colli) avec leurs dimensions en cm et leur poids en kg, ou utilisez un préréglage d'emballage enregistré. Pour les trajets soumis à la douane, ajoutez la valeur en douane et le code SH (HS code). Pour UPS hors de l'UE, QrX envoie aussi le code SH, l'origine et la description de chaque ligne de commande, issus de la ligne de commande, de l'article de stock ou de votre code SH par défaut. Si la commande contient des marchandises dangereuses que son mode d'expédition n'autorise pas, la commande est créée mais l'étiquette n'est pas achetée.

  • Send tracking updates to customer (envoyer les mises à jour de suivi au client) envoie vos notifications Track & Trace.

  • Print label (imprimer l'étiquette) est activé par défaut ; Print packing slip (imprimer le bordereau de colisage) est facultatif.

  • Delivery options (options de livraison, UPS uniquement) : signature à la livraison (aucune, signature requise, signature d'un adulte), Direct Delivery Only et livraison le samedi. Pour QrX UPS Payment on Delivery, la signature et Direct Delivery Only sont toujours activées, car UPS les exige.

Canaux emballés par un partenaire logistique : aucune étiquette n'est achetée à la création de la transaction, même avec Créer l'envoi/l'étiquette activé. La commande va au poste d'emballage du partenaire, qui achète et imprime l'étiquette lors de l'emballage. Imprimer l'étiquette est ignoré pour ces commandes.

Aperçu du coût d'expédition

La carte Shipment cost (coût d'expédition) affiche le prix d'expédition qui s'applique à vous : le prix de base plus l'éventuelle surcharge carburant et l'éventuel supplément résidentiel, ce qui donne le prix final. Si la surcharge carburant en vigueur n'est pas encore connue, la carte indique qu'elle sera ajoutée lors de la création de l'étiquette ; la surcharge finale peut légèrement différer sur la facture du transporteur. Avec votre propre contrat transporteur, la carte affiche « Own contract » : QrX crée uniquement l'étiquette et ne facture pas l'expédition.

Pourquoi la création peut être bloquée

  • « Transaction amount must be higher than the shipment cost. » : augmentez le montant au-dessus du prix d'expédition final.

  • « Shipment not allowed. Configure a customer shipping price before creating the transaction. » ou « No valid customer shipping price is defined for this shipment. » : aucun prix d'expédition n'est configuré pour cette destination ou ce mode. Contactez QrX pour configurer la tarification.

  • « Cannot create shipment: this lane is not allowed... » : cette destination ne fait pas partie de votre accord de tarification d'expédition.

  • Un message de poids maximum : le colis est plus lourd que ce que votre accord autorise.

Ce qui se passe après la création

La transaction apparaît dans la liste Transactions. Les liens de paiement et les étiquettes sont créés en arrière-plan ; vous pouvez brièvement voir des badges comme PSP Pending, PSP Creating ou Label Creating. Un lien de paiement peut attendre jusqu'à 10 minutes le prix d'expédition final. Si un lien de paiement échoue, QrX réessaie automatiquement toutes les minutes.

Quand contacter notre équipe support

  • Vous voyez un blocage de prix d'expédition ou de trajet et avez besoin d'une tarification pour un nouveau pays ou un nouveau mode.

  • Un badge reste sur PSP Failed ou Label Failed.

  • Vous souhaitez que les paiements réels soient activés après vos tests.

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