L'API Peppol en bref
De la clé API à la première requête
Notre équipe chargée de l'intégration vous accompagne tout au long du processus d'intégration et de test.
export ACCOUNT_REG_NO=YOUR_ACCOUNT_REGISTRATION_NUMBER
# Identifies the account in every Transaction API requestUtilisez cette valeur dans le chemin d'accès de la requête pour chaque appel de l'API Transaction.
export QVALIA_API_KEY=YOUR_SANDBOX_API_KEY
export QVALIA_BASE_URL=https://api-test.qvalia.comVeillez à séparer les identifiants du bac à sable de ceux de l'environnement de production.
curl -X POST \
${QVALIA_BASE_URL}/transaction/${ACCOUNT_REG_NO}/invoices/outgoing \
-H Authorization:${QVALIA_API_KEY} \
-H Content-Type:application/json \
-d @invoice.jsonLa réponse confirme la réception du document. Les résultats de la validation et le statut de livraison sont communiqués via des webhooks ou via le statut du document.
export QVALIA_API_KEY=YOUR_PRODUCTION_API_KEY
export QVALIA_BASE_URL=https://api.qvalia.comSuivez le traitement et la livraison grâce aux webhooks ou à l'état des documents.
Un compte, six API
API de facturation
Envoyez et recevez des factures et des avoirs via Peppol, avec validation avant transmission.
Commander l'API
Envoyez et recevez des bons de commande via Peppol, y compris les réponses aux commandes, les modifications et les annulations, pour l'ensemble du processus de commande.
API partenaire
Créez et gérez les comptes de vos clients finaux ainsi que leurs identifiants Peppol depuis votre propre plateforme, grâce à des webhooks pour les événements liés aux documents.
API OCR
Extraire les données structurées des factures au format PDF en vue de leur vérification et de leur traitement ultérieur.
API d'enrichissement
Classer les documents et les postes individuels, et enrichir les transactions avec des données structurées.
API Comptabilité
Générer des propositions de comptabilisation à partir des factures entrantes afin d'accélérer leur vérification et leur comptabilisation.
D'autres moyens de rester en contact
Lorsqu'une intégration via une API n'est pas la solution la plus adaptée, ou lorsque vous avez besoin de plus qu'un simple échange de documents.
- SFTP
Échangez des fichiers au format XML ou CSV via SFTP lorsqu'une intégration API n'est pas envisageable. - Connecteurs ERP
Connecteurs prêts à l'emploi pour les principaux systèmes ERP et comptables. - Serveur Peppol MCP
Offrez aux agents IA et aux clients MCP un accès structuré aux transactions, aux lignes de commande, au statut de livraison et à la validation. - Punchout
Relier le catalogue d'un fournisseur au système d'approvisionnement de l'acheteur. - Paiement B2B
Ajoutez une option de paiement et de facturation B2B à une boutique WooCommerce, avec livraison via Peppol.
Référence Peppol pour les développeurs
Cette page présente les API de Qvalia et les documents Peppol qu’elles transmettent. La norme Peppol qui les sous-tend, avec ses spécifications, ses règles de validation et ses listes de codes, est décrite dans notre documentation Peppol et notre guide de mise en œuvre. La référence complète des points de terminaison est disponible sur api.qvalia.io. Les spécifications normatives Peppol sont publiées par OpenPeppol sur docs.peppol.eu.
Les documents Peppol et leurs API
| Document | Spécification Peppol | API Qvalia |
| Facture | Peppol BIS Billing 3.0 | API de facturation |
| Note de crédit | BIS Billing s Peppol 3.0, note de crédit | API de notes de crédit |
| Commande et réponse à la commande | Peppol BIS Ordering | API de commande, API de réponse de commande |
| Contrat de commande | Peppol BIS Order Agreement | Commander des API de contrat |
| Modification et annulation de commande | Peppol BIS Advanced Ordering | API de modification de commande, API d'annulation de commande |
| Conseils d'expédition | Peppol BIS Despatch Advice | API d'avis d'expédition |
| Catalogue | BIS Catalogue s Peppol avec réponse | API de catalogue |
| État de la livraison | Réponse au niveau du message et état au niveau du message | API de réponse au niveau des messages, API d'état au niveau des messages |
Validation et erreurs
Listes de codes
Essais et exploitation
Bac à sable
Testez votre intégration avec vos propres systèmes sans affecter les clients réels ni les flux financiers.
Gestion des versions
Les modifications importantes sont publiées sous la forme d'une nouvelle version de l'API, avec un préavis d'au moins un mois.
État du système
Consultez l'état actuel de disponibilité des services et les dernières informations concernant les incidents.
Sécurité
Découvrez comment Qvalia aborde les questions de sécurité de l'information, de continuité d'activité et de confiance.
Peppol pour votre entreprise ou pour vos clients ?
Point d'accès de Peppol
Vous souhaitez envoyer et recevoir des documents Peppol pour votre entreprise. Connectez-vous au point d'accès Peppol de Qvalia et intégrez-le à votre ERP ou via l'API.
Solutions pour les partenaires
Proposez Peppol à vos propres clients selon le modèle qui correspond le mieux à votre rôle. Intégrez Peppol à votre produit via l'API de Qvalia, ou exploitez un point d'accès hébergé sous votre propre identité de fournisseur de services Peppol.
Questions posées par les développeurs
Vous trouverez davantage de conseils de mise en œuvre dans notre base de connaissances.
Existe-t-il un environnement de test ?
Oui. L'environnement de test disponible à l'adresse api-test.qvalia.com utilise une clé API distincte, ce qui vous permet d'effectuer des tests sans affecter les clients réels ni les flux financiers. Suivez le guide étape par étape de l'API Peppol disponible dans la base de connaissances.
Quels sont les formats pris en charge par l'API ?
JSON par défaut, ou XML. Les deux formats utilisent des structures basées sur la norme UBL 2.1 pour les points de terminaison des documents Peppol concernés. Définissez les en-têtes « Content-Type » et « Accept » sur « application/json » ou « application/xml ». Consultez la section « Types de messages Peppol » pour connaître les documents commerciaux et les processus pris en charge par le réseau.
Comment puis-je m'authentifier ?
À l'aide d'une clé API dans l'en-tête « Authorization », ou d'un jeton à durée de vie limitée (JWT) obtenu via le point de terminaison /token à l'aide de votre clé. Vous disposez de clés distinctes pour l'environnement de test et l'environnement de production.
Comment savoir si un document a bien été remis ?
Abonnez-vous aux webhooks ou interrogez l'API. Qvalia envoie des événements lorsqu'un document arrive, lorsqu'il est remis et en cas d'échec de la remise. Pour les messages de réponse au niveau Peppol, consultez la section « Statut au niveau du message » dans la base de connaissances.
Dois-je mettre en œuvre moi-même le protocole de transport Peppol ?
Non. Qvalia gère le point d'accès et se charge de la recherche des destinataires, du transport AS4 et de la livraison. Vous envoyez un document à l'API. Découvrez comment la découverte de services SMP et SML localise le point de terminaison destinataire.
Puis-je procéder à l'intégration sans écrire de code ?
Oui. Utilisez un connecteur ERP ou échangez des fichiers XML ou CSV via SFTP.
Quels documents Peppol puis-je échanger ?
Factures, avoirs, commandes, réponses aux commandes, accords de commande, modifications et annulations de commandes, avis d'expédition, catalogues et réponses au niveau des messages. Le tableau figurant sous la rubrique « Référence Peppol pour les développeurs » présente les spécifications propres à chacun d'entre eux. Les types de documents pris en charge par votre configuration dépendent du service et de l'intégration sélectionnés. Consultez la rubrique « Quels sont les types de messages dans Peppol ? » pour obtenir une vue d'ensemble.
Comment l'API identifie-t-elle le point de terminaison du destinataire ?
Qvalia utilise l'Peppol ID s du destinataire pour localiser son éditeur de métadonnées de service (SMP) via le localisateur de métadonnées de service (SML). Le SMP renvoie les capacités du document, ainsi que le processus et le point de terminaison de transport nécessaires à la livraison. Lire « Peppol SMP et SML : comment fonctionne la découverte de services ».
Que se passe-t-il lorsqu'un document n'est pas validé par Peppol ?
Un document présentant une erreur de validation fatale doit être corrigé avant d'être envoyé. Le code d'erreur identifie l'ensemble de règles concerné et la partie du document qui doit faire l'objet d'un examen. Voir « Comment fonctionne la validation Peppol » et « Codes des règles de validation Peppol ».
Comment puis-je vérifier les capacités d'un destinataire en matière d'Peppol ID s et de gestion de documents ?
Utilisez la recherche «Peppol ID » de Qvalia pour trouver les participants et les capacités de document publiés dans l'annuaire. Pour en savoir plus sur la structure et les schémas d'identifiants, consultez l'article « Qu'est-ce que l'Peppol ID? » dans la base de connaissances.