getreadystack/saft-pt-atcud-lint repository overview

⁠SAF-T (PT) + ATCUD Lint

14 verificações ao XML SAF-T (PT) antes da entrega à AT: versão 1.04_01, ATCUD, dados do QR code, hash, NIF, taxas por região e totais.

⁠Run

docker run --rm -v "$PWD":/work getreadystack/saft-pt-atcud-lint /work/file

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

⁠Free

• Analisa o ficheiro SAF-T (PT) aberto e mostra os 14 tipos de erro com o número da linha e o documento.
• --rules lists every rule

⁠With a licence ($29 once)

• Corre as mesmas 14 verificações em toda a pasta de exportações e grava um relatório CSV/JSON por ficheiro para o contabilista arquivar.

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

Rever os mesmos 14 pontos à mão: 3 documentos e 187 linhas de XML por exportação, e reexportar o período inteiro quando a AT devolve o ficheiro.

⁠Use from an AI agent (MCP)

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

{ "mcpServers": { "saft-pt-atcud-lint": { "command": "npx", "args": ["-y", "@readystack/saft-pt-atcud-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: SAF-T (PT) + ATCUD Lint
  run: npx -y @readystack/saft-pt-atcud-lint --dir . --ci

(container: docker run --rm -v "$PWD:/work" getreadystack/saft-pt-atcud-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⁠