Bu örnek promosyon uygulamamız bir çok farklı promosyon uygulamasına temel oluşturacak işlevlere sahip olacaktır. Örneğin;

• Müşterililerimize ileride başka ücret ödemeden kahve alabilmeleri için kullanabilecekleri Kahve Kuponları üretip, basacak ve kullandıracağız.
• Bu uygulama aynı zamanda toplu bir şekilde yemek fişi (yemek kuponu) olarak da düzenlenebilir, bu şekilde kullanıldığında ise işyerleri personellerine çok sayıda hazır kuponu indirimli olarak alır ve ay boyunca kullandırtabilir.
• Toplu bir şekilde Promosyon yapmak isteyen bir işyeri, basacağı tanıtım broşürlerinin üzerine SambaPOS tan ürettiği ikram ürün kuponlarının barkodunu yapıştırarak bu barkodla gelen kişilere ikramlarda bulunarak bunun takibini yapabilir.

Örneğimizde biz kahve kuponu üreterek bu kuponun kullanılmasını işleyeceğiz. Adım Adım yapılacaklar listesi

1. Kuponlar için Varlık Tipi tanımlanacak
2. Kupon Varlık Tipinin İçeriklerinin Güncellenmesi
3. Kahve Kuponu Ürünü oluşturulması
4. Kahve Kuponu Durum Güncelleştirmeleri
5. Varlık olarak Kahve Kuponu Ürettirilmesi
6. Yeni Kupon Satış Durumlarının Güncellenmesi
7. Kupon Ürünü Satılıp Ödendikten Sonraki Durumunu Güncelleme
8. Kupon Varlığı Oluşturma Kuralları

SambaPOS içerisinde üreteceğimiz kuponların her birini otomatik olarak oluşturacağımız birer Varlık olarak tanımlayacağız. Bunun için Özel alanlarını ve isteklerimizi karşılayacak yeni bri varlık tipi tanımlıyoruz.

Varlık Tipi tanımlama için Yönetim - Varlıklar - Varlık Tipleri menüsünden Varlık Tipi Ekle linkine tıklıyoruz.

Varlık Tipi Oluştur Ekranı Değerleri

Bu değerleri ekleyerek Adı Kupon olan ve 1. veri alanı da “Kupon Numarası” olan bir varlık tipi oluşturuyoruz. Birincil Alan Biçimine yazdığımız “AAAAA-AAA-AAA” formatı otomatik olarak oluşacak olan kuponun rahat okunabilmesi için alfanumerik değerlerin biçimini bize gösteren alandır. Alan biçimle ile ilgili olarak Primary Field Editing Formats belgesini inceleyebilirsiniz.

Varlık Tipi Özel Alanları

Varlık Tipi Oluştur Ekranı Değerleri

Kupon varlık tipimize ileriki işlemlerimizde kullanmak üzere 3 farklı Özel alan tanımlıyoruz.

Menü Ürün Adı: Kupon kullanımı sırasında hangi Menüde bulunan hangi ürünün ikram olarak adisyona ekleneceğini belirleyeceğimiz ve ürünün adını yazdıracağımız alandır.

Kupon Kullanımı: Kuponun kullanılıp kullanıldmadığını veya o anda aktif olan bir adisyonun içinde mi olduğunu sorgulayacağımız Durum değişkenlerinin saklanacağı alandır.

Son Kullanım Tarihi: Oluşturduğumuz kuponun sok kullanım tarihini saklayacağımız alandır.

Aşağıda tanımlayacağımız Eylemlerle Varlık Tipi içinde tanımladığımız Özel alanlara ilgili değerlerini yazdıracağız. Örneğin Kupon kullanıldığı zaman, Kupon Kullanımı alanındaki değeri Evet olacak.

NOT: Bundan sonra göreceğiniz ekran görüntülerinde

2.1. Menü Ürün İsmi alanını güncelleyen Eylem

Bu eylem Kupon Numarası kontolü ile Varlık Tipindeki “Menü Ürün Adı” alanına değişkenden gelen Ürün adını yazdıracak olan eylemdir.

Bu eylem ilgili Kural tarafından çalıştırıldığında, [:] arasına verilen değişken adlarının aldığı değerleri alacaklar.

Bu eylem için “Update Entity Data - Varlık Bilgisini Güncelle” eylemini kullanıyoruz.

Eylem Bilgileri

2.2. Kupon Kullanımı veri alanının bilgilerinin Güncellenmesi

Yukarıda anlatılan eylemin yaptığı için aynısı yapacak ancak bu sefer Varlık Tipi içindeki “Kupon Kullanımı” adındaki alanı güncelleyecek olan eylemdir.

Eylem Bilgileri

Kahve Kuponu ileride insanların o kuponla gelip alabilmeleri için aslında işletmemizde satılacak fiziki bir üründür. Bu sebepten Kahve Kuponu ürünümüzü tanımlıyoruz.

Ürün tanımlama SambaPOS da Yönetim - Ürünler - Ürün Listesi menüsünde Ürün Ekle linkine tıklanarak tanımlanır.

Kupon Ürünü tanımlamada dikkat edilecek husular.

• Yeni bir Grup Kodu tanımlamamız gerekir Örnekte : Promosyon
• Ürün Etiketini bu kopunun verileceği gerçek ürünün adı yazılır. Örnekte : Kahve
• Ürün Porsiyon Fiyatı; bu kuponun satılacağı fiyatıdır.

Ürün Özellikleri

Yukarıdaki benzeri bir Ürün tanımlandıktan sonra kullandığımız Menümüzün içerisinde uygun bir alana eklenir. Menüyede eklendikten sonra Menümüz aşağıdaki gibi yeni bir kategoride bulunan bir tane Kupon Ürünü olacaktır.

Ürünümüzü ve Varlık Tipimizi tanımladıktan sonra sıra geldi, bu ürün adisyona eklendiğinde üzerinde diğer işlemler yapıldığında oluşacak Durumların güncellenmelerine.

İlk olarak kahve kuponu satış durumunu güncelleştirebilmek için gerekli olan Eylemi tanımlıyoruz.

Eylem Bilgileri

Bu Eylem çalıştığında, (adisyona ürün eklendiğinde) Kupon Durumu adında yeni bir State (Durum) tanımlayacak ve bunu ürünün altında 4 sırada nın 4 değişkeni olarak yazacağını tanımladık. [:] içerisinde girdiğimiz Mevcut Durum ve Durum değişken olarak bu eylemi çalıştıran kural tarafından atanabilecekler.

Hatırlarsanız Varlık Tipimizi tanımlarken Özel Alan olarak Menü Ürün Adı biçiminde bir özel alan açmıştık. Bu alan Kupon adisyona eklendiğinde hangi ürünün verileceğinin adının yazıldığı veri alanıdır. Bu veri alanınıda güncelleştirecek bir eylem daha tanımlıyoruz.

Eylem Bilgileri

Neler yaptığımızı sırayala hatırlayalım; Öncelikle kuponlarımızı tanımlamak için, bir Varlık Tipi oluşturduk, Bu varlık tipimizin kullanabileceği bir ürün oluşturduk ve bu ürün eklendiğinde durumlarının güncellenebilmesi için gerekli eylemleri tanımladık. Şimdi sıra geldi oluşturduğumuz varlık tipinin içine gerekli şartlar oluştuğunda açılacak olan varlıkların otomatik olarak üretilmesine;

Bunun için tanımlayacağımız Eylem'in adı Varlık Oluştur. Varlık oluştur eylemi verilen şartlara göre otomatik olarak varlıkların oluşturulmasında kullanılır.

Eylem Bilgileri

Eylemin çalıştırıldığında yapacağı işlere sırayla bi göz atalım. Eylem Kuponlar Varlık Tipinin içerisinde KP{RANDOMC:8} biçiminde bir varlık açacak ve bu varlığın Özel Alanları içinde bulunan Kupon Kullanımı alanını da Hayır olarak güncelleştirecek. Sadece varlık oluşturacak bu varlığa bağlı bir hesap açmayacak.

KP{RANDOMC:8} Parametresinin açıklaması:

{RANDOMC} işareti RamdomC Karakter üretilmesinde kullanabileceğimiz bir fonsiyondur. Sonunda bulunan C karakteri ürettiği random değerin Kontrol Hanesidir. {RANDOMC:8} demek 8 haneli Random bir isim üretilmesi için kullanılır. Sonunda bulunan C yani Kontrol hanesi ile birlikte toplam 9 haneli Random bir isim elde etmiş oluruz. Ürettiğimiz bu kuponları diğer varlıklarla karışmaması için de önüne KP önekini kullanık.

Bu eylem bize KP9TGWJ3SMG gibi toplam 11 haneli bir varlık oluşturacaktır.

Bu işlemi bir Kural ile gerçekleştireceğiz, Yukarıdaki adımlarda parametrik değerler yüklediğimiz Eylemleri çağırarak Adisyona Kahve Kuponu siparişi eklendiğinde mevcut durumlarını değiştirmek için kullanacağız.

Kural Değerleri

Yukarıda bulunan resimde KISITLAMA alanı olarak belirttiğimiz alan bu kuralın çalışabilmesi için geçerli olan şartların neler olduğunun belirlenmesinde kullanılmaktadır.

Kuralımızımı okuyacak olursak, Adisyona Şipariş Eklendi olayı seçildiğinde adisyona eklenen ürünün Menü Grup Kodu Promosyona eşitse. (Kahve Kuponu Ürünümüzü eklediğimiz ürün Grubuna) aşağıda bulunan 2 eylemi çalıştıracaktır.

Bu eylemlerde sırayla; Kupon Durumunu Kupon Siparişte olarak güncelleyecek ve Menü Ürün adı alanını da {ITEM TAG} değerinden dolayı (Bu değer Yazıcı Şablonları başta olmak Ürün Etiketini kullanmamız gerektiği heryerde kullanılabilir) Kahve olarak değiştirmesini sağlar.

Kuralımızı tanımladıktan sonra adisyona, bir Kahve Kuponu ürünü eklendiğinde aşağıdaki gibi görülecektir.

Default kurulımdan sonra tanımladığımız Durumların ekranda ve raporlarda gözükmesini kontrol edebiliyoruz. Bu konu bu linkte anlatılmıştır. bu adreste anlatıldığı gibi Kupon Siparişte durumunu ekleyip ekranda gözükmesini sağladıktan sonra oluşan satış ekranımızın görüntüsü yukarıdadır.

Kupon Ürününü adisyona eklediğimizde olması gereken durumlarını bir önceki kuralımızda tanımladık. Şimdi de bu adisyon ödediği zaman bu kuponun Durumlarının değiştirilmesi gerekiyor. Çünkü ileriki aşamalarda Ödemesi tamamlanmış Kahve Kuponları için Barkod yazdırmak dahil yapacağımız işlemlerde kullanacağız.

Bunun için yeni bir kural daha tanımlıyoruz.

Kural Değerleri

Belge kapanmadan Önce olayı ile “RemainingAmount” değeri yani adisyon toplam rakamı 0 a eşitse “Kupon Ürünleri Durumlarını Güncelle” eyleminde Mevcut Durumu Kupon Siparişte olan halini Kupon Ödendi olarak değiştirdik.

Navigasyonda bulunan Adisyonlardan eski ödenmiş bir adisyona baktığımızda ödemesi yapılmış Kahve Kuponu ürünümüz aşağıdaki gibi gözükecektir.

Gerekli ön hazırlıkları yaptıktan sonra artık Kahve Kuponu ürünümüz ödendiği anda otomatik olarak Kupon Varlığımızın oluşturulmasını yapacağız. Bunun için yukarıda tanımladığımız eylemleri uygun şartlar altında çalıştıracak yeni bir Kural daha tanımlıyoruz.

Sipariş Durumu Değiştiğinde olayını kullanarak yeni varlıklar oluşturacağız.

Kural Değerleri

Yukarıdaki Kuralımızla Kupon Durumu = Kupon Ödendi olan anlarda çalışacak şekilde kısıtladıktan sonra 2 Eylemi çalıştırmasını istedik.

Birinci Eylemde bize random bir Varlık oluşturdu, 2. eylemde ise Kuponda geçen ürün adını Sipariş Durumunda yazan Kupon Ürünü adıyla güncelleştirmiş olduk.

Durum Gözden Geçirme…

Kupon Ürünümüz adisyona ekledikten ve satışı yapılarak ödemesi alındığı anda otomatik olarak bir Kuponlar Varlık Tipi altına yeni bir Varlık oluştur. Bu varlığı inceleyecek olursak aşağıdaki gibi görülecektir.