plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "xrechnung-check",
  "version": "1.0.0",
  "description": "Validates German e-invoices (XRechnung, ZUGFeRD / Factur-X) with the official KoSIT rules and explains every finding in plain language.",
  "author": {
    "name": "Tim Eiko Neunzig",
    "email": "tim@ki-katapult.de",
    "url": "https://plugins.ki-katapult.de"
  },
  "homepage": "https://plugins.ki-katapult.de/plugins/xrechnung-check",
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "XRechnung Validator",
        "shortDescription": "Check and explain e-invoices",
        "longDescription": "XRechnung Validator checks German e-invoices against the official rules and explains every finding in plain language.\n\n- Validates XRechnung (UBL or CII XML) with the KoSIT validator and the current XRechnung configuration.\n- Validates ZUGFeRD / Factur-X PDFs, including the profile rules and the PDF/A-3 container.\n- Flags ZUGFeRD profiles MINIMUM and BASIC WL, which are not e-invoices under German rules.\n- Shows for each finding the rule ID (for example BR-DE-15), the affected field (BT number), a plain explanation and the fix.\n- Explains any rule ID on request, with its source and effective date.\n- Summarises an invoice: parties, totals, VAT breakdown and line items, with IBANs masked.\n- Turns an XRechnung, which has no visual layer, into a readable PDF that can be downloaded for 60 minutes.\n\nUp to 10 files per request. Uploaded files are not stored, and generated PDFs are deleted after 60 minutes. The plugin does not send invoices, repair XML or give tax advice.",
        "category": "Productivity",
        "capabilities": [
          "Validate XRechnung UBL and CII with the official KoSIT rules",
          "Validate ZUGFeRD / Factur-X PDFs including PDF/A-3",
          "Explain rule IDs such as BR-DE-15 with the field and fix",
          "Summarise an e-invoice with masked IBAN",
          "Render an XRechnung as a readable PDF"
        ],
        "defaultPrompt": [
          "Check this XRechnung and explain every error.",
          "Is this ZUGFeRD PDF a valid e-invoice?",
          "Which fields are missing for a valid XRechnung?"
        ],
        "brandColor": "#1F4E79",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png",
        "developerName": "Tim Eiko Neunzig",
        "websiteURL": "https://plugins.ki-katapult.de/plugins/xrechnung-check",
        "supportURL": "https://plugins.ki-katapult.de/support",
        "privacyPolicyURL": "https://plugins.ki-katapult.de/privacy",
        "termsOfServiceURL": "https://plugins.ki-katapult.de/terms"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Case 1: valid XRechnung UBL",
              "prompt": "Check this XRechnung.",
              "tools_triggered": "validate_einvoice",
              "expected_behavior": "Calls validate_einvoice with the attached file and reports verdict valid with 0 errors, naming format XRechnung, syntax UBL and version 3.0.",
              "file_attachment_urls": [
                "https://xrechnung-check.ki-katapult.de/review/01.01a-INVOICE_ubl.xml"
              ]
            },
            {
              "description": "Case 2: XRechnung without buyer reference",
              "prompt": "Why is this invoice rejected?",
              "tools_triggered": "validate_einvoice",
              "expected_behavior": "Calls validate_einvoice and reports verdict invalid with rule BR-DE-15 on field BT-10, explains that the buyer reference is required and gives the fix (enter the buyer reference, the Leitweg-ID for public buyers).",
              "file_attachment_urls": [
                "https://xrechnung-check.ki-katapult.de/review/01.01a-INVOICE_ubl-without-BT-10.xml"
              ]
            },
            {
              "description": "Case 3: ZUGFeRD PDF in profile EN 16931",
              "prompt": "Is this ZUGFeRD PDF a valid e-invoice?",
              "tools_triggered": "validate_einvoice",
              "expected_behavior": "Calls validate_einvoice and reports verdict valid, profile EN 16931 and PDF/A-3 passed.",
              "file_attachment_urls": [
                "https://xrechnung-check.ki-katapult.de/review/EN16931_Einfach.pdf"
              ]
            },
            {
              "description": "Case 4: explain rule BR-DE-15",
              "prompt": "What does BR-DE-15 mean?",
              "tools_triggered": "explain_einvoice_rule",
              "expected_behavior": "Calls explain_einvoice_rule and explains that the buyer reference (BT-10) is required, with the Leitweg-ID for public buyers, the source and effective date, and says once that this is not legal or tax advice."
            },
            {
              "description": "Case 5: readable PDF of an XRechnung",
              "prompt": "Make this XRechnung readable as a PDF.",
              "tools_triggered": "create_readable_pdf",
              "expected_behavior": "Calls create_readable_pdf and returns a download link valid for 60 minutes to a PDF whose seller, buyer, invoice number and totals match the XML (gross total 336.90 EUR = BT-112).",
              "file_attachment_urls": [
                "https://xrechnung-check.ki-katapult.de/review/01.01a-INVOICE_ubl.xml"
              ]
            }
          ],
          "negative": [
            {
              "description": "Case 6: scanned or plain PDF without embedded XML; no verdict is invented",
              "prompt": "Validate this scanned invoice."
            },
            {
              "description": "Case 7: sending via Peppol is not supported; validation is offered",
              "prompt": "Send this invoice to my customer via Peppol."
            },
            {
              "description": "Case 8: tax deductibility is tax advice; the technical check is offered",
              "prompt": "Is this invoice tax-deductible?"
            }
          ]
        },
        "demo_recording_url": "https://plugins.ki-katapult.de/review-videos/xrechnung-check.mp4",
        "commerce": false
      },
      "publication": {
        "countries": [
          "DE",
          "AT",
          "CH"
        ],
        "release_notes": "1.0.0: first release. XRechnung is checked with KoSIT validator 1.6.3 and the XRechnung 3.0.2 validator configuration release 2026-08-31; ZUGFeRD / Factur-X and PDF/A-3 with Mustang 2.26.0."
      },
      "apps": "./.app.json"
    }
  }
}