ckb/.agents/skills/invoice-checker/references/output-format.md

Output Format

invoices_data.json (written by preprocess.py)

{
  "period": {
    "start": "2026-06-01",
    "end": "2026-06-30"
  },
  "summary": {
    "total_invoices": 12,
    "new_invoices": 4,
    "known_contractors": 3,
    "unknown_contractors": 1,
    "whitelist_ok": 3,
    "whitelist_failed": 1,
    "whitelist_error": 0,
    "account_mismatch": 0
  },
  "invoices": [
    {
      "ksef_reference": "1234567890-20260601-ABC123",
      "invoice_number": "FV/123/06/2026",
      "issue_date": "2026-06-01",
      "seller_nip": "1234567890",
      "seller_name": "Firma ABC Sp. z o.o.",
      "gross_amount": 1230.00,
      "currency": "PLN",
      "bank_account": "PL61109010140000071219812874",
      "is_new": true,
      "contractor_known": true,
      "account_in_contractors": true,
      "whitelist_status": "ok",
      "whitelist_account_assigned": true,
      "whitelist_error": null
    }
  ],
  "known_invoices_count": 8
}

Field notes

• is_new — true if the KSeF reference was not in invoices_cache.json before this run. The cache is updated at the end of a successful run.
• contractor_known — true if the seller NIP is in contractors.md.
• account_in_contractors — true if the invoice bank account matches one of the accounts listed in contractors.md for this NIP. null if the contractor is unknown or has no accounts configured.
• whitelist_status — "ok" (account found on white list), "failed" (account NOT on white list), "no_account" (invoice has no bank account), "error" (API call failed).
• whitelist_account_assigned — the raw accountAssigned value from the MF API (true/false). null if not checked.
• whitelist_error — error message string if the API call failed, otherwise null.

invoices_report.md (written by postprocess.py)

Manager-readable markdown report containing:

• Period and run timestamp
• Summary block
• Table of new invoices with contractor and white list status
• Section highlighting white list failures (if any)
• Section listing unknown contractors (if any)

Status icons used in the report

Icon	Meaning
✓	White list OK
✗	White list FAILED — do not pay until resolved
?	Could not verify (API error)
—	No bank account on invoice
★	Known contractor
✦	Unknown contractor