> ## Documentation Index > Fetch the complete documentation index at: https://developers.pontua.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Atualiza as informações do turno ## OpenAPI ````yaml https://api.pre.pontua.tech/api/public/doc-json put /turnos/{turnoId} openapi: 3.0.0 info: title: Pontua Public API description: >- API oficial da Pontua para integrações de clientes externos. Autentique com o token gerado no dashboard em **Configurações → API**. Envie o token no header `Authorization: Bearer `. version: '1.0' contact: {} servers: [] security: [] tags: [] paths: /turnos/{turnoId}: put: tags: - Turno summary: Atualiza as informações do turno operationId: TurnosController_Update parameters: - name: turnoId required: true in: path description: ID do turno schema: type: string requestBody: required: true description: Dados para atualização do turno content: application/json: schema: $ref: '#/components/schemas/CreateTurnoDto' examples: Fixo: value: nome: Turno Fixo - seg a sex - 08:00 às 18:00 tipoTurno: turnoFixo values: dias: - diaReferencia: SEGUNDA tipoDia: NORMAL entrada: '08:00' saida: '18:00' intervalo: isFlexivel: false horarios: - entrada: '12:00' saida: '13:00' - diaReferencia: TERCA tipoDia: NORMAL entrada: '08:00' saida: '18:00' intervalo: isFlexivel: false horarios: - entrada: '12:00' saida: '13:00' - diaReferencia: QUARTA tipoDia: NORMAL entrada: '08:00' saida: '18:00' intervalo: isFlexivel: false horarios: - entrada: '12:00' saida: '13:00' - diaReferencia: QUINTA tipoDia: NORMAL entrada: '08:00' saida: '18:00' intervalo: isFlexivel: false horarios: - entrada: '12:00' saida: '13:00' - diaReferencia: SEXTA tipoDia: NORMAL entrada: '08:00' saida: '18:00' intervalo: isFlexivel: false horarios: - entrada: '12:00' saida: '13:00' - diaReferencia: SABADO tipoDia: DSR - diaReferencia: DOMINGO tipoDia: DSR Flexível: value: nome: Turno Flexível Diário - 8h/dia seg e ter, 2h qua tipoTurno: turnoFlexivel values: tipoHorario: DIARIO semDiasDefinidos: false viraNoiteGeral: '01:00' dias: - diasReferencia: - SEGUNDA - TERCA minutosTotal: 540 intervalo: isFlexivel: true horarios: - maximo: '01:00' - diasReferencia: - QUARTA minutosTotal: 120 viraNoite: '02:00' Revezamento: value: nome: Turno Revezamento - 2 meses, com 3 e 2 dias tipoTurno: turnoRevezamento values: meses: - numeroMes: 1 dias: - numeroDia: 1 tipoDia: NORMAL entrada: '08:00' saida: '18:00' intervalo: isFlexivel: false horarios: - entrada: '12:00' saida: '13:00' - numeroDia: 2 tipoDia: DSR - numeroDia: 3 tipoDia: NORMAL entrada: '08:00' saida: '18:00' intervalo: isFlexivel: true horarios: - maximo: '01:00' - numeroMes: 2 dias: - numeroDia: 1 tipoDia: NORMAL entrada: '08:00' saida: '18:00' intervalo: isFlexivel: false horarios: - entrada: '12:00' saida: '13:00' - numeroDia: 2 tipoDia: DSR Ciclo: value: nome: Turno Ciclo - entre 2 turnos tipoTurno: turnoCiclo values: dataInicio: '2024-06-25T00:00:00.000Z' ciclosAtivos: - numeroCiclo: 1 duracaoDias: 7 turnoId: 123-abc - numeroCiclo: 2 duracaoDias: 23 turnoId: 456-def responses: '200': description: Dados do registro atualizado content: application/json: schema: $ref: '#/components/schemas/FindOneTurnosDto' examples: Fixo: value: nome: Turno Fixo - seg a sex - 08:00 às 18:00 tipoTurno: turnoFixo values: dias: - diaReferencia: SEGUNDA tipoDia: NORMAL entrada: '08:00' saida: '18:00' intervalo: isFlexivel: false horarios: - entrada: '12:00' saida: '13:00' - diaReferencia: TERCA tipoDia: NORMAL entrada: '08:00' saida: '18:00' intervalo: isFlexivel: false horarios: - entrada: '12:00' saida: '13:00' - diaReferencia: QUARTA tipoDia: NORMAL entrada: '08:00' saida: '18:00' intervalo: isFlexivel: false horarios: - entrada: '12:00' saida: '13:00' - diaReferencia: QUINTA tipoDia: NORMAL entrada: '08:00' saida: '18:00' intervalo: isFlexivel: false horarios: - entrada: '12:00' saida: '13:00' - diaReferencia: SEXTA tipoDia: NORMAL entrada: '08:00' saida: '18:00' intervalo: isFlexivel: false horarios: - entrada: '12:00' saida: '13:00' - diaReferencia: SABADO tipoDia: DSR - diaReferencia: DOMINGO tipoDia: DSR Flexível: value: nome: Turno Flexível Diário - 8h/dia seg e ter, 2h qua tipoTurno: turnoFlexivel values: tipoHorario: DIARIO semDiasDefinidos: false viraNoiteGeral: '01:00' dias: - diasReferencia: - SEGUNDA - TERCA minutosTotal: 540 intervalo: isFlexivel: true horarios: - maximo: '01:00' - diasReferencia: - QUARTA minutosTotal: 120 viraNoite: '02:00' Revezamento: value: nome: Turno Revezamento - 2 meses, com 3 e 2 dias tipoTurno: turnoRevezamento values: meses: - numeroMes: 1 dias: - numeroDia: 1 tipoDia: NORMAL entrada: '08:00' saida: '18:00' intervalo: isFlexivel: false horarios: - entrada: '12:00' saida: '13:00' - numeroDia: 2 tipoDia: DSR - numeroDia: 3 tipoDia: NORMAL entrada: '08:00' saida: '18:00' intervalo: isFlexivel: true horarios: - maximo: '01:00' - numeroMes: 2 dias: - numeroDia: 1 tipoDia: NORMAL entrada: '08:00' saida: '18:00' intervalo: isFlexivel: false horarios: - entrada: '12:00' saida: '13:00' - numeroDia: 2 tipoDia: DSR Ciclo: value: nome: Turno Ciclo - entre 2 turnos tipoTurno: turnoCiclo values: dataInicio: '2024-06-25T00:00:00.000Z' ciclosAtivos: - numeroCiclo: 1 duracaoDias: 7 turnoId: 123-abc - numeroCiclo: 2 duracaoDias: 23 turnoId: 456-def default: description: "\n\t\t\t400 - Bad Request: A solicitação não está no formato correto.\n\t\t\t401 - Unauthorized: A solicitação não foi autorizada. Verifique se o token de acesso é válido.\n\t\t\t403 - Forbidden: Acesso proibido! Requer um nível de permissão mais elevado.\n\t\t\t404 - Not Found: O recurso solicitado não foi encontrado.\n\t\t\t500 - Internal Server Error: Erro de execução no servidor!\n\t\t\t" content: application/json: schema: $ref: '#/components/schemas/ErrorDto' deprecated: false security: - bearer: [] components: schemas: CreateTurnoDto: type: object properties: nome: type: string description: Nome do turno example: Turno diurno tipoTurno: type: string description: ID referente ao registro do configuracaoDiaFixo enum: - turnoFixo - turnoFlexivel - turnoRevezamento - turnoCiclo default: turnoFixo codigo: type: number description: Código de identificação unico do Turno example: 57 values: description: Dados do turno oneOf: - $ref: '#/components/schemas/CreateTurnoHorarioFixoDto' - $ref: '#/components/schemas/CreateTurnoHorarioFlexivelDto' - $ref: '#/components/schemas/TurnoHorarioRevezamentoDto' - $ref: '#/components/schemas/CreateTurnoCicloDto' required: - nome - tipoTurno - values FindOneTurnosDto: type: object properties: nome: type: string description: Nome do turno example: Turno diurno tipoTurno: type: string description: ID referente ao registro do configuracaoDiaFixo enum: - turnoFixo - turnoFlexivel - turnoRevezamento - turnoCiclo default: turnoFixo codigo: type: number description: Código de identificação unico do Turno example: 57 values: description: Dados do turno oneOf: - $ref: '#/components/schemas/CreateTurnoHorarioFixoDto' - $ref: '#/components/schemas/CreateTurnoHorarioFlexivelDto' - $ref: '#/components/schemas/TurnoHorarioRevezamentoDto' - $ref: '#/components/schemas/CreateTurnoCicloDto' turnoId: type: string description: ID referente ao registro do Turno example: '1' ativo: type: boolean description: Status atual do Turno example: true colaboradores: type: number description: Número de colaboradores vinculados ao Turno example: 13 createdAt: format: date-time type: string description: Data de criação example: '2026-05-11T13:08:52.937Z' updatedAt: format: date-time type: string description: Data do ultimo update example: '2026-05-11T13:08:52.937Z' required: - nome - tipoTurno - values - turnoId - ativo - colaboradores - createdAt - updatedAt ErrorDto: type: object properties: service: type: string description: Rota solicitada method: type: string description: Método http message: description: Mensagem do erro oneOf: - type: string example: message erro - type: array items: type: string example: - erro 1 - erro 2 required: - service - method - message CreateTurnoHorarioFixoDto: type: object properties: dias: description: Dias da semana para a configuração type: array items: $ref: '#/components/schemas/CreateConfiguracaoDiaFixo' CreateTurnoHorarioFlexivelDto: type: object properties: tipoHorario: type: string description: Tipo de horário flexível enum: - DIARIO - SEMANAL - MENSAL - LIVRE semDiasDefinidos: type: boolean description: >- Não há dias de trabalho definidos (somente para os tipos SEMANAL e MENSAL) example: false viraNoiteGeral: type: string description: >- Valor no formato HH:mm do horário de virada da data da jornada. Este valor geral será o padrão, caso não existir no grupo de dias example: '01:00' dias: description: Array de configuração das semanas flexíveis type: array items: $ref: '#/components/schemas/CreateConfiguracaoDiasFlexivel' required: - tipoHorario TurnoHorarioRevezamentoDto: type: object properties: meses: description: meses para a configuração type: array items: $ref: '#/components/schemas/MesRevezamento' CreateTurnoCicloDto: type: object properties: dataInicio: format: date-time type: string description: Data de início da contagem dos ciclos example: '2024-06-25T00:00:00.000Z' ciclosAtivos: description: Array de configuração dos ciclos ativos type: array items: $ref: '#/components/schemas/CreateConfiguracaoCiclo' required: - dataInicio - ciclosAtivos CreateConfiguracaoDiaFixo: type: object properties: diaReferencia: type: string description: Dia de referência para a configuração enum: - DOMINGO - SEGUNDA - TERCA - QUARTA - QUINTA - SEXTA - SABADO default: SEGUNDA tipoDia: type: string description: Tipo do dia enum: - NORMAL - COMPENSADO - DSR default: NORMAL entrada: type: string description: Valor no formato HH:mm do horário de entrada no dia example: '08:00' saida: type: string description: Valor no formato HH:mm do horário da saída no dia example: '18:00' intervalo: description: Intervalos allOf: - $ref: '#/components/schemas/CreateIntervaloDto' required: - diaReferencia - tipoDia CreateConfiguracaoDiasFlexivel: type: object properties: diasReferencia: type: array description: Dias de referência para a configuração items: type: string enum: - DOMINGO - SEGUNDA - TERCA - QUARTA - QUINTA - SEXTA - SABADO minutosTotal: type: number description: Número de minutos referente ao trabalho total, incluindo intervalo example: 480 viraNoite: type: string description: >- Valor no formato HH:mm do horário de virada da data da jornada. Este valor sobrescreve o geral example: '01:00' intervalo: description: Intervalos allOf: - $ref: '#/components/schemas/CreateIntervaloDto' required: - minutosTotal MesRevezamento: type: object properties: numeroMes: type: number description: Número de referencia para ordenação dos meses example: 1 dias: description: dias para a configuração type: array items: $ref: '#/components/schemas/DiaRevezamento' CreateConfiguracaoCiclo: type: object properties: numeroCiclo: type: number description: Número de referencia para ordenação dos ciclos example: 1 duracaoDias: type: number description: Número de dias de duração do ciclo example: 7 turnoId: type: string description: ID do turno referente ao ciclo example: 123-456abc required: - turnoId CreateIntervaloDto: type: object properties: isFlexivel: type: boolean description: 'Define como intervalo com horário flexível ' example: true horarios: description: Horários do intervalo fixo ou limites do intervalo flexivel type: array items: oneOf: - type: array items: $ref: '#/components/schemas/CreateHorarioIntervaloFlexivel' - type: array items: $ref: '#/components/schemas/CreateHorarioIntervaloFixo' required: - isFlexivel - horarios DiaRevezamento: type: object properties: numeroDia: type: number description: Número de referencia para ordenação dos dias example: 1 tipoDia: type: string description: Tipo do dia enum: - NORMAL - COMPENSADO - DSR default: NORMAL entrada: type: string description: Valor no formato HH:mm do horario de entrada no dia example: '08:00' saida: type: string description: Valor no formato HH:mm do horario da saida no dia example: '18:00' intervalo: description: Intervalos allOf: - $ref: '#/components/schemas/CreateIntervaloDto' required: - tipoDia CreateHorarioIntervaloFlexivel: type: object properties: minimo: type: string description: Valor no formato HH:mm de horario mínimo para o intervalo example: '00:30' maximo: type: string description: Valor no formato HH:mm de horario máximo para o intervalo example: '01:30' required: - maximo CreateHorarioIntervaloFixo: type: object properties: entrada: type: string description: Valor no formato HH:mm do horario de entrada no intervalo example: '12:00' saida: type: string description: Valor no formato HH:mm do horario de saida do intervalo example: '13:00' required: - entrada - saida ````