---
title: "Consultar bloqueos del cierre de periodo"
method: POST
path: "/tools/accounting_getPeriodClosingBlockingReasons"
tags: ["Accounting"]
---

# Consultar bloqueos del cierre de periodo

`POST /tools/accounting_getPeriodClosingBlockingReasons`

## Request

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

Herramienta MCP: `accounting_getPeriodClosingBlockingReasons`.

Identifica bloqueos o señales de bloqueo del cierre de periodo a partir del historial de ejecuciones en estado `in_process` y `error`.

Ejemplo de llamada JSON-RPC:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accounting_getPeriodClosingBlockingReasons",
    "arguments": { "period": 2026, "month": 9 }
  }
}
```

`period` y `month` son opcionales; si se envían, filtran los historiales devueltos por periodo. Con `statuses` puedes revisar otros estados documentados del historial; por defecto se consultan `in_process` y `error`, que son las señales de bloqueo. Las razones se derivan del historial: si el backend no incluye un mensaje, la herramienta genera una explicación a partir del `status` y el `currentStep`.

Úsala cuando el usuario pregunte qué bloquea el cierre de un periodo o cuando necesites explicar una ejecución fallida o detenida del pipeline de cierre. Para el estado resumido del cierre usa `accounting_getPeriodClosingStatus`.

Solo lectura.

## Request body

- object
  - `period` integer: Año opcional para filtrar historiales por periodo.
  - `month` integer: Mes opcional para filtrar historiales por periodo.
  - `statuses` string[]: Estados de historial a consultar. Por defecto: in_process y error.

## Response `200`

Motivos de bloqueo del cierre de periodo

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