.codex-plugin/plugin.json

{
  "name": "gst-invoice",
  "version": "1.0.0",
  "description": "GST tax invoice in the GST invoice format: CGST + SGST or IGST by place of supply, GSTIN check, HSN summary, amounts in words.",
  "author": {
    "name": "Zovo",
    "email": "support@zovo.one",
    "url": "https://zovo.one"
  },
  "homepage": "https://gst-invoice.zovo.one",
  "license": "Proprietary",
  "keywords": [
    "gst invoice format",
    "gst bill format",
    "tax invoice generator india",
    "gst invoice generator",
    "tax invoice format",
    "gst invoice format in excel",
    "gst bill format with hsn code",
    "cgst sgst igst",
    "gstin check",
    "amount in words lakh crore"
  ],
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "Zovo GST Invoice Maker",
    "shortDescription": "GST tax invoices for India",
    "longDescription": "Make a GST invoice in the GST invoice format (an Indian tax invoice) as a print-ready PDF and an Excel file. Give the seller, the buyer and the items (description, HSN or SAC code, quantity, unit, rate per unit, any reduction and GST rate), and Zovo GST Invoice Maker works out the tax the way a GST bill format needs it.\n\nThe place of supply decides the tax: CGST plus SGST when the seller and the place of supply are in the same state, CGST plus UTGST in union territories such as Chandigarh, and IGST for an inter-state sale. The state code is read from the first 2 digits of each GSTIN, and each GSTIN is checked for its format and its check character (the 15th character), so a mistyped GSTIN is flagged before the invoice goes out. The invoice is still made; the warning tells you what to correct.\n\nThe PDF has the supplier and recipient details with GSTINs and state codes, the invoice number and date, the place of supply with the state name and code, reverse charge yes or no, an item table with taxable value and tax per line, an HSN/SAC-wise tax summary table, a round off to the nearest rupee on its own line, and the total and the tax amount written in words in the Indian system (rupees and paise, lakh and crore). Bank details, terms, a ship-to address and original, duplicate and triplicate copies are optional. Names and addresses in Hindi and other Indian scripts print correctly. The Excel file has the items, the HSN summary and the invoice details as numbers you can add up.\n\nReductions per line (an amount or a percent), rates that already include GST, and reverse charge are supported. Amounts are computed in whole paise, without floating-point rounding.\n\nLimitations: export invoices (zero-rated under a LUT, or with port code and shipping bill) are not supported. This is not an e-invoice (no IRN or signed QR code from the Invoice Registration Portal) and not an e-way bill. It does not decide which GST rate applies to an item; it uses the rates you give. Compensation cess, TCS and TDS are not calculated. Up to 100 items per invoice, in rupees only. The invoice has the fields of Rule 46 of the CGST Rules that you provide; it is not tax advice.",
    "developerName": "Zovo",
    "category": "Finance",
    "capabilities": [
      "Interactive",
      "Read"
    ],
    "websiteURL": "https://gst-invoice.zovo.one",
    "supportURL": "https://gst-invoice.zovo.one/support",
    "privacyPolicyURL": "https://gst-invoice.zovo.one/privacy",
    "termsOfServiceURL": "https://gst-invoice.zovo.one/terms",
    "defaultPrompt": [
      "GST invoice: Sharma Traders, Pune (27AAPFU0939F1ZV) to Mehta Stores, Gujarat. 10 kg steel rod HSN 7214 at 520, 18%",
      "Tax invoice from Pixel Studio, Bengaluru to Rao Foods, Karnataka: website design SAC 998314, Rs 45,000 at 18% GST",
      "GST bill for 3 laptops HSN 8471 at 52,499 each, 18%, from Delhi Laptops to Kapoor and Sons, both in Delhi"
    ],
    "brandColor": "#0F6654",
    "brandColorDark": "#5FD0B4",
    "composerIcon": "./assets/icon.svg",
    "logo": "./assets/logo.png"
  },
  "extensions": {
    "com.openai": {
      "onboardingSkill": "./skills/gst-invoice/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Inter-state invoice with IGST",
              "prompt": "GST invoice: Sharma Traders, Pune (27AAPFU0939F1ZV) to Mehta Stores, Gujarat. 10 kg steel rod HSN 7214 at 520, 18%",
              "tools_triggered": "generate_gst_invoice",
              "expected_behavior": "Calls generate_gst_invoice. Seller state Maharashtra (27) from the GSTIN, place of supply Gujarat (24), so IGST: taxable value Rs 5,200.00, IGST Rs 936.00, total Rs 6,136.00 (Rupees Six Thousand One Hundred Thirty Six Only), with PDF and Excel links."
            },
            {
              "description": "Intra-state service with CGST and SGST",
              "prompt": "Tax invoice from Pixel Studio, Bengaluru (29AAGCB7383J1Z4) to Rao Foods, Karnataka: website design SAC 998314, Rs 45,000 at 18% GST",
              "tools_triggered": "generate_gst_invoice",
              "expected_behavior": "Calls generate_gst_invoice. Both in Karnataka (29), so CGST Rs 4,050.00 and SGST Rs 4,050.00 on taxable value Rs 45,000.00; total Rs 53,100.00."
            },
            {
              "description": "Invalid GSTIN flagged",
              "prompt": "GST bill from Sharma Traders, GSTIN 27AAPFU0939F1ZX, Pune, to Mehta Stores in Maharashtra: 1 steel rod HSN 7214 at 1000, 18%",
              "tools_triggered": "generate_gst_invoice",
              "expected_behavior": "Calls generate_gst_invoice. The invoice is made (CGST Rs 90.00 + SGST Rs 90.00, total Rs 1,180.00) and the seller GSTIN 27AAPFU0939F1ZX is flagged as not valid because the check character should be V."
            },
            {
              "description": "Lakh amount in words with round off",
              "prompt": "GST bill for 3 laptops HSN 8471 at 52,499 each, 18%, from Delhi Laptops to Kapoor and Sons, both in Delhi",
              "tools_triggered": "generate_gst_invoice",
              "expected_behavior": "Calls generate_gst_invoice. Taxable value Rs 1,57,497.00, CGST Rs 14,174.73 and SGST Rs 14,174.73, round off -0.46, total Rs 1,85,846.00 written as Rupees One Lakh Eighty Five Thousand Eight Hundred Forty Six Only."
            },
            {
              "description": "Union territory with UTGST",
              "prompt": "Tax invoice from City Prints, Chandigarh to Gill Traders, Chandigarh: printing SAC 998912, Rs 10,000 at 18%",
              "tools_triggered": "generate_gst_invoice",
              "expected_behavior": "Calls generate_gst_invoice. Chandigarh (04) is a union territory, so CGST Rs 900.00 and UTGST Rs 900.00; total Rs 11,800.00."
            }
          ],
          "negative": [
            {
              "description": "US sales tax invoice",
              "prompt": "Make an invoice for my Texas client with 8.25% sales tax",
              "tools_triggered": "",
              "expected_behavior": "Does not call generate_gst_invoice; it makes Indian GST invoices only."
            },
            {
              "description": "GST return filing",
              "prompt": "File my GSTR-3B for October",
              "tools_triggered": "",
              "expected_behavior": "Does not call generate_gst_invoice; it does not file returns."
            },
            {
              "description": "GST rate question",
              "prompt": "What is the GST rate on cement after the 2025 changes?",
              "tools_triggered": "",
              "expected_behavior": "Does not call generate_gst_invoice; it does not decide GST rates."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments.",
        "demo_recording_url": "https://gst-invoice.zovo.one/demo.mp4"
      },
      "publication": {
        "countries": [],
        "release_notes": "Initial release: Indian GST tax invoice PDF and Excel; CGST + SGST, CGST + UTGST or IGST by place of supply; GSTIN format and check character test; HSN/SAC-wise summary; round off; amounts in words in lakh and crore; discounts, GST-inclusive prices, reverse charge, ship-to, bank details, 1 to 3 copies.",
        "translations": {
          "pl-PL": {
            "subtitle": "Faktura GST dla Indii",
            "description": "Przygotuj faktur\u0119 GST w formacie indyjskiej faktury podatkowej jako PDF gotowy do druku i plik Excel. Podaj sprzedawc\u0119, nabywc\u0119 i pozycje (opis, kod HSN lub SAC, ilo\u015b\u0107, jednostka, cena, rabat, stawka GST), a Zovo GST Invoice Maker obliczy podatek.\n\nMiejsce dostawy decyduje o podatku: CGST i SGST w obr\u0119bie jednego stanu, CGST i UTGST na terytoriach zwi\u0105zkowych, IGST przy sprzeda\u017cy mi\u0119dzystanowej. Kod stanu jest odczytywany z pierwszych 2 cyfr numeru GSTIN, a ka\u017cdy GSTIN jest sprawdzany pod k\u0105tem formatu i znaku kontrolnego; b\u0142\u0119dny numer jest oznaczany, ale faktura i tak powstaje.\n\nPDF zawiera dane stron, numer i dat\u0119, miejsce dostawy, odwrotne obci\u0105\u017cenie, tabel\u0119 pozycji, zestawienie podatku wed\u0142ug HSN/SAC, zaokr\u0105glenie do pe\u0142nej rupii w osobnym wierszu oraz kwot\u0119 s\u0142ownie w systemie indyjskim (lakh, crore). Plik Excel zawiera pozycje, zestawienie HSN i szczeg\u00f3\u0142y.\n\nOgraniczenia: to nie jest e-faktura (brak IRN i kodu QR) ani e-way bill; narz\u0119dzie nie ustala stawki GST dla towaru; nie liczy cess, TCS ani TDS; do 100 pozycji, tylko INR. To nie jest porada podatkowa. Faktury eksportowe (zerowa stawka w ramach LUT) nie s\u0105 obs\u0142ugiwane."
          },
          "de-DE": {
            "subtitle": "GST-Rechnung f\u00fcr Indien",
            "description": "Erstellen Sie eine indische GST-Rechnung im GST-Rechnungsformat als druckfertiges PDF und als Excel-Datei. Geben Sie Verk\u00e4ufer, K\u00e4ufer und Positionen an (Beschreibung, HSN- oder SAC-Code, Menge, Einheit, Preis, Rabatt, GST-Satz), und Zovo GST Invoice Maker berechnet die Steuer.\n\nDer Leistungsort entscheidet: CGST plus SGST innerhalb eines Bundesstaats, CGST plus UTGST in Unionsterritorien, IGST bei Verk\u00e4ufen zwischen Bundesstaaten. Der Staatscode stammt aus den ersten 2 Ziffern der GSTIN, und jede GSTIN wird auf Format und Pr\u00fcfzeichen gepr\u00fcft; eine fehlerhafte GSTIN wird markiert, die Rechnung wird trotzdem erstellt.\n\nDas PDF enth\u00e4lt die Angaben beider Parteien, Nummer und Datum, Leistungsort, Reverse Charge, eine Positionstabelle, eine Steuer\u00fcbersicht nach HSN/SAC, die Rundung auf volle Rupien in einer eigenen Zeile und den Betrag in Worten im indischen System (Lakh, Crore). Die Excel-Datei enth\u00e4lt Positionen, HSN-\u00dcbersicht und Details.\n\nGrenzen: keine E-Rechnung (keine IRN, kein QR-Code) und kein E-Way-Bill; der GST-Satz eines Artikels wird nicht bestimmt; Cess, TCS und TDS werden nicht berechnet; bis 100 Positionen, nur INR. Keine Steuerberatung. Exportrechnungen (nullbesteuert unter LUT) werden nicht unterst\u00fctzt."
          },
          "es-ES": {
            "subtitle": "Factura GST para India",
            "description": "Crea una factura GST en el formato de factura fiscal de India como PDF listo para imprimir y archivo Excel. Indica el vendedor, el comprador y las l\u00edneas (descripci\u00f3n, c\u00f3digo HSN o SAC, cantidad, unidad, precio, descuento y tipo de GST) y Zovo GST Invoice Maker calcula el impuesto.\n\nEl lugar de suministro decide: CGST m\u00e1s SGST dentro de un mismo estado, CGST m\u00e1s UTGST en territorios de la uni\u00f3n e IGST en ventas entre estados. El c\u00f3digo de estado se lee de los 2 primeros d\u00edgitos del GSTIN, y cada GSTIN se comprueba en formato y car\u00e1cter de control; un GSTIN err\u00f3neo se se\u00f1ala, pero la factura se genera igualmente.\n\nEl PDF incluye los datos de ambas partes, n\u00famero y fecha, lugar de suministro, inversi\u00f3n del sujeto pasivo, la tabla de l\u00edneas, el resumen de impuestos por HSN/SAC, el redondeo a la rupia en una l\u00ednea aparte y el importe en letras en el sistema indio (lakh, crore). El Excel incluye las l\u00edneas, el resumen HSN y los detalles.\n\nLimitaciones: no es una factura electr\u00f3nica (sin IRN ni c\u00f3digo QR) ni un e-way bill; no decide el tipo de GST de cada art\u00edculo; no calcula cess, TCS ni TDS; hasta 100 l\u00edneas, solo INR. No es asesoramiento fiscal. No admite facturas de exportaci\u00f3n (tipo cero con LUT)."
          },
          "fr-FR": {
            "subtitle": "Facture GST pour l'Inde",
            "description": "Cr\u00e9ez une facture GST au format de facture fiscale indienne, en PDF pr\u00eat \u00e0 imprimer et en fichier Excel. Indiquez le vendeur, l'acheteur et les lignes (description, code HSN ou SAC, quantit\u00e9, unit\u00e9, prix, remise et taux de GST), et Zovo GST Invoice Maker calcule la taxe.\n\nLe lieu de fourniture d\u00e9cide : CGST plus SGST dans un m\u00eame \u00c9tat, CGST plus UTGST dans les territoires de l'Union, IGST pour une vente entre \u00c9tats. Le code d'\u00c9tat est lu dans les 2 premiers chiffres du GSTIN, et chaque GSTIN est v\u00e9rifi\u00e9 (format et caract\u00e8re de contr\u00f4le) ; un GSTIN erron\u00e9 est signal\u00e9, mais la facture est tout de m\u00eame produite.\n\nLe PDF contient les coordonn\u00e9es des deux parties, le num\u00e9ro et la date, le lieu de fourniture, l'autoliquidation, le tableau des lignes, le r\u00e9capitulatif des taxes par HSN/SAC, l'arrondi \u00e0 la roupie sur une ligne distincte et le montant en lettres selon le syst\u00e8me indien (lakh, crore). Le fichier Excel reprend les lignes, le r\u00e9capitulatif HSN et les d\u00e9tails.\n\nLimites : ce n'est pas une facture \u00e9lectronique (pas d'IRN ni de QR code) ni un e-way bill ; l'outil ne choisit pas le taux de GST d'un article ; il ne calcule ni cess, ni TCS, ni TDS ; jusqu'\u00e0 100 lignes, en INR uniquement. Ce n'est pas un conseil fiscal. Les factures d'exportation (taux z\u00e9ro sous LUT) ne sont pas prises en charge."
          },
          "ja-JP": {
            "subtitle": "\u30a4\u30f3\u30c9\u306eGST\u8acb\u6c42\u66f8\u3092\u4f5c\u6210",
            "description": "\u30a4\u30f3\u30c9\u306eGST\u8acb\u6c42\u66f8\uff08\u30bf\u30c3\u30af\u30b9\u30a4\u30f3\u30dc\u30a4\u30b9\uff09\u3092\u3001\u5370\u5237\u7528PDF\u3068Excel\u30d5\u30a1\u30a4\u30eb\u3067\u4f5c\u6210\u3057\u307e\u3059\u3002\u58f2\u308a\u624b\u3001\u8cb7\u3044\u624b\u3001\u54c1\u76ee\uff08\u8aac\u660e\u3001HSN\u307e\u305f\u306fSAC\u30b3\u30fc\u30c9\u3001\u6570\u91cf\u3001\u5358\u4f4d\u3001\u5358\u4fa1\u3001\u5024\u5f15\u304d\u3001GST\u7a0e\u7387\uff09\u3092\u6307\u5b9a\u3059\u308b\u3068\u3001Zovo GST Invoice Maker \u304c\u7a0e\u984d\u3092\u8a08\u7b97\u3057\u307e\u3059\u3002\n\n\u4f9b\u7d66\u5730\u306b\u3088\u3063\u3066\u7a0e\u304c\u6c7a\u307e\u308a\u307e\u3059\u3002\u540c\u3058\u5dde\u5185\u306a\u3089CGST\u3068SGST\u3001\u9023\u90a6\u76f4\u8f44\u9818\u306a\u3089CGST\u3068UTGST\u3001\u5dde\u3092\u307e\u305f\u3050\u53d6\u5f15\u306a\u3089IGST\u3067\u3059\u3002\u5dde\u30b3\u30fc\u30c9\u306fGSTIN\u306e\u5148\u982d2\u6841\u304b\u3089\u8aad\u307f\u53d6\u308a\u3001\u5404GSTIN\u306e\u5f62\u5f0f\u3068\u30c1\u30a7\u30c3\u30af\u6587\u5b57\u3092\u691c\u8a3c\u3057\u307e\u3059\u3002\u8aa4\u3063\u305fGSTIN\u306f\u8b66\u544a\u3055\u308c\u307e\u3059\u304c\u3001\u8acb\u6c42\u66f8\u306f\u4f5c\u6210\u3055\u308c\u307e\u3059\u3002\n\nPDF\u306b\u306f\u53cc\u65b9\u306e\u60c5\u5831\u3001\u8acb\u6c42\u66f8\u756a\u53f7\u3068\u65e5\u4ed8\u3001\u4f9b\u7d66\u5730\u3001\u30ea\u30d0\u30fc\u30b9\u30c1\u30e3\u30fc\u30b8\u306e\u6709\u7121\u3001\u54c1\u76ee\u8868\u3001HSN/SAC\u5225\u306e\u7a0e\u984d\u96c6\u8a08\u8868\u30011\u30eb\u30d4\u30fc\u5358\u4f4d\u3078\u306e\u7aef\u6570\u8abf\u6574\uff08\u5225\u884c\uff09\u3001\u30a4\u30f3\u30c9\u5f0f\uff08\u30e9\u30fc\u30af\u3001\u30af\u30ed\u30fc\u30eb\uff09\u306e\u91d1\u984d\u306e\u6587\u5b57\u8868\u8a18\u304c\u5165\u308a\u307e\u3059\u3002Excel\u306b\u306f\u54c1\u76ee\u3001HSN\u96c6\u8a08\u3001\u8a73\u7d30\u304c\u5165\u308a\u307e\u3059\u3002\n\n\u5236\u9650\u4e8b\u9805\uff1a\u96fb\u5b50\u30a4\u30f3\u30dc\u30a4\u30b9\uff08IRN\u3084QR\u30b3\u30fc\u30c9\uff09\u3084e-way bill\u3067\u306f\u3042\u308a\u307e\u305b\u3093\u3002\u54c1\u76ee\u306eGST\u7a0e\u7387\u306f\u5224\u65ad\u3057\u307e\u305b\u3093\u3002cess\u3001TCS\u3001TDS\u306f\u8a08\u7b97\u3057\u307e\u305b\u3093\u30021\u8acb\u6c42\u66f8\u3042\u305f\u308a100\u54c1\u76ee\u307e\u3067\u3001INR\u306e\u307f\u3002\u7a0e\u52d9\u4e0a\u306e\u52a9\u8a00\u3067\u306f\u3042\u308a\u307e\u305b\u3093\u3002\u8f38\u51fa\u8acb\u6c42\u66f8\uff08LUT\u306b\u3088\u308b\u30bc\u30ed\u7a0e\u7387\uff09\u306b\u306f\u5bfe\u5fdc\u3057\u3066\u3044\u307e\u305b\u3093\u3002"
          },
          "pt-BR": {
            "subtitle": "Fatura GST da \u00cdndia",
            "description": "Crie uma fatura GST no formato de fatura fiscal da \u00cdndia, em PDF pronto para imprimir e arquivo Excel. Informe o vendedor, o comprador e os itens (descri\u00e7\u00e3o, c\u00f3digo HSN ou SAC, quantidade, unidade, pre\u00e7o, desconto e al\u00edquota de GST), e o Zovo GST Invoice Maker calcula o imposto.\n\nO local de fornecimento decide: CGST mais SGST dentro do mesmo estado, CGST mais UTGST em territ\u00f3rios da uni\u00e3o e IGST em vendas entre estados. O c\u00f3digo do estado vem dos 2 primeiros d\u00edgitos do GSTIN, e cada GSTIN \u00e9 verificado quanto ao formato e ao caractere de controle; um GSTIN errado \u00e9 sinalizado, mas a fatura \u00e9 gerada mesmo assim.\n\nO PDF traz os dados das duas partes, n\u00famero e data, local de fornecimento, reverse charge, a tabela de itens, o resumo de impostos por HSN/SAC, o arredondamento para a rupia em linha pr\u00f3pria e o valor por extenso no sistema indiano (lakh, crore). O Excel traz os itens, o resumo HSN e os detalhes.\n\nLimita\u00e7\u00f5es: n\u00e3o \u00e9 uma fatura eletr\u00f4nica (sem IRN nem QR code) nem e-way bill; n\u00e3o define a al\u00edquota de GST de um item; n\u00e3o calcula cess, TCS nem TDS; at\u00e9 100 itens, apenas INR. N\u00e3o \u00e9 consultoria tribut\u00e1ria. Faturas de exporta\u00e7\u00e3o (al\u00edquota zero com LUT) n\u00e3o s\u00e3o suportadas."
          }
        }
      }
    }
  },
  "apps": "./.app.json"
}