> ## 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.

# Cria exceções de dias de turno



## OpenAPI

````yaml https://api.pre.pontua.tech/api/public/doc-json post /turnos-excecoes/days
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 <SEU_TOKEN>`.
  version: '1.0'
  contact: {}
servers: []
security: []
tags: []
paths:
  /turnos-excecoes/days:
    post:
      tags:
        - Turno Exceção
      summary: Cria exceções de dias de turno
      operationId: ExceptionsController_createExceptionDays
      parameters: []
      requestBody:
        required: true
        description: Dados para criação das exceções de dia
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateDayExceptionsDto'
      responses:
        '201':
          description: Exceções de dias criadas com sucesso
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OkWithErrorsDto'
        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:
    CreateDayExceptionsDto:
      type: object
      properties:
        collaboratorExceptions:
          description: Colaboradores com exceções
          type: array
          items:
            $ref: '#/components/schemas/CreateCollaboratorDayExceptionsDto'
      required:
        - collaboratorExceptions
    OkWithErrorsDto:
      type: object
      properties:
        status:
          type: boolean
          description: Status da operação
          example: true
        mensagem:
          type: string
          description: Mensagem de retorno
          example: OK
        errors:
          description: Erros ocorridos durante o processamento
          example:
            - Erro 1
            - Erro 2
          type: array
          items:
            type: string
      required:
        - status
    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
    CreateCollaboratorDayExceptionsDto:
      type: object
      properties:
        collaboratorId:
          type: string
          description: ID do colaborador
          example: 123-abc
        dayExceptions:
          description: Dias com exceções
          type: array
          items:
            $ref: '#/components/schemas/CreateCollaboratorDayExceptionDto'
      required:
        - collaboratorId
        - dayExceptions
    CreateCollaboratorDayExceptionDto:
      type: object
      properties:
        date:
          format: date-time
          type: string
          description: Data da exceção de dia
          example: '2026-01-01T00:00:00.000Z'
        swappedCollaboratorId:
          type: string
          description: ID do colaborador (no caso de troca de dias)
          example: 123-abc
        swappedDate:
          format: date-time
          type: string
          description: Data do dia trocado (no caso de troca de dias)
          example: '2026-01-02T00:00:00.000Z'
        remarks:
          type: string
          description: Observações do gestor
          example: Exceção de dia justificada
        details:
          description: Intervalos
          allOf:
            - $ref: '#/components/schemas/CreateDayExceptionDetailsDto'
      required:
        - date
        - swappedDate
    CreateDayExceptionDetailsDto:
      type: object
      properties:
        type:
          type: string
          description: Tipo do dia
          enum:
            - NORMAL
            - FOLGA
            - DSR
          default: NORMAL
        isFlexible:
          type: boolean
          description: 'Define como horário flexível '
          example: false
        entry:
          type: string
          description: >-
            Valor no formato HH:mm do horário de entrada no dia (somente para
            dia não flexível)
          example: '08:00'
        exit:
          type: string
          description: >-
            Valor no formato HH:mm do horário da saída no dia (somente para dia
            não flexível)
          example: '18:00'
        flexibleShiftType:
          type: string
          description: Tipo de turno flexível
          enum:
            - LIVRE
            - DIARIO
          default: DIARIO
        totalMinutes:
          type: number
          description: >-
            Número de minutos referente ao trabalho total, incluindo intervalo
            (somente para dia flexível)
          example: 480
        cutoffTime:
          type: string
          description: >-
            Valor no formato HH:mm do horário de virada da data da jornada
            (somente para dia flexível)
          example: '01:00'
        interval:
          description: Intervalos
          allOf:
            - $ref: '#/components/schemas/CreateIntervaloDto'
      required:
        - type
    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
    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

````