CalMate

Il componente aggiuntivo CalMate calcola automaticamente il valore del campo “Parametro opzionale 2” (OP2) della spedizione in base all’importo del pagamento in contrassegno. Il calcolo viene eseguito dopo la creazione della spedizione. È possibile specificare una formula predefinita per il componente aggiuntivo, nonché una formula separata per ciascun cliente.

Requisiti

• abbonamento alla connessione API Deliveo;
• abbonamento al servizio webhook di Deliveo;
• autorizzazione all’installazione, alla configurazione e all’utilizzo del componente aggiuntivo.

Installazione e accesso

Il componente aggiuntivo può essere installato nel Portale di gestione, alla voce di menu Componenti aggiuntivi. Dopo l’installazione, è accessibile dalla voce di menu Componenti aggiuntivi / CalMate. Il componente aggiuntivo può essere installato e utilizzato solo da utenti in possesso delle autorizzazioni necessarie.

Principio di funzionamento

Nella formula, x indica l’importo del pagamento in contrassegno.

Esempio:

(x * 0.1) + 100

Se l’importo del pagamento alla consegna è 1000, allora:

• x = 1000
• il valore calcolato di OP2 è 200

Operazioni matematiche utilizzabili nella formula:

• +
• -
• *
• /
• ()

Regole importanti

• Il calcolo viene eseguito dopo la creazione della spedizione.
• Se nel campo OP2 è già presente un valore, il supplemento lo sovrascrive.
• Il risultato del calcolo non può essere negativo.
• La lunghezza del risultato non può superare la lunghezza massima del campo OP2.
• In caso di formula errata, il calcolo non viene eseguito.

Configurazione del webhook

Per il funzionamento del componente aggiuntivo è necessario creare un webhook.

1. Apri la voce di menu Impostazioni / Webhook.
2. Crea un webhook semplice.
3. Come evento, seleziona "Creazione di una spedizione".
4. Copia l'URL del webhook visualizzato sulla pagina di CalMate.
5. Salva il webhook.

L'URL del webhook è unico per ogni installazione, quindi utilizza sempre l'indirizzo visualizzato nell'interfaccia di CalMate.

Formula OP2 predefinita

La formula OP2 predefinita si applica a tutte le spedizioni dei clienti per i quali non è stata specificata una formula specifica. Per configurarla:

1. Inserisci la formula nel campo "Formula OP2 predefinita".
2. Verifica la formula utilizzando il pulsante "Prova la formula".
3. Fare clic sul pulsante «Salva».

Esempio:

10+(x*2)/10

Formule specifiche per cliente

Nella sezione "Formule cliente" è possibile specificare un calcolo diverso per ogni cliente. A tal fine sono necessari due dati:

• ID cliente
• Formula

L'ID cliente è l'identificativo numerico interno visibile nella colonna "ID" dell'elenco "Dati anagrafici / Clienti" del Portale di gestione. Per aggiungere una formula specifica per cliente:

1. Cerca l’ID cliente nella voce di menu Dati anagrafici / Clienti.
2. Inserisci l’ID nel campo ID cliente.
3. Inserisci la formula relativa al cliente.
4. Se necessario, prova la formula.
5. Fare clic sul pulsante Aggiungi.

Le formule cliente esistenti possono essere rimosse utilizzando il pulsante di cancellazione situato alla fine della riga.

Ordine di applicazione delle formule

Al momento della creazione della spedizione, il sistema:

1. verifica se al cliente è associata una formula specifica;
2. se sì, utilizza la formula specifica del cliente;
3. se non esiste una formula specifica, applica la formula predefinita.

Test della formula

È possibile testare la formula prima di salvarla.

1. Nel campo di prova, inserisci il x valore, ovvero l'importo del pagamento alla consegna che si desidera testare.
2. Fare clic sul pulsante "Prova la formula".
3. Il sistema eseguirà la formula.
4. Se il test ha esito positivo, verrà visualizzato il risultato calcolato.

Il test non modifica la spedizione, ma verifica solo il funzionamento della formula.

Formula errata

Se la formula inserita non è comprensibile:

• il calcolo non viene eseguito;
• il campo della formula viene temporaneamente contornato da un riquadro rosso.

In tal caso, verificare:

• la correttezza delle parentesi;
• i simboli delle operazioni consentiti;
• che si stia utilizzando solo la x variabile;
• che non ci siano errori di digitazione o operatori mancanti.

Esempi

Aggiunta di un importo fisso

x+100

All'importo del contrassegno viene aggiunto 100.

Calcolo di un valore percentuale

x*0.1

Il valore di OP2 è pari al 10% dell'importo del contrassegno.

Percentuale e importo fisso combinati

(x*0.1)+100

Il valore di OP2 è pari al 10% del pagamento in contrassegno, più 100.

Detrazione di un importo fisso

x-100

Il sistema sottrae 100 dall'importo del contrassegno. Il risultato non può essere negativo.

Errori comuni

Il valore di OP2 non viene aggiornato

Verifica:

• che il webhook sia stato creato;
• che l'evento del webhook sia "Creazione spedizione";
• che nel webhook sia indicato l'URL corretto;
• che sia presente un importo di contrassegno per la spedizione;
• che la formula sia stata salvata.

Non viene eseguita la formula prevista

Verifica:

• che esista una formula specifica per il cliente;
• se è stato inserito l'ID cliente corretto;
• che la formula predefinita desiderata sia stata salvata.

La formula specifica del cliente ha la precedenza su quella predefinita.

Il risultato è negativo

Il complemento non può utilizzare un valore OP2 negativo. Modifica la formula in modo che il risultato sia almeno pari a zero per ogni importo di pagamento previsto.

Il test della formula non è andato a buon fine

Verifica:

• la sintassi della formula;
• le parentesi;
• i simboli delle operazioni;
• l' x uso delle variabili.

Il valore precedente di OP2 è scomparso

L'add-on sovrascrive il valore precedente del campo OP2 al momento della creazione del messaggio. Ciò fa parte del funzionamento.