plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "fakvio",
  "version": "0.1.5",
  "description": "Invoicing for Czech freelancers and small businesses, run from your AI assistant: issue, send and track invoices, VAT filings and accounting exports.",
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Fakvio",
        "shortDescription": "AI invoicing for Czech firms",
        "longDescription": "Fakvio is cloud invoicing for Czech sole traders (OSV\u010c) and small companies, built to be run from your AI assistant. Through this app you can create, issue and e-mail invoices, credit notes and proforma invoices, manage clients with ARES lookup, record received invoices, match bank payments, and get VAT reports, EPO filings and exports for Pohoda, Money S3 and ABRA Flexi.",
        "developerName": "Fakvio",
        "category": "Productivity",
        "capabilities": [
          "Read",
          "Write"
        ],
        "websiteURL": "https://fakvio.cz",
        "supportURL": "https://fakvio.cz",
        "privacyPolicyURL": "https://fakvio.cz/privacy.html",
        "termsOfServiceURL": "https://fakvio.cz/terms.html",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/icon.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Dashboard and recent invoices (read)",
              "prompt": "Show me my Fakvio dashboard and my five latest invoices.",
              "tools_triggered": "get_dashboard, list_invoices",
              "expected_behavior": "Unpaid total, overdue count and top clients from the dashboard, then a list of the five newest issued documents with number, client, amount and status. No write tool is called."
            },
            {
              "description": "Issue an invoice and send it by e-mail (write)",
              "prompt": "Create an invoice for client Novak s.r.o.: 10 hours of consulting at 1500 CZK plus 21 % VAT, due in 14 days. Issue it and e-mail it to the client.",
              "tools_triggered": "list_clients, create_invoice, complete_invoice, get_invoice_email_options, send_invoice_email",
              "expected_behavior": "A draft is created, then completed with a document number from the default number sequence. The assistant shows the rendered e-mail subject and body before sending and asks for confirmation (send_invoice_email is destructive). The e-mail goes to the client's stored contact, a test mailbox we control."
            },
            {
              "description": "Overdue invoices and unmatched bank payments (read)",
              "prompt": "Which invoices are overdue, and which incoming bank payments from the last 30 days are still unmatched?",
              "tools_triggered": "get_overdue_invoices, list_payments",
              "expected_behavior": "Two lists: overdue issued invoices sorted by due date ascending (most overdue first) and incoming unmatched payments from the last 30 days with amount, date and counterparty."
            },
            {
              "description": "Record and approve a received supplier invoice (write)",
              "prompt": "Record a received invoice from supplier ABC s.r.o., number 2026-0042, 500 EUR without VAT, received today, due 2026-11-15, then approve it.",
              "tools_triggered": "list_clients, create_invoice, complete_invoice",
              "expected_behavior": "A received invoice (documentType ReceivedInvoice, currency EUR) exists in status Approved with the supplier's number 2026-0042 kept; list_invoices with documentType ReceivedInvoice lists it."
            },
            {
              "description": "VAT report and EPO export (read, download link)",
              "prompt": "Prepare my VAT summary for Q3 2026 and give me the EPO XML for the VAT return.",
              "tools_triggered": "get_vat_report, export_vat_epo",
              "expected_behavior": "Output VAT, input VAT and liability figures for 2026-07-01 to 2026-09-30, plus a short-lived downloadUrl for the DPHDP3 XML that the assistant hands to the user as a link without fetching the file."
            }
          ],
          "negative": [
            {
              "description": "Write tool with read-only consent: after connecting with Read only on the Fakvio consent screen, mark_invoice_paid returns a structured forbidden error (write scope required) and nothing changes.",
              "prompt": "Mark invoice FAK2026001 as paid."
            },
            {
              "description": "Document that does not exist: find_invoice_by_number returns not_found; the assistant says no such document exists instead of inventing one.",
              "prompt": "Show me invoice number XYZ-DOES-NOT-EXIST."
            },
            {
              "description": "Invalid input on a write tool: create_invoice returns validation_error (quantity must be positive, 99 % is not an active VAT rate); no draft is created.",
              "prompt": "Create an invoice for client Novak s.r.o. with one line: quantity -3, unit price 1000 CZK, VAT rate 99 %."
            }
          ]
        },
        "demo_recording_url": "https://drive.zcloud.cz/#/s/k_yycCcN_xrEG_2vHfGyraX_bR_NrFoZuw6TAXuUtvU",
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments. It manages the user's own invoicing data in Fakvio."
      },
      "publication": {
        "release_notes": "Initial submission. 90 tools for Czech invoicing (invoices, clients, received invoices, payments, reminders, VAT/EPO/OSS reports, tax estimates). OAuth 2.1 with PKCE and Client ID Metadata Document; every tool carries explicit readOnlyHint, destructiveHint and openWorldHint annotations."
      },
      "apps": "./.app.json"
    }
  }
}