@ekwo-ai/vd 0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ekwo AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,122 @@
+# `@ekwo-ai/vd`
+
+The Estonian **form VD** — *ühendusesisese käibe aruanne*, the report of
+intra-Community turnover — in TypeScript, with no dependencies.
+
+Give it the rows of a recapitulative statement and it gives you the XML the
+e-MTA loads, a name for it, and the list of what could not be put in it.
+
+```ts
+import { generateVd } from '@ekwo-ai/vd';
+
+const { file, filename, violations } = generateVd(rows, {
+  registryCode: '19999999',
+  year: 2026,
+  month: 2,
+});
+```
+
+`StatementRow` is the row shape of the `ec_sales_list(company, from, to)`
+function of [Ekwo OS](https://github.com/Ekwo-ai/ekwo-os), declared here so
+that nothing is imported from it. Any book-keeping system that can produce
+those columns can use this package; it reads no database and knows no
+accounting.
+
+## One line per acquirer, not one per nature
+
+This is the thing to know before anything else. Form VD prints one row per
+customer with three amount columns beside it, so an acquirer who was supplied
+goods and services appears **once**, with two amounts. The instructions say it
+in as many words: *not a single VAT identification number shall recur in the
+column*, and the loader rejects a duplicate by row number.
+
+Every other recapitulative statement in Europe does the opposite — the Belgian
+listing prints the same number three times with three operation codes. So this
+package merges the rows it is given, and a package for another format must not.
+
+| Column | What it holds | Element |
+|---|---|---|
+| 1 | Country code of the acquirer | `riik`, an attribute of `kmkrKood` |
+| 2 | VAT number, **without the country prefix** | the text of `kmkrKood` |
+| 3 | Taxable value of the goods | `kaup` |
+| 4 | Value of triangular transactions | `kolmnurktehing` |
+| 5 | Taxable value of the services | `teenusteMyyk` |
+
+A row carries at least one of the three amounts, which this package enforces by
+leaving out an acquirer whose every amount rounds to nothing, and saying so.
+
+## The specification this was written from
+
+| What | Where |
+|---|---|
+| The technical section that carries them all | <https://www.emta.ee/ariklient/e-teenused-koolitused/e-teenuste-kasutamine/teenuste-tehniline-info#vd-aruanne> |
+| The schema, served with an `.xml` extension | <https://www.emta.ee/sites/default/files/documents/2021-06/vorm_vd_xsd_2011.xml> |
+| Description of the XML file | <https://www.emta.ee/sites/default/files/documents/2021-06/vorm_vd_xml_kirjeldus_2011%281%29.rtf> |
+| A complete example | <https://www.emta.ee/sites/default/files/documents/2023-04/vorm_vd_xml_2011.xml> |
+| The error messages the loader gives | <https://www.emta.ee/sites/default/files/documents/2023-01/vd_vdp_veateated_12012023.xlsx> |
+| The regulation behind the form, consolidated | <https://www.riigiteataja.ee/akt/107012021006> |
+
+The output of this package was checked against that schema with `xmllint`
+before it was committed. The schema is not shipped here — it belongs to the
+administration and it moves — so the test suite proves the shape of the
+document and not its validity.
+
+Two things worth knowing about those documents:
+
+- **The specification is only on the Estonian page.** The English technical
+  page carries no VD section at all; its VAT page points at the KMD instead.
+- **`elementFormDefault` is `unqualified`**, so only the root carries the
+  namespace prefix and its children are bare. The published example shows it,
+  and this package writes it that way.
+
+## Amounts
+
+**Whole euros**, rounded away from zero at the half, with no decimals and no
+separator — the form says `täiseurodes` under each column, the schema types the
+three as `xs:integer`, and the loader refuses `1.5` by name. **Negative values
+are allowed**: a cancelled invoice or a credit note is reported on form VD for
+the period of the credit note, with a minus sign.
+
+## What it refuses and what it reports
+
+An exception, because it would make the whole file meaningless: a month outside
+1 to 12, or a registry code longer than the eleven characters the schema holds.
+
+A violation, because one line is wrong and the rest of the file is not:
+whatever the producer flagged, `unknown_nature`, `wrong_currency`,
+`no_vat_number`, `country_code_length`, `vat_number_is_the_declarer`,
+`vat_number_shape` — the schema allows twelve characters of letters, digits,
+`+` and `*` — and `nil_amounts`.
+
+The loader also validates the structure of each number against the Member State
+it claims, which this package does not: the table of per-country shapes is
+published with the form and belongs to whoever wants that check, not to a file
+writer that would then hold a list of Member States.
+
+## The file name
+
+**The administration imposes none.** The technical description prescribes no
+convention: the e-MTA checks the header of the file — declarer code, year,
+month — against the report it is being loaded into, and nothing else.
+`vdFileName` is a name of ours, and a caller is free to pick another.
+
+## Two things about loading it
+
+- **A load replaces everything already in the report**, whether it was loaded
+  before or typed in, and only works on a report that has not been confirmed.
+- **There is no nil report.** Where there was no intra-Community supply, form VD
+  is not filed at all.
+
+## What is out of scope, on purpose
+
+- **Form VDP, the corrections.** It exists, it is described, and it has **no
+  file format**: the e-MTA offers loading from a file for VD and only manual
+  entry for VDP. Nothing here can be written against a specification that does
+  not exist.
+- **Call-off stock**, column 6 of the form. It is a separate schema with its own
+  namespace, `VD_NV_toimingud`, and it reports movements of stock rather than
+  supplies.
+- **Filing.** This package writes bytes; the e-MTA screen is what turns them
+  into a report, and confirming it is irreversible.
+
+MIT.

package/dist/index.d.ts

@@ -0,0 +1,100 @@
+/**
+ * The Estonian **form VD** — *ühendusesisese käibe aruanne*, the report of
+ * intra-Community turnover — as the e-MTA loads it from a file.
+ *
+ * One XML document, `VD_deklaratsioon`, described by the schema the tax and
+ * customs board publishes beside the form. Give it the rows of a
+ * recapitulative statement and it writes the file, a name for it, and the list
+ * of what could not be put in it.
+ *
+ * **One line per customer, not one per nature.** Estonia is the odd one out:
+ * where the Belgian listing prints the same number three times with three
+ * codes, form VD prints it once with three amount columns. So this package
+ * merges the rows it is given, which the others must not do.
+ *
+ * Sources are in the README. This package depends on nothing, reads no
+ * database and knows no accounting.
+ */
+/**
+ * One line of a recapitulative statement, as `ec_sales_list(company, from,
+ * to)` of [Ekwo OS](https://github.com/Ekwo-ai/ekwo-os) returns it. Declared
+ * here so that nothing is imported from it.
+ */
+export interface StatementRow {
+    /** Country of the customer's VAT identification number, ISO 3166-1 alpha-2. */
+    vat_country: string | null;
+    /** The number itself, without its country prefix — which is how form VD wants it. */
+    vat_number: string | null;
+    /** `goods`, `services`, `triangular`. */
+    nature: string;
+    /** Taxable amount, credit notes already deducted. */
+    amount: string | number;
+    /** ISO 4217 code the amount is in. */
+    currency_code: string;
+    /** Why this line cannot be declared as it stands, or null when it can. */
+    issue?: string | null;
+    /** Names of the customers behind the line, for a message a human reads. */
+    contact_names?: string[] | null;
+}
+export interface VdOptions {
+    /**
+     * The declarer's registry code, at most eleven characters. The e-MTA checks
+     * it against the client the report is opened for.
+     */
+    registryCode: string;
+    year: number;
+    /** 1 to 12. Form VD is filed monthly, with the VAT return. */
+    month: number;
+}
+/** Something that does not add up, said in the terms of this format. */
+export interface Violation {
+    code: string;
+    message: string;
+    vatNumber?: string;
+}
+export interface Vd {
+    /** The XML, as text. */
+    file: string;
+    /** A name for it. See the README: the administration imposes none. */
+    filename: string;
+    /** Everything that could not be put in the file, and why. */
+    violations: Violation[];
+}
+/** The three amount columns of the form, by what the statement calls each. */
+export declare const COLUMNS: Readonly<Record<string, string>>;
+/** Form VD is in euro; it carries no currency field. */
+export declare const CURRENCY = "EUR";
+export declare class VdError extends Error {
+    name: string;
+}
+/**
+ * Whole euros, rounded away from zero at the half.
+ *
+ * The form says `täiseurodes` under each of its three amount columns, the XML
+ * description types them `Number(20)`, and the published error messages refuse
+ * `1.5` by name. `Math.round` would send −0,5 to −0, which is the wrong
+ * direction for a credit note, so the sign is taken out and put back.
+ */
+export declare function roundToEuro(value: string | number): number;
+/**
+ * A name for the file.
+ *
+ * **The administration imposes none.** The technical description prescribes no
+ * naming convention: the e-MTA checks the header of the file against the report
+ * it is being loaded into, and nothing else. So this is a name of ours, and a
+ * caller is free to pick another.
+ */
+export declare function vdFileName(registryCode: string, year: number, month: number): string;
+/**
+ * Writes the report.
+ *
+ * Refuses, by exception, what would make the whole file meaningless: a month
+ * outside the year, or a registry code the schema cannot hold. Everything
+ * wrong with one line comes back in `violations`.
+ *
+ * Note for whoever uses the result: loading a file into the e-MTA **replaces
+ * every row already there**, whether it was loaded or typed in, and only works
+ * on a report that has not been confirmed.
+ */
+export declare function generateVd(rows: StatementRow[], options: VdOptions): Vd;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,+EAA+E;IAC/E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,qFAAqF;IACrF,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,sCAAsC;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wEAAwE;AACxE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,EAAE;IACjB,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB;AAED,8EAA8E;AAC9E,eAAO,MAAM,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAInD,CAAC;AAEH,wDAAwD;AACxD,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAO9B,qBAAa,OAAQ,SAAQ,KAAK;IACvB,IAAI,SAAa;CAC3B;AAWD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAI1D;AA4GD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,SAAS,GAAG,EAAE,CA6CvE"}

package/dist/index.js

@@ -0,0 +1,204 @@
+/**
+ * The Estonian **form VD** — *ühendusesisese käibe aruanne*, the report of
+ * intra-Community turnover — as the e-MTA loads it from a file.
+ *
+ * One XML document, `VD_deklaratsioon`, described by the schema the tax and
+ * customs board publishes beside the form. Give it the rows of a
+ * recapitulative statement and it writes the file, a name for it, and the list
+ * of what could not be put in it.
+ *
+ * **One line per customer, not one per nature.** Estonia is the odd one out:
+ * where the Belgian listing prints the same number three times with three
+ * codes, form VD prints it once with three amount columns. So this package
+ * merges the rows it is given, which the others must not do.
+ *
+ * Sources are in the README. This package depends on nothing, reads no
+ * database and knows no accounting.
+ */
+/** The three amount columns of the form, by what the statement calls each. */
+export const COLUMNS = Object.freeze({
+    goods: 'kaup',
+    triangular: 'kolmnurktehing',
+    services: 'teenusteMyyk',
+});
+/** Form VD is in euro; it carries no currency field. */
+export const CURRENCY = 'EUR';
+const NAMESPACE = 'http://www.emta.ee/VD/xsd/webimport/v1';
+/** The schema's own pattern for a customer's registration number. */
+const CUSTOMER_NUMBER = /^[A-Za-z0-9+*]{1,12}$/;
+export class VdError extends Error {
+    name = 'VdError';
+}
+function escapeXml(value) {
+    return value.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+function normalise(value) {
+    // `+` and `*` are part of the alphabet the schema allows, so they survive.
+    return value.replace(/[^A-Za-z0-9+*]/g, '').toUpperCase();
+}
+/**
+ * Whole euros, rounded away from zero at the half.
+ *
+ * The form says `täiseurodes` under each of its three amount columns, the XML
+ * description types them `Number(20)`, and the published error messages refuse
+ * `1.5` by name. `Math.round` would send −0,5 to −0, which is the wrong
+ * direction for a credit note, so the sign is taken out and put back.
+ */
+export function roundToEuro(value) {
+    const n = typeof value === 'number' ? value : Number(value);
+    if (!Number.isFinite(n))
+        throw new VdError(`invalid amount: ${String(value)}`);
+    return Math.sign(n) * Math.round(Math.abs(n));
+}
+function linesOf(rows, declarer) {
+    const byCustomer = new Map();
+    const violations = [];
+    for (const row of rows) {
+        const country = row.vat_country === null ? '' : normalise(row.vat_country);
+        const number = row.vat_number === null ? '' : normalise(row.vat_number);
+        const named = row.contact_names?.join(', ');
+        const about = named === undefined || named === '' ? `${country}${number}` : named;
+        if (row.issue !== null && row.issue !== undefined && row.issue !== '') {
+            violations.push({
+                code: row.issue,
+                message: `${about}: this supply cannot be reported — ${row.issue.replace(/_/g, ' ')}.`,
+                ...(number === '' ? {} : { vatNumber: `${country}${number}` }),
+            });
+            continue;
+        }
+        const column = COLUMNS[row.nature];
+        if (column === undefined) {
+            violations.push({
+                code: 'unknown_nature',
+                message: `${about}: form VD has a column for goods, triangular operations and services, and none for "${row.nature}".`,
+            });
+            continue;
+        }
+        if (row.currency_code.toUpperCase() !== CURRENCY) {
+            violations.push({
+                code: 'wrong_currency',
+                message: `${about}: form VD is filed in ${CURRENCY} and this line is in ${row.currency_code}.`,
+            });
+            continue;
+        }
+        if (country === '' || number === '') {
+            violations.push({
+                code: 'no_vat_number',
+                message: `${about}: a row of form VD is identified by the acquirer's VAT number and this one has none.`,
+            });
+            continue;
+        }
+        if (country.length !== 2) {
+            violations.push({
+                code: 'country_code_length',
+                message: `${about}: column 1 of form VD holds a two-character country code and this one is "${country}".`,
+            });
+            continue;
+        }
+        if (number === declarer) {
+            violations.push({
+                code: 'vat_number_is_the_declarer',
+                message: `${about}: form VD reports supplies to other Member States, and this is the declarer's own number.`,
+                vatNumber: `${country}${number}`,
+            });
+            continue;
+        }
+        if (!CUSTOMER_NUMBER.test(number)) {
+            violations.push({
+                code: 'vat_number_shape',
+                message: `${about}: the schema holds twelve characters of letters, digits, + and * for a number, and this one is "${number}".`,
+                vatNumber: `${country}${number}`,
+            });
+            continue;
+        }
+        const value = roundToEuro(row.amount);
+        const key = `${country}|${number}`;
+        // The instructions are explicit: a VAT number may not appear twice in the
+        // column, so goods and services for the same acquirer are one row with two
+        // amounts. That is the aggregation this format asks for and no other does.
+        const held = byCustomer.get(key) ?? { country, number, amounts: new Map() };
+        held.amounts.set(column, (held.amounts.get(column) ?? 0) + value);
+        byCustomer.set(key, held);
+    }
+    const lines = [];
+    for (const line of byCustomer.values()) {
+        for (const [column, value] of [...line.amounts]) {
+            if (value === 0)
+                line.amounts.delete(column);
+        }
+        if (line.amounts.size === 0) {
+            violations.push({
+                code: 'nil_amounts',
+                message: `${line.country}${line.number}: every amount of this acquirer rounds to nothing, and a row of form VD carries at least one.`,
+                vatNumber: `${line.country}${line.number}`,
+            });
+            continue;
+        }
+        lines.push(line);
+    }
+    lines.sort((a, b) => `${a.country}${a.number}`.localeCompare(`${b.country}${b.number}`));
+    return { lines, violations };
+}
+/**
+ * A name for the file.
+ *
+ * **The administration imposes none.** The technical description prescribes no
+ * naming convention: the e-MTA checks the header of the file against the report
+ * it is being loaded into, and nothing else. So this is a name of ours, and a
+ * caller is free to pick another.
+ */
+export function vdFileName(registryCode, year, month) {
+    return `VD-${normalise(registryCode)}-${year}${String(month).padStart(2, '0')}.xml`;
+}
+/**
+ * Writes the report.
+ *
+ * Refuses, by exception, what would make the whole file meaningless: a month
+ * outside the year, or a registry code the schema cannot hold. Everything
+ * wrong with one line comes back in `violations`.
+ *
+ * Note for whoever uses the result: loading a file into the e-MTA **replaces
+ * every row already there**, whether it was loaded or typed in, and only works
+ * on a report that has not been confirmed.
+ */
+export function generateVd(rows, options) {
+    if (!Number.isInteger(options.month) || options.month < 1 || options.month > 12) {
+        throw new VdError(`month out of range: ${options.month}`);
+    }
+    if (!Number.isInteger(options.year) || options.year < 1000 || options.year > 9999) {
+        throw new VdError(`year out of range: ${options.year}`);
+    }
+    const declarer = normalise(options.registryCode);
+    if (declarer === '' || declarer.length > 11) {
+        throw new VdError(`the declarer's registry code is one to eleven characters: "${options.registryCode}"`);
+    }
+    const { lines, violations } = linesOf(rows, declarer);
+    const parts = [];
+    parts.push('<?xml version="1.0" encoding="UTF-8"?>');
+    parts.push(`<v1:VD_deklaratsioon xmlns:v1="${NAMESPACE}">`);
+    parts.push(`  <deklareerijaKood>${escapeXml(declarer)}</deklareerijaKood>`);
+    parts.push(`  <perioodAasta>${options.year}</perioodAasta>`);
+    parts.push(`  <perioodKuu>${options.month}</perioodKuu>`);
+    parts.push('  <aruandeRead>');
+    for (const line of lines) {
+        parts.push('    <aruandeRida>');
+        parts.push(`      <kmkrKood riik="${escapeXml(line.country)}">${escapeXml(line.number)}</kmkrKood>`);
+        // The schema fixes the order of the three columns, and a line carries only
+        // the ones that came to something.
+        for (const nature of ['goods', 'triangular', 'services']) {
+            const column = COLUMNS[nature];
+            const value = line.amounts.get(column);
+            if (value !== undefined)
+                parts.push(`      <${column}>${value}</${column}>`);
+        }
+        parts.push('    </aruandeRida>');
+    }
+    parts.push('  </aruandeRead>');
+    parts.push('</v1:VD_deklaratsioon>');
+    return {
+        file: `${parts.join('\n')}\n`,
+        filename: vdFileName(declarer, options.year, options.month),
+        violations,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@ekwo-ai/vd",
+  "version": "0.4.0",
+  "description": "The Estonian form VD — uhendusesisese kaibe aruanne — in TypeScript: the XML the e-MTA loads, from plain statement rows. Zero dependencies.",
+  "keywords": [
+    "vd",
+    "emta",
+    "estonia",
+    "ec-sales-list",
+    "uhendusesisese-kaibe-aruanne",
+    "intra-community",
+    "vat",
+    "xml"
+  ],
+  "license": "MIT",
+  "author": "Ekwo AI",
+  "homepage": "https://github.com/Ekwo-ai/ekwo-os/tree/main/packages/formats/vd#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Ekwo-ai/ekwo-os.git",
+    "directory": "packages/formats/vd"
+  },
+  "bugs": {
+    "url": "https://github.com/Ekwo-ai/ekwo-os/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.9.0",
+    "vitest": "^3.2.0"
+  }
+}