Ir al contenido

Crear una transferencia

POST/api/cashbox-movement/transfer

Crea dos movimientos enlazados: un egreso en la cuenta de origen y un ingreso en la de destino, con el método de pago de transferencia. El ingreso apunta al egreso con transfer_cashbox_movement_id. La comisión solo se registra en el egreso. Si las monedas de las cuentas son distintas, responde 422: para eso se usa el cambio de moneda.

origin_account_idintegerobligatorio

Cuenta de origen. Debe tener la misma moneda que la de destino.

destination_account_idintegerobligatorio

Cuenta de destino.

subtotal_amountnumberobligatorio

Monto a transferir. Mínimo 0.01.

payment_datedatetimeobligatorio

Fecha de pago.

between_boxesboolean

Indica que la transferencia es entre cajas distintas. Si es verdadero, las cuentas deben ser de cajas diferentes.

conceptstringcondicional

Concepto. Obligatorio si between_boxes es verdadero (máximo 500 caracteres); si no, el servidor lo genera como Transferencia de origen a destino.

accounting_account_movementsarraycondicional

Reparto contable. Obligatorio con al menos un elemento si between_boxes es verdadero. Cada elemento lleva accounting_account_id, amount (mínimo 0.01) y percentage.

opcodestring

Código de operación.

observationstring

Observación. Con between_boxes verdadero el servidor la reemplaza por la descripción generada.

commission_type_idinteger

Tipo de comisión. Si se envía, commission_amount es obligatorio.

commission_amountnumbercondicional

Monto de la comisión, máximo 1000. Se suma al egreso de origen.

commission_opcodestring

Código de operación de la comisión. Solo números.

cashbox.movement.create, validado en CashboxMovementPolicy::create. Ver Permisos y políticas.

Ventana de terminal
curl -X POST \
"https://servererp.allendostmen.app/api/cashbox-movement/transfer" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"origin_account_id": 1,
"destination_account_id": 2,
"subtotal_amount": 500,
"payment_date": "2026-11-19 10:30:00",
"observation": "Traslado de fondos"
}'
Transferencia creada200
{
"cashbox_movement_in": {
"id": 1523,
"type": "ingreso",
"account_id": 2,
"total_amount": 500,
"is_transfer": true,
"transfer_cashbox_movement_id": 1522,
"status": "activo"
},
"cashbox_movement_out": {
"id": 1522,
"type": "egreso",
"account_id": 1,
"total_amount": 500,
"is_transfer": true,
"status": "activo"
}
}
Sin permiso403
{
"message": "This action is unauthorized."
}
Monedas distintas422
{
"message": "La cuenta de destino tiene una moneda distinta a la de origen. Para cambiar de moneda se debe usar la transferencia con tipo de cambio.",
"errors": {
"destination_account_id": [
"La cuenta de destino tiene una moneda distinta a la de origen. Para cambiar de moneda se debe usar la transferencia con tipo de cambio."
]
}
}