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

# Consultar estado del cierre de periodo

`POST /tools/accounting_getPeriodClosingStatus`

## Request

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

Herramienta MCP: `accounting_getPeriodClosingStatus`.

Consulta el estado operativo del cierre de un periodo combinando el estado del periodo en Closing Periods con la ejecución más reciente del historial.

Ejemplo de llamada JSON-RPC:

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

`period` es el año en formato YYYY; si se omite, se usa el año actual del servidor MCP. `month` es un entero entre 1 y 12; si se omite, se consulta el cierre anual completo con fecha YYYY-12-31. Si hay una ejecución del historial en estado `in_process` o `error`, tiene prioridad para reportar procesos activos o fallidos; si no, se usa el estado `open` o `closed` del periodo contable.

Úsala para saber si el cierre de un periodo está completo, pendiente, en proceso o con error. Para saber solo si el periodo contable está `open` o `closed` usa `accounting_getAccountingPeriodStatus`, y para listar los motivos de bloqueo, `accounting_getPeriodClosingBlockingReasons`.

Solo lectura.

## Request body

- object
  - `period` integer: Año a consultar en formato YYYY. Si se omite, se usa el año actual.
  - `month` integer: Mes a consultar (1-12). Si se omite, consulta el cierre anual.

## Response `200`

Estado operativo del cierre del periodo consultado

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