Cas d’usage
Personnalisation des templates de facture (logo, couleurs, mentions)
Templates PDF par sub-tenant pour cohérence de marque
Chaque sub-tenant peut configurer son propre template de facture PDF via l'API ou le dashboard. Champs personnalisables : logo (URL d'image hébergée par Scell.io ou CDN client), couleur primaire (header), couleur secondaire (lignes alternées), police (parmi 5 polices PDF/A-3 compatibles), mentions légales en pied de page (max 500 chars), conditions de paiement (texte libre), numérotation préfixe + format (`{prefix}-{year}-{counter:5}`). Les templates sont versionnés : modifier un template ne réécrit JAMAIS les factures existantes (immuables). Pour Factur-X, le visuel PDF/A-3 reflète le template tandis que le XML CII embarqué reste conforme EN16931.
À retenir
- Logo hébergé Scell.io ou CDN externe
- Couleurs primaire / secondaire personnalisables
- 5 polices PDF/A-3 compatibles (Helvetica, Roboto, Lato, Open Sans, Inter)
- Mentions légales pied de page (max 500 chars)
- Numérotation : préfixe + format `{prefix}-{year}-{counter:5}`
- Templates versionnés : factures émises non rétroactives
Exemple de code
use Scell\Sdk\ScellClient;
$scell = new ScellClient(getenv('SCELL_SECRET_KEY'));
$template = $scell->subTenants()->updateTemplate('st_abc123', [
'logo_url' => 'https://cdn.client.com/logo.svg',
'primary_color' => '#0F766E',
'secondary_color' => '#F0FDF4',
'font' => 'Inter',
'numbering_prefix' => 'CLI',
'numbering_format' => '{prefix}-{year}-{counter:5}',
'footer_legal_notice' => 'SARL au capital de 10 000€ — RCS Paris 123 456 789 — TVA FR12345678901',
'payment_terms' => 'Paiement à 30 jours fin de mois. Pénalités de retard : 3x taux légal.',
]);