Migrations — Facturation électronique Factur-X #

Migrations SQL liées à la réforme de facturation électronique obligatoire (France, 2026-2027).

Contexte réglementaire #

La réforme impose la facturation électronique B2B en France via une plateforme agréée (PDP ou PPF). Format cible : Factur-X EN16931 (PDF/A-3 + XML CII D16B embarqué — BeamReactor implémente le XML sans le PDF, qui reste facultatif).

| Échéance | Obligation |

|----------|------------|

| 1er septembre 2026 | Réception électronique obligatoire — grandes entreprises et ETI en émission |

| 1er septembre 2027 | Émission électronique obligatoire — PME et micro-entreprises |

Fichiers #

`2026_03_31_orders_facturx_fields.sql` #

Ajoute deux colonnes à la table `orders` :

| Colonne | Type | Description |

|---------|------|-------------|

| `customer_siren` | `VARCHAR(14)` | SIREN (9) ou SIRET (14) de l'acheteur |

| `customer_vat_number` | `VARCHAR(20)` | TVA intracommunautaire acheteur (ex: `FR12345678901`) |

Ces champs sont `DEFAULT NULL` — ils ne sont obligatoires que pour les entreprises françaises (voir logique SIREN dans la documentation du plugin `invoices`).

Un index est ajouté sur `customer_siren` pour les recherches de facturation.

`2026_03_31_invoices.sql` #

Crée la table `invoices` :

| Colonne | Type | Description |

|---------|------|-------------|

| `id` | `INT UNSIGNED AUTO_INCREMENT` | Clé primaire |

| `invoice_number` | `VARCHAR(30) UNIQUE` | Numéro séquentiel immutable (`FACT-YYYY-NNNNN`) |

| `order_id` | `INT(11)` | Référence `orders.id` (pas de FK — convention BeamReactor) |

| `type` | `ENUM('invoice','credit_note')` | Facture ou avoir |

| `status` | `ENUM(...)` | `draft`, `issued`, `sent`, `acknowledged`, `cancelled` |

| `issue_date` | `DATE` | Date d'émission — obligatoire EN16931 |

| `due_date` | `DATE` | Date d'échéance — obligatoire EN16931 si paiement différé |

| `subtotal_ht` | `DECIMAL(10,2)` | Snapshot HT figé à l'émission |

| `vat_amount` | `DECIMAL(10,2)` | Snapshot TVA |

| `total_ttc` | `DECIMAL(10,2)` | Snapshot TTC |

| `currency` | `VARCHAR(3)` | Devise ISO 4217 |

| `buyer_name` | `VARCHAR(255)` | Snapshot raison sociale ou nom acheteur |

| `buyer_siren` | `VARCHAR(14)` | Snapshot SIREN/SIRET acheteur |

| `buyer_vat_number` | `VARCHAR(20)` | Snapshot TVA intracommunautaire acheteur |

| `buyer_address` | `TEXT` | Snapshot adresse facturation acheteur |

| `facturx_path` | `VARCHAR(500)` | Chemin relatif vers le XML (depuis `ROOT_DIR`) |

| `facturx_profile` | `ENUM(...)` | Profil Factur-X — défaut `en16931` |

| `transmission_status` | `ENUM(...)` | `pending`, `exported`, `sent`, `acknowledged`, `rejected`, `error` |

| `transmission_platform` | `VARCHAR(50)` | `chorus_pro`, `file_export`, `pdp_xxx` |

| `transmission_reference` | `VARCHAR(255)` | Référence retournée par la plateforme |

| `transmitted_at` | `DATETIME` | Horodatage de transmission |

| `transmission_log` | `TEXT` | Réponse brute de la plateforme |

| `created_at` | `DATETIME` | Création |

| `updated_at` | `DATETIME ON UPDATE` | Dernière modification |

Profils Factur-X supportés #

| Valeur | Description |

|--------|-------------|

| `minimum` | Profil minimal (B2G simplifié) |

| `basic_wl` | Basic Without Lines |

| `basic` | Basic |

| `en16931` | Profil cible BeamReactor — conforme EN16931 |

| `extended` | Extended (données supplémentaires) |

Installation #

Exécuter dans l'ordre :

-- 1. Champs acheteur sur orders
SOURCE var/migrations/2026_03_31_orders_facturx_fields.sql;

-- 2. Table invoices
SOURCE var/migrations/2026_03_31_invoices.sql;

Ou via phpMyAdmin, dans l'ordre indiqué.

Décisions d'architecture #

Pas de FK sur `order_id` — convention BeamReactor : les tables e-commerce ne déclarent pas de contraintes de clé étrangère entre modules pour conserver l'indépendance des plugins.

Snapshot financier et acheteur — les données sont copiées au moment de l'émission de la facture et ne suivent pas les modifications ultérieures de la commande. C'est une obligation légale : une facture émise est immutable.

SIREN vendeur dans `$cfg[34]` — le SIREN/SIRET du vendeur est stocké dans les préférences système (`company_number`), pas dans la table `invoices`. La classe `FacturX` l'extrait via `$cfg[34]['company_number']` en supprimant les caractères non numériques.

Conservation légale — les fichiers XML doivent être conservés 6 ans. Le répertoire `var/invoices/` ne doit pas être soumis à des politiques de purge automatique.