Calculadora Cyber Monday

Esta calculadora de Cyber Monday recebe o preço de lista original e o percentual de desconto anunciado, aplica sale_price igual a price vezes um menos percent dividido por cem, e devolve o preço de oferta junto com a economia para que um carrinho, um post de oferta ou um orçamento trave a cifra antes do checkout. Um desconto que ultrapassa cem por cento é rejeitado como invalid_input e não é faturado.

Como um markdown de Cyber Monday transforma um preço de lista em um preço de oferta

Um desconto de Cyber Monday é um percentual sobre um preço de lista publicado para um evento on-line de um dia, não um SKU novo e não um imposto. Os varejistas imprimem quarenta por cento em um notebook ou vinte e cinco por cento em uma TV; quem compra precisa do preço de oferta que de fato vai pagar e dos reais que vai economizar se fechar antes de a faixa expirar. Zero por cento é um resultado legítimo e devolve o preço original com economia nula em vez de um erro: um SKU que não entra no evento de Cyber Monday ainda pertence a um carrinho de comparação. Você envia os dois números; a calculadora os multiplica e arredonda o preço de oferta para duas casas decimais para que os goldens coincidam byte a byte entre runtimes. A identidade que esta calculadora usa é sale_price igual a price vezes um menos percent dividido por cem. A economia é o preço de lista menos esse preço de oferta, o que equivale a price vezes percent dividido por cem depois que o arredondamento monetário é aplicado primeiro na cifra de oferta para que as duas partes ainda somem a lista. price é a lista original em uma só moeda; percent é a taxa de Cyber Monday anunciada, digitada do jeito que as faixas imprimem, de modo que quarenta significa quarenta por cento, não quarenta centésimos. A forma decimal dessa taxa também volta como rate_decimal para que uma planilha conserve uma fração ao lado do percentual que as pessoas digitam. Cem por cento é um item promocional gratuito: sale_price fica em zero e savings iguala a lista. Um desconto que ultrapassa cem por cento não é um markdown neste contrato e é rejeitado como invalid_input, porque uma faixa que imprime cento e vinte por cento de desconto quase sempre é erro de dados, não um reembolso que você pretendia modelar. Este endpoint não raspa catálogos de varejistas, não empilha códigos de cupom sobre o percentual do evento, não adiciona imposto sobre vendas nem frete, e não converte moedas.

Contrato de entrada, forma da resposta e comportamento de erro

Se price for negativo, o tratador rejeita a solicitação porque um preço de lista não pode ser negativo; uma amostra gratuita de zero é permitida e gera preço de oferta nulo e economia nula. Se percent for negativo, o tratador rejeita com uma mensagem clara de que um desconto de Cyber Monday negativo não é permitido. Envie por POST um corpo JSON com dois números finitos obrigatórios. price é o preço de lista original em uma unidade monetária antes do markdown de Cyber Monday; os aliases original_price, list_price, original e amount apontam para o mesmo campo para que uma exportação de catálogo conserve os nomes de coluna. percent é o desconto de Cyber Monday anunciado como percentual, não como fração: quarenta significa quarenta por cento de desconto, vinte e cinco significa vinte e cinco por cento; aceitam-se os aliases discount, discount_percent, off e markdown. Cada campo numérico pode chegar como número JSON ou como string numérica. Campos ausentes, strings vazias e valores não finitos falham com invalid_input nomeando o campo. Se percent ultrapassar cem, o tratador rejeita com invalid_input afirmando que um desconto que ultrapassa cem por cento não é permitido — essas falhas não são faturadas. Zero por cento é válido e devolve sale_price igual a price. Cem por cento é válido e devolve sale_price de zero. Em caso de sucesso, o corpo ecoa price arredondado a duas casas e percent, depois informa rate_decimal como percent dividido por cem, sale_price como a cifra de checkout de Cyber Monday arredondada a duas casas, savings como price menos sale_price, e uma string formula que reitera a identidade. Exemplo: cento e noventa e nove com noventa e nove centavos a quarenta por cento produz um sale_price de cento e dezenove com noventa e nove e uma economia de oitenta. Combine o JSON com a sua própria regra sobre quais SKUs compartilham uma taxa — notebooks, jogos ou uma faixa de Cyber Monday para toda a loja — porque este endpoint multiplica os dois números que você envia; ele não consulta um varejista, não aplica uma pilha de cupons nem converte moedas. Mantenha as solicitações pequenas, fixe o sale_price arredondado nos testes e você obtém uma cifra de Cyber Monday reproduzível para planilhas, plugins LMS e workers de borda sem montar um motor de promoções próprio.

Onde uma calculadora de Cyber Monday se paga

Editores de sites de ofertas informam uma lista publicada e o percentual anunciado, depois fixam sale_price e savings para que um post não cite uma cifra inventada que depois discorde do checkout. Equipes de produto ligam o mesmo contrato a páginas de destino e teasers de e-mail que precisam mostrar o preço de oferta de Cyber Monday de um SKU de amostra sem chamar uma API de varejista. Como a implementação é parse de nível A puro, cada chamada bem-sucedida custa o preço-base publicado US$ 0,002 sem tokens de modelo e sem rede de saída. Mantenha percent entre zero e cem inclusive, fixe o sale_price arredondado nos testes e você obtém uma cifra de Cyber Monday reproduzível para teasers, carrinhos e workers de borda sem montar um motor de promoções próprio.