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.
Parámetros del cuerpo
Sección titulada «Parámetros del cuerpo»namestringobligatorioNombre del segmento. Máximo 255 caracteres. Debe ser único entre los segmentos.
descriptionstringDescripción del segmento. Máximo 500 caracteres.
settingsobjectConfiguración del segmento, como objeto.
Permiso
Sección titulada «Permiso»cashbox.configuration.create, que se valida en CashboxIncomeSegmentPolicy::create. Ver Permisos y políticas.
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"}'const response = await fetch( "https://servererp.allendostmen.app/api/cashbox-income-segment", { method: "POST", headers: { Authorization: `Bearer ${token}`, Accept: "application/json", "Content-Type": "application/json", }, body: JSON.stringify({ "name": "Ventas", "description": "Ingresos por ventas" }), },);const data = await response.json();use Illuminate\Support\Facades\Http;
$response = Http::withToken($token) ->acceptJson() ->post('https://servererp.allendostmen.app/api/cashbox-income-segment', [ '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." ] }}