Visão geral
Itens faturáveis do ticket
Seção intitulada “Itens faturáveis do ticket”Produtos e serviços lançados em um ticket: o que a aba Itens mostra, mais lançar, editar e excluir. 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.
O preço é o do momento do lançamento. O item copia e trava o preço do produto quando nasce, e totalPrice é quantity × unitPrice. Mudar o catálogo depois não mexe em item nenhum já lançado — é o que torna a fatura reproduzível.
Item que já entrou em uma fatura só se edita pela fatura. Enquanto invoiceId for nulo, o PATCH e o DELETE desta aba valem; a partir do momento em que o item está em uma fatura, os dois respondem 422 business_rule_violation dizendo para editá-lo pela fatura. Para listar só o que ainda se edita por aqui: filter[invoiceId][isNull]=true.
Lançar continua permitido em ticket concluído ou fechado, como na tela; editar e excluir respondem 422 ticket_not_editable nesse estado. Em ticket na lixeira, ler continua permitido e toda escrita responde 422 ticket_deleted.