eliDocs
/
Integrations

GitHub Action

Validate EN 16931 e-invoices in CI and fail a pull request when a document stops matching authority-pinned rules.

Listing pending

The beliq validate Action runs Beliq validation inside GitHub Actions. Point it at your invoice files and it fails the job when any of them stop matching authority-pinned rules, so a regression is caught in the pull request instead of at your customer.

Usage

Add the BELIQ_API_KEY secret to your repository, then add a step:

name: e-invoice checks
on: [pull_request]
jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5
      - uses: beliq-eu/beliq-validate-action@v1
        with:
          files: "invoices/**/*.{xml,pdf}"
          fail-on: error
          api-key: ${{ secrets.BELIQ_API_KEY }}

Inputs

Input Default Description
files (required) A glob of XML or PDF invoices to validate
fail-on error Severity that fails the job
api-key (required) Your Beliq API key, from a repository secret

Outputs and summary

The Action writes a per-file table to the job summary and sets total, invalid, and results outputs. It exits non-zero when any file is invalid; an API or I/O error also fails the job (never a silent pass), and a glob that matches no files warns and passes.

See also