Boutique — Documents & factures — documentation Sillon

Ce qu'il fait

Génère un document imprimable (facture / devis / bon de livraison / avoir) pour n'importe quelle commande de la Boutique — HTML autonome fond blanc, format A4 strict, aucune lib PDF. UNE facture par commande (contrainte base), émission AUTOMATIQUE au passage payé (webhook ET pointage manuel), 3 modèles de mise en page (Classique/Épuré/Moderne, extensible par filtre), adresse de facturation + logo propres au module, écran Documents orienté compta (filtre période, export CSV/JSON filtré). Non certifié (facturation électronique / anti-fraude) — disclaimer dans l'écran admin. Couplage souple avec shop-commercial (devis, échéancier) : aucune dépendance dure dans un sens ni dans l'autre.

UNE facture par commande, émise AUTOMATIQUEMENT au passage payé (webhook et pointage manuel)
Document HTML imprimable A4 strict (fond blanc, @media print), zéro lib PDF
3 modèles de mise en page (Classique / Épuré / Moderne), extensibles par un développeur
Bon de livraison sans prix, pensé pour être imprimé et joint au colis
Numérotation séquentielle sans trou, snapshot immuable (jamais réécrit après émission)
Écran Documents orienté compta : filtre par période, total TTC, export CSV/JSON et « Tout imprimer » en un clic
Avoir émis automatiquement à chaque remboursement : montant remboursé, TVA reprise sur les mêmes taux que la vente, numéro de la facture d'origine (plusieurs avoirs possibles par commande)
Adresse de facturation + logo propres au module, couplage souple avec shop-commercial (devis, échéancier)

Ses réglages

Ils se modifient depuis l'administration. La clé est donnée pour qui pilote le site en ligne de commande ou par l'API.

Réglage	Clé	Type	Par défaut
Titre du document (Facture, Pro forma, ou libellé libre)	`shop_documents.title`	string	`Facture`
Préfixe de numérotation	`shop_documents.prefix`	string	`FAC`
Mentions complémentaires en pied de document	`shop_documents.mentions`	string	`(vide)`
Raison sociale (adresse de facturation, propre à ce module)	`shop_documents.company_name`	string	`(vide)`
Adresse complète de facturation	`shop_documents.company_address`	string	`(vide)`
Téléphone de facturation	`shop_documents.company_phone`	string	`(vide)`
Email de facturation	`shop_documents.company_email`	string	`(vide)`
Logo affiché en en-tête du document	`shop_documents.logo`	string	`(vide)`
Modèle de document (Classique / Épuré / Moderne)	`shop_documents.template`	select	`classique`
Couleur d'accent (éléments décoratifs uniquement, le texte reste noir)	`shop_documents.accent_color`	string	`#34455E`

Ce qu'il suppose

Ce module a besoin de :

shop ^1.35

Piloter par une IA

Ce que ce module sait faire quand on le lui demande en langage naturel, et ce que chaque action engage.

documents lecture seule

Les documents émis pour une commande (lecture seule) : facture, devis, bon de livraison ou avoir, avec son type, son numéro, sa date d'émission, son total figé et le lien d'admin qui l'ouvre. Ne nomme aucun client. Émettre un document reste un geste d'écran : il consomme un numéro de la séquence comptable.

« la facture de la commande 42 est-elle émise ? » « quel est le numéro du bon de livraison de cette commande ? »

Ses points de branchement

Pour greffer du code sans toucher au module : ce qu'il annonce, et ce qu'il écoute.

Ce qu'il annonce 3

shop.documents.liens_publics: Filter bool — false = pas de liens publics facture/devis sur cette commande. Args: [bool $visible, array $order].
0: shop.documents.snapshot
1: shop.documents.delivery_snapshot

Ce qu'il écoute 7

shop.order.refunded: priorité 20
shop.compta.vente: priorité 20
shop.order.documents.actions: priorité 30
shop.order.fiche.action: priorité 25
shop.hub.tiles: priorité 20
shop.order.public.actions: priorité 20
paiement.recu: priorité 20

Ses données

Les tables que ce module crée. Désactiver un module ne les efface pas : ses données restent en base et reviennent s'il est réactivé.

Les tables 2

shop_documents
shop_documents_counters