---
title: "Listar plantillas de numeración"
method: POST
path: "/tools/accounting_listNumberTemplates"
tags: ["Accounting"]
---

# Listar plantillas de numeración

`POST /tools/accounting_listNumberTemplates`

## Request

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

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:

```json
{
  "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.

## Request body

- object
  - `idDocumentType` string: Filtra por id del tipo de documento (alias de idDocumentType_equals).
  - `idDocumentType_equals` string: Filtra por id exacto del tipo de documento asociado.
  - `status_equals` 'active' | 'inactive' | 'deleted': Filtra por estado de la numeración.
  - `preferred_equals` boolean: Filtra por numeración preferida (true/false).
  - `name_contains` string: Filtra por nombre (contiene).
  - `prefix_contains` string: Filtra por prefijo (contiene).
  - `type` string: Filtra por type del tipo de documento, por ejemplo REVENUE o CREDIT_NOTE. Valores pendientes de verificar con una llamada real.
  - `exclude` union: Excluye tipos de documento (type): separados por coma o como arreglo.
    - string: Tipos de documento (type) a excluir, separados por coma.
    - string[]: Tipos de documento (type) a excluir, como arreglo.
  - `limit` integer: Cantidad de resultados por página. Por defecto 10, máximo 150.
  - `page` integer: 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.
  - `fields` union: Campos extra por ítem: documentType, deletable, editable, associated, initializable.
    - 'documentType' | 'deletable' | 'editable' | 'associated' | 'initializable': Campo extra a incluir en cada ítem.
    - string[]: Campos extra a incluir en cada ítem, como arreglo.
  - `format` 'combo': Si es combo, el name se devuelve como "Name (Prefix)".

## Response `200`

Lista de numeraciones contables con metadatos de paginación

## Other responses

- `401`: No autorizado (token de Alegra inválido o expirado).

---

[API](https://skmtc.dev/alegra/apis/mcp-alegra.md) - [All operations](https://skmtc.dev/alegra/apis/mcp-alegra/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/mcp-alegra/revisions/528447af020b?raw)