get_invoice
Retrieve detailed invoice information from Siigo's electronic invoicing system by providing the invoice ID. Returns complete invoice data including items, taxes, and payment details for accurate financial management.
Instructions
Get an invoice by ID.
Args: invoice_id: The invoice's GUID
Returns the full invoice details including items, taxes, and payments.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| invoice_id | Yes |
Implementation Reference
- src/siigo_mcp/tools/invoices.py:42-52 (handler)The primary handler implementation for the 'get_invoice' tool. This async function is decorated with @mcp.tool, takes a Context and invoice_id parameter, and fetches the invoice details from the Siigo API endpoint '/invoices/{invoice_id}', returning a dict with the invoice data.@mcp.tool async def get_invoice(ctx: Context, invoice_id: str) -> dict[str, Any]: """Get an invoice by ID. Args: invoice_id: The invoice's GUID Returns the full invoice details including items, taxes, and payments. """ return await get_client(ctx).get(f"/invoices/{invoice_id}")
- src/siigo_mcp/tools/discovery.py:93-93 (registration)Dynamic registration of the 'get_invoice' tool in the lazy-loading tool functions map, mapping it to invoices.get_invoice for use in meta-tools like call_siigo_tool."get_invoice": invoices.get_invoice,
- Tool discovery schema entry in TOOL_INDEX, defining the name 'get_invoice', category 'invoices', and summary description for tool listing.{"name": "get_invoice", "category": "invoices", "summary": "Get an invoice by ID"},