SDKs officiels & Référence API

1import { ScellApiClient } from '@scell/sdk';
2
3const scell = new ScellApiClient('sk_live_your_api_key');
4
5// Create a Factur-X invoice
6const invoice = await scell.invoices.create({
7  format: 'facturx',
8  issue_date: '2026-03-30',
9  due_date: '2026-04-30',
10  currency: 'EUR',
11  seller: {
12    name: 'ACME Corp',
13    siren: '123456789',
14    vat_number: 'FR12345678901',
15    address: {
16      street: '10 Rue de la Paix',
17      city: 'Paris',
18      postal_code: '75002',
19      country: 'FR',
20    },
21  },
22  buyer: {
23    name: 'Client SA',
24    siren: '987654321',
25    vat_number: 'FR98765432100',
26    address: {
27      street: '5 Avenue des Champs',
28      city: 'Lyon',
29      postal_code: '69001',
30      country: 'FR',
31    },
32  },
33  lines: [
34    {
35      description: 'Consulting services',
36      quantity: 10,
37      unit_price: 150.00,
38      vat_rate: 20.0,
39    },
40  ],
41});
42
43console.log(invoice.id);          // UUID
44console.log(invoice.status);      // 'draft' | 'validated' | ...
45console.log(invoice.total_amount);
46
47// Submit invoice to PDP
48await scell.invoices.submit(invoice.id);
49
50// Download PDF
51const pdf = await scell.invoices.download(invoice.id, 'pdf');
52
53// Get audit trail
54const trail = await scell.invoices.auditTrail(invoice.id);

1import { ScellApiClient } from '@scell/sdk';
2
3const scell = new ScellApiClient('sk_live_your_api_key');
4
5const signature = await scell.signatures.create({
6  name: 'Service Agreement Q2 2026',
7  document: {
8    content: 'base64_encoded_pdf_content_here',
9    filename: 'agreement.pdf',
10  },
11  signers: [
12    {
13      first_name: 'Jean',
14      last_name: 'Dupont',
15      email: 'jean.dupont@example.com',
16      phone: '+33612345678',
17    },
18    {
19      first_name: 'Marie',
20      last_name: 'Martin',
21      email: 'marie.martin@example.com',
22      phone: '+33698765432',
23    },
24  ],
25  message: 'Please review and sign this agreement.',
26  ordered: true,
27  redirect_url: 'https://yourapp.com/signature/complete',
28});
29
30console.log(signature.id);
31console.log(signature.status);       // 'pending' | 'completed' | ...
32console.log(signature.signing_url);
33
34// Cancel a signature request
35await scell.signatures.cancel(signature.id);
36
37// Send a reminder
38await scell.signatures.remind(signature.id);
39
40// Download the signed document
41const signed = await scell.signatures.download(signature.id, 'signed');

1import { ScellApiClient } from '@scell/sdk';
2
3const scell = new ScellApiClient('sk_live_your_api_key');
4
5// Create a credit note linked to an invoice
6const creditNote = await scell.creditNotes.create({
7  invoice_id: 'inv_uuid_here',
8  reason: 'Partial refund for returned goods',
9  lines: [
10    {
11      description: 'Returned item refund',
12      quantity: 2,
13      unit_price: 75.00,
14      vat_rate: 20.0,
15    },
16  ],
17});
18
19console.log(creditNote.id);
20console.log(creditNote.status);
21
22// List all credit notes
23const list = await scell.creditNotes.list();
24
25// Download as PDF
26const pdf = await scell.creditNotes.download(creditNote.id);
27
28// Send to recipient
29await scell.creditNotes.send(creditNote.id);

1import { ScellClient } from '@scell/sdk';
2
3const client = new ScellClient('your_bearer_token');
4
5// Create a company
6const company = await client.companies.create({
7  name: 'ACME Corp',
8  siren: '123456789',
9  vat_number: 'FR12345678901',
10  address: {
11    street: '10 Rue de la Paix',
12    city: 'Paris',
13    postal_code: '75002',
14    country: 'FR',
15  },
16});
17
18// List all companies
19const companies = await client.companies.list();
20
21// Update a company
22await client.companies.update(company.id, { name: 'ACME Corp Updated' });
23
24// Initiate KYC/KYB verification
25await client.companies.initiateKyc(company.id);
26
27// Check KYC status
28const kyc = await client.companies.kycStatus(company.id);
29console.log(kyc.status); // 'pending' | 'approved' | 'rejected'

1import { ScellClient } from '@scell/sdk';
2
3const client = new ScellClient('your_bearer_token');
4
5// Create a new API key
6const key = await client.apiKeys.create({
7  name: 'Production Key',
8  environment: 'live', // 'live' | 'test'
9});
10
11console.log(key.id);
12console.log(key.key); // sk_live_... (shown only once)
13
14// List all API keys
15const keys = await client.apiKeys.list();
16
17// Delete an API key
18await client.apiKeys.delete(key.id);

1import { ScellClient } from '@scell/sdk';
2
3const client = new ScellClient('your_bearer_token');
4
5// Get current balance
6const balance = await client.balance.get();
7console.log(balance.credits);
8console.log(balance.currency);
9
10// Reload credits
11await client.balance.reload({
12  amount: 500,
13  payment_method: 'card',
14});
15
16// Update alert settings
17await client.balance.updateSettings({
18  low_balance_threshold: 50,
19  auto_reload: true,
20  auto_reload_amount: 200,
21});
22
23// List credit transactions
24const transactions = await client.balance.transactions();

1import { ScellClient } from '@scell/sdk';
2
3const client = new ScellClient('your_bearer_token');
4
5// Create a webhook endpoint
6const webhook = await client.webhooks.create({
7  url: 'https://yourapp.com/webhooks/scell',
8  events: [
9    'invoice.created',
10    'invoice.validated',
11    'signature.completed',
12    'balance.low',
13  ],
14  active: true,
15});
16
17console.log(webhook.id);
18console.log(webhook.secret); // wh_sec_... (for signature verification)
19
20// List all webhooks
21const list = await client.webhooks.list();
22
23// Update a webhook
24await client.webhooks.update(webhook.id, {
25  events: ['invoice.created', 'signature.completed'],
26});
27
28// Test a webhook (sends a test payload)
29await client.webhooks.test(webhook.id);
30
31// Regenerate the signing secret
32const newSecret = await client.webhooks.regenerateSecret(webhook.id);
33
34// View delivery logs
35const logs = await client.webhooks.logs(webhook.id);
36
37// Delete a webhook
38await client.webhooks.delete(webhook.id);

1import { ScellApiClient } from '@scell/sdk';
2
3const scell = new ScellApiClient('sk_live_your_api_key');
4
5// ─── Compliance overview ───────────────────────────────
6const status = await scell.fiscal.compliance();
7console.log(status.is_compliant);   // true | false
8console.log(status.nf525_status);
9
10// ─── Immutable ledger entries ──────────────────────────
11const entries = await scell.fiscal.entries();
12
13// ─── Closings ──────────────────────────────────────────
14const closings = await scell.fiscal.closings();
15await scell.fiscal.dailyClosing(); // Trigger a daily closing
16
17// ─── Integrity verification ───────────────────────────
18const integrity = await scell.fiscal.integrity();
19const history = await scell.fiscal.integrityHistory();
20const forDate = await scell.fiscal.integrityForDate('2026-03-30');
21
22// ─── Fiscal rules engine ──────────────────────────────
23const rules = await scell.fiscal.rules();
24const newRule = await scell.fiscal.createRule({
25  key: 'auto_daily_closing',
26  value: true,
27  description: 'Automatically trigger daily closings at midnight',
28});
29await scell.fiscal.updateRule(newRule.id, { value: false });
30const detail = await scell.fiscal.ruleDetail('auto_daily_closing');
31const ruleHist = await scell.fiscal.ruleHistory('auto_daily_closing');
32await scell.fiscal.exportRules();
33await scell.fiscal.replayRules();
34
35// ─── TSA Anchors ──────────────────────────────────────
36const anchors = await scell.fiscal.anchors();
37
38// ─── Kill switch ──────────────────────────────────────
39const ksStatus = await scell.fiscal.killSwitchStatus();
40await scell.fiscal.activateKillSwitch();
41await scell.fiscal.deactivateKillSwitch();
42
43// ─── Exports ──────────────────────────────────────────
44const fec = await scell.fiscal.fecExport();
45const forensic = await scell.fiscal.forensicExport();
46const attestation = await scell.fiscal.attestation(2026);
47const download = await scell.fiscal.attestationDownload(2026);

1import { ScellApiClient } from '@scell/sdk';
2
3const scell = new ScellApiClient('sk_live_your_api_key');
4
5// Get overview statistics
6const overview = await scell.stats.overview();
7console.log(overview.total_invoices);
8console.log(overview.total_signatures);
9console.log(overview.total_revenue);
10
11// Get monthly breakdown
12const monthly = await scell.stats.monthly();
13monthly.forEach(m => {
14  console.log(m.month, m.invoices_count, m.revenue);
15});

1import { ScellApiClient } from '@scell/sdk';
2
3const scell = new ScellApiClient('sk_live_your_api_key');
4
5// List billing invoices
6const invoices = await scell.billing.invoices();
7
8// Get a specific billing invoice
9const inv = await scell.billing.showInvoice('billing_inv_id');
10
11// Download billing invoice PDF
12const pdf = await scell.billing.downloadInvoice('billing_inv_id');
13
14// Get current usage metrics
15const usage = await scell.billing.usage();
16console.log(usage.invoices_used);
17console.log(usage.signatures_used);
18console.log(usage.credits_remaining);
19
20// Top up credits
21await scell.billing.topUp({ amount: 100, payment_method: 'card' });
22
23// Confirm a pending top-up
24await scell.billing.confirmTopUp({ top_up_id: 'tu_id', confirmation_code: '1234' });
25
26// List billing transactions
27const transactions = await scell.billing.transactions();

1import { ScellApiClient } from '@scell/sdk';
2
3const scell = new ScellApiClient('sk_live_your_api_key');
4
5// Create a sub-tenant
6const tenant = await scell.subTenants.create({
7  name: 'Partner Corp',
8  external_id: 'partner-001',
9  email: 'admin@partner-corp.com',
10  company: {
11    name: 'Partner Corp',
12    siren: '111222333',
13    address: {
14      street: '20 Boulevard Haussmann',
15      city: 'Paris',
16      postal_code: '75009',
17      country: 'FR',
18    },
19  },
20});
21
22console.log(tenant.id);
23console.log(tenant.tenant_key); // tk_live_...
24
25// List all sub-tenants
26const list = await scell.subTenants.list();
27
28// Get a specific sub-tenant
29const detail = await scell.subTenants.get(tenant.id);
30
31// Find by external ID
32const found = await scell.subTenants.findByExternalId('partner-001');
33
34// Update a sub-tenant
35await scell.subTenants.update(tenant.id, { name: 'Partner Corp (Updated)' });
36
37// Get sub-tenant stats
38const stats = await scell.subTenants.statsOverview(tenant.id);
39
40// Delete a sub-tenant
41await scell.subTenants.delete(tenant.id);

1import { ScellApiClient } from '@scell/sdk';
2
3const scell = new ScellApiClient('sk_live_your_api_key');
4
5try {
6  const invoice = await scell.invoices.create({ /* ... */ });
7} catch (error) {
8  if (error.status === 422) {
9    // Validation error — check error.errors for field-level details
10    console.error('Validation:', error.errors);
11    // { "seller.siren": ["The siren must be 9 digits."] }
12  } else if (error.status === 401) {
13    // Invalid or expired API key
14    console.error('Authentication failed');
15  } else if (error.status === 402) {
16    // Insufficient credits
17    console.error('Insufficient balance — top up credits');
18  } else if (error.status === 404) {
19    // Resource not found
20    console.error('Resource not found');
21  } else if (error.status === 429) {
22    // Rate limited — retry after error.retryAfter seconds
23    console.error('Rate limited, retry after', error.retryAfter, 'seconds');
24  } else if (error.status >= 500) {
25    // Server error — retry with exponential backoff
26    console.error('Server error, retrying...');
27  }
28}