Crear un cambio de moneda
Crea dos movimientos enlazados (egreso en el origen e ingreso en el destino) marcados como cambio de moneda. La moneda por defecto debe llevar tipo de cambio 1, y el monto de origen por su tipo de cambio debe coincidir con el monto de destino por el suyo, con un margen de tolerancia. El servidor guarda exchange_rate_value como el cociente entre el tipo de cambio mayor y el menor, y la moneda por defecto como exchange_rate_reference_coin_id.
Parámetros del cuerpo
Sección titulada «Parámetros del cuerpo»origin_account_idintegerobligatorioCuenta de origen.
destination_account_idintegerobligatorioCuenta de destino. Debe tener una moneda distinta a la de origen.
origin_amountnumberobligatorioMonto que sale de la cuenta de origen. Mínimo 0.01.
destination_amountnumberobligatorioMonto que entra a la cuenta de destino. Mínimo 0.01.
origin_exchange_ratenumberobligatorioValor de una unidad de la moneda de origen en la moneda por defecto. Mayor que 0.
destination_exchange_ratenumberobligatorioValor de una unidad de la moneda de destino en la moneda por defecto. Mayor que 0.
payment_datedatetimeobligatorioFecha de pago.
opcodestringCódigo de operación.
observationstringObservación.
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/exchange-rate" \ -H "Authorization: Bearer $TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{ "origin_account_id": 1, "destination_account_id": 3, "origin_amount": 1000, "destination_amount": 270, "origin_exchange_rate": 1, "destination_exchange_rate": 3.7037037, "payment_date": "2026-11-19 10:30:00"}'const response = await fetch( "https://servererp.allendostmen.app/api/cashbox-movement/exchange-rate", { method: "POST", headers: { Authorization: `Bearer ${token}`, Accept: "application/json", "Content-Type": "application/json", }, body: JSON.stringify({ "origin_account_id": 1, "destination_account_id": 3, "origin_amount": 1000, "destination_amount": 270, "origin_exchange_rate": 1, "destination_exchange_rate": 3.7037037, "payment_date": "2026-11-19 10:30:00" }), },);const data = await response.json();use Illuminate\Support\Facades\Http;
$response = Http::withToken($token) ->acceptJson() ->post('https://servererp.allendostmen.app/api/cashbox-movement/exchange-rate', [ 'origin_account_id' => 1, 'destination_account_id' => 3, 'origin_amount' => 1000, 'destination_amount' => 270, 'origin_exchange_rate' => 1, 'destination_exchange_rate' => 3.7037037, 'payment_date' => '2026-11-19 10:30:00', ]);{ "cashbox_movement_in": { "id": 1525, "type": "ingreso", "account_id": 3, "total_amount": 270, "is_transfer": true, "is_exchange_rate": true, "transfer_cashbox_movement_id": 1524, "status": "activo" }, "cashbox_movement_out": { "id": 1524, "type": "egreso", "account_id": 1, "total_amount": 1000, "is_transfer": true, "is_exchange_rate": true, "status": "activo" }}{ "message": "This action is unauthorized."}{ "message": "La cuenta de destino debe tener una moneda distinta a la de origen. Para cuentas de la misma moneda se debe usar la transferencia.", "errors": { "destination_account_id": [ "La cuenta de destino debe tener una moneda distinta a la de origen. Para cuentas de la misma moneda se debe usar la transferencia." ] }}