Calcolare uno sconto su più livelli

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

Obiettivi

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

Informazioni su questa soluzione

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

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

Screenshot dell'esempio di prezzi a più livelli

Come funziona

Un modello di prezzi a più livelli prevede che il costo di beni o servizi diminuisca in base alla quantità acquistata.

Ad esempio, supponiamo che tu abbia due livelli, uno compreso tra 0 e 500 € con uno sconto del 10% e uno compreso tra 501 e 1000 € con uno sconto del 20%. Se il prezzo totale per cui 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 scorre i livelli specificati nella tabella dei prezzi a livelli. Per ogni parte del prezzo totale che rientra in un livello, questa parte viene moltiplicata per il valore percentuale associato al 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 dato e calcola la porzione del valore da moltiplicare per lo sconto percentuale di ogni livello.

Prerequisiti

Per utilizzare questo esempio, devi soddisfare i seguenti prerequisiti:

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

Configurare lo script

Fai clic sul pulsante di seguito per creare una copia del foglio di lavoro della funzione personalizzata Prezzi a 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 nella riga 16 mostra un calcolo di esempio del prezzo per un prodotto Software as a Service (SaaS).
  2. Per calcolare l'importo dello sconto, nella cella C20 inserisci =tierPrice(C19,$B$3:$D$6). Gli aggiornamenti del prezzo finale nella cella C21. Se ti trovi in una località che utilizza le virgole decimali, potresti dover inserire =tierPrice(C19;$B$3:$D$6).

Esamina il codice

Per esaminare il codice Apps Script per 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 tutte le volte che vuoi per adattarla alle tue esigenze. Di seguito è un'aggiunta facoltativa per aggiornare manualmente i risultati delle funzioni personalizzate.

Aggiornare i risultati memorizzati nella cache

A differenza delle funzioni integrate, Google memorizza nella cache le funzioni personalizzate per ottimizzare il rendimento. Pertanto, 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, segui questi passaggi:

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

Collaboratori

Questo esempio è gestito da Google con l'aiuto degli esperti Google.

Passaggi successivi