Accounting

Listar plantillas de numeración

Herramienta MCP: accounting_listNumberTemplates.

Lista las numeraciones contables de la compañía (prefijos, consecutivos y numeración preferida de los comprobantes del módulo de contabilidad). No confundir con las numeraciones de facturación, inventario u otros módulos.

Ejemplo de llamada JSON-RPC:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accounting_listNumberTemplates",
    "arguments": { "idDocumentType": "01J9Y2T1W4R7P2N5K8M3Q6XZC9", "fields": ["documentType"] }
  }
}

Paginación por page y limit: page comienza en 1 y limit admite de 1 a 150 resultados (10 por defecto); si el usuario pide el listado completo, usa 150 y revisa metadata.total para paginar con page si hace falta. Orden con order_field (name, prefix, idDocumentType, status, created_at o updated_at, name por defecto) y order_direction (ASC o DESC, ascendente por defecto).

Filtros: idDocumentType (alias de idDocumentType_equals) y idDocumentType_equals con el id del tipo de documento, que obtienes con accounting_listDocumentTypes o accounting_getDocumentType; status_equals con active, inactive o deleted; preferred_equals con true o false para filtrar las numeraciones preferidas; name_contains y prefix_contains por búsqueda parcial; type por el código interno del tipo de documento (por ejemplo ACCOUNTING_ADJUSTMENT; valores pendientes de verificar con una llamada real); y exclude para excluir tipos de documento, separados por coma o como arreglo.

Con fields amplías cada ítem con documentType, deletable, editable, associated o initializable, como valor único o como arreglo; el metadata del tipo asociado es un string JSON serializado, transfórmalo con JSON.parse antes de leerlo. Con format: combo el name se devuelve como "Nombre (Prefijo)".

Flujo recomendado: accounting_listDocumentTypes → esta herramienta filtrada por idDocumentType → accounting_getNumberTemplate para el detalle de una numeración.

Solo lectura.

post/tools/accounting_listNumberTemplates

Request

  • Base URL
    https://mcp.alegra.com
  • URL
    https://mcp.alegra.com/tools/accounting_listNumberTemplates
  • Auth
    HTTP bearer

Request body

idDocumentTypestring

Filtra por id del tipo de documento (alias de idDocumentType_equals).

idDocumentType_equalsstring

Filtra por id exacto del tipo de documento asociado.

status_equals'active' | 'inactive' | 'deleted'

Filtra por estado de la numeración.

preferred_equalsboolean

Filtra por numeración preferida (true/false).

name_containsstring

Filtra por nombre (contiene).

prefix_containsstring

Filtra por prefijo (contiene).

typestring

Filtra por type del tipo de documento, por ejemplo REVENUE o CREDIT_NOTE. Valores pendientes de verificar con una llamada real.

limitinteger

Cantidad de resultados por página. Por defecto 10, máximo 150.

pageinteger

Número de página. Por defecto 1.

order_field'name' | 'prefix' | 'idDocumentType' | 'status' | 'created_at' | 'updated_at'

Campo de ordenamiento. Por defecto name.

order_direction'ASC' | 'DESC'

Dirección de ordenamiento. Por defecto ASC.

format'combo'

Si es combo, el name se devuelve como "Name (Prefix)".

Response

Lista de numeraciones contables con metadatos de paginación

Changes

No recorded changes to this operation across all 1 revision of this API.