Crear una categoría
Crea una categoría. El servidor calcula level (1 si no hay padre; el nivel del padre más uno si lo hay), guarda la categoría con estado activo, asigna al usuario autenticado como creador y responde 201. Si el padre ya está en el nivel 3, responde 422 con la clave category_father_id.
Parámetros del cuerpo
Sección titulada «Parámetros del cuerpo»namestringobligatorioNombre de la categoría. Máximo 60 caracteres; solo letras, números y espacios. Debe ser único, también frente a categorías eliminadas.
descriptionstringDescripción. Máximo 500 caracteres.
category_father_idintegerCategoría padre. Debe existir en categorías. Si se omite, la categoría es raíz.
filestringSe acepta en la validación, pero CategoryController no lo procesa (el código que guardaba la imagen está comentado).
file_extensionstringSe acepta en la validación, pero CategoryController no lo procesa.
Permiso
Sección titulada «Permiso»quotation.configuration.create, que se valida en CategoryPolicy::create.
curl -X POST \ "https://servererp.allendostmen.app/api/category" \ -H "Authorization: Bearer $TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{ "name": "Cables", "description": "Cables eléctricos"}'const response = await fetch( "https://servererp.allendostmen.app/api/category", { method: "POST", headers: { Authorization: `Bearer ${token}`, Accept: "application/json", "Content-Type": "application/json", }, body: JSON.stringify({ "name": "Cables", "description": "Cables eléctricos" }), },);const data = await response.json();use Illuminate\Support\Facades\Http;
$response = Http::withToken($token) ->acceptJson() ->post('https://servererp.allendostmen.app/api/category', [ 'name' => 'Cables', 'description' => 'Cables eléctricos',]);{ "id": 1, "name": "Cables", "description": "Cables eléctricos", "image": null, "thumbnail": null, "level": 1, "category_father_id": 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}{ "message": "El nombre de la categoría ya existe", "errors": { "name": [ "El nombre de la categoría ya existe" ] }}{ "message": "No se puede crear esta categoría dentro del nivel máximo", "errors": { "category_father_id": [ "No se puede crear esta categoría dentro del nivel máximo" ] }}{ "message": "This action is unauthorized."}