v1
latestOpenAPI 3.0.32026-07-24398641.3 MBGastos
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).
post/tools/debit-notes__create_debit_note
Request body
object required
Body POST según create_minimum, request_body_shape y line_models en la fuente.
Response
Nota creada (201) o error con payload parcial