Registros de ponto

Request

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-25T07:32",
            "type": "ajuste manual"
        },
        {
            "approved": true,
            "justification": "Registro via app com geolocalização",
            "time": "2024-09-25T11: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.

Security

BasicAuth

Query

employee_idstring

ID do funcionário. Obrigatório caso employee_external_id não esteja presente.

employee_external_idstring

ID externo do funcionário. Obrigatório caso employee_id não esteja presente.

start_datestring, (date)(DateParamModel)required

Data inicial.

Example:start_date=2023-09-27

end_datestring, (date)(DateParamModel)required

Data final.

Example:end_date=2023-09-27

curl -i -X GET \
  -u '<username>:<password>' \
  'https://api-docs.tiquetaque.app/_mock/openapi/times?employee_id=string&employee_external_id=string&start_date=2023-09-27&end_date=2023-09-27'

Responses

Resposta de sucesso, com detalhes dos registros de ponto. Os exemplos mostrams os valores de resposta possíveis.

Bodyapplication/json

employee_idstring

ID do funcionário. Obrigatório caso employee_external_id não esteja presente.

Example:"5f5bc225b511a6e44c2891f6"

employee_external_idstring

ID externo do funcionário. Obrigatório caso employee_id não esteja presente.

timesArray of objects

Lista de registros de ponto.

Response

{
  "employee_id": "5f5bc225b511a6e44c2891f6",
  "times": [
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … }
  ]
}