Développeurs
Envoyez un PDF, un scan ou une photo prise au téléphone et recevez un JSON avec le fournisseur ou le client, les références, les dates, les totaux, la TVA et les lignes de produits, déjà vérifiées par rapport aux totaux du document. Trois types de documents : factures fournisseurs, commandes fournisseurs et commandes clients.
Créez un compte et une clé API sur upinvoice.eu/api/tokens.
Envoyez le fichier en data URI base64 à POST /api/process-document avec son document_type.
Lisez le JSON, vérifiez les avertissements et créez le document dans votre système.
curl -sS https://upinvoice.eu/api/process-document \
-H "Authorization: Bearer $UPINVOICE_API_KEY" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
--max-time 120 \
-d @- <<EOF
{
"document_type": "supplier_invoice",
"invoice_file": "data:application/pdf;base64,$(base64 -w0 invoice.pdf)",
"company_name": "Demo Company SL",
"company_tax_id": "B12345678"
}
EOF
POST/api/process-document
Extrait un document. C'est celui à utiliser.
GET/api/check
Gratuit. Valide la clé et renvoie le forfait, les crédits restants et les types de documents pris en charge.
POST/api/process-invoice
Ancien, factures fournisseurs uniquement. Conservé pour les anciens modules Dolibarr.
Envoyez votre clé API comme bearer token et ajoutez toujours Accept: application/json ; sinon, une clé invalide reçoit une redirection au lieu d'un 401.
Authorization: Bearer <your-api-key>
Accept: application/json
| Champ | Description |
|---|---|
| document_type | Obligatoire. supplier_invoice (facture ou avoir reçu), supplier_order (votre bon de commande ou la confirmation de commande d'un fournisseur) ou customer_order (une commande envoyée par un client). |
| invoice_file | Obligatoire, même nom pour tous les types. Data URI data:<mime>;base64,<contenu>. Acceptés : application/pdf, image/jpeg, image/png, jusqu'à 5 Mo par fichier. |
| company_name, company_tax_id | Recommandé. Nom et numéro fiscal de votre propre entreprise, pour que l'IA ne vous confonde jamais avec le fournisseur ou le client. |
Le traitement est synchrone : en général 3 à 6 secondes, jusqu'à 30 secondes pour les longs PDF de plusieurs pages. Utilisez un timeout client d'au moins 90 secondes et jusqu'à 5 requêtes en parallèle.
L'objet data dépend du type de document. Les factures fournisseurs renvoient supplier, ref_supplier, date, totaux, TVA et lignes (les avoirs avec des montants négatifs). Les commandes renvoient thirdparty, ref_document, dates de commande et de livraison, devise, notes, lignes et avertissements. Chaque champ est décrit dans la spécification OpenAPI.
{
"success": true,
"data": {
"supplier": {
"name": "Example Supplies SL",
"idprof1": "B00000000",
"tva_intra": "ESB00000000",
"address": "Calle Mayor 1",
"zip": "46001",
"town": "Valencia",
"country_code": "ES",
...
},
"ref_supplier": "F-2026-0457",
"date": "2026-11-12",
"total_ht": 230,
"total_tva": 48.3,
"total_ttc": 278.3,
"tva_tx": 21,
"lines": [
{
"product_desc": "Printer toner, black",
"product_ref": "TN-2420",
"qty": 4,
"subprice": 50,
"remise_percent": 10,
"tva_tx": 21,
"total_ht": 180,
"total_tva": 37.8,
"total_ttc": 217.8,
"product_type": 0,
"accounting_code": "602"
},
...
],
"available_points": 72
}
}
| Code | Signification |
|---|---|
| 401 | Clé API absente ou invalide. |
| 409 | Une requête avec la même Idempotency-Key est encore en cours. Attendez la durée de Retry-After et réessayez avec la même clé. |
| 422 | Champ invalide, ou Idempotency-Key réutilisée avec un autre fichier. Corrigez la requête. |
| 400 | Data URI invalide, fichier non pris en charge, plus de crédits ou document illisible. Rien n'est facturé. Appelez /api/check pour distinguer un problème de crédits d'un problème de fichier. |
Le champ error est un message lisible par une personne, pas un code stable.
Envoyez une Idempotency-Key unique par document (un UUID ou votre propre identifiant de document). Si la connexion coupe, répétez la même requête avec la même clé : vous recevez le résultat enregistré avec l'en-tête Idempotent-Replayed: true, sans être facturé deux fois. Les clés sont conservées 48 heures.
L'extraction est réalisée par l'IA d'UpInvoice et se paie en crédits : un crédit par document traité. Les crédits sont inclus dans un forfait mensuel ou annuel, ou en packs supplémentaires quand vous en avez besoin. Les 10 premiers documents sont gratuits, sans carte bancaire.
Voir les forfaits et les prix →import base64, os, uuid
import requests # pip install requests
with open("invoice.pdf", "rb") as fh:
data_uri = "data:application/pdf;base64," + base64.b64encode(fh.read()).decode()
resp = requests.post(
"https://upinvoice.eu/api/process-document",
headers={
"Authorization": "Bearer " + os.environ["UPINVOICE_API_KEY"],
"Accept": "application/json",
"Idempotency-Key": str(uuid.uuid4()), # reuse it if you retry
},
json={
"document_type": "supplier_invoice",
"invoice_file": data_uri,
"company_name": "Demo Company SL",
"company_tax_id": "B12345678",
},
timeout=120,
)
result = resp.json()
if resp.ok:
invoice = result["data"]
print(invoice["supplier"]["name"], invoice["ref_supplier"], invoice["total_ttc"])
else:
print(resp.status_code, result.get("error") or result.get("message"))
$dataUri = 'data:application/pdf;base64,' . base64_encode(file_get_contents('invoice.pdf'));
$ch = curl_init('https://upinvoice.eu/api/process-document');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 120,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('UPINVOICE_API_KEY'),
'Accept: application/json',
'Content-Type: application/json',
'Idempotency-Key: ' . bin2hex(random_bytes(16)), // reuse it if you retry
],
CURLOPT_POSTFIELDS => json_encode([
'document_type' => 'supplier_invoice',
'invoice_file' => $dataUri,
'company_name' => 'Demo Company SL',
'company_tax_id' => 'B12345678',
]),
]);
$result = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($status === 200) {
$invoice = $result['data'];
echo $invoice['supplier']['name'], ' ', $invoice['ref_supplier'], ' ', $invoice['total_ttc'], PHP_EOL;
} else {
echo $status, ' ', $result['error'] ?? $result['message'] ?? '', PHP_EOL;
}
curl -sS https://upinvoice.eu/api/process-document \
-H "Authorization: Bearer $UPINVOICE_API_KEY" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
--max-time 120 \
-d @- <<EOF
{
"document_type": "supplier_invoice",
"invoice_file": "data:application/pdf;base64,$(base64 -w0 invoice.pdf)",
"company_name": "Demo Company SL",
"company_tax_id": "B12345678"
}
EOF
Tout ce dont un assistant IA a besoin pour créer une intégration ou lire des factures à votre place.
Instructions, règles des champs et un script d'aide pour qu'un agent IA (Claude Code et les autres agents compatibles SKILL.md) écrive une intégration correcte du premier coup.
Ouvrir →Connectez Claude, Cursor ou tout client MCP à UpInvoice pour qu'il extraie factures et commandes comme un outil.
Ouvrir →Référence lisible par les machines : importez-la dans Postman, générez un client ou donnez-la à votre assistant IA.
Ouvrir →Résumé d'UpInvoice pour les modèles de langage : produit, types de documents, prix et liens.
Ouvrir →Pas besoin de coder : le module UpInvoice gratuit pour Dolibarr utilise déjà cette API et crée les factures et les commandes pour vous.
Voir le module Dolibarr →