מרכז הידע / ממשקים API

שאלו את ה-AI

✦ תשובת ה-AI

חושב…

מקורות

    להצליב מסמך למסמך אחר - (Cross document)

    מתי להשתמש בפונקציה זו?

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

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

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

    להלן קישור לפונקציה בJSON.

    שיטת בקשה - POST.
    Cross document

    https://secure.cardcom.solutions/api/v11/Documents/CrossDocument

    להלן הפרמטרים שצרים להעביר בפונקציה Cross document.

    מקרא:

    פרמטר אדום - חובה

    פרמטר מודגש - מומלץ

    פרמטר לא אדום ולא מודגש - אופציונלי

    מספר פרמטר ערכים אפשריים לדוגמא תיאור
    1 ApiName "test2025" שם משתמש ממשקים. יש לקבל פרמטר זה מבית העסק. 
    2 ApiPassword "kzFKfohEvL6AOF8aMEJz" סיסמת API, מיועד לזיכוי וביטול עסקאות.
    3 FromDocNumber 500 אפשר לשים קבלה \ חשבונית מס שאליו יוצלב המסמך.
    4 FromDocType

    1 - חשבונית מס קבלה

    2 -  חשבונית זיכוי והחזר כספים
    3 - קבלה מלכ"ר / פטור מע"מ
    4 - קבלה מלכ"ר זיכוי (החזר כספים)

    50- הצעת מחיר

    100 - הזמנה (ללא תשלום)

    101 - אישור הזמנה - מאתר  ( מסמך פנימי לא להנח"ש) - הזמנה ששולמה
    102 - זיכוי הזמנה - מאתר (מסמך פנימי לא להנח"ש) - הזמנה שזוכתה

    200 - תעודת משלוח 210 - תעודת החזרה

    300 - חשבון עסקה

    301 - דרישה לתשלום

    302 - ביטול דרישה לתשלום

    303 - חשבון קבלה פרופורמה

    305 - חשבונית מס

    330 - חשבונית זיכוי
    400 - קבלה (לחשבונית)

    410 - החזר כספים לקוחות(קבלה זיכוי)

    405 - קבלה על תרומה

    406 - זיכוי קבלה תרומה(החזר כספים)

    303 - חשבון קבלה (כמו חשבונית לעוסק פטור , נדיר לשימוש) 304 - חשבון קבלה זיכוי

    		 הסוג מסמך שאליו מצליבים מסמך.
    5

    ToDocumentsList

    מערך של אובייקטים.

    DocNumber - INT

    --------------------------------------------------------

    DocType - INT

    --------------------------------------------------------

    PartialSumToCorss - INT

    ToDocumentsList

    המסמך השני להצלבה.

    ---

    DocNumber - מספר מסמך שאליו להצליב.

    ---

    DocType - הסוג מספר שאליו להצליב (זה אותו ערך כמו FromDocType )

    ---

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

     

     RESPONSE של Cross document.

    מספר פרמטר ערכים אפשריים לדוגמא תיאור
    1 ResponseCode 0 קוד תשובה, אם שווה לאפס הפונקציה בוצעה בצורה תקינה. בכל תשובה אחרת, הפעולה לא הייתה תקינה.
    2 Description "OK" תיאור התשובה. ''OK'' זה טוב.

     

    להלן קוד לדוגמא לפונקציה ביחד עם התשובה.

    דוגמא לקריאה להצלבת מסמכים:

    {
      "ApiName": "test2025",
      "ApiPassword": "test5000$",
      "FromDocNumber": "5118",
      "FromDocType": "305",
      "ToDocumentsList": [
        {
          "DocNumber": "6444",
          "DocType": "400",
          "PartialSumToCorss": "50"
        }
      ]
    }

     

    תשובה המתקבלת:

    {
        "ResponseCode": 0,
        "Description": "OK"
    }

    האם המאמר הזה עזר לך?