post
https://app.fracttal.com/api/service_types/
Crea un nuevo tipo de servicio para la empresa autenticada.
Si la unidad indicada por unit_code no existe, se crea automáticamente usando unit_description.
Endpoint
POST /api/service_typesParámetros de entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
description | Texto | Sí | Nombre del tipo de servicio. Máximo 50 caracteres. |
unit_code | Texto | Sí | Código de la unidad asociada al tipo de servicio. Máximo 10 caracteres. Si no existe en la empresa, se crea una nueva unidad. |
unit_description | Texto | Condicional | Descripción de la unidad. Requerido si unit_code no existe aún en la empresa. Máximo 50 caracteres. |
Notas
- Los campos
descriptionyunit_codeson obligatorios. Si alguno de los dos está ausente o vacío, la función responde con código404y el mensajedescription and unit_code are required. - Si
unit_codeno existe en el catálogo de unidades de la empresa y no se envíaunit_description, la función responde con código404y el mensajeunit_description is required. - La búsqueda de
unit_codees insensible a mayúsculas y minúsculas (UPPER). - La nueva unidad se crea con
id_unit_type = 2.
Parámetros de salida
| Parámetro | Tipo | Descripción |
|---|---|---|
id | Entero | Identificador único del tipo de servicio creado. |
id_company | Entero | Identificador de la empresa. |
description | Texto | Nombre del tipo de servicio registrado. |
id_unity | Entero | Identificador de la unidad asociada. |
is_changed | Booleano | Indica si el registro ha sido modificado. Siempre es false en creación. |
Ejemplo
Cuando la unidad no existe, envía unit_description para crearla automáticamente.
{
"description": "Mantenimiento correctivo",
"unit_code": "HRS",
"unit_description": "Horas"
}Cuando la unidad ya existe, no es necesario enviar unit_description.
{
"description": "Inspección preventiva",
"unit_code": "HRS"
} 200