דפי מכירה אינטרנטיים - פירוט הפרמטרים ב CallBack

מערכת ההזמנות של כספית יכולה לקרוא למערכת שלך לאחר ביצוע הזמנה. הקריאה מתבצעת לאחר סיום סליקת כרטיס האשראי ולאחר יצירת המסמך המתאים (חשבונית, קבלה, חש/קבלה וכו'). הקריאה נעשית ב-POST והפרמטרים מועברים בתור x-www-form-urlencoded

להלן פירוט הפרמטרים:

פרטי זיהוי של ההזמנה:

OrderId - המפתח של ההזמנה במערכת כספית
OrderNumber - מספר ההזמנה
OrderStatus - אחד מהערכים הבאים:
        {
            New = 0,
            Paid = 1,
            PaymentProblem = 2,
            Closed = 3,
            Error = 4,
            Cancelled = 5,
                        לא_שולמה = 6,
            חשבונית_נשלחה_ללקוח = 7,
            הוראת_קבע = 8
       }
caspitBusinessId - המפתח של העסק ששבו נוצרה ההזמנה במערכת כספית.
TrxId - זיהוי של התנועה. זהו פרמטר שנשלח על-ידך למערכת ההזמנות. כלומר אתה יכול להציג את טופס ההזמנה ולצרף לכתובת שלו את הפרמטר trxId שיוחזר אליך ב-CallBack. לדוגמה:
https://app.caspit.biz/Order/Index/f27863a0-cbda-4f16-8595-a1b5eaa87ee7-ff07a014-772f-4258-b4f8-6e6f2fd3a6a1?trxId=G535366-93838
DocumentId - המפתח של המסמך שנוצר בכספית עבור ההזמנה (חשבונית, קבלה וכו')
documentNumber - המספר של המסמך שנוצר (לדוגמה: "01/20089").
referenceNumber - אסמכתא לסליקה שהתקבלה מחברת האשראי
voucherNumber - מספר השובר שהתקבל מחברת האשראי

פרטי הלקוח:

customerName
, osekMorshe,
address1
, address2
, city,
postalCode,
mobilePhone,
email,
contactId -- ה- id שכספית יצרה עבור הלקוח. מסוג GUID.
comments -- הערות להזמנה שהכניס הלקוח,
extraField1, - שדות אופצינאלים שהוגדרו בדף ההזמנה
extraField2, - שדות אופצינאלים שהוגדרו בדף ההזמנה
extraField3 - השדות האופצינאליים שבדף ההזמנה,

פרטי ההזמנה:

total - סה"כ ההזמנה בש"ח (כולל מע"מ).
vat - סכום המע"מ בש"ח.

פרטי שורות ההזמנה. כספית תשלח שורות ככל שישנן בהזמנה:

productId1 - המפתח של המוצר בכספית.
productCatalogNumber1 - המספר הקטלוגי של המוצר.
productName1 - שם המוצר
unitNumber1 - מספר היחידות (דפי ההזמנה מאפשרים רק מספר שלם, אבל בעיקרון מדובר ב-decimal. לדוגמה: 12.34)
unitPrice1 - עלות היחידה בש"ח (לדוגמה: 45.67)

אם ישנה שורה שניה אז כספית תשלח productId2, productCatalogNumber2, productName2, unitNumber2, unitPrice2 וכו'

הנה דוגמה להזמנה ובה 3 שורות הזמנה:

orderId=645ac655-4a41-4840-b831-f0b5af4d8e85-26f810ca-5111-4647-b911-3a332dff6cd2
orderNumber=10065
orderStatus=7
caspitBusinessId=dc30e052-b06c-469d-a388-63818d656f82
contactId=d85f96a0-4e77-427d-ba0c-6e47f86246ff
customerName=עזרא חובב ציון
osekMorshe=111111118
address1=כצנלסון 67
address2=דירה 6
city=רמת גן
postalCode=51345
mobilePhone=054-2334527
email=ezra34@test6363.co.il
total=6.5000000000000000000000000001
vat=0.9444444444444444444444444445
extraField1=מהנדס מכונות
extraField2=פייסבוק
extraField3=
TrxId=G535366-93838
comments=אני מבקש שהשליח יתקשר אלי לפני שיגיע.
documentNumber=01/20074
documentId=הזמנה 10065
referenceNumber=272964563
voucherNumber=02001013
productId1=1ce20266-776d-4eb2-a22d-fef065f8da8f
productCatalogNumber1=721
ProductName1=פריט 7 - סוס עץ
UnitNumber1=1
UnitPrice1=0.8547008547008547008547008547
productId2=28b522dc-9b75-4dc6-b7a5-4d347cc46813
productCatalogNumber2=4444444
ProductName2=פריט 4 - מיטה חבית
UnitNumber2=2
UnitPrice2=1.7094017094017094017094017094
productId3=a642563f-4a53-4736-b28d-4c81ed0b1136
productCatalogNumber3=3333333
ProductName3=פריט 3 - ארון מגירות
UnitNumber3=1
UnitPrice3=1.2820512820512820512820512821

171