@kirjapro/mcp-server 0.18.0 → 0.18.1

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [0.18.1] - 2026-10-19
+
+No database migration; one tool fingerprint changes (`kirjapro_book_sale`).
+
+- `kirjapro_book_sale` books the sale of a company outside the VAT register gross even when
+  the receipt or invoice it gave showed VAT (founder decision 19.10.2026, audit T2-3): a
+  `vatRate` above 0 is no longer refused with `NOT_VAT_REGISTERED_SALE`, it is the rate the
+  receipt showed. No VAT is booked (no 4210 line, `vat: 0`, `vat_rate: "0 %"`), and the
+  result and the dry run add `vat_notice`, a Finnish note the agent relays to the user: the
+  company charges no VAT, the sale was booked in full as revenue, and a receipt that showed
+  VAT is wrong and is replaced with a corrected receipt without VAT, attached as the voucher
+  in the Kirjapro app.
+- A sale template with VAT (`cash_sale_25` and the like) is still refused for such a
+  company, and the refusal now points to `kirjapro_book_sale` with the receipt's rate.
+
 ## [0.18.0] - 2026-10-19
 
 **Breaking: Node.js 22 or newer is required** (`engines.node` `>=22`; Node.js 20 reached its

package/README.md

@@ -201,9 +201,10 @@ See the [full tool reference](https://kirjapro.fi/docs/mcp/) for parameters, usa
   cents (`INVALID_AMOUNT` otherwise), and `documentNumber` is the company's own
   voucher number: leave it out for the next number (a supplier's receipt number
   belongs in the description).
-- A company outside the VAT register books its sales without VAT
-  (`kirjapro_book_sale` takes only `vatRate "0"`, and the sale templates with
-  VAT are not offered). Recurring invoice templates take prices of 0 or more
+- A company outside the VAT register books its sales without VAT: the sale
+  templates with VAT are not offered, and `kirjapro_book_sale` books the gross
+  amount as revenue. If the receipt showed VAT, the result's `vat_notice` tells
+  the user to give the customer a corrected receipt without VAT (0.18.1). Recurring invoice templates take prices of 0 or more
   (a discount is `discountPercent`) and a first date from today on.
 - Update tools are annotated `destructiveHint: true` and the recurring invoice
   writes `openWorldHint: true`, so a host that auto-approves non-destructive

package/dist/index.js

@@ -35743,7 +35743,7 @@ import { AsyncLocalStorage } from "node:async_hooks";
 import { createClient } from "@supabase/supabase-js";
 
 // src/version.ts
-var VERSION = "0.18.0";
+var VERSION = "0.18.1";
 
 // src/auth.ts
 var SUPABASE_PROJECT_URL = "https://tifewzsimmyoiepblhld.supabase.co";
@@ -41808,7 +41808,11 @@ var ACCOUNTS = {
 
 // src/compliance/vat-guard.ts
 var ALV_REGISTERED_SALE_REFUSAL = "This company is VAT-registered (ALV). A sale booked as a journal voucher never reaches the ALV report (fields 301-303 and 309), so Kirjapro refuses it. Create the sale with kirjapro_create_invoice, deliver it with kirjapro_send_invoice and record the payment with kirjapro_record_payment or bank matching.";
-var NOT_VAT_REGISTERED_SALE_REFUSAL = 'NOT_VAT_REGISTERED_SALE: this company is not VAT-registered (ALV), so it charges no VAT and its sale is booked gross as revenue. Use vatRate "0" (the cash_sale_0 template), with no VAT split. If a receipt or invoice the company gave did show VAT, ask an accountant how to book that VAT; Kirjapro does not book it automatically.';
+var SALE_TEMPLATE_NOT_VAT_REGISTERED_REFUSAL = "NOT_VAT_REGISTERED_SALE: this company is not VAT-registered (ALV), so a sale template with VAT cannot be used. Use kirjapro_book_sale with the vatRate the receipt showed (the sale is booked gross as revenue and the result says how to correct the receipt) or the cash_sale_0 template.";
+var euros = (amount2) => `${amount2.toFixed(2).replace(".", ",")} \u20AC`;
+function saleVatNotice(gross, vatRate, vat2, preview) {
+  return `Yritys ei ole ALV-rekisteriss\xE4, joten se ei peri arvonlis\xE4veroa. Myynti ${preview ? "kirjataan" : "kirjattiin"} kokonaan myyntituloksi (${euros(gross)}) ilman ALV-osuutta. Jos asiakkaalle annetussa kuitissa tai laskussa n\xE4kyi arvonlis\xE4vero (${vatRate.replace(".", ",")} %, ${euros(vat2)}), kuitti on virheellinen: anna asiakkaalle alkuper\xE4isen tilalle korjattu kuitti ilman arvonlis\xE4veroa ja liit\xE4 korjattu kuitti tositteeksi Kirjapro-sovelluksessa.`;
+}
 var NOT_VAT_REGISTERED_PURCHASE_REFUSAL = "This company is not VAT-registered, so it cannot deduct VAT. General-rule services from a foreign supplier can still incur full buyer VAT: use kirjapro_book_purchase with reverseCharge, eu_services/non_eu_services, deductionPercent 0 and documented vatRateBasis, or the atomic purchase form in the web app. Do not add a separate VAT row or duplicate voucher. EU goods, construction and scrap-metal registration requirements need separate assessment; do not change ordinary registration settings merely to bypass this guard. Customs collects import VAT for a buyer outside the VAT register.";
 var REVERSE_CHARGE_CATEGORIES = [
   "eu_goods",
@@ -42333,7 +42337,7 @@ function registerTemplateTools(server2) {
           return toErrorContent(ALV_REGISTERED_SALE_REFUSAL);
         }
         if (!alvRegistered && isVatSaleTemplate(params.template)) {
-          return toErrorContent(NOT_VAT_REGISTERED_SALE_REFUSAL);
+          return toErrorContent(SALE_TEMPLATE_NOT_VAT_REGISTERED_REFUSAL);
         }
       }
       return withIdempotency(
@@ -42452,7 +42456,7 @@ Nothing was written.`);
         );
         if (vatSaleIndexes.length > 0) {
           return toErrorContent(
-            `${NOT_VAT_REGISTERED_SALE_REFUSAL} Sale templates with VAT at index ${vatSaleIndexes.join(", ")}; nothing was written.`
+            `${SALE_TEMPLATE_NOT_VAT_REGISTERED_REFUSAL} Sale templates with VAT at index ${vatSaleIndexes.join(", ")}; nothing was written.`
           );
         }
       }
@@ -43045,12 +43049,12 @@ function registerBookingTools(server2) {
   server2.registerTool(
     "kirjapro_book_sale",
     {
-      description: 'Book a sale (myynti) of a company that is not VAT-registered: it charges no VAT, so the gross amount is revenue in full (vatRate "0"; a VAT rate is refused). Payment types: invoice (default, D Myyntisaamiset), cash (D bank), prepaid. A VAT-registered (ALV) company is refused: its sales reach the ALV report only as invoices (kirjapro_create_invoice + kirjapro_send_invoice).',
+      description: "Book a sale (myynti) of a company that is not VAT-registered: it charges no VAT, so the gross amount is revenue in full and no VAT is booked. If the receipt or invoice the company gave showed VAT, pass that vatRate: the sale is still booked gross, and the result and the dry run carry vat_notice, which you relay to the user (the receipt is replaced with a corrected one without VAT). Payment types: invoice (default, D Myyntisaamiset), cash (D bank), prepaid. A VAT-registered (ALV) company is refused: its sales reach the ALV report only as invoices (kirjapro_create_invoice + kirjapro_send_invoice).",
       inputSchema: {
         amount: external_exports.number().finite().positive().max(1e9).describe("EUR amount the customer pays"),
         description: external_exports.string().min(1).max(500).describe('Transaction description (e.g. "Konsultointi Acme Oy, 40h \xD7 95 \u20AC")'),
         date: ISO_DATE_SCHEMA.describe("Transaction date (YYYY-MM-DD)"),
-        vatRate: external_exports.enum(["25.5", "13.5", "10", "0"]).default("0").describe('Only "0" (the default) is accepted: a company outside the VAT register charges no VAT'),
+        vatRate: external_exports.enum(["25.5", "13.5", "10", "0"]).default("0").describe('The VAT rate the receipt or invoice the company gave showed, if any (default "0"). No VAT is booked at any rate; a rate above 0 adds vat_notice'),
         revenueAccount: external_exports.string().default(ACCOUNTS.MYYNTI_0).describe(`Revenue account number (default "${ACCOUNTS.MYYNTI_0}", the 0 % sales account invoices of a company outside the VAT register also use)`),
         paymentType: external_exports.enum(["invoice", "cash", "prepaid"]).default("invoice").describe(`invoice = receivable (${ACCOUNTS.MYYNTISAAMISET}), cash/prepaid = bank payment (${ACCOUNTS.PANKKITILI})`),
         paymentAccount: external_exports.string().default(ACCOUNTS.PANKKITILI).describe(`Bank account for cash/prepaid payments (default "${ACCOUNTS.PANKKITILI}")`),
@@ -43065,9 +43069,10 @@ function registerBookingTools(server2) {
       const companyVat = await readCompanyVat(getSupabase(), getCompanyId());
       if ("isError" in companyVat) return companyVat;
       if (companyVat.alvRegistered) return toErrorContent(ALV_REGISTERED_SALE_REFUSAL);
-      if (params.vatRate !== "0") return toErrorContent(NOT_VAT_REGISTERED_SALE_REFUSAL);
       const gross = roundCents(params.amount);
       if (gross <= 0) return toErrorContent("Myynnin summan on oltava v\xE4hint\xE4\xE4n yksi sentti.");
+      const receiptVatRate = params.vatRate === "0" ? null : params.vatRate;
+      const vatNotice = (preview) => saleVatNotice(gross, params.vatRate, splitVat(gross, Number(params.vatRate)).vat, preview);
       const debitAccount = params.paymentType === "invoice" ? ACCOUNTS.MYYNTISAAMISET : params.paymentAccount;
       const entries = [
         { accountNumber: debitAccount, debitAmount: gross, creditAmount: 0 },
@@ -43082,13 +43087,14 @@ function registerBookingTools(server2) {
           gross,
           net,
           vat: vat2,
-          vat_rate: `${params.vatRate} %`,
+          vat_rate: "0 %",
           payment_type: params.paymentType,
           debit_account: tagAccountRef(debitAccount),
           revenue_account: tagAccountRef(params.revenueAccount),
           date: params.date,
           entries: echoEntries(entries),
-          ...saleAccountWarning && { account_warning: saleAccountWarning }
+          ...saleAccountWarning && { account_warning: saleAccountWarning },
+          ...receiptVatRate && { vat_notice: vatNotice(true) }
         });
       }
       return withIdempotency(
@@ -43112,12 +43118,13 @@ function registerBookingTools(server2) {
             gross,
             net,
             vat: vat2,
-            vat_rate: `${params.vatRate} %`,
+            vat_rate: "0 %",
             payment_type: params.paymentType,
             debit_account: tagAccountRef(debitAccount),
             revenue_account: tagAccountRef(params.revenueAccount),
             entries: echoEntries(entries),
-            ...saleAccountWarning && { warning: saleAccountWarning }
+            ...saleAccountWarning && { warning: saleAccountWarning },
+            ...receiptVatRate && { vat_notice: vatNotice(false) }
           });
         }
       );
@@ -45523,7 +45530,7 @@ var INSTRUCTIONS_FULL_ADDENDUM = `
 
 ### Booking Shortcuts
 Faster than composing journal entries via \`kirjapro_create_transaction\`:
-- \`kirjapro_book_sale\` / \`kirjapro_book_purchase\` \u2014 one-liner with auto VAT splitting. A VAT-registered (ALV) company books sales as invoices (\`kirjapro_create_invoice\` + \`kirjapro_send_invoice\`): \`kirjapro_book_sale\` is refused for it. Purchases use \`kirjapro_book_purchase\` with source \`vatRateBasis\` and a documented deduction share; reverse charge records the full buyer tax, including when deduction is zero. Import means customs-tax assessment only on the complete customs base, with no duplicate supplier purchase/payment
+- \`kirjapro_book_sale\` / \`kirjapro_book_purchase\` \u2014 one-liners. A VAT-registered (ALV) company books sales as invoices (\`kirjapro_create_invoice\` + \`kirjapro_send_invoice\`): \`kirjapro_book_sale\` is refused for it. A company outside the VAT register books its sale gross with no VAT; if its receipt showed VAT, relay the result's \`vat_notice\` to the user (the receipt is replaced with a corrected one). Purchases use \`kirjapro_book_purchase\` with source \`vatRateBasis\` and a documented deduction share; reverse charge records the full buyer tax, including when deduction is zero. Import means customs-tax assessment only on the complete customs base, with no duplicate supplier purchase/payment
 - \`kirjapro_book_vat_settlement\` \u2014 settles the company's VAT period from ALV-saamiset/ALV-velka. Call \`kirjapro_get_alv_summary\` for the period first to preview the net and its reconciliation.
 - **Payroll is intentionally NOT exposed.** Direct users to Palkkaus.fi / Palkka.fi for salary calculation; the payslip can then be booked manually via \`kirjapro_create_transaction\`.
 - \`kirjapro_list_templates\` \u2192 \`kirjapro_create_from_template\` for common patterns (built-in templates; the sale templates are hidden and refused for a VAT-registered company)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kirjapro/mcp-server",
-  "version": "0.18.0",
+  "version": "0.18.1",
   "description": "MCP server for Finnish accounting — exposes Kirjapro bookkeeping, invoicing, and reporting tools to Claude, ChatGPT, Mistral, and other MCP clients.",
   "type": "module",
   "bin": {

package/server.json

@@ -2,7 +2,7 @@
   "name": "@kirjapro/mcp-server",
   "displayName": "Kirjapro - Finnish Accounting",
   "description": "Finnish double-entry bookkeeping, invoicing, and financial reporting for growing businesses. Create transactions, generate invoices with VAT calculation, produce income statements and balance sheets, and validate Finnish business identifiers.",
-  "version": "0.18.0",
+  "version": "0.18.1",
   "homepage": "https://kirjapro.fi",
   "repository": "https://github.com/Jaollo/kirja-pro",
   "license": "MIT",

package/tool-fingerprints.json

@@ -6,7 +6,7 @@
     },
     {
       "name": "kirjapro_book_sale",
-      "hash": "4a397f56677421fb"
+      "hash": "7a4971b42657b6b5"
     },
     {
       "name": "kirjapro_book_vat_settlement",