Saisie
Facture au format PDF ou XML
Un fichier par requête, encodé en Base64
Résultat
Données de facturation structurées
Données d'en-tête et postes individuels
Traitement
Asynchrone
Interrogation avec un identifiant d'interrogation, au maximum toutes les 30 secondes
Accès
Environnement de test et production
Facturé séparément, grâce à l'assistance Qvalia
Saisir une facture en deux étapes
Encodez le fichier en Base64, envoyez-le en définissant `enrichmentTypes` sur « capture », puis récupérez le résultat à l'aide de l'ID de sondage fourni dans la réponse.
- Un fichier de facture par demande, au format PDF ou XML
- Inclure l'extension du fichier dans « fileName »
- Ne pas interroger plus d'une fois toutes les 30 secondes
- Récupérer uniquement le résultat de la capture via le chemin « enrichmentType »
● ● ●
Demande concernant l'environnement de test : enregistrement d'une facture
# capture-request.json
{
"fileName": "invoice.pdf",
"fileContent": "<Base64-encoded PDF>",
"enrichmentTypes": "capture"
}
curl -X POST \
"https://api-test.qvalia.com/enrichment/$ACCOUNT_REG_NO/invoice" \
-H "Authorization: $QVALIA_API_KEY" \
-H "Content-Type: application/json" \
-d @capture-request.json
# Collect the result with the pollingId
curl "https://api-test.qvalia.com/enrichment/$ACCOUNT_REG_NO/$POLLING_ID/capture" \
-H "Authorization: $QVALIA_API_KEY"Essayez de numériser vous-même votre facture au format PDF
Téléchargez une facture au format PDF d'une taille maximale de 4,5 Mo dans l'outil de test de capture gratuit de Qvalia et découvrez les données structurées qu'il génère. Aucune intégration n'est nécessaire, et un exemple de rapport est disponible si vous n'avez pas de fichier sous la main.
Fonctionnement de la saisie des factures
La capture s'effectue de manière asynchrone. Vous téléchargez le fichier, Qvalia le traite et vous récupérez le résultat dès qu'il est prêt.
Téléverser
Envoyez une facture au format PDF ou XML par requête, encodée en Base64, vers le point de terminaison dédié aux factures.
Capture
Qvalia lit le document et extrait les données d'en-tête ainsi que les lignes de facturation pour les transformer en données de facturation structurées.
Sondage
Utilisez l'identifiant de requête. La valeur 202 indique que le traitement se poursuit, tandis que la valeur 200 renvoie le résultat.
Critique
Vérifiez les erreurs et les avertissements renvoyés pour chaque document avant que les données ne passent à l'étape suivante de votre processus.
Terminaux de capture
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 |
| Téléverser une facture | POST /enrichment/{accountRegNo}/invoice | Identifiant du sondage |
| Afficher tous les résultats | GET /enrichment/{accountRegNo}/{pollingId} | Statut ou résultats par type |
| Obtenir le résultat de la capture | GET /enrichment/{accountRegNo}/{pollingId}/capture | Résultat de la capture |
Bac à sable : api-test.qvalia.com. Production : api.qvalia.com. La fonctionnalité « Capture » fait partie de l'API Enrichment, qui fait l'objet d'une facturation distincte et dont l'activation est assurée par le service d'assistance de Qvalia.
Éléments à prendre en compte lors d'une intégration
La capture s'effectue en dehors de votre cycle de requêtes. Prévoyez ces points avant la mise en production.
- Traitement asynchrone
Enregistrez l'identifiant d'interrogation avec le document et n'effectuez pas d'interrogation plus d'une fois toutes les 30 secondes. - Erreurs et avertissements
Transmettez les documents contenant des erreurs pour qu'ils soient examinés manuellement et laissez les avertissements visibles pour l'utilisateur. - Limites de débit
Le nombre de requêtes est comptabilisé par compte pour l'ensemble des API Qvalia. En cas de code d'erreur 429, veuillez patienter jusqu'à l'expiration du délai « Retry-After ». - Environnements distincts
Effectuez vos tests sur api-test.qvalia.com avant de basculer vers api.qvalia.com. - Identifiants de sondage périmés
Une erreur 404 signifie que l'identifiant de sondage est inconnu ou périmé. Veuillez télécharger à nouveau le document si le résultat n'a jamais été enregistré.
Choisissez votre point de départ
Dans l'application web
OCR des factures
Importez des factures au format PDF dans l'application web Qvalia sans avoir à mettre en place d'intégration.
Affichage et classification
API d'enrichissement
Suggestions de comptabilisation et classification UNSPSC. La numérisation est l'étape de préparation qui permet de traiter les factures au format PDF pour ces deux finalités.
Pour commencer
Guide de démarrage rapide de l'API
Configurez l'accès à l'API et envoyez votre première requête, étape par étape.
FAQ sur l'API OCR pour les factures
Qu'est-ce que l'API OCR pour les factures ?
Une API REST qui transforme les factures au format PDF en données de facturation structurées. Elle fonctionne comme type de capture de l'API d'enrichissement.
Quels fichiers puis-je envoyer ?
Une facture au format PDF ou XML par demande, encodée en Base64 dans le champ « fileContent ». Indiquez l'extension du fichier dans le champ « fileName ».
Que renvoie l'API ?
Données de facture structurées comprenant les données d'en-tête et les lignes de facture, ainsi que les erreurs et les avertissements relatifs au document.
Combien de temps dure la capture ?
Le traitement est asynchrone ; le temps nécessaire varie donc d'un document à l'autre. Interrogez le point de terminaison de résultat au maximum une fois toutes les 30 secondes jusqu'à ce que vous obteniez un code 200.
En quoi l'API OCR diffère-t-elle de l'OCR de factures ?
La reconnaissance optique de caractères (OCR) des factures s'effectue dans l'application web Qvalia. L'API OCR permet à votre propre système d'effectuer la capture via une API REST.
Y a-t-il un bac à sable ?
Oui. Utilisez api-test.qvalia.com pour les tests et api.qvalia.com en production.
L'API OCR est-elle incluse dans d'autres API Qvalia ?
Non. La fonctionnalité « Capture » fait partie de l'API Enrichment, qui fait l'objet d'une facturation distincte. Le service d'assistance Qvalia se charge de l'activer sur votre compte.
