Cas d’usage
Embarquer XML CII dans un PDF/A-3 existant
Convertir un PDF métier en Factur-X conforme EN16931
Si vous avez déjà un générateur PDF de factures (template métier, ERP custom), Scell.io peut convertir le PDF en Factur-X en attachant un XML CII D16B conforme EN 16931 dans une pièce jointe PDF/A-3. Endpoint `POST /api/v1/invoices/embed` : vous fournissez le PDF source (multipart) + les données structurées (JSON) et obtenez un PDF/A-3 hybride. Scell.io gère la conversion PDF/A-3 (couleurs, polices embarquées, métadonnées XMP), la génération du XML et l'attachement. Idéal pour migrer un legacy facturation vers la conformité 2026 sans refondre le moteur de templates.
À retenir
- Input : PDF arbitraire + données JSON structurées
- Output : PDF/A-3 hybride avec `factur-x.xml` attaché
- Conversion PDF → PDF/A-3 automatique (polices, couleurs ICC)
- Métadonnées XMP conformes Factur-X v1.0.07
- Profils supportés : MINIMUM, BASIC, EN16931, EXTENDED
- Validation Schematron EN16931 incluse
Exemple de code
use Scell\Sdk\ScellClient;
$scell = new ScellClient(getenv('SCELL_SECRET_KEY'));
$pdfStream = fopen('/var/exports/INV-2026-001.pdf', 'rb');
$facturX = $scell->invoices()->embed([
'pdf' => $pdfStream,
'data' => [
'profile' => 'EN16931',
'invoice_number' => 'INV-2026-001',
'issue_date' => '2026-05-03',
'seller' => ['siret' => '12345678901234', 'name' => 'Ma SAS'],
'buyer' => ['siret' => '98765432109876', 'name' => 'Client SARL'],
'lines' => [['description' => 'Prestation', 'quantity' => 1, 'unit_price' => 1000.00, 'vat_rate' => 20]],
],
]);
file_put_contents('/var/exports/INV-2026-001.facturx.pdf', $facturX->getBody());