noxctl 0.8.0 → 0.10.0

package/dist/cli.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import { Command, Option } from 'commander';
+import { parsePositiveInteger } from './cli-validators.js';
 import { readFileSync, writeFileSync } from 'node:fs';
 import { createInterface } from 'node:readline/promises';
 import { isJsonMode, outputList, outputDetail, outputConfirmation, formatTaxReport, formatFinancialReport, errorEnvelope, } from './formatter.js';
@@ -8,7 +9,7 @@ import { setResolvedProfile } from './auth.js';
 import { applyPeriod } from './date-periods.js';
 import { DEFAULT_PROFILE, InvalidProfileNameError } from './profile-name.js';
 import { VERSION } from './version.js';
-import { invoiceListColumns, invoiceDetailColumns, invoiceConfirmColumns, customerListColumns, customerDetailColumns, voucherListColumns, voucherDetailColumns, voucherRowColumns, accountListColumns, companyDetailColumns, articleListColumns, articleDetailColumns, supplierListColumns, supplierDetailColumns, supplierInvoiceListColumns, supplierInvoiceDetailColumns, supplierInvoiceConfirmColumns, invoicePaymentListColumns, invoicePaymentDetailColumns, supplierInvoicePaymentListColumns, supplierInvoicePaymentDetailColumns, offerListColumns, offerDetailColumns, orderListColumns, orderDetailColumns, projectListColumns, projectDetailColumns, costCenterListColumns, costCenterDetailColumns, taxReductionListColumns, taxReductionDetailColumns, priceListListColumns, priceListDetailColumns, priceListColumns, priceDetailColumns, financialYearListColumns, financialYearDetailColumns, lockedPeriodDetailColumns, contractListColumns, contractDetailColumns, recurringListColumns, recurringDetailColumns, invoiceRequestListColumns, invoiceRequestDetailColumns, topCustomerColumns, monthlyRevenueColumns, voucherAttachmentColumns, employeeListColumns, employeeDetailColumns, salaryTransactionListColumns, salaryTransactionDetailColumns, attendanceTransactionListColumns, attendanceTransactionDetailColumns, absenceTransactionListColumns, absenceTransactionDetailColumns, scheduleTimeDetailColumns, } from './views.js';
+import { invoiceListColumns, invoiceDetailColumns, invoiceConfirmColumns, invoiceAttachmentColumns, invoiceAttachmentListColumns, customerListColumns, customerDetailColumns, voucherListColumns, voucherDetailColumns, voucherRowColumns, accountListColumns, companyDetailColumns, articleListColumns, articleDetailColumns, supplierListColumns, supplierDetailColumns, supplierInvoiceListColumns, supplierInvoiceDetailColumns, supplierInvoiceConfirmColumns, supplierInvoiceAttachmentColumns, invoicePaymentListColumns, invoicePaymentDetailColumns, supplierInvoicePaymentListColumns, supplierInvoicePaymentDetailColumns, offerListColumns, offerDetailColumns, offerConfirmColumns, orderListColumns, orderDetailColumns, orderConfirmColumns, projectListColumns, projectDetailColumns, costCenterListColumns, costCenterDetailColumns, taxReductionListColumns, taxReductionDetailColumns, priceListListColumns, priceListDetailColumns, priceListColumns, priceDetailColumns, financialYearListColumns, financialYearDetailColumns, lockedPeriodDetailColumns, contractListColumns, contractDetailColumns, recurringListColumns, recurringDetailColumns, invoiceRequestListColumns, invoiceRequestDetailColumns, topCustomerColumns, monthlyRevenueColumns, voucherAttachmentColumns, employeeListColumns, employeeDetailColumns, salaryTransactionListColumns, salaryTransactionDetailColumns, attendanceTransactionListColumns, attendanceTransactionDetailColumns, absenceTransactionListColumns, absenceTransactionDetailColumns, scheduleTimeDetailColumns, referenceDataColumns, generalLedgerColumns, } from './views.js';
 const program = new Command();
 // A closed downstream pipe (`noxctl ... | head`, or a reader that exits early)
 // makes stdout emit EPIPE. That is normal for a CLI, and without this listener
@@ -199,15 +200,23 @@ program
     .option('--profile <name>', 'Profile to create/re-auth (defaults to resolved profile or "default")')
     .option('--with-salary', 'Also request the Lön (salary/payroll) scope — requires the Lön permission enabled on your Fortnox app')
     .option('--with-orders', 'Also request the offer/order scopes — requires the Order licence on the Fortnox company')
+    .option('--with-archive', 'Also request the archive (Arkivplats) scope — lets noxctl read files from the Fortnox file archive, e.g. attachments made via the Fortnox web UI')
     .action(async (initOpts) => {
-    const { inspectCredentials, runOAuthSetup, SCOPES, SALARY_SCOPE, ORDER_SCOPES } = await import('./auth.js');
+    const { inspectCredentials, runOAuthSetup, SCOPES, SALARY_SCOPE, ORDER_SCOPES, ARCHIVE_SCOPE, } = await import('./auth.js');
     const { validateProfileName } = await import('./profile-name.js');
-    // Opt-in scopes: flag for TTY, env var for non-interactive/CI runs. Both are
-    // licence-gated in Fortnox (Lön / Order), and asking for a scope the company
-    // is not licensed for fails the whole authorization — hence not defaults.
+    // Opt-in scopes: flag for TTY, env var for non-interactive/CI runs. All are
+    // licence-gated in Fortnox (Lön / Order / Arkivplats), and asking for a scope
+    // the company is not licensed for fails the whole authorization — hence not
+    // defaults.
     const withSalary = Boolean(initOpts.withSalary) || process.env.FORTNOX_WITH_SALARY === '1';
     const withOrders = Boolean(initOpts.withOrders) || process.env.FORTNOX_WITH_ORDERS === '1';
-    const scopes = [SCOPES, withOrders ? ORDER_SCOPES : '', withSalary ? SALARY_SCOPE : '']
+    const withArchive = Boolean(initOpts.withArchive) || process.env.FORTNOX_WITH_ARCHIVE === '1';
+    const scopes = [
+        SCOPES,
+        withOrders ? ORDER_SCOPES : '',
+        withSalary ? SALARY_SCOPE : '',
+        withArchive ? ARCHIVE_SCOPE : '',
+    ]
         .filter(Boolean)
         .join(' ');
     let targetProfile;
@@ -1039,9 +1048,9 @@ keychain
     console.log(`Deleted ${deleted} login-keychain entr${deleted === 1 ? 'y' : 'ies'}.`);
     console.log('Credentials now live only in the YubiKey-locked keychain.');
 });
-// --- serve (default command) ---
+// --- serve ---
 program
-    .command('serve', { isDefault: true })
+    .command('serve')
     .description('Start the MCP server (stdio transport)')
     .action(async () => {
     const { startMcpServer } = await import('./index.js');
@@ -1149,6 +1158,51 @@ invoices
     const data = await sendInvoice(documentNumber, opts.method, emailOptions);
     outputConfirmation(`Invoice ${documentNumber} sent via ${opts.method}.`, json(), data, invoiceConfirmColumns, 'Invoice');
 });
+for (const action of [
+    { command: 'cancel', label: 'Cancel', exportName: 'cancelInvoice' },
+    { command: 'eprint', label: 'Send via e-print', exportName: 'eprintInvoice' },
+    {
+        command: 'external-print',
+        label: 'Mark as externally printed',
+        exportName: 'externalPrintInvoice',
+    },
+]) {
+    invoices
+        .command(`${action.command} <documentNumber>`)
+        .description(`${action.label} an invoice`)
+        .option('-y, --yes', 'Skip confirmation prompt')
+        .option('--dry-run', 'Preview the action without sending it')
+        .action(async (documentNumber, opts) => {
+        const operations = await import('./operations/invoices.js');
+        if (!(await confirmMutation(`${action.label} invoice ${documentNumber}`, opts)))
+            return;
+        const data = await operations[action.exportName](documentNumber);
+        outputConfirmation(`Invoice ${documentNumber}: ${action.command} completed.`, json(), data, invoiceConfirmColumns, 'Invoice');
+    });
+}
+invoices
+    .command('reminder-pdf <documentNumber>')
+    .description('Print an invoice reminder and save the returned PDF')
+    .option('-f, --file <path>', 'Write the PDF here')
+    .option('--overwrite', 'Allow replacing an existing regular file')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the action without sending it')
+    .action(async (documentNumber, opts) => {
+    const { getInvoiceReminderPdf } = await import('./operations/invoices.js');
+    if (!(await confirmMutation(`Print reminder for invoice ${documentNumber}`, opts)))
+        return;
+    const pdf = await getInvoiceReminderPdf(documentNumber);
+    if (!pdf) {
+        outputConfirmation(`Invoice reminder ${documentNumber} printed without a PDF response.`, json(), {});
+        return;
+    }
+    const { writeBinaryFile } = await import('./safe-file-output.js');
+    const path = writeBinaryFile(opts.file ?? `invoice-reminder-${documentNumber}.pdf`, pdf, opts.overwrite);
+    outputConfirmation(`Invoice reminder saved to ${path}.`, json(), {
+        Path: path,
+        Bytes: pdf.length,
+    });
+});
 invoices
     .command('pdf <documentNumber>')
     .description('Download an invoice as a PDF')
@@ -1280,6 +1334,47 @@ invoices
     const data = await creditInvoice(documentNumber);
     outputConfirmation(`Invoice ${documentNumber} credited.`, json(), data, invoiceConfirmColumns, 'Invoice');
 });
+invoices
+    .command('attach <documentNumber> <files...>')
+    .description('Upload receipt/underlag files and attach them to a customer invoice')
+    .option('--no-include-on-send', 'Do not bundle the file when the invoice is sent (default: bundled)')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview without uploading')
+    .addHelpText('after', `
+Requires the "archive" scope — run \`noxctl init --with-archive\` first if
+\`noxctl doctor\` reports it missing.
+
+Examples:
+  noxctl invoices attach 91110646 underlag.pdf
+  noxctl invoices attach 91110646 underlag.pdf --no-include-on-send`)
+    .action(async (documentNumber, files, opts) => {
+    const { attachInvoiceFiles } = await import('./operations/invoices.js');
+    if (!(await confirmMutation(`Attach ${files.length} file(s) to invoice ${documentNumber}`, opts, {
+        files,
+        includeOnSend: opts.includeOnSend ?? true,
+    }))) {
+        return;
+    }
+    const results = await attachInvoiceFiles({
+        documentNumber,
+        filePaths: files,
+        includeOnSend: opts.includeOnSend,
+    });
+    if (json()) {
+        console.log(JSON.stringify({ Attachments: results }, null, 2));
+    }
+    else {
+        outputList(results, invoiceAttachmentColumns, false, results);
+    }
+});
+invoices
+    .command('attachments <documentNumber>')
+    .description('List files attached to a customer invoice')
+    .action(async (documentNumber) => {
+    const { listInvoiceAttachments } = await import('./operations/invoices.js');
+    const results = await listInvoiceAttachments(documentNumber);
+    outputList(results, invoiceAttachmentListColumns, json(), { Attachments: results });
+});
 // --- tax ---
 const tax = program.command('tax').description('Tax operations');
 tax
@@ -1369,6 +1464,59 @@ accounts
     });
     outputList(data.Accounts ?? [], accountListColumns, json(), data, data.MetaInformation);
 });
+accounts
+    .command('get <number>')
+    .description('Get one account')
+    .action(async (number) => {
+    const { getAccount } = await import('./operations/accounts.js');
+    const data = await getAccount(Number(number));
+    outputDetail(data, accountListColumns, json(), 'Account');
+});
+accounts
+    .command('create')
+    .description('Create an account')
+    .requiredOption('--number <number>', 'Account number', parseInt)
+    .requiredOption('--description <text>', 'Account description')
+    .option('--input <file>', 'Additional account data as JSON file (or - for stdin)')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the request without sending it')
+    .action(async (opts) => {
+    const { createAccount } = await import('./operations/accounts.js');
+    const extra = opts.input
+        ? JSON.parse(opts.input === '-' ? readFileSync(0, 'utf-8') : readFileSync(opts.input, 'utf-8'))
+        : {};
+    const fields = { ...extra, Number: opts.number, Description: opts.description };
+    if (!(await confirmMutation(`Create account ${opts.number}`, opts, { Account: fields })))
+        return;
+    const data = await createAccount(fields);
+    outputDetail(data, accountListColumns, json(), 'Account');
+});
+accounts
+    .command('update <number>')
+    .description('Update an account')
+    .requiredOption('--input <file>', 'Account data as JSON file (or - for stdin)')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the request without sending it')
+    .action(async (number, opts) => {
+    const { updateAccount } = await import('./operations/accounts.js');
+    const fields = JSON.parse(opts.input === '-' ? readFileSync(0, 'utf-8') : readFileSync(opts.input, 'utf-8'));
+    if (!(await confirmMutation(`Update account ${number}`, opts, { Account: fields })))
+        return;
+    const data = await updateAccount(Number(number), fields);
+    outputDetail(data, accountListColumns, json(), 'Account');
+});
+accounts
+    .command('delete <number>')
+    .description('Delete an account')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the request without sending it')
+    .action(async (number, opts) => {
+    const { deleteAccount } = await import('./operations/accounts.js');
+    if (!(await confirmMutation(`Delete account ${number}`, opts)))
+        return;
+    await deleteAccount(Number(number));
+    outputConfirmation(`Account ${number} deleted.`, json(), { Number: Number(number), deleted: true }, undefined, 'Account');
+});
 // --- customers ---
 const customers = program.command('customers').description('Customer operations');
 customers
@@ -1430,7 +1578,7 @@ customers
     .option('--dry-run', 'Preview the request without sending it')
     .addHelpText('after', `
 Examples:
-  echo '{"Email":"new@acme.se","Phone":"08-123456"}' | noxctl customers update 25 --input - --yes`)
+  echo '{"Email":"new@acme.se","Phone1":"08-123456"}' | noxctl customers update 25 --input - --yes`)
     .action(async (customerNumber, opts) => {
     const { updateCustomer } = await import('./operations/customers.js');
     const raw = opts.input === '-' ? readFileSync(0, 'utf-8') : readFileSync(opts.input, 'utf-8');
@@ -1441,6 +1589,18 @@ Examples:
     const data = await updateCustomer(customerNumber, fields);
     outputDetail(data, customerDetailColumns, json(), 'Customer');
 });
+customers
+    .command('delete <customerNumber>')
+    .description('Delete a customer')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the request without sending it')
+    .action(async (customerNumber, opts) => {
+    const { deleteCustomer } = await import('./operations/customers.js');
+    if (!(await confirmMutation(`Delete customer ${customerNumber}`, opts)))
+        return;
+    await deleteCustomer(customerNumber);
+    outputConfirmation(`Customer ${customerNumber} deleted.`, json(), { CustomerNumber: customerNumber, deleted: true }, undefined, 'Customer');
+});
 // --- articles ---
 const articles = program.command('articles').description('Article operations');
 articles
@@ -1516,6 +1676,18 @@ Examples:
     const data = await updateArticle(articleNumber, fields);
     outputDetail(data, articleDetailColumns, json(), 'Article');
 });
+articles
+    .command('delete <articleNumber>')
+    .description('Delete an article')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the request without sending it')
+    .action(async (articleNumber, opts) => {
+    const { deleteArticle } = await import('./operations/articles.js');
+    if (!(await confirmMutation(`Delete article ${articleNumber}`, opts)))
+        return;
+    await deleteArticle(articleNumber);
+    outputConfirmation(`Article ${articleNumber} deleted.`, json(), { ArticleNumber: articleNumber, deleted: true }, undefined, 'Article');
+});
 // --- suppliers ---
 const suppliers = program.command('suppliers').description('Supplier operations');
 suppliers
@@ -1596,7 +1768,7 @@ const supplierInvoices = program
 supplierInvoices
     .command('list')
     .description('List/filter supplier invoices')
-    .option('--filter <filter>', 'Filter: cancelled, fullypaid, unpaid, unpaidoverdue, unbooked, pendingpayment')
+    .option('--filter <filter>', 'Filter: cancelled, fullypaid, unpaid, unpaidoverdue, unbooked, pendingpayment, authorizepending')
     .option('--supplier <number>', 'Filter by supplier number')
     .option('--from <date>', 'From date (YYYY-MM-DD)')
     .option('--to <date>', 'To date (YYYY-MM-DD)')
@@ -1661,6 +1833,98 @@ supplierInvoices
     const data = await bookkeepSupplierInvoice(givenNumber);
     outputConfirmation(`Supplier invoice ${givenNumber} bookkeept.`, json(), data, supplierInvoiceConfirmColumns, 'SupplierInvoice');
 });
+supplierInvoices
+    .command('update <givenNumber>')
+    .description('Update a supplier invoice')
+    .requiredOption('--input <file>', 'Invoice data as JSON file (or - for stdin)')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the request without sending it')
+    .action(async (givenNumber, opts) => {
+    const { updateSupplierInvoice } = await import('./operations/supplier-invoices.js');
+    const raw = opts.input === '-' ? readFileSync(0, 'utf-8') : readFileSync(opts.input, 'utf-8');
+    const fields = JSON.parse(raw);
+    if (!(await confirmMutation(`Update supplier invoice ${givenNumber}`, opts, {
+        SupplierInvoice: fields,
+    })))
+        return;
+    const data = await updateSupplierInvoice(givenNumber, fields);
+    outputDetail(data, supplierInvoiceDetailColumns, json(), 'SupplierInvoice');
+});
+for (const action of [
+    {
+        command: 'approval-bookkeep',
+        label: 'Approval-bookkeep',
+        exportName: 'approvalBookkeepSupplierInvoice',
+    },
+    {
+        command: 'approval-payment',
+        label: 'Payment-approve',
+        exportName: 'approvalPaymentSupplierInvoice',
+    },
+    { command: 'cancel', label: 'Cancel', exportName: 'cancelSupplierInvoice' },
+    { command: 'credit', label: 'Credit', exportName: 'creditSupplierInvoice' },
+]) {
+    supplierInvoices
+        .command(`${action.command} <givenNumber>`)
+        .description(`${action.label} a supplier invoice`)
+        .option('-y, --yes', 'Skip confirmation prompt')
+        .option('--dry-run', 'Preview the action without sending it')
+        .action(async (givenNumber, opts) => {
+        const operations = await import('./operations/supplier-invoices.js');
+        if (!(await confirmMutation(`${action.label} supplier invoice ${givenNumber}`, opts)))
+            return;
+        const data = await operations[action.exportName](givenNumber);
+        outputConfirmation(`Supplier invoice ${givenNumber}: ${action.command} completed.`, json(), data, supplierInvoiceConfirmColumns, 'SupplierInvoice');
+    });
+}
+supplierInvoices
+    .command('attachments <givenNumber>')
+    .description('List files (e.g. the scanned/received invoice) attached to a supplier invoice — works for unbooked/authorizepending invoices too')
+    .action(async (givenNumber) => {
+    const { listSupplierInvoiceAttachments } = await import('./operations/supplier-invoices.js');
+    const attachments = await listSupplierInvoiceAttachments(givenNumber);
+    if (json()) {
+        console.log(JSON.stringify({ Attachments: attachments }, null, 2));
+    }
+    else {
+        outputList(attachments, supplierInvoiceAttachmentColumns, false, attachments);
+    }
+});
+supplierInvoices
+    .command('file <fileId>')
+    .description('Download a file attached to a supplier invoice (get the fileId from "supplier-invoices attachments")')
+    .option('-f, --file <path>', 'Write the file here (- for stdout; default: supplier-invoice-file-<fileId><ext>)')
+    .option('--overwrite', 'Allow replacing an existing regular file')
+    .addHelpText('after', `
+Examples:
+  noxctl supplier-invoices attachments 1
+  noxctl supplier-invoices file c7e578d8-59a7-4e00-b29b-b99e4d9ede63
+  noxctl supplier-invoices file c7e578d8-59a7-4e00-b29b-b99e4d9ede63 --file invoice-scan.pdf`)
+    .action(async (fileId, opts) => {
+    const { getSupplierInvoiceFile } = await import('./operations/supplier-invoices.js');
+    const { extensionForMime } = await import('./operations/vouchers.js');
+    const { safeLocalOutputPath, writeBinaryFile } = await import('./safe-file-output.js');
+    const toStdout = opts.file === '-';
+    if (toStdout && program.opts().output === 'json') {
+        throw new Error('--file - writes raw file bytes to stdout and cannot be combined with --output json.');
+    }
+    const file = await getSupplierInvoiceFile(fileId);
+    if (toStdout) {
+        await new Promise((resolve, reject) => {
+            process.stdout.write(file.buffer, (err) => (err ? reject(err) : resolve()));
+        });
+        return;
+    }
+    const path = opts.file ??
+        safeLocalOutputPath('supplier-invoice-file-', fileId, extensionForMime(file.contentType));
+    const savedPath = writeBinaryFile(path, file.buffer, opts.overwrite);
+    outputConfirmation(`File saved to ${savedPath} (${file.contentType}, ${file.buffer.length} bytes).`, json(), {
+        FileId: fileId,
+        Path: savedPath,
+        ContentType: file.contentType,
+        Bytes: file.buffer.length,
+    });
+});
 // --- company ---
 const company = program.command('company').description('Company operations');
 company
@@ -1765,6 +2029,138 @@ Examples:
         outputList(results, voucherAttachmentColumns, false, results);
     }
 });
+vouchers
+    .command('attachments <series> <voucherNumber>')
+    .description('List files (receipts/underlag) attached to a voucher')
+    .option('--year <number>', 'Financial year (recommended — voucher numbers reset between financial years)', parseInt)
+    .action(async (series, voucherNumber, opts) => {
+    const { listVoucherAttachments } = await import('./operations/vouchers.js');
+    const attachments = await listVoucherAttachments(series, voucherNumber, opts.year);
+    if (json()) {
+        console.log(JSON.stringify({ Attachments: attachments }, null, 2));
+    }
+    else {
+        outputList(attachments, voucherAttachmentColumns, false, attachments);
+    }
+});
+vouchers
+    .command('file <fileId>')
+    .description('Download a file attached to a voucher (get the fileId from "vouchers attachments")')
+    .option('-f, --file <path>', 'Write the file here (- for stdout; default: voucher-file-<fileId><ext>)')
+    .addHelpText('after', `
+Examples:
+  noxctl vouchers attachments A 60 --year 4
+  noxctl vouchers file c7e578d8-59a7-4e00-b29b-b99e4d9ede63
+  noxctl vouchers file c7e578d8-59a7-4e00-b29b-b99e4d9ede63 --file receipt.pdf`)
+    .action(async (fileId, opts) => {
+    const { getVoucherFile, extensionForMime } = await import('./operations/vouchers.js');
+    const toStdout = opts.file === '-';
+    if (toStdout && program.opts().output === 'json') {
+        throw new Error('--file - writes raw file bytes to stdout and cannot be combined with --output json.');
+    }
+    const file = await getVoucherFile(fileId);
+    if (toStdout) {
+        await new Promise((resolve, reject) => {
+            process.stdout.write(file.buffer, (err) => (err ? reject(err) : resolve()));
+        });
+        return;
+    }
+    const path = opts.file ?? `voucher-file-${fileId}${extensionForMime(file.contentType)}`;
+    writeFileSync(path, file.buffer);
+    outputConfirmation(`File saved to ${path} (${file.contentType}, ${file.buffer.length} bytes).`, json(), {
+        FileId: fileId,
+        Path: path,
+        ContentType: file.contentType,
+        Bytes: file.buffer.length,
+    });
+});
+vouchers
+    .command('connection <fileId>')
+    .description('Get voucher file-connection metadata')
+    .action(async (fileId) => {
+    const { getVoucherFileConnection } = await import('./operations/vouchers.js');
+    const result = await getVoucherFileConnection(fileId);
+    outputDetail(result, voucherAttachmentColumns, json(), 'VoucherFileConnection');
+});
+vouchers
+    .command('detach <fileId>')
+    .description('Detach a file from its voucher')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview without detaching')
+    .action(async (fileId, opts) => {
+    const { deleteVoucherFileConnection } = await import('./operations/vouchers.js');
+    if (!(await confirmMutation(`Delete voucher file connection ${fileId}`, opts)))
+        return;
+    await deleteVoucherFileConnection(fileId);
+    outputConfirmation(`Voucher file connection ${fileId} deleted.`, json(), {
+        FileId: fileId,
+        detached: true,
+    });
+});
+supplierInvoices
+    .command('connection <fileId>')
+    .description('Get supplier-invoice file-connection metadata')
+    .action(async (fileId) => {
+    const { getSupplierInvoiceFileConnection } = await import('./operations/supplier-invoices.js');
+    const result = await getSupplierInvoiceFileConnection(fileId);
+    outputDetail(result, supplierInvoiceAttachmentColumns, json(), 'SupplierInvoiceFileConnection');
+});
+supplierInvoices
+    .command('connect-file <givenNumber> <fileId>')
+    .description('Connect an existing inbox file to a supplier invoice')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview exact payload')
+    .action(async (givenNumber, fileId, opts) => {
+    const payload = { SupplierInvoiceNumber: givenNumber, FileId: fileId };
+    if (!(await confirmMutation(`Connect file ${fileId} to supplier invoice ${givenNumber}`, opts, {
+        SupplierInvoiceFileConnection: payload,
+    })))
+        return;
+    const { createSupplierInvoiceFileConnection } = await import('./operations/supplier-invoices.js');
+    const result = await createSupplierInvoiceFileConnection(givenNumber, fileId);
+    outputDetail(result, supplierInvoiceAttachmentColumns, json(), 'SupplierInvoiceFileConnection');
+});
+supplierInvoices
+    .command('detach-file <fileId>')
+    .description('Detach a file from a supplier invoice')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview without detaching')
+    .action(async (fileId, opts) => {
+    const { deleteSupplierInvoiceFileConnection } = await import('./operations/supplier-invoices.js');
+    if (!(await confirmMutation(`Delete supplier invoice file connection ${fileId}`, opts)))
+        return;
+    await deleteSupplierInvoiceFileConnection(fileId);
+    outputConfirmation(`Supplier invoice file connection ${fileId} deleted.`, json(), {
+        FileId: fileId,
+        detached: true,
+    });
+});
+// --- general-ledger ---
+const generalLedger = program
+    .command('general-ledger')
+    .alias('ledger')
+    .description('Bookkeeping transaction list with amounts, via Fortnox’s SIE export — fast even for a full year, unlike walking vouchers one by one');
+generalLedger
+    .command('list')
+    .description('List bookkeeping transactions for a date range, one row per posting')
+    .requiredOption('--from <date>', 'From date (YYYY-MM-DD)')
+    .requiredOption('--to <date>', 'To date (YYYY-MM-DD)')
+    .option('--year <number>', 'Financial year (optional; resolved automatically from --from otherwise)', parsePositiveInteger)
+    .option('--account <number>', 'Filter to one account number')
+    .option('--series <code>', 'Filter to one voucher series (e.g. "A")')
+    .action(async (opts) => {
+    const { getGeneralLedger } = await import('./operations/general-ledger.js');
+    let rows = await getGeneralLedger({
+        fromDate: opts.from,
+        toDate: opts.to,
+        financialYear: opts.year,
+    });
+    if (opts.account)
+        rows = rows.filter((r) => r.account === opts.account);
+    if (opts.series)
+        rows = rows.filter((r) => r.series === opts.series);
+    outputList(rows, generalLedgerColumns, json(), rows);
+});
 // --- invoice-payments ---
 const invoicePayments = program
     .command('invoice-payments')
@@ -1849,6 +2245,23 @@ invoicePayments
     const result = await bookkeepInvoicePayment(paymentNumber);
     outputConfirmation(`Invoice payment ${paymentNumber} bookkeept.`, json(), result, undefined, 'InvoicePayment');
 });
+invoicePayments
+    .command('update <paymentNumber>')
+    .description('Update an invoice payment')
+    .requiredOption('--input <file>', 'Payment data as JSON file (or - for stdin)')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the request without sending it')
+    .action(async (paymentNumber, opts) => {
+    const { updateInvoicePayment } = await import('./operations/invoice-payments.js');
+    const raw = opts.input === '-' ? readFileSync(0, 'utf-8') : readFileSync(opts.input, 'utf-8');
+    const fields = JSON.parse(raw);
+    if (!(await confirmMutation(`Update invoice payment ${paymentNumber}`, opts, {
+        InvoicePayment: fields,
+    })))
+        return;
+    const data = await updateInvoicePayment(paymentNumber, fields);
+    outputDetail(data, invoicePaymentDetailColumns, json(), 'InvoicePayment');
+});
 // --- supplier-invoice-payments ---
 const supplierInvoicePayments = program
     .command('supplier-invoice-payments')
@@ -1918,6 +2331,35 @@ supplierInvoicePayments
     await deleteSupplierInvoicePayment(paymentNumber);
     outputConfirmation(`Supplier invoice payment ${paymentNumber} deleted.`, json(), { Number: paymentNumber, deleted: true }, undefined, 'SupplierInvoicePayment');
 });
+supplierInvoicePayments
+    .command('update <paymentNumber>')
+    .description('Update a supplier invoice payment')
+    .requiredOption('--input <file>', 'Payment data as JSON file (or - for stdin)')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the request without sending it')
+    .action(async (paymentNumber, opts) => {
+    const { updateSupplierInvoicePayment } = await import('./operations/supplier-invoice-payments.js');
+    const raw = opts.input === '-' ? readFileSync(0, 'utf-8') : readFileSync(opts.input, 'utf-8');
+    const fields = JSON.parse(raw);
+    if (!(await confirmMutation(`Update supplier invoice payment ${paymentNumber}`, opts, {
+        SupplierInvoicePayment: fields,
+    })))
+        return;
+    const data = await updateSupplierInvoicePayment(paymentNumber, fields);
+    outputDetail(data, supplierInvoicePaymentDetailColumns, json(), 'SupplierInvoicePayment');
+});
+supplierInvoicePayments
+    .command('bookkeep <paymentNumber>')
+    .description('Bookkeep a supplier invoice payment')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the action without sending it')
+    .action(async (paymentNumber, opts) => {
+    const { bookkeepSupplierInvoicePayment } = await import('./operations/supplier-invoice-payments.js');
+    if (!(await confirmMutation(`Bookkeep supplier invoice payment ${paymentNumber}`, opts)))
+        return;
+    const data = await bookkeepSupplierInvoicePayment(paymentNumber);
+    outputConfirmation(`Supplier invoice payment ${paymentNumber} bookkeept.`, json(), data, undefined, 'SupplierInvoicePayment');
+});
 // --- offers ---
 const offers = program.command('offers').description('Offer/quote operations (offerter)');
 offers
@@ -2017,6 +2459,56 @@ offers
     const data = await createOrderFromOffer(documentNumber);
     outputConfirmation(`Order created from offer ${documentNumber}.`, json(), data, undefined, 'Order');
 });
+for (const action of [
+    { command: 'cancel', label: 'Cancel', exportName: 'cancelOffer' },
+    { command: 'email', label: 'Email', exportName: 'emailOffer' },
+    {
+        command: 'external-print',
+        label: 'Mark as externally printed',
+        exportName: 'externalPrintOffer',
+    },
+]) {
+    offers
+        .command(`${action.command} <documentNumber>`)
+        .description(`${action.label} an offer`)
+        .option('-y, --yes', 'Skip confirmation prompt')
+        .option('--dry-run', 'Preview the action without sending it')
+        .action(async (documentNumber, opts) => {
+        const operations = await import('./operations/offers.js');
+        if (!(await confirmMutation(`${action.label} offer ${documentNumber}`, opts)))
+            return;
+        const data = await operations[action.exportName](documentNumber);
+        outputConfirmation(`Offer ${documentNumber}: ${action.command} completed.`, json(), data, offerConfirmColumns, 'Offer');
+    });
+}
+offers
+    .command('pdf <documentNumber>')
+    .description('Download or print an offer as PDF')
+    .option('-f, --file <path>', 'Write the PDF here')
+    .option('--print', 'Use the state-changing Fortnox print action')
+    .option('--overwrite', 'Allow replacing an existing regular file')
+    .option('-y, --yes', 'Skip confirmation prompt (required with --print)')
+    .option('--dry-run', 'Preview the action without sending it')
+    .action(async (documentNumber, opts) => {
+    const mode = opts.print ? 'print' : 'preview';
+    if (opts.print || opts.dryRun) {
+        if (!(await confirmMutation(`${mode} offer ${documentNumber} as PDF`, opts)))
+            return;
+    }
+    const { getOfferPdf } = await import('./operations/offers.js');
+    const pdf = await getOfferPdf(documentNumber, mode);
+    if (!pdf) {
+        outputConfirmation(`Offer ${documentNumber} printed without a PDF response.`, json(), {});
+        return;
+    }
+    const { writeBinaryFile } = await import('./safe-file-output.js');
+    const path = writeBinaryFile(opts.file ?? `offer-${documentNumber}.pdf`, pdf, opts.overwrite);
+    outputConfirmation(`Offer PDF saved to ${path}.`, json(), {
+        Path: path,
+        Bytes: pdf.length,
+        Mode: mode,
+    });
+});
 // --- orders ---
 const orders = program.command('orders').description('Order operations (ordrar)');
 orders
@@ -2103,6 +2595,56 @@ orders
     const data = await createInvoiceFromOrder(documentNumber);
     outputConfirmation(`Invoice created from order ${documentNumber}.`, json(), data, invoiceConfirmColumns, 'Invoice');
 });
+for (const action of [
+    { command: 'cancel', label: 'Cancel', exportName: 'cancelOrder' },
+    { command: 'email', label: 'Email', exportName: 'emailOrder' },
+    {
+        command: 'external-print',
+        label: 'Mark as externally printed',
+        exportName: 'externalPrintOrder',
+    },
+]) {
+    orders
+        .command(`${action.command} <documentNumber>`)
+        .description(`${action.label} an order`)
+        .option('-y, --yes', 'Skip confirmation prompt')
+        .option('--dry-run', 'Preview the action without sending it')
+        .action(async (documentNumber, opts) => {
+        const operations = await import('./operations/orders.js');
+        if (!(await confirmMutation(`${action.label} order ${documentNumber}`, opts)))
+            return;
+        const data = await operations[action.exportName](documentNumber);
+        outputConfirmation(`Order ${documentNumber}: ${action.command} completed.`, json(), data, orderConfirmColumns, 'Order');
+    });
+}
+orders
+    .command('pdf <documentNumber>')
+    .description('Download or print an order as PDF')
+    .option('-f, --file <path>', 'Write the PDF here')
+    .option('--print', 'Use the state-changing Fortnox print action')
+    .option('--overwrite', 'Allow replacing an existing regular file')
+    .option('-y, --yes', 'Skip confirmation prompt (required with --print)')
+    .option('--dry-run', 'Preview the action without sending it')
+    .action(async (documentNumber, opts) => {
+    const mode = opts.print ? 'print' : 'preview';
+    if (opts.print || opts.dryRun) {
+        if (!(await confirmMutation(`${mode} order ${documentNumber} as PDF`, opts)))
+            return;
+    }
+    const { getOrderPdf } = await import('./operations/orders.js');
+    const pdf = await getOrderPdf(documentNumber, mode);
+    if (!pdf) {
+        outputConfirmation(`Order ${documentNumber} printed without a PDF response.`, json(), {});
+        return;
+    }
+    const { writeBinaryFile } = await import('./safe-file-output.js');
+    const path = writeBinaryFile(opts.file ?? `order-${documentNumber}.pdf`, pdf, opts.overwrite);
+    outputConfirmation(`Order PDF saved to ${path}.`, json(), {
+        Path: path,
+        Bytes: pdf.length,
+        Mode: mode,
+    });
+});
 // --- projects ---
 const projects = program.command('projects').description('Project operations');
 projects
@@ -2172,6 +2714,21 @@ projects
     const data = await updateProject(projectNumber, fields);
     outputDetail(data, projectDetailColumns, json(), 'Project');
 });
+projects
+    .command('delete <projectNumber>')
+    .description('Delete a project')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the action without sending it')
+    .action(async (projectNumber, opts) => {
+    const { deleteProject } = await import('./operations/projects.js');
+    if (!(await confirmMutation(`Delete project ${projectNumber}`, opts)))
+        return;
+    await deleteProject(projectNumber);
+    outputConfirmation(`Project ${projectNumber} deleted.`, json(), {
+        ProjectNumber: projectNumber,
+        deleted: true,
+    });
+});
 // --- cost centers ---
 const costcenters = program.command('costcenters').description('Cost center operations');
 costcenters
@@ -2423,6 +2980,23 @@ salarytransactions
     await deleteSalaryTransaction(salaryRow);
     outputConfirmation(`Salary transaction ${salaryRow} deleted.`, json(), { SalaryRow: salaryRow, deleted: true }, undefined, 'SalaryTransaction');
 });
+salarytransactions
+    .command('update <salaryRow>')
+    .description('Update a salary transaction')
+    .requiredOption('--input <file>', 'Transaction data as JSON file (or - for stdin)')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the request without sending it')
+    .action(async (salaryRow, opts) => {
+    const { updateSalaryTransaction } = await import('./operations/salarytransactions.js');
+    const raw = opts.input === '-' ? readFileSync(0, 'utf-8') : readFileSync(opts.input, 'utf-8');
+    const fields = JSON.parse(raw);
+    if (!(await confirmMutation(`Update salary transaction ${salaryRow}`, opts, {
+        SalaryTransaction: fields,
+    })))
+        return;
+    const data = await updateSalaryTransaction(salaryRow, fields);
+    outputDetail(data, salaryTransactionDetailColumns, json(), 'SalaryTransaction');
+});
 // --- attendance transactions (närvaro / Lön) ---
 const attendancetransactions = program
     .command('attendance-transactions')
@@ -2450,9 +3024,15 @@ attendancetransactions
 attendancetransactions
     .command('get <id>')
     .description('Get a single attendance transaction')
-    .action(async (id) => {
-    const { getAttendanceTransaction } = await import('./operations/attendancetransactions.js');
-    const data = await getAttendanceTransaction(id);
+    .option('--date <date>', 'Date for the composite Fortnox key (YYYY-MM-DD)')
+    .option('--code <code>', 'Cause code for the composite Fortnox key')
+    .action(async (id, opts) => {
+    const { getAttendanceTransaction, getAttendanceTransactionByDateCode } = await import('./operations/attendancetransactions.js');
+    if ((opts.date && !opts.code) || (opts.code && !opts.date))
+        throw new Error('--date and --code must be supplied together');
+    const data = opts.date && opts.code
+        ? await getAttendanceTransactionByDateCode(id, opts.date, opts.code)
+        : await getAttendanceTransaction(id);
     outputDetail(data, attendanceTransactionDetailColumns, json(), 'AttendanceTransaction');
 });
 attendancetransactions
@@ -2501,6 +3081,23 @@ attendancetransactions
     await deleteAttendanceTransaction(id);
     outputConfirmation(`Attendance transaction ${id} deleted.`, json(), { id, deleted: true }, undefined, 'AttendanceTransaction');
 });
+attendancetransactions
+    .command('update <id>')
+    .description('Update an attendance transaction')
+    .requiredOption('--input <file>', 'Transaction data as JSON file (or - for stdin)')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the request without sending it')
+    .action(async (id, opts) => {
+    const { updateAttendanceTransaction } = await import('./operations/attendancetransactions.js');
+    const raw = opts.input === '-' ? readFileSync(0, 'utf-8') : readFileSync(opts.input, 'utf-8');
+    const fields = JSON.parse(raw);
+    if (!(await confirmMutation(`Update attendance transaction ${id}`, opts, {
+        AttendanceTransaction: fields,
+    })))
+        return;
+    const data = await updateAttendanceTransaction(id, fields);
+    outputDetail(data, attendanceTransactionDetailColumns, json(), 'AttendanceTransaction');
+});
 // --- absence transactions (frånvaro / Lön) ---
 const absencetransactions = program
     .command('absence-transactions')
@@ -2528,9 +3125,15 @@ absencetransactions
 absencetransactions
     .command('get <id>')
     .description('Get a single absence transaction')
-    .action(async (id) => {
-    const { getAbsenceTransaction } = await import('./operations/absencetransactions.js');
-    const data = await getAbsenceTransaction(id);
+    .option('--date <date>', 'Date for the composite Fortnox key (YYYY-MM-DD)')
+    .option('--code <code>', 'Cause code for the composite Fortnox key')
+    .action(async (id, opts) => {
+    const { getAbsenceTransaction, getAbsenceTransactionByDateCode } = await import('./operations/absencetransactions.js');
+    if ((opts.date && !opts.code) || (opts.code && !opts.date))
+        throw new Error('--date and --code must be supplied together');
+    const data = opts.date && opts.code
+        ? await getAbsenceTransactionByDateCode(id, opts.date, opts.code)
+        : await getAbsenceTransaction(id);
     outputDetail(data, absenceTransactionDetailColumns, json(), 'AbsenceTransaction');
 });
 absencetransactions
@@ -2582,6 +3185,23 @@ absencetransactions
     await deleteAbsenceTransaction(id);
     outputConfirmation(`Absence transaction ${id} deleted.`, json(), { id, deleted: true }, undefined, 'AbsenceTransaction');
 });
+absencetransactions
+    .command('update <id>')
+    .description('Update an absence transaction')
+    .requiredOption('--input <file>', 'Transaction data as JSON file (or - for stdin)')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the request without sending it')
+    .action(async (id, opts) => {
+    const { updateAbsenceTransaction } = await import('./operations/absencetransactions.js');
+    const raw = opts.input === '-' ? readFileSync(0, 'utf-8') : readFileSync(opts.input, 'utf-8');
+    const fields = JSON.parse(raw);
+    if (!(await confirmMutation(`Update absence transaction ${id}`, opts, {
+        AbsenceTransaction: fields,
+    })))
+        return;
+    const data = await updateAbsenceTransaction(id, fields);
+    outputDetail(data, absenceTransactionDetailColumns, json(), 'AbsenceTransaction');
+});
 // --- schedule times (schematider / Lön) ---
 const scheduletimes = program
     .command('schedule-times')
@@ -2695,6 +3315,34 @@ taxreductions
     const data = await createTaxReduction(params);
     outputDetail(data, taxReductionDetailColumns, json(), 'TaxReduction');
 });
+taxreductions
+    .command('update <id>')
+    .description('Update a tax reduction')
+    .requiredOption('--input <file>', 'Tax reduction data as JSON file (or - for stdin)')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the request without sending it')
+    .action(async (id, opts) => {
+    const { updateTaxReduction } = await import('./operations/taxreductions.js');
+    const raw = opts.input === '-' ? readFileSync(0, 'utf-8') : readFileSync(opts.input, 'utf-8');
+    const fields = JSON.parse(raw);
+    const numericId = parseInt(id, 10);
+    if (!(await confirmMutation(`Update tax reduction ${id}`, opts, { TaxReduction: fields })))
+        return;
+    const data = await updateTaxReduction(numericId, fields);
+    outputDetail(data, taxReductionDetailColumns, json(), 'TaxReduction');
+});
+taxreductions
+    .command('delete <id>')
+    .description('Delete a tax reduction')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the action without sending it')
+    .action(async (id, opts) => {
+    const { deleteTaxReduction } = await import('./operations/taxreductions.js');
+    if (!(await confirmMutation(`Delete tax reduction ${id}`, opts)))
+        return;
+    await deleteTaxReduction(parseInt(id, 10));
+    outputConfirmation(`Tax reduction ${id} deleted.`, json(), { Id: Number(id), deleted: true });
+});
 // --- price lists ---
 const pricelists = program.command('pricelists').description('Price list operations');
 pricelists
@@ -2768,7 +3416,7 @@ const prices = program.command('prices').description('Price operations within pr
 prices
     .command('list')
     .description('List prices in a price list')
-    .requiredOption('--pricelist <code>', 'Price list code')
+    .option('--pricelist <code>', 'Price list code (omit to list all prices)')
     .option('--article <number>', 'Filter by article number')
     .option('--page <number>', 'Page number', parseInt)
     .option('--limit <number>', 'Results per page', parseInt)
@@ -2794,6 +3442,26 @@ prices
     const data = await getPrice(opts.pricelist, opts.article, opts.fromQuantity);
     outputDetail(data, priceDetailColumns, json(), 'Price');
 });
+prices
+    .command('create')
+    .description('Create a price')
+    .requiredOption('--pricelist <code>', 'Price list code')
+    .requiredOption('--article <number>', 'Article number')
+    .requiredOption('--input <file>', 'Price data as JSON file (or - for stdin)')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the request without sending it')
+    .action(async (opts) => {
+    const { createPrice } = await import('./operations/pricelists.js');
+    const raw = opts.input === '-' ? readFileSync(0, 'utf-8') : readFileSync(opts.input, 'utf-8');
+    const input = JSON.parse(raw);
+    const fields = { ...input, PriceList: opts.pricelist, ArticleNumber: opts.article };
+    if (!(await confirmMutation(`Create price ${opts.pricelist}/${opts.article}`, opts, {
+        Price: fields,
+    })))
+        return;
+    const data = await createPrice(fields);
+    outputDetail(data, priceDetailColumns, json(), 'Price');
+});
 prices
     .command('update')
     .description('Update a price')
@@ -2815,6 +3483,22 @@ prices
     const data = await updatePrice(opts.pricelist, opts.article, fields, opts.fromQuantity);
     outputDetail(data, priceDetailColumns, json(), 'Price');
 });
+prices
+    .command('delete')
+    .description('Delete a quantity-aware price')
+    .requiredOption('--pricelist <code>', 'Price list code')
+    .requiredOption('--article <number>', 'Article number')
+    .requiredOption('--from-quantity <number>', 'From quantity', parseInt)
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the action without sending it')
+    .action(async (opts) => {
+    const { deletePrice } = await import('./operations/pricelists.js');
+    const target = `${opts.pricelist}/${opts.article}/${opts.fromQuantity}`;
+    if (!(await confirmMutation(`Delete price ${target}`, opts)))
+        return;
+    await deletePrice(opts.pricelist, opts.article, opts.fromQuantity);
+    outputConfirmation(`Price ${target} deleted.`, json(), { deleted: true });
+});
 // --- contracts ---
 const contracts = program
     .command('contracts')
@@ -3092,6 +3776,27 @@ financialYears
     const data = await getFinancialYear(parseInt(id, 10));
     outputDetail(data, financialYearDetailColumns, json(), 'FinancialYear');
 });
+financialYears
+    .command('create')
+    .description('Create a financial year')
+    .requiredOption('--from <date>', 'Start date (YYYY-MM-DD)')
+    .requiredOption('--to <date>', 'End date (YYYY-MM-DD)')
+    .option('--accounting-method <method>', 'Accounting method (ACCRUAL or CASH)')
+    .option('--account-chart <type>', 'Account chart type')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview the request without sending it')
+    .action(async (opts) => {
+    const { createFinancialYear } = await import('./operations/financial-years.js');
+    const fields = { FromDate: opts.from, ToDate: opts.to };
+    if (opts.accountingMethod)
+        fields.AccountingMethod = opts.accountingMethod;
+    if (opts.accountChart)
+        fields.AccountChartType = opts.accountChart;
+    if (!(await confirmMutation('Create financial year', opts, { FinancialYear: fields })))
+        return;
+    const data = await createFinancialYear(fields);
+    outputDetail(data, financialYearDetailColumns, json(), 'FinancialYear');
+});
 financialYears
     .command('locked-period')
     .description('Show the locked period (bokföring låst t.o.m.)')
@@ -3108,6 +3813,396 @@ financialYears
     }
     outputDetail(data, lockedPeriodDetailColumns, false);
 });
+const archive = program.command('archive').description('Fortnox archive operations');
+archive
+    .command('list')
+    .option('--path <path>', 'Archive path')
+    .option('--file-id <id>', 'File ID')
+    .action(async (opts) => {
+    const { listArchive } = await import('./operations/files.js');
+    const raw = await listArchive({ path: opts.path, fileId: opts.fileId });
+    const folder = (raw.Folder ?? {});
+    const items = [
+        ...(folder.Folders ?? []),
+        ...(folder.Files ?? []),
+    ];
+    outputList(items, referenceDataColumns, json(), raw);
+});
+archive
+    .command('get <id>')
+    .option('--path <path>', 'Archive path')
+    .option('--file-id <fileId>', 'File ID')
+    .option('-o, --output <file>', 'Output file (default: private temporary directory)')
+    .option('--overwrite', 'Overwrite an existing regular file')
+    .action(async (id, opts) => {
+    const { getArchiveEntry } = await import('./operations/files.js');
+    const { privateOutputPath, writeBinaryFile } = await import('./safe-file-output.js');
+    const file = await getArchiveEntry(id, { path: opts.path, fileId: opts.fileId });
+    const target = writeBinaryFile(opts.output ?? privateOutputPath('noxctl-', `archive-${id}`), file.buffer, opts.overwrite);
+    outputConfirmation(`Archive file ${id} saved to ${target}.`, json(), {
+        Id: id,
+        File: target,
+        Bytes: file.buffer.length,
+        ContentType: file.contentType,
+    });
+});
+archive
+    .command('upload <file>')
+    .option('--folder-id <id>', 'Target folder ID')
+    .option('--path <path>', 'Target archive path')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview without reading or uploading the file')
+    .action(async (file, opts) => {
+    const { uploadArchiveFile } = await import('./operations/files.js');
+    if (!(await confirmMutation(`Upload ${file} to archive`, opts, {
+        folderId: opts.folderId,
+        path: opts.path,
+    })))
+        return;
+    const raw = await uploadArchiveFile(file, { folderId: opts.folderId, path: opts.path });
+    outputDetail((raw.File ?? raw), referenceDataColumns, json(), 'File');
+});
+archive
+    .command('delete-path <path>')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview without deleting')
+    .action(async (path, opts) => {
+    const { deleteArchivePath } = await import('./operations/files.js');
+    if (!(await confirmMutation(`Delete archive path ${JSON.stringify(path)}`, opts)))
+        return;
+    await deleteArchivePath(path);
+    outputConfirmation(`Archive path ${JSON.stringify(path)} deleted.`, json(), {
+        path,
+        deleted: true,
+    });
+});
+archive
+    .command('delete <id>')
+    .option('--path <path>', 'Archive path')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview without deleting')
+    .action(async (id, opts) => {
+    const { deleteArchiveEntry } = await import('./operations/files.js');
+    if (!(await confirmMutation(`Delete archive entry ${id}`, opts, { path: opts.path })))
+        return;
+    await deleteArchiveEntry(id, opts.path);
+    outputConfirmation(`Archive entry ${id} deleted.`, json(), { Id: id, deleted: true });
+});
+const inbox = program.command('inbox').description('Fortnox inbox operations');
+inbox.command('list').action(async () => {
+    const { listInbox } = await import('./operations/files.js');
+    const raw = await listInbox();
+    const folder = (raw.Folder ?? {});
+    const items = [
+        ...(folder.Folders ?? []),
+        ...(folder.Files ?? []),
+    ];
+    outputList(items, referenceDataColumns, json(), raw);
+});
+inbox
+    .command('upload <file>')
+    .option('--folder-id <id>', 'Target folder ID')
+    .option('--path <path>', 'Target inbox path')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview without reading or uploading the file')
+    .action(async (file, opts) => {
+    const { uploadInboxEntry } = await import('./operations/files.js');
+    if (!(await confirmMutation(`Upload ${file} to inbox`, opts, {
+        folderId: opts.folderId,
+        path: opts.path,
+    })))
+        return;
+    const raw = await uploadInboxEntry(file, { folderId: opts.folderId, path: opts.path });
+    outputDetail((raw.File ?? raw), referenceDataColumns, json(), 'File');
+});
+inbox
+    .command('file <id>')
+    .option('-f, --file <path>', 'Write the file here')
+    .option('--overwrite', 'Allow replacing an existing regular file')
+    .action(async (id, opts) => {
+    const { getInboxFile } = await import('./operations/files.js');
+    const { privateOutputPath, writeBinaryFile } = await import('./safe-file-output.js');
+    const file = await getInboxFile(id);
+    const path = writeBinaryFile(opts.file ?? privateOutputPath('noxctl-', `inbox-${id}`), file.buffer, opts.overwrite);
+    outputConfirmation(`Inbox file ${id} saved to ${path}.`, json(), {
+        Path: path,
+        Bytes: file.buffer.length,
+    });
+});
+inbox
+    .command('delete <id>')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview without deleting')
+    .action(async (id, opts) => {
+    const { deleteInboxEntry } = await import('./operations/files.js');
+    if (!(await confirmMutation(`Delete inbox entry ${id}`, opts)))
+        return;
+    await deleteInboxEntry(id);
+    outputConfirmation(`Inbox entry ${id} deleted.`, json(), { Id: id, deleted: true });
+});
+const attachments = program
+    .command('attachments')
+    .description('Cross-document attachment operations');
+attachments
+    .command('attach <entityType> <documentNumber> <fileId>')
+    .option('--exclude-on-send', 'Do not include the attachment when the document is sent')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview without attaching')
+    .action(async (entityType, documentNumber, fileId, opts) => {
+    if (!['F', 'OF', 'O', 'C'].includes(entityType))
+        throw new Error('entityType must be F, OF, O, or C');
+    const body = {
+        documentNumber,
+        entityType,
+        fileId,
+        includeOnSend: !opts.excludeOnSend,
+    };
+    if (!(await confirmMutation(`Attach archive file ${fileId} to ${entityType} ${documentNumber}`, opts, body)))
+        return;
+    const { createDocumentAttachment } = await import('./operations/invoices.js');
+    const result = await createDocumentAttachment(documentNumber, entityType, fileId, !opts.excludeOnSend);
+    outputDetail(result, invoiceAttachmentListColumns, json(), 'Attachment');
+});
+attachments
+    .command('list <entityType> <documentNumber>')
+    .description('List attachments for OF (offer), O (order), or C (contract)')
+    .action(async (entityType, documentNumber) => {
+    if (!['OF', 'O', 'C'].includes(entityType))
+        throw new Error('entityType must be OF, O, or C');
+    const { listDocumentAttachments } = await import('./operations/invoices.js');
+    const rows = await listDocumentAttachments(documentNumber, entityType);
+    outputList(rows, invoiceAttachmentListColumns, json(), rows);
+});
+attachments
+    .command('counts <entityType> <entityIds...>')
+    .action(async (entityType, entityIds) => {
+    if (!['F', 'OF', 'O', 'C'].includes(entityType))
+        throw new Error('entityType must be F, OF, O, or C');
+    const { getAttachmentCounts } = await import('./operations/invoices.js');
+    const result = await getAttachmentCounts(entityIds.map(Number), entityType);
+    outputDetail(result, invoiceAttachmentListColumns, json(), 'AttachmentCounts');
+});
+attachments
+    .command('validate')
+    .requiredOption('--input <file>', 'Attachment array as JSON (or - for stdin)')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview exact payload')
+    .action(async (opts) => {
+    const raw = opts.input === '-' ? readFileSync(0, 'utf-8') : readFileSync(opts.input, 'utf-8');
+    const rows = JSON.parse(raw);
+    if (!Array.isArray(rows))
+        throw new Error('Attachment input must be an array');
+    if (!(await confirmMutation('Validate attachments included on send', opts, rows)))
+        return;
+    const { validateAttachmentsOnSend } = await import('./operations/invoices.js');
+    await validateAttachmentsOnSend(rows);
+    outputConfirmation('Attachment validation accepted.', json(), {});
+});
+attachments
+    .command('update <attachmentId>')
+    .requiredOption('--input <file>', 'Attachment fields as JSON (or - for stdin)')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview exact payload')
+    .action(async (attachmentId, opts) => {
+    const raw = opts.input === '-' ? readFileSync(0, 'utf-8') : readFileSync(opts.input, 'utf-8');
+    const fields = JSON.parse(raw);
+    if (!(await confirmMutation(`Update attachment ${attachmentId}`, opts, fields)))
+        return;
+    const { updateDocumentAttachment } = await import('./operations/invoices.js');
+    const result = await updateDocumentAttachment(attachmentId, fields);
+    outputDetail(result, invoiceAttachmentListColumns, json(), 'Attachment');
+});
+attachments
+    .command('detach <attachmentId>')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--dry-run', 'Preview without detaching')
+    .action(async (attachmentId, opts) => {
+    if (!(await confirmMutation(`Detach attachment ${attachmentId}`, opts)))
+        return;
+    const { detachDocumentAttachment } = await import('./operations/invoices.js');
+    await detachDocumentAttachment(attachmentId);
+    outputConfirmation(`Attachment ${attachmentId} detached.`, json(), {
+        AttachmentId: attachmentId,
+        detached: true,
+    });
+});
+const accrualResources = [
+    {
+        command: 'invoice-accruals',
+        envelope: 'InvoiceAccrual',
+        list: 'listInvoiceAccruals',
+        get: 'getInvoiceAccrual',
+        create: 'createInvoiceAccrual',
+        update: 'updateInvoiceAccrual',
+        delete: 'deleteInvoiceAccrual',
+    },
+    {
+        command: 'supplier-invoice-accruals',
+        envelope: 'SupplierInvoiceAccrual',
+        list: 'listSupplierInvoiceAccruals',
+        get: 'getSupplierInvoiceAccrual',
+        create: 'createSupplierInvoiceAccrual',
+        update: 'updateSupplierInvoiceAccrual',
+        delete: 'deleteSupplierInvoiceAccrual',
+    },
+    {
+        command: 'contract-accruals',
+        envelope: 'ContractAccrual',
+        list: 'listContractAccruals',
+        get: 'getContractAccrual',
+        create: 'createContractAccrual',
+        update: 'updateContractAccrual',
+        delete: 'deleteContractAccrual',
+    },
+];
+for (const definition of accrualResources) {
+    const resource = program
+        .command(definition.command)
+        .description('Fortnox-native accrual operations');
+    resource.command('list').action(async () => {
+        const operations = await import('./operations/accruals.js');
+        const result = await operations[definition.list]();
+        outputList(result.items, referenceDataColumns, json(), result.raw, result.raw.MetaInformation);
+    });
+    resource.command('get <documentNumber>').action(async (documentNumber) => {
+        const operations = await import('./operations/accruals.js');
+        const result = await operations[definition.get](documentNumber);
+        outputDetail(result, referenceDataColumns, json(), definition.envelope);
+    });
+    resource
+        .command('create')
+        .requiredOption('--input <file>', 'Complete accrual JSON data (or - for stdin)')
+        .option('-y, --yes', 'Skip confirmation prompt')
+        .option('--dry-run', 'Preview the exact payload without sending it')
+        .action(async (opts) => {
+        const operations = await import('./operations/accruals.js');
+        const raw = opts.input === '-' ? readFileSync(0, 'utf-8') : readFileSync(opts.input, 'utf-8');
+        const fields = operations.prepareAccrualFields(definition.envelope, JSON.parse(raw));
+        if (!(await confirmMutation(`Create ${definition.command}`, opts, {
+            [definition.envelope]: fields,
+        })))
+            return;
+        const result = await operations[definition.create](fields);
+        outputDetail(result, referenceDataColumns, json(), definition.envelope);
+    });
+    resource
+        .command('update <documentNumber>')
+        .requiredOption('--input <file>', 'Complete accrual JSON data (or - for stdin)')
+        .option('-y, --yes', 'Skip confirmation prompt')
+        .option('--dry-run', 'Preview the exact payload without sending it')
+        .action(async (documentNumber, opts) => {
+        const operations = await import('./operations/accruals.js');
+        const raw = opts.input === '-' ? readFileSync(0, 'utf-8') : readFileSync(opts.input, 'utf-8');
+        const fields = operations.prepareAccrualFields(definition.envelope, JSON.parse(raw));
+        if (!(await confirmMutation(`Update ${definition.command} ${documentNumber}`, opts, {
+            [definition.envelope]: fields,
+        })))
+            return;
+        const result = await operations[definition.update](documentNumber, fields);
+        outputDetail(result, referenceDataColumns, json(), definition.envelope);
+    });
+    resource
+        .command('delete <documentNumber>')
+        .option('-y, --yes', 'Skip confirmation prompt')
+        .option('--dry-run', 'Preview the action without sending it')
+        .action(async (documentNumber, opts) => {
+        const operations = await import('./operations/accruals.js');
+        if (!(await confirmMutation(`Delete ${definition.command} ${documentNumber}`, opts)))
+            return;
+        await operations[definition.delete](documentNumber);
+        outputConfirmation(`${definition.envelope} ${documentNumber} deleted.`, json(), {
+            DocumentNumber: documentNumber,
+            deleted: true,
+        });
+    });
+}
+const referenceResources = [
+    {
+        command: 'currencies',
+        description: 'Currency reference data',
+        list: 'listCurrencies',
+        get: 'getCurrency',
+    },
+    { command: 'units', description: 'Unit reference data', list: 'listUnits', get: 'getUnit' },
+    {
+        command: 'modes-of-payments',
+        description: 'Payment mode reference data',
+        list: 'listModesOfPayments',
+        get: 'getModeOfPayment',
+    },
+    {
+        command: 'terms-of-deliveries',
+        description: 'Delivery term reference data',
+        list: 'listTermsOfDeliveries',
+        get: 'getTermOfDelivery',
+    },
+    {
+        command: 'terms-of-payments',
+        description: 'Payment term reference data',
+        list: 'listTermsOfPayments',
+        get: 'getTermOfPayment',
+    },
+    {
+        command: 'ways-of-delivery',
+        description: 'Delivery way reference data',
+        list: 'listWaysOfDelivery',
+        get: 'getWayOfDelivery',
+    },
+    {
+        command: 'voucher-series',
+        description: 'Voucher series setup data',
+        list: 'listVoucherSeries',
+        get: 'getVoucherSeries',
+    },
+    {
+        command: 'predefined-voucher-series',
+        description: 'Predefined voucher series',
+        list: 'listPredefinedVoucherSeries',
+        get: 'getPredefinedVoucherSeries',
+    },
+    {
+        command: 'account-charts',
+        description: 'Available account chart types',
+        list: 'listAccountCharts',
+    },
+    {
+        command: 'predefined-accounts',
+        description: 'Predefined account setup',
+        list: 'listPredefinedAccounts',
+        get: 'getPredefinedAccount',
+    },
+    {
+        command: 'customer-references',
+        description: 'Customer reference data',
+        list: 'listCustomerReferences',
+        get: 'getCustomerReference',
+    },
+];
+for (const definition of referenceResources) {
+    const resource = program.command(definition.command).description(definition.description);
+    resource
+        .command('list')
+        .option('--page <number>', 'Page number', parseInt)
+        .option('--limit <number>', 'Results per page', parseInt)
+        .option('-a, --all', 'Fetch all pages')
+        .action(async (opts) => {
+        const operations = await import('./operations/reference-data.js');
+        const list = operations[definition.list];
+        const result = await list({ page: opts.page, limit: opts.limit, all: opts.all });
+        outputList(result.items, referenceDataColumns, json(), result.raw, result.raw.MetaInformation);
+    });
+    if ('get' in definition) {
+        resource
+            .command('get <identifier>')
+            .description(`Get one ${definition.command} entry`)
+            .action(async (identifier) => {
+            const operations = await import('./operations/reference-data.js');
+            const get = operations[definition.get];
+            const result = await get(identifier);
+            outputDetail(result.item, referenceDataColumns, json(), definition.command);
+        });
+    }
+}
 // --- analytics ---
 const analytics = program
     .command('analytics')
@@ -3229,7 +4324,8 @@ Examples:
 // Error handling (configureOutput + exitOverride set above, before the command
 // tree, so subcommands inherit them).
 try {
-    await program.parseAsync(process.argv);
+    const args = process.argv.length === 2 ? [...process.argv, '--help'] : process.argv;
+    await program.parseAsync(args);
 }
 catch (err) {
     const code = err instanceof Error && 'code' in err ? err.code : undefined;