Ir al contenido

Crear un movimiento de caja de cliente

POST/api/customer-cashbox-movement

Registra un ingreso en una caja de cliente. En una transacción crea un movimiento de ingreso en la caja de la empresa (estado activo, con la apertura vigente de la caja de la cuenta) y un movimiento de caja de cliente de tipo ingreso con el mismo monto. El concepto del movimiento sale de cashbox_movement.observation. El observador suma el monto al saldo disponible de la caja de cliente. La respuesta incluye el movimiento de la empresa en boxMovement.

customer_idintegerobligatorio

Cliente dueño de la caja.

customer_cashbox_idintegerobligatorio

Caja de cliente que recibe el ingreso. Debe pertenecer al cliente indicado.

cashbox_movementobjectobligatorio

Datos del movimiento de la caja de la empresa.

cashbox_movement.account_idintegerobligatorio

Cuenta de la empresa que recibe el dinero. Debe pertenecer a una caja con apertura en estado abierto.

cashbox_movement.accounting_account_idintegerobligatorio

Cuenta contable.

cashbox_movement.payment_datedateobligatorio

Fecha del pago.

cashbox_movement.amountnumberobligatorio

Monto del ingreso.

cashbox_movement.payment_method_idintegerobligatorio

Método de pago.

cashbox_movement.observationstring

Observación. Se usa como concepto del movimiento; envíala siempre.

cashbox_movement.bank_idinteger

Banco.

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.create, que se valida en CashboxMovementPolicy::create al crear el movimiento de la caja de la empresa; CustomerCashboxMovementPolicy::create devuelve verdadero. Ver Permisos y políticas.

Ventana de terminal
curl -X POST \
"https://servererp.allendostmen.app/api/customer-cashbox-movement" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"customer_id": 12,
"customer_cashbox_id": 4,
"cashbox_movement": {
"account_id": 7,
"accounting_account_id": 3,
"payment_date": "2026-11-19",
"amount": 1500,
"payment_method_id": 2,
"observation": "PAGO DEL CLIENTE"
}
}'
Movimiento creado201
{
"id": 30,
"customer_id": 12,
"customer_cashbox_id": 4,
"to_customer_cashbox_id": null,
"from_customer_cashbox_id": null,
"transfer_customer_cashbox_movement_id": null,
"cashbox_movement_id": 879,
"type": "ingreso",
"concept": "PAGO DEL CLIENTE",
"amount": 1500.0,
"untouchable": false,
"status": "activo",
"previous_status": null,
"status_update_comment": null,
"status_update_date": null,
"create_user_id": 1,
"update_user_id": null,
"delete_user_id": null,
"restore_user_id": null,
"status_update_user_id": null,
"created_at": "2026-11-19T10:40:15.000000Z",
"updated_at": "2026-11-19T10:40:15.000000Z",
"deleted_at": null,
"boxMovement": {
"id": 879,
"account_id": 7,
"type": "ingreso",
"status": "activo",
"concept": "PAGO DEL CLIENTE"
}
}
Sin permiso403
{
"message": "This action is unauthorized."
}
La caja no pertenece al cliente422
{
"message": "La cuenta no existe o no pertenece al cliente seleccionado",
"errors": {
"customer_cashbox_id": [
"La cuenta no existe o no pertenece al cliente seleccionado"
]
}
}
Sin apertura422
{
"message": "No hay caja aperturada para la cuenta seleccionada",
"errors": {
"apertura": [
"No hay caja aperturada para la cuenta seleccionada"
]
}
}