Calcolare uno sconto su più livelli

Livello di programmazione: principiante
Durata: 10 minuti
Tipo di progetto: Funzione personalizzata

Obiettivi

  • Scopri cosa fa la soluzione.
  • Scopri cosa fanno i servizi Apps Script all'interno di questa soluzione.
  • Configura lo script.
  • Esegui lo script.

Informazioni su questa soluzione

Se offri ai tuoi clienti un sistema di prezzi a più livelli, questa funzione personalizzata semplifica il calcolo degli importi degli sconti per i tuoi prezzi.

Sebbene sia possibile utilizzare la funzione integrata SUMPRODUCT per eseguire un calcolo dei prezzi per livelli, l'utilizzo di SUMPRODUCT è più complesso e meno flessibile della funzione personalizzata di questa soluzione.

Screenshot dell'esempio di prezzo del livello

Come funziona

Un modello di prezzi a livelli significa che il costo dei beni o dei servizi diminuisce in base alla quantità acquistata.

Ad esempio, immagina di avere due livelli, uno che va da 0 $a 500 $ con uno sconto del 10% e uno che va da 501 $a 1000 $ con uno sconto del 20%. Se il prezzo totale per il quale devi calcolare uno sconto è di 700 $, lo script moltiplica i primi 500 $per il 10% e i restanti 200 $per il 20%, per uno sconto totale di 90 $.

Per un determinato prezzo totale, lo script passa attraverso i livelli specificati nella tabella dei prezzi dei livelli. Per ogni porzione del prezzo totale che rientra in un livello, tale parte viene moltiplicata per il valore percentuale associato del livello. Il risultato è la somma del calcolo di ogni livello.

Servizi Apps Script

Questa soluzione utilizza il seguente servizio:

  • Servizio fogli di lavoro: prende il valore specificato e calcola la porzione di valore da moltiplicare per lo sconto percentuale di ogni livello.

Prerequisiti

Per utilizzare questo esempio, devi disporre dei seguenti prerequisiti:

  • Un Account Google (gli account Google Workspace potrebbero richiedere l'approvazione dell'amministratore).
  • Un browser web con accesso a internet.

Configura lo script

Fai clic sul pulsante di seguito per creare una copia del foglio di lavoro della funzione personalizzata di determinazione dei prezzi per livelli. Il progetto Apps Script per questa soluzione è allegato al foglio di lavoro.
Crea una copia

Esegui lo script

  1. Nel foglio di lavoro copiato, la tabella alla riga 16 mostra un calcolo del prezzo di esempio per un prodotto Software as a Service (SaaS).
  2. Per calcolare l'importo dello sconto, inserisci =tierPrice(C19,$B$3:$D$6) nella cella C20. Il prezzo finale viene aggiornato nella cella C21. Se ti trovi in una località che utilizza virgole decimali, potresti dover inserire =tierPrice(C19;$B$3:$D$6).

Rivedi il codice

Per esaminare il codice Apps Script di questa soluzione, fai clic su Visualizza codice sorgente di seguito:

Visualizza codice sorgente

Code.gs

solutions/custom-functions/tier-pricing/Code.js
// 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 (let [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.
    let 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;
}

Modifiche

Puoi modificare la funzione personalizzata come preferisci in base alle tue esigenze. Di seguito è riportata un'aggiunta facoltativa per aggiornare manualmente i risultati delle funzioni personalizzate.

Aggiorna risultati memorizzati nella cache

A differenza delle funzioni integrate, Google memorizza nella cache funzioni personalizzate per ottimizzare le prestazioni. Di conseguenza, se modifichi qualcosa all'interno della funzione personalizzata, ad esempio un valore in fase di calcolo, l'aggiornamento potrebbe non essere forzato immediatamente. Per aggiornare manualmente il risultato della funzione, svolgi i seguenti passaggi:

  1. Aggiungi una casella di controllo a una cella vuota facendo clic su Inserisci > Casella di controllo.
  2. Aggiungi la cella contenente la casella di controllo come parametro aggiuntivo della funzione personalizzata. Ad esempio, se aggiungi una casella di controllo alla cella D20, aggiorna la funzione tierPrice() nella cella C20 in =tierPrice(C19,$B$3:$D$6,D20).
  3. Seleziona o deseleziona la casella di controllo per aggiornare i risultati delle funzioni personalizzate.

Collaboratori

Questo campione è gestito da Google con l'aiuto degli Esperti Google Developers.

Passaggi successivi