# Registros de ponto

Retorna os detalhes dos registros para o funcionário solicitado, dentro do intervalo, o formato da resposta é o seguinte:
 
{
    "employee_id": "5f5bc225b511a6e44c2891f6",
    "times": [
        { 
            "approved": true, 
            "justification": "Esqueci de registrar", 
            "time": "2024-09-02T07:32", 
            "type": "ajuste manual" 
        },
        { 
            "approved": true, 
            "justification": "Registro via app com geolocalização", 
            "time": "2024-09-02T11:59", 
            "type": "app" 
        } 
    ] 
}


 | Chave         | Descrição                                                                           | 
|---------------|-------------------------------------------------------------------------------------| 
| employee      | ID do funcionário.                                                                  | 
| times         | Lista de registros de ponto encontrados para o funcionário.                         | 
 Os valores para cada um dos itens da lista de times são: 
* approved: [true, false]. Indica se o registro já está aprovado pelo gestor. 
* type: [pré-assinalado, aparelho, web, desconsiderado,app, reconhecimento facial, ajuste manual, offline, registro externo] 
* time: Data e hora no format YYYY-MM-DDTHH:MM 
* justification: justificativa do registro, caso exista.

Endpoint: GET /times
Version: 2.1
Security: BasicAuth

## Query parameters:

  - `employee_id` (string)
    ID do funcionário. Obrigatório caso employee_external_id não esteja presente.

  - `employee_external_id` (string)
    ID externo do funcionário. Obrigatório caso employee_id não esteja presente.

  - `start_date` (string, required)
    Data inicial.
    Example: "YYYY-MM-DD"

  - `end_date` (string, required)
    Data final.
    Example: "YYYY-MM-DD"

## Response 200 fields (application/json):

  - `employee_id` (string)
    ID do funcionário. Obrigatório caso employee_external_id não esteja presente.
    Example: "5f5bc225b511a6e44c2891f6"

  - `employee_external_id` (string)
    ID externo do funcionário. Obrigatório caso employee_id não esteja presente.

  - `times` (array)
    Lista de registros de ponto.

  - `times.approved` (boolean)
    Indica se o registro está aprovado ou pendente de aprovação para fins de cálculos.

  - `times.justification` (string)
    Informações adicionais do motivo ou origem do registro.

  - `times.time` (string)
    Data e hora do registro de ponto.
    Example: "2024-09-30T10:19"

  - `times.type` (string)
    Origem do registro, os valores possíveis são pré-assinalado, aparelho, web, desconsiderado, app, reconhecimento facial, offline, ajuste manual, registro externo, N/D
    Enum: "pré-assinalado", "aparelho", "web", "desconsiderado", "app", "reconhecimento facial", "offline", "ajuste manual", "registro externo", "N/D"

  - `times.location` (array)
    Example: [[-32.04910884654619,-54.188595456807924]]

## Response 401 fields (application/json):

  - `_code` (integer)
    Código de erro interno.

  - `_status` (string)
    Example: "ERR"

  - `_error` (object)

  - `_error.code` (integer)
    Codigo de erro HTTP.

  - `_error.message` (string)
    Mensagem de erro interna.

  - `_error._ui_message` (string)
    Mensagem de erro para o usuário.

## Response 404 fields (application/json):

  - `_code` (integer)
    Código de erro interno.

  - `_status` (string)
    Example: "ERR"

  - `_error` (object)

  - `_error.code` (integer)
    Codigo de erro HTTP.

  - `_error.message` (string)
    Mensagem de erro interna.

  - `_error._ui_message` (string)
    Mensagem de erro para o usuário.

## Response 409 fields (application/json):

  - `_code` (integer)
    Código de erro interno.

  - `_status` (string)
    Example: "ERR"

  - `_error` (object)

  - `_error.code` (integer)
    Codigo de erro HTTP.

  - `_error.message` (string)
    Mensagem de erro interna.

  - `_error._ui_message` (string)
    Mensagem de erro para o usuário.

## Response 422 fields (application/json):

  - `_code` (integer)
    Código de erro interno.

  - `_status` (string)
    Example: "ERR"

  - `_error` (object)

  - `_error.code` (integer)
    Codigo de erro HTTP.

  - `_error.message` (string)
    Mensagem de erro interna.

  - `_error._ui_message` (string)
    Mensagem de erro para o usuário.