Enrichissements
Affichage et classification
Demande par document
Étape d'assistance
Capture
Conversion des factures au format PDF en données structurées
Taxonomie
UNSPSC
Résultats renvoyés par référence produit
Traitement
Asynchrone
Interroger toutes les 30 secondes au maximum
Deux enrichissements, avec la capture comme support
La saisie et le classement constituent les étapes d'enrichissement. La numérisation est l'étape qui transforme une facture au format PDF en données structurées, permettant ainsi aux deux processus de fonctionner.
Suggestions de publication
Propositions de comptabilisation pour chaque ligne d'une facture fournisseur, générées à partir de l'historique des écritures comptables de votre organisation. Votre équipe valide chaque proposition.
Classification des produits
Les codes UNSPSC correspondant aux lignes de facture et aux produits issus des catalogues et des listes de prix, chacun étant associé à votre propre identifiant.
Capture en tant que support
Lorsqu'une facture est reçue au format PDF, le système « Capture » extrait d'abord les données d'en-tête et les lignes de facturation, afin que les modules de comptabilisation et de classification disposent de données structurées sur lesquelles s'appuyer.
Récupérer les résultats
Chaque requête renvoie un identifiant d'interrogation. Récupérez le résultat par type d'enrichissement, en ne lançant pas plus d'une interrogation toutes les 30 secondes.
Classer une liste de produits en deux requêtes
Envoyez les noms de produits accompagnés de vos propres identifiants, par exemple des articles issus d'un catalogue, d'une liste de prix ou de votre registre d'articles. La réponse vous fournit un identifiant de requête, et le résultat renvoie chaque identifiant de produit avec sa classification UNSPSC.
- Les identifiants de vos produits apparaissent dans le résultat
- Authentifiez-vous à l'aide d'une clé API ou d'un JWT provenant de l'API Compte
- Ne pas interroger plus d'une fois toutes les 30 secondes
- Distinguer les URL de base de l'environnement de test et celles de l'environnement de production
● ● ●
Demande relative au bac à sable : classer les produits
curl -X POST \
"https://api-test.qvalia.com/enrichment/$ACCOUNT_REG_NO/categorisation" \
-H "Authorization: $QVALIA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"enrichmentTypes": "unspsc",
"products": [
{ "id": 1, "product_name": "Nitrile gloves, size M" },
{ "id": 2, "product_name": "A4 copy paper, 80 g" }
]
}'
# Collect the result with the pollingId
curl "https://api-test.qvalia.com/enrichment/$ACCOUNT_REG_NO/$POLLING_ID" \
-H "Authorization: $QVALIA_API_KEY"Critères d'enrichissement
Tous les chemins d'accès sont relatifs à l'URL de base de l'environnement de test ou de production et sont associés à votre numéro d'enregistrement de compte.
| Demande | Point d'extrémité | Retours |
| Enrichir une facture | POST /enrichment/{accountRegNo}/invoice | Identifiant du sondage |
| Classer les produits | POST /enrichment/{accountRegNo}/categorisation | Identifiant du sondage |
| Afficher tous les résultats | GET /enrichment/{accountRegNo}/{pollingId} | Statut ou résultats par type |
| Obtenir un résultat | GET /enrichment/{accountRegNo}/{pollingId}/{enrichmentType} | Résultat de la saisie, de la comptabilisation ou du classement |
Bac à sable : api-test.qvalia.com. Production : api.qvalia.com. L'API Enrichment fait l'objet d'une facturation distincte, et le service d'assistance de Qvalia active les enrichissements utilisés par votre compte.
Dans les cas où des données enrichies sont utilisées
La saisie des suggestions et des codes UNSPSC alimente d'autres processus, que ce soit dans votre propre plateforme ou dans Qvalia.
- Comptes fournisseurs
Une fois validée, la codification du compte est reprise dans le processus de validation et de comptabilisation de la facture. - Catalogues et listes de prix
Ajouter un code UNSPSC aux articles du catalogue et de la liste de prix qui n'en possèdent pas. - Analyse des dépenses
: les codes UNSPSC vous permettent de regrouper les achats par segment, famille et classe, tous fournisseurs confondus. - Votre propre plateforme
Proposez des suggestions et des classifications à vos utilisateurs via votre propre interface.
Choisissez votre point de départ
Publication
API Comptabilité
Comment les suggestions de publication sont traitées, vérifiées et validées par votre équipe.
Données sur le produit
Classification UNSPSC
Comment Qvalia classe les lignes de facture et les données produit à l'aide de l'UNSPSC.
Capture
API OCR
L'étape de capture seule, avec un essai gratuit pour votre propre facture au format PDF.
FAQ sur l'API d'enrichissement
Qu'est-ce que l'API Enrichment ?
Une API REST proposant deux fonctionnalités d'enrichissement : des suggestions de comptabilisation pour les factures fournisseurs et la classification UNSPSC des lignes de facture et des produits. « Capture » est une étape de traitement qui transforme les factures au format PDF en données structurées avant leur comptabilisation et leur classification.
Pourquoi la capture est-elle une étape de soutien ?
Traitement et classification des données structurées. Les factures reçues au format Peppol ou sous forme d'autres documents XML contiennent déjà ces informations. Une facture au format PDF est d'abord numérisée, ce qui permet de traiter et de classer ses données d'en-tête et ses lignes de facturation. La numérisation est également disponible de manière indépendante via l'API OCR.
Comment fonctionnent les suggestions de publication ?
Elles sont entraînées à partir des factures que votre organisation a déjà comptabilisées. Chaque nouvelle facture fournisseur fait l'objet de suggestions d'imputation par ligne, que votre équipe doit ensuite valider. Pour en savoir plus, consultez la page consacrée à l'API Comptabilité.
Puis-je classer les catalogues et les listes de prix ?
Oui. La demande de classification nécessite une liste de produits, chacun comportant son propre identifiant et un nom de produit ; ainsi, les articles issus d'un catalogue, d'une liste de prix, d'un registre d'articles ou de lignes de facture sont transmis de la même manière.
Quelle taxonomie la classification utilise-t-elle ?
UNSPSC. Le résultat renvoie chaque référence de produit accompagnée de sa classification, ce qui vous permet de l'associer à vos propres enregistrements.
Y a-t-il un bac à sable ?
Oui. Utilisez api-test.qvalia.com pour les tests et api.qvalia.com en production.
L'API Enrichment est-elle incluse dans d'autres API Qvalia ?
Non. 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.
