Ürün, işletmenin satılabilir herhangi bir öğesini tanımlamak için kullanılan veri modelidir. Bir ürün tanımlamak için en az stok kodu, ürün adı, ürün tipi, satış fiyatı ve vergi oranı girilmelidir. Her ürün bir menüye bağlı olmalıdır ve benzer ürünler birden fazla menü tanımı ile ayrılabilir.
Bir ürün için masa satış fiyatı, sıcak satış fiyatı ve paket fiyatı olarak üçlü fiyat tanımı yapılabilir. Ürünleri farklı fiyatlarla satmak için üçlü fiyat yeterli değilse, önce yeni bir menü oluşturulur ve aynı ad ve koda sahip ancak farklı fiyatlara sahip yeni bir ürün bu menüde tanımlanabilir.
Bir ürün birden fazla Menü Grubuna ve departmana bağlı olabilir. İlgili Menü Grubu ve departman bilgilerine web servisleri üzerinden erişilebilir.
| ALAN ADI | SQL TÜRÜ | VERİ TÜRÜ | AÇIKLAMA |
|---|---|---|---|
| ProductID | numeric(18,0) IDENTITY | decimal | Benzersiz ürün ID’si |
| CustomerID | numeric(18,0) | decimal | Ürünün ait olduğu işletmenin ID’si |
| MenuID | numeric(18,0) | decimal | Ürünün bağlı olduğu Menü ID’si |
| Name | nvarchar(100) | string | Ürünü tanımlayan başlık bilgisi |
| Code | nvarchar(100) | string | Ürün veya stok kodu (SKU) |
| DepCode | nvarchar(100) | string | Ürünün bağlı olduğu departman veya bölüm kodu |
| GroupCode | nvarchar(100) | string | Ürünün bağlı olduğu Menü Grubu veya kategori kodu |
| Price | decimal(18,2) | decimal | Ürünün varsayılan masa satış fiyatı |
| Price2 | decimal(18,2) | decimal | Ürünün sıcak satış fiyatı (isteğe bağlı) |
| Price3 | decimal(18,2) | decimal | Ürünün paket sipariş fiyatı (isteğe bağlı) |
| Tax | int | int | Ürünün varsayılan masa satış KDV oranı |
| Tax2 | int | int | Ürünün sıcak satış KDV oranı (isteğe bağlı) |
| Tax3 | int | int | Ürünün paket sipariş KDV oranı (isteğe bağlı) |
| Unit | int | int | Ürün birim tipi (Adet: 0, Gramaj: 1) |
| Type | int | int | Ürün tipi (Adet:0, Saatlik:1, TekSeferlik:2, Ekstra:8, Mesaj:9, Özel:10) |
| Status | int | int | Ürün durumu (Satışa kapalı: -1, Yeni:0, Aktif:1) |
| Splittable | bit | bool | Ürünün miktarının kesirli veya ondalıklı olup olmadığını belirler |
| Deleted | bit | bool | Ürün silinme durumu; true ise ürün artık mevcut değildir |
| Description | nvarchar(250) | string | Ürün açıklaması |
| Barcodes | nvarchar(100) | bool | Ürün barkodları listesi (virgülle ayrılmış) |
Tablo 5. Ürün veri modeli yapısı
Bir işletmedeki tüm ürünlerin listesine erişim sağlar. Aynı ürünler farklı menülerde tanımlanmışsa, ayrı girişler olarak görünür. Bu yöntem ürünleri JSON dizisi şeklinde döndürür. Bu web servise erişim için işletmenize özel APIKey gerekmektedir. API anahtarınızı edinmek için arge@menulux.com
adresine e-posta gönderebilirsiniz.
https://apis.menulux.com/api/ProductAPI/GetProducts?customerID=CID
Belirli bir menüde tanımlı ürün listesine erişim sağlar. Bu yöntem, o menüye bağlı ürünleri JSON dizisi olarak döndürür. Bu web servise erişim için işletmenize özel APIKey gerekmektedir. API anahtarınızı edinmek için arge@menulux.com
adresine e-posta gönderebilirsiniz.
https://apis.menulux.com/api/ProductAPI/GetProducts?customerID=CID&menuID=MID
İşletmedeki tüm ürünlerden, verilen koda uygun olanları listeler. JSON dizisi şeklinde döner. Bu web servise erişim için işletmenize özel APIKey gerekmektedir. API anahtarınızı edinmek için arge@menulux.com
adresine e-posta gönderebilirsiniz.
https://apis.menulux.com/api/ProductAPI/GetProducts?customerID=CID&code=CODE
Belirli bir ürünün detaylı bilgilerine erişim sağlar. İlgili ürünü JSON formatında döndürür. Bu web servise erişim için işletmenize özel APIKey gerekmektedir. API anahtarınızı edinmek için arge@menulux.com
adresine e-posta gönderebilirsiniz.
https://apis.menulux.com/api/ProductAPI/GetProduct?productID=PID
İşletmedeki ilgili ürün bilgisini getirir. Sorguya uygun ilk ürünü JSON formatında döndürür. Bu web servise erişim için işletmenize özel APIKey gerekmektedir. API anahtarınızı edinmek için arge@menulux.com
adresine e-posta gönderebilirsiniz.
https://apis.menulux.com/api/ProductAPI/GetProduct?customerID=CID&code=CODE
Bu web servisi, ilgili menüye ürün eklemeye veya mevcut ürünü güncellemeye olanak tanır. POST yöntemi, Product nesnesini payload olarak alır, ilgili CustomerID ve MenuID kontrol eder ve sonucu HttpResponseMessage olarak döndürür. Bu web servise erişim için işletmenize özel APIKey gerekmektedir. API anahtarınızı edinmek için arge@menulux.com
adresine e-posta gönderebilirsiniz.
https://apis.menulux.com/api/ProductAPI/PostProduct?PRODUCT
Bu web servisi, birden fazla ürünü eklemeye veya mevcut ürünleri güncellemeye olanak tanır. POST yöntemi, Product nesnelerinin listesini payload olarak alır, CustomerID ve MenuID kontrol eder ve işlem sonucunu HttpResponseMessage olarak döndürür. Bu web servise erişim için işletmenize özel APIKey gerekmektedir. API anahtarınızı edinmek için arge@menulux.com
adresine e-posta gönderebilirsiniz.
https://apis.menulux.com/api/ProductAPI/PostProducts?LIST(PRODUCT)
Bu web servisi mevcut bir ürünü güncellemeye olanak tanır. PUT yöntemi, Product nesnesini payload olarak alır, ProductID ve Code alanlarını kullanarak ürünü bulur, günceller ve sonucu HttpResponseMessage olarak döndürür. Bu web servise erişim için işletmenize özel APIKey gerekmektedir. API anahtarınızı edinmek için arge@menulux.com
adresine e-posta gönderebilirsiniz.
https://apis.menulux.com/api/ProductAPI/PutProduct?PRODUCT
Bu web servisi mevcut ürünlerin sadece fiyat bilgilerini güncellemeye olanak tanır. PUT yöntemi, ProductID, Code ve Price alanlarını içeren kısıtlı Product nesneleri listesini payload olarak alır. Ürünler ProductID ve Code ile tanımlanır ve fiyatları güncellenir. Sonuç HttpResponseMessage olarak döner. Bu web servise erişim için işletmenize özel APIKey gerekmektedir. API anahtarınızı edinmek için arge@menulux.com
adresine e-posta gönderebilirsiniz.
https://apis.menulux.com/api/ProductAPI/PutPrices?LIST(PRICE)