Buoni acquisto
Protocollo di comunicazione per i buoni acquisto.
Metodi Rest utilizzati, contratto: Comarch.B2.DataService.Contracts.dll
VoucherEntity[] GetInternalVouchers(string numer)
Il metodo dovrebbe restituire l’elenco dei buoni acquisto aggiornato, in accordo con il numero indicato (di solito questo è un buono acquisto)
VoucherResult UpdateVouchers(VoucherEntity[] vouchers);
Il metodo dovrebbe eseguire l’azione di aggiunta/attivazione/disattivazione/aggiornamento di particolari buoni sconto trasferiti come parametro.
L’attività da eseguire per buoni acquisto particolari dipende dai dati inclusi nell’entità VoucherEntity. Dati importanti inviati da POS:
| VoucherEntity | |
| Id : int | Id del buono acquisto (0 se va creato) |
| TypeId : VoucherKindEnum | Tipo di buono acquisto
(Unknown, InternalSold, InternalReleased, External, GiftCard) |
| SortId : int | Genere di buono acquisto |
| CurrencyId : int | Valuta del buono acquisto |
| IsActive : bool | Stato del buono acquisto
True: buono acquisto interno (venduto, rilasciato, carda), da utilizzare (disattivazione) o nel caso della carta da aggiornare lo stato Amount |
| Number : string | Numero del buono acquisto |
| Amount : decimal | Valore del buono acquisto |
Azione prevista a seconda della configurazione dei parametri VoucherEntity inviati al servizio dei buoni acquisto (DataService) con l’utilizzo del metodo UpdateVouchers:
| Id | SortId | IsActive | Azione |
| – | External | – | Utilizzo del buono esterno
Salvataggio nel database come utilizzato e non attivo ha il valore specificato in Amount con la valuta CurrencyId e il numero Number |
| 0 | InternalReleased | – | Generazione di un buono sconto interno rilasciato
Salvataggio nel database del buono acquisto come attivo e non utilizzato con il valore Amount, con il numero Number e con la valuta CurrencyId |
| >0 | InternalReleased
InternalSold GiftCard |
true | Utilizzo del buono sconto o aggiornamento del valore della carta regalo
|
| >0 | InternalReleased | false | Attivazione di un buono acquisto esistente e rilasciato internamente |
Bool IsExternalVoucherExists(string numer, int sortId)
Il metodo dovrebbe verificare se nel database esiste già un buono acquisto esterno con il numero e genere indicato.