Read an e-invoice
read_invoiceExtract complete contents of an electronic invoice (Factur-X, ZUGFeRD, XRechnung, UBL, CII) as text: parties, items, VAT, totals, and EN 16931 validation.
Instructions
Extract the full contents of one electronic invoice file (Factur-X, ZUGFeRD, XRechnung, UBL or CII) as plain text: invoice number and dates, supplier and customer, every line, the VAT breakdown per rate, totals, IBAN, the EN 16931 consistency check, and whether the amounts on a Factur-X PDF's visible page match its embedded XML. Use it when the user wants to know what an invoice contains. If they only ask whether the invoice is correct, use check_invoice instead, which returns the verdict without the contents. Side effects: the file is uploaded over HTTPS to the Facturolia API, processed in memory and discarded; nothing is written locally. Requires FACTUROLIA_API_KEY; files over 10 MB are refused; requests are rate limited per key tier and a 429 error means wait and retry.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"path": "<path>"
},
"name": "read_invoice"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Absolute path on this machine to one invoice file. Must end in .pdf (a Factur-X or ZUGFeRD PDF with embedded XML) or .xml (UBL, CII or XRechnung). A plain PDF without embedded data returns an error explaining that it is not a structured invoice. |