jaz-cli 2.7.0 → 2.8.0

package/assets/skills/jobs/references/supplier-recon.md

@@ -0,0 +1,330 @@
+# Supplier Statement Reconciliation
+
+Compare your accounts payable balance for a supplier against the supplier's own statement. Identify missing bills, duplicate payments, pricing discrepancies, and timing differences. This is how you catch errors before they become disputes.
+
+**CLI:** `jaz jobs supplier-recon [--supplier "Acme Corp"] [--period 2025-01] [--json]`
+
+---
+
+## Phase 1: Get Supplier Details
+
+### Step 1: Find the supplier contact
+
+If `--supplier` is specified, search by name:
+
+```
+POST /api/v1/contacts/search
+{
+  "filter": {
+    "supplier": { "eq": true },
+    "name": { "contains": "Acme Corp" }
+  },
+  "sort": { "sortBy": ["name"], "order": "ASC" },
+  "limit": 10
+}
+```
+
+If no supplier is specified, list all suppliers:
+
+```
+POST /api/v1/contacts/search
+{
+  "filter": { "supplier": { "eq": true } },
+  "sort": { "sortBy": ["name"], "order": "ASC" },
+  "limit": 100
+}
+```
+
+**What you need:** The supplier's `resourceId` and `name` for all subsequent queries.
+
+---
+
+## Phase 2: Pull Your Records
+
+### Step 2: List all bills for the supplier in the period
+
+```
+POST /api/v1/bills/search
+{
+  "filter": {
+    "contactResourceId": { "eq": "<supplier-uuid>" },
+    "status": { "in": ["POSTED", "VOIDED"] },
+    "valueDate": { "between": ["2025-01-01", "2025-01-31"] }
+  },
+  "sort": { "sortBy": ["valueDate"], "order": "ASC" },
+  "limit": 1000
+}
+```
+
+**Include VOIDED status** — you need to see voided bills to explain differences (e.g., "we voided your invoice #123 because it was a duplicate").
+
+**Record for each bill:**
+- Reference number
+- Date
+- Total amount
+- Balance amount (how much is still unpaid)
+- Status
+
+### Step 3: List all payments to the supplier in the period
+
+Search for payment transactions against the supplier's bills. First, get all bills (from Step 2), then check each bill's payment records:
+
+```
+GET /api/v1/bills/{billResourceId}/payments
+```
+
+Alternatively, search cashflow transactions for supplier payments:
+
+```
+POST /api/v1/cashflow-transactions/search
+{
+  "filter": {
+    "contact": { "name": { "eq": "Acme Corp" } },
+    "businessTransactionType": { "in": ["PURCHASE"] },
+    "direction": { "eq": "PAYOUT" },
+    "valueDate": { "between": ["2025-01-01", "2025-01-31"] }
+  },
+  "sort": { "sortBy": ["valueDate"], "order": "ASC" },
+  "limit": 1000
+}
+```
+
+### Step 4: List any supplier credit notes
+
+```
+POST /api/v1/supplier-credit-notes/search
+{
+  "filter": {
+    "contactResourceId": { "eq": "<supplier-uuid>" },
+    "status": { "eq": "POSTED" },
+    "valueDate": { "between": ["2025-01-01", "2025-01-31"] }
+  },
+  "sort": { "sortBy": ["valueDate"], "order": "ASC" },
+  "limit": 100
+}
+```
+
+---
+
+## Phase 3: Get the Supplier Statement Balance
+
+### Step 5: Determine the AP balance per your books
+
+Get the AP balance for this specific supplier from the AP aging report:
+
+```
+POST /api/v1/generate-reports/ap-report
+{ "endDate": "2025-01-31" }
+```
+
+Look for the supplier in the report output and note their total balance.
+
+Alternatively, for a quick per-supplier calculation:
+
+```
+POST /api/v1/bills/search
+{
+  "filter": {
+    "contactResourceId": { "eq": "<supplier-uuid>" },
+    "status": { "eq": "POSTED" },
+    "balanceAmount": { "gt": 0 }
+  },
+  "sort": { "sortBy": ["dueDate"], "order": "ASC" },
+  "limit": 1000
+}
+```
+
+Sum the `balanceAmount` from all results = your AP balance for this supplier.
+
+### Step 6: Compare to supplier's statement
+
+The supplier's statement is an external document — you'll have it as a PDF, email, or portal download. The key figure is their **closing balance** for the period.
+
+**The reconciliation equation:**
+
+```
+Your AP balance (from Step 5)
+  SHOULD EQUAL
+Supplier's statement closing balance
+
+If they don't match, the difference is explained by reconciling items (Phase 4).
+```
+
+---
+
+## Phase 4: Identify Differences
+
+Work through each discrepancy type systematically.
+
+### Difference Type 1: Missing bills (in supplier statement, not in your books)
+
+The supplier has invoiced you, but the bill isn't entered in Jaz.
+
+**Common causes:**
+- Bill arrived late (still in someone's inbox or physical mailbox)
+- Bill was emailed to the wrong person
+- Bill was received but not yet entered by the bookkeeper
+
+**Resolution:** Obtain the bill from the supplier and enter it:
+
+```
+POST /api/v1/bills
+{
+  "contactResourceId": "<supplier-uuid>",
+  "saveAsDraft": false,
+  "reference": "BILL-MISSING-001",
+  "valueDate": "2025-01-15",
+  "dueDate": "2025-02-14",
+  "lineItems": [{
+    "name": "Office supplies — Jan 2025",
+    "unitPrice": 850.00,
+    "quantity": 1,
+    "accountResourceId": "<expense-account-uuid>",
+    "taxProfileResourceId": "<tax-profile-uuid>"
+  }]
+}
+```
+
+Or use Jaz Magic if you have the document:
+
+```
+POST /api/v1/magic/createBusinessTransactionFromAttachment
+Content-Type: multipart/form-data
+
+Fields:
+  - sourceFile: <PDF of the missing bill>
+  - businessTransactionType: "BILL"
+  - sourceType: "FILE"
+```
+
+### Difference Type 2: Duplicate payments
+
+You paid the same bill twice, or the supplier hasn't credited a payment you made.
+
+**How to check:** Look for two payments with the same amount and similar dates against different bills from the same supplier.
+
+**Resolution:**
+- If genuinely paid twice → request a refund or credit note from the supplier
+- If the supplier hasn't recorded your payment → send them the bank transfer reference/proof
+
+### Difference Type 3: Timing differences
+
+The most common and least worrying type. Your payment was made on Jan 30 but the supplier didn't record it until Feb 3.
+
+**Resolution:** No action needed — these resolve themselves in the next period. Note them as reconciling items.
+
+### Difference Type 4: Pricing discrepancies
+
+The supplier's invoice amount differs from what you expected (wrong unit price, quantity, or missing discount).
+
+**Resolution:**
+- Contact the supplier to clarify
+- If they agree to the correction → request a supplier credit note
+- Enter the credit note when received:
+
+```
+POST /api/v1/supplier-credit-notes
+{
+  "contactResourceId": "<supplier-uuid>",
+  "saveAsDraft": false,
+  "reference": "SCN-DISPUTE-001",
+  "valueDate": "2025-01-31",
+  "lineItems": [{
+    "name": "Price correction — Invoice #12345",
+    "unitPrice": 150.00,
+    "quantity": 1,
+    "accountResourceId": "<expense-account-uuid>",
+    "taxProfileResourceId": "<tax-profile-uuid>"
+  }]
+}
+```
+
+### Difference Type 5: Bills in your books, not in supplier statement
+
+You have a bill entered, but the supplier doesn't show it.
+
+**Common causes:**
+- You entered a bill from a pro-forma/estimate instead of the actual invoice
+- The bill was entered under the wrong supplier contact
+- The supplier issued a credit note you haven't processed
+
+**Resolution:** Investigate and either void the incorrect bill or request clarification from the supplier.
+
+---
+
+## Phase 5: Verification
+
+### Step 7: Re-check after adjustments
+
+After entering missing bills, credit notes, and resolving discrepancies:
+
+```
+POST /api/v1/bills/search
+{
+  "filter": {
+    "contactResourceId": { "eq": "<supplier-uuid>" },
+    "status": { "eq": "POSTED" },
+    "balanceAmount": { "gt": 0 }
+  },
+  "sort": { "sortBy": ["dueDate"], "order": "ASC" },
+  "limit": 1000
+}
+```
+
+Sum `balanceAmount` again. The difference between this and the supplier's statement should now be explainable entirely by timing differences.
+
+### Step 8: Verify AP aging
+
+```
+POST /api/v1/generate-reports/ap-report
+{ "endDate": "2025-01-31" }
+```
+
+**What to check:**
+- Supplier's balance reflects all adjustments
+- Total AP still ties to the Accounts Payable control account on the trial balance
+
+---
+
+## Supplier Recon Checklist (Quick Reference)
+
+| # | Step | Phase | What |
+|---|------|-------|------|
+| 1 | Find supplier contact | Setup | Search contacts with supplier=true |
+| 2 | List bills for period | Your records | Bills by contact + date range |
+| 3 | List payments for period | Your records | Payment records per bill |
+| 4 | List credit notes | Your records | Supplier credit notes in period |
+| 5 | Get your AP balance | Compare | Sum of unpaid bill balances |
+| 6 | Compare to supplier statement | Compare | External document comparison |
+| — | Missing bills | Resolve | Enter missing, use Jaz Magic |
+| — | Duplicate payments | Resolve | Request refund/credit |
+| — | Timing differences | Resolve | Note only, resolves next period |
+| — | Pricing discrepancies | Resolve | Request supplier credit note |
+| — | Phantom bills | Resolve | Investigate and void if needed |
+| 7 | Re-check balance | Verify | Should match or explain difference |
+| 8 | Verify AP aging | Verify | Total AP ties to trial balance |
+
+---
+
+## Common Discrepancy Types (Summary)
+
+| Type | Direction | Action |
+|------|-----------|--------|
+| Missing bill | You owe more than your books show | Enter the bill |
+| Duplicate payment | You've overpaid | Request refund or credit |
+| Timing difference | Payment in transit | No action, resolves next period |
+| Price discrepancy | Amount disagrees | Request credit note or re-invoice |
+| Phantom bill | Your books show more than supplier | Investigate, void if error |
+| Unapplied credit | Credit note not yet applied | Apply to outstanding bill |
+
+---
+
+## Tips for SMBs
+
+**Do this quarterly at minimum, monthly for high-volume suppliers.** Most supplier disputes become much harder to resolve after 90 days because people forget the details and documents get lost.
+
+**Request statements proactively.** Don't wait for the supplier to send one — email their accounts department at the start of each quarter requesting a statement for the prior period. Many suppliers have online portals where you can download statements on demand.
+
+**The most common issue is missing bills.** In our experience, 80% of supplier recon differences are bills you haven't entered yet. The fix is process, not technology — create a shared inbox or folder for bills and check it daily.
+
+**GST implications of discrepancies.** If you discover missing bills during reconciliation, the input tax claim on those bills belongs to the quarter the bill is dated, not when you entered it. If you've already filed the GST return for that quarter, you may need to adjust in the next return or file a voluntary disclosure.

package/assets/skills/jobs/references/year-end-close.md

@@ -0,0 +1,341 @@
+# Year-End Close
+
+The annual close builds on the quarterly close. It is quarter-end close repeated four times, plus a set of year-end-specific adjustments — true-ups, dividends, retained earnings rollover, final GST reconciliation, and audit preparation. For most SMBs, the annual extras add 2-5 days of work depending on complexity and whether an external audit is required.
+
+**CLI:** `jaz jobs year-end --period 2025 [--currency SGD] [--json]`
+
+**Standalone vs Incremental:**
+- **Standalone (default):** Generates the full plan — all quarterly close steps for each of the four quarters, followed by the annual extras. Use this when quarters haven't been closed yet.
+- **Incremental (`--incremental`):** Generates only the annual extras below. Use this when all four quarters are already closed and locked.
+
+---
+
+## Phase 1–7: Quarterly Close (x4)
+
+Complete the full quarter-end close for each quarter in the year. Each quarter follows the monthly close (x3) plus quarterly extras pattern.
+
+**Reference:** `references/quarter-end-close.md`
+
+| FY | Q1 | Q2 | Q3 | Q4 |
+|----|----|----|----|----|
+| Calendar year | Jan–Mar | Apr–Jun | Jul–Sep | Oct–Dec |
+
+**Important:** Close quarters in order. Q1 must be locked before starting Q2, and so on. The annual extras run after Q4 is closed. By the time you reach this phase, all 12 months are individually closed, all four quarterly GST returns are filed, and all quarterly provisions are up to date.
+
+---
+
+## Phase 8: Annual Extras
+
+These steps run once per year, after all four quarters are closed. They address items that are inherently annual — full-year depreciation reconciliation, true-ups against actuals, dividends, retained earnings rollover, and audit preparation.
+
+### Step Y1: Final depreciation run
+
+Verify the full year's depreciation is correctly recorded and reconciles to the fixed asset register.
+
+**Recipe:** `declining-balance` | **Calculator:** `jaz calc depreciation`
+
+**Step-by-step:**
+
+1. Pull the fixed asset register as at year-end:
+```
+POST /generate-reports/fixed-assets-summary
+{}
+```
+
+2. For each asset class, verify that 12 months of depreciation have been recorded. If using Jaz native FA depreciation (straight-line), this should be automatic. If using manual journals for non-standard methods (DDB, 150DB), verify all 12 monthly entries exist.
+
+3. Run the calculator for each non-standard asset to confirm the full-year charge:
+```bash
+jaz calc depreciation --cost 50000 --salvage 5000 --life 5 --method ddb --frequency monthly --json
+```
+
+4. Reconcile accumulated depreciation per the FA register to accumulated depreciation per the trial balance:
+```
+POST /generate-reports/trial-balance
+{ "startDate": "2025-01-01", "endDate": "2025-12-31" }
+```
+
+**What to check:**
+- Depreciation expense on P&L = sum of all 12 monthly depreciation charges
+- Accumulated depreciation on balance sheet = prior year balance + current year depreciation - accumulated depreciation on disposed assets
+- FA register NBV (net book value) per asset ties to the balance sheet total
+- No asset has been depreciated below its salvage value
+
+**Conditional:** Always, if fixed assets exist. Even if depreciation runs automatically, verify it at year-end. Auditors will test this.
+
+### Step Y2: Year-end true-ups
+
+Reconcile accruals to actuals and post adjustments. Three components:
+
+#### a) Leave balance true-up
+
+Monthly closes accrued a fixed amount for leave liability. At year-end, reconcile to actual leave balances.
+
+**Recipe:** `employee-accruals`
+
+```
+POST /journals
+{
+  "valueDate": "2025-12-31",
+  "reference": "YE-LEAVE-TRUEUP-FY25",
+  "journalEntries": [
+    { "accountResourceId": "<leave-expense>", "amount": 3200.00, "type": "DEBIT", "name": "Leave accrual true-up — FY2025 (actual vs accrued)" },
+    { "accountResourceId": "<leave-liability>", "amount": 3200.00, "type": "CREDIT", "name": "Leave accrual true-up — FY2025 (actual vs accrued)" }
+  ]
+}
+```
+
+**What to check:** Leave liability on balance sheet should equal (unused leave days x daily rate) for each employee. If accrual > actual, reverse the excess (DR Leave Liability, CR Leave Expense).
+
+**Conditional:** Only if you track leave balances in the books. Most SMBs with 5+ employees should.
+
+#### b) Bonus true-up
+
+Quarterly closes maintained the bonus accrual estimate. At year-end, true up to actual bonus amounts declared.
+
+**Recipe:** `employee-accruals` (bonus component)
+
+```
+POST /journals
+{
+  "valueDate": "2025-12-31",
+  "reference": "YE-BONUS-TRUEUP-FY25",
+  "journalEntries": [
+    { "accountResourceId": "<bonus-expense>", "amount": 5000.00, "type": "DEBIT", "name": "Bonus true-up — FY2025 (actual declared vs accrued)" },
+    { "accountResourceId": "<bonus-liability>", "amount": 5000.00, "type": "CREDIT", "name": "Bonus true-up — FY2025 (actual declared vs accrued)" }
+  ]
+}
+```
+
+**What to check:** Bonus liability on balance sheet = actual bonuses declared but not yet paid. If over-accrued, reverse the excess.
+
+**Conditional:** Only if the business has bonus schemes.
+
+#### c) Provision reassessment (IAS 37)
+
+At year-end, reassess all provisions — not just unwind the discount, but review whether the provision amount itself is still the best estimate.
+
+**Recipe:** `provisions`
+
+**What to check for each provision:**
+- Is the obligating event still valid? (If resolved, release the provision.)
+- Has the best estimate changed? (Adjust up or down.)
+- Has the discount rate changed? (Re-measure at current rate, post the difference.)
+- Has the expected settlement date changed? (Adjust the unwinding schedule.)
+
+Post adjustment journals for any changes. Document the reasoning — auditors will review provision assessments.
+
+**Conditional:** Only if IAS 37 provisions exist. Most simple SMBs can skip this.
+
+### Step Y3: Dividend declaration and payment
+
+If the business is declaring dividends for the fiscal year, post two journals — one for declaration and one for payment. These are distinct accounting events.
+
+**Recipe:** `dividend`
+
+#### Declaration (board resolution date):
+
+```
+POST /journals
+{
+  "valueDate": "2025-12-31",
+  "reference": "YE-DIV-DECLARE-FY25",
+  "journalEntries": [
+    { "accountResourceId": "<retained-earnings>", "amount": 50000.00, "type": "DEBIT", "name": "Dividend declared — FY2025" },
+    { "accountResourceId": "<dividends-payable>", "amount": 50000.00, "type": "CREDIT", "name": "Dividend declared — FY2025" }
+  ]
+}
+```
+
+#### Payment (actual payment date):
+
+```
+POST /journals
+{
+  "valueDate": "2026-01-15",
+  "reference": "YE-DIV-PAY-FY25",
+  "journalEntries": [
+    { "accountResourceId": "<dividends-payable>", "amount": 50000.00, "type": "DEBIT", "name": "Dividend paid — FY2025" },
+    { "accountResourceId": "<bank-account>", "amount": 50000.00, "type": "CREDIT", "name": "Dividend paid — FY2025" }
+  ]
+}
+```
+
+**Note:** Declaration often falls in the current FY (e.g., Dec 31), but payment may fall in the next FY (e.g., Jan 15). The declaration journal reduces retained earnings in the current year. The payment journal just clears the liability — no P&L impact.
+
+**For Singapore:** Dividends are tax-exempt in the hands of the shareholder (one-tier system). No withholding tax. No additional tax journal needed.
+
+**For Philippines:** Dividends to resident individuals are subject to 10% final withholding tax. Post the withholding tax separately (DR Dividends Payable, CR Withholding Tax Payable) and remit to BIR.
+
+**Conditional:** Only if the business is declaring dividends. Many SMBs retain all earnings. Skip if no dividend resolution.
+
+### Step Y4: Retained earnings rollover (Current Year Earnings)
+
+Jaz auto-manages the annual rollover of Current Year Earnings (CYE) into Retained Earnings at the start of each new fiscal year. The net P&L for the year is accumulated in CYE during the year, then rolled forward.
+
+**What to verify:**
+
+1. Pull the equity movement report:
+```
+POST /generate-reports/equity-movement
+{ "primarySnapshotStartDate": "2025-01-01", "primarySnapshotEndDate": "2025-12-31" }
+```
+
+2. Confirm:
+   - CYE balance at year-end = Net profit (or loss) for the year per P&L
+   - Retained Earnings opening balance = prior year closing Retained Earnings
+   - After rollover (in the new year): CYE resets to zero, Retained Earnings increases by last year's net profit (less any dividends declared)
+
+**Tip:** If CYE doesn't match the P&L bottom line, there's a posting error somewhere — most likely a journal posted directly to an equity account that shouldn't have been.
+
+**No journal needed** — this is a platform-managed rollover. Your job is to verify it happened correctly.
+
+### Step Y5: Final GST/VAT reconciliation
+
+Reconcile the full year's GST/VAT against all four quarterly returns (or twelve monthly returns for PH).
+
+```
+POST /generate-reports/vat-ledger
+{ "startDate": "2025-01-01", "endDate": "2025-12-31" }
+```
+
+**What to check:**
+
+1. Annual output tax per tax ledger = sum of output tax across all four quarterly returns
+2. Annual input tax per tax ledger = sum of input tax across all four quarterly returns
+3. Net GST paid/refunded during the year = sum of all quarterly GST payments/refunds
+4. GST control account on trial balance = net GST payable/receivable for Q4 (if Q1–Q3 already settled)
+5. No orphan transactions — every taxable invoice and bill is accounted for in the tax ledger
+
+**For Singapore:** IRAS may request the Annual GST Return (GST F8) for certain businesses. The annual reconciliation feeds directly into this.
+
+**For Philippines:** Cross-check annual totals against the Summary List of Sales (SLS) and Summary List of Purchases (SLP) required by BIR.
+
+**Tip:** If the annual tax ledger total doesn't match the sum of quarterly returns, the most common causes are: (a) transactions entered after the quarterly filing with a backdated date, (b) credit notes or amendments posted in a later quarter, (c) reclassification of tax codes mid-year.
+
+### Step Y6: Audit preparation
+
+Compile all reports, reconciliation schedules, and supporting documentation for the external auditor or tax preparer.
+
+**Reference:** `references/audit-prep.md` for the full audit preparation job.
+
+At minimum, generate and export:
+
+| Report | API Call |
+|--------|----------|
+| Trial Balance (full year) | `POST /generate-reports/trial-balance { "startDate": "2025-01-01", "endDate": "2025-12-31" }` |
+| Balance Sheet (year-end) | `POST /generate-reports/balance-sheet { "primarySnapshotDate": "2025-12-31" }` |
+| P&L (full year) | `POST /generate-reports/profit-and-loss { "primarySnapshotDate": "2025-12-31", "secondarySnapshotDate": "2025-01-01" }` |
+| General Ledger (full year) | `POST /generate-reports/general-ledger { "startDate": "2025-01-01", "endDate": "2025-12-31", "groupBy": "ACCOUNT" }` |
+| Cashflow Statement | `POST /generate-reports/cashflow { "primaryStartDate": "2025-01-01", "primaryEndDate": "2025-12-31" }` |
+| AR Aging (year-end) | `POST /generate-reports/ar-report { "endDate": "2025-12-31" }` |
+| AP Aging (year-end) | `POST /generate-reports/ap-report { "endDate": "2025-12-31" }` |
+| FA Register | `POST /generate-reports/fixed-assets-summary {}` |
+| Tax Ledger (full year) | `POST /generate-reports/vat-ledger { "startDate": "2025-01-01", "endDate": "2025-12-31" }` |
+| Equity Movement | `POST /generate-reports/equity-movement { "primarySnapshotStartDate": "2025-01-01", "primarySnapshotEndDate": "2025-12-31" }` |
+
+**Supporting schedules to prepare:**
+- Bank reconciliation statements for each bank account at year-end
+- ECL provision calculation workpaper (from Q4 Step Q2)
+- Fixed asset movement schedule (additions, disposals, depreciation, NBV)
+- Intercompany balance confirmation letters (if multi-entity)
+- Loan amortization schedules with principal/interest split
+- Provision schedules with movement analysis
+
+**Conditional:** Always for audited entities. For non-audited SMBs, at minimum prepare TB + BS + P&L for tax filing purposes.
+
+### Step Y7: Final lock date
+
+Lock the entire fiscal year. This prevents any accidental or unauthorized entries into the closed year.
+
+**Best practice:** Set the org lock date to the last day of the fiscal year (e.g., `2025-12-31`).
+
+**Important considerations:**
+- Confirm with the auditor that they have no remaining adjustments before locking. Many auditors request a "soft close" first, with the hard lock applied after audit adjustments are posted.
+- If using an audit adjustments period (e.g., January 1–15 of the new year for audit entries), set the lock date after those entries are complete.
+- Once locked, reopening requires admin action and should be documented.
+
+---
+
+## Phase 9: Annual Verification
+
+Run the standard period verification (see `references/building-blocks.md` — Period Verification Pattern) for the full year, plus these annual-specific checks.
+
+### Standard verification (full year)
+
+```
+POST /generate-reports/trial-balance
+{ "startDate": "2025-01-01", "endDate": "2025-12-31" }
+```
+
+```
+POST /generate-reports/profit-and-loss
+{ "primarySnapshotDate": "2025-12-31", "secondarySnapshotDate": "2025-01-01" }
+```
+
+```
+POST /generate-reports/balance-sheet
+{ "primarySnapshotDate": "2025-12-31" }
+```
+
+### Annual-specific checks
+
+**CYE rollover check:**
+- Current Year Earnings at year-end = Net profit per the annual P&L
+- After the new FY opens: CYE resets to zero, Retained Earnings increases by the prior year's net profit (less dividends)
+- Total equity movement = Net profit - Dividends declared + Other equity movements (capital injection, etc.)
+
+**Annual P&L vs monthly P&Ls sum:**
+- Generate P&L for each of the 12 months individually
+- Sum all 12 monthly net profit figures
+- This sum MUST equal the annual P&L net profit
+- If it doesn't, there's a timing/posting error — most commonly a journal posted to a month that was supposed to be locked
+
+**FA register reconciliation:**
+- NBV per FA register = Cost less accumulated depreciation per balance sheet
+- Depreciation expense per FA register = Depreciation expense per P&L
+- Asset count per FA register = physical count (if performed)
+- Any fully depreciated assets still in use should be noted but not removed from register
+
+**Provision balances:**
+- Each provision on the balance sheet has documented support (IAS 37 criteria met)
+- Provision movement = Opening + New provisions + Unwinding - Utilizations - Releases
+- Unwinding total for the year = sum of four quarterly unwinding entries
+
+**Intercompany elimination (if consolidating):**
+- All intercompany balances net to zero across the group
+- Intercompany revenue/expense eliminated on consolidation
+- No intercompany profit in inventory or fixed assets (if applicable)
+
+---
+
+## Year-End Close Checklist (Quick Reference)
+
+| # | Step | Phase | Conditional | Recipe/Calc |
+|---|------|-------|-------------|-------------|
+| 1–18 | Q1 Month 1 close | Monthly | Always | See month-end-close.md |
+| 1–18 | Q1 Month 2 close | Monthly | Always | See month-end-close.md |
+| 1–18 | Q1 Month 3 close | Monthly | Always | See month-end-close.md |
+| Q1–Q5 | Q1 quarterly extras | Quarterly | See quarter-end-close.md | See quarter-end-close.md |
+| 1–18 | Q2 Month 1 close | Monthly | Always | See month-end-close.md |
+| 1–18 | Q2 Month 2 close | Monthly | Always | See month-end-close.md |
+| 1–18 | Q2 Month 3 close | Monthly | Always | See month-end-close.md |
+| Q1–Q5 | Q2 quarterly extras | Quarterly | See quarter-end-close.md | See quarter-end-close.md |
+| 1–18 | Q3 Month 1 close | Monthly | Always | See month-end-close.md |
+| 1–18 | Q3 Month 2 close | Monthly | Always | See month-end-close.md |
+| 1–18 | Q3 Month 3 close | Monthly | Always | See month-end-close.md |
+| Q1–Q5 | Q3 quarterly extras | Quarterly | See quarter-end-close.md | See quarter-end-close.md |
+| 1–18 | Q4 Month 1 close | Monthly | Always | See month-end-close.md |
+| 1–18 | Q4 Month 2 close | Monthly | Always | See month-end-close.md |
+| 1–18 | Q4 Month 3 close | Monthly | Always | See month-end-close.md |
+| Q1–Q5 | Q4 quarterly extras | Quarterly | See quarter-end-close.md | See quarter-end-close.md |
+| Y1 | Final depreciation run | Annual | If fixed assets exist | declining-balance / `jaz calc depreciation` |
+| Y2a | Leave balance true-up | Annual | If tracking leave | employee-accruals |
+| Y2b | Bonus true-up | Annual | If bonus schemes exist | employee-accruals |
+| Y2c | Provision reassessment | Annual | If IAS 37 provisions exist | provisions |
+| Y3 | Dividend declaration & payment | Annual | If declaring dividends | dividend |
+| Y4 | Retained earnings rollover (CYE) | Annual | Always (verify only) | — |
+| Y5 | Final GST/VAT reconciliation | Annual | Always (if GST-registered) | gst-vat-filing job |
+| Y6 | Audit preparation | Annual | Always (scope varies) | audit-prep job |
+| Y7 | Final lock date | Annual | Always | — |
+| V | Annual verification | Verification | Always | — |

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

@@ -1,6 +1,6 @@
 ---
 name: transaction-recipes
-version: 2.7.0
+version: 2.8.0
 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 10 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.