Novidades

Mudanças da API do Trinks, da mais recente para a mais antiga.

22/10/2026

DELETE /v1/agendamentos/{agendamentoId}/assistente

• Endpoint adicionado: remove o profissional assistente de um agendamento.
• Regras: agendamento cancelado, já pago no Trinks ou pago antecipadamente online não pode ser alterado (400). Se o agendamento não tiver assistente, devolve 204 sem alterar nada.

GET /v1/produtos

• Novo campo categoria na resposta.
• Novo campo estoque na resposta.
• Novo campo fabricante na resposta.
• Novo campo informacoesComplementares na resposta: Informações complementares do produto; null quando não preenchidas.
• Novo campo precoVenda na resposta: Preço de venda ao cliente, em reais, por unidade do produto. Sem preço definido vem 0, que é o que o BackOffice grava; null só quando não há valor gravado.

POST /v1/agendamentos

• Regras:
  • Cliente, serviço e profissional precisam estar ativos, e o profissional precisa realizar o serviço.
  • A API não verifica conflito de horário nem disponibilidade do profissional. Para achar horário livre, use GET /v1/agendamentos/profissionais/{data}.
  • O valor gravado é o enviado; o preço do serviço não é aplicado.
  • assistenteId (opcional) é o profissional que auxilia no atendimento. Use o campo id de GET /v1/profissionais, o mesmo usado em profissionalId. Para informá-lo:
  • envie também profissionalId, com um profissional diferente do assistente;
  • o assistente precisa estar ativo e habilitado para auxiliar no serviço;
  • o profissional precisa estar configurado para realizar o serviço com assistente.
• Adicionada a nova propriedade de requisição opcional assistenteId.

PUT /v1/agendamentos/{agendamentoId}

• Regras:
  • Substitui todos os campos: profissionalId omitido tira o profissional e observacoes omitida apaga a observação atual. O status não muda por aqui.
  • Agendamento cancelado, já pago no Trinks ou pago antecipadamente online não pode ser editado (400).
  • Valem as mesmas regras de cliente, serviço, profissional e assistente da criação.
  • Exceção à substituição: assistenteId omitido mantém o assistente atual. Para remover, use DELETE /v1/agendamentos/{agendamentoId}/assistente.
  • Se o serviço ou o profissional mudarem, o assistente mantido precisa continuar válido para eles. Se não estiver, a edição responde 400 com o motivo; envie outro assistenteId ou remova o assistente e repita a edição.
• Adicionada a nova propriedade de requisição opcional assistenteId.

Textos da documentação revisados, sem mudança de regra: 1 descrição de endpoint.

15/10/2026

DELETE /v1/agendamentos/{agendamentoId}/etiquetas/{etiquetaId}

• Endpoint adicionado: remove uma etiqueta de um agendamento.
• Regras: agendamento que não existe no estabelecimento, ou etiqueta que não está associada a ele, responde 404.

GET /v1/agendamentos/{agendamentoId}/etiquetas

• Endpoint adicionado: lista as etiquetas de um agendamento.
• Regras: traz só as etiquetas ativas de tipo agendamento (1), todas de uma vez, em ordem alfabética. Agendamento que não existe no estabelecimento responde 404. Agendamento cancelado ou pago também tem etiquetas.

GET /v1/agendamentos/{agendamentoId}/etiquetas/{etiquetaId}

• Endpoint adicionado: obtém os detalhes de uma etiqueta associada ao agendamento.
• Regras: agendamento que não existe no estabelecimento, ou etiqueta que não está associada a ele, responde 404.

GET /v1/clientes/{clienteId}/etiquetas/{etiquetaId}

• Regras: cliente que não existe no estabelecimento responde 400; etiqueta não associada ao cliente responde 404.
• A resposta 400 passa a ser documentada.

POST /v1/agendamentos/{agendamentoId}/etiquetas/{etiquetaId}

• Endpoint adicionado: associa uma etiqueta a um agendamento.
• Regras:
  • A etiqueta precisa estar ativa e ser de tipo agendamento (1); etiqueta inexistente, inativa ou de tipo cliente (2) responde 404. Agendamento que não existe no estabelecimento também responde 404.
  • Agendamento cancelado ou já pago no Trinks também aceita etiqueta.
  • Se a etiqueta já está associada, devolve 204 sem duplicar.
• Efeitos: a etiqueta passa a aparecer em etiquetasAssociadas no GET /v1/transacoes quando o agendamento é pago.

28/09/2026

GET /v1/clube/assinaturas

• Novo campo clienteId na resposta: Id do cliente, o de GET /v1/clientes; null quando o assinante não é cliente do estabelecimento.

24/09/2026

Para sincronizar o histórico de vendas, consulte por janelas de até um ano. Datas anteriores a 01/01/2000 ou dataFim antes de dataInicio também respondem 400.

GET /v1/transacoes

• Concorrência: no máximo 2 chamadas simultâneas por conta neste endpoint. A partir da terceira, a resposta é 429 com o cabeçalho Retry-After.

GET /v1/vendas

• Período: quando dataInicio e dataFim são omitidos, a listagem devolve os últimos 90 dias. Quando só dataInicio é informada, o período vai até hoje. Quando só dataFim é informada, o período começa 90 dias antes dela. O intervalo entre as duas datas não pode passar de 366 dias; acima disso a resposta é 400.
• Paginação: pageSize acima de 50 é limitado a 50.
• Concorrência: no máximo 2 chamadas simultâneas por conta neste endpoint. A partir da terceira, a resposta é 429 com o cabeçalho Retry-After.
• A resposta 400 passa a ser documentada.

Em vários endpoints

• A resposta 429 passa a ser documentada em GET /v1/transacoes, GET /v1/transacoes/notas-fiscais, GET /v1/vendas.

Textos da documentação revisados, sem mudança de regra: 5 parâmetros.

16/09/2026

GET /v1/profissionais

• Novo parâmetro include: Dados opcionais a incluir na resposta. 1 = Foto, que preenche o campo fotoUrl de cada profissional. Padrão 0 = nenhum dado opcional. Também aceita o nome do valor, ex.: include=Foto. Valor não reconhecido é ignorado e a resposta vem sem os dados opcionais, sem erro.
• Novo campo fotoUrl na resposta.