get_document_types
Retrieve configured document types from Siigo's electronic invoicing system. Filter by specific types like invoices (FV), credit notes (NC), or cash receipts (RC) to identify available document categories.
Instructions
Get all configured document types.
Args: document_type: Optional filter by type (FV=invoice, NC=credit note, etc.)
Returns a list of document types configured in the account. Common types: FV (factura), NC (nota crédito), RC (recibo de caja).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| document_type | No |
Implementation Reference
- src/siigo_mcp/tools/reference.py:30-46 (handler)The core handler function for the 'get_document_types' tool. It fetches document types from the Siigo API endpoint '/document-types', optionally filtering by document_type parameter.@mcp.tool async def get_document_types( ctx: Context, document_type: str | None = None, ) -> list[dict[str, Any]]: """Get all configured document types. Args: document_type: Optional filter by type (FV=invoice, NC=credit note, etc.) Returns a list of document types configured in the account. Common types: FV (factura), NC (nota crédito), RC (recibo de caja). """ params: dict[str, Any] = {} if document_type: params["type"] = document_type return await get_client(ctx).get("/document-types", params=params or None)
- src/siigo_mcp/tools/discovery.py:72-78 (registration)Registers the get_document_types tool function (along with other reference tools) in the _tool_functions dictionary used for dynamic/lazy tool execution.# Reference "get_taxes": reference.get_taxes, "get_payment_types": reference.get_payment_types, "get_document_types": reference.get_document_types, "get_warehouses": reference.get_warehouses, "get_users": reference.get_users, "get_account_groups": reference.get_account_groups,
- Metadata entry in TOOL_INDEX providing the tool's name, category, and summary for discovery via list_siigo_tools.{"name": "get_document_types", "category": "reference", "summary": "Get all document types (FV, NC, etc.)"},