Ir al contenido

Transferir entre cajas de cliente

POST/api/customer-cashbox/transfer

Transfiere saldo de una caja de cliente a otra del mismo cliente. Todo ocurre en una transacción: crea un egreso y un ingreso en la caja de la empresa, y un movimiento de caja de cliente por cada lado. El ingreso queda enlazado al egreso con transfer_customer_cashbox_movement_id. El observador del movimiento resta el monto a la caja de origen y lo suma a la de destino. La respuesta es el movimiento de egreso.

from_customer_cashbox_idintegerobligatorio

Caja de cliente de origen.

to_customer_cashbox_idintegerobligatorio

Caja de cliente de destino. Debe ser distinta de la de origen y del mismo cliente.

cashbox_movementobjectobligatorio

Datos del movimiento de la caja de la empresa.

cashbox_movement.origin_account_idintegerobligatorio

Cuenta de la empresa de la que sale el dinero.

cashbox_movement.destination_account_idintegerobligatorio

Cuenta de la empresa a la que entra el dinero. Debe pertenecer a una caja.

cashbox_movement.payment_datedateobligatorio

Fecha del pago.

cashbox_movement.amountnumberobligatorio

Monto a transferir. Mínimo 0.01.

cashbox_movement.payment_method_idintegerobligatorio

Método de pago.

cashbox_movement.operation_codestring

Código de operación.

cashbox_movement.voucher_typestring

Tipo de comprobante.

cashbox_movement.invoice_numberstring

Número del comprobante.

cashbox_movement.voucher_filestring

Archivo del comprobante.

cashbox_movement.conceptstring

Concepto del movimiento.

La ruta no valida un permiso de caja de cliente, pero al crear los movimientos de la caja de la empresa se valida cashbox.movement.create en CashboxMovementPolicy::create. Ver Permisos y políticas.

Ventana de terminal
curl -X POST \
"https://servererp.allendostmen.app/api/customer-cashbox/transfer" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"from_customer_cashbox_id": 4,
"to_customer_cashbox_id": 5,
"cashbox_movement": {
"origin_account_id": 7,
"destination_account_id": 9,
"payment_date": "2026-11-19",
"amount": 300,
"payment_method_id": 2,
"concept": "TRANSFERENCIA ENTRE CAJAS"
}
}'
Movimiento de egreso creado201
{
"id": 31,
"customer_id": 12,
"customer_cashbox_id": 4,
"to_customer_cashbox_id": 5,
"from_customer_cashbox_id": null,
"transfer_customer_cashbox_movement_id": null,
"cashbox_movement_id": 880,
"type": "egreso",
"concept": "TRANSFERENCIA ENTRE CAJAS",
"amount": 300.0,
"untouchable": false,
"status": "activo",
"create_user_id": 1,
"created_at": "2026-11-19T10:40:15.000000Z",
"updated_at": "2026-11-19T10:40:15.000000Z"
}
Cajas de distintos clientes400
{
"message": "No se puede transferir entre cajas de diferentes clientes"
}
Misma caja400
{
"message": "No se puede transferir a la misma caja"
}
Saldo insuficiente en la caja400
{
"message": "No se puede transferir más de lo que hay en la caja"
}
Saldo insuficiente en la cuenta422
{
"message": "El monto a egresar es mayor al saldo de la cuenta",
"errors": {
"amount": [
"El monto a egresar es mayor al saldo de la cuenta"
]
}
}
Sin permiso403
{
"message": "This action is unauthorized."
}