npm - @readystack/einvoice-lint-en16931 - Versions diffs - 0.1.0 - Mend

@readystack/einvoice-lint-en16931 0.1.0

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.

Files changed (7) hide show

package/LICENSE.txt ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ Copyright. Free features may be used without a licence key.
2	+ Paid features require a valid licence key.

package/README.md ADDED Viewed

@@ -0,0 +1,35 @@
+# E-Invoice Lint for XRechnung, Factur-X and UBL
+![E-Invoice Lint for XRechnung, Factur-X and UBL](https://getreadystack.com/img/promo/sku14679_result_card.jpg)
+Catches retired profile identifiers, code-list values outside EN 16931 and malformed dates in your e-invoice XML, in the editor, before an access point rejects the file.
+## Install
+```
+npx @readystack/einvoice-lint-en16931 file
+```
+Node 18+. The same 26 rules as the VS Code extension, from a terminal or CI.
+## Free
+- Check the open e-invoice against all 26 rules; Check only the lines you select; Reopen the last findings, with line numbers and severity; Read every rule that ships inside, in plain English
+- `--rules` lists every rule
+## With a licence ($29 once)
+- Check every e-invoice file in the repository; Findings report as CSV, JSON or HTML; JSON output a build step can fail on
+```
+@readystack/einvoice-lint-en16931 --dir ./templates --report html --out report.html
+```
+Peppol access points bill per document - published pay-per-use rates run EUR 0.18 to EUR 0.25 per invoice - and every rejected document is one you send twice.
+7-day refund, no questions. Set `READYSTACK_LICENSE=<key>` or run `--license <key>` once.
+[Get a licence](https://buy.polar.sh/polar_cl_uvaD8HrNLY041vZaDJqCklAVjAZRz5CnK5b184gKfFx)
+<!-- e invoice lint -->

package/cli.js ADDED Viewed

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+// cli.js — the same rules as the VS Code extension, run from a terminal or a container. Generated by adapters.py.
+'use strict';
+const fs = require('fs'), path = require('path');
+const RULES = require('./rules.json');
+const S = require('./strings.json');
+const lic = require('./license.js');
+function scan(text) {
+  const lines = String(text).split(/\r?\n/); const hits = [];
+  for (let i = 0; i < lines.length; i++) {
+    for (const r of RULES) {
+      let re; try { re = new RegExp(r.pattern, r.flags || ''); } catch (e) { continue; }
+      if (re.test(lines[i])) hits.push({ line: i + 1, msg: r.message, fix: r.fix || null, sev: r.sev || 'warn' });
+    }
+  }
+  return hits;
+}
+function isText(p) { try { const b = fs.readFileSync(p); if (b.length > 2 * 1024 * 1024) return false; const s = b.subarray(0, 4096); for (const x of s) if (x === 0) return false; return true; } catch (e) { return false; } }
+function walk(dir, exts, out) {
+  let ents = []; try { ents = fs.readdirSync(dir, { withFileTypes: true }); } catch (e) { return out; }
+  for (const e of ents) {
+    if (e.name === 'node_modules' || e.name === '.git' || e.name.startsWith('.')) continue;
+    const p = path.join(dir, e.name);
+    if (e.isDirectory()) walk(p, exts, out);
+    else if ((!exts.length || exts.includes(path.extname(e.name).toLowerCase())) && isText(p)) out.push(p);
+  }
+  return out;
+}
+function esc(s) { return String(s).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;'); }
+function csvq(s) { return '"' + String(s == null ? '' : s).replace(/"/g, '""') + '"'; }
+function render(rows, fmt) {
+  if (fmt === 'json') return JSON.stringify({ tool: S.name, rules: RULES.length, files: rows }, null, 1);
+  if (fmt === 'csv') { const o = ['file,line,severity,message,fix']; for (const r of rows) for (const h of r.hits) o.push([csvq(r.file), h.line, h.sev, csvq(h.msg), csvq(h.fix)].join(',')); return o.join('\n') + '\n'; }
+  if (fmt === 'html') {
+    const n = rows.reduce((a, r) => a + r.hits.length, 0);
+    let o = '<!doctype html><meta charset="utf-8"><title>' + esc(S.name) + ' report</title><style>body{font:14px system-ui;margin:24px}table{border-collapse:collapse}td,th{border:1px solid #ddd;padding:4px 8px;font-size:13px}code{font-family:ui-monospace,monospace}</style>';
+    o += '<h1>' + esc(S.name) + '</h1><p>' + rows.length + ' files · ' + n + ' findings · ' + RULES.length + ' rules</p><table><tr><th>file</th><th>line</th><th>sev</th><th>message</th><th>fix</th></tr>';
+    for (const r of rows) for (const h of r.hits) o += '<tr><td><code>' + esc(r.file) + '</code></td><td>' + h.line + '</td><td>' + esc(h.sev) + '</td><td>' + esc(h.msg) + '</td><td>' + esc(h.fix || '') + '</td></tr>';
+    return o + '</table>';
+  }
+  let o = ''; for (const r of rows) { o += r.file + '\n'; for (const h of r.hits) o += '  ' + String(h.line).padStart(5) + '  ' + h.sev.padEnd(5) + ' ' + h.msg + (h.fix ? '\n         -> ' + h.fix : '') + '\n'; if (!r.hits.length) o += '  (no findings)\n'; }
+  return o;
+}
+function help() {
+  return [S.name + ' - ' + S.subtitle, '', 'Usage: ' + S.bin + ' <file> [more files]           check the files you name (free, every rule)',
+    '       ' + S.bin + ' --dir <folder> [--ext .html]  scan a whole folder            (licence)',
+    '       ' + S.bin + ' ... --report csv|json|html [--out file]   export a report   (licence)',
+    '       ' + S.bin + ' ... --ci                      exit 1 when an error-level finding exists (licence)',
+    '       ' + S.bin + ' --license <key>               store your licence key (or set READYSTACK_LICENSE)',
+    '       ' + S.bin + ' --rules                       list the ' + RULES.length + ' rules', '',
+    'Free: ' + S.free, 'Licence ($' + S.price + ', once, 7-day refund): ' + S.paid, 'Get a licence: ' + lic.BUY_URL, ''].join('\n');
+}
+(async function main() {
+  try { const _feed = await lic.pullFeed(); if (_feed && Array.isArray(_feed.rules)) { for (const r of _feed.rules) RULES.push(r); } } catch (e) {}   // ★s134 구독 피드 병합 (키 있는 손님만)
+  const a = process.argv.slice(2);
+  const get = (k) => { const i = a.indexOf(k); return i >= 0 ? a[i + 1] : null; };
+  if (!a.length || a.includes('--help') || a.includes('-h')) { process.stdout.write(help()); return; }
+  if (a.includes('--rules')) { process.stdout.write(RULES.map((r, i) => String(i + 1).padStart(3) + '  [' + (r.sev || 'warn') + '] ' + r.message).join('\n') + '\n'); return; }
+  if (a.includes('--license')) { const r = await lic.ensure(get('--license')); process.stdout.write(r.ok ? 'Licence stored: ' + lic.storePath() + '\n' : 'Licence not accepted (' + r.why + '). Get one: ' + lic.BUY_URL + '\n'); process.exit(r.ok ? 0 : 2); }
+  const dir = get('--dir'), fmt = get('--report'), out = get('--out'), ci = a.includes('--ci');
+  const exts = a.includes('--ext') ? [get('--ext')] : (S.exts || []);
+  const paid = !!(dir || fmt || ci);
+  if (paid) {
+    const r = await lic.ensure();
+    if (!r.ok) { process.stderr.write(S.need_key + '\n  set READYSTACK_LICENSE=<key>  or  ' + S.bin + ' --license <key>\n  Get a licence ($' + S.price + ', once): ' + lic.BUY_URL + '\n'); process.exit(2); }
+  }
+  const files = dir ? walk(dir, exts, []) : a.filter((x, i) => !x.startsWith('--') && !['--dir', '--report', '--out', '--ext', '--license'].includes(a[i - 1]));
+  if (!files.length) { process.stderr.write('No files. ' + S.bin + ' --help\n'); process.exit(2); }
+  const rows = files.map((f) => { let t = ''; try { t = fs.readFileSync(f, 'utf8'); } catch (e) { return { file: f, hits: [], error: String(e.message) }; } return { file: f, hits: scan(t) }; });
+  const text = render(rows, fmt || 'text');
+  if (out) fs.writeFileSync(out, text); else process.stdout.write(text.endsWith('\n') ? text : text + '\n');
+  const errors = rows.reduce((n, r) => n + r.hits.filter((h) => h.sev === 'error').length, 0);
+  if (ci && errors) process.exit(1);
+})().catch((e) => { process.stderr.write(String(e && e.stack || e) + '\n'); process.exit(3); });

package/license.js ADDED Viewed

@@ -0,0 +1,63 @@
+// license.js — Polar licence check for the CLI / container. Generated by adapters.py; do not edit by hand.
+'use strict';
+const https = require('https'), fs = require('fs'), path = require('path'), os = require('os');
+const ORG_ID = 'a5cdf664-d8e7-4f87-8895-056717aaba17';
+const BUY_URL = 'https://buy.polar.sh/polar_cl_uvaD8HrNLY041vZaDJqCklAVjAZRz5CnK5b184gKfFx';
+const SLUG = 'einvoice-lint-en16931';
+const GRACE_MS = 30 * 24 * 3600 * 1000;   // after a successful check, 30 days work offline
+const RECHECK_MS = 7 * 24 * 3600 * 1000;  // re-ask Polar every 7 days (refunds / cancellations)
+function storePath() { return path.join(process.env.READYSTACK_HOME || path.join(os.homedir(), '.config', 'readystack'), SLUG + '.json'); }
+function load() { try { return JSON.parse(fs.readFileSync(storePath(), 'utf8')); } catch (e) { return {}; } }
+function save(o) { try { fs.mkdirSync(path.dirname(storePath()), { recursive: true }); fs.writeFileSync(storePath(), JSON.stringify(o)); } catch (e) { /* read-only home: still works for this run */ } }
+function validate(key) {
+  return new Promise(function (resolve) {
+    if (!ORG_ID) return resolve({ ok: false, offline: false });
+    const body = JSON.stringify({ key: key, organization_id: ORG_ID });
+    const req = https.request({ hostname: 'api.polar.sh', path: '/v1/customer-portal/license-keys/validate', method: 'POST', timeout: 8000,
+      headers: { 'content-type': 'application/json', 'content-length': Buffer.byteLength(body) } }, function (res) {
+      let buf = ''; res.on('data', function (d) { buf += d; });
+      res.on('end', function () {
+        if (res.statusCode !== 200) return resolve({ ok: false, offline: false });
+        try { const j = JSON.parse(buf); resolve({ ok: j && (j.status === 'granted' || j.valid === true || !!j.id), offline: false }); }
+        catch (e) { resolve({ ok: false, offline: false }); }
+      });
+    });
+    req.on('timeout', function () { req.destroy(); resolve({ ok: false, offline: true }); });
+    req.on('error', function () { resolve({ ok: false, offline: true }); });
+    req.write(body); req.end();
+  });
+}
+async function ensure(explicitKey) {
+  const st = load();
+  const key = explicitKey || process.env.READYSTACK_LICENSE || st.key;
+  if (!key) return { ok: false, why: 'no_key' };
+  const age = Date.now() - (st.okAt || 0);
+  if (!explicitKey && st.key === key && age < RECHECK_MS) return { ok: true, cached: true };
+  const r = await validate(String(key).trim());
+  if (r.ok) { save({ key: String(key).trim(), okAt: Date.now() }); return { ok: true }; }
+  if (r.offline && st.key === key && age < GRACE_MS) return { ok: true, offline: true };
+  return { ok: false, why: r.offline ? 'offline' : 'invalid' };
+}
+// ★s134 — 구독 규칙 피드(층3 "바뀌면 업데이트"): 키 있는 손님만 · 7일마다 · 오프라인은 캐시. 워커 GET /api/rules/<slug>?key=
+const FEED_URL = 'https://getreadystack.com/api/rules/';
+function pullFeed() {
+  const st = load(); const key = process.env.READYSTACK_LICENSE || st.key; const cached = st.feed || null;
+  if (!key) return Promise.resolve(cached);
+  if (cached && (Date.now() - (st.feedAt || 0)) < RECHECK_MS) return Promise.resolve(cached);
+  return new Promise(function (resolve) {
+    let req;
+    try {
+      req = https.get(FEED_URL + encodeURIComponent(SLUG) + '?key=' + encodeURIComponent(key), { timeout: 8000, headers: { 'user-agent': 'readystack-cli' } }, function (res) {
+        let buf = ''; res.on('data', function (d) { buf += d; });
+        res.on('end', function () {
+          if (res.statusCode !== 200) return resolve(cached);
+          try { const j = JSON.parse(buf); if (!j || !Array.isArray(j.rules)) return resolve(cached); save(Object.assign(load(), { feed: j, feedAt: Date.now() })); resolve(j); }
+          catch (e) { resolve(cached); }
+        });
+      });
+    } catch (e) { return resolve(cached); }
+    req.on('timeout', function () { req.destroy(); resolve(cached); });
+    req.on('error', function () { resolve(cached); });
+  });
+}
+module.exports = { ensure, BUY_URL, storePath, pullFeed };

package/package.json ADDED Viewed

@@ -0,0 +1,32 @@
+{
+  "name": "@readystack/einvoice-lint-en16931",
+  "version": "0.1.0",
+  "description": "Catches retired profile identifiers, code-list values outside EN 16931 and malformed dates in your e-invoice XML, in the editor, before an access point rejects the file.",
+  "license": "SEE LICENSE IN LICENSE.txt",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "xrechnung",
+    "factur-x",
+    "en16931",
+    "peppol",
+    "ubl"
+  ],
+  "homepage": "https://getreadystack.com",
+  "funding": "https://buy.polar.sh/polar_cl_uvaD8HrNLY041vZaDJqCklAVjAZRz5CnK5b184gKfFx",
+  "bin": {
+    "einvoice-lint-en16931": "cli.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "cli.js",
+    "license.js",
+    "rules.json",
+    "strings.json",
+    "README.md",
+    "LICENSE.txt"
+  ]
+}

package/rules.json ADDED Viewed

@@ -0,0 +1,184 @@
+[
+ {
+  "pattern": "xoev-de:kosit:standard:xrechnung_1\\.\\d",
+  "flags": "i",
+  "sev": "error",
+  "message": "XRechnung 1.x specification identifier (BT-24). Version 1.x has not been a valid XRechnung since 2020; a German public-sector or B2B receiver rejects the file at the gate.",
+  "fix": "urn:cen.eu:en16931:2017#compliant#urn:xoev-de:kosit:standard:xrechnung_3.0"
+ },
+ {
+  "pattern": "xoev-de:kosit:standard:xrechnung_2\\.\\d",
+  "flags": "i",
+  "sev": "error",
+  "message": "XRechnung 2.x specification identifier (BT-24). Version 2.3 stopped being valid on 1 February 2024, when 3.0 took over. This is the identifier a chatbot most often hands you.",
+  "fix": "urn:cen.eu:en16931:2017#compliant#urn:xoev-de:kosit:standard:xrechnung_3.0"
+ },
+ {
+  "pattern": "xoev-de:kosit:standard:xrechnung_3\\.0\\.\\d",
+  "flags": "i",
+  "sev": "error",
+  "message": "The bundle version (3.0.1 / 3.0.2) has been written into BT-24. The specification identifier stays at xrechnung_3.0 for the whole 3.0 line - only the KoSIT bundle carries the third digit.",
+  "fix": "urn:cen.eu:en16931:2017#compliant#urn:xoev-de:kosit:standard:xrechnung_3.0"
+ },
+ {
+  "pattern": "urn:factur-x\\.eu:1p0:minimum",
+  "flags": "i",
+  "sev": "error",
+  "message": "Factur-X MINIMUM profile. MINIMUM carries header data only - the line items stay in the PDF layer - so it is not EN 16931 compliant and the French B2B route does not accept it as a structured invoice.",
+  "fix": "urn:cen.eu:en16931:2017 (EN 16931 profile) or urn:cen.eu:en16931:2017#conformant#urn:factur-x.eu:1p0:extended"
+ },
+ {
+  "pattern": "urn:factur-x\\.eu:1p0:basicwl",
+  "flags": "i",
+  "sev": "error",
+  "message": "Factur-X BASIC WL profile. BASIC WL is 'without lines' - no invoice lines in the XML - so it fails EN 16931 the same way MINIMUM does.",
+  "fix": "urn:cen.eu:en16931:2017 (EN 16931 profile) or urn:cen.eu:en16931:2017#conformant#urn:factur-x.eu:1p0:extended"
+ },
+ {
+  "pattern": "urn:ferd:CrossIndustryDocument:invoice:1p0",
+  "flags": "i",
+  "sev": "error",
+  "message": "ZUGFeRD 1.0 context parameter. ZUGFeRD 1.0 predates EN 16931 and uses the old CrossIndustryDocument namespace; nothing in the 2026 mandates reads it.",
+  "fix": "Regenerate as ZUGFeRD 2.x / Factur-X: urn:cen.eu:en16931:2017"
+ },
+ {
+  "pattern": "urn:zugferd\\.de:2p0:",
+  "flags": "i",
+  "sev": "warn",
+  "message": "ZUGFeRD 2.0 profile identifier. From 2.1 onward the profiles moved to the shared Factur-X URNs; receivers that only know the current set will not match this one.",
+  "fix": "urn:cen.eu:en16931:2017 for the EN 16931 profile"
+ },
+ {
+  "pattern": "urn:www\\.cenbii\\.eu:transaction:biitrns",
+  "flags": "i",
+  "sev": "error",
+  "message": "CENBII / Peppol BIS 2.0 transaction identifier. That generation of the network was switched off in 2019; BIS Billing 3.0 replaced it.",
+  "fix": "urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0"
+ },
+ {
+  "pattern": "<cbc:ProfileID[^>]*>\\s*urn:fdc:peppol\\.eu:2017:poacc:billing:(?!01:1\\.0\\s*<)",
+  "flags": "",
+  "sev": "error",
+  "message": "Peppol BIS Billing profile identifier (BT-23) is not the billing process id. For an invoice or credit note it is always the 01:1.0 process, whatever the customization says.",
+  "fix": "urn:fdc:peppol.eu:2017:poacc:billing:01:1.0"
+ },
+ {
+  "pattern": "<cbc:UBLVersionID>\\s*(?!2\\.1\\s*<)",
+  "flags": "",
+  "sev": "error",
+  "message": "UBLVersionID is not 2.1. EN 16931 and Peppol BIS Billing 3.0 are both bound to UBL 2.1; any other value makes the syntax binding undefined.",
+  "fix": "<cbc:UBLVersionID>2.1</cbc:UBLVersionID>"
+ },
+ {
+  "pattern": "<cbc:InvoiceTypeCode[^>]*>\\s*381\\s*<",
+  "flags": "",
+  "sev": "error",
+  "message": "Type code 381 (credit note) inside a UBL Invoice document. In UBL a credit note is its own root element with CreditNoteTypeCode; 381 in an Invoice is a document-type mismatch, not a code-list problem.",
+  "fix": "Send a <CreditNote> with <cbc:CreditNoteTypeCode>381</cbc:CreditNoteTypeCode>, or use 384 (corrected invoice) if you meant to replace an invoice."
+ },
+ {
+  "pattern": "<cbc:InvoiceTypeCode[^>]*>\\s*(?!(?:71|80|82|84|102|218|219|326|331|380|381|382|383|384|386|388|389|393|395|553|575|623|780|817|870|875|876|877)\\s*<)",
+  "flags": "",
+  "sev": "error",
+  "message": "Invoice type code (BT-3) is outside the UNTDID 1001 subset that EN 16931 and Peppol BIS Billing 3.0 allow. Codes invented outside the subset fail schematron before any business rule runs.",
+  "fix": "380 commercial invoice, 384 corrected invoice, 386 prepayment invoice, 389 self-billed invoice, 326 partial invoice, 875/876/877 construction invoices."
+ },
+ {
+  "pattern": "<ram:CategoryCode>\\s*(?!(?:AE|B|E|G|K|L|M|O|S|Z)\\s*<)",
+  "flags": "",
+  "sev": "error",
+  "message": "VAT category code is outside UNTDID 5305. The list has exactly ten entries and each one drives a different BR-* rule set, so a wrong letter silently changes which VAT rules are applied.",
+  "fix": "S standard, Z zero rated, E exempt, AE reverse charge, K intra-community, G export, O outside scope, L Canary Islands, M Ceuta and Melilla, B transferred VAT (Italy)."
+ },
+ {
+  "pattern": "<cbc:(?:IssueDate|DueDate|TaxPointDate|StartDate|EndDate|ActualDeliveryDate|PaymentDueDate)>\\s*(?!\\d{4}-\\d{2}-\\d{2}\\s*<)",
+  "flags": "",
+  "sev": "error",
+  "message": "Date is not in the ISO 8601 form the UBL binding requires. Local formats such as 31.12.2026 or 12/31/2026 are the single most common reason a first e-invoice bounces.",
+  "fix": "YYYY-MM-DD, for example 2026-09-08"
+ },
+ {
+  "pattern": "<ram:DateTimeString[^>]*format=\\\"(?!102\\\")",
+  "flags": "",
+  "sev": "error",
+  "message": "CII date format qualifier is not 102. EN 16931 binds every date in Cross Industry Invoice to UNTDID 2379 format 102, so 101, 203 or 204 are rejected even when the date itself is correct.",
+  "fix": "format=\"102\" with the value written as CCYYMMDD"
+ },
+ {
+  "pattern": "<ram:DateTimeString[^>]*format=\\\"102\\\"\\s*>\\s*(?!\\d{8}\\s*<)",
+  "flags": "",
+  "sev": "error",
+  "message": "CII date is declared as format 102 but the value is not eight digits. Format 102 is CCYYMMDD with no separators - a hyphenated date here contradicts its own qualifier.",
+  "fix": "20260908, not 2026-09-08"
+ },
+ {
+  "pattern": "<cbc:EndpointID>",
+  "flags": "",
+  "sev": "error",
+  "message": "Electronic address (BT-34 / BT-49) carries no schemeID. The identifier is meaningless without the EAS code that says what kind of address it is, and routing cannot resolve it.",
+  "fix": "<cbc:EndpointID schemeID=\"9930\">DE123456789</cbc:EndpointID> - 9930 German VAT, 9957 French VAT, 0009 SIRET, 0088 GLN, 0198 Danish CVR."
+ },
+ {
+  "pattern": "<cbc:EndpointID[^>]*schemeID=\\\"[A-Z]{2}:[A-Z]{2,}\\\"",
+  "flags": "",
+  "sev": "error",
+  "message": "Legacy Peppol party scheme (DE:VAT, FR:SIRET and similar) in schemeID. Those string schemes were replaced by four-digit EAS codes; an access point on the current network cannot look this up.",
+  "fix": "Use the numeric EAS code: 9930 for DE:VAT, 9957 for FR:VAT, 0009 for FR:SIRET, 9925 for BE:VAT."
+ },
+ {
+  "pattern": "<cbc:EndpointID[^>]*>[^<]*@",
+  "flags": "",
+  "sev": "warn",
+  "message": "The electronic address looks like an email address. Peppol routes on registered participant identifiers, not mailboxes, so an email here means the invoice has nowhere to go.",
+  "fix": "Use the receiver's registered participant id with its EAS schemeID."
+ },
+ {
+  "pattern": "<cbc:(?:TaxAmount|PayableAmount|LineExtensionAmount|TaxExclusiveAmount|TaxInclusiveAmount|TaxableAmount|AllowanceTotalAmount|ChargeTotalAmount|PrepaidAmount|PayableRoundingAmount|Percent|BaseQuantity|InvoicedQuantity|MultiplierFactorNumeric)[^>]*>\\s*-?\\d+,\\d",
+  "flags": "",
+  "sev": "error",
+  "message": "Decimal comma in a numeric value. XML numeric types use a dot regardless of locale, so 1.234,56 written this way is read as a different number or fails the type check outright.",
+  "fix": "Write 1234.56 - no thousands separator, dot as the decimal mark."
+ },
+ {
+  "pattern": "<cbc:(?:TaxAmount|PayableAmount|LineExtensionAmount|TaxExclusiveAmount|TaxInclusiveAmount|TaxableAmount|AllowanceTotalAmount|ChargeTotalAmount|PrepaidAmount|PayableRoundingAmount|PriceAmount)>",
+  "flags": "",
+  "sev": "error",
+  "message": "Amount element has no currencyID attribute. Every amount in EN 16931 is a qualified amount; without the currency the value is not typed and the totals cannot be checked.",
+  "fix": "<cbc:PayableAmount currencyID=\"EUR\">1234.56</cbc:PayableAmount>"
+ },
+ {
+  "pattern": "<cbc:(?:TaxAmount|PayableAmount|LineExtensionAmount|TaxExclusiveAmount|TaxInclusiveAmount|TaxableAmount|AllowanceTotalAmount|ChargeTotalAmount|PrepaidAmount|PayableRoundingAmount)[^>]*>\\s*-?\\d+\\.\\d{3,}",
+  "flags": "",
+  "sev": "error",
+  "message": "Amount carries more than two decimals. The BR-DEC rules cap document and line amounts at two decimals; only the unit price (BT-146) may go finer, so this is not a rounding preference.",
+  "fix": "Round the amount to two decimals and keep the extra precision in cbc:PriceAmount."
+ },
+ {
+  "pattern": "<cbc:Percent[^>]*>[^<]*%",
+  "flags": "",
+  "sev": "error",
+  "message": "Percent sign inside the VAT rate value. The element is a number, and the symbol makes it fail type validation before any VAT rule is evaluated.",
+  "fix": "<cbc:Percent>19</cbc:Percent>"
+ },
+ {
+  "pattern": "unitCode=\\\"[^\\\"]*[a-z]",
+  "flags": "",
+  "sev": "warn",
+  "message": "Unit of measure code is not upper case. UN/ECE Recommendation 20 codes are upper case throughout, so Stk, pcs or kg are not in the list even though the intent is obvious.",
+  "fix": "H87 piece, C62 one, KGM kilogram, LTR litre, MTR metre, MTK square metre, DAY day, HUR hour, TNE tonne."
+ },
+ {
+  "pattern": "<\\?xml[^>]*encoding=\\\"(?![Uu][Tt][Ff]-8\\\")",
+  "flags": "",
+  "sev": "error",
+  "message": "The XML declaration asks for an encoding other than UTF-8. Every EN 16931 syntax binding is UTF-8, and a Latin-1 file turns umlauts and accented names into invalid characters on the receiving side.",
+  "fix": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>"
+ },
+ {
+  "pattern": "<cbc:BuyerReference\\s*/>|<cbc:BuyerReference>\\s*</cbc:BuyerReference>",
+  "flags": "",
+  "sev": "error",
+  "message": "Buyer reference (BT-10) is present but empty. XRechnung makes BT-10 mandatory - it is where the Leitweg-ID goes - and an empty element counts as missing, not as optional.",
+  "fix": "<cbc:BuyerReference>04011000-12345-56</cbc:BuyerReference> - the Leitweg-ID the buyer gave you."
+ }
+]

package/strings.json ADDED Viewed

@@ -0,0 +1,10 @@
+{
+ "name": "E-Invoice Lint for XRechnung, Factur-X and UBL",
+ "subtitle": "Catches retired profile identifiers, code-list values outside EN 16931 and malformed dates in your e-invoice XML, in the editor, before an access point rejects the file.",
+ "bin": "einvoice-lint-en16931",
+ "price": 29,
+ "free": "Check the open e-invoice against all 26 rules; Check only the lines you select; Reopen the last findings, with line numbers and severity; Read every rule that ships inside, in plain English",
+ "paid": "Check every e-invoice file in the repository; Findings report as CSV, JSON or HTML; JSON output a build step can fail on",
+ "need_key": "This option needs a licence (E-Invoice Lint for XRechnung, Factur-X and UBL).",
+ "exts": []
+}