Update to e-invoices.it

{
  "description": "Read the files of Italian electronic invoicing that the user attached (FatturaPA invoices as .xml, signed .xml.p7m or a zip, and receipts of the Sistema di Interscambio SdI such as a notifica di scarto, an _NS_ file) with the read_e_invoice_files tool of e-invoices.it. Explain an invoice - parties, amounts, VAT, due dates, payment details, withholding tax - or why the SdI rejected an invoice the user sent and how to correct it, or sum up several invoices (a download massivo) - revenue, costs, VAT, top customers and suppliers, imposta di bollo, ritenute and anomalies to check for the accountant. Use it whenever the user attaches such a file, asks about an attached Italian e-invoice, or says their e-invoice was rejected (\"scartata\").",
  "included_files": [],
  "name": "read-italian-e-invoice",
  "skill_md_contents": "---\nname: read-italian-e-invoice\ndescription: Read the files of Italian electronic invoicing that the user attached (FatturaPA invoices as .xml, signed .xml.p7m or a zip, and receipts of the Sistema di Interscambio SdI such as a notifica di scarto, an _NS_ file) with the read_e_invoice_files tool of e-invoices.it. Explain an invoice - parties, amounts, VAT, due dates, payment details, withholding tax - or why the SdI rejected an invoice the user sent and how to correct it, or sum up several invoices (a download massivo) - revenue, costs, VAT, top customers and suppliers, imposta di bollo, ritenute and anomalies to check for the accountant. Use it whenever the user attaches such a file, asks about an attached Italian e-invoice, or says their e-invoice was rejected (\"scartata\").\n---\n\n# Read Italian e-invoice files\n\nThe `read_e_invoice_files` tool of e-invoices.it reads the files of Italian\nelectronic invoicing (FatturaPA, the XML exchanged through the Sistema di\nInterscambio, SdI). What it returns depends on the files:\n\n- **one invoice**: its data, and the invoice is shown as a readable document next to\n  the answer;\n- **a notifica di scarto** (the SdI rejected an invoice the user sent: an XML file\n  with `_NS_` in its name and one or more five-digit error codes, e.g. `00404`),\n  with the rejected invoice if attached: each error explained, with the current\n  values of the fields it concerns;\n- **another SdI receipt** (delivery receipt, mancata consegna, esito, decorrenza\n  termini): what it means;\n- **several invoices** (more files, a zip or a download massivo from Fatture e\n  Corrispettivi): aggregates for the business and its accountant, not the single\n  invoices.\n\n## When to use it\n\n- The user attached a `.xml`, `.xml.p7m` or `.zip` file that is, or may be, an\n  Italian e-invoice or an SdI receipt. Pass **all** attached files in one call: a\n  notifica di scarto together with its invoice gives the best answer.\n- Call `read_e_invoice_files` with the attached files. Do not ask the user to paste\n  the XML as text, and do not try to read the file yourself first.\n- The user says an invoice was rejected but attached only the invoice: read it, and\n  ask for the `_NS_` file they received (by PEC, from their invoicing software or\n  from the Fatture e Corrispettivi portal) to explain the rejection.\n- Do not call it without an attached file, or to create, check in advance, change\n  or send an invoice: it only reads.\n\n## How to answer about an invoice\n\n1. Answer only from the tool result (`structuredContent`). Never invent or estimate a\n   value; if a field is missing, say that the invoice does not contain it.\n2. Unless the user asks something specific, give a short summary:\n   - document type, number and date\n   - supplier and customer, with their VAT numbers\n   - total amount and currency; the net amount to pay if there is withholding tax\n   - due dates, payment method and IBAN\n   - names of the attachments, if any\n3. The invoice is shown in full next to your answer: do not repeat every line item\n   unless the user asks for them.\n4. Codes: the result has a description next to each code (document type `TD..`, VAT\n   nature `N..`, VAT due `I`/`D`/`S`, payment method `MP..`). Use the descriptions and\n   explain them briefly when they matter, e.g. `S` is split payment.\n5. Amounts with two decimals and their currency; dates in the user's usual format.\n\n## How to answer about a rejection (notifica di scarto)\n\n1. Answer only from the tool result (`structuredContent`). For each error in\n   `Errori`:\n   - the code and, in one sentence, what is wrong (`Spiegazione`; else the SdI's\n     `Descrizione`);\n   - where: the field (`Campi`) and, if the invoice was attached, the value it has\n     now (`ValoriNellaFattura`);\n   - the correction: start from `Correzione` and the SdI's `Suggerimento`, and make\n     it concrete with the values, e.g. \"line 3: 8 × 18.40 = 147.20, not 147.00\".\n2. The SdI's `Descrizione` often names the exact field, line or value: use it.\n3. Keep the correction a **proposal**. Say what to change and in which field; the\n   user changes it in their invoicing software. Do not write a corrected XML file\n   unless the user asks for it, and if you do, say that their software has to\n   produce and sign the file it sends.\n4. When you cannot tell the right value (a VAT number, the recipient code, the\n   correct VAT nature), say what to check and with whom (the customer, their\n   accountant), and do not guess.\n5. End with what to do now (`DopoLoScarto`): the rejected invoice counts as not\n   issued and is sent again, corrected.\n6. `NotaFattura`: if present, mention it. The attached invoice may not be the one\n   that was rejected.\n\n## How to answer about several invoices\n\n1. Answer only from the tool result (`structuredContent`): aggregates, not the single\n   invoices. `company` is the business the invoices are about (the party of most of\n   them); if `tied_with` is set, another party has as many, so say which one was\n   taken and ask if it is the right one.\n2. Unless the user asks something specific, give a short overview:\n   - the company and the period;\n   - issued (`sales`) and received (`purchases`) invoices: number, taxable amount,\n     VAT, total; the largest customers and suppliers;\n   - the VAT position (`vat_position`) and, if useful, the trend by period\n     (`by_period`) and the expected cash flow from the due dates (`cash_flow`);\n   - what an accountant (commercialista) looks at, when present: imposta di bollo per\n     quarter with its F24 code (`bollo`, and `to_check`: invoices without bollo that\n     may need it), ritenute d'acconto operated and suffered per month and supplier\n     (`ritenute`), and the anomalies to check (`controlli`, each with the invoices\n     concerned).\n3. `remarks` point out what stands out (a customer or supplier with a large share,\n   a weak period, a possible cash shortfall): mention them.\n4. Everything is an aid to be checked, not a tax return or a verification of the\n   invoices: say so when the user may act on it.\n5. For one Excel file, readable PDFs or the full dashboard of the same invoices,\n   point to https://e-invoices.it.\n\n## In every answer\n\n- Answer in the user's language. Keep the Italian terms and field names the user\n  sees on the invoice or in their software (imponibile, ritenuta d'acconto, imposta\n  di bollo, PrezzoTotale) and translate them once.\n\n## When the tool cannot read the files\n\n- **Too many invoices**, or **the analyses of several invoices are used up** for\n  now: the chat has a limit of invoices per call and of analyses per user. Relay the\n  note: e-invoices.it handles many invoices at once (one Excel file, PDFs, a\n  dashboard) at https://e-invoices.it; or offer to look at fewer invoices here.\n- **Several notifiche di scarto**: the tool explains one at a time; ask which one.\n- **Another SdI receipt**: relay what the tool says. These are not rejections.\n- **Not an e-invoice** or an unreadable file: say so, and suggest the XML or\n  `.xml.p7m` from the Agenzia delle Entrate portal (Fatture e Corrispettivi) or from\n  the supplier. A PDF is only a copy of the invoice and cannot be read by the tool.\n- **The service is busy**: say so and suggest trying again in a minute.\n\n## Limits\n\n- This is no tax or legal advice, and e-invoices.it does not check invoices before\n  they are sent: a corrected invoice may still be rejected for another reason. For\n  decisions and doubts about VAT, refer the user to their accountant\n  (commercialista).\n- The legally valid invoice is the XML file; a PDF attached to it is only a copy.\n- e-invoices.it processes the files only in memory: it does not store them and\n  does not log anything about them. Say only this about e-invoices.it, and make no\n  statement about how ChatGPT or OpenAI handle the user's data.\n"
}