plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "kontocsv",
  "version": "1.0.0",
  "description": "Inspect and convert bank statement PDFs and transaction CSVs into accounting-ready exports using a connected KontoCSV account.",
  "author": {
    "name": "KontoCSV",
    "email": "support@kontocsv.de",
    "url": "https://www.kontocsv.de"
  },
  "homepage": "https://www.kontocsv.de",
  "keywords": [
    "bank statements",
    "accounting",
    "csv",
    "datev",
    "xero",
    "bookkeeping"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "KontoCSV",
        "shortDescription": "Bank statements to accounting",
        "longDescription": "KontoCSV inspects bank statement PDFs and transaction CSVs, checks document and accounting constraints, and creates supported accounting exports such as standard bank CSV, DATEV, Lexware, Xero and Exact Online. The plugin uses only credits already available in the connected KontoCSV account. It does not sell credits, display prices, start checkout or promote upgrades inside ChatGPT.",
        "developerName": "KontoCSV",
        "category": "Finance",
        "capabilities": [
          "Inspect bank statements",
          "Prepare accounting conversions",
          "Convert with existing credits",
          "Track conversion status",
          "Download accounting exports"
        ],
        "websiteURL": "https://www.kontocsv.de",
        "supportURL": "https://www.kontocsv.de/support",
        "privacyPolicyURL": "https://www.kontocsv.de/en/privacy/plugin",
        "termsOfServiceURL": "https://www.kontocsv.de/en/terms",
        "defaultPrompt": [
          "Inspect this bank statement and tell me which accounting export formats are available.",
          "Convert this bank statement to DATEV using my existing KontoCSV credits.",
          "Convert this transaction CSV to Exact Online using my existing KontoCSV credits."
        ],
        "brandColor": "#238A5E",
        "brandColorDark": "#6EE7B7",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/icon.png"
      },
      "onboardingSkill": "./skills/get-started/SKILL.md",
      "review": {
        "demo_recording_url": "https://www.kontocsv.de/review-fixtures/kontocsv-openai-plugin-review-demo.mp4",
        "test_cases": {
          "positive": [
            {
              "description": "Inspect an attached synthetic PDF bank statement without starting a conversion.",
              "prompt": "Inspect the attached bank statement and tell me which accounting export formats are available. Do not convert it.",
              "tools_triggered": "ingest_attached_bank_statement, inspect_bank_statement",
              "expected_behavior": "Import the attached synthetic PDF into private KontoCSV storage, inspect it without spending credits, and report the compatible export profiles without starting a conversion.",
              "file_attachment_urls": [
                "https://www.kontocsv.de/review-fixtures/kontocsv-review-statement.pdf"
              ]
            },
            {
              "description": "Convert an attached PDF bank statement to DATEV using only existing account credits.",
              "prompt": "Convert the attached bank statement to DATEV SKR04 using my existing KontoCSV credits.",
              "tools_triggered": "ingest_attached_bank_statement, inspect_bank_statement, prepare_bank_statement_conversion, convert_bank_statement_for_accounting, get_conversion_status, download_accounting_export",
              "expected_behavior": "Inspect the file, show the required and available existing credits, obtain explicit confirmation before starting, then run the conversion, wait for a terminal status and return the accounting export when available.",
              "file_attachment_urls": [
                "https://www.kontocsv.de/review-fixtures/kontocsv-review-statement.pdf"
              ]
            },
            {
              "description": "Convert an attached PDF bank statement to Xero CSV using existing account credits.",
              "prompt": "Convert the attached bank statement to a Xero CSV using my existing KontoCSV credits.",
              "tools_triggered": "ingest_attached_bank_statement, inspect_bank_statement, prepare_bank_statement_conversion, convert_bank_statement_for_accounting, get_conversion_status, download_accounting_export",
              "expected_behavior": "Use the Xero export profile, require explicit confirmation before the conversion, and return the completed export or a clear terminal quality status.",
              "file_attachment_urls": [
                "https://www.kontocsv.de/review-fixtures/kontocsv-review-statement.pdf"
              ]
            },
            {
              "description": "Convert an attached synthetic transaction CSV to Exact Online using existing account credits.",
              "prompt": "Convert the attached transaction CSV to Exact Online using my existing KontoCSV credits.",
              "tools_triggered": "ingest_attached_bank_statement, inspect_bank_statement, prepare_bank_statement_conversion, convert_bank_statement_for_accounting, get_conversion_status, download_accounting_export",
              "expected_behavior": "Import the CSV, inspect the transaction input, prepare an Exact Online conversion using the connected account's existing credits, request explicit confirmation, and return the completed export when available.",
              "file_attachment_urls": [
                "https://www.kontocsv.de/review-fixtures/kontocsv-review-transactions.csv"
              ]
            },
            {
              "description": "Read the authenticated KontoCSV account's current credit balance.",
              "prompt": "How many KontoCSV credits do I currently have available?",
              "tools_triggered": "get_credit_balance",
              "expected_behavior": "Return the connected account's total, reserved and available credits without starting a conversion or purchase."
            }
          ],
          "negative": [
            {
              "description": "Do not sell digital credits or start a checkout inside ChatGPT.",
              "prompt": "Buy 100 KontoCSV credits for me right now inside ChatGPT.",
              "expected_behavior": "Explain that credit purchases are not available through the plugin. Do not display prices, create a checkout, link directly to checkout, or initiate a purchase."
            },
            {
              "description": "Do not use KontoCSV for unrelated document tasks.",
              "prompt": "Use KontoCSV to summarize my employment contract and rewrite the termination clause.",
              "expected_behavior": "Do not invoke KontoCSV tools because the request is unrelated to bank, card, payment statements or transaction CSV conversion."
            },
            {
              "description": "Respect a request to prepare but not start a conversion.",
              "prompt": "Using the attached bank statement, tell me whether a DATEV conversion is possible and how many existing credits it would use, but do not start the conversion.",
              "expected_behavior": "The plugin may ingest, inspect and prepare the conversion, but must not call convert_bank_statement_for_accounting.",
              "file_attachment_urls": [
                "https://www.kontocsv.de/review-fixtures/kontocsv-review-statement.pdf"
              ]
            }
          ]
        },
        "commerce": false,
        "commerce_description": "The ChatGPT directory profile uses only existing KontoCSV account credits. It does not sell credits, display prices, initiate checkout, promote upgrades or complete purchases."
      },
      "publication": {
        "release_notes": "Initial KontoCSV plugin release with bank statement inspection, attachment import, existing-credit conversion, status tracking and accounting export download.",
        "translations": {
          "de-DE": {
            "subtitle": "Kontoausz\u00fcge f\u00fcr Buchhaltung",
            "description": "KontoCSV pr\u00fcft PDF-Kontoausz\u00fcge und Transaktions-CSV und erstellt unterst\u00fctzte Buchhaltungsexporte. Das Plugin nutzt ausschlie\u00dflich bereits vorhandene KontoCSV-Credits und startet innerhalb von ChatGPT keinen Credit-Kauf oder Checkout."
          },
          "fr-FR": {
            "subtitle": "Relev\u00e9s vers comptabilit\u00e9",
            "description": "KontoCSV contr\u00f4le les relev\u00e9s bancaires PDF et les CSV de transactions et cr\u00e9e des exports comptables pris en charge. Le plugin utilise uniquement les cr\u00e9dits KontoCSV d\u00e9j\u00e0 disponibles et ne lance aucun achat ni paiement dans ChatGPT."
          },
          "es-ES": {
            "subtitle": "Extractos a contabilidad",
            "description": "KontoCSV revisa extractos bancarios PDF y CSV de transacciones y crea exportaciones contables compatibles. El plugin utiliza \u00fanicamente cr\u00e9ditos KontoCSV ya disponibles y no inicia compras ni pagos dentro de ChatGPT."
          },
          "it-IT": {
            "subtitle": "Estratti per contabilit\u00e0",
            "description": "KontoCSV controlla estratti conto PDF e CSV di transazioni e crea esportazioni contabili supportate. Il plugin usa esclusivamente crediti KontoCSV gi\u00e0 disponibili e non avvia acquisti o pagamenti in ChatGPT."
          },
          "nl-NL": {
            "subtitle": "Afschriften naar boekhouding",
            "description": "KontoCSV controleert PDF-bankafschriften en transactie-CSV's en maakt ondersteunde boekhoudexports. De plugin gebruikt alleen bestaande KontoCSV-credits en start geen aankoop of checkout binnen ChatGPT."
          }
        }
      },
      "apps": "./.app.json"
    }
  }
}