---
updatedAt: 2026-07-07T08:42:27.000Z
agentTools:
  projectIndex: https://api.fracttal.com/llms.txt
---

# 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

```http
POST /api/service_types
```

## Pará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 `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á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.

```json
{
  "description": "Mantenimiento correctivo",
  "unit_code": "HRS",
  "unit_description": "Horas"
}
```

Cuando la unidad ya existe, no es necesario enviar `unit_description`.

```json
{
  "description": "Inspección preventiva",
  "unit_code": "HRS"
}
```

<br />

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "1.0.0",
    "title": "Crear un servicio"
  },
  "servers": [
    {
      "url": "https://app.fracttal.com/api/service_types"
    }
  ],
  "paths": {
    "/": {
      "post": {
        "responses": {
          "200": {
            "description": ""
          }
        },
        "parameters": [],
        "operationId": "post_",
        "summary": "Crear un servicio",
        "description": "Crea un nuevo tipo de servicio para la empresa autenticada."
      }
    }
  },
  "x-readme": {
    "explorer-enabled": false,
    "proxy-enabled": true
  }
}
```