---
title: "Obtener plantilla de numeración"
method: POST
path: "/tools/accounting_getNumberTemplate"
tags: ["Accounting"]
---

# Obtener plantilla de numeración

`POST /tools/accounting_getNumberTemplate`

## Request

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

Herramienta MCP: `accounting_getNumberTemplate`.

Obtiene el detalle de una numeración contable específica por su `id`: prefijo, consecutivo actual, numeración preferida y tipo de comprobante asociado del módulo de contabilidad.

Ejemplo de llamada JSON-RPC:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accounting_getNumberTemplate",
    "arguments": { "id": "01J9Z3B7C2D5F8H1K4M6P9RVXT2", "fields": ["documentType"], "format": "combo" }
  }
}
```

El `id` es obligatorio (ULID de la numeración, no el prefijo ni el consecutivo). Con `fields` amplías la respuesta 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. `preferred` indica si es la numeración por defecto del tipo. Con `format: combo` el `name` se devuelve como "Nombre (Prefijo)".

Si no conoces el `id`, primero llama `accounting_listNumberTemplates` con `prefix_contains` (por ejemplo "AC") o con `idDocumentType`.

Solo lectura.

## Request body

- object
  - `id` string, required: Id de la numeración a consultar.
  - `fields` union: Campos extra: documentType, deletable, editable, associated, initializable.
    - 'documentType' | 'deletable' | 'editable' | 'associated' | 'initializable': Campo extra a incluir.
    - string[]: Campos extra a incluir, como arreglo.
  - `format` 'combo': Si es combo, el name se devuelve como "Name (Prefix)".

## Response `200`

Detalle de la numeración contable

## 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)