Apontamentos

Listar apontamentos (global)

Lista os apontamentos de todos os tickets da organização, com filtros por usuário, mesas, clientes, contratos e período.

get/appointments

Query parameters

offsetinteger

Número da página a ser retornada

limitinteger

Número de itens retornados na página

user_idsinteger[]

Filtrar pelos IDs dos usuários que realizaram os apontamentos, separados por vírgula (,) e sem espaços: user_ids=1,2,3

  • O número máximo de itens permitidos é 15.

  • Valores duplicados não são permitidos.

  • Requer a permissão <span style="margin:1px; padding:1px 8px; font-weight:bold; border-radius:12px; background-color: var(--light-red, var(--input-bg)); color:var(--red); border:1px solid var(--red)"><!--?lit$8458964218$-->Visualizar usuários nos relatórios de atendentes</span>. Sem essa permissão, este parâmetro é ignorado e a listagem retorna sempre apenas os apontamentos do próprio usuário autenticado, independente do valor informado.

desk_idsinteger[]

Filtrar apontamentos pelas mesas dos tickets vinculados, separados por vírgula (,) e sem espaços: desk_ids=1,2,3

  • O número máximo de itens permitidos é 15.

  • Valores duplicados não são permitidos.

client_idsinteger[]

Filtrar apontamentos pelos clientes dos tickets vinculados, separados por vírgula (,) e sem espaços: client_ids=1,2,3

  • O número máximo de itens permitidos é 15.

  • Valores duplicados não são permitidos.

contract_idsinteger[]

Filtrar apontamentos vinculados aos contratos informados. Apontamentos sem contrato não são retornados quando este parâmetro é utilizado. Para contratos da modalidade compartilhado, também é aceito o id do grupo de contratos (o mesmo id retornado pela listagem /contracts para esses casos). A filtragem é resolvida automaticamente para todos os contratos membros do grupo, separados por vírgula (,) e sem espaços: contract_ids=1,2,3

  • O número máximo de itens permitidos é 15.

  • Valores duplicados não são permitidos.

start_datestring date required

Retorna os apontamentos realizados a partir dessa data. Obrigatório nesta rota.

end_datestring date required

Retorna os apontamentos realizados até essa data. Obrigatório nesta rota.

include_valorizationboolean

Com esse parâmetro é possível incluir as informações de valorização de cada apontamento. Ao informar esse parâmetro como true, será adicionado um atributo de nome valorization no corpo da resposta dessa requisição. Por padrão (false), o campo valorization não é retornado.

Response

idinteger required

Identificador do apontamento

datestring date required

Dia em que o atendimento foi realizado

init_timestring required

Horário de início do atendimento. No formato HH:MM

end_timestring required

Horário de fim do atendimento. No formato HH:MM

descriptionstring required

Descrição do apontamento

external_user_namestring nullable

Nome do usuário que executou a ação em uma ferramenta externa

Changes

Changed in 2 of the 5 revisions of this API.5

    • added the new optional query request parameter client_ids

      new-optional-request-parameter

    • added the new optional query request parameter contract_ids

      new-optional-request-parameter

    • added the required property items/contract to the response with the 200 status

      response-required-property-added

    • added the optional property items/external_user_name to the response with the 200 status

      response-optional-property-added

    • added the optional property items/valorization/shift_owner_ticket to the response with the 200 status

      response-optional-property-added