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

# Resolve `código` interno do colaborador para `colaboradorId`

> Endpoint utilitário que mapeia o **código numérico interno** (visível ao usuário, ex.: "001234") para o **`colaboradorId` (UUID)** usado em todas as outras rotas.

**Quando usar:**
- Sua integração já trabalha com o código (impresso em crachá, emitido pela folha) e precisa traduzir para chamar outros endpoints
- Importação a partir de sistema externo que só tem o código

**Regras:**
- O código é **único por unidade de negócio** — duas UNs podem ter o mesmo código.
- Códigos são gerados sequencialmente na criação ou pelo cadastro manual.
- Endpoint retorna 404 se o código não existir.

**Padrão recomendado:** se você sincroniza dados frequentemente, mantenha um cache local `código → colaboradorId` em vez de chamar este endpoint a cada operação.



## OpenAPI

````yaml https://api.pre.pontua.tech/api/public/doc-json get /colaborador/codigo/{codigo}
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/codigo/{codigo}:
    get:
      tags:
        - Colaborador
      summary: Resolve `código` interno do colaborador para `colaboradorId`
      description: >-
        Endpoint utilitário que mapeia o **código numérico interno** (visível ao
        usuário, ex.: "001234") para o **`colaboradorId` (UUID)** usado em todas
        as outras rotas.


        **Quando usar:**

        - Sua integração já trabalha com o código (impresso em crachá, emitido
        pela folha) e precisa traduzir para chamar outros endpoints

        - Importação a partir de sistema externo que só tem o código


        **Regras:**

        - O código é **único por unidade de negócio** — duas UNs podem ter o
        mesmo código.

        - Códigos são gerados sequencialmente na criação ou pelo cadastro
        manual.

        - Endpoint retorna 404 se o código não existir.


        **Padrão recomendado:** se você sincroniza dados frequentemente,
        mantenha um cache local `código → colaboradorId` em vez de chamar este
        endpoint a cada operação.
      operationId: ColaboradorController_getCodigoColaborador
      parameters:
        - name: codigo
          required: true
          in: path
          schema:
            type: number
      responses:
        '200':
          description: Apenas `id` do colaborador (UUID)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IdDto'
        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:
    IdDto:
      type: object
      properties:
        id:
          type: string
          description: Identificador (ID)
          example: 5f9b8b1f-1e0d-4b7b-8c8d-4e8f0b8d8d4a
      required:
        - id
    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

````