Regra base e camadas
Cada tipo de ingresso parte de um preço base, com camadas opcionais por dia da semana, temporada ou horário do dia. Se duas camadas se sobrepõem, vence a mais específica.
Preços e impostos
Um preço final. Uma dúzia de razões por trás.
Temporada, horário do dia, ocupação, antecedência, impostos compostos: cada camada é resolvida no momento da consulta, sempre na mesma ordem. Nunca existe um preço "estimado" separado do que realmente é cobrado.
- Custo → líquido → venda Cada um deriva do outro automaticamente; a margem nunca se perde de vista
- 2 Gatilhos de preço dinâmico: ocupação da vaga e antecedência da reserva
- Compostos Os impostos podem se encadear, cada um calculado sobre o resultado do anterior
Quatro peças. Um preço final.
Cada camada responde a uma pergunta diferente, e todas se combinam no mesmo cálculo.
Exceção de preço
Para uma data e horário exatos, como um evento especial, sem alterar a configuração habitual do resto do calendário.
Preço dinâmico
Ajusta o preço automaticamente conforme quão cheia está a vaga ou quão perto está a data, por porcentagem ou valor fixo, para cima ou para baixo.
Impostos por categoria
Cada imposto define sua própria base (venda, líquido ou margem), seu modo (incluído, aditivo ou interno), e se compõe sobre o anterior.
Como um preço é calculado, passo a passo
Cinco passos, exatamente nesta ordem, toda vez que alguém consulta um preço.
- 1
Exceção de preço
Existe uma exceção configurada para esta data e horário exatos? Ela vence qualquer regra recorrente, por mais específica que seja.
- 2
A regra base mais específica
Se não há exceção, aplica-se a regra recorrente que melhor combina: horário do dia pesa mais que temporada, que por sua vez pesa mais que a regra base geral.
- 3
Ajuste dinâmico
A regra de preço dinâmico ativa de maior prioridade que dispare para aquele momento é avaliada, e seu ajuste se aplica sobre o preço de venda.
- 4
Impostos em ordem
Cada imposto atribuído é calculado sobre sua própria base, na ordem configurada. Um marcado como composto é calculado sobre o resultado do anterior, não sobre o preço original.
- 5
Total final
Os impostos que realmente afetam o que o cliente paga são somados e arredondados para duas casas decimais. É exatamente isso que o checkout cobra.
O mesmo detalhamento que o checkout vê
Custo, líquido, preço de venda, a regra dinâmica aplicada se houve uma, e cada imposto listado separadamente com sua própria base e valor. Nunca um total sem explicação de onde veio.
GET /api/v1/products/observation-deck/calendar
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
{
"currency": "EUR",
"cost": 18,
"net": 28.1,
"base_retail": 40,
"retail": 44,
"applied_dynamic_rule": {
"trigger_type": "occupancy_threshold",
"adjustment_type": "percentage",
"adjustment_value": 10
},
"taxes": [
{
"name": "VAT",
"basis": "retail",
"application_mode": "additive",
"rate_percentage": 21,
"amount": 9.24
}
],
"customer_total": 53.24
}200 Preço resolvido
O imposto pode ser cobrado sobre a margem, não sobre o preço
Para revendedores na União Europeia, o regime de margem (TOMS) exige calcular o imposto sobre a diferença entre o que o cliente paga e o que o fornecedor recebe, não sobre o preço de venda completo. Qualquer categoria de imposto pode definir sua base como venda, líquido ou margem: esse cálculo não é um caso especial no código, é uma das três opções normais.
Perguntas frequentes
A exceção para aquela data e horário exatos sempre vence qualquer regra recorrente, por mais específica que seja essa regra.
Igual à disponibilidade: vence a mais específica. Uma regra vinculada ao horário do dia pesa mais que uma vinculada só à temporada, que por sua vez pesa mais que a regra base geral.
Sim, e cada um pode ter sua própria base (venda, líquido ou margem) e modo (incluído, aditivo ou interno), numa ordem explícita. Um imposto marcado como composto é calculado sobre o resultado do anterior, não sobre o preço original.
Não. Cada regra define seu próprio tipo de ajuste (porcentagem ou valor fixo) e um valor que pode ser negativo, então o mesmo mecanismo serve tanto para uma sobretaxa de última hora quanto para um desconto de reserva antecipada.
Depende de como cada imposto está configurado. Um "incluído" já faz parte do preço exibido; um "aditivo" é somado à parte no checkout; um "interno" nunca é cobrado do cliente, só é registrado para contabilidade. O detalhamento completo é exposto na API, não só o total.
Mais reservas. Mais canais. A mesma calma.
A Tiqory mantém disponibilidade, preços, pagamentos e acesso a trabalhar juntos enquanto a sua operação cresce. Conte-nos para onde vai; mostramos como chegar lá sem recomeçar.