הטמעת IFRAME למפת PUDO

▼

הטמעת המפה

יש להטמיע את המפה בדף בעזרת IFRAME ל-URL הבא:

https://bar2go.co.il/pudo/<sitecode>/map

sitecode יש לקבל לכל דומיין.

ניתן להעביר את הפרמטרים הבאים (Query String):

שם פרמטר	תיאור	ערכים	ברירת מחדל
city	שם העיר שתפתח עם עליית המפה	-	-
accessibility	האם להציג את תוסף הנגישות	1 - כן, 0 - לא	1
search	האם להציג את בר החיפוש	1 - כן, 0 - לא	1
select	האם לאפשר בחירת תחנה	1 - כן, 0 - לא	1

▼

קבלת הנתונים שנבחרו מהמפה

כאשר גולש בוחר נקודת מסירה ישלחו פרטי הנקודה שנבחרה בעזרת window.postMessage.
קוד לדוגמא לקבלת הנתונים:

<script>
    var eventMethod = window.addEventListener ? "addEventListener" : "attachEvent";
    var eventer = window[eventMethod];
    var messageEvent = eventMethod == "attachEvent" ? "onmessage" : "message";
    eventer(messageEvent, function (e) {
        if (e.data.type == "PUDOEvent") {
            if (e.data.name == "close") {
                var stationId = e.data.station.id;
                if (stationId != null) {
                    var str = "שם: " + e.data.station.name + "<br/>";
                    str += "קוד: " + e.data.station.id + "<br/>";
                    str += "כתובת: " + e.data.station.address + "<br/>";
                    str += "עיר: " + e.data.station.city + "<br/>";
                    str += "שעות פתיחה: " + e.data.station.openHours + "<br/>";
                    str += "נגישות: " + (e.data.station.accessiblity ? "כן" : "לא")+ "<br/>";
                    console.log(str);
                }
            }
        }
    }, false);
</script>

▼

העברת הנתונים ל-POS ע"י HTTP POST

יש להעביר JSON ל-URL הבא: https://bar2go.co.il/api/out/package/task/2

פרמטרים ראשיים:

שם פרמטר	סוג	תיאור	חובה
userName	string	שם משתמש כפי שיתקבל מ-POS	חובה
password	string	סיסמה כפי שתתקבל מ-POS	חובה
topCustomerId	int	קוד לקוח כפי שיתקבל מ-POS	חובה
consumer	object	אובייקט נמען (מפורט בהמשך)	חובה
quantity	int	כמות חבילות	חובה
notes	string	הערות	לא חובה
deliveryNumber	string	מספר שליחות	תלוי בהגדרה מול POS
productCode	string	קוד מוצר	תלוי בהגדרה מול POS
weight	float	משקל	לא חובה
stationId	int	קוד תחנת מסירה	תלוי בהגדרה מול POS

אובייקט consumer:

שם פרמטר	סוג	תיאור	חובה
name	string	שם נמען	חובה
street	string	רחוב	לא חובה
homeNumber	string	מספר בית	לא חובה
cityId	int	קוד עיר לפי הרשימה כאן	חובה
cellphone	string	מספר סלולרי	לא חובה
cellphone2	string	מספר סלולרי נוסף	לא חובה
email	string	אימייל	לא חובה

דוגמת בקשה:

POST /api/out/package/task/2 HTTP/1.1
Host: https://bar2go.co.il
Cache-Control: no-cache

{
    "userName":"pudotest1",
    "password":"pudotest1",
    "topCustomerId":99,
    "consumer":{
        "name":"שם נמען",
        "street":"רחוב נמען",
        "homeNumber":"מספר בית נמען",
        "cityId": 13,
        "cellphone":"0542123456",
        "cellphone2":null
    },
    "quantity":1,
    "notes":"",
    "deliveryNumber":null,
    "productCode":null,
    "weight":null,
    "stationId":985
}

תשובה מוצלחת:

{
    "status":true,
    "message":null,
    "moreData":{
        "barcode":"POSWS3687757"
    }
}

את הברקוד יש להדפיס ולהדביק על החבילה.

תשובת כשלון:

{
    "status":false,
    "message":"סיבת הכשלון",
    "moreData":{}
}

הצלחה עם אזהרה (סמס לא נשלח):

{
    "status":true,
    "message":"לא נשלח סמס",
    "moreData":{
        "barcode":"POSWS3687757"
    }
}