Brancher Dolibarr à un moteur Factur-X EN16931 via API REST

<?php

/**
 * Hook Dolibarr custom — appel FacturX API /convert
 * Place ce code dans un module Dolibarr custom (htdocs/custom/yourmodule/)
 * et déclenche-le depuis BILL_VALIDATE ou un cron.
 */

use Symfony\Component\HttpClient\HttpClient;

function facturx_convert_dolibarr_invoice(string $pdfPath, array $invoice): array
{
    $client = HttpClient::create([
        'timeout' => 20,
        'headers' => [
            'Authorization' => 'Bearer ' . getenv('FACTURX_API_KEY'),
            'Accept-Language' => 'fr',
        ],
    ]);

    // Dans un module réel, construisez ce JSON depuis la facture Dolibarr.
    // Gardez toutes les racines : seller, buyer, totals, tax_breakdown, line_items.
    $invoiceData = <<<'JSON'
{
  "invoice_number": "FA-2026-042",
  "issue_date": "2026-04-01",
  "invoice_type": "380",
  "currency": "EUR",
  "seller": {
    "name": "Ma Societe SAS",
    "siret": "10000000900017",
    "vat_id": "FR88100000009",
    "address": {
      "street": "10 rue de Rivoli",
      "city": "Paris",
      "postal_code": "75001",
      "country": "FR"
    }
  },
  "buyer": {
    "name": "Client SA",
    "siret": "10000001700010",
    "address": {
      "street": "20 rue de la Republique",
      "city": "Lyon",
      "postal_code": "69002",
      "country": "FR"
    }
  },
  "references": {
    "buyer_reference": "SERVICE-ACHATS",
    "purchase_order_reference": "PO-2026-0017",
    "contract_reference": "CTR-2026-04"
  },
  "totals": {
    "net": "970.00",
    "tax": "194.00",
    "gross": "1164.00",
    "prepaid_amount": "100.00",
    "rounding_amount": "0.00",
    "due": "1064.00"
  },
  "tax_breakdown": [
    {
      "rate": "20.00",
      "category": "S",
      "base": "970.00",
      "amount": "194.00"
    }
  ],
  "line_items": [
    {
      "number": "1",
      "description": "Prestation conseil",
      "quantity": "10",
      "unit": "C62",
      "unit_price": "100.00",
      "net_amount": "970.00",
      "vat_rate": "20.00",
      "vat_category": "S",
      "purchase_order_line_reference": "10",
      "gross_unit_price": "120.00",
      "price_discount": "20.00",
      "allowances": [
        {
          "amount": "50.00",
          "reason": "Remise ligne",
          "reason_code": "95"
        }
      ],
      "charges": [
        {
          "amount": "20.00",
          "reason": "Supplement urgent"
        }
      ]
    }
  ],
  "payment": {
    "due_date": "2026-05-01",
    "terms": "Paiement a 30 jours",
    "iban": "FR7630006000011234567890189"
  },
  "delivery": {
    "date": "2026-04-01",
    "address": {
      "street": "20 rue de la Republique",
      "city": "Lyon",
      "postal_code": "69002",
      "country": "FR"
    }
  },
  "invoicing_period": {
    "start_date": "2026-04-01",
    "end_date": "2026-04-30"
  }
}
JSON;

    $response = $client->request('POST', 'https://api.facturxapi.com/api/v1/convert', [
        'body' => [
            'file' => fopen($pdfPath, 'r'),
            'output' => 'facturx_pdfa3',
            'validation_target' => 'en16931',
            'invoice_data' => $invoiceData,
        ],
    ]);

    return $response->toArray(false);
}

Checklist intégration

• ✓

  Stocker FACTURX_API_KEY hors du dépôt Dolibarr (vault, env serveur, conf/conf.php override)

• ✓

  Appeler FacturX API depuis un hook BILL_VALIDATE ou un cron, pas dans la transaction métier

• ✓

  Conserver le request_id retourné pour corréler avec vos logs Dolibarr (rowid facture)

• ✓

  Pour les exports incomplets, compléter via invoice_data JSON plutôt que de modifier le générateur PDF Dolibarr