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

שאלו את ה-AI

✦ תשובת ה-AI

חושב…

מקורות

    Financial - פירוט חיובים וזיכויים - (Finacial tranzaction)

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

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

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

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

    שיטת בקשה - POST.
    Finacial tranzaction

    https://secure.cardcom.solutions/api/v11/Financial/FinancialTransactions

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

    מקרא:

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

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

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

     

    מספר
         		 פרמטר ערכים אפשריים לדוגמא תיאור
    1 ApiName "kzFKfohEvL6AOF8aMEJz" שם API.
    2 ApiPassword "FIDHIh4pAadw3Slbdsjg" סיסמת API.
    3 FromCreateDate "25032025" למצוא עסקאות מתאריך X.
    4 ToCreateDate "26032025" למצוא עסקאות עד תאריך Y
    5 Page 1 מאיזה עמוד למשוך את פרטי רשימת העסקאות .
    7
    AddDepositedTransaction
    		 false מציג את העסקאות לפי CreateDate 
    8 Page_size 20 מה יהיה כמות השורות בעמוד שמהם אנחנו נמשוך את פרטי רשימת העסקאות.

     

     

     

    RESPONSE של Finacial tranzaction.

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

     

    ערכים של CreditCardTransactions (5).

    מספר
         		 פרמטר ערכים אפשריים לדוגמא תיאור
    1 Id (Int) מזהה עסקת אשראי פנימי.
    2 ARN (String) "2135146546" מזהה סולק, בחברת האשראי הסולקת.
    3 SapakNumber (Int) מספר ספק קארדקום.
    4 OrigTransactionAmount (Number)  סכום עסקה המקורית.
    5 BankDepositeId 105478 מקשר הפקדה לבנק.
    6 CreditCardTransactionsId 7127717 מזהה מספר עסקה.
    7 ConcentrationNumber 4064 מספר ריכוז.
    8 DepositeCurrency 376 מטבע הפיקדון - תמיד בשקל.
    9 ActionCode

    • NoActionCode – "לא קוד פעולה"

    • Purchase_1 – "רכישה"

    • Return_6 – "החזרה"

    • FeeCharge_10 – "עמלת חיוב"

    • CloseTXNReturn_11 – "סגירת עסקה והחזרה"

    • CHB_15 – "חיוב CHB"

    • CHBNoMerchandis_19 – "חיוב CHB ללא סחורה"

    • FeeChargeReturn_20 – "עמלת חיוב והחזרה"

    • CloseTXN_21 – "סגירת עסקה"

    • HOLD_24 – "החזקה"

    • Cancel_25 – "ביטול"

    • RevCHB_35 – "החזר חיוב CHB"

    • Rep_45 – "שחזור"

    • OriginalRequest_51 – "בקשה מקורית"

    • CopyRequest_52 – "בקשת העתק"

    • CHB2_65 – "חיוב CHB 2"

    • CHB2NoMerchandi_69 – "חיוב CHB 2 ללא סחורה"

    • RevCHB2_75 – "החזר חיוב CHB 2"

    • BlockedCard_90 – "כרטיס חסום"

    • NEW_ISSUER_NOTIFY_ISSUANCE_CARD_91 – "הנפקת כרטיס - הודעת ספק חדש"

    • OLD_ISSUER_RESPONSE_FOR_NOTIFY_92 – "תגובה מהספק הישן להודעה"

    • FRAUD_93 – "הונאה"

    • CANCEL_STANDING_ORDER_94 – "ביטול הוראת קבע"

    • CHANGE_CARD_STANDING_ORDER_95 – "שינוי הוראת קבע בכרטיס"

    • ISSUER_CANCEL_STANDING_ORDER_96 – "ביטול הוראת קבע על ידי הספק"

    • RESUME_CARD_97 – "החזרת כרטיס לפעולה"

    • CHANGE_NOT_ACTIVATED_CARD_98 – "שינוי כרטיס שלא הופעל"

    • CBH_SECOND_FULL_205 – "CBH שני מלא"

    • CBH_SECOND_PARTIAL_282 – "CBH שני חלקי"

    • CBH_FIRST_FULL_450 – "CBH ראשון מלא"

    • CBH_FIRST_FULL_451 – "CBH ראשון מלא"

    • CBH_FIRST_PARTIAL_453 – "CBH ראשון חלקי"

    • CBH_FIRST_PARTIAL_454 – "CBH ראשון חלקי"

    • PrePayment_1001 – "תשלום מראש"

    • PrePaymentFutureDebts_1002 – "תשלום מראש חובות עתידיים"

    • CHBCommition_1003 – "עמלת CHB"

    • CancelMTI520Commition_1004 – "ביטול עמלת MTI520"

    • RefundAC6Commition_1005 – "החזר עמלת AC6"

    • NotUsedRefundsSum_2001 – "סכום החזר שלא שולם"

    • GetMoneyFromMerchant_2002 – "קבלת כסף מסוחר"

    • FixVat_2003 – "תיקון מע"מ"

    • InternalTransactionRecalc_9001 – "חישוב מחדש של עסקה פנימית"

    		  מספר קוד פעולה
    10 CreditCardCurrency 376 מטבע העסקה 
    11  DepositeAmount 390.3900   סכום הפקדה.
    12 IfPct 0.01200000000000000000000 (Number)  אחוז % העמלה שנגבה מהעסקה.
    13  FeePerTrnAmt 0.0000 (Number)  עמלה פייר עסקה במטבע העסקה המקורי.
    14 FixFeeAmtDepoCurr 0.0000 עמלה קבועה במטבע ההפקדה (שקלים).
    15  MngtFeePct 0.0000 אחוז דמי ניהול
    16 BrutoOrgCurAmt 170.0000 סכום ברוטו במטבע המקורי
    17  DiscOrigCurrAmt 0.0000 הנחה במטבע המקורי
    18 ClDscOrgCurAmt 0.0000 סכום סופי לאחר הנחה במטבע המקורי
    19  DiscFreqShopAmt 0.0000 הנחה במקרים תכופים
    20 AftDiscAmtDepoCur 170.0000 סכום לאחר הנחה במטבע ההפקדה
    21  IfAmtDepoCur 2.0400 עמלה בשקלים פר עסקה
    22 VatPrc 0.1800 שיעור מע"מ
    23  VatIfNisDepoCur 0.3700 מע"מ אם בשקלים
    24 CurrencyOrIndexRate 0.0000 שער מטבע או מדד
    25 

    EffectiveCurrency

    OrIndexRate

    		 0.0000 שער מטבע או מדד אפקטיבי
    26 EstimateDepositeDate "2025-03-06T00:00:00" תאריך הפקדה משוער
    27  NoOfPmt 0 מספר תשלומים
    28 PmtNo 0 מספר תשלום
    29  TxnType 1 - רגיל, דחוי בחודשים
    2 - 30 +, עדיף
    3- חיוב מיידי
    6 - קרדיט
    7 - חיוב מיידי חדש
    8 - תשלומים
    12 - ישראקרדיט
    17 - חיוב מיידי כרטיס נטען
    71 - חלפנים
    78 - חלפנים תשלומים    		 סוג עסקה
    30 IndexLinkType 1 סוג קישור למדד
    31  PurchaseDate "2025-02-28T00:00:00" תאריך רכישה
    32 CreateDate "2025-03-02T13:43:54.7922104" תאריך יצירה
    33 UID "25022822501590562905492"

    מזהה עסקה יחודי.

    במידה ועשו הכחשה \ זיכוי \ ביטול מתוך העסקה, הUID של הפעולה החדשה הזאת יהיה זהה לעסקה המקורית.

    אם עשו זיכוי מחוץ לעסקה, למשל כעסקה חדשה עם אסימון, הUID יהיה חדש.
    34 Last4CardDigits 5794 ארבע הספרות האחרונות של הכרטיס
    35 SapakMutavNumber  0 מספר ספק מוטב

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

    דוגמא לקריאה:

    {
      "ApiName": "XFVXHjbcOxoYo",
      "ApiPassword": "85yikxn25pKZHg",
      "FromCreateDate": "01032025",
      "ToCreateDate": "26032025",
      "Page": "1",
      "Page_size": "20",
      "BankDepositeId": "<integer>"
    }

     

    דוגמא לתשובה המתקבלת:

     

    {
        "ResponseCode": 0,
        "Description": "ok",
        "Page": 1,
        "Page_size": 20,
        "FinancialTransactions": [
            {
                "FirstCardDigits": 401047,
                "Id": 7729027,
                "ARN": "24396415061000070987712",
                "SapakNumber": 1119361,
                "OrigTransactionAmount": 396.0000,
                "BankDepositesId": 105478,
                "BankDepositAt": "2025-03-06T00:00:00",
                "CreditCardTransactionsId": 7127717,
                "ConcentrationNumber": 40016493,
                "DepositeCurrency": 376,
                "ActionCode": 1,
                "CreditCardCurrency": 376,
                "DepositeAmount": 390.3900,
                "IfPct": 0.01200000000000000000000,
                "FeePerTrnAmt": 0.0000,
                "FixFeeAmtDepoCurr": 0.0000,
                "MngtFeePct": 0.0000,
                "BrutoOrgCurAmt": 396.0000,
                "DiscOrigCurrAmt": 0.0000,
                "ClDscOrgCurAmt": 0.0000,
                "DiscFreqShopAmt": 0.0000,
                "AftDiscAmtDepoCur": 396.0000,
                "IfAmtDepoCur": 4.7500,
                "VatPrc": 0.1800,
                "VatIfNisDepoCur": 0.8600,
                "CurrencyOrIndexRate": 0.0000,
                "EffectiveCurrencyOrIndexRate": 0.0000,
                "EstimateDepositeDate": "2025-03-06T00:00:00",
                "NoOfPmt": 0,
                "PmtNo": 0,
                "TxnType": 1,
                "IndexLinkType": 1,
                "PurchaseDate": "2025-02-28T00:00:00",
                "CreateDate": "2025-03-02T13:43:54.789908",
                "UID": "25022821592090562905497",
                "Last4CardDigits": 3436,
                "SapakMutavNumber": 0
            }
        ]
    }

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