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

# Busca um colaborador por ID

> Retorna **todos os dados consolidados** de um colaborador específico — dados pessoais, vínculo organizacional, configurações de turno, parâmetros, foto, contato.

**Retorno mais completo que `GET /colaborador`:** a listagem retorna campos resumidos para performance; este endpoint retorna o objeto cheio. Use após resolver o `colaboradorId` (via `/codigo/:codigo` ou `/cpf/:cpf`).

**404 vs. soft-delete:**
- Se o colaborador foi **excluído** (status `DEMITIDO`), o endpoint **ainda retorna** os dados — Pontua mantém histórico para folha e fiscalização.
- Retorna 404 só se o ID não existe naquela UN.

**LGPD:** alguns campos sensíveis (RG, CPF, dados bancários) podem aparecer mascarados dependendo da política da UN. Para a versão completa, use sempre HTTPS e auditoria do uso da chave.



## OpenAPI

````yaml https://api.pre.pontua.tech/api/public/doc-json get /colaborador/{colaboradorId}
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}:
    get:
      tags:
        - Colaborador
      summary: Busca um colaborador por ID
      description: >-
        Retorna **todos os dados consolidados** de um colaborador específico —
        dados pessoais, vínculo organizacional, configurações de turno,
        parâmetros, foto, contato.


        **Retorno mais completo que `GET /colaborador`:** a listagem retorna
        campos resumidos para performance; este endpoint retorna o objeto cheio.
        Use após resolver o `colaboradorId` (via `/codigo/:codigo` ou
        `/cpf/:cpf`).


        **404 vs. soft-delete:**

        - Se o colaborador foi **excluído** (status `DEMITIDO`), o endpoint
        **ainda retorna** os dados — Pontua mantém histórico para folha e
        fiscalização.

        - Retorna 404 só se o ID não existe naquela UN.


        **LGPD:** alguns campos sensíveis (RG, CPF, dados bancários) podem
        aparecer mascarados dependendo da política da UN. Para a versão
        completa, use sempre HTTPS e auditoria do uso da chave.
      operationId: ColaboradorController_findOne
      parameters:
        - name: colaboradorId
          required: true
          in: path
          description: Id do colaborador
          schema:
            example: a2f2cbed-e141-465c-a769-f1591be5f35c
            type: string
      responses:
        '200':
          description: Objeto completo do colaborador com todos os vínculos e configurações
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetColaboradorDto'
        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:
    GetColaboradorDto:
      type: object
      properties:
        colaboradorId:
          type: string
          description: ID referente ao Colaborador
          example: b5887a64-6aa1-43e8-b233-ffadc7f92ca6
        nome:
          type: string
          description: Nome do colaborador
          example: Douglas Coelho
        tipoColaborador:
          type: string
          description: Identificação se será um Colaborador CLT ou Prestador de Serviço
          enum:
            - PRESTADOR_SERVICO
            - CLT
            - EXTERNO
            - API
          default: CLT
        tipoIdentificacao:
          type: string
          description: Identificação se o documento é um CPF ou CNPJ
          enum:
            - CNPJ
            - CPF
          default: CPF
        numeroDocumento:
          type: string
          description: CPF ou CNPJ
          example: 152.175.100-56
        unidadeNegocioId:
          type: string
          description: ID da unidade de negocio do colaborador
          example: b5887a64-6aa1-43e8-b233-ffadc7f92ca6
        unidadeNegocio:
          type: string
          description: Nome da unidade de negocio do colaborador
          example: Tron
        situacao:
          type: string
          description: Situação do empregado
          enum:
            - ATIVO
            - INATIVO
            - RASCUNHO
          default: ATIVO
        createdAt:
          format: date-time
          type: string
          description: Data de criação
          example: '2026-05-11T13:08:56.467Z'
        updatedAt:
          format: date-time
          type: string
          description: Data de update
          example: '2026-05-11T13:08:56.467Z'
        acesso:
          description: Acessos do Colaborador
          allOf:
            - $ref: '#/components/schemas/GetAcessoColaboradorDto'
        definicoes:
          description: Definições do Colaborador
          allOf:
            - $ref: '#/components/schemas/GetDefinicoesColaboradorDto'
        preferencias:
          description: Prefetencias do Colaborador
          allOf:
            - $ref: '#/components/schemas/GetPreferenciaColaboradorDto'
        alocacao:
          description: Alocação do Colaborador
          allOf:
            - $ref: '#/components/schemas/GetAlocacaoColaboradorDto'
        complemento:
          description: Complementos do Colaborador
          allOf:
            - $ref: '#/components/schemas/GetComplementoColaboradorDto'
        dados:
          description: Dados do Colaborador
          allOf:
            - $ref: '#/components/schemas/GetDadosCadastraisColaboradorDto'
        foto:
          description: Fotos do Colaborador
          allOf:
            - $ref: '#/components/schemas/GetFotoColaboradorDto'
        facialId:
          description: Dados do cadastro de reconhecimento facial
          allOf:
            - $ref: '#/components/schemas/FacialId'
      required:
        - colaboradorId
        - nome
        - tipoColaborador
        - tipoIdentificacao
        - numeroDocumento
        - unidadeNegocioId
        - unidadeNegocio
        - situacao
        - createdAt
        - updatedAt
        - acesso
        - definicoes
        - preferencias
        - alocacao
        - complemento
        - dados
        - foto
    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
    GetAcessoColaboradorDto:
      type: object
      properties:
        colaboradorId:
          type: string
          description: ID referente ao cargo
          example: b5887a64-6aa1-43e8-b233-ffadc7f92ca6
        numeroDocumento:
          type: string
          description: CPF ou CNPJ
          example: '71055398712'
        usarConfigPadrao:
          type: boolean
          description: Status sobre o uso das configurações padrões estabelecidas
          example: true
        liberarAcesso:
          type: boolean
          description: Liberar acesso ao sistema ao colaborador
          example: true
        enviarAcessoEmail:
          type: boolean
          description: Enviar acesso ao sistema por EMAIL ao colaborador
          example: true
        enviarAcessoSms:
          type: boolean
          description: Enviar acesso ao sistema por SMS ao colaborador
          example: true
        solicitarCadastroFacial:
          type: boolean
          description: Solicitar Cadastro da Facial ao colaborador
          example: true
        nivelAcesso:
          type: string
          description: "Nível\tde acesso às permissões do sistema, dado ao usuário"
          default: USER
          enum:
            - ADMIN
            - GESTOR
            - USER
        biometriaAtiva:
          type: boolean
          description: Biometria
          example: true
        cadastroReconhecimentoFacial:
          description: Fotos para Reconhecimento Facial
          deprecated: true
          type: array
          items:
            type: string
        step:
          type: string
          description: Path da próxima pagina
          enum:
            - DADOS
            - COMPLEMENTO
            - ALOCACAO
            - PREFERENCIA
            - DEFINICOES
            - ACESSO
            - CONCLUIDO
          default: CONCLUIDO
      required:
        - colaboradorId
        - numeroDocumento
        - usarConfigPadrao
        - liberarAcesso
        - enviarAcessoEmail
        - enviarAcessoSms
        - solicitarCadastroFacial
        - nivelAcesso
        - biometriaAtiva
        - cadastroReconhecimentoFacial
        - step
    GetDefinicoesColaboradorDto:
      type: object
      properties:
        logo:
          type: string
          description: Url para download da foto
          example: https://s3-bucket.s3.amazonaws.com/files/tenant_x/file.jpg
        batidaPonto:
          type: string
          description: Permissões de batida de ponto que o colaborador terá
          example: Padrão da Empresa de BH
        batidaPontoId:
          type: string
          description: ID da batida de ponto que o colaborador terá
          example: 56aw4d61.201
        regrasPonto:
          type: string
          description: Nome da regra de ponto atribuida ao empregado
          example: Regra de horas extras da Empresa de BH
        regrasPontoId:
          type: string
          description: Id da regra de ponto atribuida ao empregado
          example: aljdfh-awdkjhaw-awd
        step:
          type: string
          description: Path da próxima pagina
          enum:
            - DADOS
            - COMPLEMENTO
            - ALOCACAO
            - PREFERENCIA
            - DEFINICOES
            - ACESSO
            - CONCLUIDO
          default: ACESSO
      required:
        - logo
        - batidaPonto
        - batidaPontoId
        - regrasPonto
        - regrasPontoId
        - step
    GetPreferenciaColaboradorDto:
      type: object
      properties:
        dataAdmissao:
          format: date-time
          type: string
          description: Data de admissão do colaborador
          example: null
        dataInicio:
          format: date-time
          type: string
          description: Data de inicio do colaborador
          example: null
        dataDemissao:
          format: date-time
          type: string
          description: Data de demissão do colaborador
          example: null
        calendarioId:
          type: string
          description: >-
            ID referente ao calendário de trabalho da empresa, onde colocorá o
            colaborador
          example: b5887a64-6aa1-43e8-b233-ffadc7f92ca6
        turno:
          description: Turno do empregado
          allOf:
            - $ref: '#/components/schemas/Turno'
        step:
          type: string
          description: Path da próxima pagina
          enum:
            - DADOS
            - COMPLEMENTO
            - ALOCACAO
            - PREFERENCIA
            - DEFINICOES
            - ACESSO
            - CONCLUIDO
          default: DEFINICOES
      required:
        - dataAdmissao
        - dataInicio
        - calendarioId
        - turno
        - step
    GetAlocacaoColaboradorDto:
      type: object
      properties:
        numeroPrevidenciario:
          type: string
          description: >-
            Número do tipo de vínculo previdenciário do empregado,  (NIS, PIS,
            PASEP )
          example: N586692225
        tipoVinculo:
          type: string
          description: Tipo de vínculo
          default: CLT
          enum:
            - CLT
            - APRENDIZ
            - ESTAGIO
            - AUTONOMO
            - INTERMITENTE
            - OUTROS
        adicionalInsalubridade:
          type: boolean
          description: Se o empregado terá adicional de Insalubridade
          example: false
        valorInsalubridade:
          type: string
          description: Selecionar o grau de Insalubridade
          default: GRAU_MEDIO_20
          enum:
            - GRAU_MINIMO_10
            - GRAU_MEDIO_20
            - GRAU_MAXIMO_40
        adicionalPericulosidade:
          type: boolean
          description: Se o empregado terá adicional de Insalubridade
          example: false
        cargo:
          description: Cargo referente ao colaborador
          allOf:
            - $ref: '#/components/schemas/Cargo'
        departamento:
          description: Departamento referente ao colaborador
          allOf:
            - $ref: '#/components/schemas/Departamento'
        equipe:
          description: Equipe referente ao colaborador
          allOf:
            - $ref: '#/components/schemas/Equipe'
        remuneracao:
          type: number
          description: Salário do empregado
          example: 7400
        tipoRemuneracao:
          type: string
          description: Tipo de remuneraçã do empregado
          enum:
            - SALARIO_FIXO
            - POR_HORA
            - DIARIAS
            - PRESTACAO_SERVICO
          default: SALARIO_FIXO
        fusoHorario:
          type: string
          description: Fuso horário
          default: SAO_PAULO
          enum:
            - MANAUS
            - NORONHA
            - RIO_BRANCO
            - SAO_PAULO
        localTrabalho:
          description: Local de Trabalho do colaborador
          allOf:
            - $ref: '#/components/schemas/LocalTrabalho'
        centroCusto:
          description: Centro de custo do colaborador
          allOf:
            - $ref: '#/components/schemas/CentroCusto'
        step:
          type: string
          description: Path da próxima pagina
          enum:
            - DADOS
            - COMPLEMENTO
            - ALOCACAO
            - PREFERENCIA
            - DEFINICOES
            - ACESSO
            - CONCLUIDO
          default: PREFERENCIA
      required:
        - cargo
        - departamento
        - equipe
        - localTrabalho
        - centroCusto
        - step
    GetComplementoColaboradorDto:
      type: object
      properties:
        numeroPrevidenciario:
          type: string
          description: Número do tipo de vínculo previdenciário do empregado
          example: N586692225
        matriculaEsocial:
          type: string
          description: Matrícula do eSocial
          example: xxxxxxxxx
        matriculaInterna:
          type: string
          description: Matrícula interna da empresa
          example: '49172594718'
        email:
          type: string
          description: Email do empregado
          example: douglas@pontua.com.br
        telefoneCelular:
          type: string
          description: Número do telefone celular do empregado
          example: '62993610391'
        endereco:
          description: Endereço da unidade de negócio
          allOf:
            - $ref: '#/components/schemas/EnderecoEntity'
        step:
          type: string
          description: Path da próxima pagina
          enum:
            - DADOS
            - COMPLEMENTO
            - ALOCACAO
            - PREFERENCIA
            - DEFINICOES
            - ACESSO
            - CONCLUIDO
          default: ALOCACAO
      required:
        - email
        - telefoneCelular
        - endereco
        - step
    GetDadosCadastraisColaboradorDto:
      type: object
      properties:
        tipoColaborador:
          type: string
          description: Identificação se será um Colaborador CLT ou Prestador de Serviço
          enum:
            - CNPJ
            - CPF
          default: CPF
        numeroDocumento:
          type: string
          description: CPF ou CNPJ
          example: '71055398712'
        unidadeNegocio:
          type: string
          description: Nome da unidade de negocio
          example: c9f447fe-f97f-4f24-974d-9f92eb3049dc
        colaboradorId:
          type: string
          description: ID referente ao colaborador
          example: b5887a64-6aa1-43e8-b233-ffadc7f92ca6
        estadoCivil:
          type: string
          description: Estado civil
          default: SOLTEIRO
          enum:
            - SOLTEIRO
            - CASADO
            - SEPARADO
            - DIVORCIADO
            - VIUVO
        genero:
          type: string
          description: Gênero
          default: MASCULINO
          enum:
            - MASCULINO
            - FEMININO
            - OUTRO
        dataNascimento:
          format: date-time
          type: string
          description: Data de nascimento
          example: '2026-05-11T13:08:56.463Z'
        nomeCompleto:
          type: string
          description: Nome completo do colaborador
          example: Douglas Fernandez Coelho
        nomeOuRazaoSocial:
          type: string
          description: Nome ou razão social
          example: Douglas Vitor
        nomeFantasia:
          type: string
          description: Nome fantasia
          example: STW Tecnologia
        inscricaoEstadual:
          type: string
          description: Inscrição estadual
          example: '123456789'
        isentoInscricaoEstadual:
          type: boolean
          description: Inscrição estadual está isenta?
          default: false
        inscricaoMunicipal:
          type: string
          description: Inscrição municipal
          example: '987654321'
        isentoInscricaoMunicipal:
          type: boolean
          description: Inscrição municipal está isenta?
          default: false
        step:
          type: string
          description: Path da próxima pagina
          enum:
            - DADOS
            - COMPLEMENTO
            - ALOCACAO
            - PREFERENCIA
            - DEFINICOES
            - ACESSO
            - CONCLUIDO
          default: COMPLEMENTO
      required:
        - tipoColaborador
        - numeroDocumento
        - unidadeNegocio
        - colaboradorId
        - step
    GetFotoColaboradorDto:
      type: object
      properties:
        url:
          type: string
          description: Url para download da foto
          example: https://s3-bucket.s3.amazonaws.com/files/tenant_x/file.jpg
      required:
        - url
    FacialId:
      type: object
      properties:
        id:
          type: string
          description: ID referente do cadastro da FacialId no nosso banco
          example: b5887a64-6aa1-43e8-b233-ffadc7f92ca6
        codigoFacial:
          type: string
          description: Código referente ao rosto da pessoa na FacialId
          example: FULANO.10
        situacao:
          type: string
          description: Stituação de cadastro na FacialId
          example: Ativo
        dataExpiracao:
          format: date-time
          type: string
          description: Data de expiração das fotos enviadas para o cadastro
          example: '2025-07-23T00:00:00.000Z'
    Turno:
      type: object
      properties:
        turnoId:
          type: string
          description: ID referente ao turno, onde colocorá o colaborador
          example: b5887a64-6aa1-43e8-b233-ffadc7f92ca6
        tipoTurno:
          type: string
          description: Tipo do turno
          enum:
            - turnoFixo
            - turnoFlexivel
            - turnoRevezamento
            - turnoCiclo
          default: turnoFixo
        nome:
          type: string
          description: Nome do turno
          example: Horário comercial
        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:
        - turnoId
        - tipoTurno
        - nome
        - createdAt
        - updatedAt
    Cargo:
      type: object
      properties:
        cargoId:
          type: string
          description: ID referente ao cargo
          example: b5887a64-6aa1-43e8-b233-ffadc7f92ca6
        nome:
          type: string
          description: Nome do Cargo
          example: Analista de Marketing
      required:
        - cargoId
        - nome
    Departamento:
      type: object
      properties:
        departamentoId:
          type: string
          description: ID referente ao departamento
          example: c9f447fe-f97f-4f24-974d-9f92eb3049dc
        nome:
          type: string
          description: Nome do departamento
          example: Desenvolvimento
      required:
        - departamentoId
        - nome
    Equipe:
      type: object
      properties:
        equipeId:
          type: string
          description: ID referente à equipe
          example: b5887a64-6aa1-43e8-b233-ffadc7f92ca6
        nome:
          type: string
          description: Nome da equipe
          example: Squad Plataforma
      required:
        - equipeId
        - nome
    LocalTrabalho:
      type: object
      properties:
        localTrabalhoId:
          type: string
          description: ID referente ao local de trabalho
          example: b5887a64-6aa1-43e8-b233-ffadc7f92ca6
        nome:
          type: string
          description: Nome do local de trabalho
          example: Sede Goiânia
      required:
        - localTrabalhoId
        - nome
    CentroCusto:
      type: object
      properties:
        centroCustoId:
          type: string
          description: ID referente ao centro de custo
          example: b5887a64-6aa1-43e8-b233-ffadc7f92ca6
        nome:
          type: string
          description: Nome do centro de custo
          example: Tecnologia / R&D
      required:
        - centroCustoId
        - nome
    EnderecoEntity:
      type: object
      properties:
        rua:
          type: string
          example: Rua da Felicidade
        numero:
          type: string
          example: s/n
        complemento:
          type: string
          example: Sombra da Tarde
        bairro:
          type: string
          example: Jardim America
        cidade:
          type: string
          example: Barreiras
        estado:
          type: string
          example: BA
        cep:
          type: string
          example: '47803658'
      required:
        - rua
        - numero
        - cidade
        - estado
        - cep

````