מושגי יסוד
ברקוד (barcode)
קוד GTIN/EAN המזהה מוצר באופן ייחודי בכל הרשתות (למשל 7290010935656). כל ה-endpoints שמקבלים barcode מצפים לקוד זה, לא למזהה פנימי.
רשת מול סניף (chain vs. store)
chain_id מזהה רשת (למשל ramilevi). כאשר granularity הוא "store", אובייקט store נוסף מזהה סניף ספציפי (store_id, city). כרגע, כל המחירים מוחזרים ברמת סניף — זהו הערך היחיד שמוחזר כיום.
price_ils מול effective_price_ils
| תרחיש | price_ils | effective_price_ils | פרטי מבצע |
|---|---|---|---|
| אין מבצע פעיל | "18.90" | "18.90" (זהה) | — |
| מבצע כללי (לא מועדון) | "18.90" | "14.90" | promotion object |
| מבצע מועדון (member_only) | "18.90" | "18.90" (לא כלול) | promotion.member_only = true |
price_ils הוא המחיר המדף. effective_price_ils הוא המחיר הנמוך ביותר שקונה משלם עכשיו ללא צורך במועדון. מחירי מועדון מופיעים רק באובייקט promotion.
עדכניות (collected_at)
כל אובייקט מחיר כולל collected_at — חותמת זמן ISO-8601 מלאה (לא רק תאריך) של מועד איסוף המחיר. שדה meta.data_updated_at הוא ה-collected_at המאוחר ביותר בתגובה. מחירים הם אינדיקטיביים — ייתכן פער של עד יום מהמחיר בפועל בחנות.
מע"מ (VAT)
כל מחירי המזון בישראל כוללים מע"מ. vat_included תמיד true, vat_rate משקף את השיעור הנוכחי (0.18 = 18%).