Ir al contenido

Actualizar un movimiento

PUT/api/cashbox-movement/{cashboxMovement}

Edita un movimiento. El monto (subtotal_amount, commission_amount, total_amount) nunca se puede cambiar: si envías un valor distinto al guardado, responde 422 con el mensaje El monto del movimiento no puede ser editado. Monto debe de ser: 150.5. Tampoco se puede editar si el movimiento está vinculado a una orden de pago, si su caja está cerrada o anulada, ni si es una transferencia (para esas usa la edición de transferencia).

cashboxMovementintegerobligatorio

Identificador del movimiento.

third_party_typestringobligatorio

Tipo de tercero: proveedor, cliente u otro.

conceptstringobligatorio

Concepto del movimiento.

cashbox_income_segment_idintegercondicional

Obligatorio si el movimiento es un ingreso. Debe existir un segmento con ese identificador.

provider_idintegercondicional

Obligatorio si third_party_type es proveedor.

customer_idintegercondicional

Obligatorio si third_party_type es cliente.

payment_datedatetime

Fecha de pago. Con la misma fecha del día el movimiento conserva su hora; si cambia el día, entra al final del nuevo día. No puede ser anterior a la fecha de pago del último movimiento conciliado de la cuenta.

cost_center_idinteger

Centro de costo. Solo se usa en egresos. Se puede asignar o cambiar, pero no quitar si ya tiene uno.

accounting_account_idinteger

Cuenta contable.

accounting_account_movementsarray

Reparto entre cuentas contables. Cada elemento lleva accounting_account_id, amount y percentage. Si se envía, reemplaza el reparto anterior.

project_idinteger

Proyecto asociado.

opcodestring

Código de operación.

responsiblestring

Responsable del movimiento.

beneficiary_accountstring

Cuenta del beneficiario.

origin_bank_idinteger

Banco de origen. Se ignora si el movimiento no es un ingreso.

destination_bank_idinteger

Banco de destino. Se ignora si el movimiento es un ingreso.

provider_account_idinteger

Cuenta del proveedor.

customer_account_idinteger

Cuenta del cliente.

voucher_typestring

Tipo de comprobante.

invoice_numberstring

Número del comprobante.

observationstring

Observación.

cashbox.movement.edit, validado en CashboxMovementPolicy::update. Además solo puede editar quien creó el movimiento (create_user_id), y el movimiento no debe estar anulado, conciliado ni ser una transferencia; cada causa devuelve su propio mensaje en español. Ver Permisos y políticas.

Ventana de terminal
curl -X PUT \
"https://servererp.allendostmen.app/api/cashbox-movement/1520" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"third_party_type": "proveedor",
"provider_id": 12,
"concept": "Pago de servicio de agua",
"observation": "Corrección de concepto"
}'
Movimiento actualizado200
{
"id": 1520,
"type": "egreso",
"account_id": 1,
"payment_method_id": 2,
"payment_date": "2026-11-19T10:30:00.000000Z",
"subtotal_amount": 150.5,
"total_amount": 150.5,
"concept": "Pago de servicio de agua",
"third_party_type": "proveedor",
"provider_id": 12,
"status": "activo",
"create_user_id": 1,
"observation": "Corrección de concepto",
"update_user_id": 1
}
Sin permiso403
{
"message": "Solo puede editar este movimiento quien lo haya creado."
}
Datos no válidos422
{
"message": "El monto del movimiento no puede ser editado. Monto debe de ser: 150.5",
"errors": {
"subtotal_amount": [
"El monto del movimiento no puede ser editado. Monto debe de ser: 150.5"
]
}
}