getreadystack/en16931-einvoice-lint repository overview

⁠EN 16931 e-Invoice Lint

Checks an invoice payload or field mapping against EN 16931 and the national CIUS of the country it detects — 29 rules, in your editor.

⁠Run

docker run --rm -v "$PWD":/work getreadystack/en16931-einvoice-lint /work/file

The same 29 rules as the VS Code extension, in a container. Mount a folder on /work.

⁠Free

• Check the invoice payload or field mapping open in your editor against all 29 rules, with every finding and every fix shown
• --rules lists every rule

⁠With a licence ($29 once)

• Sweep every invoice mapping in the workspace in one pass and write a dated report file you keep, commit and hand to an auditor

docker run --rm -e READYSTACK_LICENSE=<key> -v "$PWD":/work getreadystack/en16931-einvoice-lint --dir /work --ci

A German tax adviser's time fee is fixed by StBVV § 13 at EUR 30-70 per half hour (EUR 60-140 an hour); one review of one invoice mapping costs more than this licence.

⁠Use from an AI agent (MCP)

Claude Code · Cursor · Windsurf · any MCP client - add to your MCP config:

{ "mcpServers": { "en16931-einvoice-lint": { "command": "npx", "args": ["-y", "@readystack/en16931-einvoice-lint", "--mcp"] } } }

Tools: check_text and check_file (free) · check_dir (licence). The agent gets every finding with the line number.

⁠Use in CI

- name: EN 16931 e-Invoice Lint
  run: npx -y @readystack/en16931-einvoice-lint --dir . --ci

(container: docker run --rm -v "$PWD:/work" getreadystack/en16931-einvoice-lint --dir /work --ci)

The folder sweep, reports and CI mode need one licence — one payment, no subscription. Set READYSTACK_LICENSE=<key> or run --license <key> once.

Get a licence⁠