Crear una transferencia
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.
Parámetros del cuerpo
Sección titulada «Parámetros del cuerpo»origin_account_idintegerobligatorioCuenta de origen. Debe tener la misma moneda que la de destino.
destination_account_idintegerobligatorioCuenta de destino.
subtotal_amountnumberobligatorioMonto a transferir. Mínimo 0.01.
payment_datedatetimeobligatorioFecha de pago.
between_boxesbooleanIndica que la transferencia es entre cajas distintas. Si es verdadero, las cuentas deben ser de cajas diferentes.
conceptstringcondicionalConcepto. Obligatorio si between_boxes es verdadero (máximo 500 caracteres); si no, el servidor lo genera como Transferencia de origen a destino.
accounting_account_movementsarraycondicionalReparto 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.
opcodestringCódigo de operación.
observationstringObservación. Con between_boxes verdadero el servidor la reemplaza por la descripción generada.
commission_type_idintegerTipo de comisión. Si se envía, commission_amount es obligatorio.
commission_amountnumbercondicionalMonto de la comisión, máximo 1000. Se suma al egreso de origen.
commission_opcodestringCódigo de operación de la comisión. Solo números.
Permiso
Sección titulada «Permiso»cashbox.movement.create, validado en CashboxMovementPolicy::create. Ver Permisos y políticas.
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"}'const response = await fetch( "https://servererp.allendostmen.app/api/cashbox-movement/transfer", { method: "POST", headers: { Authorization: `Bearer ${token}`, Accept: "application/json", "Content-Type": "application/json", }, body: JSON.stringify({ "origin_account_id": 1, "destination_account_id": 2, "subtotal_amount": 500, "payment_date": "2026-11-19 10:30:00", "observation": "Traslado de fondos" }), },);const data = await response.json();use Illuminate\Support\Facades\Http;
$response = Http::withToken($token) ->acceptJson() ->post('https://servererp.allendostmen.app/api/cashbox-movement/transfer', [ 'origin_account_id' => 1, 'destination_account_id' => 2, 'subtotal_amount' => 500, 'payment_date' => '2026-11-19 10:30:00', 'observation' => 'Traslado de fondos', ]);{ "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" }}{ "message": "This action is unauthorized."}{ "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." ] }}