Ir al contenido

Crear una moneda

POST/api/coin

Crea una moneda. El servidor guarda el registro con estado activo y asigna al usuario autenticado como creador. Devuelve el modelo creado.

namestringobligatorio

Nombre de la moneda. Máximo 60 caracteres y único.

symbolstring

Símbolo de la moneda. Máximo 10 caracteres.

abbreviationstringobligatorio

Abreviatura de la moneda. Máximo 3 caracteres.

valuenumber

Tipo de cambio. Numérico y mayor o igual a 0. Si no se envía, al crear queda en 1 y al actualizar se conserva el valor vigente, porque lo mantiene la sincronización diaria de tipos de cambio.

defaultbooleanobligatorio

Indica si es la moneda por defecto. Si es verdadero, las demás monedas dejan de serlo.

cashbox.configuration.create, que se valida en CoinPolicy::create. Ver Permisos y políticas.

Ventana de terminal
curl -X POST \
"https://servererp.allendostmen.app/api/coin" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"name": "Sol",
"symbol": "S/",
"abbreviation": "PEN",
"default": true
}'
Coin creado201
{
"id": 1,
"name": "Sol",
"symbol": "S/",
"abbreviation": "PEN",
"value": 1,
"default": true,
"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,
"restored_at": 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 nombre de la moneda ya existe. Verifique o restaure el registro si fue eliminado anteriormente.",
"errors": {
"name": [
"El nombre de la moneda ya existe. Verifique o restaure el registro si fue eliminado anteriormente."
]
}
}