post
https://app.fracttal.com/api/service_types/
Se a unidade informada em unit_code não existir, ela será criada automaticamente usando unit_description.
Parâmetros de entrada
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
description | Texto | Sim | Nome do tipo de serviço. Máximo de 50 caracteres. |
unit_code | Texto | Sim | Código da unidade associada ao tipo de serviço. Máximo de 10 caracteres. Se não existir na empresa, uma nova unidade será criada. |
unit_description | Texto | Condicional | Descrição da unidade. Obrigatório se unit_code ainda não existir na empresa. Máximo de 50 caracteres. |
Observações
- Os campos
descriptioneunit_codesão obrigatórios. Se algum deles estiver ausente ou vazio, a função retorna o código404e a mensagemdescription and unit_code are required. - Se
unit_codenão existir no catálogo de unidades da empresa eunit_descriptionnão for enviado, a função retorna o código404e a mensagemunit_description is required. - A busca por
unit_codenão diferencia maiúsculas de minúsculas (UPPER). - A nova unidade é criada com
id_unit_type = 2.
Parâmetros de saída
| Parâmetro | Tipo | Descrição |
|---|---|---|
id | Inteiro | Identificador único do tipo de serviço criado. |
id_company | Inteiro | Identificador da empresa. |
description | Texto | Nome do tipo de serviço registrado. |
id_unity | Inteiro | Identificador da unidade associada. |
is_changed | Booleano | Indica se o registro foi modificado. Sempre será false na criação. |
Exemplo
Quando a unidade não existir, envie unit_description para criá-la automaticamente.
{
"description": "Manutenção corretiva",
"unit_code": "HRS",
"unit_description": "Horas"
}Quando a unidade já existir, não é necessário enviar unit_description.
{
"description": "Inspeção preventiva",
"unit_code": "HRS"
} 200