Mettre en place l'API, pas à pas

Terminal

export PFX_KEY="sk_test_votre_cle"

Terminal

curl https://api.pont-facturx.com/v1/account/usage \
  -H "Authorization: Bearer $PFX_KEY"

Terminal

curl -X POST https://api.pont-facturx.com/v1/extract \
  -H "Authorization: Bearer $PFX_KEY" \
  -F "file=@facture.pdf" \
  -o extract.json

extract.json (extrait)

{
  "job_id": "0f0a4f6e-2c39-4a6e-9d21-9c3f0f7f1f8e",
  "invoice_data": {
    "invoiceNumber": "FA-2026-0042",
    "invoiceDate": "2026-10-29",
    "vendorName": "Votre société SAS",
    "vendorSIRET": "12345678900017",
    "clientName": "Client SARL",
    "clientSIRET": "98765432100019",
    "amountHT": "1218.00",
    "vatAmount": "243.60",
    "amountTTC": "1461.60",
    "vatBreakdown": [{ "rate": "20", "base": "1218.00" }]
  },
  "raw": { "...": "sortie brute du moteur de lecture" }
}

Terminal

curl -X POST https://api.pont-facturx.com/v1/convert \
  -H "Authorization: Bearer $PFX_KEY" \
  -F "file=@facture.pdf" \
  -F "profile=EN16931" \
  -D entetes.txt \
  -o facture-facturx.pdf

Terminal

# Récupérer le bloc invoice_data de l'étape 3, puis le relire et le corriger
jq '.invoice_data' extract.json > invoice_data.json

curl -X POST https://api.pont-facturx.com/v1/convert \
  -H "Authorization: Bearer $PFX_KEY" \
  -F "file=@facture.pdf" \
  -F "profile=EN16931" \
  -F "invoice_data=<invoice_data.json" \
  -D entetes.txt \
  -o facture-facturx.pdf

Terminal

curl -X POST https://api.pont-facturx.com/v1/validate \
  -H "Authorization: Bearer $PFX_KEY" \
  -F "file=@facture-facturx.pdf"

convertir_export.py

import csv, json, os, pathlib
import requests  # pip install requests

API = "https://api.pont-facturx.com"
KEY = os.environ["PFX_KEY"]  # sk_test_... pour les essais, sk_live_... en production

# Ce qui ne change pas d'une facture à l'autre : votre société.
EMETTEUR = {
    "vendorName": "Votre société SAS",
    "vendorSIRET": "12345678900017",
    "vendorVAT": "FR32123456789",
    "vendorAddress": "1 rue de l'Exemple, 75001 Paris",
    "iban": "FR7630001007941234567890185",
}

sortie = pathlib.Path("facturx")
sortie.mkdir(exist_ok=True)

# Un export de votre logiciel : une ligne par facture, séparateur « ; ».
with open("export_factures.csv", newline="", encoding="utf-8") as f:
    for ligne in csv.DictReader(f, delimiter=";"):
        invoice_data = {
            **EMETTEUR,
            "invoiceNumber": ligne["numero"],
            "invoiceDate": ligne["date"],
            "dueDate": ligne["echeance"],
            "clientName": ligne["client"],
            "clientSIRET": ligne["siret_client"],
            "clientVAT": ligne["tva_client"],
            "clientAddress": ligne["adresse_client"],
            "amountHT": ligne["total_ht"],
            "vatAmount": ligne["total_tva"],
            "amountTTC": ligne["total_ttc"],
            "vatRate": ligne["taux_tva"],
            "paymentTerms": ligne["conditions"],
        }
        pdf = pathlib.Path("pdf") / f"{ligne['numero']}.pdf"
        with pdf.open("rb") as fichier:
            r = requests.post(
                f"{API}/v1/convert",
                headers={
                    "Authorization": f"Bearer {KEY}",
                    # Rejouer la même facture ne débite qu'un crédit.
                    "Idempotency-Key": f"facture-{ligne['numero']}",
                },
                files={"file": (pdf.name, fichier, "application/pdf")},
                data={
                    "profile": "EN16931",
                    "invoice_data": json.dumps(invoice_data, ensure_ascii=False),
                },
                timeout=120,
            )
        if r.status_code != 200:
            print(ligne["numero"], "ERREUR", r.status_code, r.text[:300])
            continue
        (sortie / pdf.name).write_bytes(r.content)
        print(ligne["numero"], r.headers.get("X-Facturx-Validation-Status"))