mcp-server-acube 0.3.0 → 0.3.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +15 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -93,7 +93,7 @@ The server is configured through environment variables:
|
|
|
93
93
|
|---|---|
|
|
94
94
|
| `send_invoice` | Send a FatturaPA electronic invoice to SDI. Accepts the complete FatturaPA JSON object. Returns the UUID assigned by SDI (HTTP 202). Supports optional digital signing. |
|
|
95
95
|
| `send_simplified_invoice` | Send a simplified FatturaPA invoice (fattura semplificata) for amounts up to 400 EUR. |
|
|
96
|
-
| `list_invoices` | List and filter invoices with 20+ filters (sender/recipient name, VAT, status, date ranges, etc.). Returns a **compact default view** -- see [Response Optimization](#response-optimization). |
|
|
96
|
+
| `list_invoices` | List and filter invoices with 20+ filters (sender/recipient name, VAT, status, date ranges, invoice series, etc.). Returns a **compact default view** -- see [Response Optimization](#response-optimization). |
|
|
97
97
|
| `get_invoice` | Retrieve a specific invoice by UUID. Output formats: JSON, XML (FatturaPA), PDF (base64), or HTML. Supports field selection. |
|
|
98
98
|
|
|
99
99
|
### Invoice Extraction (3 tools)
|
|
@@ -204,6 +204,20 @@ The `list_invoices` tool returns a **compact default view** (10 items per page)
|
|
|
204
204
|
|
|
205
205
|
The `invoice_number`, `invoice_date`, `total_amount`, and `currency` fields are **computed** by parsing the FatturaPA payload JSON on the server side, so they're available without transferring the entire payload.
|
|
206
206
|
|
|
207
|
+
### Filtering by invoice series
|
|
208
|
+
|
|
209
|
+
Italian invoice numbers often include a series suffix (e.g. `1/Servizi`, `2026/100/CI`, `3/cipay`). The API's `invoice_number` filter does a partial match, which can return unrelated series. The `invoice_series` parameter solves this by post-filtering results to match only invoices whose number ends with the exact series suffix:
|
|
210
|
+
|
|
211
|
+
```
|
|
212
|
+
# Only returns "1/Servizi", "2/Servizi", etc. -- not "2026/100/CI"
|
|
213
|
+
list_invoices(sender_vat: "01234567890", invoice_series: "Servizi")
|
|
214
|
+
|
|
215
|
+
# Only returns invoices in the /CI series
|
|
216
|
+
list_invoices(sender_vat: "01234567890", invoice_series: "CI")
|
|
217
|
+
```
|
|
218
|
+
|
|
219
|
+
The match is exact on the part after the last `/` in the invoice number.
|
|
220
|
+
|
|
207
221
|
### Using the `fields` parameter
|
|
208
222
|
|
|
209
223
|
Both `list_invoices` and `get_invoice` accept an optional `fields` parameter to control which fields are returned:
|
package/package.json
CHANGED