jaz-clio 4.25.0 → 4.25.1

package/assets/skills/api/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: jaz-api
-version: 4.25.0
+version: 4.25.1
 description: Complete reference for the Jaz REST API — the accounting platform backend. Use this skill whenever building, modifying, debugging, or extending any code that calls the API — including API clients, integrations, data seeding, test data, or new endpoint work. Contains every field name, response shape, error, gotcha, and edge case discovered through live production testing.
 license: MIT
 compatibility: Requires Jaz API key (x-jk-api-key header). Works with Claude Code, Google Antigravity, OpenAI Codex, GitHub Copilot, Cursor, and any agent that reads markdown.
@@ -85,7 +85,7 @@ You are working with the **Jaz REST API** — the accounting platform backend. A
 
 ### Custom Fields
 35. **Do NOT send `appliesTo` on custom field POST** — causes "Invalid request body". Only send `name`, `type`, `printOnDocuments`.
-35a. **Custom field values on transactions**: Set via `customFields: [{ customFieldName: "PO Number", actualValue: "PO-123" }]` on invoice/bill/customer-CN/supplier-CN create/update. NOT on journals, cash entries, or cash transfers. Read from GET responses in the same shape.
+35a. **Custom field values on transactions**: Set via `customFields: [{ customFieldName: "PO Number", actualValue: "PO-123" }]` on invoice/bill/customer-CN/supplier-CN/payment/item create/update. NOT on journals, cash entries, or cash transfers. Read from GET responses in the same shape.
 35b. **Custom field search**: `POST /custom-fields/search` with filter/sort/limit/offset. Filter by `customFieldName` (StringExpression), `datatypeCode` (StringExpression: TEXT, DATE, DROPDOWN).
 35c. **Custom field GET**: `GET /custom-fields/:resourceId` returns full definition including `applyToSales`, `applyToPurchase`, `applyToCreditNote`, `applyToPayment`, `printOnDocuments`, `listOptions`.
 

package/assets/skills/conversion/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: jaz-conversion
-version: 4.25.0
+version: 4.25.1
 description: Accounting data conversion skill — migrates customer data from Xero, QuickBooks, Sage, MYOB, and Excel exports to Jaz. Covers config, quick, and full conversion workflows, Excel parsing, CoA/contact/tax/items mapping, clearing accounts, TTB, and TB verification.
 ---
 

package/assets/skills/jobs/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: jaz-jobs
-version: 4.25.0
+version: 4.25.1
 description: 12 accounting jobs for SMB bookkeepers and accountants — month-end, quarter-end, and year-end close playbooks plus 9 ad-hoc operational jobs (bank recon, document collection, GST/VAT filing, payment runs, credit control, supplier recon, audit prep, fixed asset review, statutory filing). Jobs can have paired tools as nested subcommands (e.g., `clio jobs bank-recon match`, `clio jobs document-collection ingest`, `clio jobs statutory-filing sg-cs`). Paired with an interactive CLI blueprint generator (clio jobs).
 license: MIT
 compatibility: Works with Claude Code, Claude Cowork, Claude.ai, and any agent that reads markdown. For API payloads, load the jaz-api skill. For individual transaction patterns, load the jaz-recipes skill.

package/assets/skills/transaction-recipes/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: jaz-recipes
-version: 4.25.0
+version: 4.25.1
 description: 16 IFRS-compliant recipes for complex multi-step accounting in Jaz — prepaid amortization, deferred revenue, loan schedules, IFRS 16 leases, hire purchase, fixed deposits, asset disposal, FX revaluation, ECL provisioning, IAS 37 provisions, dividends, intercompany, and capital WIP. Each recipe includes journal entries, capsule structure, and verification steps. Paired with 13 financial calculators that produce execution-ready blueprints with workings.
 license: MIT
 compatibility: Works with Claude Code, Claude Cowork, Claude.ai, and any agent that reads markdown. For API payloads, load the jaz-api skill alongside this one.

package/dist/commands/bills.js

@@ -254,17 +254,20 @@ export function registerBillsCommand(program) {
         .option('--method <method>', 'Payment method (BANK_TRANSFER, CASH, CHEQUE, etc.)', 'BANK_TRANSFER')
         .option('--ref <reference>', 'Payment reference')
         .option('--draft', 'Save as draft instead of finalizing')
+        .option('--custom-fields <json>', 'Custom field values as JSON array')
         .option('--input <file>', 'Read full payment body from JSON file (or pipe via stdin)')
         .option('--api-key <key>', 'API key (overrides stored/env)')
         .option('--json', 'Output as JSON')
         .action((resourceId, opts) => apiAction(async (client) => {
         const body = readBodyInput(opts);
+        const customFields = opts.customFields ? parseCustomFields(opts.customFields) : undefined;
         let res;
         if (body) {
             // eslint-disable-next-line @typescript-eslint/no-explicit-any -- user-provided JSON, API validates
             res = await createBillPayment(client, resourceId, {
                 ...body,
                 saveAsDraft: body.saveAsDraft ?? (opts.draft ?? false),
+                customFields: body.customFields ?? customFields,
             });
         }
         else {
@@ -287,6 +290,7 @@ export function registerBillsCommand(program) {
                 paymentMethod: opts.method,
                 reference: opts.ref ?? '',
                 saveAsDraft: opts.draft ?? false,
+                customFields,
             });
         }
         if (opts.json) {

package/dist/commands/invoices.js

@@ -256,17 +256,20 @@ export function registerInvoicesCommand(program) {
         .option('--method <method>', 'Payment method (BANK_TRANSFER, CASH, CHEQUE, etc.)', 'BANK_TRANSFER')
         .option('--ref <reference>', 'Payment reference')
         .option('--draft', 'Save as draft instead of finalizing')
+        .option('--custom-fields <json>', 'Custom field values as JSON array')
         .option('--input <file>', 'Read full payment body from JSON file (or pipe via stdin)')
         .option('--api-key <key>', 'API key (overrides stored/env)')
         .option('--json', 'Output as JSON')
         .action((resourceId, opts) => apiAction(async (client) => {
         const body = readBodyInput(opts);
+        const customFields = opts.customFields ? parseCustomFields(opts.customFields) : undefined;
         let res;
         if (body) {
             // eslint-disable-next-line @typescript-eslint/no-explicit-any -- user-provided JSON, API validates
             res = await createInvoicePayment(client, resourceId, {
                 ...body,
                 saveAsDraft: body.saveAsDraft ?? (opts.draft ?? false),
+                customFields: body.customFields ?? customFields,
             });
         }
         else {
@@ -289,6 +292,7 @@ export function registerInvoicesCommand(program) {
                 paymentMethod: opts.method,
                 reference: opts.ref ?? '',
                 saveAsDraft: opts.draft ?? false,
+                customFields,
             });
         }
         if (opts.json) {

package/dist/commands/items.js

@@ -2,7 +2,7 @@ import chalk from 'chalk';
 import { listItems, getItem, searchItems, createItem, updateItem, deleteItem, } from '../core/api/items.js';
 import { apiAction } from './api-action.js';
 import { outputList } from './output.js';
-import { parsePositiveInt, parseNonNegativeInt, parseMoney, readBodyInput, requireFields } from './parsers.js';
+import { parsePositiveInt, parseNonNegativeInt, parseMoney, readBodyInput, requireFields, parseCustomFields } from './parsers.js';
 import { paginatedFetch } from './pagination.js';
 import { formatId } from './format-helpers.js';
 const ITEMS_COLUMNS = [
@@ -101,6 +101,7 @@ export function registerItemsCommand(program) {
         .option('--purchase-account <resourceId>', 'Purchase account resourceId')
         .option('--sale-tax <resourceId>', 'Sale tax profile resourceId')
         .option('--purchase-tax <resourceId>', 'Purchase tax profile resourceId')
+        .option('--custom-fields <json>', 'Custom field values as JSON array: [{"customFieldName":"PO Number","actualValue":"PO-123"}]')
         .option('--input <file>', 'Read full request body from JSON file (or pipe via stdin)')
         .option('--api-key <key>', 'API key (overrides stored/env)')
         .option('--format <type>', 'Output format: table, json, csv, yaml')
@@ -117,6 +118,7 @@ export function registerItemsCommand(program) {
                 { flag: '--name', key: 'name' },
                 { flag: '--code', key: 'code' },
             ]);
+            const customFields = opts.customFields ? parseCustomFields(opts.customFields) : undefined;
             res = await createItem(client, {
                 internalName: opts.name,
                 itemCode: opts.code,
@@ -128,6 +130,7 @@ export function registerItemsCommand(program) {
                 purchaseAccountResourceId: opts.purchaseAccount,
                 saleTaxProfileResourceId: opts.saleTax,
                 purchaseTaxProfileResourceId: opts.purchaseTax,
+                customFields,
             });
         }
         if (opts.json) {
@@ -147,6 +150,7 @@ export function registerItemsCommand(program) {
         .option('--sale-price <n>', 'New sale price', parseMoney)
         .option('--purchase-price <n>', 'New purchase price', parseMoney)
         .option('--status <status>', 'Status (ACTIVE/INACTIVE)')
+        .option('--custom-fields <json>', 'Custom field values as JSON array')
         .option('--input <file>', 'Read full update body from JSON file (or pipe via stdin)')
         .option('--api-key <key>', 'API key (overrides stored/env)')
         .option('--format <type>', 'Output format: table, json, csv, yaml')
@@ -169,6 +173,8 @@ export function registerItemsCommand(program) {
                 data.purchasePrice = opts.purchasePrice;
             if (opts.status !== undefined)
                 data.status = opts.status;
+            if (opts.customFields)
+                data.customFields = parseCustomFields(opts.customFields);
         }
         const res = await updateItem(client, resourceId, data);
         if (opts.json) {

package/dist/core/registry/tools.js

@@ -417,6 +417,7 @@ export const TOOL_DEFINITIONS = [
                 enum: ['CASH', 'BANK_TRANSFER', 'CREDIT_CARD', 'CHEQUE', 'E_WALLET', 'OTHER'],
                 description: 'Payment method (default BANK_TRANSFER)',
             },
+            customFields: CUSTOM_FIELDS_PARAM,
         },
         required: ['resourceId', 'paymentAmount', 'accountResourceId', 'valueDate'],
         group: 'invoices',
@@ -439,6 +440,7 @@ export const TOOL_DEFINITIONS = [
                 reference: input.reference ?? '',
                 paymentMethod: (input.paymentMethod ?? 'BANK_TRANSFER'),
                 saveAsDraft: false,
+                customFields: input.customFields, // eslint-disable-line @typescript-eslint/no-explicit-any
             });
         },
     },
@@ -603,6 +605,7 @@ export const TOOL_DEFINITIONS = [
             valueDate: { type: 'string' },
             reference: { type: 'string' },
             paymentMethod: { type: 'string' },
+            customFields: CUSTOM_FIELDS_PARAM,
         },
         required: ['resourceId', 'paymentAmount', 'accountResourceId', 'valueDate'],
         group: 'bills',
@@ -625,6 +628,7 @@ export const TOOL_DEFINITIONS = [
                 reference: input.reference ?? '',
                 paymentMethod: (input.paymentMethod ?? 'BANK_TRANSFER'),
                 saveAsDraft: false,
+                customFields: input.customFields, // eslint-disable-line @typescript-eslint/no-explicit-any
             });
         },
     },
@@ -904,6 +908,7 @@ export const TOOL_DEFINITIONS = [
             purchasePrice: { type: 'number', description: 'Default purchase price' },
             saleAccountResourceId: { type: 'string', description: 'Revenue account for sales' },
             purchaseAccountResourceId: { type: 'string', description: 'Expense account for purchases' },
+            customFields: CUSTOM_FIELDS_PARAM,
         },
         required: ['itemCode', 'internalName'],
         group: 'items',
@@ -920,6 +925,7 @@ export const TOOL_DEFINITIONS = [
             salePrice: { type: 'number' },
             purchasePrice: { type: 'number' },
             status: { type: 'string', enum: ['ACTIVE', 'INACTIVE'] },
+            customFields: CUSTOM_FIELDS_PARAM,
         },
         required: ['resourceId'],
         group: 'items',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jaz-clio",
-  "version": "4.25.0",
+  "version": "4.25.1",
   "description": "Clio — Command Line Interface Orchestrator for Jaz AI.",
   "type": "module",
   "bin": {