Editar ingreso (datos no monetarios)
PUT /api/incomes/{income_id}
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Edita datos que no mueven dinero. Acepta PUT o PATCH; todos los campos son opcionales; cualquier otro campo se ignora.
Quién puede usarlo: cualquier usuario autenticado. Un administrador accede a todos los registros; un vendedor solo a los que registró él (o en los que figura como vendedor). Si el registro existe pero es de otro vendedor responde 403.
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
number |
string | No | Número (máx. 255, puede ser null). |
income_type_id |
integer | No | Tipo de ingreso existente. |
income_reason_id |
integer | No | Motivo de ingreso existente. |
customer |
string | No | Nombre de quien entrega el dinero (texto libre, máx. 255). |
items |
array | No | Solo la descripción de ítems existentes: [{id, description}]. |
Errores: 409 si el ingreso está anulado; 422; 404; 403.
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
income_id |
ruta | sí | 1 |
Cuerpo
Content-Type: application/json
{
"number": "2",
"income_type_id": 1,
"income_reason_id": 1,
"customer": "CARLOS RAMIREZ TORRES",
"items": [
{
"id": 11,
"description": "Aporte de capital noviembre"
}
]
}
Respuestas
200 — Editado
{
"success": true,
"data": {
"id": 8,
"external_id": "9b2d4e6f-1a3c-4b5d-8e7f-0a1b2c3d4e5f",
"number": "2",
"number_full": "ING-1",
"date_of_issue": "2026-11-07",
"time_of_issue": "11:20:00",
"state_type_id": "05",
"state_type_description": "Aceptado",
"currency_type_id": "PEN",
"exchange_rate_sale": 1.0,
"total": 120.0,
"user_id": 5,
"establishment_id": 1,
"income_type_id": 1,
"income_type_description": "Otros ingresos",
"income_reason_id": 1,
"income_reason_description": "Aporte de socio",
"customer": "CARLOS RAMIREZ TORRES",
"items": [
{
"id": 11,
"description": "Aporte de capital",
"total": 120.0
}
],
"payments": [
{
"id": 15,
"date_of_payment": "2026-11-07",
"payment_method_type_id": "01",
"payment_method_type_description": "Efectivo",
"destination_description": "CAJA - JUAN PEREZ",
"reference": null,
"payment": 120.0
}
]
},
"message": "Registro actualizado"
}
409 — Anulado
{
"success": false,
"message": "El registro está anulado y no se puede editar."
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.