Documentation Parsurai
La reference developpeur pour l'extraction de factures Parsurai, la division, le recadrage et la classification de documents AP, ZUGFeRD, doublons, analyses fournisseurs et integrations comptables.
Parsurai aide les outils comptables, ERP et logiciels metier a extraire des donnees de facture structurees depuis du texte, des uploads PDF, des uploads image et des URLs de documents accessibles. Elle divise egalement les scans de lots multi-pages en documents individuels, recadre plusieurs documents depuis une seule page scannee, classifie les documents AP par type, et traite bons de commande, bons de livraison et autres documents AP via une API d'extraction dediee et un workflow de revue.
Nouveau ici ? Commencez par le guide de demarrage rapide et parsez votre premiere facture avec l'API d'extraction actuelle.
Decouvrir Parsurai
Demarrage rapide
Envoyez des extractions texte, fichier et URL, puis lisez le schema de reponse et les compteurs d'usage.
Authentification
Utilisez `X-API-Key`, faites tourner les cles `sk_live_` et gardez les appels API cote serveur.
Extraction de factures
Reference pour `POST /v1/extract`, `POST /v1/extract/file` et `POST /v1/extract/url` avec explications des champs.
Parsing ZUGFeRD
Lit les pieces jointes XML supportees dans les PDF hybrides ZUGFeRD, Factur-X et XRechnung sur Pro et Business.
SDKs & bibliotheques
Utilisez `invoiceextract` pour Python et `@invoiceextract/sdk` pour les clients TypeScript.
Serveur MCP
Exposez `extract_invoice`, `check_duplicate` et `get_vendor_analytics` aux assistants compatibles MCP.
Apercu de la plateforme
Parsurai expose un petit ensemble de surfaces API publiques. Masquez les workflows limites par offre tant que l'offre courante ne les supporte pas.
| Couche | Fonction | Endpoints |
|---|---|---|
| Parsing de documents | Extrait parties, dates, lignes, taxes, totaux, type de document et confiance | /v1/extract, /v1/extract/file, /v1/extract/url |
| Traitement de documents AP | Divise les lots multi-pages, recadre les scans multi-documents, classifie le type de document et extrait bons de commande, bons de livraison et autres documents AP | /v1/documents/split, /v1/documents/crop, /v1/documents/classify, /v1/documents/extract, /v1/workflows/ap/process |
| XML integre | Lit les pieces jointes XML ZUGFeRD / Factur-X / XRechnung supportees dans les PDF hybrides | /v1/extract/zugferd |
| Intelligence | Score les doublons, renvoie des flags d'anomalie et liste les metriques fournisseurs agregees | /v1/intelligence/*, /v1/analytics/vendors |
| Export comptable | Telecharge un CSV compatible DATEV pour une periode | /v1/exports/datev |
| Receiver Stripe | Recoit les evenements de facturation Stripe pour l'etat du compte Parsurai | /webhooks/stripe |
| Webhooks sortants | Livraison d'evenements signes HMAC vers votre propre endpoint HTTPS (plans Pro et Business) | /v1/webhooks |
Standards API
Toutes les APIs Parsurai suivent des conventions coherentes:
- URL de base:
https://api.parsurai.com - Protocole: HTTPS uniquement.
- Authentification: En-tete
X-API-Keysur chaque requete. - Format de requete:
application/jsonpour les endpoints JSON;multipart/form-datapour les uploads de fichiers. - Format de reponse:
application/jsonen UTF-8, sauf l'export DATEV qui renvoieapplication/octet-stream. - Erreurs: Les erreurs applicatives renvoient
{ "error": { "code": "...", "message": "..." } }. - Versioning: La version stable actuelle est
v1.
Types de documents supportes
| Format | Endpoint texte | Upload fichier | Entree URL | Endpoint ZUGFeRD |
|---|---|---|---|---|
| Texte brut / corps d'email | Oui | Non | Non | Non |
| Facture PDF | Non | Oui | Oui | Non |
| Facture JPEG / PNG | Non | Oui | Oui | Non |
| PDF/A-3 ZUGFeRD / Factur-X | Non | Oui | Oui | Oui, si l'XML integre utilise un nom supporte |
Couverture des fonctionnalites
Extraction de documents AP
Parsez bons de commande, bons de livraison, avis de paiement et e-factures autonomes via l'enveloppe de document AP.
Classification AP
Categorisez les documents entrants par type et confiance avant le parsing avec `POST /v1/documents/classify`.
Recadrage automatique
Detectez et isolez plusieurs documents physiques scannes ou photographies ensemble sur une seule page.
Division automatique
Segmentez les lots PDF multi-pages en documents logiques selon les limites, en synchrone ou via un job en attente.
Workflow documents AP
Faites passer les documents AP par un pipeline fixe en huit etapes avec revue humaine et pistes d'audit.
Detection de doublons
Score les doublons possibles avec `{ score, reason, matching_invoice_ids }`; les scores `>= 0.85` sont des correspondances probables.
Detection d'anomalies
Renvoie des `flags` pour changements fournisseur, paiement, devise, montant, conditions, taux fiscal et ID fiscal.
Analyses fournisseurs
Liste `items` avec ID profil fournisseur, nom affiche, nombre de factures, depense totale, montant moyen et derniere activite.
Webhooks sortants
Abonnez-vous a une livraison d'evenements signee et verifiee par HMAC pour l'extraction, la revue et les workflows.
Receiver webhook Stripe
Documente le receiver interne `POST /webhooks/stripe` et les trois evenements de facturation Stripe geres par le routeur.
Export DATEV
Telecharge un CSV encode `windows-1252` avec `POST /v1/exports/datev?from=YYYY-MM-DD&to=YYYY-MM-DD`.
Limites de debit & erreurs
Verifiez quotas d'offre, limites de requetes, retry, usage et codes d'erreur actuels.