תיעוד API של Infoproff - v3

גרסת המתג V3

התחלת העבודה

שירות האינטרנט wsdl והסכמות נמצאים כאן:

http://wsdfn.infoproff.com/v3/

Web service functions:

  • SimpleSearch - חפש מידע על חברות במדינות שונות.
  • ChkFinance - חפש דוחות כספיים זמינים.
  • Order - יוצר order_id ומחזיר כפילויות. הכפילויות נבחרות על פי הפרמטרים הבאים: country, product, reg_code.
  • OrderCancellation - אם שלחת בקשת הזמנה וקיבלת את order_id, יש לך אפשרות לבטל הזמנה זו (אם היא לא נכנסה לייצור).
  • OrderConfirmation - לאחר קבלת order_id, עליך לאשר את הזמנתך תוך שעה. אם לא תאשר את הזמנתך תוך שעה, ההזמנה תבוטל אוטומטית.
  • ChkStatus - בדוק את סטטוס ההזמנה.
  • GetReport - קבל דוחות סופיים.
  • GetClassifiersFinancialStatements - קבל את כל המסמכים הפיננסיים עם כל האלמנטים: row_number, row_formated_description, row_lang_key ו-row_order.
  • GetLegalForms - קבל את כל הטפסים המשפטיים עבור כל המדינות הזמינות.
  • GetActivityClassificators - קבל את כל הקודים והתיאורים עבור סיווג פעילות ספציפי.
  • GetDictionaryStandardPhrases - קבל את כל הביטויים הסטנדרטיים עם מקשים ושפה.
  • GetAvailableProducts - קבל רשימה של המוצרים הזמינים.
  • CreditOpinionCalculator - מחשבון חוות דעת אשראי מסייע בהענקת חוות דעת אשראי לחברה.

API מספקת מספר שירותים:

  1. דוחות אשראי מקוונים עבור המדינות הבאות: אוסטריה (AUT), אזרבייג'ן (AZE), איטליה (ITA), אירלנד (IRL), אסטוניה (EST), בולגריה (BGR), בלגיה (BEL), גרמניה (DEU), דנמרק (DNK), הולנד (NLD), הונגריה (HUN), הממלכה המאוחדת (GBR), יוון (GRC), לוקסמבורג (LUX), לטביה (LVA), מולדובה (MDA), מונגוליה (MNG), מלטה (MLT), נורבגיה (NOR), סין (CHN), סלובניה (SVN), סלובקיה (SVK), ספרד (ESP), פולין (POL), פורטוגל (PRT), פינלנד (FIN), צ'כיה (CZE), צרפת (FRA), קזחסטן (KAZ), קירגיזסטן (KGZ), קרואטיה (HRV), רוסיה (RUS), שבדיה (SWE), שווייץ (CHE)
  2. דוחות לא מקוונים עבור המדינות הבאות: כל המדינות
  3. מחשבון חוות דעת אשראי
  4. Company search

איך לחפש חברה?

חיפוש החברה כולל 2 אפשרויות:

  1. חיפוש לפי שם חברה,
  2. Search by company code.
רשימת המדינות הזמינות: אוזבקיסטן (UZB), אוסטריה (AUT), אוסטרליה (AUS), אורוגוואי (URY), אזרבייג'ן (AZE), איחוד מחדש (REU), איטליה (ITA), איסלנד (ISL), אירלנד (IRL), אלבניה (ALB), אלג'יריה (DZA), אנגולה (AGO), אסטוניה (EST), אקוודור (ECU), ארגנטינה (ARG), אתיופיה (ETH), בולגריה (BGR), בוליביה (BOL), בוסניה והרצגובינה (BIH), בוצואנה (BWA), בלארוס (BLR), בלגיה (BEL), בנין (BEN), ברזיל (BRA), ג'רזי (JEY), גאורגיה (GEO), גואדלופ (GLP), גיאנה (GUY), גיאנה הצרפתית (GUF), גינאה (GIN), גמביה (GMB), גרינלנד (GRL), גרמניה (DEU), דנמרק (DNK), דרום אפריקה (ZAF), האי מאן (IMN), האיים המלדיביים (MDV), הולנד (NLD), הונג קונג (HKG), הונגריה (HUN), הממלכה המאוחדת (GBR), הפיליפינים (PHL), ונצואלה (VEN), זימבבואה (ZWE), זמביה (ZMB), חוף השנהב (CIV), טג'יקיסטן (TJK), טוגו (TGO), טנזניה (TZA), יוון (GRC), יפן (JPN), ישראל (ISR), לוקסמבורג (LUX), לטביה (LVA), ליטא (LTU), ליכטנשטיין (LIE), מאוריציוס (MUS), מאיוט (MYT), מדגסקר (MDG), מולדובה (MDA), מונגוליה (MNG), מונקו (MCO), מלטה (MLT), מרוקו (MAR), מרטיניק (MTQ), נורבגיה (NOR), ניגריה (NGA), ניו זילנד (NZL), נמיביה (NAM), סיישל (SYC), סין (CHN), סין (TWN), סינגפור (SGP), סלובניה (SVN), סלובקיה (SVK), סמואה (WSM), סן מרטן (MAF), סן מרינו (SMR), ספרד (ESP), סרביה (SRB), סרי לנקה (LKA), פולין (POL), פורטוגל (PRT), פינלנד (FIN), פרגוואי (PRY), פרו (PER), צ'ילה (CHL), צ'כיה (CZE), צרפת (FRA), קונגו (COG), קוסובו (XXK), קזחסטן (KAZ), קירגיזסטן (KGZ), קנדה (CAN), קניה (KEN), קפריסין (CYP), קרואטיה (HRV), רואנדה (RWA), רומניה (ROU), רוסיה (RUS), שבדיה (SWE), שווייץ (CHE), תאילנד (THA)

The search for other countries is performed only in the database of archived reports. If you do not find the desired company, enter the company details manually.

מידע חשוב:

search_result_id can be acquired here for orders with delivery_term = "o" or delivery_term = "a".

It may take up to 20 seconds to respond to a search request in the following countries: United Kingdom, Ireland, France, Spain, Portugal, Germany, Italy, Austria, Switzerland.

המרשם הנורבגי אינו מאפשר חיפוש חברות שנמחקו לפי שמות. לכן, איננו יכולים לספק {חיפוש פשוט} לפי שמות בתוך חברות שנמחקו בנורבגיה.

Field's length:
company_name varchar(512)
company_code varchar(64)

להלן דוגמה:

פונקציה SimpleSearch

אפשרות 2: חיפוש לפי קוד רישום

פונקציה SimpleSearch

Option 3: Search by query (by name or code)

פונקציה UnifiedSearch

כיצד להזמין דוח אשראי?

List of available countries for online credit reports: אוסטריה (AUT), אזרבייג'ן (AZE), איטליה (ITA), אירלנד (IRL), אסטוניה (EST), בולגריה (BGR), בלגיה (BEL), גרמניה (DEU), דנמרק (DNK), הולנד (NLD), הונגריה (HUN), הממלכה המאוחדת (GBR), יוון (GRC), לוקסמבורג (LUX), לטביה (LVA), מולדובה (MDA), מונגוליה (MNG), מלטה (MLT), נורבגיה (NOR), סין (CHN), סלובניה (SVN), סלובקיה (SVK), ספרד (ESP), פולין (POL), פורטוגל (PRT), פינלנד (FIN), צ'כיה (CZE), צרפת (FRA), קזחסטן (KAZ), קירגיזסטן (KGZ), קרואטיה (HRV), רוסיה (RUS), שבדיה (SWE), שווייץ (CHE)
Field's length:
business_name varchar(512)
reg_code varchar(64)
vat_code varchar(64)
address varchar(512)
phone varchar(256)
email varchar(256)
additional_info varchar(512)
ref_code varchar(64)

Below you can find the example of how to order and download reports:

STEP 1: Find a company (Online/Offline Order (with search_result_id))

פונקציה SimpleSearch

To order an Online/Offline with identification report you need to receive "<search_result_id>".
To do so, please follow the link: איך לחפש חברה?

The search allows you to accurately identify the company you wish to place an order for. For example, in some countries, there may be several companies with one registration number, or the same official name may belong to several companies.

STEP 2: Order a report (Online/Offline Order (with search_result_id))

פונקציה Order
If you won't use the element confirm_order, then you will receive <last_duplicates> in the XML response, so that you can decide if you really need to place an order.

STEP 3: Order cancellation (Optional) (Online/Offline Order (with search_result_id))

פונקציה OrderCancellation
If you wish to cancel the order, you can use this OrderCancellation function. If the order is already in progress, then you won't be able to cancel it.

STEP 4: Order confirmation (Online/Offline Order (with search_result_id))

פונקציה OrderConfirmation
If you didn't use the element "confirm_order", then you need to confirm your order.

STEP 5: Check order status (Online/Offline Order (with search_result_id))

פונקציה ChkStatus
  • - For offline orders checking order status once every 30 minutes is acceptable frequency.
  • - For online orders checking order status once every 5 seconds is acceptable frequency.

הסטטוסים הבאים משמשים לדוחות:

  • בתהליך - דו"ח בשלב הייצור
  • Identification pending - הכנת הדוח בהמתנה. נדרשים נתונים נוספים מהלקוח.
  • Canceled - הזמנה מבוטלת
  • Finished - הדו"ח מוכן
  • Updated - המידע נוסף לדוח הסופי.
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - אירעה שגיאה טכנית במערכת שלנו. פירוש הדבר הוא שאנו מודעים לשגיאה זו ונתקן אותה בהקדם האפשרי. תודע לך מתי תוכל לקבל את ההזמנה.

אם מצב הביצוע הוא Finished או Updated, תוכל לקבל הזמנה.

STEP 6: Get report (Online/Offline Order (with search_result_id))

פונקציה GetReport
רשימת השפות הזמינות: ar (Arabic), az (Azerbaijani), bg (בולגרי), cs (צ'כי), da (דני), de (גרמני), el (יווני), en (אנגלית), es (ספרדית), et (אסטונית), fi (פינית), fr (צרפתית), he (Hebrew), hi (Hindi), hu (הונגרי), hy (Armenian), id (אינדונזי), it (איטלקי), ja (יפנית), ka (Georgian), kk (Kazakh), ko (קוריאני), lt (ליטאי), lv (לטבית), mn (Mongolian), ms (Malay), nb (נורווגית בוקמאל), nl (הולנדית), pl (פולני), pt (פורטוגזית), ro (רומנית), ru (רוסית), sk (סלובקי), sl (סלובנית), sr (Српски), sv (שוודית), th (Thai), tr (טורקי), uk (אוקראיני), uz (Uzbek), vi (Vietnamese), zh (סינית)

STEP 1: Order a report (Offline Order (without search_result_id))

פונקציה Order
If you won't use the element confirm_order, then you will receive <last_duplicates> in the XML response, so that you can decide if you really need to place an order.

STEP 2: Order cancellation (Optional) (Offline Order (without search_result_id))

פונקציה OrderCancellation
If you wish to cancel the order, you can use OrderCancellation function. If the order is already in progress, then you won't be able to cancel it.

STEP 3: Order confirmation (Offline Order (without search_result_id))

פונקציה OrderConfirmation
If you didn't use the element "confirm_order", then you need to confirm your order.

STEP 4: Status Checking (Offline Order (without search_result_id))

פונקציה ChkStatus
For offline orders checking order status once every 30 minutes is acceptable frequency.

הסטטוסים הבאים משמשים לדוחות:

  • בתהליך - דו"ח בשלב הייצור
  • Identification pending - הכנת הדוח בהמתנה. נדרשים נתונים נוספים מהלקוח.
  • Canceled - הזמנה מבוטלת
  • Finished - הדו"ח מוכן
  • Updated - המידע נוסף לדוח הסופי.
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - אירעה שגיאה טכנית במערכת שלנו. פירוש הדבר הוא שאנו מודעים לשגיאה זו ונתקן אותה בהקדם האפשרי. תודע לך מתי תוכל לקבל את ההזמנה.

אם מצב הביצוע הוא Finished או Updated, תוכל לקבל הזמנה.

STEP 5: Get report (Offline Order (without search_result_id))

פונקציה GetReport
רשימת השפות הזמינות: ar (Arabic), az (Azerbaijani), bg (בולגרי), cs (צ'כי), da (דני), de (גרמני), el (יווני), en (אנגלית), es (ספרדית), et (אסטונית), fi (פינית), fr (צרפתית), he (Hebrew), hi (Hindi), hu (הונגרי), hy (Armenian), id (אינדונזי), it (איטלקי), ja (יפנית), ka (Georgian), kk (Kazakh), ko (קוריאני), lt (ליטאי), lv (לטבית), mn (Mongolian), ms (Malay), nb (נורווגית בוקמאל), nl (הולנדית), pl (פולני), pt (פורטוגזית), ro (רומנית), ru (רוסית), sk (סלובקי), sl (סלובנית), sr (Српски), sv (שוודית), th (Thai), tr (טורקי), uk (אוקראיני), uz (Uzbek), vi (Vietnamese), zh (סינית)

כיצד להזמין דוח אשראי מאוחסן?

Purchase of an archived report is available for all countries.

Below you can find the example of how to order and download archived reports:

STEP 1: Find a company

פונקציה SimpleSearch

To order an archived report you need to receive "<search_result_id>" which has an "<archived_reports>" section that contains a product you need.
To do so, please follow the link: איך לחפש חברה?

Example companies with archived reports:

  • Country: EST, Reg. Code: 12309116
  • Country: EST, Reg. Code: 12854256
  • Country: EST, Reg. Code: 12830238
  • Country: USA, Company name: Apple

STEP 2: Order a report

פונקציה Order

STEP 3: Order cancellation (Optional)

Just like the online/offline reports.

STEP 4: Order confirmation

Just like the online/offline reports.

STEP 5: Check order status

Just like the online/offline reports.

For archived orders checking order status once every 5 seconds is acceptable frequency.

STEP 6: Get report

Just like the online/offline reports.

כיצד להזמין דוחות כספיים מקוונים?

STEP 1: Find a company

פונקציה SimpleSearch

To order an online financial statements, you need to receive "<search_result_id>".
To do so, please follow the link: איך לחפש חברה?

The search allows you to accurately identify the company you wish to place an order for. For example, in some countries, there may be several companies with one registration number, or the same official name may belong to several companies.

STEP 2: חפש דוחות כספיים זמינים

פונקציה ChkFinance

פונקציה זו נדרשת רק בעת הזמנת מוצר: finances (Financial statements) עם delivery_term = 'o'.

רשימת המדינות הזמינות: אסטוניה (EST), שבדיה (SWE)

STEP 3: הזמנת דוחות כספיים

פונקציה Order
If you won't use the element confirm_order, then you will receive <last_duplicates> in the XML response, so that you can decide if you really need to place an order.

STEP 4: Order cancellation (Optional)

פונקציה OrderCancellation
If you wish to cancel the order, you can use this OrderCancellation function. If the order is already in progress, then you won't be able to cancel it.
To see the examples of xml request/response, please follow the link: How to cancel the order?

STEP 5: Order confirmation

פונקציה OrderConfirmation
If you didn't use the element "confirm_order", then you need to confirm your order.
To see the examples of xml request/response, please follow the link: How to confirm the order?

STEP 6: Check order status

פונקציה ChkStatus
  • - For online orders checking order status once every 5 seconds is acceptable frequency.

הסטטוסים הבאים משמשים לדוחות:

  • בתהליך - דו"ח בשלב הייצור
  • Identification pending - הכנת הדוח בהמתנה. נדרשים נתונים נוספים מהלקוח.
  • Canceled - הזמנה מבוטלת
  • Finished - הדו"ח מוכן
  • Updated - המידע נוסף לדוח הסופי.
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - אירעה שגיאה טכנית במערכת שלנו. פירוש הדבר הוא שאנו מודעים לשגיאה זו ונתקן אותה בהקדם האפשרי. תודע לך מתי תוכל לקבל את ההזמנה.

If the execution status is Finished or Updated, then you can get an order.

To see the examples of xml request/response, please follow the link: How to check order status?

STEP 7: Get report

פונקציה GetReport
רשימת השפות הזמינות: ar (Arabic), az (Azerbaijani), bg (בולגרי), cs (צ'כי), da (דני), de (גרמני), el (יווני), en (אנגלית), es (ספרדית), et (אסטונית), fi (פינית), fr (צרפתית), he (Hebrew), hi (Hindi), hu (הונגרי), hy (Armenian), id (אינדונזי), it (איטלקי), ja (יפנית), ka (Georgian), kk (Kazakh), ko (קוריאני), lt (ליטאי), lv (לטבית), mn (Mongolian), ms (Malay), nb (נורווגית בוקמאל), nl (הולנדית), pl (פולני), pt (פורטוגזית), ro (רומנית), ru (רוסית), sk (סלובקי), sl (סלובנית), sr (Српски), sv (שוודית), th (Thai), tr (טורקי), uk (אוקראיני), uz (Uzbek), vi (Vietnamese), zh (סינית)
To see the examples of xml request/response, please follow the link: How to get finished order?

כיצד להוריד דוחות סטנדרטיים (בפורמטים אחרים מ-XML)?

Types of standard product: Basic Report, Mini Report, Linkages, Registration Data Report, Full report (private person), Short report (private person), Full report (with research), Financials (bank), Short Report, Real estate ownership search, Extended report, Full Report, KYC Report, Linked persons, Credit Opinion, Financial statements.

הבקשה מורכבת משלושה חלקים:

  1. חלק קבוע https://www.infoproff.com/en/orders/files/
  2. ה-hash הייחודי שלך, אותו אנו מספקים בתגובה
  3. And fixed part at the end /report?&lang=en&doc_type=pdf&currency_position=left&preferred_currency=EUR
https://www.infoproff.com/en/orders/files/<order_hash>/report?&lang=en&doc_type=pdf&currency_position=left&preferred_currency=EUR
lang: en, et, ru, lv, ar, az, bg, cs, da, de, el, fi, fr, he, hi, hu, hy, id, it, ja, ka, kk, ko, lt, mn, ms, nl, nb, pl, pt, ro, sk, sl, es, sr, sv, th, tr, uk, uz, vi, zh
doc_type: pdf, html, docx, xlsx
currency_position: left, right
preferred_currency: XXX - מקורית (ללא המרה), EUR, USD, AUD, BGN, BRL, CAD, CHF, CNY, CZK, DKK, GBP, HKD, HRK, HUF, IDR, ILS, INR, ISK, JPY, KRW, MXN, MYR, NOK, NZD, PHP, PLN, RON, RUB, SEK, SGD, THB, TRY, ZAR

כיצד להוריד מוצרים שאינם סטנדרטיים?

Types of non-standard product: Marketing database (special offer), Site visit - non-capital city, Extract from registry, Site visit - capital city, Due Diligence, non-standard, Shareholder document, Memorandum of Association, Certificate of incorporation.

הבקשה מורכבת משלושה חלקים:

  1. Fixed part https://www.infoproff.com/en/orders/files/
  2. ה-hash הייחודי שלך, אותו אנו מספקים בתגובה
  3. וחלק קבוע בסוף /download

איך לקבל חוות דעת אשראי?

פונקציה CreditOpinionCalculator

כיצד ניתן לקבל מידע נוסף?

פונקציה GetClassifiersFinancialStatements
פונקציה GetActivityClassificators
פונקציה GetDictionaryStandardPhrases
פונקציה GetAvailableProducts

delivery_term:

  1. "o" = "Online"
  2. "n" = "Normal"
  3. "f" = "Flash"
  4. "s" = "SuperFlash"

שגיאות אפשריות

שגיאות אלה עשויות להתרחש בעת ביצוע בקשה לשירות האינטרנט שלנו..

כל הפונקציות
  • Incorrect username/password or you have no permissions.
    אתה מזין פרטי התחברות שגויים או שגישתך ל-API נחסמה.
פונקציה SimpleSearch
  1. You don't have permissions to search in this country.
    רשימת המדינות הזמינות: אוזבקיסטן (UZB), אוסטריה (AUT), אוסטרליה (AUS), אורוגוואי (URY), אזרבייג'ן (AZE), איחוד מחדש (REU), איטליה (ITA), איסלנד (ISL), אירלנד (IRL), אלבניה (ALB), אלג'יריה (DZA), אנגולה (AGO), אסטוניה (EST), אקוודור (ECU), ארגנטינה (ARG), אתיופיה (ETH), בולגריה (BGR), בוליביה (BOL), בוסניה והרצגובינה (BIH), בוצואנה (BWA), בלארוס (BLR), בלגיה (BEL), בנין (BEN), ברזיל (BRA), ג'רזי (JEY), גאורגיה (GEO), גואדלופ (GLP), גיאנה (GUY), גיאנה הצרפתית (GUF), גינאה (GIN), גמביה (GMB), גרינלנד (GRL), גרמניה (DEU), דנמרק (DNK), דרום אפריקה (ZAF), האי מאן (IMN), האיים המלדיביים (MDV), הולנד (NLD), הונג קונג (HKG), הונגריה (HUN), הממלכה המאוחדת (GBR), הפיליפינים (PHL), ונצואלה (VEN), זימבבואה (ZWE), זמביה (ZMB), חוף השנהב (CIV), טג'יקיסטן (TJK), טוגו (TGO), טנזניה (TZA), יוון (GRC), יפן (JPN), ישראל (ISR), לוקסמבורג (LUX), לטביה (LVA), ליטא (LTU), ליכטנשטיין (LIE), מאוריציוס (MUS), מאיוט (MYT), מדגסקר (MDG), מולדובה (MDA), מונגוליה (MNG), מונקו (MCO), מלטה (MLT), מרוקו (MAR), מרטיניק (MTQ), נורבגיה (NOR), ניגריה (NGA), ניו זילנד (NZL), נמיביה (NAM), סיישל (SYC), סין (CHN), סין (TWN), סינגפור (SGP), סלובניה (SVN), סלובקיה (SVK), סמואה (WSM), סן מרטן (MAF), סן מרינו (SMR), ספרד (ESP), סרביה (SRB), סרי לנקה (LKA), פולין (POL), פורטוגל (PRT), פינלנד (FIN), פרגוואי (PRY), פרו (PER), צ'ילה (CHL), צ'כיה (CZE), צרפת (FRA), קונגו (COG), קוסובו (XXK), קזחסטן (KAZ), קירגיזסטן (KGZ), קנדה (CAN), קניה (KEN), קפריסין (CYP), קרואטיה (HRV), רואנדה (RWA), רומניה (ROU), רוסיה (RUS), שבדיה (SWE), שווייץ (CHE), תאילנד (THA)
פונקציה Order
  1. This product is not available.
    מוצר זה אינו קיים ואינו ניתן להזמנה.
  2. You can't order report on company with legal form: "legal_form"
    שגיאה זו חלה רק על: שבדיה (SWE)
    בשבדיה לא ניתן להזמין דוח מקוון (delivery_term = "o") עם הטפסים המשפטיים הבאים:
    • enskild näringsidkare
    • kommanditbolag
    • handelsbolag
  3. When delivery term is Online, please use order_details_by_id with search_result_id.
    This error only appears if you are trying to order online report without search_result_id.
    It is important yo use order_details_by_id in OrderReportRequest
  4. Business Name or Reg Code is required
    בעת הזמנת דוח לא מקוון (delivery_term = "n", "f" או "s") נדרש "שם העסק" או "קוד רישום".
  5. Reg Code is required when delivery term is Online
    בעת הזמנת דוח מקוון (delivery_term = "o") נדרש "קוד רישום".
פונקציה GetReport
  1. This language is not supported.
    רשימת השפות הזמינות לדוחות מקוונים: ar (Arabic), az (Azerbaijani), bg (בולגרי), cs (צ'כי), da (דני), de (גרמני), el (יווני), en (אנגלית), es (ספרדית), et (אסטונית), fi (פינית), fr (צרפתית), he (Hebrew), hi (Hindi), hu (הונגרי), hy (Armenian), id (אינדונזי), it (איטלקי), ja (יפנית), ka (Georgian), kk (Kazakh), ko (קוריאני), lt (ליטאי), lv (לטבית), mn (Mongolian), ms (Malay), nb (נורווגית בוקמאל), nl (הולנדית), pl (פולני), pt (פורטוגזית), ro (רומנית), ru (רוסית), sk (סלובקי), sl (סלובנית), sr (Српски), sv (שוודית), th (Thai), tr (טורקי), uk (אוקראיני), uz (Uzbek), vi (Vietnamese), zh (סינית)
פונקציות GetReport ChkStatus
  1. Incorrect order_id.
    לא ניתן למצוא את מזהה ההזמנה. אתה מקבל מזהה הזמנה כאשר אתה משתמש בפונקציה Order.
פונקציה OrderCancellation
  1. Your order is already canceled.
    אין לך יותר הרשאה לבטל את ההזמנה.
פונקציה OrderConfirmation
  1. You don't have permission to confirm the order anymore. Confirmation can be done within one hour after you recieved 'order_id'.

שינויים ב-SOAP (גרסה 3) בהשוואה ל-SOAP (גרסה 2)

שינויים ב-SOAP (גרסה 3) בהשוואה ל-SOAP (גרסה 2) [Overview]

1) New function: ChkFinance

Allows you to search for available financial statements.
Currently available only in EST (Estonia), SWE (Sweden)

2) Function: SimpleSearch

- Changes in list of available countries: אוזבקיסטן (UZB), אוסטריה (AUT), אוסטרליה (AUS), אורוגוואי (URY), אזרבייג'ן (AZE), איחוד מחדש (REU), איטליה (ITA), איסלנד (ISL), אירלנד (IRL), אלבניה (ALB), אלג'יריה (DZA), אנגולה (AGO), אסטוניה (EST), אקוודור (ECU), ארגנטינה (ARG), אתיופיה (ETH), בולגריה (BGR), בוליביה (BOL), בוסניה והרצגובינה (BIH), בוצואנה (BWA), בלארוס (BLR), בלגיה (BEL), בנין (BEN), ברזיל (BRA), ג'רזי (JEY), גאורגיה (GEO), גואדלופ (GLP), גיאנה (GUY), גיאנה הצרפתית (GUF), גינאה (GIN), גמביה (GMB), גרינלנד (GRL), גרמניה (DEU), דנמרק (DNK), דרום אפריקה (ZAF), האי מאן (IMN), האיים המלדיביים (MDV), הולנד (NLD), הונג קונג (HKG), הונגריה (HUN), הממלכה המאוחדת (GBR), הפיליפינים (PHL), ונצואלה (VEN), זימבבואה (ZWE), זמביה (ZMB), חוף השנהב (CIV), טג'יקיסטן (TJK), טוגו (TGO), טנזניה (TZA), יוון (GRC), יפן (JPN), ישראל (ISR), לוקסמבורג (LUX), לטביה (LVA), ליטא (LTU), ליכטנשטיין (LIE), מאוריציוס (MUS), מאיוט (MYT), מדגסקר (MDG), מולדובה (MDA), מונגוליה (MNG), מונקו (MCO), מלטה (MLT), מרוקו (MAR), מרטיניק (MTQ), נורבגיה (NOR), ניגריה (NGA), ניו זילנד (NZL), נמיביה (NAM), סיישל (SYC), סין (CHN), סין (TWN), סינגפור (SGP), סלובניה (SVN), סלובקיה (SVK), סמואה (WSM), סן מרטן (MAF), סן מרינו (SMR), ספרד (ESP), סרביה (SRB), סרי לנקה (LKA), פולין (POL), פורטוגל (PRT), פינלנד (FIN), פרגוואי (PRY), פרו (PER), צ'ילה (CHL), צ'כיה (CZE), צרפת (FRA), קונגו (COG), קוסובו (XXK), קזחסטן (KAZ), קירגיזסטן (KGZ), קנדה (CAN), קניה (KEN), קפריסין (CYP), קרואטיה (HRV), רואנדה (RWA), רומניה (ROU), רוסיה (RUS), שבדיה (SWE), שווייץ (CHE), תאילנד (THA)

- Each time you place an request we asaign a new 'search_result_id' for each company. You need to use this 'search_result_id' to place online orders.

Also you can place offline (delivery_term = 'n', 'f' or 's') orders with 'search_result_id', if you desire.

3) Function: Order
Identification is required!

To place an online order, you need to recieve 'search_result_id' from function 'SimpleSearch', and only after that you can place an online (delivery_term = 'o') order.

- Changes in list of available countries for online credit reports: אוסטריה (AUT), אזרבייג'ן (AZE), איטליה (ITA), אירלנד (IRL), אסטוניה (EST), בולגריה (BGR), בלגיה (BEL), גרמניה (DEU), דנמרק (DNK), הולנד (NLD), הונגריה (HUN), הממלכה המאוחדת (GBR), יוון (GRC), לוקסמבורג (LUX), לטביה (LVA), מולדובה (MDA), מונגוליה (MNG), מלטה (MLT), נורבגיה (NOR), סין (CHN), סלובניה (SVN), סלובקיה (SVK), ספרד (ESP), פולין (POL), פורטוגל (PRT), פינלנד (FIN), צ'כיה (CZE), צרפת (FRA), קזחסטן (KAZ), קירגיזסטן (KGZ), קרואטיה (HRV), רוסיה (RUS), שבדיה (SWE), שווייץ (CHE)

- Available to download financial statements (using product: finances) in online mode: Estonia (EST), Sweden (SWE)

3) Function: GetReport

- Changes in of available languages: ar (Arabic), az (Azerbaijani), bg (בולגרי), cs (צ'כי), da (דני), de (גרמני), el (יווני), en (אנגלית), es (ספרדית), et (אסטונית), fi (פינית), fr (צרפתית), he (Hebrew), hi (Hindi), hu (הונגרי), hy (Armenian), id (אינדונזי), it (איטלקי), ja (יפנית), ka (Georgian), kk (Kazakh), ko (קוריאני), lt (ליטאי), lv (לטבית), mn (Mongolian), ms (Malay), nb (נורווגית בוקמאל), nl (הולנדית), pl (פולני), pt (פורטוגזית), ro (רומנית), ru (רוסית), sk (סלובקי), sl (סלובנית), sr (Српски), sv (שוודית), th (Thai), tr (טורקי), uk (אוקראיני), uz (Uzbek), vi (Vietnamese), zh (סינית)


שינויים ב-SOAP (גרסה 3) בהשוואה ל-SOAP (גרסה 2) [WSDL and XSD]

File: report.xsd

New elements:

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

New function:

- ChkFinance

Function that allows you to search for available financial statements.

NB: This function is only needed when ordering a product: finances (Financial statements) with delivery_term = 'o'.
File: order.xsd

1) OrderReportRequest has a choice:

- order_details:

Using general information: business_name, reg_code, vat_code, address, phone, email, additional_info

NB:
* Business Name or Registration Code is required
* Only for orders with delivery_term: 'n', 'f' and 's' (credit reports in offline mode)

- order_details_by_id:

Using 'search_result_id'

NB:
* 'search_result_id' can be obtained with function: 'SimpleSearch'
* each new search generates new 'search_result_id'

2) order_details

New element:

- preferable_finances

NB: This element is required only ordering a product: finances (Financial statements) with delivery_term = 'o'.

3) SimpleSearchRequest

Removed element:

search_block.reg_code

New element:

search_block->company_code

NB: in some countries we allow to search companies by vat_code.

4) SimpleSearchResponse

Removed elements

- code

אלמנטים חדשים:

  • - search_result_id (is required for order with delivery_term = 'o')
  • - name_transliteration
  • - reg_code
  • - vat_code
  • - unified_legal_form

Webhooks Settings

סקירה כללית

Webhook הוא אמצעי המאפשר ליישום לספק ליישומים אחרים מידע בזמן אמת. תכונת ה-webhook שלנו מיישמת קריאות חוזרות HTTP המוגדרות עם כתובת URL. בכל פעם שמתרחש אירוע מסוים, נשלחת מטען HTTP POST בפורמט JSON לכתובת URL זו. בהקשר של הפרויקט שלנו, עיצבנו את פונקציית ה-webhook כך שתפעיל אירועים ספציפיים.

הגדרת Webhook

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

  1. "כתובת URL של Webhook" היא כתובת ה-URL שבה השרת שלך יקבל בקשות POST של Webhook.
  2. "מספר ניסיונות מקסימלי" הוא ההגדרה הקובעת את מספר הניסיונות המקסימלי שיש לבצע כדי להעביר אירוע webhook כאשר הניסיון הראשוני נכשל.
  3. "זמן המתנה לניסיון משלוח חוזר" הוא הגדרה המאפשרת לך לציין את מרווח הזמן בין ניסיונות חוזרים כאשר ניסיון משלוח webhook נכשל.

לאחר הזנת הפרטים, לחץ על 'שמור'.

סוגי אירועי Webhook

  1. סטטוס חדש של ההזמנה

מטען Webhook

כאשר מתרחש אירוע, אנו שולחים בקשת HTTP POST לכתובת ה-URL של המטען עם גוף JSON המכיל מידע על האירוע.

הנה דוגמה למטען:
דוגמה למטען של סטטוס חדש של הזמנה
ערכים אפשריים של שדה " "new_status" ":
  • "Finished" - ההזמנה הושלמה. ניתן לאסוף את ההזמנה.;
  • "Updated" - הזמנה מעודכנת, נתונים שנוספו להזמנה שהושלמה;
  • "Canceled" - הזמנה מבוטלת לבקשת הלקוח (או בהסכמתו);
  • "Rejected" - הזמנה נדחית. בדרך כלל מכיוון שלא ניתן לזהות את החברה..
  • "Identification pending" - אנו זקוקים למידע נוסף מהלקוח לפני שנוכל להכין את ההזמנה..

אבטחת ה-Webhooks שלך

חשוב לוודא שבקשות POST שנשלחות לכתובת ה-URL של המטען הן מהאפליקציה שלנו. כדי לסייע בכך, כל בקשת webhook כוללת כותרת X-Signature.

תיאור חתימה

לצורך החתימה אנו משתמשים ב-HMAC עם אלגוריתם SHA512.

הסוד הוא צירוף של מזהה האפליקציה ומפתח הסוד מהגדרות ה-webhooks.

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

פתרון בעיות

שרת חייב להגיב תוך 10 שניות ולהחזיר קוד HTTP 2XX; אחרת, משלוח ה-webhook ייחשב כנכשל. במקרה של כשל, התכונה תנסה לשלוח את הבקשה מחדש בהתאם למדיניות המשלוח.

© תיעוד API של Infoproff 2026