Ir al contenido

Crear un cambio de moneda

POST/api/cashbox-movement/exchange-rate

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.

origin_account_idintegerobligatorio

Cuenta de origen.

destination_account_idintegerobligatorio

Cuenta de destino. Debe tener una moneda distinta a la de origen.

origin_amountnumberobligatorio

Monto que sale de la cuenta de origen. Mínimo 0.01.

destination_amountnumberobligatorio

Monto que entra a la cuenta de destino. Mínimo 0.01.

origin_exchange_ratenumberobligatorio

Valor de una unidad de la moneda de origen en la moneda por defecto. Mayor que 0.

destination_exchange_ratenumberobligatorio

Valor de una unidad de la moneda de destino en la moneda por defecto. Mayor que 0.

payment_datedatetimeobligatorio

Fecha de pago.

opcodestring

Código de operación.

observationstring

Observación.

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/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"
}'
Cambio de moneda creado200
{
"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"
}
}
Sin permiso403
{
"message": "This action is unauthorized."
}
Monedas iguales422
{
"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."
]
}
}