Flux des commandes
Commande à expédier
Commandes, réponses, modifications et annulations
Spécifications
Spécifications Peppol BIS
Commande uniquement, Passation de commande, Passation de commande avancée, Accord de commande
Événements
Webhooks signés
Reçu, livré, en retard et en échec
Disponibilité
99,8 % par mois
Contractuel, avec crédits de service
Le flux de commande Peppol dans une seule API
L'acheteur et le fournisseur se connectent chacun via leur propre point d'accès. Votre système envoie et récupère les messages via l'API de Qvalia, tandis que Qvalia se charge de la validation, de la recherche des destinataires et de la livraison sur le réseau Peppol.
Recevoir une commande et y répondre
En tant que fournisseur, abonnez-vous au webhook « nouveau document », récupérez les commandes non lues et répondez en envoyant une réponse de commande. En tant qu'acheteur, envoyez vos commandes vers le point de terminaison sortant et suivez les réponses sur le point de terminaison entrant.
- Environnement de test sur api-test.qvalia.com, environnement de production sur api.qvalia.com
- JSON par défaut, ou XML UBL avec les en-têtes « Content-Type » et « Accept »
- Une clé d'idempotence sur chaque requête POST garantit la sécurité des tentatives de réessai
● ● ●
Sandbox : récupérer les commandes non lues, puis répondre
# Fetch unread incoming orders (marks them as read)
curl "https://api-test.qvalia.com/transaction/$ACCOUNT_REG_NO/orders/incoming/readorders?limit=10" \
-H "Authorization: $QVALIA_API_KEY" \
-H "Accept: application/json"
# Reply with an order response
curl -X POST \
"https://api-test.qvalia.com/transaction/$ACCOUNT_REG_NO/orderresponses/outgoing" \
-H "Authorization: $QVALIA_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d @order-response.jsonClassement des messages et des points de terminaison
Chaque chemin commence par /transaction/{accountRegNo}. Chaque type de message dispose de points de terminaison sortants et entrants, d'un point de terminaison de lecture pour les messages non lus et d'un point de terminaison d'état.
| Message | Envoyé par | Point d'extrémité | Peppol BIS |
| Commande | Acheteur | /orders | Commande uniquement, Commande, Commande avancée |
| Réponse à la commande | Fournisseur | /orderresponses | Commandes, Commandes anticipées |
| Modification de la commande | Acheteur | /order-changes | Commande avancée |
| Annulation de commande | Acheteur | /order-cancellations | Commande avancée |
| Contrat de commande | Fournisseur | /orderagreements | Contrat de commande |
| Catalogue | Fournisseur | /catalogues | Catalogue |
| Réponse au catalogue | Acheteur | /catalogueresponses | Catalogue avec réponse |
| Conseils d'expédition | Fournisseur | /despatch-advices | Avis d'expédition |
Les messages utilisés par votre compte dépendent du service et de la formule souscrite. Les schémas de requête et de réponse pour chaque message se trouvent dans le fichier Référence de l'API « Order ». Les factures relatives aux commandes livrées passent par le API de facturation. Pour vérifier, avant l'envoi, que le destinataire est bien inscrit à un type de message, par exemple Order ou OrderResponse, utilisez le recherche de destinataires.
Choisissez votre point de départ
Fournisseurs
E-commande gestion
Recevez et traitez les commandes Peppol dans l'application web de Qvalia, puis convertissez-les en factures, avant de mettre en place une intégration.
Plateformes d'approvisionnement
Peppol intégré
Envoyez et recevez les commandes de vos propres clients. L'API Partenaire crée leurs comptes et leurs identifiants Peppol, tandis que l'API Commande assure la transmission des messages.
Commerce en ligne
Punchout
Connectez votre catalogue au système d'approvisionnement de l'acheteur, afin que le panier d'achat soit converti en commande structurée.
FAQ sur l'API de commande
Qu'est-ce qu'une API de commande ?
Une API de commande permet à votre système d'envoyer et de recevoir des bons de commande, ainsi que les messages qui s'y rapportent, dans un format structuré. L'API de commande de Qvalia prend en charge les messages « BIS ordering » de Peppol au format JSON ou XML UBL et les transmet via le réseau Peppol.
Quels types de messages de commande l'API prend-elle en charge ?
Commandes, réponses aux commandes, modifications de commandes, annulations de commandes, accords relatifs aux commandes, catalogues accompagnés de réponses aux catalogues et avis d'expédition. Chacun d'entre eux comporte des points de terminaison entrants et sortants.
Quelle est la différence entre « Peppol BIS Ordering » et « Advanced Ordering » ?
La fonction « Commande » couvre la commande et la réponse à celle-ci. La fonction « Commande avancée » inclut les modifications et les annulations de commande, ce qui permet à l'acheteur de modifier ou d'annuler une commande après son envoi. Consultez les articles « Qu'est-ce que Peppol BIS Ordering? » et « Qu'est-ce que Peppol BIS Advanced Ordering? ».
Puis-je recevoir des commandes Peppol sans intégration ?
Oui. Tous les forfaits Connect permettent de recevoir des commandes Peppol dans l'application web de Qvalia. L'accès à l'API et à l'environnement de test est inclus à partir du forfait Connect « Medium ».
Comment savoir si une commande a été livrée ?
Abonnez-vous aux webhooks pour les événements de livraison et d'erreur, ou consultez le point de terminaison d'état pour les commandes. Tout événement de livraison peut être récupéré à nouveau pendant 30 jours à l'aide de son identifiant d'événement.
Une commande peut-elle devenir une facture ?
Oui. Dans l'application web Connect, l'automatisation du processus « de la commande à la facture » est incluse à partir de la formule « Medium ». Dans votre propre intégration, utilisez les données de la commande pour créer la facture et l'envoyer via l'API de facturation.
Y a-t-il un bac à sable ?
Oui. L'environnement de test disponible à l'adresse api-test.qvalia.com utilise sa propre clé API, ce qui vous permet de tester les processus de commande sans affecter les commandes réelles.
