---
title: "bills__close_bill"
method: POST
path: "/tools/bills__close_bill"
tags: ["Gastos"]
---

# bills__close_bill

`POST /tools/bills__close_bill`

### MCP
`close_bill` → `bills__close_bill`.

### HTTP
`POST /v1/bills/{id}/close`

### Body obligatorio
- `date` (yyyy-MM-dd): fecha de cierre.
- `category`: id de categoría de **ingreso** (string, number u objeto `{ id }`).

### Body opcional
- `observations` (máx. 500 caracteres).
- `journal.numberTemplate.id` si la empresa usa tipos y numeraciones para el asiento de cierre.

### Errores
| Código | Significado | Acción |
|--------|-------------|--------|
| 11200 | Formulario de cierre vacío o incompleto | Enviar campos requeridos de cierre |
| 11201 | Fecha de cierre obligatoria | Incluir `date` válida |
| 11203 | Categoría de ingreso obligatoria | Incluir `category` válida |
| 11208 | Factura no cerrable en este estado | Verificar saldo y estado |
| 11110 | Bill no encontrado | Verificar id |
| 905 | JSON inválido | Corregir cuerpo de la petición |

## Request body

- object
  - `id` string, required
  - `date` string, date, required
  - `category` union, required
    - string
    - number
    - object
      - `id` string, required
  - `observations` string
  - `journal` object
    - `numberTemplate` object
      - `id` string

## Response `200`

Payload de éxito con code/message

---

[API](https://skmtc.net/alegra/apis/ingresos.md) · [All operations](https://skmtc.net/alegra/apis/ingresos/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alegra/ingresos/versions/cd52d3f68f1b/schema)