API Error Codes
API Error Codes Reference
This page provides a reference for common error responses returned by the API, including example responses, explanations, error categories, and troubleshooting guidance.
How Error Responses Work
The API uses two layers of error reporting:
1. HTTP Status Code
Indicates the general type of error (e.g., 400, 401, 500).
2. API Error Body (JSON or HTML)
Provides detailed information about what went wrong, including:
error_codeclient_message(usually Hebrew, user-friendly)debug_message(internal English identifier)data(optional extra context)
Example Error Responses
Below are sample responses for the most common status codes.
400 - Bad Request
A 400 Bad Request occurs when the server cannot parse or validate the incoming request.
Example Response (HTML)
Returned mostly from SOAP/WCF-style endpoints
<html>
<head>
<title>Request Error</title>
</head>
<body>
<h1>Request Error</h1>
<p>The server encountered an error processing the request. Please see the
<a href="https://icredit.rivhit.co.il/API/PaymentPageRequest.svc/help">
service help page</a> for constructing valid requests to the service.
</p>
</body>
</html>Common Causes
- Invalid JSON/XML (malformed body)
- Missing required fields
- Incorrect Content-Type header
- Sending JSON to a SOAP endpoint (or vice-versa)
- Field types do not match the schema
500 – Internal Server Error
A 500 indicates that the request reached the server, but an unexpected error prevented processing.
Example Response (JSON)
{
"error_code": -94,
"client_message": "הסכום אינו תקין",
"debug_message": "-94 : INVALID_AMOUNT",
"data": null
}Field Descriptions
| Field | Type | Description |
|---|---|---|
error_code | Integer | The unique numeric identifier for the error. |
client_message | String | A message intended for display to the user or client. |
debug_message | String | A message providing the internal, English-language code |
data | String | Additional error context. |
Error Code Categories
Below is a list of API error codes grouped by category.
Data Validation Errors
These errors typically mean the data sent in the request body is incorrect, missing, or invalid.
error_code | client_message Code | debug_message Code |
|---|---|---|
| -1 | שגיאה כללית במסד הנתונים | -1 : GENERAL_DB_ERROR |
| -2 | לא נמצאו נתונים | -2 : NO_DATA_FOUND |
| -3 | WRONG_ARGUMENTS_FOR_FUNCTION | -3 : WRONG_ARGUMENTS_FOR_FUNCTION |
| -4 | INVALID_ARGUMENTS_FOR_FUNCTION | -4 : INVALID_ARGUMENTS_FOR_FUNCTION |
| -20 | הלקוח אינו קיים | -20 : CUSTOMER_NOT_EXISTS |
| -21 | סוג הלקוח אינו קיים | -21 : CUSTOMER_TYPE_NOT_EXISTS |
| -22 | הלקוח אינו קיים | -22 : CUSTOMER_NOT_EXISTS |
| -23 | סוג המסמך אינו קיים | -23 : HENTYPE_NOT_EXISTS |
| -24 | הפריט אינו קיים | -24 : ITEM_NOT_EXISTS |
| -25 | שם הלקוח אינו תקין | -25 : INVALID_CUSTOMER_NAME |
| -26 | תא דואר אינו תקין | -26 : INVALID_POB |
| -27 | המיקוד אינו תקין | -27 : INVALID_ZIPCODE |
| -28 | ת.ז אינה תקינה | -28 : INVALID_ID_NUMBER |
| -29 | ע.מ אינו תקין | -29 : INVALID_VAT_NUMBER |
| -30 | קוד הסוכן אינו תקין | -30 : INVALID_AGENT_NUMBER |
| -31 | קוד הפרויקט אינו תקין | -31 : INVALID_PROJECT_NUMBER |
| -32 | הלקוח המשלם אינו תקין | -32 : INVALID_PAYING_CUSOMER |
| -33 | קוד מחירון אינו תקין | -33 : INVALID_PRICE_LIST |
| -34 | סוג הלקוח אינו תקין | -34 : INVALID_CUSTOMER_TYPE |
| -35 | קוד רווח והפסד אינו תקין | -35 : INVALID_PALCODE |
| -36 | הסוכן אינו קיים | -36 : AGENT_NOT_EXISTS |
| -37 | הפרויקט אינו קיים | -37 : PROJECT_NOT_EXISTS |
| -38 | הלקוח המשלם אינו קיים | -38 : PAYING_CUSTOMER_NOT_EXISTS |
| -39 | קוד מחירון לא קיים | -39 : PRICE_LIST_NOT_EXISTS |
| -40 | קוד רווח והפסד לא קיים | -40 : PAL_CODE_NOT_EXISTS |
| -41 | קוד הלקוח אינו תקין | -41 : INVALID_CUSTOMER_ID |
| -42 | סוג המסמך אינו תקין | -42 : INVALID_DOCUMENT_TYPE |
| -43 | סוג המסמך אינו קיים | -43 : DOCUMENT_TYPE_NOT_EXISTS |
| -44 | האסמכתא אינה תקינה | -44 : INVALID_ASMACHTA |
| -45 | שדה הזמנה ארוך מידי (מוגבל ל-80 תוים) | -45 : ORDER_SIZE_TO_BIG |
| -46 | שדה הערות ארוך מידי (מוגבל ל-400 תוים) | -46 : COMMENTS_SIZE_TO_BIG |
| -47 | קוד המיון אינו תקין | -47 : INVALID_SORTCODE |
| -48 | קוד המיון אינו קיים | -48 : SORTCODE_NOT_EXISTS |
| -49 | סוג ההנחה אינו תקין | -49 : INVALID_DISCOUNT_TYPE |
| -50 | ערך ההנחה אינו תקין | -50 : INVALID_DISCOUNT_VALUE |
| -51 | קוד מחיר פריט לא תקין (צ"ל כולל / ללא מע"מ) | -51 : INVALID_INCLUDE_VAT_INDICATOR |
| -52 | תאריך הפרעון אינו תקין | -52 : INVALID_DUE_DATE |
| -53 | קוד מטבע חוץ אינו תקין | -53 : INVALID_MTC_CODE |
| -54 | קוד מטבע חוץ אינו קיים | -54 : MTC_CODE_NOT_EXISTS |
| -55 | INVALID_PRINT_ORIGINAL_PARAMETER | -55 : INVALID_PRINT_ORIGINAL_PARAMETER |
| -56 | INVALID_PRINT_COPY_PARAMETER | -56 : INVALID_PRINT_COPY_PARAMETER |
| -57 | INVALID_PRINT_TYPE | -57 : INVALID_PRINT_TYPE |
| -58 | UNSUPPORTED_PPINT_TYPE | -58 : UNSUPPORTED_PPINT_TYPE |
| -59 | INVALID_REJECT_QUANTITY | -59 : INVALID_REJECT_QUANTITY |
| -60 | INVALID_UPDATE_INVENTORY_PARAMETER | -60 : INVALID_UPDATE_INVENTORY_PARAMETER |
| -61 | מספר הפריטים שהועברו אינו תקין | -61 : INVALID_NUMBER_ITEMS_RECORDS |
| -62 | NUMBER_ITEMS_RECORDS_NOT_MATH | -62 : NUMBER_ITEMS_RECORDS_NOT_MATH |
| -63 | קוד הפריט אינו תקין | -63 : INVALID_ITEM_NUMBER |
| -64 | כמות הפריטים אינה תקינה | -64 : INVALID_Quantity |
| -65 | המחיר בש"ח אינו תקין | -65 : INVALID_PRICE_NIS |
| -66 | המחיר במט"ח אינו תקין | -66 : INVALID_PRICE_MTC |
| -67 | שער המט"ח אינו תקין | -67 : INVALID_MTC_RATE |
| -68 | לא ניתן להפיק מסמך במט"ח עם מטבעות שונים | -68 : DIFFERENT_MTC_CODES_IN_MTC_DOCUMENT |
| -69 | UPDATE_ACC_Balance_FAILED | -69 : UPDATE_ACC_Balance_FAILED |
| -71 | KABALA_TYPE_IN_CREATE_DOC | -71 : KABALA_TYPE_IN_CREATE_DOC |
| -73 | לא הוגדר חשבון מע"מ | -73 : VAT_ACCOUNT_NOT_DEFINED |
| -74 | ACCOUNTING_UPDATE_FAILED | -74 : ACCOUNTING_UPDATE_FAILED |
| -75 | INVALID_PPINT_FOLDER | -75 : INVALID_PPINT_FOLDER |
| -76 | המסמך אינו קיים | -76 : DOCUMENT_NOT_EXISTS |
| -77 | מספר המסמך אינו תקין | -77 : INVALID_DOCUMENT_NUMBER |
| -78 | INVALID_NUMBER_COPIES | -78 : INVALID_NUMBER_COPIES |
| -79 | שם הפריט אינו תקין | -79 : INVALID_ITEM_NAME |
| -80 | INVALID_COST_PRICE | -80 : INVALID_COST_PRICE |
| -81 | INVALID_SALE_PRICE | -81 : INVALID_SALE_PRICE |
| -82 | INVALID_PART_NUM | -82 : INVALID_PART_NUM |
| -83 | עדכון המלאי נכשל | -83 : UPDATE_INVENTORY_FAILED |
| -84 | קוד משתמש CRM לא תקין | -84 : INVALID_CRM_USER_ID |
| -85 | סוג הקבלה אינו תקין | -85 : INVALID_RECEIPT_TYPE |
| -86 | לא נשלחו תשלומים לקבלה | -86 : RECEIPT_MISSING_PAYMENTS_RECORDS |
| -87 | סוג הקבלה אינו נתמך | -87 : RECEIPT_TYPE_NOT_SUPPORTED |
| -88 | סוג הקבלה אינו קיים | -88 : RECEIPT_TYPE_NOT_EXISTS |
| -90 | קוד מחסן לא תקין | -90 : INVALID_STORAGE |
| -91 | קוד מחסן לא קיים | -91 : STORAGE_NOT_EXISTS |
| -92 | סוג התשלום אינו תקין | -92 : INVALID_PAY_CODE |
| -93 | סוג התשלום אינו קיים | -93 : PAY_CODE_NOT_EXISTS |
| -94 | הסכום אינו תקין | -94 : INVALID_AMOUNT |
| -95 | מספר השיק אינו תקין | -95 : INVALID_CHECK_NUM |
| -96 | קוד הבנק אינו תקין | -96 : INVALID_BANK_CODE |
| -97 | קוד הבנק אינו קיים | -97 : BANK_CODE_NOT_EXISTS |
| -98 | סניף הבנק אינו תקין | -98 : INVALID_BRANCH_NUM |
| -99 | מספר חשבון אינו תקין | -99 : INVALID_ACCOUNT_NUM |
| -100 | הסכום במט"ח אינו תקין | -100 : INVALID_MTC_AMOUNT |
| -113 | הסכום אינו תואם בין החשבונית לקבלה | -113 : DIFFERENT_AMOUNT_BETWEEN_INVOICE_AND_RECEIPT |
| -114 | שם המשתמש כבר קיים במערכת | -114 : USER_ALREADY_EXISTS |
| -112 | החברה כבר קיימת במערכת | -112 : COMPANY_ALREADY_EXISTS |
| -101 | אין אפשרות למחוק את הפריט | -101 : CANT_DELETE_ITEM |
| -102 | אין אפשרות למחוק את הלקוח | -102 : CANT_DELETE_CUSTOMER |
| -103 | הסכום שהועבר גבוה מהסכום המותר | -103 : DONATION_LIMIT |
| -104 | סוג הנהלת החשבונות אינו קיים (1-חד צידית, 2- כפולה) | -104 : INVALID_ACCOUNTING_TYPE |
| -105 | שם המשתמש אינו תקין, עליו להיות מורכב מאותיות באנגלית וספרות בלבד | -105 : INVALID_USERNAME |
| -106 | על סכום הזיכוי להיות שלילי | -106 : INVALID_AMOUNT_NEGATIVE |
| -107 | כבר בוצעה בקשה עם אותו מזהה בקשה | -107 : REQUEST_ALREADY_PROCESSED |
| -108 | מספר הטלפון ארוך מידי (מוגבל ל-15 תוים) | -108 : PHONE_NUMBER_TOO_LONG |
| -109 | מספר כרטיס כבר קיים במערכת | -109 : CUSTOMER_ALREADY_EXISTS |
| -115 | INVALID_PRINT_FOLDER | -115 : INVALID_PRINT_FOLDER |
| -116 | רשומת תקבול אינה תקינה | -116 : WRONG_PAYMENT_RECORD |
| -117 | משתמש CRM לא קיים | -117 : CRM_USER_ID_NOT_EXISTS |
| -118 | DOCUMENT_CREATE_RECEIPT_ERROR | -118 : DOCUMENT_CREATE_RECEIPT_ERROR |
| -119 | IN_gf_item_movement | -119 : IN_gf_item_movement |
| -121 | המספר הסידורי לא במלאי | -121 : SERIAL_NUMBER_NOT_AVIALABLE |
| -122 | המספר הסידורי לא קיים | -122 : SERIAL_NUMBER_NOT_EXISTS |
| -123 | אין מלאי מספרים סידוריים | -123 : NO_AVIALABLE_SERIAL_NUMBER |
| -124 | כשל בעדכון מלאי מספר סידורי | -124 : UPDATE_SERIAL_NUMBERS_FAILED |
| -125 | כשל בעדכון הסטוריית מספר סידורי | -125 : UPDATE_SERIAL_NUMBERS_HISTORY_FAILED |
| -126 | כמות לא תקינה למספר סידורי | -126 : INVALID_SERIAL_AMOUNT |
| -130 | קוד מבנה אחיד אינו תקין | -130 : INVALID_PAYCODE_FORMAT |
| -131 | הגדרת אמצעי תשלום שגויה - חסר כרטיס חשבון | -131 : PAYMENT_CUST_ID_MISSING |
| -120 | OPEN_NEW_MONTH_FAILED | -120 : OPEN_NEW_MONTH_FAILED |
| -72 | חודש סגור, לא ניתן להוסיף תנועות יומן | -72 : MONTH_IS_CLOSED |
| -70 | INSERT_ACC_RECORD_FAILED | -70 : INSERT_ACC_RECORD_FAILED |
| -127 | חסרים נתונים בטבלת ערכי מע"מ | -127 : INVALID_VAT_DATA |
| -128 | הערך צריך להיות חיובי עד 9 ספרות | -128 : INVALID_SHAAM_INVOICE_VALUE |
| -992 | לא התקבל מספר הקצאה | -992 : SHAAM_INVOICE_NOT_APPROVED |
| -993 | על מנת לקבל מספר הקצאה מרשות המיסים, חובה להזין ת.ז | -993 : SHAAM_VAT_NUMBER_MISSING |
| -994 | לחשבון המזוהה אין הרשאה לפעול בשם התאגיד | -994 : SHAAM_PERMISSION_NEEDED |
| -995 | שגיאה כללית מול רשות המיסים | -995 : SHAAM_ERROR |
| -996 | יש לבצע אימות מול רשות המיסים | -996 : SHAAM_AUTHORIZATION_NEEDED |
| -997 | פורמט השעה אינו תקין | -997 : BAD_TIME_FORMAT |
| -998 | פורמט התאריך אינו תקין | -998 : BAD_DATE_FORMAT |
| -999 | RUNTIME ERROR | -999 : RUNTIME_ERROR |
| -1000 | שגיאה בלתי צפויה | -1000 : UNHANDLED_EXCEPTION |
| -1001 | רשיון לא בתוקף | -1001 : INVALID_LICENCE_KEY |
| -9997 | כתובת IP לא מורשית | -9997 : UNAUTHORIZED_IP |
| -9998 | שגיאת התחברות | -9998 : CONNECTION_ERROR |
| -9999 | שגיאת הרשאות | -9999 : UNAUTHORIZED |
Updated 8 days ago