Crear un servicio

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_types

Parámetros de entrada

ParámetroTipoRequeridoDescripción
descriptionTextoNombre del tipo de servicio. Máximo 50 caracteres.
unit_codeTextoCó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_descriptionTextoCondicionalDescripción de la unidad. Requerido si unit_code no existe aún en la empresa. Máximo 50 caracteres.

Notas

  • Los campos description y unit_code son obligatorios. Si alguno de los dos está ausente o vacío, la función responde con código 404 y el mensaje description and unit_code are required.
  • Si unit_code no existe en el catálogo de unidades de la empresa y no se envía unit_description, la función responde con código 404 y el mensaje unit_description is required.
  • La búsqueda de unit_code es insensible a mayúsculas y minúsculas (UPPER).
  • La nueva unidad se crea con id_unit_type = 2.

Parámetros de salida

ParámetroTipoDescripción
idEnteroIdentificador único del tipo de servicio creado.
id_companyEnteroIdentificador de la empresa.
descriptionTextoNombre del tipo de servicio registrado.
id_unityEnteroIdentificador de la unidad asociada.
is_changedBooleanoIndica 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"
}

Response
200
Language
LoadingLoading…