Script - Stampa preconto

Questo documento intende fornire le corrette indicazioni all'utente dell'applicazione FM Driver POS per creare e configurare al meglio lo script "Stampa preconto"

Questo script si presenta con una parte, la prima, modificabile dall'utente e una seconda, di cui qui non si scrive, che non bisogna modificare.

Che cos'è un preconto?

Un "preconto" è un documento gestionale, nuova dicitura di uno "scontrino non fiscale" molto utilizzato nella ristorazione: il gestore porta al tavolo questo documento per preparare il cliente al pagamento del conto finale.

Perché non stampare immediatamente un documento commerciale (scontrino fiscale)? L'esigenza di un preconto è nata in seguito alla necessità di memorizzare le modalità di pagamento di una prestazione e questo non può avvenire se si emette un documento commerciale senza sapere come il cliente intende pagare.

Il messaggio di testata

È possibile inserire un testo libero a inizio del documento gestionale che chiameremo "messaggio di testata". Può essere, ad esempio, il nome del cliente o qualche informazione aggiuntiva che si desidera comunicare. Si può abilitare con il valore di un campo boleano in testata (1 SI, 0 NO).

Set Variable [ $messaggioHeader ; Value: ricevuta::messageHeader ]

oppure impostarlo direttamente nello script

Set Variable [ $messaggioHeader ; Value: 0 ]

(abilitare solo una delle 2 possibilità)

Se si è deciso di abilitare il "messaggio di testata" con il valore della precedente variabile a 1, il programma permette di configurare 2 testi o 2 righe di uno stesso testo. Anche in questo caso la soluzione del cliente può avere 2 campi

Set Variable [ $messageHeader1 ; Value: ricevuta::messageHeader1 ] 

Set Variable [ $messageHeader2 ; Value: ricevuta::messageHeader2 ] 

o utilizzare 2 variabili create da una finestra di dialogo

Show Custom Dialog [ "Inserire i valori seguendo le indicazioni." ; $messageHeader1 ; $messageHeader2 ]

(abilitare solo una delle 2 possibilità)

Questa sezione è presente anche nello script "Stampa scontrino".

La riga di vendita

Impostare il contenuto della seguente variabile per ricavare il numero delle righe del corpo del documento. Inserire il campo che serve per relazionare le righe alla testata del documento

Set Variable [$campo_righeCorpoIdTestataDoc; Value: GetFieldName (righe_ricevuta::idRicevuta )] 

Impostare il contenuto della seguente variabile per riportare la quantità del prodotto della riga. La quantità deve avere al massimo 3 decimali.

Set Variable [ $campo_quantita ; Value: GetFieldName ( righe_ricevuta::Qtà ) ] 

Impostare il contenuto della seguente variabile per riportare il prezzo unitario. Il prezzo deve essere di 2 decimali e deve essere sempre positivo, anche in caso di reso (quantità negativa).

Set Variable [ $campo_prezzoUnitario ; Value: GetFieldName ( righe_ricevuta::prezzoUnitario ) ]

Impostare il contenuto della seguente variabile per riportare la descrizione del prodotto.

Set Variable [ $campo_descrizione ; Value: GetFieldName ( righe_ricevuta::articolo ) ] 

Ogni riga di vendita può avere un campo che descrive ulteriormente il prodotto. Ad esempio, può essere utile riportare numeri di serie, matricole o più semplicemente testo aggiuntivo.

Impostare il contenuto della seguente variabile per aggiungere contenuto alla riga.

Set Variable [ $campo_messaggio ; Value: GetFieldName ( righe_ricevuta::articolo2 ) ] 

Questa sezione è presente anche nello script "Stampa scontrino".

Gli sconti sul prodotto

In un documento di vendita si può decidere di impostare uno o più sconti su uno o più prodotti. Ogni riga di vendita ha un campo che ne indica il "totale" al netto degli sconti applicati.

Le stampanti, in presenza di sconti, inseriscono nella stampa una riga aggiuntiva che indica il valore dello sconto e, quindi, hanno bisogno di un campo che indichi la differenza tra il "totale" in assenza di sconti e il "totale" in loro presenza.

Impostare il contenuto della seguente variabile per riportare il valore dello sconto di ogni singola riga di vendita.

Set Variable [ $campo_valoreSconto ; Value: GetFieldName ( righe_ricevuta::importoSconto ) ] 

In presenza di sconti viene stampata una riga con il valore dello sconto ed è possibile personalizzare la descrizione della riga. Per una miglior leggibilità del documento è meglio rimanere sotto i 26 caratteri.

Impostare il contenuto della seguente variabile per riportare una descrizione per lo sconto applicato.

Set Variable [ $messaggioSconto ; Value: Left ("*** PROMOZIONE ***"; 25) ]

Questa sezione è presente anche nello script "Stampa scontrino".

Il "Totale" e lo sconto sul "Totale"

Il totale del documento deve essere assolutamente uguale alla somma degli importi delle singole righe. NON PUÒ ESSERE DIVERSO!

Impostare il contenuto della seguente variabile con il nome del campo totale.

Set Variable [ $campo_totaleDocumentoSuRighe ; Value: GetFieldName ( ricevuta::totale ) ] 

Se si desidera impostare uno sconto sul totale o, più semplicemente, arrotondare il totale del documento è necessario inserire il campo con il valore dell'arrotondamento nella seguente variabile.

Set Variable [ $campo_scontoSubtotale ; Value: GetFieldName ( ricevuta::scontoSubtotale ) ] 

Questa sezione è presente anche nello script "Stampa scontrino".

Il pagamento

È possibile abilitare/disabilitare la stampa di informazioni sul pagamento. Impostare il contenuto della seguente variabile per indicare al sistema se stampare o meno queste informazioni (1 = SI, 0 = NO).

Set Variable [ $stampaPagamenti ; Value: 0  ]

In un gestionale il pagamento di un documento può essere effettuato con uno o più forme di pagamento e si può gestire in due modi:

• un portale con le righe dei pagamenti
• uno o più campi della testata stessa del documento.

Impostare il contenuto della seguente variabile per indicare al sistema la presenza o meno di una tabella "pagamenti" (1 = SI, 0 = NO).

Set Variable [ $portalePagamenti ; Value: 0 ] 

1 - Presenza di una tabella "pagamenti"

Questi sono i campi necessari per un documento gestionale:

• descrizione (contanti, bancomat...)
• importo

Impostare il contenuto della seguente variabile per ricavare il numero dei pagamenti del documento. Inserire il campo che serve per relazionare i pagamenti alla testata del documento.

Set Variable [$campo_righePagamentiIdTestataDoc; Value: GetFieldName (pagamenti_ricevuta::idRicevuta)] 

Impostare il contenuto della seguente variabile con il campo che descrive il pagamento.

Set Variable [ $campo_pagamento ; Value: GetFieldName (pagamenti_ricevuta::pagamento ) ]

Impostare il contenuto della seguente variabile con il campo che indica l'importo del pagamento.

Set Variable [$campo_importoPagamento; Value: GetFieldName (pagamenti_ricevuta::importoPagamento)]

2 - Assenza di una tabella "pagamenti"

Nel caso, invece, non esista una tabella "pagamenti", ma un semplice campo nella testata del documento, è necessario inserire nella soluzione una lista con i valori dei pagamenti possibili e utilizzarla nell'applicazione per descrivere il pagamento.

ESEMPIO LISTA VALORI:

• Contanti
• Carta di debito/credito
• Assegno
• Bonifico bancario

Impostare il contenuto della seguente variabile per ricavare il numero dei pagamenti che si possono utilizzare nei documenti (MAX 3, normalmente 1).

Set Variable [ $numeroPagamentiUtilizzati ; Value: 1 ] 

Impostare il contenuto della seguente variabile con il campo che descrive il pagamento.

Set Variable [ $campo_pagamento ; Value: GetFieldName (ricevuta::pagamento) ] 

Impostare il contenuto della seguente variabile con il campo che indica l'importo del pagamento.

Set Variable [ $campo_importoPagamento ; Value: GetFieldName (ricevuta::importoPagamento) ]

 

Testo aggiuntivo

Questa sezione serve a fornire maggiori informazioni. Ognuna delle prossime variabili può contenere al massimo 46 caratteri.

Come si può ritrovare rapidamente un documento tra decine di altri documenti? O meglio: a quale tavolo appartiene questo documento di "preconto"?

Le due prossime variabili sono state pensate per riportare le informazioni utili a rispondere a queste domande. È consigliato impostarne almeno una.

Impostare il contenuto della seguente variabile con il campo che descrive il primo riferimento.
Set Variable [ $riferimento1 ; Value: "Riferimento doc n. " & ricevuta::numero & " del " & ricevuta::data ]

Impostare il contenuto della seguente variabile con il campo che descrive il secondo riferimento.
Set Variable [ $riferimento2 ; Value: "Tavolo n. " & ricevuta::tavolo ]

C'è ancora la possibilità di inserire 3 righe di testo aggiuntive. Si può abilitare con il valore di un campo boleano in testata (1 SI, 0 NO).

Set Variable [ $messageFooter ; Value: ricevuta::messageFooter ]

oppure impostarlo direttamente nello script

Set Variable [ $messageFooter ; Value: 0 ]

Le variabili possono essere popolate da campi nella testata (messaggi sempre personalizzabili), impostate nello script o utilizzare 3 variabili create da una finestra di dialogo.

Set Variable [ $messageFooter1 ; Value: ricevuta::messageFooter1 ]
Set Variable [ $messageFooter2 ; Value: ricevuta::messageFooter2 ]
Set Variable [ $messageFooter3 ; Value: "Le ricordo che il vino è offerto dalla casa" ]

Se si preferisce utilizzare 3 variabili:
Show Custom Dialog [ "Inserire i valori seguendo le indicazioni." ; $messageFooter1 ; $messageFooter2 ; $messageFooter3 ]