Use cases
Invoice template customisation (logo, colours, notices)
Per-sub-tenant PDF templates for brand consistency
Each sub-tenant can configure its own PDF invoice template via the API or dashboard. Customisable fields: logo (Scell.io-hosted or client-CDN image URL), primary colour (header), secondary colour (alternating rows), font (one of 5 PDF/A-3 compatible fonts), legal footer notices (max 500 chars), payment terms (free text), numbering prefix + format (`{prefix}-{year}-{counter:5}`). Templates are versioned: modifying a template NEVER rewrites existing invoices (immutable). For Factur-X, the PDF/A-3 visual reflects the template while the embedded CII XML remains EN16931-compliant.
Key facts
- Scell.io-hosted or external CDN logo
- Customisable primary / secondary colours
- 5 PDF/A-3-compatible fonts (Helvetica, Roboto, Lato, Open Sans, Inter)
- Legal footer notices (max 500 chars)
- Numbering: prefix + format `{prefix}-{year}-{counter:5}`
- Versioned templates: issued invoices are not rewritten
Code example
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.',
]);