jaz-clio 4.51.0 → 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.
- package/README.md +12 -7
- package/assets/skills/api/SKILL.md +26 -4
- package/assets/skills/api/help-center-mirror/bank-reconciliations.md +8 -10
- package/assets/skills/api/help-center-mirror/bills.md +23 -51
- package/assets/skills/api/help-center-mirror/customer-credits.md +23 -51
- package/assets/skills/api/help-center-mirror/get-started.md +79 -104
- package/assets/skills/api/help-center-mirror/help-center-embeddings.json +1 -1
- package/assets/skills/api/help-center-mirror/help-center-index.json +1 -1
- package/assets/skills/api/help-center-mirror/import-data.md +2 -2
- package/assets/skills/api/help-center-mirror/index.md +7 -6
- package/assets/skills/api/help-center-mirror/invoices.md +26 -54
- package/assets/skills/api/help-center-mirror/journal-entries.md +4 -4
- package/assets/skills/api/help-center-mirror/reports.md +9 -5
- package/assets/skills/api/help-center-mirror/settings.md +393 -160
- package/assets/skills/api/help-center-mirror/supplier-credits.md +25 -53
- package/assets/skills/api/references/endpoints.md +152 -1
- package/assets/skills/api/references/field-map.md +19 -2
- package/assets/skills/api/references/full-api-surface.md +22 -1
- package/assets/skills/api/references/search-enums.md +15 -0
- package/assets/skills/api/references/search-reference.md +45 -0
- package/assets/skills/api/references/search-syntax.md +303 -0
- package/assets/skills/cli/SKILL.md +65 -3
- package/assets/skills/cli/references/command-catalog.md +20 -2
- package/assets/skills/cli/references/field-guide.md +78 -0
- package/assets/skills/conversion/SKILL.md +1 -1
- package/assets/skills/jobs/SKILL.md +1 -1
- package/assets/skills/transaction-recipes/SKILL.md +1 -1
- package/cli.mjs +437 -429
- package/help-center-mirror/bank-reconciliations.md +8 -10
- package/help-center-mirror/bills.md +23 -51
- package/help-center-mirror/customer-credits.md +23 -51
- package/help-center-mirror/fixed-assets.md +117 -0
- package/help-center-mirror/get-started.md +79 -104
- package/help-center-mirror/help-center-embeddings.json +1 -1
- package/help-center-mirror/help-center-index.json +1 -1
- package/help-center-mirror/import-data.md +2 -2
- package/help-center-mirror/index.md +7 -6
- package/help-center-mirror/invoices.md +26 -54
- package/help-center-mirror/journal-entries.md +4 -4
- package/help-center-mirror/reports.md +9 -5
- package/help-center-mirror/settings.md +393 -160
- package/help-center-mirror/supplier-credits.md +25 -53
- 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-
|
|
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
|
-
|
|
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) —
|
|
22
|
-
- [MCP Server](#mcp-server) —
|
|
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** |
|
|
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
|
+
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
|
-
|
|
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.
|
|
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-
|
|
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
|
|
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
|
|
116
|
-
- **Payment Recognition**: Magic Match
|
|
117
|
-
- **Multidimensional Matching**:
|
|
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),
|
|
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
|
-
|
|
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
|
|
429
|
+
**Q2. How can I update the GST profile for a line item?**
|
|
430
430
|
|
|
431
|
-
- Ensure that a GST
|
|
432
|
-
- Afterwards, you will be able to select a GST
|
|
433
|
-
- To update the GST
|
|
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
|
|
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
|
|
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
|
|
477
|
+
**Q2. How to remove GST, item discount or item quantity & unit from appearing in the bill?**
|
|
478
478
|
|
|
479
|
-
- To remove GST
|
|
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
|
|
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
|
|
658
|
+
**Q9. How to adjust GST in Bills?**
|
|
659
659
|
|
|
660
|
-
- Click the GST
|
|
660
|
+
- Click the GST amount in the totals section when editing a bill transaction.
|
|
661
661
|
|
|
662
|
-
**Q10. Which transactions allow GST
|
|
662
|
+
**Q10. Which transactions allow GST adjustments?**
|
|
663
663
|
|
|
664
|
-
- You can utilize GST
|
|
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
|
|
670
|
+
**Q11. What impact will GST adjustments have?**
|
|
671
671
|
|
|
672
|
-
- Adjustments affect the GST
|
|
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
|
|
674
|
+
**Q12. Where can I see reports showing GST adjustments?**
|
|
675
675
|
|
|
676
|
-
- GST
|
|
677
|
-
- GST
|
|
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
|
-
-
|
|
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
|
|
1065
|
+
**Q4. How does recording GST work for transaction fees?**
|
|
1094
1066
|
|
|
1095
|
-
- You can include GST
|
|
1096
|
-
- The summary will reflect a breakdown of the fees charged, showing the actual **fees charged**and the **GST
|
|
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
|
|
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
|
|
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
|
|
266
|
+
**Q2. How can I update the GST profile for a line item?**
|
|
267
267
|
|
|
268
|
-
- Ensure that a GST
|
|
269
|
-
- Afterwards, you will be able to select a GST
|
|
270
|
-
- To update the GST
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
391
|
+
**Q9. How to adjust GST in Customer Credit Notes?**
|
|
392
392
|
|
|
393
|
-
- Click the GST
|
|
393
|
+
- Click the GST amount in the totals section when editing a customer credit note transaction.
|
|
394
394
|
|
|
395
|
-
**Q10. Which transactions allow GST
|
|
395
|
+
**Q10. Which transactions allow GST adjustments?**
|
|
396
396
|
|
|
397
|
-
- You can utilize GST
|
|
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
|
|
403
|
+
**Q11. What impact will GST adjustments have?**
|
|
404
404
|
|
|
405
|
-
- Adjustments affect the GST
|
|
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
|
|
407
|
+
**Q12. Where can I see reports showing GST adjustments?**
|
|
408
408
|
|
|
409
|
-
- GST
|
|
410
|
-
- GST
|
|
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
|
-
-
|
|
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
|
|
688
|
+
**Q4. How does recording GST work for transaction fees?**
|
|
717
689
|
|
|
718
|
-
- You can include GST
|
|
719
|
-
- The summary will reflect a breakdown of the fees charged, showing the actual **fees charged**and the **GST
|
|
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
|
|
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
|
|