Admin · Setup

Import workbench

Paste JSON, see exactly what it will do, then apply through an audited database function. Applies run as you, so sign in first.

You are signed out

Previews still work, but every apply will be refused. Go to login.

EnvironmentReadyRoot env loaded

Remote writesTest windowGuarded CLIs

Bootstrap payloadValid1 company, 48 periods

Schema apply50 workbenchespnpm v2:migration-status

Finance

Tax setup

Back to the app

External AI briefing

Copy this prompt, paste it into ChatGPT/Claude with your Excel/CSV, then paste the returned JSON here.

Company

PAN: not set — add at /app/company

VAT: not set — add at /app/company

Fiscal yearSource dataNepal VAT/TDS conventionsAmounts in minor units (paisa)I will attach a spreadsheet

Your notes for the AI (column mapping, PAN, special cases)

Examples are templates, not gospel

Repo examples pass structural validation but use placeholder tax IDs and sample amounts. Your accountant should confirm statutory rules and opening balances before you apply in production.

Tax Setup JSON

Valid

90 lines

{
  "companyCode": "SCC",
  "profiles": [
    {
      "fiscalYearCode": "2083-84",
      "pan": "000000000",
      "vatRegistrationNumber": "000000000",
      "taxOfficePartyCode": "IRD",
      "status": "active"
    }
  ],
  "taxCodes": [
    {
      "code": "VAT-OUTPUT-13",
      "name": "Output VAT placeholder 13 percent",
      "taxType": "vat",
      "direction": "payable",
      "rateBps": 1300,
      "recoverable": false,
      "payableAccountCode": "2200",
      "effectiveFromAd": "2026-07-17",
      "effectiveFromBs": "2083-04-01",
      "status": "active"
    },
    {
      "code": "VAT-INPUT-13",
      "name": "Input VAT placeholder 13 percent",
      "taxType": "vat",
      "direction": "receivable",
      "rateBps": 1300,
      "recoverable": true,
      "receivableAccountCode": "2210",
      "effectiveFromAd": "2026-07-17",
      "effectiveFromBs": "2083-04-01",
      "status": "active"
    },
    {
      "code": "WHT-PAYABLE-1.5",
      "name": "Withholding payable placeholder 1.5 percent",
      "taxType": "wht",
      "direction": "payable",
      "rateBps": 150,
      "recoverable": false,
      "payableAccountCode": "2300",
      "effectiveFromAd": "2026-07-17",
      "effectiveFromBs": "2083-04-01",
      "status": "active"
    },
    {
      "code": "WHT-SUFFERED-1.5",
      "name": "Withholding suffered placeholder 1.5 percent",
      "taxType": "wht",
      "direction": "receivable",
      "rateBps": 150,
      "recoverable": true,
      "receivableAccountCode": "1400",
      "effectiveFromAd": "2026-07-17",
      "effectiveFromBs": "2083-04-01",
      "status": "active"
    }
  ],
  "withholdingTaxRates": [
    {
      "code": "WHT-SERVICE-1.5",
      "name": "Service withholding placeholder",
      "appliesTo": "Vendor service bills",
      "taxCodeCode": "WHT-PAYABLE-1.5",
      "rateBps": 150,
      "payableAccountCode": "2300",
      "effectiveFromAd": "2026-07-17",
      "effectiveFromBs": "2083-04-01",
      "status": "active"
    }
  ],
  "obligations": [
    {
      "obligationNumber": "VAT-2083-84-M01",
      "obligationType": "vat_return",
      "fiscalYearCode": "2083-84",
      "fiscalPeriodNumber": 1,
      "dueDateAd": "2026-08-17",
      "dueDateBs": "2083-05-01",
      "currencyCode": "NPR",
      "amountMinor": 0,
      "status": "due",
      "notes": "Placeholder only; replace with accountant-confirmed obligation during onboarding."
    }
  ]
}

Preview

Validation only

Company: SCC
Tax profiles: 1
Tax codes: 4
Active tax codes: 4
Withholding rates: 1
Due obligations: 1
Obligation amounts: NPR 0

Upserts the fiscal-year tax profile, tax codes and withholding rates (by code + effective date) and statutory obligations (by number). Importing an obligation as filed/paid/closed/cancelled performs that transition and stamps you; locked obligations are not re-importable. Requires tax.manage.

Runs app.apply_import('tax_setup') as you; the database re-checks your permission and records an audit event.