Ir al contenido

Crear una comisión

POST/api/commission

Crea una comisión. El servidor la guarda con estado activo y asigna al usuario autenticado como creador (create_user_id). Responde 201 con el registro.

commission_type_idintegerobligatorio

Tipo de comisión. Debe existir. Junto con coin_id, origin_bank_id y destination_bank_id forma una combinación única; si se repite, el mensaje es Ya existe una comisión con estos mismos valores. Verifique o restaure registros eliminados.

coin_idintegerobligatorio

Moneda de la comisión. Debe existir.

origin_bank_idintegerobligatorio

Banco de origen. Debe existir.

variablebooleanobligatorio

Indica si la comisión es variable. Si es verdadero, destination_bank_id se ignora y se guarda en nulo.

destination_bank_idintegercondicional

Banco de destino. Obligatorio si variable es falso, con el mensaje El banco de destino es obligatorio cuando la comisión no es variable.

amountnumber

Monto de la comisión. Entre 0.01 y 1000.00, con hasta 4 dígitos enteros y 2 decimales.

descriptionstring

Descripción. Máximo 500 caracteres.

cashbox.configuration.create, que se valida en CommissionPolicy::create.

Ventana de terminal
curl -X POST \
"https://servererp.allendostmen.app/api/commission" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"commission_type_id": 2,
"coin_id": 1,
"origin_bank_id": 3,
"destination_bank_id": 5,
"variable": false,
"amount": 2.5
}'
Comisión creada201
{
"id": 1,
"commission_type_id": 2,
"coin_id": 1,
"origin_bank_id": 3,
"destination_bank_id": 5,
"variable": false,
"amount": "2.50000000",
"comment": null,
"status": "activo",
"previous_status": null,
"status_update_comment": null,
"status_update_date": null,
"status_update_user_id": null,
"create_user_id": 1,
"update_user_id": null,
"delete_user_id": null,
"restore_user_id": null,
"created_at": "2026-11-19T10:40:15.000000Z",
"updated_at": "2026-11-19T10:40:15.000000Z",
"deleted_at": null
}
Sin permiso403
{
"message": "This action is unauthorized."
}
Datos no válidos422
{
"message": "El banco de destino es obligatorio cuando la comisión no es variable.",
"errors": {
"destination_bank_id": ["El banco de destino es obligatorio cuando la comisión no es variable."]
}
}