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

# Altera status do colaborador (ATIVO/INATIVO/AFASTADO/DEMITIDO)

> Modifica o **status** de um colaborador, que controla se ele tem jornada ativa, é elegível a folha e se aparece em listas filtradas.

**Status disponíveis:**
- `ATIVO` — quadro normal: aparece em escalas, tem jornada calculada, entra em folha
- `INATIVO` — usuário pausado, sem geração de jornada (raro fora de portarias específicas)
- `AFASTADO` — afastamento médico, licença, etc.: jornada gera `ATESTADO` automaticamente; ainda em folha
- `DEMITIDO` — desligamento (soft-delete): para de gerar jornada **a partir da data informada**, mantém histórico para fiscalização

**Demissão retroativa:** ao definir `DEMITIDO` com `dataMudanca` no passado, jornadas após a data viram `SEM_JORNADA` e relatórios são recalculados. **Cuidado** — se o período já está em fechamento concluído, o ajuste pode exigir reabertura.

**Reverter demissão:** mudar de `DEMITIDO` para `ATIVO` é permitido. O histórico de demissão fica no audit log; jornadas voltam a gerar a partir da data de retorno.

Veja [Lidar com Fechamento](/guias-praticas/lidar-com-fechamento) antes de mudar status para período já fechado.



## OpenAPI

````yaml https://api.pre.pontua.tech/api/public/doc-json patch /colaborador/{colaboradorId}/status
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:
  /colaborador/{colaboradorId}/status:
    patch:
      tags:
        - Colaborador
      summary: Altera status do colaborador (ATIVO/INATIVO/AFASTADO/DEMITIDO)
      description: >-
        Modifica o **status** de um colaborador, que controla se ele tem jornada
        ativa, é elegível a folha e se aparece em listas filtradas.


        **Status disponíveis:**

        - `ATIVO` — quadro normal: aparece em escalas, tem jornada calculada,
        entra em folha

        - `INATIVO` — usuário pausado, sem geração de jornada (raro fora de
        portarias específicas)

        - `AFASTADO` — afastamento médico, licença, etc.: jornada gera
        `ATESTADO` automaticamente; ainda em folha

        - `DEMITIDO` — desligamento (soft-delete): para de gerar jornada **a
        partir da data informada**, mantém histórico para fiscalização


        **Demissão retroativa:** ao definir `DEMITIDO` com `dataMudanca` no
        passado, jornadas após a data viram `SEM_JORNADA` e relatórios são
        recalculados. **Cuidado** — se o período já está em fechamento
        concluído, o ajuste pode exigir reabertura.


        **Reverter demissão:** mudar de `DEMITIDO` para `ATIVO` é permitido. O
        histórico de demissão fica no audit log; jornadas voltam a gerar a
        partir da data de retorno.


        Veja [Lidar com Fechamento](/guias-praticas/lidar-com-fechamento) antes
        de mudar status para período já fechado.
      operationId: ColaboradorController_updateStatus
      parameters:
        - name: colaboradorId
          required: true
          in: path
          description: Id do colaborador
          schema:
            example: a2f2cbed-e141-465c-a769-f1591be5f35c
            type: string
      requestBody:
        required: true
        description: Novo status, data de mudança e observação opcional
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateStatusColaboradorDto'
      responses:
        '200':
          description: Atualizado com sucesso
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OkDto'
        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:
    UpdateStatusColaboradorDto:
      type: object
      properties:
        status:
          type: string
          description: Status do colaborador
          enum:
            - ATIVO
            - INATIVO
          default: ATIVO
        dataDemissao:
          format: date-time
          type: string
          description: Data de demissão
          example: '2024-07-23T00:00:00.000Z'
      required:
        - status
    OkDto:
      type: object
      properties:
        status:
          type: boolean
          description: Status da operação
          example: true
        mensagem:
          type: string
          description: Mensagem de retorno
          example: OK
      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

````