מסמך עם תקבולים: מזומן, צ'ק, אשראי וניכוי במקור

הלקוח שילם, והתשלום נרשם במסמך

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

המדריך מסביר באילו מסמכים שולחים תקבולים, אילו סוגי תקבול אפשר לרשום ומה הכללים לכל אחד. יצירת המסמך עצמו מוסברת ביצירת מסמך מכירה דרך ה-API: סוגים, שורות, מע״מ והנחה.

רישום תשלום אינו גבייה. ה-API לא מחייב כרטיס אשראי ולא מבצע סליקה. תקבול באשראי רושם במסמך תשלום שכבר בוצע.

באילו מסמכים שולחים תקבולים

את התקבולים שולחים ברשימה payments, בשני סוגי מסמכים בלבד:

• קבלה (400): תקבולים בלבד. אין בה שורות, ולכן לא שולחים items וגם לא סוג מע״מ. רשימת שורות בקבלה נדחית עם "אין להעביר רשימת פריטים במסמך קבלה".
• חשבונית מס קבלה (320): גם שורות וגם תקבולים. סכום התקבולים חייב להיות שווה לסכום המסמך, אחרת חוזרת ההודעה "סכום התקבולים וסכום החיוב חייבים להיות זהים".

בשני הסוגים האלה התקבולים חובה, ובלעדיהם חוזרת ההודעה "לא הועבר אופן התשלום במסמך". בכל סוג מסמך אחר אסור לשלוח תקבולים, והבקשה נדחית.

סוגי התקבול

בכל תקבול שולחים את payment_type ואת הסכום ב-amount_nis, עד 2 ספרות אחרי הנקודה. לפי הסוג נדרשים שדות נוספים:

במזומן ובניכוי מס במקור התאריך נקבע לפי יום יצירת המסמך, גם אם נשלח תאריך אחר.

בקבלה אפשר לרשום גם ארבעה סוגים נוספים: 4 העברה בנקאית, 5 ביט, 6 PayPal ו-7 PayBox. בהעברה בנקאית בלי bank_account_id נרשם חשבון הבנק שמוגדר אצלכם כברירת מחדל. בקבלה עצמה הם מופיעים כ"ה. בנקאית", "ביט", "פייפאל" ו"פייבוקס".

קבלה שנוצרה דרך ה-API עם העברה בנקאית, ביט, PayPal, PayBox וכרטיס אשראי. מהכרטיס נשמרו רק 4 הספרות האחרונות.

הכללים לצ'ק ולכרטיס אשראי

צ'ק
תאריך הפירעון ב-due_date לא יכול להיות לפני היום. bank_code הוא קוד של בנק שקיים במערכת, branch_number הוא מספר סניף בן 3 תווים בדיוק, ומספר הצ'ק ב-cheque_number הוא לפחות 4 תווים.

כרטיס אשראי
credit_card_code הוא קוד של סוג כרטיס שקיים במערכת, ו-credit_card_number הוא לפחות 4 תווים.

מכרטיס האשראי נשמרות רק 4 הספרות האחרונות. גם כששולחים מספר כרטיס מלא, במסמך ובתשובה של document_get מופיעות רק הן. במספר הצ'ק מספיקות 4 הספרות האחרונות.

את רשימות קודי הבנקים וסוגי הכרטיסים מקבלים מצוות ביג בוס.

דוגמה: קבלה על תשלום במזומן

זה מבנה הבקשה לקבלה ללקוח קיים, עם תקבול אחד במזומן:

{
  "api_token": "xxxxxxxx",
  "request_reference": "ORDER-1001-PAY",
  "document_type": 400,
  "company_id": 5608,
  "payments": [
    { "payment_type": 1, "amount_nis": 50 }
  ]
}

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

מה אי אפשר לרשום

סוג תקבול שאינו ברשימה נדחה, למשל payment_type 8: "שורת תשלום מס' 1 סוג תשלום לא מוגדר". וקבלה שכבר נוצרה אפשר לבטל דרך ה-API, ב-document_cancel: הביטול מפיק החזר תקבול.

כל שכבת המדריכים מרוכזת בעמוד ממשק API בביג בוס.