Crear Clasificación 1 de almacenes

post

https://app.fracttal.com/api/warehouses_groups_1/new-endpoint-1

Crea una nueva Clasificación 1 de almacenes en la empresa del caller.

Add-on requerido
Uso general — sin add-on específico. Requiere que la API key/usuario tenga permiso add sobre Configuración > Catálogos.

POST https://app.fracttal.com/api/warehouses_groups_1

Parámetros de entrada — Requeridos

Ninguno — ver nota sobre description a continuación.

Parámetros de entrada — Opcionales

Se envían en el body de la petición.

Parámetro	Tipo	Requerido	Descripción
`description`	texto (máx. 50 caracteres)	No	Nombre de la clasificación. La columna es nullable — si no se envía, se crea el registro con `description = null`. No hay truncado automático: enviar más de 50 caracteres genera un error `500`.

Comportamientos que llaman la atención (no son errores)

Enviar la misma description dos veces no falla ni es idempotente: crea un segundo registro con el mismo texto. El endpoint no valida unicidad.

No enviar description tampoco falla: crea el registro con description = null.

Parámetros de salida

Parámetro	Tipo	Descripción
`success`	booleano	`true` si la creación fue exitosa.
`message`	texto	`"200"` en éxito; código/mensaje de error en caso contrario.
`data`	objeto	`{ id, id_company, description, enabled }` de la clasificación creada.
`total`	entero	`1` en éxito.

Errores

Código	Causa
`401`	Token inválido o ausente.
`500`	Sin permiso `add` sobre Configuración > Catálogos.
`500`	`description` supera los 50 caracteres (error de base de datos, sin mensaje de validación específico).

Nota sobre el código de error por falta de permiso
Actualmente la función responde 500 tanto para el rechazo de permiso como para cualquier otro error interno no controlado — no hay un código 403 diferenciado. Está bajo discusión con Arquitectura si debería separarse (ver PR DbProduction#2844 y FHEI-1822).

Ejemplo

Request body

{
  "description": "Repuestos críticos"
}

Response `200`

{
  "success": true,
  "message": "200",
  "data": {
    "id": 751,
    "id_company": 4344,
    "description": "Repuestos críticos",
    "enabled": true
  },
  "total": 1
}

Response — sin permiso `add` (`500`)

{
  "success": false,
  "message": "500",
  "data": null,
  "total": 0
}

Response

200

Language

Loading…