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'),
        ],
    ]);

    // Compléter ce que l'export Dolibarr ne fournit pas toujours
    $invoiceData = [
        'invoice_number' => $invoice['facnumber'],
        'issue_date' => $invoice['date'],
        'currency' => $invoice['multicurrency_code'] ?: 'EUR',
        'seller' => [
            'name' => $invoice['seller_name'],
            'siren' => $invoice['seller_siren'],     // BT-30, schemeID 0002
            'vat_number' => $invoice['seller_tva'],  // BT-31
        ],
        'buyer' => [
            'name' => $invoice['buyer_name'],
            'siren' => $invoice['buyer_siren'],
        ],
    ];

    $response = $client->request('POST', 'https://api.facturxapi.com/api/v1/convert', [
        'body' => [
            'file' => fopen($pdfPath, 'r'),
            'invoice_data' => json_encode($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