Listar apontamentos (global)
Lista os apontamentos de todos os tickets da organização, com filtros por usuário, mesas, clientes, contratos e período.
Query parameters
Número da página a ser retornada
Número de itens retornados na página
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.
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.
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.
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.
Retorna os apontamentos realizados a partir dessa data. Obrigatório nesta rota.
Retorna os apontamentos realizados até essa data. Obrigatório nesta rota.
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
Changes
Changed in 2 of the 5 revisions of this API.5
- ○
added the new optional
queryrequest parameterclient_idsnew-optional-request-parameter
- ○
added the new optional
queryrequest parametercontract_idsnew-optional-request-parameter
- ○
added the required property
items/contractto the response with the200statusresponse-required-property-added
- ○
- ○
added the optional property
items/external_user_nameto the response with the200statusresponse-optional-property-added
- ○
added the optional property
items/valorization/shift_owner_ticketto the response with the200statusresponse-optional-property-added
- ○