דחיפת נתונים אל לוח המכירות

1 מטרת הפרויקט

לוח המכירות מציג בזמן אמת את הביצועים של כל חנות וכל סוכן ברשת — מחזור, יחידות, עסקאות ורווחיות, מפולחים לפי חנות / סוכן / קטגוריה / חלון זמן, כולל השוואות בין תקופות ובין חנויות. אנשי הרצפה רואים יעדים, לוחות תוצאות ותחרויות, ובחיפוש לפי טלפון — כרטיס לקוח עם כל ההיסטוריה, שמראה מה כדאי להציע. הכול מבוסס על הנתונים שבי‑גייט דוחף.

2 המנגנון

• JSON בלבד (עודכן בשיחה 6.7) — דוחפים את מה שה‑BI קורא, כמו שהוא: · בקשת POST עם Content-Type: application/json
  · אימות בכותרת: Authorization: Bearer <טוקן> — הטוקן נשלח בנפרד
  · הגוף: מערך JSON של אובייקטים — שורה לכל רשומה (במכירות: שורה לכל פריט בקבלה, כולל קוד הסוכן). שמות השדות — כמו שהם אצלך ב‑BI, בלי התאמות; אנחנו ממפים אצלנו
  · עד 500 שורות ל‑POST · עד 4MB לבקשה · שליחה חוזרת בטוחה (כפילות מדולגת, תיקון מעדכן)
• כתובת (POST) לכל סוג: חנויות — https://gomobile-sales.vercel.app/api/bgate/sales-data/stores
  סוכנים — https://gomobile-sales.vercel.app/api/bgate/sales-data/salespeople
  מכירות — https://gomobile-sales.vercel.app/api/bgate/sales-data/sales
  לקוחות — https://gomobile-sales.vercel.app/api/bgate/sales-data/customers
• שליחה חוזרת בטוחה: כפילות מדולגת, תיקון מעדכן. סדר גמיש — שורה שעוד לא נפתרה ממתינה ונפתרת לבד.
• שלב ראשון: דוגמה קטנה מכל סוג — נראה איך זה מגיע, ונתאים את המיפוי אצלנו.

3 המידע שאנחנו צריכים

4 מה נשאר

דוגמה קטנה מכל סוג — נראה איך הנתונים מגיעים, ונתאים את המיפוי אצלנו (כולל מבנה ההחזרות — מינוס / זיכוי). אפשר לשלוח באחת משתי הדרכים:

• POST ישיר לכתובות שלמעלה — עדיף: דחיפה אחת מראה את הפורמט וגם מאמתת את ההזדהות והתקשורת (idempotent — אפשר לחזור עליה).
• או קובץ / הדבקה במייל — נמפה ממנו, ונאשר את הפורמט בדחיפה הראשונה.

5 מלאי לפי חנות — בשלב אחרון

את זה נחבר אחרון, אחרי שכל השאר עובד והמכירות זורמות. אז נבקש סנאפשוט מלא חד‑פעמי של המלאי (כמה מכל מוצר בכל חנות), ומשם עדכון בכל מכירה / שינוי. אין צורך להתעסק בזה עכשיו.