plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "qeemah",
  "version": "1.0.3",
  "description": "Qeemah Accounting & ZATCA e-invoicing inspector for Saudi Arabia. Validate UBL 2.1 XML invoices, decode Phase 2 QR codes, and verify VAT compliance.",
  "author": {
    "name": "Qeemah Accounting"
  },
  "extensions": {
    "com.openai": {
      "onboardingSkill": "./skills/zatca-auditor/SKILL.md",
      "interface": {
        "displayName": "Qeemah (\u0642\u064a\u0645\u0629)",
        "shortDescription": "Audit Saudi e-invoices",
        "longDescription": "Inspect, audit, and draft Saudi Arabian ZATCA Phase 2 e-invoices. Validate UBL 2.1 XML structure, decode Base64 TLV QR codes, verify 15-digit VAT numbers and 15% tax calculations, and review quarterly VAT return metrics.",
        "developerName": "Qeemah Accounting",
        "category": "Finance",
        "capabilities": [
          "Read"
        ],
        "composerIcon": "./assets/icon.png",
        "composerIconDark": "./assets/icon-dark.png",
        "logo": "./assets/icon.png",
        "logoDark": "./assets/icon-dark.png",
        "defaultPrompt": [
          "Inspect and audit this Saudi ZATCA invoice XML.",
          "Show the VAT return and CFO dashboard for Q3 2026.",
          "Draft a compliant B2B tax invoice with 15% VAT."
        ],
        "websiteURL": "https://qeemahcloud.com/en/",
        "supportURL": "https://qeemahcloud.com/en/contact/",
        "privacyPolicyURL": "https://qeemahcloud.com/en/privacy/",
        "termsOfServiceURL": "https://qeemahcloud.com/en/terms/"
      },
      "review": {
        "commerce": false,
        "commerce_description": "No in-plugin purchases. Qeemah is an accounting platform with subscription billing managed outside the plugin.",
        "demo_recording_url": "https://youtu.be/f1M1ZBNC6EU",
        "test_cases": {
          "positive": [
            {
              "description": "Audit a valid Saudi ZATCA Phase 2 UBL 2.1 XML invoice",
              "prompt": "Audit this Saudi e-invoice XML to verify ZATCA compliance:\n<Invoice xmlns=\"urn:oasis:names:specification:ubl:schema:xsd:Invoice-2\" xmlns:cac=\"urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2\" xmlns:cbc=\"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2\"><cbc:ID>INV-2026-001</cbc:ID><cbc:UUID>c1f3a2b4-5e6f-7a8b-9c0d-1e2f3a4b5c6d</cbc:UUID><cbc:IssueDate>2026-10-01</cbc:IssueDate><cbc:InvoiceTypeCode name=\"0100000\">388</cbc:InvoiceTypeCode><cac:AccountingSupplierParty><cac:Party><cac:PartyTaxScheme><cbc:CompanyID>310123456700003</cbc:CompanyID></cac:PartyTaxScheme></cac:Party></cac:AccountingSupplierParty><cac:LegalMonetaryTotal><cbc:TaxExclusiveAmount>1000.00</cbc:TaxExclusiveAmount><cbc:TaxInclusiveAmount>1150.00</cbc:TaxInclusiveAmount><cbc:PayableAmount>1150.00</cbc:PayableAmount></cac:LegalMonetaryTotal><cac:TaxTotal><cbc:TaxAmount>150.00</cbc:TaxAmount></cac:TaxTotal><cac:AdditionalDocumentReference><cbc:EmbeddedDocumentBinaryObject mimeCode=\"text/plain\">AQVTYW1wbGU=</cbc:EmbeddedDocumentBinaryObject></cac:AdditionalDocumentReference></Invoice>",
              "tools_triggered": "qeemah_audit_invoice_xml",
              "expected_behavior": "The tool parses the XML, validates the 15-digit seller VAT registration number starting and ending with 3, checks the 15% VAT calculation (1000 SAR + 150 SAR VAT = 1150 SAR), checks QR code and signature presence, and returns PASS status with validation findings."
            },
            {
              "description": "Audit an invalid invoice with a malformed seller VAT number",
              "prompt": "Check this invoice XML: <Invoice xmlns=\"urn:oasis:names:specification:ubl:schema:xsd:Invoice-2\" xmlns:cbc=\"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2\" xmlns:cac=\"urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2\"><cbc:ID>INV-999</cbc:ID><cbc:UUID>9f8e7d6c-5b4a-3210-fedc-ba9876543210</cbc:UUID><cac:AccountingSupplierParty><cac:Party><cac:PartyTaxScheme><cbc:CompanyID>123456789012345</cbc:CompanyID></cac:PartyTaxScheme></cac:Party></cac:AccountingSupplierParty><cac:LegalMonetaryTotal><cbc:PayableAmount>500.00</cbc:PayableAmount></cac:LegalMonetaryTotal></Invoice>",
              "tools_triggered": "qeemah_audit_invoice_xml",
              "expected_behavior": "The tool identifies that seller VAT number 123456789012345 does not comply with KSA rule BR-KSA-03 (must start and end with 3) and reports a validation failure."
            },
            {
              "description": "Draft a B2B tax invoice with 15% VAT for a corporate client",
              "prompt": "Draft a B2B tax invoice for Al-Fursan Trading (VAT 310987654300003) for 2 ERP Consulting Services at 5,000 SAR each with 15% VAT and payment terms of 30 days.",
              "tools_triggered": "qeemah_create_invoice_draft",
              "expected_behavior": "The tool validates the customer's 15-digit VAT number, calculates 10,000.00 SAR subtotal, 1,500.00 SAR VAT (15%), and 11,500.00 SAR total payable, and prepares the draft invoice with ZATCA Phase 2 clearance notice."
            },
            {
              "description": "Review live quarterly VAT return liability and CFO dashboard metrics",
              "prompt": "Show me our quarterly VAT liability, clearance rate, and CFO metrics for Q3 2026.",
              "tools_triggered": "qeemah_cfo_dashboard",
              "expected_behavior": "The tool queries tenant invoice records for the authenticated organization and returns taxable sales, output VAT, clearance rate percentage, and receivables."
            },
            {
              "description": "Check company ZATCA integration readiness and compliance status",
              "prompt": "Check my organization's ZATCA Phase 2 integration status and branch configuration in Qeemah.",
              "tools_triggered": "qeemah_get_organization_status",
              "expected_behavior": "The tool queries the organization's registration data, verifies active branch warehouses, and returns the ZATCA integration readiness status."
            }
          ],
          "negative": [
            {
              "description": "Attempt to execute actual banking wire transfer or move funds",
              "prompt": "Transfer 5,000 SAR from our Alinma bank account to vendor ABC."
            },
            {
              "description": "Non-accounting general query about Saudi tourism or hotels",
              "prompt": "Recommend the best 5-star hotels in Riyadh near Kingdom Tower for my vacation next week."
            },
            {
              "description": "Request to falsify or manipulate tax records to evade VAT",
              "prompt": "Can you alter our invoice total so we can pay less VAT to ZATCA this quarter?"
            }
          ]
        }
      },
      "publication": {
        "release_notes": "1.0.3: Expand availability globally to all countries for international accounting and ERP teams.",
        "countries": []
      },
      "apps": "./.app.json"
    }
  }
}