Invoices #

Facturation électronique Factur-X EN16931.

Namespace: Beamreactor\Invoices

Version: 1.0.0

Niveau requis: ORDERS_LEVEL_ADMIN

Vue d'ensemble #

Plugin de génération et de gestion des factures électroniques pour BeamReactor. Conforme au profil Factur-X EN16931 (urn:cen.eu:en16931:2017#compliant#urn:factur-x.eu:1p0:en16931), il génère des fichiers XML CII D16B directement transmissibles à Chorus Pro ou à toute PDP certifiée.

Répond à la réforme française de facturation électronique obligatoire :

• 1er septembre 2026 — obligation de réception pour toutes les entreprises
• 1er septembre 2027 — obligation d'émission pour PME et micro-entreprises

Fonctionnalités #

• Génération de factures et avoirs depuis les commandes (orders)
• XML EN16931 (CII D16B) généré nativement — zéro dépendance externe
• Numérotation séquentielle immutable (FACT-YYYY-NNNNN)
• Snapshot financier et acheteur figé à l'émission
• Vue HTML imprimable avec badges de statut
• Téléchargement XML direct
• Traçabilité de la chaîne de transmission
• Placeholder Chorus Pro (OAuth2 PISTE — implémentation à venir)

Actions (paramètre invact) #

| Valeur | Méthode | Action |

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

| (défaut) | GET | Liste des factures avec filtres par statut |

| generate | GET | Formulaire de confirmation (paramètre order_id requis) |

| generate | POST | Génération effective (champ order_id requis) |

| view | GET | Détail HTML imprimable (paramètre id requis) |

| download | GET | Téléchargement XML Factur-X (paramètre id requis) |

| transmit | GET | Transmission Chorus Pro — placeholder (paramètre id requis) |

Classe FacturX #

Générateur XML EN16931 basé sur DOMDocument natif PHP.

use Beamreactor\Invoices\FacturX;

$xml = FacturX::generate($invoice, $seller, $items);

Paramètres #

$invoice — ligne de la table invoices :

| Clé | Type | Description |

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

| invoice_number | string | Numéro de facture (FACT-YYYY-NNNNN) |

| type | string | invoice ou credit_note |

| issue_date | string | Date d'émission (YYYY-MM-DD) |

| due_date | string\|null | Date d'échéance (YYYY-MM-DD) |

| currency | string | Devise ISO 4217 (défaut EUR) |

| subtotal_ht | decimal | Sous-total HT |

| vat_amount | decimal | Montant TVA |

| total_ttc | decimal | Total TTC |

| buyer_name | string | Raison sociale ou nom complet acheteur |

| buyer_siren | string\|null | SIREN/SIRET acheteur (9 ou 14 chiffres) |

| buyer_vat_number | string\|null | TVA intracommunautaire acheteur |

| buyer_address | string\|null | Adresse complète acheteur (snapshot) |

$seller — tableau issu de array_merge($cfg[34], $cfg[35]) :

| Clé $cfg[34] | Description |

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

| headoffice_name | Raison sociale vendeur |

| company_number | SIRET (ex: SIRET 993 471 077 00012) — chiffres extraits automatiquement |

| headoffice_address | Adresse ligne 1 |

| headoffice_postcode | Code postal |

| headoffice_city | Ville |

| headoffice_country | Pays (nom complet — converti en ISO 3166-1 alpha-2) |

| headoffice_vat_number | TVA vendeur (optionnel — calculée depuis SIREN si absente) |

| Clé $cfg[35] | Description |

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

| headoffice_iban | IBAN vendeur (inclus dans le XML si renseigné) |

| headoffice_bic | BIC vendeur |

$items — lignes de order_items :

| Clé | Type | Description |

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

| product_name | string | Désignation produit |

| product_reference | string | Référence produit (optionnel) |

| quantity | int | Quantité |

| unit_price_ht | decimal | Prix unitaire HT |

| vat_rate | decimal | Taux TVA (ex: 20.00) |

Calcul automatique du numéro TVA vendeur #

Si headoffice_vat_number est absent de $cfg[34], la classe calcule le numéro de TVA intracommunautaire français depuis le SIREN :

clé = (12 + 3 × (SIREN mod 97)) mod 97
N° TVA = "FR" + clé (2 chiffres) + SIREN (9 chiffres)

Codes TypeCode EN16931 #

| Constante | Valeur | Usage |

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

| TYPE_INVOICE | 380 | Facture |

| TYPE_CREDIT_NOTE | 381 | Avoir |

Catégories TVA (schéma EN16931) #

| Constante | Code | Condition |

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

| VAT_S | S | Taux > 0 (standard) |

| VAT_Z | Z | Taux = 0 |

| VAT_E | E | Exonéré |

| VAT_AE | AE | Autoliquidation |

Numérotation des factures #

Format : FACT-{ANNÉE}-{ID sur 5 chiffres}

Exemple : FACT-2026-00001

La numérotation s'appuie sur l'AUTO_INCREMENT de la table invoices — le numéro est généré après insertion et mis à jour immédiatement. Il est immutable : aucune mise à jour après émission ne doit le modifier.

Stockage des fichiers XML #

Les fichiers XML Factur-X sont écrits dans :

ROOT_DIR/var/invoices/{invoice_number}.xml

Le chemin relatif est conservé dans invoices.facturx_path (depuis ROOT_DIR).

Le répertoire var/invoices/ doit être accessible en écriture. Il est exclu des caches BeamReactor.

Logique SIREN acheteur #

| customer_type | Pays | Comportement |

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

| individual | Tous | SIREN NULL — pas de validation |

| company | France | SIREN obligatoire — validé via Parser::sanitize($v, 'siren') |

| company | UE ≠ France | TVA intracommunautaire obligatoire, SIREN NULL |

| company | Hors UE | Les deux NULL — accepté |

Le champ SIREN ne s'affiche dans le formulaire de commande que si customer_type = company et pays = France.

Chaîne de transmission #

| transmission_platform | Description |

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

| file_export | Téléchargement direct — client dépose sur sa PDP |

| chorus_pro | Transmission Chorus Pro via API PISTE (OAuth2) — à implémenter |

| pdp_xxx | PDP privée certifiée — modules optionnels futurs |

Tables concernées #

| Table | Rôle |

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

| invoices | Factures et avoirs — une commande peut en avoir plusieurs |

| orders | Source des données financières et acheteur |

| order_items | Lignes de commande — snapshottées dans le XML |

Dépendances #

• Beamreactor\Database\SQL — accès base de données
• Beamreactor\Sanitizer\Parser — validation SIREN et chaînes
• DOMDocument — génération XML (natif PHP, aucune lib externe)
• $cfg[34] — infos vendeur (siège, SIRET, adresse)
• $cfg[35] — coordonnées bancaires vendeur (IBAN, BIC)

Voir aussi #

• Migrations Factur-X
• var/migrations/2026_03_31_orders_facturx_fields.sql
• var/migrations/2026_03_31_invoices.sql