OpenSource ERP Software dedicated to small to mid-size companies

           Become Platinium or Gold Neogia Partner

Ayez l'esprit Libre, partagez vos connaissances!!

Cet espace est communautaire et est basé sur les contributions de chacun. N'hésitez pas a créer de nouveaux documents en suivant les bonnes pratiques.

Gift_Card_Documentation


Contents

Rule

The gift cards allow warehouse's customer to buy a payment's reservation on this warehouse. In fact, it's possible to buy activation of gift card, reload it or pay order with it.

Entities and services

Gift card's management is done by the following entities:

GiftCard 
Customer gift card's definition "physical"
GiftCardFulfilment 
Define all actions happenned on card (activation, reload or payment)
PaymentMethod 
relation between gift card and party
FinAccount 
Financial Account indicate gift card account's balance
FinAccountTrans 
All transactions done on finacial account
FinAccountAuth 
All operations done on finacial account
Survey 
the dynamic questionnaire survey used during activation or reload card
ProductStorePaymentSetting 
A payment method's configuration (services and properties) on productStore.
ProductStoreFinActSetting 
Configuration and customize of using financial account on productStore

The main services used are :

ofbGcPurchase 
Activation of gift card's financial account
ofbGcReload 
Reload of gift card's financial account
ofbGcAuthorize 
Using financial account for payment

Uses Cases

Gift Card's Activation

Gift card's activation is done through some product who is associated to content with Fulfillment External (Async) type and ofbGcPurchase service name.

A Survey must be associated to product or category, this Survey allow to fill some information in order to creat a gift card

When order is finished, ofbGcPurchase service is triggered and financial account is created. It is associated to a party with PLACING_PARTY role.

Depending on productSotre configuration, the finAccount is created with random number or not and pin code.

The current issue when activating gift cards is the creation of gift card and association whith party don't occur. So it's impossible to use a financial account to do payments. It's necessary to creat a gigt card manually by user to take advantage of his gift card.

Gift Card's reload

The reload of a gift card requires a product to which a content of type "Fulfillment External (Async)" is associated with serviceName to ofbGcReload. There must exist a Survey associated to the product or to its category,this Survey gives informations concerning the gift card to be reloaded. When the command is ended, the ofbGcReload Service is activated and the financial account having its finAccountId==to the number of the card to be reloaded,is then refed through a finAccountTrans. At present,it is hard to reload a card ;this is because of the analysis of the card number which is not adapted to the generation of the card number.

Payment with Gift Card

when customer payes with gift card it is necessary to:

  1. He has a gift card associated to party as payment method
  2. There is a finAccount whith finAccount.finAccountId = giftcard.cardNumber and finAccount.finAccountCode = giftcard.pinNumber
  3. The finAccount is supplied by finAccountTrans
  4. Each finAccountTrans is associated to a payment

Neogia Specifications

At the moment of order's payment with gift card in ofbiz, a finAccounTrans is generated but not the order's payment. It will be difficult to match the invoices. In order to keep a logical set of payment process. It was decided in Neogia that the order's payment by gift card generate a finAccountTrans with WITHDRAWAL type associated to payment