Calcular um desconto de preço em níveis

Nível de programação: iniciante
Duração: 10 minutos
Tipo de projeto: função personalizada

Objetivos

• Entender o que a solução faz.
• Entender o que os serviços do Google Apps Script fazem na solução.
• Configurar o script.
• Executar o script.

Sobre esta solução

Se você oferece um sistema de preços por níveis para seus clientes, essa função personalizada facilita o cálculo dos valores de desconto para seus preços no Planilhas Google.

Embora seja possível usar a função integrada SUMPRODUCT para fazer um cálculo de preços por níveis, o uso de SUMPRODUCT é mais complexo e menos flexível do que a função personalizada dessa solução.

Como funciona

Um modelo de preços por níveis significa que o custo de bens ou serviços diminui com base na quantidade comprada.

Por exemplo, imagine que você tenha dois níveis: um que varia de US $0 a US$ 500 e tem um desconto de 10%, e outro que varia de US $501 a US$ 1.000 e tem um desconto de 20%. Se o preço total para o qual você precisa calcular um desconto for de US $700, o script vai multiplicar os primeiros US $500 por 10% e os US $200 restantes por 20%, para um desconto total de US $90.

Para um determinado preço total, o script faz um loop nos níveis especificados na tabela de preços por níveis. Para cada parte do preço total que se enquadra em um nível, essa parte é multiplicada pelo valor percentual associado ao nível. O resultado é a soma do cálculo de cada nível.

Serviços do Apps Script

Esta solução usa o seguinte serviço:

• Serviço de planilha: usa o valor fornecido e calcula qual parte do valor será multiplicada pelo desconto percentual de cada nível.

Pré-requisitos

Para usar este exemplo, você precisa dos seguintes pré-requisitos:

• Uma Conta do Google (as contas do Google Workspace podem exigir a aprovação do administrador).
• Um navegador da Web com acesso à Internet.

Configurar o script

Para fazer uma cópia da planilha Função personalizada de preços por níveis, clique no botão a seguir:

Fazer uma cópia

O projeto do Apps Script para essa solução está anexado à planilha.

Executar o script

1. Na planilha copiada, a tabela na linha 16 mostra um exemplo de cálculo de preço para um produto de software como serviço (SaaS).
2. Para calcular o valor do desconto, na célula C20, insira =tierPrice(C19,$B$3:$D$6). O preço final é atualizado na célula C21. Se você estiver em um local que usa vírgulas decimais, talvez seja necessário inserir =tierPrice(C19;$B$3:$D$6).

Revisar o código

Para revisar o código do Apps Script para essa solução, clique em Acessar o código-fonte:

// To learn how to use this script, refer to the documentation:
// https://developers.google.com/apps-script/samples/custom-functions/tier-pricing

/*
Copyright 2022 Google LLC

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/

/**
 * Calculates the tiered pricing discount.
 *
 * You must provide a value to calculate its discount. The value can be a string or a reference
 * to a cell that contains a string.
 * You must provide a data table range, for example, $B$4:$D$7, that includes the
 * tier start, end, and percent columns. If your table has headers, don't include
 * the headers in the range.
 *
 * @param {string} value The value to calculate the discount for, which can be a string or a
 * reference to a cell that contains a string.
 * @param {string} table The tier table data range using A1 notation.
 * @return number The total discount amount for the value.
 * @customfunction
 *
 */
function tierPrice(value, table) {
  let total = 0;
  // Creates an array for each row of the table and loops through each array.
  for (const [start, end, percent] of table) {
    // Checks if the value is less than the starting value of the tier. If it is less, the loop stops.
    if (value < start) {
      break;
    }
    // Calculates the portion of the value to be multiplied by the tier's percent value.
    const amount = Math.min(value, end) - start;
    // Multiplies the amount by the tier's percent value and adds the product to the total.
    total += amount * percent;
  }
  return total;
}

Modificações

Você pode editar a função personalizada quantas vezes quiser para atender às suas necessidades. Para conferir uma adição opcional para atualizar manualmente os resultados da função personalizada, clique em Atualizar resultados em cache:

Colaboradores

Este exemplo é mantido pelo Google com a ajuda dos Especialistas do Google Developers.

Próximas etapas

• Funções personalizadas no Planilhas
• Estender o Planilhas