jaz-clio 4.50.1 → 4.55.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (43) hide show
  1. package/README.md +12 -7
  2. package/assets/skills/api/SKILL.md +26 -4
  3. package/assets/skills/api/help-center-mirror/bank-reconciliations.md +8 -10
  4. package/assets/skills/api/help-center-mirror/bills.md +23 -51
  5. package/assets/skills/api/help-center-mirror/customer-credits.md +23 -51
  6. package/assets/skills/api/help-center-mirror/get-started.md +79 -104
  7. package/assets/skills/api/help-center-mirror/help-center-embeddings.json +1 -1
  8. package/assets/skills/api/help-center-mirror/help-center-index.json +1 -1
  9. package/assets/skills/api/help-center-mirror/import-data.md +2 -2
  10. package/assets/skills/api/help-center-mirror/index.md +7 -6
  11. package/assets/skills/api/help-center-mirror/invoices.md +26 -54
  12. package/assets/skills/api/help-center-mirror/journal-entries.md +4 -4
  13. package/assets/skills/api/help-center-mirror/reports.md +9 -5
  14. package/assets/skills/api/help-center-mirror/settings.md +393 -160
  15. package/assets/skills/api/help-center-mirror/supplier-credits.md +25 -53
  16. package/assets/skills/api/references/endpoints.md +152 -1
  17. package/assets/skills/api/references/field-map.md +19 -2
  18. package/assets/skills/api/references/full-api-surface.md +22 -1
  19. package/assets/skills/api/references/search-enums.md +15 -0
  20. package/assets/skills/api/references/search-reference.md +45 -0
  21. package/assets/skills/api/references/search-syntax.md +303 -0
  22. package/assets/skills/cli/SKILL.md +65 -3
  23. package/assets/skills/cli/references/command-catalog.md +20 -2
  24. package/assets/skills/cli/references/field-guide.md +78 -0
  25. package/assets/skills/conversion/SKILL.md +1 -1
  26. package/assets/skills/jobs/SKILL.md +1 -1
  27. package/assets/skills/transaction-recipes/SKILL.md +1 -1
  28. package/cli.mjs +451 -441
  29. package/help-center-mirror/bank-reconciliations.md +8 -10
  30. package/help-center-mirror/bills.md +23 -51
  31. package/help-center-mirror/customer-credits.md +23 -51
  32. package/help-center-mirror/fixed-assets.md +117 -0
  33. package/help-center-mirror/get-started.md +79 -104
  34. package/help-center-mirror/help-center-embeddings.json +1 -1
  35. package/help-center-mirror/help-center-index.json +1 -1
  36. package/help-center-mirror/import-data.md +2 -2
  37. package/help-center-mirror/index.md +7 -6
  38. package/help-center-mirror/invoices.md +26 -54
  39. package/help-center-mirror/journal-entries.md +4 -4
  40. package/help-center-mirror/reports.md +9 -5
  41. package/help-center-mirror/settings.md +393 -160
  42. package/help-center-mirror/supplier-credits.md +25 -53
  43. package/package.json +2 -2
package/README.md CHANGED
@@ -3,11 +3,11 @@
3
3
  <p align="center">
4
4
  <a href="https://www.npmjs.com/package/jaz-clio"><img src="https://img.shields.io/npm/v/jaz-clio?style=for-the-badge&logo=npm" alt="npm"></a>
5
5
  <a href="https://www.npmjs.com/package/jaz-clio"><img src="https://img.shields.io/npm/dm/jaz-clio?style=for-the-badge&label=downloads" alt="npm downloads"></a>
6
- <img src="https://img.shields.io/badge/tools-255-blue?style=for-the-badge" alt="255 Tools">
6
+ <img src="https://img.shields.io/badge/tools-247-blue?style=for-the-badge" alt="247 Tools">
7
7
  <a href="https://github.com/teamtinvio/jaz-ai/blob/main/LICENSE"><img src="https://img.shields.io/github/license/teamtinvio/jaz-ai?style=for-the-badge&color=green" alt="License"></a>
8
8
  </p>
9
9
 
10
- 255 tools. 13 financial calculators. 12 job playbooks. 117 API rules. 16 IFRS recipes.
10
+ 247 tools. 13 financial calculators. 12 job playbooks. 117 API rules. 16 IFRS recipes.
11
11
 
12
12
  ```bash
13
13
  npm install -g jaz-clio
@@ -18,8 +18,8 @@ Requires **Node.js 18+** ([nodejs.org](https://nodejs.org)). Also fully compatib
18
18
  ## Contents
19
19
 
20
20
  - [Three Ways In](#three-ways-in) — CLI, MCP, Skills
21
- - [CLI](#cli) — 48 command groups
22
- - [MCP Server](#mcp-server) — 243 tools for AI agents
21
+ - [CLI](#cli) — 53 command groups
22
+ - [MCP Server](#mcp-server) — 247 tools for AI agents
23
23
  - [Skills](#skills) — Teach any AI the Jaz API
24
24
  - [Setup](#setup) — Auth, multi-org, automation
25
25
 
@@ -27,7 +27,7 @@ Requires **Node.js 18+** ([nodejs.org](https://nodejs.org)). Also fully compatib
27
27
 
28
28
  | | What happens | Try it |
29
29
  |---|---|---|
30
- | **CLI** | 48 command groups, every accounting operation | `clio invoices list` |
30
+ | **CLI** | 53 command groups, every accounting operation | `clio invoices list` |
31
31
  | **MCP** | Plug into Claude Code, Cursor, Codex, Copilot | `clio mcp` |
32
32
  | **Skills** | Teach any AI tool the Jaz API | `clio init` |
33
33
 
@@ -45,13 +45,13 @@ clio magic create --file receipt.pdf # AI extracts → draft transa
45
45
  clio search "overdue" # Find it across all entities
46
46
  ```
47
47
 
48
- 48 command groups. 16 report types. 13 calculators. 12 job playbooks. Every command supports `--json`. Run `clio --help` for the full list.
48
+ 53 command groups. 16 report types. 13 calculators. 12 job playbooks. Every command supports `--json`. Run `clio --help` for the full list.
49
49
 
50
50
  ---
51
51
 
52
52
  ## MCP Server
53
53
 
54
- 242 CLI tools, available to any AI agent that speaks MCP. Runs locally — no cloud, no ports.
54
+ 247 CLI tools, available to any AI agent that speaks MCP. Runs locally — no cloud, no ports.
55
55
 
56
56
  **Claude Code:**
57
57
  ```bash
@@ -71,6 +71,11 @@ claude mcp add jaz -- npx jaz-clio mcp
71
71
  }
72
72
  ```
73
73
 
74
+ **Multi-org** — comma-separated keys or a personal access token:
75
+ ```json
76
+ { "env": { "JAZ_API_KEY": "jk-org1-key,jk-org2-key" } }
77
+ ```
78
+
74
79
  ---
75
80
 
76
81
  ## Skills
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: jaz-api
3
- version: 4.50.1
3
+ version: 4.55.3
4
4
  description: >-
5
5
  Use this skill whenever you call, debug, or review code that touches the Jaz
6
6
  REST API. Covers field names, response shapes, 117 production gotchas, error
@@ -66,10 +66,28 @@ You are working with the **Jaz REST API** — the accounting platform backend. A
66
66
  21. **CoA POST uses `classificationType`** — GET returns `accountType`. Same values.
67
67
  22. **CoA code mapping: match by NAME, not code** — pre-existing accounts may have different codes. Resource IDs are the universal identifier.
68
68
 
69
- ### Bulk Upsert (Items & Rates)
70
- - **Items bulk-upsert** (`POST /items/bulk-upsert`) — max 500 per call. Provide `resourceId` per item to update (partial — only changed fields needed, server preserves existing values). Omit `resourceId` to create (defaults: `status=ACTIVE`, `itemCategory=NON_INVENTORY`). Response: `{ resourceId: null, resourceIds: [...] }`.
69
+ ### Bulk Upsert (Items, Contacts & Rates)
70
+ - **Items bulk-upsert** (`POST /items/bulk-upsert`) — max 500 per call. Provide `resourceId` per item to update (partial — only changed fields needed, server preserves existing values). Omit `resourceId` to create (defaults: `status=ACTIVE`, `itemCategory=NON_INVENTORY`). Response: `{ resourceId: null, resourceIds: [...] }`. **SYNC** — returns resourceIds immediately.
71
+ - **Contacts bulk-upsert** (`POST /contacts/bulk-upsert`) — max 500 per call. Provide `resourceId` to update (partial), omit to create. `billingName` required for create. **ASYNC** — returns `{ jobId, status: "QUEUED", totalRecords }`. Poll `search_background_jobs` with `filter: {resourceId:{eq:jobId}}` until status is `SUCCESS`, `FAILED`, or `PARTIAL_SUCCESS`. Unlike items, contacts bulk-upsert is asynchronous.
71
72
  - **Rates bulk-upsert** (`POST /organization/currencies/rates/bulk-upsert`) — max 500 per call. Requires `rateDirection` per rate (`FUNCTIONAL_TO_SOURCE` or `SOURCE_TO_FUNCTIONAL`). **Auto-enables currencies not yet enabled in the org** — no need to call `add_currency` first. Response: `{ resourceId: null, resourceIds: [...] }`.
72
73
 
74
+ ### Background Jobs (Universal Async Tracking)
75
+ - **ANY operation that returns a `jobId`** can be polled via `search_background_jobs`. This includes: contacts bulk-upsert (`UPSERT_CONTACTS`), items bulk-upsert (`UPSERT_ITEMS`), bank statement import (`PROCESS_BANK_STATEMENT_FILES`), and magic processing (`MAGIC_TRANSACTION_*`).
76
+ - **🚨 CRITICAL: Filter by `resourceId`, NOT `jobId`** — `filter: {jobId:{eq:...}}` is silently ignored (returns ALL jobs). Must use `filter: {resourceId:{eq:theJobId}}`. The response field is named `jobId` but the filter path is `resourceId`.
77
+ - **Poll until terminal status** — `SUCCESS`, `FAILED`, or `PARTIAL_SUCCESS`. Use `processedCount`, `failedCount`, `totalRecords` for progress. `PARTIAL_SUCCESS` means some records succeeded and some failed — check `errorDetails` array for per-record errors.
78
+ - **`startedAt` filter does NOT work** — use `createdAt` for date range filtering.
79
+ - **`errorDetails` is `[]` (empty array) on success** — not `null`.
80
+ - **Known jobTypes**: `UPSERT_CONTACTS`, `UPSERT_ITEMS`, `PROCESS_BANK_STATEMENT_FILES`, `MAGIC_TRANSACTION_PURCHASE`, `MAGIC_TRANSACTION_SALE`, `MAGIC_TRANSACTION_SALE_CREDIT_NOTE`.
81
+
82
+ ### Export Records
83
+ - **`outputFormat: "XLSX"` is always required** — no other format is currently supported. Hardcode it.
84
+ - **`query` + `filter` are mutually exclusive** — the server returns `INVALID_SEARCH_INPUT` if both are provided. Pass `query` (structured search string, same syntax as dashboard) OR `filter` (raw JSON filter object), never both.
85
+ - **Available entity types**: `INVOICE`, `BILL`, `CUSTOMER_CREDIT_NOTE`, `SUPPLIER_CREDIT_NOTE`, `SALE_PAYMENT`, `PURCHASE_PAYMENT`, `BATCH_PAYMENT`, `CONTACT`, `ITEM`, `CAPSULE`, `SCHEDULED_TRANSACTION`, `JOURNAL`, `BANK_RECORD`, `CASHFLOW_TRANSACTION`, `FIXED_ASSET`, `CHART_OF_ACCOUNT`, `TAX_PROFILE`.
86
+ - **`fileUrl` expires in ~5 minutes** — it's a pre-signed S3 URL. Warn the user to download immediately.
87
+ - **Preview first** — use `preview_export_records` to confirm scope (count + sample rows) before calling `export_records`. The `filterDescription` field gives a human-readable summary like `"2580 records | Status in: UNPAID"`.
88
+ - **Column customization** — use `get_export_columns` to discover available column paths and headers. Pass a `columns` array to select specific fields. Omit for default columns.
89
+ - **`previewRows` keys are column headers** — not field paths. E.g. `{"Invoice Ref #": "INV-001", "Customer": "Acme"}`. Use `resolvedColumns` to map headers back to paths.
90
+
73
91
  ### Journals & Cash
74
92
  23. **Journals use `journalEntries`** with `amount` + `type: "DEBIT"|"CREDIT"` — NOT `debit`/`credit` number fields.
75
93
  24. **Journals support multi-currency via `currency` object** — same format as invoices/bills: `"currency": { "sourceCurrency": "USD" }` (auto-fetch platform rate) or `"currency": { "sourceCurrency": "USD", "exchangeRate": 1.35 }` (custom rate). Must be enabled for the org. Omit for base currency. Three restrictions apply to foreign currency journals: (a) **no controlled accounts** — accounts with `controlFlag` (AR, AP) are off-limits (use invoices/bills instead), (b) **no FX accounts** — FX Unrealized Gain/Loss/Rounding are system-managed, (c) **bank accounts must match** — can only post to bank accounts in the same currency as the journal (e.g., USD journal → USD bank account only, not SGD bank account). All other non-controlled accounts (expenses, revenue, assets, liabilities) are available.
@@ -144,6 +162,9 @@ You are working with the **Jaz REST API** — the accounting platform backend. A
144
162
 
145
163
  ### Search & Filter
146
164
  50. **Search endpoint universal pattern** — All 28 `POST /*/search` endpoints share identical structure: `{ filter?, sort: { sortBy: ["field"], order: "ASC"|"DESC" }, limit: 1-1000, offset: 0-65536 }`. Sort is REQUIRED when offset is present (even `offset: 0`). Default limit: 100. `sortBy` is always an array on all endpoints (no exceptions). See `references/search-reference.md` for per-endpoint filter/sort fields.
165
+ 50a. **`query` field — Jaz search operators** — 14 endpoints accept an optional `query` string alongside `filter`: invoices, bills, customer/supplier credit notes, journals, cashflow-transactions, bank-records, contacts, items, capsules, fixed-assets, scheduled-transactions, chart-of-accounts, tax-profiles. Example: `{ "query": "status:unpaid AND $500+", "limit": 50 }`. Key syntax: amounts (`$500+`, `$100-500`, `amount:>2m`, magnitude suffixes `5k`/`2m`/`1b`), negative (`$-500`), absolute value (`abs:1000+`), dates (`date:this month`, `date:-30d`, `due:overdue`, `submitted:last week`, `lastpayment:-7d`), status/enum (`status:unpaid`, `currency:SGD,USD` — comma = OR), string fields (`customer:acme`, `ref:INV-*` wildcard, `=ref:INV-001` exact, `ref:/\d{4}/` regex), blank checks (`ref:blank`, `tag:!blank`), booleans (`hasattachment:yes`, `customer:yes`), negation (`!status:paid` or `NOT status:void` — **never `-`** for negation), logic (`AND`/`OR` with implicit AND on space), grouping, inline sort (`sort:amount:desc`). Full syntax spec (all fields, aliases, entity field lists, examples): **`references/search-syntax.md`**.
166
+ 50b. **`query` + `filter` merge** — When both are present, they are merged at the filter level. Explicit `filter` keys win on conflict. Use `query` for human-readable shorthand, `filter` for programmatic precision, or combine both: `{ "query": "date:this year", "filter": { "currencyCode": { "in": ["SGD"] } } }`.
167
+ 50c. **`query` error handling** — Unknown field name → `query_not_understood` (400). Bad enum value (e.g. `status:BADVALUE`) → **empty results, no error** (silent miss). Unsupported endpoint → `query_not_supported` (400). Parser unavailable → `query_parse_error` (502). Empty/null/whitespace query → passthrough (ignored). In CLI/MCP: use `--query` / `query` param only on supported entities — unsupported entities have no `--query` flag.
147
168
  51. **Filter operator reference** — String: `eq`, `neq`, `contains`, `in` (array, max 100), `likeIn` (array, max 100), `reg` (regex array, max 100), `isNull` (bool). Numeric: `eq`, `gt`, `gte`, `lt`, `lte`, `in`. Date (YYYY-MM-DD): `eq`, `gt`, `gte`, `lt`, `lte`, `between` (exactly 2 values). DateTime (RFC3339): same operators, converted to epoch ms internally. Boolean: `eq`. JSON: `jsonIn`, `jsonNotIn`. Logical: nest with `and`/`or`/`not` objects, or use `andGroup`/`orGroup` arrays (invoices, bills, journals, credit notes).
148
169
  52. **Date format asymmetry (CRITICAL)** — Request dates: `YYYY-MM-DD` strings (all create/update and DateExpression filters). Request datetimes: RFC3339 strings (DateTimeExpression filters for `createdAt`, `updatedAt`, `approvedAt`, `submittedAt`). **ALL response dates**: `int64` epoch milliseconds — including `valueDate`, `createdAt`, `updatedAt`, `approvedAt`, `submittedAt`, `matchDate`. Convert: `new Date(epochMs).toISOString().slice(0,10)`. **Timezone convention**: ALL business dates (`valueDate`, `dueDate`, `startDate`, `endDate`, etc.) are in the **organization's timezone** — never UTC. The epoch ms stored in the DB represents the org-local date (no timezone conversion is ever needed). Only audit timestamps (`createdAt`, `updatedAt`, `action_at`) are UTC.
149
170
  53. **Field aliases on create endpoints** — Middleware transparently maps: `issueDate`/`date` → `valueDate` (invoices, bills, credit notes, journals). `name` → `tagName` (tags) or `internalName` (items). `paymentDate` → `valueDate`, `bankAccountResourceId` → `accountResourceId` (payments). `paymentAmount` → `refundAmount`, `paymentMethod` → `refundMethod` (credit note refunds). `accountType` → `classificationType`, `currencyCode` → `currency` (CoA). Canonical names always work; aliases are convenience only.
@@ -328,7 +349,8 @@ Bills, invoices, and credit notes share identical mandatory field specs. Adding
328
349
 
329
350
  For detailed reference, read these files in this skill directory:
330
351
 
331
- - **[references/search-reference.md](./references/search-reference.md)** — Complete search/filter/sort reference for all 28 search endpoints per-endpoint filter fields, sort fields, operator types
352
+ - **[references/search-syntax.md](./references/search-syntax.md)** — Full Jaz search query syntax: amounts, dates, abs, blanks, wildcards, regex, entity field lists, aliases, examples (auto-synced from dashboard repo)
353
+ - **[references/search-reference.md](./references/search-reference.md)** — API search/filter/sort reference for all 28 endpoints — per-endpoint filter fields, sort fields, operator types
332
354
  - **[references/endpoints.md](./references/endpoints.md)** — Full API endpoint reference with request/response examples
333
355
  - **[references/errors.md](./references/errors.md)** — Complete error catalog: every error, cause, and fix
334
356
  - **[references/field-map.md](./references/field-map.md)** — Complete field name mapping (what you'd guess vs actual), date format matrix, middleware aliases
@@ -105,24 +105,22 @@ Source: https://help.jaz.ai/en/articles/9941732-export-reconciled-unreconciled-r
105
105
  ### Magic Match in Bank Reconciliation
106
106
  Source: https://help.jaz.ai/en/articles/9993390-magic-match-in-bank-reconciliation
107
107
 
108
- Q1. What is a Magic match in Bank reconciliation?
108
+ **Q1. What is a Magic match in Bank reconciliation?**
109
109
 
110
110
  - Magic Match automatically pairs your bank statement lines with corresponding records in Jaz. It simplifies the reconciliation process, making it faster and more accurate regardless of your accounting experience.
111
- - You will see a notification banner whenever Magic Match finds potential pairings. If Jaz doesn't find a match, you can manually reconcile the entry yourself.
111
+ - You will see a notification banner whenever Magic Match finds potential pairings. If Jaz doesn't find a match, you can manually reconcile the entry.
112
112
 
113
113
  **Q2. How does Jaz determine which transactions will potentially reconcile with a statement line?**
114
114
 
115
- - Jaz uses **Magic Match** which aims to save you time in reconciliations. It looks beyond simple dates and amounts, using layered search logic to suggest the most accurate records for your reconciliation.
116
- - **Payment Recognition**: Magic Match automatically detects internal records, such as bill payments, customer refunds, or manual journal entries, that correspond to your bank activity.
117
- - **Multidimensional Matching**: Jaz goes beyond amounts and includes contact names, reference numbers, and descriptions in order to find highest-confidence transactions to match a statement line.
115
+ - Jaz uses **Magic Match** which aims to save you time in reconciliations. It looks beyond dates and amounts, using layered search logic to suggest the most accurate records for your reconcilation:
116
+ - **Payment Recognition**: Magic Match detects internal records, such as bill payments, customer refunds, or manual journal entries, that correspond to your bank activity.
117
+ - **Multidimensional Matching**: Magic Match goes beyond amounts and includes contact names, reference numbers, and descriptions in order to find transactions to match a statement line with high confidence.
118
118
  - **Date Windows**: Magic Match identifies your typical payment patterns to suggest matches that occurred within a logical timeframe of your statement line.
119
119
  - **Currency Conversion**: For cross-currency matching, Magic Match identifies transactions even when the currency of your invoice is different from the currency of your bank account.
120
- - **Group Matching**: If a single bank entry represents multiple invoices or bills (such as a bulk deposit), Juan can identify and suggest the specific combination of records that add up to that total.
121
-
120
+ - **Group Matching**: If a single bank entry represents multiple invoices or bills (such as a bulk deposit), Jaz can identify and suggest the specific combination of records that add up to that total.
121
+ - **Note:** Although Magic Match provides you with high confidence of reconciliation, always make sure to double check.**Q3. I see the same transaction matched with more than one statement line. What happens if I reconcile both?**
122
122
 
123
- **Note:** If a single record doesn’t match the amount, Jaz can automatically identify a group of transactions that add up to your statement line. This is particularly helpful for reconciling bulk deposits or batch payments.**Q3. I see the same transaction matched with more than one statement line. What happens if I reconcile both?**
124
-
125
- - If one transaction is matched with multiple statement lines, reconciling will not allow both to reconcile with the same transaction. Only the first statement line will be reconciled.
123
+ - Jaz shows potential matches with statement lines, but if one transaction is matched with multiple statement lines, reconciling will not allow both to reconcile with the same transaction. Instead, you will see a partial success banner and only the first statement line in the list will be reconciled.
126
124
 
127
125
  **Q4. I see records with the same date and amount as the statement line, but I don't see them matched.**
128
126
 
@@ -426,11 +426,11 @@ Source: https://help.jaz.ai/en/articles/9104249-bill-line-items
426
426
  - You can’t save a new item when creating a bill. You need to go to the** Items List** to create a new item, then the item will appear when creating a bill. See[Items List](https://help.jaz.ai/en/articles/9094095-items-list) for more information.
427
427
  - However, you can create a new custom item. Refer to [Q3. What is a custom item, when would I need to create one for a bill?](#h_4d7ae4a3b3) for more information.
428
428
 
429
- **Q2. How can I update the GST/VAT profile for a line item?**
429
+ **Q2. How can I update the GST profile for a line item?**
430
430
 
431
- - Ensure that a GST/VAT setting has been selected (GST/VAT included in price or GST/VAT excluded in price) via the **Bill Settings.**
432
- - Afterwards, you will be able to select a GST/VAT profile for the line item.
433
- - To update the GST/VAT profile for a line item, choose from one of your organization's existing GST/VAT profiles, or **Add New**to add a new GST/VAT profile.
431
+ - Ensure that a GST setting has been selected (GST included in price or GST excluded in price) via the **Bill Settings.**
432
+ - Afterwards, you will be able to select a GST profile for the line item.
433
+ - To update the GST profile for a line item, choose from one of your organization's existing GST profiles, or **Add New**to add a new GST profile.
434
434
 
435
435
  **Q3. What is a custom item, when would I need to create one for a bill?**
436
436
 
@@ -439,9 +439,9 @@ Source: https://help.jaz.ai/en/articles/9104249-bill-line-items
439
439
 
440
440
  **Q4. Is there a restriction on the type of account I can select for an item in a bill?**
441
441
 
442
- - While there are no strict restrictions on the type of account you can select for an item in a bill, Jaz will **warn you** if you have selected an account that is not an**Expense Account or Asset account**.**Q5. Why do I not see all the GST/VAT profiles created in a bill?**
442
+ - While there are no strict restrictions on the type of account you can select for an item in a bill, Jaz will **warn you** if you have selected an account that is not an**Expense Account or Asset account**.**Q5. Why do I not see all the GST profiles created in a bill?**
443
443
 
444
- - Some of your previously created GST/VAT profiles may only apply to other business transactions such as invoices or customer credits. As such, you may not be able to select them for your bill.
444
+ - Some of your previously created GST profiles may only apply to other business transactions such as invoices or customer credits. As such, you may not be able to select them for your bill.
445
445
 
446
446
  **Q6. Why can't I edit/delete a line item from an existing bill?**
447
447
 
@@ -474,9 +474,9 @@ Source: https://help.jaz.ai/en/articles/9104248-bill-settings
474
474
 
475
475
  - Click on the **gear icon**on the right side of the screen while creating a bill. A menu should show up.
476
476
 
477
- **Q2. How to remove GST/VAT, item discount or item quantity & unit from appearing in the bill?**
477
+ **Q2. How to remove GST, item discount or item quantity & unit from appearing in the bill?**
478
478
 
479
- - To remove GST/VAT, you can adjust the default GST/VAT settings to **No GST/VAT.**
479
+ - To remove GST, you can adjust the default GST settings to **No GST.**
480
480
  - To remove item quantity & unit, you can disable both options under **Item Attributes.Q3. What are bill internal notes?**
481
481
 
482
482
  - Bill internal notes are notes added for the internal team, which will not be printed on the PDFs.
@@ -519,7 +519,7 @@ Source: https://help.jaz.ai/en/articles/9104247-create-a-bill
519
519
 
520
520
  **Q7. How do I add taxes?**
521
521
 
522
- - To add taxes for a bill, ensure that you have selected a **GST/VAT setting** under default**GST/VAT**, either**GST/VAT Included in Price** or **GST/VAT Excluded in Price**.
522
+ - To add taxes for a bill, ensure that you have selected a **GST setting** under default**GST**, either**GST Included in Price** or **GST Excluded in Price**.
523
523
  - Afterwards, you will be able to select a tax profile at a line item level.
524
524
  - These taxes will also show up in the bill total summary.
525
525
 
@@ -655,26 +655,26 @@ Pretty Case offers four formatting styles:
655
655
 
656
656
  These options make it easy to standardize text formats across bill item descriptions, unit fields, and other text-based fields.
657
657
 
658
- **Q9. How to adjust GST/VAT in Bills?**
658
+ **Q9. How to adjust GST in Bills?**
659
659
 
660
- - Click the GST/VAT amount in the totals section when editing a bill transaction.
660
+ - Click the GST amount in the totals section when editing a bill transaction.
661
661
 
662
- **Q10. Which transactions allow GST/VAT adjustments?**
662
+ **Q10. Which transactions allow GST adjustments?**
663
663
 
664
- - You can utilize GST/VAT adjustments for the following transactions:
664
+ - You can utilize GST adjustments for the following transactions:
665
665
  - [Invoices](https://help.jaz.ai/en/articles/9094439-edit-invoice)
666
666
  - [Customer Credit Notes](https://help.jaz.ai/en/articles/9101355-edit-customer-credit)
667
667
  - Bills
668
668
  - [Supplier Credit Notes](https://help.jaz.ai/en/articles/9115435-edit-supplier-credit)
669
669
 
670
- **Q11. What impact will GST/VAT adjustments have?**
670
+ **Q11. What impact will GST adjustments have?**
671
671
 
672
- - Adjustments affect the GST/VAT total and transaction total. All amounts in reports are impacted but not recorded in the ledger.
672
+ - Adjustments affect the GST total and transaction total. All amounts in reports are impacted but not recorded in the ledger.
673
673
 
674
- **Q12. Where can I see reports showing GST/VAT adjustments?**
674
+ **Q12. Where can I see reports showing GST adjustments?**
675
675
 
676
- - GST/VAT adjustments are shown in the "GST/VAT Adj. (Source)" and "GST/VAT Adj. (Notes)" columns in:
677
- - GST/VAT Ledger and related reports
676
+ - GST adjustments are shown in the "GST Adj. (Source)" and "GST Adj. (Notes)" columns in:
677
+ - GST Ledger and related reports
678
678
  - Sales/Purchases Summary reports
679
679
  - Note: Adjustments are displayed in the item details column. No new adjustment columns are added to the Sales/Purchase Summary report.
680
680
 
@@ -699,39 +699,11 @@ These options make it easy to standardize text formats across bill item descript
699
699
  - Description (with classifier support)
700
700
  - Quantity, Unit, Price, Discount
701
701
  - Account
702
- - VAT/GST Profile
702
+ - GST Profile
703
703
  - Smart locking ensures only unlocked fields are editable, reducing errors.
704
704
 
705
705
  ---
706
706
 
707
- ### Saved Search (Bills)
708
- Source: https://help.jaz.ai/en/articles/11324613-saved-search-bills
709
-
710
- **Q1: What is Saved Search in Bills?**
711
-
712
- - Saved Search lets you store commonly used filters for faster access when working with Bills
713
-
714
- **Q2: What filters can I use in a Saved Search (Bills)?**
715
-
716
- - Saved Searches support:
717
- - Numeric ranges (e.g., amount ranges)
718
- - Date ranges (e.g., specific time periods)
719
- - Text filters (e.g., reference numbers, contact names)
720
-
721
- **Q3: Can I edit or delete a Saved Search (Bills)?**
722
-
723
- - Yes. You can edit or delete Saved Searches using the same modal where you created them.
724
-
725
- **Q4: Can I apply multiple Saved Searches at once?**
726
-
727
- - No. Only one Saved Search can be active at a time. It behaves like a regular filter and cannot be edited inline or combined with other filters.
728
-
729
- **Q5: Are there any rules when creating a Saved Search (Bills)?**
730
-
731
- - Yes. Filters must pass strict validations—no duplicate rules or invalid combinations are allowed during setup.
732
-
733
- ---
734
-
735
707
  ### View Bills
736
708
  Source: https://help.jaz.ai/en/articles/9104252-view-bills
737
709
 
@@ -1090,13 +1062,13 @@ Source: https://help.jaz.ai/en/articles/9306134-transaction-fees-bill-payments
1090
1062
  - The **Net Cash Spent**reflects the actual spent amount, including fees**.**
1091
1063
  - On the bill details, the payment amount shown in the bill total summary will reflect the **Gross Cash Spent**or the cash spent before fees.
1092
1064
 
1093
- **Q4. How does recording GST/VAT work for transaction fees?**
1065
+ **Q4. How does recording GST work for transaction fees?**
1094
1066
 
1095
- - You can include GST/VAT on fees easily by selecting a profile.
1096
- - The summary will reflect a breakdown of the fees charged, showing the actual **fees charged**and the **GST/VAT on fees**.**Q5. How are transaction fees reflected on the general ledger?**
1067
+ - You can include GST on fees easily by selecting a profile.
1068
+ - The summary will reflect a breakdown of the fees charged, showing the actual **fees charged**and the **GST on fees**.**Q5. How are transaction fees reflected on the general ledger?**
1097
1069
 
1098
1070
  - On the general ledger, you should see a record reflecting the transaction fees charged under the expense account (e.g. **Transaction Fees & Charges**) that you have selected when recording a transaction fee.
1099
- - If you have indicated **GST/VAT included** in the transaction fees, you should see an additional record for the included GST/VAT under the**Input GST Receivable **account.
1071
+ - If you have indicated **GST included** in the transaction fees, you should see an additional record for the included GST under the**Input GST Receivable **account.
1100
1072
 
1101
1073
  ---
1102
1074
 
@@ -185,7 +185,7 @@ Source: https://help.jaz.ai/en/articles/9062379-create-customer-credit
185
185
 
186
186
  **Q11. How do I add taxes?**
187
187
 
188
- - To add taxes for a customer credit note, ensure that you have selected a **GST/VAT setting** under**default GST/VAT**, either**GST/VAT Included in Price** or **GST/VAT Excluded in Price**.
188
+ - To add taxes for a customer credit note, ensure that you have selected a **GST setting** under**default GST**, either**GST Included in Price** or **GST Excluded in Price**.
189
189
  - Afterwards, you will be able to select a tax profile at a line item level.
190
190
  - These taxes will also show up in the customer credit total summary.
191
191
 
@@ -263,11 +263,11 @@ Source: https://help.jaz.ai/en/articles/9101349-customer-credit-line-items
263
263
  - You can’t save a new item when creating a customer credit note. You need to go to the **Items List** to create a new item. Afterwards, the item will appear when creating a customer credit note. See [Items List](https://help.jaz.ai/en/articles/9094095-items-list) for more information.
264
264
  - However, you can create a new custom item. Refer to [Items List](https://help.jaz.ai/en/articles/9094095-items-list) for more information.
265
265
 
266
- **Q2. How can I update the GST/VAT profile for a line item?**
266
+ **Q2. How can I update the GST profile for a line item?**
267
267
 
268
- - Ensure that a GST/VAT setting has been selected (GST/VAT included in price or GST/VAT excluded in price) via the **Customer Credit Settings.**
269
- - Afterwards, you will be able to select a GST/VAT profile for the line item.
270
- - To update the GST/VAT profile for a line item, choose from one of your organization's existing GST/VAT profiles, or **Add New**to add a new GST/VAT profile.
268
+ - Ensure that a GST setting has been selected (GST included in price or GST excluded in price) via the **Customer Credit Settings.**
269
+ - Afterwards, you will be able to select a GST profile for the line item.
270
+ - To update the GST profile for a line item, choose from one of your organization's existing GST profiles, or **Add New**to add a new GST profile.
271
271
 
272
272
  **Q3. What is a custom item, when would I need to create one for a customer credit note?**
273
273
 
@@ -276,9 +276,9 @@ Source: https://help.jaz.ai/en/articles/9101349-customer-credit-line-items
276
276
 
277
277
  **Q4. Is there a restriction on the type of account I can select for an item in a customer credit note?**
278
278
 
279
- - While there are no strict restrictions on the type of account you can select for an item in a customer credit note, Jaz will **warn you** if you have selected an account that is not a**Revenue Account**.**Q5. Why do I not see all the VAT/Tax profiles created in a customer credit note?**
279
+ - While there are no strict restrictions on the type of account you can select for an item in a customer credit note, Jaz will **warn you** if you have selected an account that is not a**Revenue Account**.**Q5. Why do I not see all the GST profiles created in a customer credit note?**
280
280
 
281
- - Some of your previously created VAT/Tax profiles may only be applicable to other business transactions such as bills or supplier credits. As such, you may not be able to select them for your customer credit note.
281
+ - Some of your previously created GST profiles may only be applicable to other business transactions such as bills or supplier credits. As such, you may not be able to select them for your customer credit note.
282
282
 
283
283
  ---
284
284
 
@@ -289,9 +289,9 @@ Source: https://help.jaz.ai/en/articles/8937984-customer-credit-settings
289
289
 
290
290
  - Click on the **gear icon**on the right side of the screen while creating a customer credit note. A menu should show up.
291
291
 
292
- **Q2. How can I remove GST/VAT, item discount, or item quantity & unit from appearing in the customer credit note?**
292
+ **Q2. How can I remove GST, item discount, or item quantity & unit from appearing in the customer credit note?**
293
293
 
294
- - To remove GST/VAT, you can adjust the default GST/VAT settings to **No GST/VAT.**
294
+ - To remove GST, you can adjust the default GST settings to **No GST.**
295
295
  - To remove item quantity & unit, you can disable both options under **Item Attributes.**
296
296
 
297
297
  ---
@@ -388,26 +388,26 @@ Pretty Case offers four formatting styles:
388
388
 
389
389
  These options make it easy to standardize text formats across customer credit item descriptions, unit fields, and other text-based fields.
390
390
 
391
- **Q9. How to adjust GST/VAT in Customer Credit Notes?**
391
+ **Q9. How to adjust GST in Customer Credit Notes?**
392
392
 
393
- - Click the GST/VAT amount in the totals section when editing a customer credit note transaction.
393
+ - Click the GST amount in the totals section when editing a customer credit note transaction.
394
394
 
395
- **Q10. Which transactions allow GST/VAT adjustments?**
395
+ **Q10. Which transactions allow GST adjustments?**
396
396
 
397
- - You can utilize GST/VAT adjustments for the following transactions:
397
+ - You can utilize GST adjustments for the following transactions:
398
398
  - [Invoices](https://help.jaz.ai/en/articles/9094439-edit-invoice)
399
399
  - Customer Credit Notes
400
400
  - [Bills](https://help.jaz.ai/en/articles/9104253-edit-bill)
401
401
  - [Supplier Credit Notes](https://help.jaz.ai/en/articles/9115435-edit-supplier-credit)
402
402
 
403
- **Q11. What impact will GST/VAT adjustments have?**
403
+ **Q11. What impact will GST adjustments have?**
404
404
 
405
- - Adjustments affect the GST/VAT total and transaction total. All amounts in reports are impacted but not recorded in the ledger.
405
+ - Adjustments affect the GST total and transaction total. All amounts in reports are impacted but not recorded in the ledger.
406
406
 
407
- **Q12. Where can I see reports showing GST/VAT adjustments?**
407
+ **Q12. Where can I see reports showing GST adjustments?**
408
408
 
409
- - GST/VAT adjustments are shown in the "GST/VAT Adj. (Source)" and "GST/VAT Adj. (Notes)" columns in:
410
- - GST/VAT Ledger and related reports
409
+ - GST adjustments are shown in the "GST Adj. (Source)" and "GST Adj. (Notes)" columns in:
410
+ - GST Ledger and related reports
411
411
  - Sales/Purchases Summary reports
412
412
  - Note: Adjustments are displayed in the item details column. No new adjustment columns are added to the Sales/Purchase Summary report.
413
413
 
@@ -433,39 +433,11 @@ These options make it easy to standardize text formats across customer credit it
433
433
  - Description (with classifier support)
434
434
  - Quantity, Unit, Price, Discount
435
435
  - Account
436
- - VAT/GST Profile
436
+ - GST Profile
437
437
  - Smart locking ensures only unlocked fields are editable, reducing errors.
438
438
 
439
439
  ---
440
440
 
441
- ### Saved Search (Customer Credits)
442
- Source: https://help.jaz.ai/en/articles/11324634-saved-search-customer-credits
443
-
444
- **Q1: What is Saved Search in Customer Credit?**
445
-
446
- - Saved Search lets you store commonly used filters for faster access when working with Customer Credit
447
-
448
- **Q2: What filters can I use in a Saved Search (Customer Credit)?**
449
-
450
- - Saved Searches support:
451
- - Numeric ranges (e.g., amount ranges)
452
- - Date ranges (e.g., specific time periods)
453
- - Text filters (e.g., reference numbers, contact names)
454
-
455
- **Q3: Can I edit or delete a Saved Search (Customer Credit)?**
456
-
457
- - Yes. You can edit or delete Saved Searches using the same modal where you created them.
458
-
459
- **Q4: Can I apply multiple Saved Searches at once?**
460
-
461
- - No. Only one Saved Search can be active at a time. It behaves like a regular filter and cannot be edited inline or combined with other filters.
462
-
463
- **Q5: Are there any rules when creating a Saved Search (Customer Credit)?**
464
-
465
- - Yes. Filters must pass strict validations—no duplicate rules or invalid combinations are allowed during setup.
466
-
467
- ---
468
-
469
441
  ### View Customer Credit
470
442
  Source: https://help.jaz.ai/en/articles/9101354-view-customer-credit
471
443
 
@@ -713,13 +685,13 @@ Source: https://help.jaz.ai/en/articles/9306137-transaction-fees-customer-credit
713
685
  - The **Net Cash Received**reflects the actual refunded amount, including fees**.**
714
686
  - On the customer credit note details, the refund amount shown in the customer credit note's total summary will reflect the **Gross Cash Received**or the cash received after fees.
715
687
 
716
- **Q4. How does recording GST/VAT work for transaction fees?**
688
+ **Q4. How does recording GST work for transaction fees?**
717
689
 
718
- - You can include GST/VAT on fees easily by selecting a profile.
719
- - The summary will reflect a breakdown of the fees charged, showing the actual **fees charged**and the **GST/VAT on fees**.**Q5. How are transaction fees reflected on the general ledger?**
690
+ - You can include GST on fees easily by selecting a profile.
691
+ - The summary will reflect a breakdown of the fees charged, showing the actual **fees charged**and the **GST on fees**.**Q5. How are transaction fees reflected on the general ledger?**
720
692
 
721
693
  - On the general ledger, you should see a record reflecting the transaction fees charged under the expense account (e.g. **Transaction Fees & Charges**) that you have selected when recording a transaction fee.
722
- - If you have indicated **GST/VAT included** in the transaction fees, you should see an additional record for the included GST/VAT under the**Input GST Receivable **account.
694
+ - If you have indicated **GST included** in the transaction fees, you should see an additional record for the included GST under the**Input GST Receivable **account.
723
695
 
724
696
  ---
725
697