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

# debit-notes__create_debit_note

`POST /tools/debit-notes__create_debit_note`

### MCP
`create_debit_note` → `debit-notes__create_debit_note`.

### HTTP
`POST /v1/debit-notes`

### Obligatorio
- `client: { id }` (proveedor), `date`
- Al menos una línea: `items`, `categories`, `purchases.items` o `purchases.categories`

### Opcional
`bills: [{ id, amount }]`, `refunds`, `retentions`, `stamp`, `warehouse`, `currency`, `costCenter`,
`resolution`, metadatos (adjustmentNoteType, annotation, reason, typeCreditNote CR), etc.

### No enviar
id, status, total, balance, calculationScale, emissionStatus, payments.

### Errores (selección)
| Código | Significado | Acción |
|--------|-------------|--------|
| 13011 | Cliente/proveedor no encontrado | Corregir `client.id` |
| 13043 | Sin líneas | Agregar items/categories/purchases |
| 13066 | Timbre sin resolución electrónica (CO/CR cuando aplica) | Asignar resolución electrónica |
| 13007 | Multimoneda no habilitada | Habilitar multimoneda en cuenta |
| 900 | Límite plan | Plan o cupo |
| 907 | Solo lectura | Plan no permite escritura |
| 3051 | Fallo timbre en alta — puede ir `debitNote` parcial | No re-POST ciego; `update_debit_note` con id |
| 905 / 902 | JSON vacío o mal formado | Cuerpo JSON válido y no vacío |

Códigos de líneas: 13043–13054, 13104, etc. Ver `line_models.validation_codes_common` en la fuente.

### Actualización tras 3051
Persistir `debitNote.id` y usar `update_debit_note` (ver `error_3051_stamp_failure` en la guía).

## Request body

- object — Body POST según create_minimum, request_body_shape y line_models en la fuente.

## Response `200`

Nota creada (201) o error con payload parcial

---

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