front_ponto_eletronico/docs/settings_calculo_horas/create.yml

88 lines
2.6 KiB
YAML

tags:
- Settings Cálculo Horas
summary: Cria uma nova configuração de cálculo de horas
description: >
Essa rota permite criar uma configuração de cálculo de horas associada a uma instância de serviço.
parameters:
- in: body
name: body
description: Dados para a criação de uma nova configuração.
required: true
schema:
type: object
properties:
jornada_diaria:
type: integer
description: Jornada de trabalho diária em minutos
example: 480
jornada_semanal:
type: integer
description: Jornada de trabalho semanal em minutos
example: 2400
inicio_periodo_noturno:
type: string
format: time
description: Hora de início do período noturno
example: "22:00:00"
fim_periodo_noturno:
type: string
format: time
description: Hora de fim do período noturno
example: "05:00:00"
desconto_atraso_automatico:
type: string
description: Habilita ou não o desconto automático por atraso
example: "True"
tolerancia_para_descontos:
type: integer
description: Tolerância em minutos para aplicação de descontos
example: 10
arredondamento_minutos:
type: integer
description: Minutos utilizados para arredondamento
example: 5
service_instance_id:
type: integer
description: ID da instância de serviço associada
example: 4
responses:
201:
description: Configuração criada com sucesso
content:
application/json:
schema:
type: object
properties:
message:
type: string
settings_id:
type: integer
examples:
application/json:
message: "Configuração criada com sucesso"
settings_id: 1
400:
description: Requisição inválida (dados incorretos ou ausentes)
content:
application/json:
schema:
type: object
properties:
error:
type: string
examples:
application/json:
error: "Campos obrigatórios ausentes ou inválidos."
401:
description: Token inválido ou ausente
content:
application/json:
schema:
type: object
properties:
error:
type: string
examples:
application/json:
error: "Token inválido ou ausente"