Extraction de factures

Extrayez les informations du fournisseur, les lignes de détail, les totaux et les dates de vos factures. Parse prend en charge une grande variété de formats de facture, notamment les PDFs, les images scannées et les documents de plusieurs pages.

Schéma de facture

Définissez un schéma qui capture les champs clés d’une facture :

{
  "name": "invoice",
  "description": "Extract data from invoices",
  "fields": [
    { "name": "vendor_name", "type": "string", "description": "Company name of the vendor" },
    { "name": "vendor_address", "type": "string", "description": "Address of the vendor" },
    { "name": "invoice_number", "type": "string", "description": "Invoice reference number" },
    { "name": "date", "type": "date", "description": "Invoice issue date" },
    { "name": "due_date", "type": "date", "description": "Payment due date" },
    { "name": "line_items", "type": "array", "description": "List of billed items", "items": {
      "type": "object",
      "fields": [
        { "name": "description", "type": "string" },
        { "name": "quantity", "type": "number" },
        { "name": "unit_price", "type": "number" },
        { "name": "amount", "type": "number" }
      ]
    }},
    { "name": "subtotal", "type": "number", "description": "Subtotal before tax" },
    { "name": "tax", "type": "number", "description": "Tax amount" },
    { "name": "total", "type": "number", "description": "Total amount due" },
    { "name": "currency", "type": "string", "description": "Currency code (e.g. USD, EUR)" }
  ]
}

Exemples de code

cURL

curl -X POST https://api-parse.conversiontools.io/v1/extract \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@invoice.pdf" \
  -F "schema_id=YOUR_INVOICE_SCHEMA_ID"

Python

import requests

API_KEY = "YOUR_API_KEY"
headers = {"Authorization": f"Bearer {API_KEY}"}

with open("invoice.pdf", "rb") as f:
    response = requests.post(
        "https://api-parse.conversiontools.io/v1/extract",
        headers=headers,
        files={"file": f},
        data={"schema_id": "YOUR_INVOICE_SCHEMA_ID"},
    )

data = response.json()
print(f"Vendor: {data['data']['vendor_name']}")
print(f"Total: {data['data']['currency']} {data['data']['total']}")
for item in data["data"]["line_items"]:
    print(f"  - {item['description']}: {item['amount']}")

Node.js

const fs = require("fs");

const API_KEY = "YOUR_API_KEY";
const headers = { Authorization: `Bearer ${API_KEY}` };

const form = new FormData();
form.append("file", fs.createReadStream("invoice.pdf"));
form.append("schema_id", "YOUR_INVOICE_SCHEMA_ID");

const response = await fetch("https://api-parse.conversiontools.io/v1/extract", {
  method: "POST",
  headers,
  body: form,
});

const data = await response.json();
console.log(`Vendor: ${data.data.vendor_name}`);
console.log(`Total: ${data.data.currency} ${data.data.total}`);
data.data.line_items.forEach((item) => {
  console.log(`  - ${item.description}: ${item.amount}`);
});

Exemple de résultat

{
  "success": true,
  "id": "ext_inv_001",
  "data": {
    "vendor_name": "TechSupply Inc.",
    "vendor_address": "123 Business Ave, Suite 400, San Francisco, CA 94105",
    "invoice_number": "INV-2024-0847",
    "date": "2024-01-15",
    "due_date": "2024-02-14",
    "line_items": [
      {
        "description": "Cloud Hosting - Standard Plan",
        "quantity": 1,
        "unit_price": 299.00,
        "amount": 299.00
      },
      {
        "description": "SSL Certificate - Wildcard",
        "quantity": 2,
        "unit_price": 49.99,
        "amount": 99.98
      },
      {
        "description": "Technical Support - Premium",
        "quantity": 1,
        "unit_price": 150.00,
        "amount": 150.00
      }
    ],
    "subtotal": 548.98,
    "tax": 49.41,
    "total": 598.39,
    "currency": "USD"
  },
  "pages_used": 1
}

Exporter vers CSV ou Excel

Vous préférez une feuille de calcul ? Exportez n’importe quelle extraction terminée au format CSV ou Excel. Les lignes de détail deviennent des lignes avec l’en-tête de la facture répété sur chacune, prêtes pour vos outils de comptabilité. Les exports sont gratuits.

# Start the export, then download when ready
curl -X POST https://api-parse.conversiontools.io/v1/extractions/ext_inv_001/export \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"format": "xlsx"}'

curl -L -o invoice.xlsx \
  "https://api-parse.conversiontools.io/v1/extractions/ext_inv_001/export?format=xlsx" \
  -H "Authorization: Bearer YOUR_API_KEY"

Conseils pour réussir l’extraction de factures

Les factures de plusieurs pages sont prises en charge - toutes les pages sont traitées et les données combinées automatiquement
La devise est détectée automatiquement ; ajoutez un champ currency à votre schéma pour la capturer explicitement
Utilisez le type array pour les lignes de détail afin de gérer les factures comportant un nombre variable d’éléments
Pour les factures scannées, assurez-vous que l’image fait au moins 150 DPI pour obtenir les meilleurs résultats