Visão geral
Apontamentos do ticket
Seção intitulada “Apontamentos do ticket”Apontamentos de um ticket: as horas de atendimento registradas por um agente. Toda requisição exige o cabeçalho Authorization: Bearer <chave de API>.
O ticket da rota é sempre resolvido na empresa da chave antes de qualquer outra verificação: um ticket de outra empresa, ou inexistente, responde 404 not_found, e um apontamento que não pertence ao ticket da rota responde o mesmo.
agentId é obrigatório na criação: o apontamento é hora de trabalho de alguém, e é por ele que o total por agente e os relatórios de desempenho somam. A escrita continua nascendo com origem API e guardando o identificador da chave no histórico do ticket.
Ler continua permitido em ticket na lixeira; escrever, não (422 ticket_deleted). Em ticket concluído ou fechado, criar apontamento é permitido — é assim que o agente lança a hora que trabalhou depois do encerramento —, mas editar e excluir respondem 422 ticket_not_editable, porque a chave não tem como ganhar a permissão de editar ticket encerrado.
As datas e horas do apontamento (date, startTime, endTime, timeSpent) não têm fuso: são valores de parede, como o agente os digita. Quem carrega instante de verdade são createdAt e updatedAt, carimbos do servidor — e eles são nulos em apontamento anterior a esta API, que nunca recebeu carga retroativa.