L'API d'enrichissement ajoute des données structurées aux factures fournisseurs et aux données produit. Elle propose deux types d'enrichissement : les suggestions de comptabilisation, qui proposent une codification comptable pour chaque ligne d'une facture fournisseur, et la classification des produits, qui attribue des codes UNSPSC aux lignes de facture ainsi qu'aux produits figurant dans les catalogues et les listes de prix.
| Enrichissement | Ce que vous envoyez | Ce que vous obtenez en retour |
| Suggestions de publication | Une facture fournisseur | Proposition de codage comptable par ligne de facture, à valider par votre équipe |
| Classification des produits | Produits avec votre propre référence et un nom de produit, ou lignes de facture | Un code UNSPSC pour chaque produit, fourni avec votre identifiant |
| Saisie (étape de prise en charge) | Une facture au format PDF | Données d'en-tête et lignes de facture sous forme de données structurées |
La fonction « Capture » transforme une facture au format PDF en données structurées afin que les modules d'enrichissement disposent de données sur lesquelles travailler. Les factures reçues au format Peppol ou sous forme d'autres documents XML ne passent pas par cette étape. La fonction « Capture » est également disponible séparément sous la forme d'une API OCR.
Comment fonctionne une demande ?
- Envoyez une requête POST vers le point de terminaison « facture » ou « catégorisation ».
- Enregistrez l'identifiant de sondage renvoyé dans la réponse.
- Récupérez le résultat à l'aide d'une requête GET, à raison d'une seule fois toutes les 30 secondes au maximum.
- Récupérez les résultats pour tous les types d'enrichissement à la fois, ou pour un seul type.
● ● ●
Critères d'évaluation
POST /enrichment/{accountRegNo}/invoice
POST /enrichment/{accountRegNo}/categorisation
GET /enrichment/{accountRegNo}/{pollingId}
GET /enrichment/{accountRegNo}/{pollingId}/{enrichmentType}Le bac à sable se trouve à api-test.qvalia.com et la production à api.qvalia.com. Les requêtes sont authentifiées à l'aide d'une clé API ou d'un JWT provenant de l'API Compte.
Où sont utilisés les résultats ?
- Comptes fournisseurs : l'imputation comptable validée est transférée avec la facture vers les étapes de validation et de comptabilisation.
- Catalogues et listes de prix : ajoutez les codes UNSPSC aux articles qui n'en possèdent pas.
- Analyse des dépenses : achats groupés par segment UNSPSC, famille et classe, tous fournisseurs confondus.
- Votre propre plateforme: affichez des suggestions et des classifications dans votre propre interface.
Accès
L'API d'enrichissement fait l'objet d'une facturation distincte et nécessite des autorisations supplémentaires. Le service d'assistance de Qvalia active les enrichissements utilisés par votre compte.
À lire également : Comment fonctionnent les suggestions de publication · Comment fonctionne la classification UNSPSC · Comment fonctionne la capture de fichiers PDF · Référence API
