@scell/sdk 1.2.0 → 1.5.0

package/dist/index.d.mts

@@ -54,7 +54,7 @@ declare function createRetryWrapper(defaultOptions?: RetryOptions): <T>(fn: () =
 /**
  * Authentication mode
  */
-type AuthMode = 'bearer' | 'api-key';
+type AuthMode = 'bearer' | 'api-key' | 'tenant-key';
 /**
  * Client configuration options
  */
@@ -243,6 +243,2313 @@ interface ApiErrorResponse {
     code?: string | undefined;
 }
 
+/**
+ * Invoice direction
+ */
+type InvoiceDirection = 'outgoing' | 'incoming';
+/**
+ * Invoice output format
+ */
+type InvoiceFormat = 'facturx' | 'ubl' | 'cii';
+/**
+ * Invoice status
+ */
+type InvoiceStatus = 'draft' | 'pending' | 'validated' | 'converted' | 'transmitted' | 'accepted' | 'rejected' | 'paid' | 'disputed' | 'cancelled' | 'error';
+/**
+ * Invoice download file type
+ */
+type InvoiceDownloadType = 'original' | 'converted' | 'pdf';
+/**
+ * Invoice line item
+ */
+interface InvoiceLine {
+    line_number: number;
+    description: string;
+    quantity: number;
+    unit_price: number;
+    tax_rate: number;
+    total_ht: number;
+    total_tax: number;
+    total_ttc: number;
+}
+/**
+ * Invoice party (seller or buyer)
+ */
+interface InvoiceParty {
+    siret: Siret;
+    name: string;
+    address: Address;
+}
+/**
+ * Invoice entity
+ */
+interface Invoice {
+    id: UUID;
+    external_id: string | null;
+    invoice_number: string;
+    direction: InvoiceDirection;
+    output_format: InvoiceFormat;
+    issue_date: DateString;
+    due_date: DateString | null;
+    currency: CurrencyCode;
+    total_ht: number;
+    total_tax: number;
+    total_ttc: number;
+    seller: InvoiceParty;
+    buyer: InvoiceParty;
+    lines: InvoiceLine[] | null;
+    status: InvoiceStatus;
+    status_message: string | null;
+    environment: Environment;
+    archive_enabled: boolean;
+    amount_charged: number | null;
+    created_at: DateTimeString;
+    validated_at: DateTimeString | null;
+    transmitted_at: DateTimeString | null;
+    completed_at: DateTimeString | null;
+    /** Date when the invoice was marked as paid (ISO 8601) */
+    paid_at: DateTimeString | null;
+    /** Payment reference (bank transfer ID, check number, etc.) */
+    payment_reference: string | null;
+    /** Optional note about the payment */
+    payment_note: string | null;
+}
+/**
+ * Invoice line input for creation
+ */
+interface InvoiceLineInput {
+    description: string;
+    quantity: number;
+    unit_price: number;
+    tax_rate: number;
+    total_ht: number;
+    total_tax: number;
+    total_ttc: number;
+}
+/**
+ * Invoice creation input
+ */
+interface CreateInvoiceInput {
+    /** Your external reference ID */
+    external_id?: string | undefined;
+    /** Invoice number (required) */
+    invoice_number: string;
+    /** Direction: outgoing (sale) or incoming (purchase) */
+    direction: InvoiceDirection;
+    /** Output format for electronic invoice */
+    output_format: InvoiceFormat;
+    /** Issue date (YYYY-MM-DD) */
+    issue_date: DateString;
+    /** Due date (YYYY-MM-DD) */
+    due_date?: DateString | undefined;
+    /** Currency code (default: EUR) */
+    currency?: CurrencyCode | undefined;
+    /** Total excluding tax */
+    total_ht: number;
+    /** Total tax amount */
+    total_tax: number;
+    /** Total including tax */
+    total_ttc: number;
+    /** Seller SIRET (14 digits) */
+    seller_siret: Siret;
+    /** Seller company name */
+    seller_name: string;
+    /** Seller address */
+    seller_address: Address;
+    /** Buyer SIRET (14 digits) */
+    buyer_siret: Siret;
+    /** Buyer company name */
+    buyer_name: string;
+    /** Buyer address */
+    buyer_address: Address;
+    /** Invoice line items */
+    lines: InvoiceLineInput[];
+    /** Enable 10-year archiving */
+    archive_enabled?: boolean | undefined;
+}
+/**
+ * Invoice list filter options
+ */
+interface InvoiceListOptions {
+    company_id?: UUID | undefined;
+    direction?: InvoiceDirection | undefined;
+    status?: InvoiceStatus | undefined;
+    environment?: Environment | undefined;
+    from?: DateString | undefined;
+    to?: DateString | undefined;
+    per_page?: number | undefined;
+}
+/**
+ * Invoice conversion input
+ */
+interface ConvertInvoiceInput {
+    invoice_id: UUID;
+    target_format: InvoiceFormat;
+}
+/**
+ * Invoice download response
+ */
+interface InvoiceDownloadResponse {
+    url: string;
+    expires_at: DateTimeString;
+}
+/**
+ * Audit trail entry
+ */
+interface AuditTrailEntry {
+    action: string;
+    details: string;
+    actor_ip: string | null;
+    created_at: DateTimeString;
+}
+/**
+ * Audit trail response
+ */
+interface AuditTrailResponse {
+    data: AuditTrailEntry[];
+    integrity_valid: boolean;
+}
+/**
+ * Incoming invoice list filter options
+ */
+interface IncomingInvoiceParams {
+    status?: InvoiceStatus | undefined;
+    seller_siret?: Siret | undefined;
+    from?: DateString | undefined;
+    to?: DateString | undefined;
+    min_amount?: number | undefined;
+    max_amount?: number | undefined;
+    page?: number | undefined;
+    per_page?: number | undefined;
+}
+/**
+ * Rejection reason code for incoming invoices
+ */
+type RejectionCode = 'incorrect_amount' | 'duplicate' | 'unknown_order' | 'incorrect_vat' | 'other';
+/**
+ * Dispute type for incoming invoices
+ */
+type DisputeType = 'amount_dispute' | 'quality_dispute' | 'delivery_dispute' | 'other';
+/**
+ * Input for accepting an incoming invoice
+ */
+interface AcceptInvoiceInput {
+    /** Expected payment date (YYYY-MM-DD) */
+    payment_date?: DateString | undefined;
+    /** Optional note about the acceptance */
+    note?: string | undefined;
+}
+/**
+ * Input for rejecting an incoming invoice
+ */
+interface RejectInvoiceInput {
+    /** Reason for rejection */
+    reason: string;
+    /** Standardized rejection code */
+    reason_code: RejectionCode;
+}
+/**
+ * Input for disputing an incoming invoice
+ */
+interface DisputeInvoiceInput {
+    /** Reason for the dispute */
+    reason: string;
+    /** Type of dispute */
+    dispute_type: DisputeType;
+    /** Expected correct amount (if amount dispute) */
+    expected_amount?: number | undefined;
+}
+/**
+ * Input for marking an incoming invoice as paid
+ */
+interface MarkPaidInput {
+    /** Payment reference (bank transfer ID, check number, etc.) */
+    payment_reference?: string | undefined;
+    /** Payment date (ISO 8601) - defaults to current date/time if not provided */
+    paid_at?: DateTimeString | undefined;
+    /** Optional note about the payment */
+    note?: string | undefined;
+}
+/**
+ * Invoice file download format
+ */
+type InvoiceFileFormat = 'pdf' | 'xml';
+
+/**
+ * Tenant Invoices types
+ *
+ * Types for multi-tenant invoice operations including direct invoices,
+ * incoming invoices, and credit notes.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Invoice direction for tenant operations
+ */
+type TenantInvoiceDirection = 'outgoing' | 'incoming';
+/**
+ * Buyer information for direct invoice creation
+ */
+interface TenantInvoiceBuyer {
+    /** Buyer company name */
+    company_name: string;
+    /** SIREN number (9 digits) - optional */
+    siren?: Siren | undefined;
+    /** SIRET number (14 digits) - optional */
+    siret?: Siret | undefined;
+    /** VAT number - optional */
+    vat_number?: string | undefined;
+    /** Buyer address */
+    address: Address;
+    /** Buyer email for notifications */
+    email: string;
+}
+/**
+ * Seller information for incoming invoice creation
+ */
+interface TenantInvoiceSeller {
+    /** Seller company name */
+    company_name: string;
+    /** SIREN number (9 digits) - required, validated with Luhn algorithm */
+    siren: Siren;
+    /** SIRET number (14 digits) - optional */
+    siret?: Siret | undefined;
+    /** VAT number - optional */
+    vat_number?: string | undefined;
+    /** Seller address */
+    address: Address;
+    /** Seller email */
+    email: string;
+}
+/**
+ * Input for creating a tenant direct invoice
+ *
+ * Direct invoices are outgoing invoices created by a tenant
+ * that are billed directly to an external buyer (not a sub-tenant).
+ *
+ * @example
+ * ```typescript
+ * const params: CreateTenantDirectInvoiceParams = {
+ *   company_id: 'company-uuid',
+ *   buyer: {
+ *     company_name: 'Client SARL',
+ *     siret: '12345678901234',
+ *     address: {
+ *       line1: '123 Rue Example',
+ *       postal_code: '75001',
+ *       city: 'Paris',
+ *       country: 'FR'
+ *     },
+ *     email: 'contact@client.com'
+ *   },
+ *   lines: [{
+ *     description: 'Consulting services',
+ *     quantity: 10,
+ *     unit_price: 100,
+ *     tax_rate: 20,
+ *     total_ht: 1000,
+ *     total_tax: 200,
+ *     total_ttc: 1200
+ *   }],
+ *   issue_date: '2026-01-26'
+ * };
+ * ```
+ */
+interface CreateTenantDirectInvoiceParams {
+    /** Company UUID issuing the invoice */
+    company_id: UUID;
+    /** Buyer information */
+    buyer: TenantInvoiceBuyer;
+    /** Invoice line items */
+    lines: InvoiceLineInput[];
+    /** Issue date (YYYY-MM-DD) - defaults to today */
+    issue_date?: DateString | undefined;
+    /** Due date (YYYY-MM-DD) */
+    due_date?: DateString | undefined;
+    /** Currency code (ISO 4217) - defaults to EUR */
+    currency?: CurrencyCode | undefined;
+    /** Notes or comments on the invoice */
+    notes?: string | undefined;
+    /** Custom metadata */
+    metadata?: Record<string, unknown> | undefined;
+    /** Output format for the invoice */
+    output_format?: InvoiceFormat | undefined;
+    /** External reference ID */
+    external_id?: string | undefined;
+}
+/**
+ * Input for creating a tenant direct credit note
+ *
+ * Direct credit notes are linked to direct invoices and allow
+ * partial or total refunds.
+ *
+ * @example
+ * ```typescript
+ * const params: CreateTenantDirectCreditNoteParams = {
+ *   invoice_id: 'invoice-uuid',
+ *   reason: 'Product returned - damaged item',
+ *   type: 'partial',
+ *   items: [{ invoice_line_id: 'line-uuid', quantity: 2 }]
+ * };
+ * ```
+ */
+interface CreateTenantDirectCreditNoteParams {
+    /** Invoice UUID to credit */
+    invoice_id: UUID;
+    /** Reason for the credit note */
+    reason: string;
+    /** Type: 'partial' or 'total' */
+    type: 'partial' | 'total';
+    /** Items to credit (required for partial credit notes) */
+    items?: TenantCreditNoteItemInput$1[] | undefined;
+    /** Custom metadata */
+    metadata?: Record<string, unknown> | undefined;
+}
+/**
+ * Credit note item input
+ */
+interface TenantCreditNoteItemInput$1 {
+    /** Invoice line ID to credit */
+    invoice_line_id: UUID;
+    /** Quantity to credit (defaults to full line quantity) */
+    quantity?: number | undefined;
+}
+/**
+ * Input for creating an incoming invoice for a sub-tenant
+ *
+ * Incoming invoices represent invoices received by a sub-tenant
+ * from an external supplier.
+ *
+ * @example
+ * ```typescript
+ * const params: CreateIncomingInvoiceParams = {
+ *   invoice_number: 'SUPP-2026-001',
+ *   company_id: 'company-uuid',
+ *   seller: {
+ *     company_name: 'Supplier Corp',
+ *     siren: '123456789',
+ *     address: {
+ *       line1: '456 Avenue Fournisseur',
+ *       postal_code: '69001',
+ *       city: 'Lyon',
+ *       country: 'FR'
+ *     },
+ *     email: 'invoices@supplier.com'
+ *   },
+ *   lines: [{
+ *     description: 'Raw materials',
+ *     quantity: 100,
+ *     unit_price: 5,
+ *     tax_rate: 20,
+ *     total_ht: 500,
+ *     total_tax: 100,
+ *     total_ttc: 600
+ *   }],
+ *   issue_date: '2026-01-20',
+ *   total_ht: 500,
+ *   total_ttc: 600
+ * };
+ * ```
+ */
+interface CreateIncomingInvoiceParams {
+    /** Supplier's invoice number */
+    invoice_number: string;
+    /** Company UUID receiving the invoice */
+    company_id: UUID;
+    /** Seller (supplier) information */
+    seller: TenantInvoiceSeller;
+    /** Invoice line items */
+    lines: InvoiceLineInput[];
+    /** Issue date (YYYY-MM-DD) */
+    issue_date: DateString;
+    /** Due date (YYYY-MM-DD) */
+    due_date?: DateString | undefined;
+    /** Total excluding tax */
+    total_ht: number;
+    /** Total including tax */
+    total_ttc: number;
+    /** Currency code (ISO 4217) - defaults to EUR */
+    currency?: CurrencyCode | undefined;
+    /** External reference ID */
+    external_id?: string | undefined;
+}
+/**
+ * Input for updating a tenant invoice
+ *
+ * Only invoices in 'draft' status can be updated.
+ */
+interface UpdateTenantInvoiceParams {
+    /** Updated buyer information */
+    buyer?: Partial<TenantInvoiceBuyer> | undefined;
+    /** Updated line items (replaces all existing lines) */
+    lines?: InvoiceLineInput[] | undefined;
+    /** Updated due date */
+    due_date?: DateString | undefined;
+    /** Updated notes */
+    notes?: string | undefined;
+    /** Updated metadata */
+    metadata?: Record<string, unknown> | undefined;
+}
+/**
+ * Input for updating a tenant credit note
+ *
+ * Only credit notes in 'draft' status can be updated.
+ */
+interface UpdateTenantCreditNoteParams {
+    /** Updated reason */
+    reason?: string | undefined;
+    /** Updated items (for partial credit notes) */
+    items?: TenantCreditNoteItemInput$1[] | undefined;
+    /** Updated metadata */
+    metadata?: Record<string, unknown> | undefined;
+}
+/**
+ * Filter options for tenant invoice listing
+ *
+ * @example
+ * ```typescript
+ * const filters: TenantInvoiceFilters = {
+ *   status: 'validated',
+ *   direction: 'outgoing',
+ *   date_from: '2026-01-01',
+ *   date_to: '2026-01-31',
+ *   per_page: 50
+ * };
+ * ```
+ */
+interface TenantInvoiceFilters extends PaginationOptions {
+    /** Search in invoice number, buyer/seller name */
+    search?: string | undefined;
+    /** Filter by status (single or multiple) */
+    status?: InvoiceStatus | InvoiceStatus[] | undefined;
+    /** Filter by direction */
+    direction?: TenantInvoiceDirection | undefined;
+    /** Filter invoices from this date (YYYY-MM-DD) */
+    date_from?: DateString | undefined;
+    /** Filter invoices to this date (YYYY-MM-DD) */
+    date_to?: DateString | undefined;
+    /** Filter by buyer SIRET */
+    buyer_siret?: Siret | undefined;
+    /** Filter by seller SIRET */
+    seller_siret?: Siret | undefined;
+    /** Minimum total amount (TTC) */
+    min_amount?: number | undefined;
+    /** Maximum total amount (TTC) */
+    max_amount?: number | undefined;
+    /** Sort field */
+    sort?: string | undefined;
+    /** Sort order */
+    order?: 'asc' | 'desc' | undefined;
+}
+/**
+ * Filter options for tenant credit note listing
+ */
+interface TenantCreditNoteFilters extends PaginationOptions {
+    /** Filter by status */
+    status?: 'draft' | 'sent' | 'cancelled' | undefined;
+    /** Filter credit notes from this date (YYYY-MM-DD) */
+    date_from?: DateString | undefined;
+    /** Filter credit notes to this date (YYYY-MM-DD) */
+    date_to?: DateString | undefined;
+    /** Sort field */
+    sort?: string | undefined;
+    /** Sort order */
+    order?: 'asc' | 'desc' | undefined;
+}
+/**
+ * Tenant Invoice entity
+ *
+ * Extended invoice entity with tenant-specific fields.
+ */
+interface TenantInvoice {
+    id: UUID;
+    external_id: string | null;
+    invoice_number: string;
+    direction: TenantInvoiceDirection;
+    output_format: InvoiceFormat;
+    issue_date: DateString;
+    due_date: DateString | null;
+    currency: CurrencyCode;
+    total_ht: number;
+    total_tax: number;
+    total_ttc: number;
+    seller: {
+        siret: Siret | null;
+        siren: Siren | null;
+        name: string;
+        address: Address;
+        email?: string | undefined;
+    };
+    buyer: {
+        siret: Siret | null;
+        siren: Siren | null;
+        name: string;
+        address: Address;
+        email?: string | undefined;
+    };
+    lines: InvoiceLine[] | null;
+    status: InvoiceStatus;
+    status_message: string | null;
+    notes: string | null;
+    metadata: Record<string, unknown> | null;
+    tenant_id: UUID;
+    sub_tenant_id: UUID | null;
+    company_id: UUID;
+    created_at: DateTimeString;
+    updated_at: DateTimeString;
+    validated_at: DateTimeString | null;
+    paid_at: DateTimeString | null;
+    payment_reference: string | null;
+}
+/**
+ * Tenant Credit Note entity
+ */
+interface TenantCreditNote$1 {
+    id: UUID;
+    credit_note_number: string;
+    invoice_id: UUID;
+    tenant_id: UUID;
+    sub_tenant_id: UUID | null;
+    status: 'draft' | 'sent' | 'cancelled';
+    type: 'partial' | 'total';
+    reason: string;
+    subtotal: number;
+    tax_amount: number;
+    total: number;
+    currency: CurrencyCode;
+    buyer_name: string | null;
+    buyer_siret: Siret | null;
+    seller_name: string | null;
+    seller_siret: Siret | null;
+    issue_date: DateString;
+    metadata: Record<string, unknown> | null;
+    created_at: DateTimeString;
+    updated_at: DateTimeString;
+    items: TenantCreditNoteItem$1[] | null;
+}
+/**
+ * Tenant Credit Note Item
+ */
+interface TenantCreditNoteItem$1 {
+    id: UUID;
+    invoice_line_id: UUID | null;
+    description: string;
+    quantity: number;
+    unit_price: number;
+    tax_rate: number;
+    total: number;
+}
+
+/**
+ * Tenant Direct Invoices Resource
+ *
+ * Manage direct invoices issued by a tenant to external buyers.
+ * Direct invoices are outgoing invoices that are not part of
+ * sub-tenant billing but billed directly to third-party clients.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Tenant Direct Invoices API resource
+ *
+ * Provides operations for managing direct invoices created by tenants
+ * for external buyers (not sub-tenants).
+ *
+ * @example
+ * ```typescript
+ * import { ScellTenantClient } from '@scell/sdk';
+ *
+ * const client = new ScellTenantClient('your-tenant-key');
+ *
+ * // Create a direct invoice
+ * const { data: invoice } = await client.directInvoices.create({
+ *   company_id: 'company-uuid',
+ *   buyer: {
+ *     company_name: 'Client Corp',
+ *     siret: '12345678901234',
+ *     address: {
+ *       line1: '123 Rue Client',
+ *       postal_code: '75001',
+ *       city: 'Paris',
+ *       country: 'FR'
+ *     },
+ *     email: 'billing@client.com'
+ *   },
+ *   lines: [{
+ *     description: 'Consulting services',
+ *     quantity: 10,
+ *     unit_price: 150,
+ *     tax_rate: 20,
+ *     total_ht: 1500,
+ *     total_tax: 300,
+ *     total_ttc: 1800
+ *   }]
+ * });
+ *
+ * // List all direct invoices
+ * const { data: invoices, meta } = await client.directInvoices.list({
+ *   status: 'validated',
+ *   per_page: 50
+ * });
+ * ```
+ */
+declare class TenantDirectInvoicesResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Create a new direct invoice
+     *
+     * Creates an outgoing invoice from the tenant to an external buyer.
+     * The invoice will be generated in the specified format (Factur-X by default).
+     *
+     * @param params - Invoice creation parameters
+     * @param requestOptions - Optional request configuration
+     * @returns Created invoice
+     *
+     * @example
+     * ```typescript
+     * const { data: invoice } = await client.directInvoices.create({
+     *   company_id: 'company-uuid',
+     *   buyer: {
+     *     company_name: 'Acme Corporation',
+     *     siret: '98765432109876',
+     *     address: {
+     *       line1: '456 Avenue Business',
+     *       postal_code: '69001',
+     *       city: 'Lyon',
+     *       country: 'FR'
+     *     },
+     *     email: 'accounts@acme.com'
+     *   },
+     *   lines: [{
+     *     description: 'Monthly subscription',
+     *     quantity: 1,
+     *     unit_price: 299,
+     *     tax_rate: 20,
+     *     total_ht: 299,
+     *     total_tax: 59.80,
+     *     total_ttc: 358.80
+     *   }],
+     *   issue_date: '2026-01-26',
+     *   due_date: '2026-02-26',
+     *   notes: 'Thank you for your business!'
+     * });
+     *
+     * console.log('Invoice created:', invoice.invoice_number);
+     * ```
+     */
+    create(params: CreateTenantDirectInvoiceParams, requestOptions?: RequestOptions): Promise<SingleResponse<TenantInvoice>>;
+    /**
+     * List all direct invoices
+     *
+     * Returns a paginated list of direct invoices created by the tenant.
+     * Supports filtering by status, date range, buyer, and amount.
+     *
+     * @param filters - Filter and pagination options
+     * @param requestOptions - Optional request configuration
+     * @returns Paginated list of invoices
+     *
+     * @example
+     * ```typescript
+     * // List all validated invoices
+     * const { data: invoices, meta } = await client.directInvoices.list({
+     *   status: 'validated',
+     *   per_page: 50
+     * });
+     *
+     * console.log(`Found ${meta.total} validated invoices`);
+     *
+     * // Filter by date range
+     * const januaryInvoices = await client.directInvoices.list({
+     *   date_from: '2026-01-01',
+     *   date_to: '2026-01-31'
+     * });
+     *
+     * // Search by buyer
+     * const acmeInvoices = await client.directInvoices.list({
+     *   search: 'Acme'
+     * });
+     * ```
+     */
+    list(filters?: TenantInvoiceFilters, requestOptions?: RequestOptions): Promise<PaginatedResponse<TenantInvoice>>;
+    /**
+     * Get a specific direct invoice by ID
+     *
+     * @param invoiceId - Invoice UUID
+     * @param requestOptions - Optional request configuration
+     * @returns Invoice details
+     *
+     * @example
+     * ```typescript
+     * const { data: invoice } = await client.directInvoices.get('invoice-uuid');
+     *
+     * console.log('Invoice:', invoice.invoice_number);
+     * console.log('Status:', invoice.status);
+     * console.log('Total:', invoice.total_ttc, invoice.currency);
+     * ```
+     */
+    get(invoiceId: string, requestOptions?: RequestOptions): Promise<SingleResponse<TenantInvoice>>;
+    /**
+     * Update a direct invoice
+     *
+     * Only invoices in 'draft' status can be updated.
+     * Once validated or sent, invoices become immutable.
+     *
+     * @param invoiceId - Invoice UUID
+     * @param params - Update parameters
+     * @param requestOptions - Optional request configuration
+     * @returns Updated invoice
+     *
+     * @example
+     * ```typescript
+     * const { data: invoice } = await client.directInvoices.update(
+     *   'invoice-uuid',
+     *   {
+     *     due_date: '2026-03-15',
+     *     notes: 'Updated payment terms'
+     *   }
+     * );
+     *
+     * console.log('Invoice updated:', invoice.due_date);
+     * ```
+     */
+    update(invoiceId: string, params: UpdateTenantInvoiceParams, requestOptions?: RequestOptions): Promise<SingleResponse<TenantInvoice>>;
+    /**
+     * Delete a direct invoice
+     *
+     * Only invoices in 'draft' status can be deleted.
+     * Validated or sent invoices cannot be deleted for audit trail compliance.
+     *
+     * @param invoiceId - Invoice UUID
+     * @param requestOptions - Optional request configuration
+     *
+     * @example
+     * ```typescript
+     * await client.directInvoices.delete('draft-invoice-uuid');
+     * console.log('Invoice deleted successfully');
+     * ```
+     */
+    delete(invoiceId: string, requestOptions?: RequestOptions): Promise<MessageResponse>;
+    /**
+     * Validate a direct invoice
+     *
+     * Validates the invoice, generates the electronic invoice file,
+     * and changes status from 'draft' to 'validated'.
+     *
+     * @param invoiceId - Invoice UUID
+     * @param requestOptions - Optional request configuration
+     * @returns Validated invoice
+     *
+     * @example
+     * ```typescript
+     * const { data: invoice } = await client.directInvoices.validate('invoice-uuid');
+     * console.log('Invoice validated:', invoice.status); // 'validated'
+     * console.log('Validated at:', invoice.validated_at);
+     * ```
+     */
+    validate(invoiceId: string, requestOptions?: RequestOptions): Promise<SingleResponse<TenantInvoice>>;
+    /**
+     * Send a direct invoice to the buyer
+     *
+     * Sends the validated invoice to the buyer via email.
+     * The invoice must be in 'validated' status.
+     *
+     * @param invoiceId - Invoice UUID
+     * @param requestOptions - Optional request configuration
+     * @returns Updated invoice
+     *
+     * @example
+     * ```typescript
+     * const { data: invoice } = await client.directInvoices.send('invoice-uuid');
+     * console.log('Invoice sent to:', invoice.buyer.email);
+     * ```
+     */
+    send(invoiceId: string, requestOptions?: RequestOptions): Promise<SingleResponse<TenantInvoice>>;
+    /**
+     * Download invoice as PDF
+     *
+     * Downloads the electronic invoice file as a PDF (Factur-X).
+     *
+     * @param invoiceId - Invoice UUID
+     * @param requestOptions - Optional request configuration
+     * @returns ArrayBuffer containing the PDF file
+     *
+     * @example
+     * ```typescript
+     * // Download invoice PDF
+     * const pdfBuffer = await client.directInvoices.download('invoice-uuid');
+     *
+     * // In Node.js, save to file:
+     * import { writeFileSync } from 'fs';
+     * writeFileSync('invoice.pdf', Buffer.from(pdfBuffer));
+     *
+     * // In browser, trigger download:
+     * const blob = new Blob([pdfBuffer], { type: 'application/pdf' });
+     * const url = URL.createObjectURL(blob);
+     * const a = document.createElement('a');
+     * a.href = url;
+     * a.download = 'invoice.pdf';
+     * a.click();
+     * ```
+     */
+    download(invoiceId: string, requestOptions?: RequestOptions): Promise<ArrayBuffer>;
+    /**
+     * Download invoice XML
+     *
+     * Downloads the electronic invoice XML (UBL/CII format).
+     *
+     * @param invoiceId - Invoice UUID
+     * @param requestOptions - Optional request configuration
+     * @returns ArrayBuffer containing the XML file
+     *
+     * @example
+     * ```typescript
+     * const xmlBuffer = await client.directInvoices.downloadXml('invoice-uuid');
+     * const xmlString = new TextDecoder().decode(xmlBuffer);
+     * console.log('XML:', xmlString);
+     * ```
+     */
+    downloadXml(invoiceId: string, requestOptions?: RequestOptions): Promise<ArrayBuffer>;
+    /**
+     * Bulk create multiple invoices
+     */
+    bulkCreate(invoices: CreateTenantDirectInvoiceParams[], requestOptions?: RequestOptions): Promise<MessageResponse>;
+    /**
+     * Bulk submit multiple invoices
+     */
+    bulkSubmit(invoiceIds: string[], requestOptions?: RequestOptions): Promise<MessageResponse>;
+    /**
+     * Get status of multiple invoices
+     */
+    bulkStatus(invoiceIds: string[], requestOptions?: RequestOptions): Promise<SingleResponse<Record<string, unknown>[]>>;
+}
+
+/**
+ * Tenant Direct Credit Notes Resource
+ *
+ * Manage credit notes for direct invoices issued by a tenant.
+ * Direct credit notes are linked to direct invoices (not sub-tenant invoices)
+ * and allow partial or total refunds.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Remaining creditable information for a direct invoice
+ */
+interface DirectInvoiceRemainingCreditable {
+    /** Invoice UUID */
+    invoice_id: string;
+    /** Original invoice total (TTC) */
+    invoice_total: number;
+    /** Total already credited */
+    credited_total: number;
+    /** Remaining amount that can be credited */
+    remaining_total: number;
+    /** Line-by-line breakdown */
+    lines: DirectInvoiceRemainingLine[];
+}
+/**
+ * Remaining creditable information for an invoice line
+ */
+interface DirectInvoiceRemainingLine {
+    /** Invoice line UUID */
+    invoice_line_id: string;
+    /** Line description */
+    description: string;
+    /** Original quantity */
+    original_quantity: number;
+    /** Quantity already credited */
+    credited_quantity: number;
+    /** Remaining quantity that can be credited */
+    remaining_quantity: number;
+    /** Unit price */
+    unit_price: number;
+}
+/**
+ * Tenant Direct Credit Notes API resource
+ *
+ * Provides operations for managing credit notes linked to direct invoices.
+ * Use this for refunds or corrections on invoices issued to external buyers.
+ *
+ * @example
+ * ```typescript
+ * import { ScellTenantClient } from '@scell/sdk';
+ *
+ * const client = new ScellTenantClient('your-tenant-key');
+ *
+ * // Create a partial credit note
+ * const { data: creditNote } = await client.directCreditNotes.create({
+ *   invoice_id: 'invoice-uuid',
+ *   reason: 'Product returned - damaged in transit',
+ *   type: 'partial',
+ *   items: [
+ *     { invoice_line_id: 'line-uuid', quantity: 2 }
+ *   ]
+ * });
+ *
+ * // Create a total credit note (full refund)
+ * const { data: totalCreditNote } = await client.directCreditNotes.create({
+ *   invoice_id: 'invoice-uuid',
+ *   reason: 'Order cancelled by customer',
+ *   type: 'total'
+ * });
+ *
+ * // List all credit notes
+ * const { data: creditNotes } = await client.directCreditNotes.list({
+ *   status: 'sent'
+ * });
+ * ```
+ */
+declare class TenantDirectCreditNotesResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Create a new credit note for a direct invoice
+     *
+     * Creates a credit note (avoir) linked to a direct invoice.
+     * - For partial credit notes, specify the items and quantities to credit.
+     * - For total credit notes, all items are automatically credited.
+     *
+     * @param params - Credit note creation parameters
+     * @param requestOptions - Optional request configuration
+     * @returns Created credit note
+     *
+     * @example
+     * ```typescript
+     * // Partial credit note
+     * const { data: creditNote } = await client.directCreditNotes.create({
+     *   invoice_id: 'invoice-uuid',
+     *   reason: 'Returned items',
+     *   type: 'partial',
+     *   items: [
+     *     { invoice_line_id: 'line-1-uuid', quantity: 2 },
+     *     { invoice_line_id: 'line-2-uuid', quantity: 1 }
+     *   ]
+     * });
+     *
+     * // Total credit note (cancels entire invoice)
+     * const { data: totalCreditNote } = await client.directCreditNotes.create({
+     *   invoice_id: 'invoice-uuid',
+     *   reason: 'Invoice issued in error',
+     *   type: 'total'
+     * });
+     *
+     * console.log('Credit note number:', creditNote.credit_note_number);
+     * console.log('Amount:', creditNote.total, creditNote.currency);
+     * ```
+     */
+    create(params: CreateTenantDirectCreditNoteParams, requestOptions?: RequestOptions): Promise<SingleResponse<TenantCreditNote$1>>;
+    /**
+     * List all direct credit notes
+     *
+     * Returns a paginated list of credit notes for direct invoices.
+     *
+     * @param filters - Filter and pagination options
+     * @param requestOptions - Optional request configuration
+     * @returns Paginated list of credit notes
+     *
+     * @example
+     * ```typescript
+     * // List all sent credit notes
+     * const { data: creditNotes, meta } = await client.directCreditNotes.list({
+     *   status: 'sent',
+     *   per_page: 50
+     * });
+     *
+     * console.log(`Found ${meta.total} sent credit notes`);
+     *
+     * // Filter by date range
+     * const januaryCreditNotes = await client.directCreditNotes.list({
+     *   date_from: '2026-01-01',
+     *   date_to: '2026-01-31'
+     * });
+     * ```
+     */
+    list(filters?: TenantCreditNoteFilters, requestOptions?: RequestOptions): Promise<PaginatedResponse<TenantCreditNote$1>>;
+    /**
+     * Get a specific credit note by ID
+     *
+     * @param creditNoteId - Credit note UUID
+     * @param requestOptions - Optional request configuration
+     * @returns Credit note details
+     *
+     * @example
+     * ```typescript
+     * const { data: creditNote } = await client.directCreditNotes.get('credit-note-uuid');
+     *
+     * console.log('Credit note:', creditNote.credit_note_number);
+     * console.log('Status:', creditNote.status);
+     * console.log('Reason:', creditNote.reason);
+     * console.log('Total:', creditNote.total, creditNote.currency);
+     * ```
+     */
+    get(creditNoteId: string, requestOptions?: RequestOptions): Promise<SingleResponse<TenantCreditNote$1>>;
+    /**
+     * Update a credit note
+     *
+     * Only credit notes in 'draft' status can be updated.
+     *
+     * @param creditNoteId - Credit note UUID
+     * @param params - Update parameters
+     * @param requestOptions - Optional request configuration
+     * @returns Updated credit note
+     *
+     * @example
+     * ```typescript
+     * const { data: creditNote } = await client.directCreditNotes.update(
+     *   'credit-note-uuid',
+     *   {
+     *     reason: 'Updated reason: Customer complaint resolved',
+     *     items: [
+     *       { invoice_line_id: 'line-uuid', quantity: 3 }
+     *     ]
+     *   }
+     * );
+     * ```
+     */
+    update(creditNoteId: string, params: UpdateTenantCreditNoteParams, requestOptions?: RequestOptions): Promise<SingleResponse<TenantCreditNote$1>>;
+    /**
+     * Delete a credit note
+     *
+     * Only credit notes in 'draft' status can be deleted.
+     *
+     * @param creditNoteId - Credit note UUID
+     * @param requestOptions - Optional request configuration
+     *
+     * @example
+     * ```typescript
+     * await client.directCreditNotes.delete('draft-credit-note-uuid');
+     * console.log('Credit note deleted');
+     * ```
+     */
+    delete(creditNoteId: string, requestOptions?: RequestOptions): Promise<MessageResponse>;
+    /**
+     * Send a credit note
+     *
+     * Validates and sends the credit note, changing status from 'draft' to 'sent'.
+     *
+     * @param creditNoteId - Credit note UUID
+     * @param requestOptions - Optional request configuration
+     * @returns Sent credit note
+     *
+     * @example
+     * ```typescript
+     * const { data: creditNote } = await client.directCreditNotes.send('credit-note-uuid');
+     * console.log('Credit note sent:', creditNote.status); // 'sent'
+     * ```
+     */
+    send(creditNoteId: string, requestOptions?: RequestOptions): Promise<SingleResponse<TenantCreditNote$1>>;
+    /**
+     * Download credit note as PDF
+     *
+     * @param creditNoteId - Credit note UUID
+     * @param requestOptions - Optional request configuration
+     * @returns ArrayBuffer containing the PDF file
+     *
+     * @example
+     * ```typescript
+     * const pdfBuffer = await client.directCreditNotes.download('credit-note-uuid');
+     *
+     * // In Node.js:
+     * import { writeFileSync } from 'fs';
+     * writeFileSync('credit-note.pdf', Buffer.from(pdfBuffer));
+     *
+     * // In browser:
+     * const blob = new Blob([pdfBuffer], { type: 'application/pdf' });
+     * const url = URL.createObjectURL(blob);
+     * window.open(url);
+     * ```
+     */
+    download(creditNoteId: string, requestOptions?: RequestOptions): Promise<ArrayBuffer>;
+    /**
+     * Get remaining creditable amount for a direct invoice
+     *
+     * Returns information about how much can still be credited,
+     * including line-by-line breakdown.
+     *
+     * @param invoiceId - Invoice UUID
+     * @param requestOptions - Optional request configuration
+     * @returns Remaining creditable information
+     *
+     * @example
+     * ```typescript
+     * const remaining = await client.directCreditNotes.remainingCreditable('invoice-uuid');
+     *
+     * console.log('Invoice total:', remaining.invoice_total);
+     * console.log('Already credited:', remaining.credited_total);
+     * console.log('Can still credit:', remaining.remaining_total);
+     *
+     * // Check per-line
+     * remaining.lines.forEach(line => {
+     *   if (line.remaining_quantity > 0) {
+     *     console.log(`${line.description}: ${line.remaining_quantity} units remaining`);
+     *   }
+     * });
+     * ```
+     */
+    remainingCreditable(invoiceId: string, requestOptions?: RequestOptions): Promise<DirectInvoiceRemainingCreditable>;
+}
+
+/**
+ * Tenant Incoming Invoices Resource
+ *
+ * Manage incoming invoices (purchase invoices) for sub-tenants.
+ * Incoming invoices are invoices received by a sub-tenant from external suppliers.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Input for accepting an incoming invoice
+ */
+interface AcceptIncomingInvoiceInput {
+    /** Expected payment date (YYYY-MM-DD) */
+    payment_date?: string | undefined;
+    /** Optional note about acceptance */
+    note?: string | undefined;
+}
+/**
+ * Input for marking an invoice as paid
+ */
+interface MarkPaidIncomingInvoiceInput {
+    /** Payment reference (bank transfer ID, check number, etc.) */
+    payment_reference?: string | undefined;
+    /** Payment date (ISO 8601) - defaults to current date/time */
+    paid_at?: string | undefined;
+    /** Optional note about the payment */
+    note?: string | undefined;
+}
+/**
+ * Tenant Incoming Invoices API resource
+ *
+ * Provides operations for managing incoming invoices (purchase invoices)
+ * received by sub-tenants from external suppliers.
+ *
+ * In the French e-invoicing lifecycle, incoming invoices go through these states:
+ * - pending: Awaiting review
+ * - accepted: Approved for payment
+ * - rejected: Disputed/refused
+ * - paid: Payment completed
+ *
+ * @example
+ * ```typescript
+ * import { ScellTenantClient } from '@scell/sdk';
+ *
+ * const client = new ScellTenantClient('your-tenant-key');
+ *
+ * // Create an incoming invoice for a sub-tenant
+ * const { data: invoice } = await client.incomingInvoices.create(
+ *   'sub-tenant-uuid',
+ *   {
+ *     invoice_number: 'SUPP-2026-001',
+ *     company_id: 'company-uuid',
+ *     seller: {
+ *       company_name: 'Supplier Corp',
+ *       siren: '123456789',
+ *       address: {
+ *         line1: '789 Rue Fournisseur',
+ *         postal_code: '33000',
+ *         city: 'Bordeaux',
+ *         country: 'FR'
+ *       },
+ *       email: 'invoices@supplier.com'
+ *     },
+ *     lines: [{
+ *       description: 'Raw materials',
+ *       quantity: 100,
+ *       unit_price: 10,
+ *       tax_rate: 20,
+ *       total_ht: 1000,
+ *       total_tax: 200,
+ *       total_ttc: 1200
+ *     }],
+ *     issue_date: '2026-01-20',
+ *     total_ht: 1000,
+ *     total_ttc: 1200
+ *   }
+ * );
+ *
+ * // Accept the invoice
+ * await client.incomingInvoices.accept(invoice.id, {
+ *   payment_date: '2026-02-20',
+ *   note: 'Approved by finance department'
+ * });
+ *
+ * // Later, mark as paid
+ * await client.incomingInvoices.markPaid(invoice.id, {
+ *   payment_reference: 'VIR-2026-0150'
+ * });
+ * ```
+ */
+declare class TenantIncomingInvoicesResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Create a new incoming invoice for a sub-tenant
+     *
+     * Creates a purchase invoice received by a sub-tenant from an external supplier.
+     * The seller's SIREN is validated using the Luhn algorithm.
+     *
+     * @param subTenantId - Sub-tenant UUID
+     * @param params - Invoice creation parameters
+     * @param requestOptions - Optional request configuration
+     * @returns Created invoice
+     *
+     * @example
+     * ```typescript
+     * const { data: invoice } = await client.incomingInvoices.create(
+     *   'sub-tenant-uuid',
+     *   {
+     *     invoice_number: 'SUPP-2026-001',
+     *     company_id: 'company-uuid',
+     *     seller: {
+     *       company_name: 'Acme Supplies',
+     *       siren: '123456789',
+     *       siret: '12345678901234',
+     *       vat_number: 'FR12123456789',
+     *       address: {
+     *         line1: '123 Industrial Park',
+     *         postal_code: '31000',
+     *         city: 'Toulouse',
+     *         country: 'FR'
+     *       },
+     *       email: 'billing@acme-supplies.com'
+     *     },
+     *     lines: [
+     *       {
+     *         description: 'Widget A - Bulk order',
+     *         quantity: 500,
+     *         unit_price: 2.50,
+     *         tax_rate: 20,
+     *         total_ht: 1250,
+     *         total_tax: 250,
+     *         total_ttc: 1500
+     *       }
+     *     ],
+     *     issue_date: '2026-01-15',
+     *     due_date: '2026-02-15',
+     *     total_ht: 1250,
+     *     total_ttc: 1500
+     *   }
+     * );
+     *
+     * console.log('Incoming invoice created:', invoice.invoice_number);
+     * ```
+     */
+    create(subTenantId: string, params: CreateIncomingInvoiceParams, requestOptions?: RequestOptions): Promise<SingleResponse<TenantInvoice>>;
+    /**
+     * List incoming invoices for a sub-tenant
+     *
+     * Returns a paginated list of purchase invoices received by the sub-tenant.
+     *
+     * @param subTenantId - Sub-tenant UUID
+     * @param filters - Filter and pagination options
+     * @param requestOptions - Optional request configuration
+     * @returns Paginated list of invoices
+     *
+     * @example
+     * ```typescript
+     * // List all pending invoices
+     * const { data: invoices, meta } = await client.incomingInvoices.listForSubTenant(
+     *   'sub-tenant-uuid',
+     *   { status: 'pending', per_page: 50 }
+     * );
+     *
+     * console.log(`Found ${meta.total} pending invoices to review`);
+     *
+     * // Filter by supplier
+     * const acmeInvoices = await client.incomingInvoices.listForSubTenant(
+     *   'sub-tenant-uuid',
+     *   { seller_siret: '12345678901234' }
+     * );
+     * ```
+     */
+    listForSubTenant(subTenantId: string, filters?: TenantInvoiceFilters, requestOptions?: RequestOptions): Promise<PaginatedResponse<TenantInvoice>>;
+    /**
+     * Get a specific incoming invoice by ID
+     *
+     * @param invoiceId - Invoice UUID
+     * @param requestOptions - Optional request configuration
+     * @returns Invoice details
+     *
+     * @example
+     * ```typescript
+     * const { data: invoice } = await client.incomingInvoices.get('invoice-uuid');
+     *
+     * console.log('Invoice from:', invoice.seller.name);
+     * console.log('Status:', invoice.status);
+     * console.log('Amount:', invoice.total_ttc, invoice.currency);
+     * ```
+     */
+    get(invoiceId: string, requestOptions?: RequestOptions): Promise<SingleResponse<TenantInvoice>>;
+    /**
+     * Accept an incoming invoice
+     *
+     * Marks the invoice as accepted, indicating approval for payment.
+     * Optionally specify an expected payment date.
+     *
+     * @param invoiceId - Invoice UUID
+     * @param input - Optional acceptance details
+     * @param requestOptions - Optional request configuration
+     * @returns Updated invoice
+     *
+     * @example
+     * ```typescript
+     * // Accept with payment date
+     * const { data: invoice } = await client.incomingInvoices.accept(
+     *   'invoice-uuid',
+     *   {
+     *     payment_date: '2026-02-15',
+     *     note: 'Approved by CFO'
+     *   }
+     * );
+     *
+     * console.log('Invoice accepted:', invoice.status); // 'accepted'
+     *
+     * // Simple acceptance
+     * await client.incomingInvoices.accept('invoice-uuid');
+     * ```
+     */
+    accept(invoiceId: string, input?: AcceptIncomingInvoiceInput, requestOptions?: RequestOptions): Promise<SingleResponse<TenantInvoice>>;
+    /**
+     * Reject an incoming invoice
+     *
+     * Marks the invoice as rejected with a reason and optional code.
+     *
+     * @param invoiceId - Invoice UUID
+     * @param reason - Reason for rejection
+     * @param code - Optional standardized rejection code
+     * @param requestOptions - Optional request configuration
+     * @returns Updated invoice
+     *
+     * @example
+     * ```typescript
+     * const { data: invoice } = await client.incomingInvoices.reject(
+     *   'invoice-uuid',
+     *   'Amount does not match purchase order PO-2026-042',
+     *   'incorrect_amount'
+     * );
+     *
+     * console.log('Invoice rejected:', invoice.status); // 'rejected'
+     * ```
+     */
+    reject(invoiceId: string, reason: string, code?: RejectionCode, requestOptions?: RequestOptions): Promise<SingleResponse<TenantInvoice>>;
+    /**
+     * Mark an incoming invoice as paid
+     *
+     * Records payment information for an accepted invoice.
+     * This is a mandatory step in the French e-invoicing lifecycle.
+     *
+     * @param invoiceId - Invoice UUID
+     * @param input - Optional payment details
+     * @param requestOptions - Optional request configuration
+     * @returns Updated invoice with payment information
+     *
+     * @example
+     * ```typescript
+     * // Mark as paid with details
+     * const { data: invoice } = await client.incomingInvoices.markPaid(
+     *   'invoice-uuid',
+     *   {
+     *     payment_reference: 'VIR-2026-0150',
+     *     paid_at: '2026-02-14T14:30:00Z',
+     *     note: 'Payment via bank transfer'
+     *   }
+     * );
+     *
+     * console.log('Invoice paid:', invoice.status); // 'paid'
+     * console.log('Payment ref:', invoice.payment_reference);
+     *
+     * // Simple mark as paid (current date)
+     * await client.incomingInvoices.markPaid('invoice-uuid');
+     * ```
+     */
+    markPaid(invoiceId: string, input?: MarkPaidIncomingInvoiceInput, requestOptions?: RequestOptions): Promise<SingleResponse<TenantInvoice>>;
+    /**
+     * Delete an incoming invoice
+     *
+     * Only invoices in 'pending' status can be deleted.
+     *
+     * @param invoiceId - Invoice UUID
+     * @param requestOptions - Optional request configuration
+     *
+     * @example
+     * ```typescript
+     * await client.incomingInvoices.delete('pending-invoice-uuid');
+     * console.log('Incoming invoice deleted');
+     * ```
+     */
+    delete(invoiceId: string, requestOptions?: RequestOptions): Promise<MessageResponse>;
+    /**
+     * Download incoming invoice as PDF
+     *
+     * @param invoiceId - Invoice UUID
+     * @param requestOptions - Optional request configuration
+     * @returns ArrayBuffer containing the PDF file
+     *
+     * @example
+     * ```typescript
+     * const pdfBuffer = await client.incomingInvoices.download('invoice-uuid');
+     *
+     * // Save to file (Node.js)
+     * import { writeFileSync } from 'fs';
+     * writeFileSync('supplier-invoice.pdf', Buffer.from(pdfBuffer));
+     * ```
+     */
+    download(invoiceId: string, requestOptions?: RequestOptions): Promise<ArrayBuffer>;
+}
+
+/**
+ * Tenant Credit Notes types
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Credit note status
+ */
+type TenantCreditNoteStatus = 'draft' | 'sent' | 'cancelled';
+/**
+ * Credit note type
+ */
+type TenantCreditNoteType = 'partial' | 'total';
+/**
+ * Credit note item
+ */
+interface TenantCreditNoteItem {
+    id: UUID;
+    invoice_line_id?: UUID | undefined;
+    description: string;
+    quantity: number;
+    unit_price: number;
+    tax_rate: number;
+    total: number;
+}
+/**
+ * Tenant Credit Note
+ */
+interface TenantCreditNote {
+    id: UUID;
+    credit_note_number: string;
+    invoice_id: UUID;
+    tenant_id: UUID;
+    sub_tenant_id: UUID;
+    status: TenantCreditNoteStatus;
+    type: TenantCreditNoteType;
+    reason: string;
+    subtotal: number;
+    tax_amount: number;
+    total: number;
+    currency: CurrencyCode;
+    buyer_name?: string | undefined;
+    buyer_siret?: Siret | undefined;
+    seller_name?: string | undefined;
+    seller_siret?: Siret | undefined;
+    issue_date: DateString;
+    created_at: DateTimeString;
+    updated_at: DateTimeString;
+    items?: TenantCreditNoteItem[] | undefined;
+}
+/**
+ * Credit note item input for creation
+ */
+interface TenantCreditNoteItemInput {
+    invoice_line_id: UUID;
+    quantity?: number | undefined;
+}
+/**
+ * Input for creating a tenant credit note
+ */
+interface CreateTenantCreditNoteInput {
+    invoice_id: UUID;
+    reason: string;
+    type: TenantCreditNoteType;
+    items?: TenantCreditNoteItemInput[] | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}
+/**
+ * Line item remaining creditable information
+ */
+interface RemainingCreditableLine {
+    invoice_line_id: UUID;
+    description: string;
+    original_quantity: number;
+    credited_quantity: number;
+    remaining_quantity: number;
+    unit_price: number;
+}
+/**
+ * Remaining creditable information for an invoice
+ */
+interface RemainingCreditable {
+    invoice_id: UUID;
+    invoice_total: number;
+    credited_total: number;
+    remaining_total: number;
+    lines: RemainingCreditableLine[];
+}
+/**
+ * List options for tenant credit notes
+ */
+interface TenantCreditNoteListOptions extends PaginationOptions {
+    status?: TenantCreditNoteStatus | undefined;
+    date_from?: DateString | undefined;
+    date_to?: DateString | undefined;
+}
+/**
+ * Input for updating a tenant credit note
+ *
+ * Only credit notes in 'draft' status can be updated.
+ */
+interface UpdateTenantCreditNoteInput {
+    /** Updated reason for the credit note */
+    reason?: string | undefined;
+    /** Updated items (for partial credit notes) */
+    items?: TenantCreditNoteItemInput[] | undefined;
+    /** Updated metadata */
+    metadata?: Record<string, unknown> | undefined;
+}
+
+/**
+ * Tenant Credit Notes Resource
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Tenant Credit Notes API resource
+ *
+ * Manage credit notes for sub-tenant invoices.
+ *
+ * @example
+ * ```typescript
+ * // List credit notes for a sub-tenant
+ * const { data, meta } = await client.tenantCreditNotes.list('sub-tenant-uuid', {
+ *   status: 'sent'
+ * });
+ *
+ * // Create a credit note
+ * const creditNote = await client.tenantCreditNotes.create('sub-tenant-uuid', {
+ *   invoice_id: 'invoice-uuid',
+ *   reason: 'Product returned',
+ *   type: 'partial',
+ *   items: [{ invoice_line_id: 'line-uuid', quantity: 1 }]
+ * });
+ * ```
+ */
+declare class TenantCreditNotesResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * List credit notes for a sub-tenant
+     *
+     * @param subTenantId - Sub-tenant UUID
+     * @param options - Filter and pagination options
+     * @param requestOptions - Request options
+     * @returns Paginated list of credit notes
+     *
+     * @example
+     * ```typescript
+     * const { data, meta } = await client.tenantCreditNotes.list('sub-tenant-uuid', {
+     *   status: 'sent',
+     *   date_from: '2024-01-01',
+     *   per_page: 50
+     * });
+     * console.log(`Found ${meta.total} credit notes`);
+     * ```
+     */
+    list(subTenantId: string, options?: TenantCreditNoteListOptions, requestOptions?: RequestOptions): Promise<PaginatedResponse<TenantCreditNote>>;
+    /**
+     * Create a new credit note for a sub-tenant invoice
+     *
+     * @param subTenantId - Sub-tenant UUID
+     * @param input - Credit note creation data
+     * @param requestOptions - Request options
+     * @returns Created credit note
+     *
+     * @example
+     * ```typescript
+     * // Create a partial credit note
+     * const { data: creditNote } = await client.tenantCreditNotes.create(
+     *   'sub-tenant-uuid',
+     *   {
+     *     invoice_id: 'invoice-uuid',
+     *     reason: 'Product returned - damaged item',
+     *     type: 'partial',
+     *     items: [
+     *       { invoice_line_id: 'line-uuid-1', quantity: 2 }
+     *     ]
+     *   }
+     * );
+     *
+     * // Create a total credit note
+     * const { data: totalCreditNote } = await client.tenantCreditNotes.create(
+     *   'sub-tenant-uuid',
+     *   {
+     *     invoice_id: 'invoice-uuid',
+     *     reason: 'Order cancelled',
+     *     type: 'total'
+     *   }
+     * );
+     * ```
+     */
+    create(subTenantId: string, input: CreateTenantCreditNoteInput, requestOptions?: RequestOptions): Promise<SingleResponse<TenantCreditNote>>;
+    /**
+     * Get a specific credit note by ID
+     *
+     * @param creditNoteId - Credit note UUID
+     * @param requestOptions - Request options
+     * @returns Credit note details
+     *
+     * @example
+     * ```typescript
+     * const { data: creditNote } = await client.tenantCreditNotes.get('credit-note-uuid');
+     * console.log('Credit note number:', creditNote.credit_note_number);
+     * console.log('Total:', creditNote.total, creditNote.currency);
+     * ```
+     */
+    get(creditNoteId: string, requestOptions?: RequestOptions): Promise<SingleResponse<TenantCreditNote>>;
+    /**
+     * Update a credit note
+     *
+     * Only credit notes in 'draft' status can be updated.
+     *
+     * @param creditNoteId - Credit note UUID
+     * @param input - Update data
+     * @param requestOptions - Request options
+     * @returns Updated credit note
+     *
+     * @example
+     * ```typescript
+     * const { data: creditNote } = await client.tenantCreditNotes.update(
+     *   'credit-note-uuid',
+     *   {
+     *     reason: 'Updated reason: Customer complaint resolved',
+     *     items: [
+     *       { invoice_line_id: 'line-uuid', quantity: 3 }
+     *     ]
+     *   }
+     * );
+     * console.log('Credit note updated:', creditNote.reason);
+     * ```
+     */
+    update(creditNoteId: string, input: UpdateTenantCreditNoteInput, requestOptions?: RequestOptions): Promise<SingleResponse<TenantCreditNote>>;
+    /**
+     * Send a credit note
+     *
+     * Changes the status from 'draft' to 'sent'.
+     *
+     * @param creditNoteId - Credit note UUID
+     * @param requestOptions - Request options
+     * @returns Updated credit note
+     *
+     * @example
+     * ```typescript
+     * const { data: sentCreditNote } = await client.tenantCreditNotes.send('credit-note-uuid');
+     * console.log('Status:', sentCreditNote.status); // 'sent'
+     * ```
+     */
+    send(creditNoteId: string, requestOptions?: RequestOptions): Promise<SingleResponse<TenantCreditNote>>;
+    /**
+     * Delete a credit note (draft only)
+     *
+     * Only credit notes with status 'draft' can be deleted.
+     *
+     * @param creditNoteId - Credit note UUID
+     * @param requestOptions - Request options
+     *
+     * @example
+     * ```typescript
+     * await client.tenantCreditNotes.delete('credit-note-uuid');
+     * ```
+     */
+    delete(creditNoteId: string, requestOptions?: RequestOptions): Promise<MessageResponse>;
+    /**
+     * Download credit note as PDF
+     *
+     * @param creditNoteId - Credit note UUID
+     * @param requestOptions - Request options
+     * @returns ArrayBuffer containing the PDF file
+     *
+     * @example
+     * ```typescript
+     * // Download credit note PDF
+     * const pdfBuffer = await client.tenantCreditNotes.download('credit-note-uuid');
+     *
+     * // In Node.js, save to file:
+     * import { writeFileSync } from 'fs';
+     * writeFileSync('credit-note.pdf', Buffer.from(pdfBuffer));
+     *
+     * // In browser, trigger download:
+     * const blob = new Blob([pdfBuffer], { type: 'application/pdf' });
+     * const url = URL.createObjectURL(blob);
+     * const a = document.createElement('a');
+     * a.href = url;
+     * a.download = 'credit-note.pdf';
+     * a.click();
+     * ```
+     */
+    download(creditNoteId: string, requestOptions?: RequestOptions): Promise<ArrayBuffer>;
+    /**
+     * Get remaining creditable amount for an invoice
+     *
+     * Returns information about how much can still be credited for an invoice,
+     * including per-line breakdown.
+     *
+     * @param invoiceId - Invoice UUID
+     * @param requestOptions - Request options
+     * @returns Remaining creditable information
+     *
+     * @example
+     * ```typescript
+     * const remaining = await client.tenantCreditNotes.remainingCreditable('invoice-uuid');
+     *
+     * console.log('Invoice total:', remaining.invoice_total);
+     * console.log('Already credited:', remaining.credited_total);
+     * console.log('Remaining to credit:', remaining.remaining_total);
+     *
+     * // Check remaining quantity per line
+     * remaining.lines.forEach(line => {
+     *   console.log(`${line.description}: ${line.remaining_quantity} remaining`);
+     * });
+     * ```
+     */
+    remainingCreditable(invoiceId: string, requestOptions?: RequestOptions): Promise<RemainingCreditable>;
+}
+
+/**
+ * Fiscal Compliance Types
+ *
+ * Types for the fiscal compliance API (LF 2026).
+ *
+ * @packageDocumentation
+ */
+interface FiscalComplianceData {
+    closing_coverage_percent: number;
+    chain_integrity_percent: number;
+    open_incidents: FiscalIncident[];
+    open_incidents_count: number;
+    overall_status: FiscalComplianceStatus;
+    last_integrity_check_at: string | null;
+    last_closing_at: string | null;
+    last_closing_date: string | null;
+    total_fiscal_entries: number;
+    days_with_activity: number;
+    days_closed: number;
+    attestation_status: FiscalAttestationStatus;
+}
+type FiscalComplianceStatus = 'CONFORME' | 'ALERTE' | 'NON_CONFORME';
+interface FiscalIncident {
+    type: string;
+    severity: 'critical' | 'warning' | 'info';
+    message: string;
+    since?: string;
+    count?: number;
+}
+interface FiscalAttestationStatus {
+    current: boolean;
+    software_version: string;
+    attestation_version: string | null;
+    needs_renewal: boolean;
+    reason: string | null;
+}
+interface FiscalIntegrityReport {
+    is_valid: boolean;
+    entries_checked: number;
+    broken_links: number;
+    details?: Record<string, unknown>;
+}
+interface FiscalIntegrityCheck {
+    id: string;
+    tenant_id: string;
+    result: 'passed' | 'failed';
+    entries_checked: number;
+    broken_links: number;
+    details?: Record<string, unknown>;
+    created_at: string;
+}
+interface FiscalIntegrityOptions {
+    date_from?: string;
+    date_to?: string;
+}
+interface FiscalIntegrityHistoryOptions {
+    per_page?: number;
+}
+interface FiscalClosing {
+    id: string;
+    tenant_id: string;
+    closing_date: string;
+    closing_type: string;
+    status: string;
+    entries_count: number;
+    total_debit: number;
+    total_credit: number;
+    chain_hash?: string;
+    environment?: string;
+    created_at?: string;
+}
+interface FiscalClosingsOptions {
+    limit?: number;
+}
+interface FiscalDailyClosingInput {
+    date?: string;
+}
+interface FiscalFecExportOptions {
+    start_date: string;
+    end_date: string;
+    format?: 'pipe' | 'tab';
+    download?: boolean;
+}
+interface FiscalFecExportResult {
+    period: {
+        start_date: string;
+        end_date: string;
+    };
+    format: string;
+    file_path: string;
+}
+interface FiscalAttestation {
+    year: number;
+    tenant_name: string;
+    software_version: string;
+    compliance: Record<string, unknown>;
+    generated_at?: string;
+    certificate_hash?: string;
+}
+interface FiscalEntry {
+    id: string;
+    tenant_id: string;
+    sequence_number: number;
+    entry_type: string;
+    fiscal_date: string;
+    entity_type?: string | null;
+    entity_id?: string | null;
+    data_snapshot?: Record<string, unknown> | null;
+    data_hash?: string;
+    previous_hash?: string;
+    chain_hash?: string;
+    environment?: string;
+    legal_status?: string;
+    created_at?: string;
+}
+interface FiscalEntriesOptions {
+    date_from?: string;
+    date_to?: string;
+    entry_type?: string;
+    environment?: 'production' | 'sandbox';
+    per_page?: number;
+}
+interface FiscalKillSwitchStatus {
+    is_active: boolean;
+    kill_switch: FiscalKillSwitch | null;
+}
+interface FiscalKillSwitch {
+    id: string;
+    tenant_id: string;
+    is_active: boolean;
+    activated_at: string;
+    reason: string;
+    activated_by: string;
+    deactivated_at?: string | null;
+    deactivated_by?: string | null;
+}
+interface FiscalKillSwitchActivateInput {
+    reason: string;
+}
+interface FiscalAnchor {
+    id: string;
+    tenant_id: string;
+    anchor_type: string;
+    source_hash: string;
+    anchor_reference?: string | null;
+    anchor_provider?: string | null;
+    anchored_at?: string | null;
+    created_at?: string;
+}
+interface FiscalAnchorsOptions {
+    limit?: number;
+}
+type FiscalRuleCategory = 'vat' | 'invoicing' | 'credit_note' | 'closing' | 'export';
+interface FiscalRule {
+    id: string;
+    rule_key: string;
+    name: string;
+    category: FiscalRuleCategory;
+    rule_definition: Record<string, unknown>;
+    version: number;
+    effective_from: string;
+    effective_until?: string | null;
+    legal_reference?: string | null;
+    tenant_id?: string | null;
+    description?: string | null;
+    is_active: boolean;
+    created_at?: string;
+}
+interface FiscalRulesOptions {
+    date?: string;
+    category?: FiscalRuleCategory;
+}
+interface FiscalCreateRuleInput {
+    rule_key: string;
+    name: string;
+    category: FiscalRuleCategory;
+    rule_definition: Record<string, unknown>;
+    effective_from: string;
+    effective_until?: string;
+    legal_reference?: string;
+}
+interface FiscalUpdateRuleInput {
+    rule_definition: Record<string, unknown>;
+    effective_from?: string;
+    effective_until?: string;
+    legal_reference?: string;
+}
+interface FiscalExportRulesOptions {
+    start_date: string;
+    end_date: string;
+}
+interface FiscalReplayRulesInput {
+    start_date: string;
+    end_date: string;
+}
+type FiscalForensicExportType = 'chronology' | 'graph' | 'report';
+interface FiscalForensicExportOptions {
+    start_date: string;
+    end_date: string;
+    type?: FiscalForensicExportType;
+}
+
+/**
+ * Fiscal Compliance Resource
+ * @packageDocumentation
+ */
+
+declare class FiscalResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    compliance(requestOptions?: RequestOptions): Promise<SingleResponse<FiscalComplianceData>>;
+    integrity(options?: FiscalIntegrityOptions, requestOptions?: RequestOptions): Promise<SingleResponse<FiscalIntegrityReport>>;
+    integrityHistory(options?: FiscalIntegrityHistoryOptions, requestOptions?: RequestOptions): Promise<PaginatedResponse<FiscalIntegrityReport>>;
+    integrityForDate(date: string, requestOptions?: RequestOptions): Promise<SingleResponse<FiscalIntegrityReport>>;
+    closings(options?: FiscalClosingsOptions, requestOptions?: RequestOptions): Promise<PaginatedResponse<FiscalClosing>>;
+    performDailyClosing(input?: FiscalDailyClosingInput, requestOptions?: RequestOptions): Promise<MessageResponse>;
+    fecExport(options: FiscalFecExportOptions, requestOptions?: RequestOptions): Promise<SingleResponse<FiscalFecExportResult>>;
+    fecDownload(options: FiscalFecExportOptions, requestOptions?: RequestOptions): Promise<ArrayBuffer>;
+    attestation(year: number, requestOptions?: RequestOptions): Promise<SingleResponse<FiscalAttestation>>;
+    attestationDownload(year: number, requestOptions?: RequestOptions): Promise<ArrayBuffer>;
+    entries(options?: FiscalEntriesOptions, requestOptions?: RequestOptions): Promise<PaginatedResponse<FiscalEntry>>;
+    killSwitchStatus(requestOptions?: RequestOptions): Promise<SingleResponse<FiscalKillSwitchStatus>>;
+    killSwitchActivate(input: FiscalKillSwitchActivateInput, requestOptions?: RequestOptions): Promise<MessageResponse>;
+    killSwitchDeactivate(requestOptions?: RequestOptions): Promise<MessageResponse>;
+    anchors(options?: FiscalAnchorsOptions, requestOptions?: RequestOptions): Promise<PaginatedResponse<FiscalAnchor>>;
+    rules(options?: FiscalRulesOptions, requestOptions?: RequestOptions): Promise<PaginatedResponse<FiscalRule>>;
+    ruleDetail(key: string, requestOptions?: RequestOptions): Promise<SingleResponse<FiscalRule>>;
+    ruleHistory(key: string, requestOptions?: RequestOptions): Promise<PaginatedResponse<FiscalRule>>;
+    createRule(input: FiscalCreateRuleInput, requestOptions?: RequestOptions): Promise<SingleResponse<FiscalRule>>;
+    updateRule(id: string, input: FiscalUpdateRuleInput, requestOptions?: RequestOptions): Promise<SingleResponse<FiscalRule>>;
+    exportRules(options: FiscalExportRulesOptions, requestOptions?: RequestOptions): Promise<SingleResponse<Record<string, unknown>>>;
+    replayRules(input: FiscalReplayRulesInput, requestOptions?: RequestOptions): Promise<MessageResponse>;
+    forensicExport(options: FiscalForensicExportOptions, requestOptions?: RequestOptions): Promise<SingleResponse<Record<string, unknown>>>;
+}
+
+/**
+ * Billing Types
+ *
+ * Types for the tenant billing API.
+ *
+ * @packageDocumentation
+ */
+interface BillingInvoice {
+    id: string;
+    invoice_number: string;
+    period: string;
+    total_ht: number;
+    total_tax: number;
+    total_ttc: number;
+    status: string;
+    currency: string;
+    issued_at?: string | null;
+    due_date?: string | null;
+    paid_at?: string | null;
+    lines?: BillingInvoiceLine[] | null;
+}
+interface BillingInvoiceLine {
+    description: string;
+    quantity: number;
+    unit_price: number;
+    total: number;
+}
+interface BillingInvoiceListOptions {
+    per_page?: number;
+    page?: number;
+}
+interface BillingUsage {
+    period: string;
+    invoices_count: number;
+    credit_notes_count: number;
+    signatures_count: number;
+    total_cost: number;
+    currency: string;
+    breakdown?: Record<string, unknown> | null;
+}
+interface BillingUsageOptions {
+    period?: string;
+}
+interface BillingTopUpInput {
+    amount: number;
+    payment_method?: string;
+}
+interface BillingTopUpConfirmInput {
+    payment_intent_id: string;
+}
+interface BillingTransaction {
+    id: string;
+    type: string;
+    amount: number;
+    currency: string;
+    description?: string | null;
+    reference?: string | null;
+    status?: string | null;
+    created_at?: string | null;
+}
+interface BillingTransactionListOptions {
+    per_page?: number;
+    page?: number;
+}
+
+/**
+ * Billing Resource
+ * @packageDocumentation
+ */
+
+declare class BillingResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    invoices(options?: BillingInvoiceListOptions, requestOptions?: RequestOptions): Promise<PaginatedResponse<BillingInvoice>>;
+    showInvoice(invoiceId: string, requestOptions?: RequestOptions): Promise<SingleResponse<BillingInvoice>>;
+    downloadInvoice(invoiceId: string, requestOptions?: RequestOptions): Promise<ArrayBuffer>;
+    usage(options?: BillingUsageOptions, requestOptions?: RequestOptions): Promise<SingleResponse<BillingUsage>>;
+    topUp(input: BillingTopUpInput, requestOptions?: RequestOptions): Promise<MessageResponse>;
+    confirmTopUp(input: BillingTopUpConfirmInput, requestOptions?: RequestOptions): Promise<MessageResponse>;
+    transactions(options?: BillingTransactionListOptions, requestOptions?: RequestOptions): Promise<PaginatedResponse<BillingTransaction>>;
+}
+
+/**
+ * Stats Types
+ *
+ * Types for the tenant statistics API.
+ *
+ * @packageDocumentation
+ */
+interface StatsOverview {
+    total_invoices: number;
+    total_credit_notes: number;
+    total_revenue: number;
+    total_expenses: number;
+    active_sub_tenants: number;
+    currency: string;
+    status_breakdown?: Record<string, number> | null;
+    period_comparison?: Record<string, unknown> | null;
+}
+interface StatsMonthly {
+    month: string;
+    invoices_count: number;
+    credit_notes_count: number;
+    revenue: number;
+    expenses: number;
+    daily_breakdown?: Record<string, unknown>[] | null;
+}
+interface StatsOverviewOptions {
+    period?: string;
+    currency?: string;
+}
+interface StatsMonthlyOptions {
+    year?: number;
+    month?: number;
+}
+
+/**
+ * Stats Resource
+ * @packageDocumentation
+ */
+
+declare class StatsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    overview(options?: StatsOverviewOptions, requestOptions?: RequestOptions): Promise<SingleResponse<StatsOverview>>;
+    monthly(options?: StatsMonthlyOptions, requestOptions?: RequestOptions): Promise<SingleResponse<StatsMonthly[]>>;
+    subTenantOverview(subTenantId: string, options?: StatsOverviewOptions, requestOptions?: RequestOptions): Promise<SingleResponse<StatsOverview>>;
+}
+
+/**
+ * Sub-Tenant Types
+ *
+ * Types for the sub-tenant management API.
+ *
+ * @packageDocumentation
+ */
+interface SubTenant {
+    id: string;
+    external_id?: string | null;
+    name: string;
+    siret?: string | null;
+    siren?: string | null;
+    email?: string | null;
+    phone?: string | null;
+    address?: SubTenantAddress | null;
+    metadata?: Record<string, unknown> | null;
+    created_at?: string;
+    updated_at?: string;
+}
+interface SubTenantAddress {
+    line1: string;
+    line2?: string;
+    postal_code: string;
+    city: string;
+    country?: string;
+}
+interface SubTenantListOptions {
+    per_page?: number;
+    page?: number;
+    search?: string;
+}
+interface CreateSubTenantInput {
+    external_id?: string;
+    name: string;
+    siret?: string;
+    siren?: string;
+    email?: string;
+    phone?: string;
+    address?: SubTenantAddress;
+    metadata?: Record<string, unknown>;
+}
+interface UpdateSubTenantInput {
+    external_id?: string;
+    name?: string;
+    siret?: string;
+    siren?: string;
+    email?: string;
+    phone?: string;
+    address?: SubTenantAddress;
+    metadata?: Record<string, unknown>;
+}
+
+/**
+ * Sub-Tenants Resource
+ * @packageDocumentation
+ */
+
+declare class SubTenantsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    list(options?: SubTenantListOptions, requestOptions?: RequestOptions): Promise<PaginatedResponse<SubTenant>>;
+    create(input: CreateSubTenantInput, requestOptions?: RequestOptions): Promise<SingleResponse<SubTenant>>;
+    get(id: string, requestOptions?: RequestOptions): Promise<SingleResponse<SubTenant>>;
+    update(id: string, input: UpdateSubTenantInput, requestOptions?: RequestOptions): Promise<SingleResponse<SubTenant>>;
+    delete(id: string, requestOptions?: RequestOptions): Promise<MessageResponse>;
+    findByExternalId(externalId: string, requestOptions?: RequestOptions): Promise<SingleResponse<SubTenant>>;
+}
+
+/**
+ * Tenant Profile Types
+ *
+ * Types for tenant profile and identity API.
+ *
+ * @packageDocumentation
+ */
+interface TenantProfile {
+    id: string;
+    name: string;
+    email?: string;
+    phone?: string;
+    siret?: string;
+    siren?: string;
+    address?: TenantAddress | null;
+    kyb_status?: string;
+    environment?: string;
+    created_at?: string;
+    updated_at?: string;
+}
+interface TenantAddress {
+    line1: string;
+    line2?: string;
+    postal_code: string;
+    city: string;
+    country?: string;
+}
+interface UpdateTenantProfileInput {
+    name?: string;
+    email?: string;
+    phone?: string;
+    address?: TenantAddress;
+}
+interface TenantBalance {
+    credits: number;
+    currency: string;
+}
+interface TenantQuickStats {
+    invoices_this_month: number;
+    credit_notes_this_month: number;
+    signatures_this_month: number;
+}
+interface RegenerateKeyResult {
+    tenant_key: string;
+}
+
+/**
+ * Scell Tenant Client
+ *
+ * Client for multi-tenant operations using X-Tenant-Key authentication.
+ * Use this client for tenant-specific invoice and credit note operations.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Scell Tenant Client
+ *
+ * Use this client for multi-tenant operations with X-Tenant-Key authentication.
+ */
+declare class ScellTenantClient {
+    private readonly http;
+    /** Direct invoices resource */
+    readonly directInvoices: TenantDirectInvoicesResource;
+    /** Direct credit notes resource */
+    readonly directCreditNotes: TenantDirectCreditNotesResource;
+    /** Incoming invoices resource */
+    readonly incomingInvoices: TenantIncomingInvoicesResource;
+    /** Sub-tenant credit notes resource */
+    readonly subTenantCreditNotes: TenantCreditNotesResource;
+    /** Fiscal compliance resource (LF 2026) */
+    readonly fiscal: FiscalResource;
+    /** Billing resource */
+    readonly billing: BillingResource;
+    /** Stats resource */
+    readonly stats: StatsResource;
+    /** Sub-tenants resource */
+    readonly subTenants: SubTenantsResource;
+    /**
+     * Create a new Scell Tenant Client
+     *
+     * @param tenantKey - Your tenant API key (from dashboard)
+     * @param config - Optional client configuration
+     */
+    constructor(tenantKey: string, config?: ClientConfig);
+    /** Get tenant profile */
+    me(requestOptions?: RequestOptions): Promise<SingleResponse<TenantProfile>>;
+    /** Update tenant profile */
+    updateProfile(input: UpdateTenantProfileInput, requestOptions?: RequestOptions): Promise<SingleResponse<TenantProfile>>;
+    /** Get tenant balance */
+    balance(requestOptions?: RequestOptions): Promise<SingleResponse<TenantBalance>>;
+    /** Get quick stats */
+    quickStats(requestOptions?: RequestOptions): Promise<SingleResponse<TenantQuickStats>>;
+    /** Regenerate tenant key */
+    regenerateKey(requestOptions?: RequestOptions): Promise<SingleResponse<RegenerateKeyResult>>;
+}
+
 /**
  * API Key entity
  */
@@ -996,238 +3303,6 @@ declare class CompaniesResource {
     kycStatus(id: string, requestOptions?: RequestOptions): Promise<KycStatusResponse>;
 }
 
-/**
- * Invoice direction
- */
-type InvoiceDirection = 'outgoing' | 'incoming';
-/**
- * Invoice output format
- */
-type InvoiceFormat = 'facturx' | 'ubl' | 'cii';
-/**
- * Invoice status
- */
-type InvoiceStatus = 'draft' | 'pending' | 'validated' | 'converted' | 'transmitted' | 'accepted' | 'rejected' | 'paid' | 'disputed' | 'cancelled' | 'error';
-/**
- * Invoice download file type
- */
-type InvoiceDownloadType = 'original' | 'converted' | 'pdf';
-/**
- * Invoice line item
- */
-interface InvoiceLine {
-    line_number: number;
-    description: string;
-    quantity: number;
-    unit_price: number;
-    tax_rate: number;
-    total_ht: number;
-    total_tax: number;
-    total_ttc: number;
-}
-/**
- * Invoice party (seller or buyer)
- */
-interface InvoiceParty {
-    siret: Siret;
-    name: string;
-    address: Address;
-}
-/**
- * Invoice entity
- */
-interface Invoice {
-    id: UUID;
-    external_id: string | null;
-    invoice_number: string;
-    direction: InvoiceDirection;
-    output_format: InvoiceFormat;
-    issue_date: DateString;
-    due_date: DateString | null;
-    currency: CurrencyCode;
-    total_ht: number;
-    total_tax: number;
-    total_ttc: number;
-    seller: InvoiceParty;
-    buyer: InvoiceParty;
-    lines: InvoiceLine[] | null;
-    status: InvoiceStatus;
-    status_message: string | null;
-    environment: Environment;
-    archive_enabled: boolean;
-    amount_charged: number | null;
-    created_at: DateTimeString;
-    validated_at: DateTimeString | null;
-    transmitted_at: DateTimeString | null;
-    completed_at: DateTimeString | null;
-    /** Date when the invoice was marked as paid (ISO 8601) */
-    paid_at: DateTimeString | null;
-    /** Payment reference (bank transfer ID, check number, etc.) */
-    payment_reference: string | null;
-    /** Optional note about the payment */
-    payment_note: string | null;
-}
-/**
- * Invoice line input for creation
- */
-interface InvoiceLineInput {
-    description: string;
-    quantity: number;
-    unit_price: number;
-    tax_rate: number;
-    total_ht: number;
-    total_tax: number;
-    total_ttc: number;
-}
-/**
- * Invoice creation input
- */
-interface CreateInvoiceInput {
-    /** Your external reference ID */
-    external_id?: string | undefined;
-    /** Invoice number (required) */
-    invoice_number: string;
-    /** Direction: outgoing (sale) or incoming (purchase) */
-    direction: InvoiceDirection;
-    /** Output format for electronic invoice */
-    output_format: InvoiceFormat;
-    /** Issue date (YYYY-MM-DD) */
-    issue_date: DateString;
-    /** Due date (YYYY-MM-DD) */
-    due_date?: DateString | undefined;
-    /** Currency code (default: EUR) */
-    currency?: CurrencyCode | undefined;
-    /** Total excluding tax */
-    total_ht: number;
-    /** Total tax amount */
-    total_tax: number;
-    /** Total including tax */
-    total_ttc: number;
-    /** Seller SIRET (14 digits) */
-    seller_siret: Siret;
-    /** Seller company name */
-    seller_name: string;
-    /** Seller address */
-    seller_address: Address;
-    /** Buyer SIRET (14 digits) */
-    buyer_siret: Siret;
-    /** Buyer company name */
-    buyer_name: string;
-    /** Buyer address */
-    buyer_address: Address;
-    /** Invoice line items */
-    lines: InvoiceLineInput[];
-    /** Enable 10-year archiving */
-    archive_enabled?: boolean | undefined;
-}
-/**
- * Invoice list filter options
- */
-interface InvoiceListOptions {
-    company_id?: UUID | undefined;
-    direction?: InvoiceDirection | undefined;
-    status?: InvoiceStatus | undefined;
-    environment?: Environment | undefined;
-    from?: DateString | undefined;
-    to?: DateString | undefined;
-    per_page?: number | undefined;
-}
-/**
- * Invoice conversion input
- */
-interface ConvertInvoiceInput {
-    invoice_id: UUID;
-    target_format: InvoiceFormat;
-}
-/**
- * Invoice download response
- */
-interface InvoiceDownloadResponse {
-    url: string;
-    expires_at: DateTimeString;
-}
-/**
- * Audit trail entry
- */
-interface AuditTrailEntry {
-    action: string;
-    details: string;
-    actor_ip: string | null;
-    created_at: DateTimeString;
-}
-/**
- * Audit trail response
- */
-interface AuditTrailResponse {
-    data: AuditTrailEntry[];
-    integrity_valid: boolean;
-}
-/**
- * Incoming invoice list filter options
- */
-interface IncomingInvoiceParams {
-    status?: InvoiceStatus | undefined;
-    seller_siret?: Siret | undefined;
-    from?: DateString | undefined;
-    to?: DateString | undefined;
-    min_amount?: number | undefined;
-    max_amount?: number | undefined;
-    page?: number | undefined;
-    per_page?: number | undefined;
-}
-/**
- * Rejection reason code for incoming invoices
- */
-type RejectionCode = 'incorrect_amount' | 'duplicate' | 'unknown_order' | 'incorrect_vat' | 'other';
-/**
- * Dispute type for incoming invoices
- */
-type DisputeType = 'amount_dispute' | 'quality_dispute' | 'delivery_dispute' | 'other';
-/**
- * Input for accepting an incoming invoice
- */
-interface AcceptInvoiceInput {
-    /** Expected payment date (YYYY-MM-DD) */
-    payment_date?: DateString | undefined;
-    /** Optional note about the acceptance */
-    note?: string | undefined;
-}
-/**
- * Input for rejecting an incoming invoice
- */
-interface RejectInvoiceInput {
-    /** Reason for rejection */
-    reason: string;
-    /** Standardized rejection code */
-    reason_code: RejectionCode;
-}
-/**
- * Input for disputing an incoming invoice
- */
-interface DisputeInvoiceInput {
-    /** Reason for the dispute */
-    reason: string;
-    /** Type of dispute */
-    dispute_type: DisputeType;
-    /** Expected correct amount (if amount dispute) */
-    expected_amount?: number | undefined;
-}
-/**
- * Input for marking an incoming invoice as paid
- */
-interface MarkPaidInput {
-    /** Payment reference (bank transfer ID, check number, etc.) */
-    payment_reference?: string | undefined;
-    /** Payment date (ISO 8601) - defaults to current date/time if not provided */
-    paid_at?: DateTimeString | undefined;
-    /** Optional note about the payment */
-    note?: string | undefined;
-}
-/**
- * Invoice file download format
- */
-type InvoiceFileFormat = 'pdf' | 'xml';
-
 /**
  * Invoices Resource
  *
@@ -1850,6 +3925,28 @@ declare class SignaturesResource {
      * ```
      */
     cancel(id: string, requestOptions?: RequestOptions): Promise<MessageResponse>;
+    /**
+     * Get signature audit trail (JSON)
+     *
+     * Returns the complete history of actions on the signature:
+     * creation, delivery, opening, signing, refusal, etc.
+     *
+     * @param id - Signature UUID
+     * @param requestOptions - Request options
+     * @returns Audit trail entries with integrity validation
+     *
+     * @example
+     * ```typescript
+     * const { data: entries, integrity_valid } = await client.signatures.auditTrail(
+     *   'signature-uuid'
+     * );
+     *
+     * if (integrity_valid) {
+     *   entries.forEach(e => console.log(e.action, e.created_at));
+     * }
+     * ```
+     */
+    auditTrail(id: string, requestOptions?: RequestOptions): Promise<AuditTrailResponse>;
 }
 
 /**
@@ -2410,7 +4507,7 @@ declare class ScellTimeoutError extends ScellError {
  *
  * @example
  * ```typescript
- * import { ScellClient, ScellApiClient, ScellAuth, ScellWebhooks } from '@scell/sdk';
+ * import { ScellClient, ScellApiClient, ScellTenantClient, ScellAuth, ScellWebhooks } from '@scell/sdk';
  *
  * // Dashboard client (Bearer token)
  * const auth = await ScellAuth.login({ email, password });
@@ -2419,9 +4516,15 @@ declare class ScellTimeoutError extends ScellError {
  * // API client (X-API-Key)
  * const apiClient = new ScellApiClient('your-api-key');
  *
+ * // Tenant client (X-Tenant-Key) - for multi-tenant operations
+ * const tenantClient = new ScellTenantClient('your-tenant-key');
+ *
  * // Create invoice
  * const invoice = await apiClient.invoices.create({...});
  *
+ * // Create direct invoice (tenant)
+ * const directInvoice = await tenantClient.directInvoices.create({...});
+ *
  * // Verify webhook
  * const isValid = await ScellWebhooks.verifySignature(payload, signature, secret);
  * ```
@@ -2518,10 +4621,24 @@ declare class ScellApiClient {
     readonly invoices: InvoicesResource;
     /** Signature operations (create, download, remind, cancel) */
     readonly signatures: SignaturesResource;
+    /** Sub-tenant management (provision, update, list) */
+    readonly subTenants: SubTenantsResource;
+    /** NF525 fiscal compliance (closings, FEC, attestation) */
+    readonly fiscal: FiscalResource;
+    /** Platform statistics */
+    readonly stats: StatsResource;
+    /** Platform billing (usage, top-up, transactions) */
+    readonly billing: BillingResource;
+    /** Credit notes operations (create, send, download) */
+    readonly creditNotes: TenantCreditNotesResource;
+    /** Tenant invoice operations (create, submit, update, delete) */
+    readonly tenantInvoices: TenantDirectInvoicesResource;
+    /** Incoming invoice operations (list, accept, reject) */
+    readonly incomingInvoices: TenantIncomingInvoicesResource;
     /**
      * Create a new Scell API Client
      *
-     * @param apiKey - Your API key (from dashboard)
+     * @param apiKey - Your API key (sk_live_xxx or sk_test_xxx)
      * @param config - Client configuration
      *
      * @example
@@ -2538,4 +4655,4 @@ declare class ScellApiClient {
     constructor(apiKey: string, config?: ClientConfig);
 }
 
-export { type AcceptInvoiceInput, type Address, type ApiErrorResponse, type ApiKey, type ApiKeyWithSecret, type AuditTrailEntry, type AuditTrailResponse, type AuthResponse, type Balance, type BalanceWebhookData, type ClientConfig, type Company, type CompanyStatus, type ConvertInvoiceInput, type CreateApiKeyInput, type CreateCompanyInput, type CreateInvoiceInput, type CreateSignatureInput, type CreateWebhookInput, type CurrencyCode, type DateRangeOptions, type DateString, type DateTimeString, type DisputeInvoiceInput, type DisputeType, type Environment, type ForgotPasswordInput, type IncomingInvoiceParams, type Invoice, type InvoiceDirection, type InvoiceDownloadResponse, type InvoiceDownloadType, type InvoiceFileFormat, type InvoiceFormat, type InvoiceIncomingPaidPayload, type InvoiceLine, type InvoiceLineInput, type InvoiceListOptions, type InvoiceParty, type InvoiceStatus, type InvoiceWebhookData, type KycInitiateResponse, type KycStatusResponse, type LoginCredentials, type MarkPaidInput, type MessageResponse, type MessageWithDataResponse, type PaginatedResponse, type PaginationMeta, type PaginationOptions, type RegisterInput, type RejectInvoiceInput, type RejectionCode, type ReloadBalanceInput, type ReloadBalanceResponse, type ResetPasswordInput, type RetryOptions, ScellApiClient, ScellAuth, ScellAuthenticationError, ScellAuthorizationError, ScellClient, ScellError, ScellInsufficientBalanceError, ScellNetworkError, ScellNotFoundError, ScellRateLimitError, ScellServerError, ScellTimeoutError, ScellValidationError, ScellWebhooks, type Signature, type SignatureDownloadResponse, type SignatureDownloadType, type SignatureListOptions, type SignaturePosition, type SignatureRemindResponse, type SignatureStatus, type SignatureUIConfig, type SignatureWebhookData, type Signer, type SignerAuthMethod, type SignerInput, type SignerStatus, type SingleResponse, type Siren, type Siret, type Transaction, type TransactionListOptions, type TransactionService, type TransactionType, type UUID, type UpdateBalanceSettingsInput, type UpdateCompanyInput, type UpdateWebhookInput, type User, type VerifySignatureOptions, type Webhook, type WebhookEvent, type WebhookListOptions, type WebhookLog, type WebhookPayload, type WebhookTestResponse, type WebhookWithSecret, createRetryWrapper, withRetry };
+export { type AcceptInvoiceInput, type Address, type ApiErrorResponse, type ApiKey, type ApiKeyWithSecret, type AuditTrailEntry, type AuditTrailResponse, type AuthResponse, type Balance, type BalanceWebhookData, type BillingInvoice, type BillingInvoiceLine, type BillingInvoiceListOptions, type BillingTopUpConfirmInput, type BillingTopUpInput, type BillingTransaction, type BillingTransactionListOptions, type BillingUsage, type BillingUsageOptions, type ClientConfig, type Company, type CompanyStatus, type ConvertInvoiceInput, type CreateApiKeyInput, type CreateCompanyInput, type CreateIncomingInvoiceParams, type CreateInvoiceInput, type CreateSignatureInput, type CreateSubTenantInput, type CreateTenantCreditNoteInput, type CreateTenantDirectCreditNoteParams, type CreateTenantDirectInvoiceParams, type CreateWebhookInput, type CurrencyCode, type DateRangeOptions, type DateString, type DateTimeString, type DisputeInvoiceInput, type DisputeType, type Environment, type FiscalAnchor, type FiscalAnchorsOptions, type FiscalAttestation, type FiscalAttestationStatus, type FiscalClosing, type FiscalClosingsOptions, type FiscalComplianceData, type FiscalComplianceStatus, type FiscalCreateRuleInput, type FiscalDailyClosingInput, type FiscalEntriesOptions, type FiscalEntry, type FiscalExportRulesOptions, type FiscalFecExportOptions, type FiscalFecExportResult, type FiscalForensicExportOptions, type FiscalForensicExportType, type FiscalIncident, type FiscalIntegrityCheck, type FiscalIntegrityHistoryOptions, type FiscalIntegrityOptions, type FiscalIntegrityReport, type FiscalKillSwitch, type FiscalKillSwitchActivateInput, type FiscalKillSwitchStatus, type FiscalReplayRulesInput, type FiscalRule, type FiscalRuleCategory, type FiscalRulesOptions, type FiscalUpdateRuleInput, type ForgotPasswordInput, type IncomingInvoiceParams, type Invoice, type InvoiceDirection, type InvoiceDownloadResponse, type InvoiceDownloadType, type InvoiceFileFormat, type InvoiceFormat, type InvoiceIncomingPaidPayload, type InvoiceLine, type InvoiceLineInput, type InvoiceListOptions, type InvoiceParty, type InvoiceStatus, type InvoiceWebhookData, type KycInitiateResponse, type KycStatusResponse, type LoginCredentials, type MarkPaidInput, type MessageResponse, type MessageWithDataResponse, type PaginatedResponse, type PaginationMeta, type PaginationOptions, type RegenerateKeyResult, type RegisterInput, type RejectInvoiceInput, type RejectionCode, type ReloadBalanceInput, type ReloadBalanceResponse, type RemainingCreditable, type RemainingCreditableLine, type ResetPasswordInput, type RetryOptions, ScellApiClient, ScellAuth, ScellAuthenticationError, ScellAuthorizationError, ScellClient, ScellError, ScellInsufficientBalanceError, ScellNetworkError, ScellNotFoundError, ScellRateLimitError, ScellServerError, ScellTenantClient, ScellTimeoutError, ScellValidationError, ScellWebhooks, type Signature, type SignatureDownloadResponse, type SignatureDownloadType, type SignatureListOptions, type SignaturePosition, type SignatureRemindResponse, type SignatureStatus, type SignatureUIConfig, type SignatureWebhookData, type Signer, type SignerAuthMethod, type SignerInput, type SignerStatus, type SingleResponse, type Siren, type Siret, type StatsMonthly, type StatsMonthlyOptions, type StatsOverview, type StatsOverviewOptions, type SubTenant, type SubTenantAddress, type SubTenantListOptions, type TenantAddress, type TenantBalance, type TenantCreditNote, type TenantCreditNoteFilters, type TenantCreditNoteItem, type TenantCreditNoteItemInput, type TenantCreditNoteListOptions, type TenantCreditNoteStatus, type TenantCreditNoteType, type TenantInvoice, type TenantInvoiceBuyer, type TenantInvoiceDirection, type TenantInvoiceFilters, type TenantInvoiceSeller, type TenantProfile, type TenantQuickStats, type Transaction, type TransactionListOptions, type TransactionService, type TransactionType, type UUID, type UpdateBalanceSettingsInput, type UpdateCompanyInput, type UpdateSubTenantInput, type UpdateTenantCreditNoteInput, type UpdateTenantCreditNoteParams, type UpdateTenantInvoiceParams, type UpdateTenantProfileInput, type UpdateWebhookInput, type User, type VerifySignatureOptions, type Webhook, type WebhookEvent, type WebhookListOptions, type WebhookLog, type WebhookPayload, type WebhookTestResponse, type WebhookWithSecret, createRetryWrapper, withRetry };