Troubleshooting#

Common Failures#

Schema validation failed#

  • Cause: template and XSD versions do not match.

  • Fix: use the same message type for both assets, or omit --template and --schema so the registry auto-resolves bundled files.

Data validation failed#

  • Cause: missing required CSV columns, invalid IBAN/BIC fields, or bad dates.

  • Fix: run pain001 --dry-run first and inspect the validation error.

Path validation failed#

  • Cause: parent traversal, output path outside the working directory, or unsupported template directives.

  • Fix: use repo-local or temp-local paths, and avoid Jinja include, extends, and import directives in XML templates.

CLI Exit Codes#

  • 0: success

  • 1: validation or processing failure

  • 2: CLI/configuration error