Documentation

Extraction de Documents AP

Extraire bons de commande, documents de livraison, avis de paiement, releves bancaires et e-factures autonomes via l'API documents AP.

POST/v1/documents/extractPro

L'extraction de documents AP est separee de l'extraction de factures. Les endpoints de factures existants conservent l'enveloppe top-level invoice; les endpoints de documents AP renvoient l'enveloppe top-level document.

Endpoints

EndpointEntreeOffre
POST /v1/documents/extractBody JSON avec textPro et Business
POST /v1/documents/extract/fileFichier multipart avec PDF, image ou XMLPro et Business
POST /v1/documents/extract/urlBody JSON avec urlPro et Business

Pro inclut les bons de commande, bons de livraison, bordereaux de colisage, bons de reception, avis de remise et avis de paiement. Business ajoute le parsing autonome XRechnung et Peppol ainsi que l'extraction de releves bancaires.

Document Type vs Source Format

document_type decrit le document metier: purchase_order, delivery_note, remittance_advice, bank_statement, invoice, credit_note et les familles AP associees.

source_format decrit le mode d'arrivee ou le standard structure parse: text, pdf, image, url, zugferd, factur_x, xrechnung, peppol_bis_billing ou unknown_xml.

Les e-factures structurees gardent normalement document_type a invoice ou credit_note et definissent source_format sur xrechnung, peppol_bis_billing, zugferd ou factur_x.

Upload fichier

curl -X POST "https://api.parsurai.com/v1/documents/extract/file?locale=de" \
  -H "X-API-Key: $PARSURAI_API_KEY" \
  -F "document_type_hint=purchase_order" \
  -F "file=@purchase-order.pdf"

Reponse

{
  "document_id": "6ed32f61-f826-4ce1-8d0d-508fb68d1f12",
  "document_type": "purchase_order",
  "source_format": "pdf",
  "schema_version": 1,
  "document": {
    "po_number": "PO-2026-0042",
    "supplier": { "name": "Muster GmbH" },
    "buyer": { "name": "Buyer GmbH" },
    "line_items": [],
    "currency": "EUR",
    "total_amount": "2975.00"
  },
  "raw_structured_metadata": {},
  "confidence": 0.91,
  "field_confidence": {},
  "warnings": []
}

Utilisez POST /v1/extract/file pour la reponse facture classique. Utilisez POST /v1/documents/extract/file pour l'enveloppe document AP ou les e-factures XML autonomes.

Fonctionnalités Associées

Pour des flux de travail de comptabilité fournisseurs plus spécialisés, vous pouvez également utiliser :