Démarrer en tant qu'entreprise de logistique (API)
Ce guide s'adresse aux entreprises de logistique (3PL) qui emballent et expédient pour plusieurs boutiques en ligne et veulent proposer à ces boutiques le Payment on Delivery numérique, tout en conservant leur propre système de gestion d'entrepôt (WMS). Votre WMS continue de recevoir les commandes comme aujourd'hui. Pour les commandes Payment on Delivery, il demande à QrX l'étiquette du transporteur et l'étiquette de paiement QrX via l'API publique QrX. À la porte, l'acheteur scanne le QR code QrX et paie via le prestataire de paiement de la boutique en ligne. QrX ne détient jamais l'argent, et celui-ci ne transite jamais par votre entreprise.
Dans PortalX, il s'agit du parcours de configuration Je suis une entreprise de logistique et je connecte mon propre WMS via l'API du guide de démarrage (Paramètres > Entreprise > Démarrage).
Choisissez votre modèle de compte
QrX fonctionne avec des canaux de vente (canaux marchands). Chaque canal a son propre prestataire de paiement, sa clé API, sa personnalisation et son transporteur par défaut. Il existe deux façons de configurer vos clients :
Vous gérez les clients (le plus courant) : votre entreprise a un seul compte QrX avec un canal marchand par boutique en ligne cliente. Vous connectez le prestataire de paiement de chaque client au canal de ce client, afin que les paiements à la porte soient versés directement au client. Vous recevez une seule facture QrX pour tous les clients.
Les clients ont leur propre compte QrX : chaque boutique en ligne s'inscrit elle-même, connecte son prestataire de paiement et donne accès à votre entreprise avec l'Accès partenaire (Paramètres > Entreprise > Accès partenaire, périmètre Reseller operations ou Carrier operations). Votre WMS utilise alors la clé API du canal du client, ou vous vous connectez via QrX Connect (consultez « QrX Connect : connecter votre plateforme avec OAuth »).
Convenez avec QrX du modèle utilisé avant la mise en production de votre premier client. Les commissions partenaires des entreprises de logistique sont convenues par partenariat ; consultez « Les partenaires et comment devenir partenaire de QrX ».
1. Configurez votre entreprise
Informations de l'entreprise. QrX reprend le nom de l'entreprise, l'adresse et le numéro de TVA ou d'immatriculation (Chambre de commerce) de votre inscription. Si une information manque ou a changé, cliquez sur Demandez à QrX dans l'étape et QrX la complète pour vous. L'étape se coche lorsque toutes les informations sont connues.
Adresse d'expéditeur de l'entrepôt avec un code court pour les appels API : Paramètres > Opérations > Adresses.
Équipe : invitez vos collègues de l'entrepôt et de l'informatique dans Paramètres > Équipe et accès > Utilisateurs, et attribuez-leur des rôles dans Rôles et autorisations.
2. Ajoutez vos clients
Un canal par boutique en ligne cliente : Paramètres > Entreprise > Canaux marchands. Utilisez le nom de la boutique du client afin que les acheteurs la reconnaissent sur la page de paiement.
Connectez le fournisseur de paiement de chaque client dans l'onglet Paiements du canal (Stripe, Mollie ou MultiSafePay). Le client finalise l'inscription auprès du prestataire avec les informations de sa propre entreprise.
Personnalisation par client : logo et couleurs sur le canal, un modèle Track & Trace (Paramètres > Opérations > Suivi de colis) et des modèles de messages, afin que les acheteurs voient la boutique en ligne, pas l'entrepôt.
3. Connectez les transporteurs et l'impression
Transporteurs : Paramètres > Opérations > Prestataires de services de livraison. Utilisez vos propres contrats de transporteur ou le compte QrX UPS Payment on Delivery. Liez un compte à tous les canaux ou à un seul canal client.
Format d'étiquette : choisissez PDF ou ZPL et, pour UPS, Standard (étiquette du transporteur plus étiquette de paiement QrX) ou Extended (une étiquette combinée). Imprimez le jeu complet pour chaque colis Payment on Delivery.
Si votre WMS imprime lui-même, il utilise les étiquettes renvoyées par l'API. Sinon, connectez PrintNode dans Paramètres > Préférences > Impression.
4. Connectez votre WMS
Une clé API par canal client : Canaux marchands, ouvrez le canal, onglet Paramètres, Régénérer la clé API (Regenerate API Key). Stockez les clés chiffrées sur votre serveur, une par client.
Jeton : POST /api/v1/auth/token avec l'en-tête QrX-MerchantChannel-API-Key.
Recherchez les codes avec /api/v1/reference/shipping-methods et /api/v1/reference/senders. Ne codez jamais en dur les identifiants d'un autre client.
Créez la transaction avec son étiquette en un seul appel : POST /api/v1/transactions avec le type Payment pour le Payment on Delivery, ou No payment pour les commandes prépayées, plus un bloc parcel avec CreateCarrierLabel. Enregistrez l'identifiant de transaction et les étiquettes renvoyés avant de déclarer le colis comme emballé, afin qu'une nouvelle tentative n'achète jamais une deuxième étiquette.
Webhooks : Paramètres > Avancé > Webhooks. Abonnez-vous aux événements transaction payée, annulée et expédition, par canal ou pour tous les canaux. Vérifiez l'en-tête X-QrX-Signature.
Testez de bout en bout en mode test pour chaque client avant la mise en production : commande reçue, étiquette imprimée, paiement test à la porte, webhook reçu.
5. Passez en production client par client
Demandez à QrX d'activer le mode réel (Discutez avec QrX dans le guide).
Basculez un client à la fois, et conservez l'ancien flux pour ce client jusqu'à ce que les premiers paiements réels à la porte soient confirmés.
Bon à savoir
Une transaction annulée ne peut plus être payée, étiquetée ni expédiée. Annulez dans QrX lorsque la boutique en ligne annule.
HTTP 201 à la création n'est pas une preuve de paiement. Attendez le webhook de paiement.
Votre commission partenaire est fixée dans votre accord de partenariat ; il n'existe pas de tarif universel publié.
Dans ce parcours, le stock et le picking restent dans votre propre WMS. Vous préférez gérer votre entrepôt dans QrX ? Consultez « Démarrer en tant qu'entreprise de logistique sur le QrX WMS ».
Quand contacter notre équipe support
Contactez QrX pour convenir de votre modèle de compte et de vos conditions de partenariat, pour certifier vos étiquettes et votre imprimante, lorsque l'inscription d'un client auprès de son prestataire de paiement est bloquée, ou lorsque des webhooks échouent de manière répétée.