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 |
Size Error (413)
The 413 Request Entity Too Large error occurs when the request payload exceeds the server's maximum allowed size. For this API, the limit is strictly set to 65,536 bytes (64 KB).
This most commonly happens when a single document contains a very high number of items (rows) or extremely long text descriptions.
Updated 7 days ago