plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "e-invoices",
  "version": "1.2.1",
  "description": "Understand Italian electronic invoices (FatturaPA) in ChatGPT: e-invoices.it reads an attached .xml, .xml.p7m or zip invoice and explains amounts, VAT, due dates and payment details.",
  "author": {
    "name": "Thomas Tschager",
    "url": "https://e-invoices.it/en/"
  },
  "homepage": "https://e-invoices.it/en/",
  "keywords": [
    "fatturapa",
    "fattura elettronica",
    "e-invoice",
    "italy",
    "vat",
    "sdi"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "e-invoices.it",
        "shortDescription": "Understand Italian e-invoices",
        "longDescription": "e-invoices.it helps you understand Italian electronic invoices (FatturaPA) before you pay them, book them or pass them to your accountant.\n\nAttach an invoice to the chat: a .xml file, a signed .xml.p7m file or a zip with one invoice, as you get it from the supplier or from the Agenzia delle Entrate portal Fatture e Corrispettivi. e-invoices.it reads it and shows it as a readable document: supplier and customer with their VAT numbers, line items, the VAT summary per rate, the total, due dates, payment details with IBAN, withholding tax and the names of the attached files. ChatGPT then answers your questions about it in your language, for example how much to pay and by when, how the VAT is made up, or what the Italian codes mean (document type, VAT nature, split payment, payment method).\n\nFor businesses, freelancers and accountants who receive Italian invoices, including foreign suppliers and customers who do not read Italian.\n\nOne invoice at a time. The plugin only reads invoices: it does not create or send them. For many invoices at once (one Excel file, PDFs, a dashboard), use https://e-invoices.it.\n\ne-invoices.it processes the file only in memory: it does not store the file and does not log anything about it.",
        "developerName": "Thomas Tschager",
        "category": "Finance",
        "websiteURL": "https://e-invoices.it/en/",
        "supportURL": "https://e-invoices.it/en/legal-notice#contatti",
        "privacyPolicyURL": "https://e-invoices.it/en/privacy",
        "termsOfServiceURL": "https://e-invoices.it/en/terms",
        "defaultPrompt": [
          "Summarize the invoice I attached",
          "When is this invoice due and how do I pay it?",
          "Break down the VAT of this invoice by rate"
        ],
        "brandColor": "#253494",
        "composerIcon": "./assets/logo.svg",
        "logo": "./assets/logo.svg"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Summary of an attached XML invoice",
              "prompt": "Summarize the invoice I attached.",
              "file_attachment_urls": [
                "https://e-invoices.it/static/demo/fattura.xml"
              ],
              "tools_triggered": "read_invoice",
              "expected_behavior": "Calls read_invoice with the attached file and shows the invoice. The answer names invoice 2025/0042 of 17 June 2025 from Bottega Alpina Srl to Hotel Dolomiti Spa, total 852.38 EUR, due 17 July 2025, by bank transfer."
            },
            {
              "description": "Due date and payment details",
              "prompt": "When is this invoice due and where do I have to pay it?",
              "file_attachment_urls": [
                "https://e-invoices.it/static/demo/fattura.xml"
              ],
              "tools_triggered": "read_invoice",
              "expected_behavior": "Calls read_invoice. The answer says 852.38 EUR are due on 17 July 2025 by bank transfer to IBAN IT00X0000000000012345678900 at Banca di Esempio."
            },
            {
              "description": "VAT summary per rate",
              "prompt": "Break down the VAT of this invoice by rate.",
              "file_attachment_urls": [
                "https://e-invoices.it/static/demo/fattura.xml"
              ],
              "tools_triggered": "read_invoice",
              "expected_behavior": "Calls read_invoice. The answer lists 4% on 192.00 = 7.68, 10% on 378.20 = 37.82 and 22% on 194.00 = 42.68, all with immediate VAT due, 88.18 EUR of VAT in total."
            },
            {
              "description": "Explanation in another language",
              "prompt": "Erkl\u00e4re mir diese italienische Rechnung auf Deutsch.",
              "file_attachment_urls": [
                "https://e-invoices.it/static/demo/fattura.xml"
              ],
              "tools_triggered": "read_invoice",
              "expected_behavior": "Calls read_invoice and answers in German: invoice (TD01, Fattura) 2025/0042 from Bottega Alpina Srl, total 852.38 EUR, due 17 July 2025; Italian terms such as imponibile are translated."
            },
            {
              "description": "Line items",
              "prompt": "Which items are on this invoice and what does each one cost?",
              "file_attachment_urls": [
                "https://e-invoices.it/static/demo/fattura.xml"
              ],
              "tools_triggered": "read_invoice",
              "expected_behavior": "Calls read_invoice. The answer lists five items: Speck Alto Adige IGP 231.00, Formaggio Stelvio DOP 192.00, Canederli allo speck 147.20, Succo di mela 149.00 and Trasporto refrigerato 45.00, with their VAT rates."
            }
          ],
          "negative": [
            {
              "description": "Creating an invoice is not supported",
              "prompt": "Write me an invoice for three hours of consulting at 80 euros per hour."
            },
            {
              "description": "General tax question without a file",
              "prompt": "What is the standard VAT rate in Italy?"
            },
            {
              "description": "Sending an invoice to the SdI is not supported",
              "prompt": "Send my invoice to the Sistema di Interscambio for me."
            }
          ]
        },
        "demo_recording_url": "https://eta.tschager.net/e-invoices-chatgpt-demo.webm"
      },
      "publication": {
        "release_notes": "Initial release: reads one Italian electronic invoice (FatturaPA as .xml, signed .xml.p7m or a zip with one invoice) attached in the chat, shows it as a readable document and answers questions about it: parties, amounts, VAT per rate, due dates, payment details and withholding tax, in the user's language.",
        "translations": {
          "it-IT": {
            "subtitle": "Leggi le fatture elettroniche",
            "description": "e-invoices.it ti aiuta a capire le fatture elettroniche (FatturaPA) prima di pagarle, registrarle o passarle al commercialista.\n\nAllega in chat una fattura: un file .xml, un .xml.p7m firmato o uno zip con una fattura, come la ricevi dal fornitore o dal portale Fatture e Corrispettivi dell'Agenzia delle Entrate. e-invoices.it la legge e la mostra come documento leggibile: fornitore e cliente con partita IVA, righe, riepilogo IVA per aliquota, totale, scadenze, dati di pagamento con IBAN, ritenute e nomi degli allegati. ChatGPT risponde poi alle tue domande, per esempio quanto pagare ed entro quando, come si compone l'IVA o cosa significano i codici.\n\nPer imprese, professionisti e commercialisti, e per chi riceve fatture italiane senza leggere l'italiano.\n\nUna fattura alla volta. Il plugin legge soltanto: non crea n\u00e9 invia fatture. Per molte fatture insieme (un unico Excel, PDF, una dashboard) usa https://e-invoices.it.\n\ne-invoices.it elabora il file solo in memoria: non lo salva e non ne registra nulla nei log."
          },
          "de-DE": {
            "subtitle": "E-Rechnungen aus Italien lesen",
            "description": "e-invoices.it hilft Ihnen, italienische elektronische Rechnungen (FatturaPA) zu verstehen, bevor Sie sie bezahlen, verbuchen oder an Ihre Steuerberatung weitergeben.\n\nH\u00e4ngen Sie eine Rechnung an den Chat an: eine .xml-Datei, eine signierte .xml.p7m-Datei oder ein ZIP mit einer Rechnung, so wie Sie sie vom Lieferanten oder aus dem Portal Fatture e Corrispettivi der Agenzia delle Entrate erhalten. e-invoices.it liest sie und zeigt sie als lesbares Dokument: Lieferant und Kunde mit USt-IdNr., Positionen, MwSt.-Zusammenfassung je Satz, Gesamtbetrag, F\u00e4lligkeiten, Zahlungsdaten mit IBAN, Quellensteuer und die Namen der Anh\u00e4nge. ChatGPT beantwortet dann Ihre Fragen auf Deutsch, etwa wie viel bis wann zu zahlen ist, wie sich die MwSt. zusammensetzt oder was die italienischen Codes bedeuten.\n\nF\u00fcr Unternehmen, Selbst\u00e4ndige und Steuerberatungen, die Rechnungen aus Italien erhalten.\n\nEine Rechnung auf einmal. Das Plugin liest nur: Es erstellt oder versendet keine Rechnungen. F\u00fcr viele Rechnungen zusammen (eine Excel-Datei, PDFs, ein Dashboard) nutzen Sie https://e-invoices.it.\n\ne-invoices.it verarbeitet die Datei nur im Arbeitsspeicher: Es speichert sie nicht und protokolliert nichts \u00fcber sie."
          }
        }
      },
      "apps": "./.app.json"
    }
  }
}