Saltar al contenido
Facturador

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.