Tickets

Listar custos de deslocamento do ticket

Changed on

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 --
get/tickets/{ticket_number}/shift-entries

Request

  • Base URL
    https://api.tiflux.com/api/v2
  • Auth
    HTTP bearer

Path parameters

ticket_numberinteger required

Número do ticket

Query parameters

offsetinteger

Número da página a ser retornada

limitinteger

Número de itens retornados na página

Response

appointment_idinteger required

Identificador do apontamento que registrou o deslocamento ou a carona

datestring required

Data do apontamento, no formato AAAA-MM-DD

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

valuestring 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

guaranteeboolean nullable required

Indica se o apontamento é de garantia. Lançamentos em garantia ficam fora dos totais

billedboolean nullable required

Só no deslocamento avulso: indica se ele já foi faturado. Nulo nos tipos contract e carona e quando kind é nulo

Changes