Ir al contenido

Crear un segmento de ingreso

POST/api/cashbox-income-segment

Crea un segmento de ingreso. El servidor lo guarda con estado activo y asigna al usuario autenticado como creador.

namestringobligatorio

Nombre del segmento. Máximo 255 caracteres. Debe ser único entre los segmentos.

descriptionstring

Descripción del segmento. Máximo 500 caracteres.

settingsobject

Configuración del segmento, como objeto.

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

Ventana de terminal
curl -X POST \
"https://servererp.allendostmen.app/api/cashbox-income-segment" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"name": "Ventas",
"description": "Ingresos por ventas"
}'
Segmento creado201
{
"name": "Ventas",
"description": "Ingresos por ventas",
"status": "activo",
"previous_status": null,
"create_user_id": 1,
"updated_at": "2026-11-19T10:40:15.000000Z",
"created_at": "2026-11-19T10:40:15.000000Z",
"id": 1
}
Sin permiso403
{
"message": "Esta acción no está autorizada."
}
Datos no válidos422
{
"message": "Ya existe un segmento de ingreso con este nombre. Verifique o restaure el registro si fue eliminado anteriormente.",
"errors": {
"name": [
"Ya existe un segmento de ingreso con este nombre. Verifique o restaure el registro si fue eliminado anteriormente."
]
}
}