---
title: "Listar custos de deslocamento do ticket"
method: GET
path: "/tickets/{ticket_number}/shift-entries"
tags: ["Tickets"]
---

# Listar custos de deslocamento do ticket

`GET /tickets/{ticket_number}/shift-entries`

## Request

- Base URL: `https://api.tiflux.com/api/v2`
- URL: `https://api.tiflux.com/api/v2/tickets/{ticket_number}/shift-entries`
- Auth: HTTP bearer

Lista os deslocamentos e as caronas apontados em um determinado ticket, um item por apontamento, ordenados pela data do apontamento.

- `value` é o valor gravado no lançamento, e não o preço atual do deslocamento cadastrado
- `kind` separa o deslocamento avulso (`loose`), o de contrato ou de grupo de contratos (`contract`) e a carona (`carona`), que aproveita o deslocamento de outro ticket e não tem custo próprio
- Os headers `X-Total-Loose-Value` e `X-Total-Contract-Value` somam os deslocamentos avulsos e de contrato do ticket inteiro (não só da página), sem os apontamentos em garantia e sem os lançamentos antigos gravados sem valor
- Os valores seguem a permissão **Visualizar valores dos tickets**: sem ela, `value` é retornado como `--`, exceto nos apontamentos criados pelo próprio usuário, e os headers de total retornam `--`

## Path parameters

- `ticket_number` integer, required

## Query parameters

- `offset` integer
- `limit` integer

## Response `200`

- object[]
  - `appointment_id` integer, required: Identificador do apontamento que registrou o deslocamento ou a carona
  - `date` string, required: Data do apontamento, no formato `AAAA-MM-DD`
  - `user` object, required: Usuário que realizou o apontamento
    - `id` integer, nullable: Identificador do usuário
    - `name` string, nullable: Nome do usuário
  - `kind` 'loose' | 'contract' | 'carona', nullable, required: Tipo do lançamento: - `loose`: deslocamento avulso, cobrado à parte do contrato - `contract`: deslocamento do contrato ou do grupo de contratos - `carona`: o apontamento aproveitou o deslocamento de outro ticket (`owner_ticket`), onde fica o custo Nulo quando o deslocamento cadastrado usado no apontamento não existe mais: não é possível saber se era avulso ou de contrato, e o lançamento fica fora dos totais
  - `shift` object, nullable, required: Deslocamento cadastrado usado no apontamento. Nulo na carona. Quando o cadastro não existe mais, traz só o `id` gravado no apontamento, com `name` nulo
    - `id` integer: Identificador
    - `name` string, nullable: Nome
  - `contract` object, nullable, required: Contrato do deslocamento. Nulo quando o deslocamento não é de contrato
    - `id` integer: Identificador
    - `name` string: Nome
  - `contract_group` object, nullable, required: Grupo de contratos do deslocamento. Nulo quando o deslocamento não é de grupo de contratos
    - `id` integer: Identificador
    - `name` string: Nome
  - `value` string, nullable, required: Valor do deslocamento gravado no lançamento, com duas casas decimais. Alterar o preço do cadastro depois não muda este valor, mas qualquer edição do apontamento grava de novo o valor com o preço atual do cadastro. É nulo em lançamentos antigos, gravados sem o valor. Na carona retorna `0.00`, porque o custo fica no ticket dono. Retorna `--` quando o usuário não possui a permissão **Visualizar valores dos tickets**, exceto nos apontamentos criados por ele mesmo
  - `guarantee` boolean, nullable, required: Indica se o apontamento é de garantia. Lançamentos em garantia ficam fora dos totais
  - `billed` boolean, nullable, required: Só no deslocamento avulso: indica se ele já foi faturado. Nulo nos tipos `contract` e `carona` e quando `kind` é nulo
  - `owner_ticket` object, nullable, required: Na carona, o ticket dono do deslocamento. Nulo nos demais tipos
    - `ticket_number` integer, nullable: Número do ticket. Nulo quando o ticket dono não existe mais
  - `carona_tickets` object[], required: Nos tipos `loose` e `contract`, os tickets que pegaram carona em um deslocamento deste ticket, em ordem de número, com a quantidade de apontamentos de cada um. O vínculo da carona é com o ticket, não com um deslocamento específico: quando o ticket tem mais de um deslocamento, a mesma lista aparece em todos eles. Vazio na carona
    - `ticket_number` integer, required: Número do ticket que pegou a carona
    - `appointments` integer, required: Quantidade de apontamentos de carona do ticket

## Other responses

- `401`: ### **Problemas com o token de autenticação**
- `403`: ### **Problemas com permissão** Essa resposta significa que o seu usuário está autenticado corretamente, porém, não possui a permissão ou licença necessária para acessar essa rota
- `404`: ### **Ticket não encontrado**
- `422`: ### **Problemas com os parâmetros informados**

## Changes

- **2026-11-18** `01e1e8e86812`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tiflux/apis/tiflux-official-api/changes/tickets/:ticket_number/shift-entries/get.md)

---

[API](https://skmtc.dev/tiflux/apis/tiflux-official-api.md) - [All operations](https://skmtc.dev/tiflux/apis/tiflux-official-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tiflux/apis/tiflux-official-api/revisions/01e1e8e86812?raw)
