תיעוד API של Infoproff - v2

גרסת המתג V2

התחלת העבודה

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

http://wsdfn.infoproff.com/v2/

פונקציות עיקריות של שירות האינטרנט:

  • SimpleSearch - חפש מידע על חברות במדינות שונות.
  • Order - יוצר order_id ומחזיר כפילויות. הכפילויות נבחרות על פי הפרמטרים הבאים: country, product, delivery_term and 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. דוחות אשראי מקוונים עבור המדינות הבאות: אירלנד (IRL), הדוכסות הגדולה של לוקסמבורג (LUX), הממלכה המאוחדת של בריטניה הגדולה וצפון אירלנד (GBR), הפדרציה הרוסית (RUS), הקונפדרציה השוויצרית (CHE), הרפובליקה האיטלקית (ITA), הרפובליקה ההלנית (GRC), הרפובליקה הסלובקית (SVK), הרפובליקה העממית של סין (CHN), הרפובליקה הפדרלית של גרמניה (DEU), הרפובליקה הפורטוגלית (PRT), הרפובליקה הצרפתית (FRA), הרפובליקה הקירגיזית (KGZ), הרפובליקה של הונגריה (HUN), מונגוליה (MNG), ממלכת בלגיה (BEL), ממלכת דנמרק (DNK), ממלכת הולנד (NLD), ממלכת נורבגיה (NOR), ממלכת ספרד (ESP), ממלכת שבדיה (SWE), צ'כיה (CZE), רפובליקת אוסטריה (AUT), רפובליקת אזרבייג'ן (AZE), רפובליקת אסטוניה (EST), רפובליקת בולגריה (BGR), רפובליקת לטביה (LVA), רפובליקת מולדובה (MDA), רפובליקת מלטה (MLT), רפובליקת סלובניה (SVN), רפובליקת פולין (POL), רפובליקת פינלנד (FIN), רפובליקת קזחסטן (KAZ), רפובליקת קרואטיה (HRV)
  2. דוחות לא מקוונים עבור המדינות הבאות: כל המדינות
  3. מחשבון חוות דעת אשראי
  4. Company search

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

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

  1. חיפוש לפי שם חברה,
  2. חיפוש לפי קוד רישום.
רשימת המדינות הזמינות: רפובליקת פינלנד (FIN), ממלכת שבדיה (SWE), ממלכת נורבגיה (NOR), ממלכת דנמרק (DNK)
מידע חשוב:
המרשם הנורבגי אינו מאפשר חיפוש חברות שנמחקו לפי שמות. לכן, איננו יכולים לספק {חיפוש פשוט} לפי שמות בתוך חברות שנמחקו בנורבגיה.
Field's length:
company_name varchar(512)
company_code varchar(64)

להלן דוגמה:

פונקציה SimpleSearch

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

פונקציה SimpleSearch

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

ההזמנה מהרישום ועד קבלת הדוח כוללת את השלבים הבאים:

  1. המשתמש רושם הזמנה חדשה (פונקציית "הזמנה"). המערכת מחזירה את פרטי ההזמנה, רשימת כפילויות שהוזמנו ב-60 הימים האחרונים וממתינה לאישור ההזמנה.
  2. המשתמש מאשר הזמנה (פונקציה "OrderConfirmation"). המערכת שולחת את ההזמנה לייצור ומחזירה את סטטוס הייצור הנוכחי.
  3. המשתמש בודק את סטטוס ההזמנה (פונקציה "ChkStatus").
  4. אם ההזמנה מוכנה, המשתמש יכול להוריד את הדוח (פונקציה "GetReport").
רשימת המדינות הזמינות: רפובליקת פינלנד (FIN), ממלכת שבדיה (SWE)
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)

להלן דוגמה:

שלב 1: הזמנת דוח

משתמשים הסבורים כי שלב אישור ההזמנה אינו נחוץ, יכולים להשתמש באלמנט "confirm_order" ולהעביר את הערך "TRUE".

בדרך כלל, הכנת דוח האשראי במצב מקוון אורכת 10-20 שניות.
לכן, עבור דוחות מקוונים, עליך לבצע בדיקות כל 5 שניות או יותר.

רשימת החברות הזמינות לחשבון ניסיון:

01120389 FIN, 01163231 FIN, 01332146 FIN, 01795458 FIN, 02245466 FIN, 07640633 FIN, 08481566 FIN, 08607931 FIN, 09484603 FIN, 09488655 FIN, 16366779 FIN, 16433070 FIN, 16457849 FIN, 16564505 FIN, 19148611 FIN, 20453920 FIN, 20453947 FIN, 26513621 FIN, 27019879 FIN, 27240442 FIN, 27330384 FIN, 27748684 FIN, 28725388 FIN, 29048796 FIN, 5560117482 SWE, 5564294089 SWE, 5566436035 SWE, 5569760464 SWE
בנוסף, עבור דוחות מקוונים (delivery_term = "o"), ניתן להשתמש בדוגמאות שנוצרו עבור כל מדינה (שימוש: קוד רישום "00000000"). דוחות אלה ניתנים ללא תשלום וניתן להזמין אותם באמצעות חשבון ניסיון.
פונקציה Order
פונקציה OrderCancellation

שלב 2. אישור הזמנה

פונקציה OrderConfirmation

שלב 3. בדיקת סטטוס

פונקציה ChkStatus

שלב 4. קבל דוח

רשימת השפות הזמינות לדוחות מקוונים: en (English), et (Estonian), ru (Russian), de (German)
הורדת הדוח המקוון בפורמט PDF אינה זמינה עדיין.
פונקציה GetReport

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

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

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

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

ניתן להוריד דוחות לא מקוונים ישירות. להלן ההוראות כיצד לעשות זאת:

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

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

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

פונקציה CreditOpinionCalculator

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

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

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

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

כל הפונקציות
  • שם משתמש/סיסמה שגויים או שאין לך הרשאות.
    אתה מזין פרטי התחברות שגויים או שגישתך ל-API נחסמה.
פונקציה SimpleSearch
  1. אין לך הרשאה לחפש במדינה זו.
    רשימת המדינות הזמינות: רפובליקת פינלנד (FIN), ממלכת שבדיה (SWE)
פונקציה Order
  1. מוצר זה אינו זמין.
    מוצר זה אינו קיים ואינו ניתן להזמנה.
  2. לא ניתן להזמין דוח על חברה עם צורה משפטית: "legal_form"
    שגיאה זו חלה רק על: ממלכת שבדיה (SWE)
    בשבדיה לא ניתן להזמין דוח מקוון (delivery_term = "o") עם הטפסים המשפטיים הבאים:
    • enskild näringsidkare
    • kommanditbolag
    • handelsbolag
  3. חברה זו אינה מופיעה ברשימת הבדיקות.
    קוד רישום החברה אינו מופיע ברשימת הבדיקות שלנו.
    רשימת החברות הזמינות לחשבון ניסיון:
    01120389 FIN, 01163231 FIN, 01332146 FIN, 01795458 FIN, 02245466 FIN, 07640633 FIN, 08481566 FIN, 08607931 FIN, 09484603 FIN, 09488655 FIN, 16366779 FIN, 16433070 FIN, 16457849 FIN, 16564505 FIN, 19148611 FIN, 20453920 FIN, 20453947 FIN, 26513621 FIN, 27019879 FIN, 27240442 FIN, 27330384 FIN, 27748684 FIN, 28725388 FIN, 29048796 FIN, 5560117482 SWE, 5564294089 SWE, 5566436035 SWE, 5569760464 SWE
  4. יש להזין שם עסק או קוד רישום
    בעת הזמנת דוח לא מקוון (delivery_term = "n", "f" או "s") נדרש "שם העסק" או "קוד רישום".
  5. קוד רישום נדרש כאשר תנאי המשלוח הוא מקוון
    בעת הזמנת דוח מקוון (delivery_term = "o") נדרש "קוד רישום".
פונקציה GetReport
  1. שפה זו אינה נתמכת.
    רשימת השפות הזמינות לדוחות מקוונים: en (English), et (Estonian), ru (Russian), de (German)
פונקציות GetReport ChkStatus
  1. מספר הזמנה שגוי.
    לא ניתן למצוא את מזהה ההזמנה. אתה מקבל מזהה הזמנה כאשר אתה משתמש בפונקציה Order.
פונקציה OrderCancellation
  1. Your order is already canceled.
    אין לך יותר הרשאה לבטל את ההזמנה.
פונקציה OrderConfirmation
  1. אין לך יותר הרשאה לאשר את ההזמנה. האישור יכול להתבצע תוך שעה לאחר קבלת 'order_id'.

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

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

1) פונקציה חדשה: ChkFinance

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

2) פונקציה: SimpleSearch

- Changes in list of available countries: Finland (FIN), Sweden (SWE), Norway (NOR), Denmark (DNK), Belgium (BEL), Estonia (EST), Netherlands (NLD), United Kingdom (GBR), Ireland (IRL), France (FRA), Spain (ESP), Portugal (PRT), Germany (DEU), Italy (ITA), Austria (AUT), Switzerland (CHE), Cyprus (CYP)

- 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) פונקציה: Order
Identification is required!

כדי לבצע הזמנה מקוונת, עליך לקבל 'search_result_id' מהפונקציה 'SimpleSearch', ורק לאחר מכן תוכל לבצע הזמנה מקוונת (delivery_term = 'o').

- שינויים ברשימת המדינות הזמינות לדוחות אשראי מקוונים: Finland (FIN), Sweden (SWE), Belgium (BEL), Netherlands (NLD), Estonia (EST)

- ניתן להוריד דוחות כספיים (באמצעות המוצר: כספים) במצב מקוון: Estonia (EST), Sweden (SWE)

3) פונקציה: GetReport

- Changes in of available languages: en (English), et (Estonian), ru (Russian), de (German), zh (Chinese), ja (Japanese), bg (Bulgarian), cs (Czech), da (Danish), el (Greek), fi (Finnish), fr (French), hu (Hungarian), it (Italian), lv (Latvian), lt (Lithuanian), nl (Dutch), pl (Polish), pt (Portuguese), ro (Romanian), sk (Slovak), sl (Slovenian), es (Spanish), sv (Swedish)


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

File: report.xsd

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

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

פונקציה חדשה:

- 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

אלמנט חדש:

- preferable_finances

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

3) SimpleSearchRequest

אלמנט שהוסר:

search_block.reg_code

אלמנט חדש:

search_block->company_code

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

4) SimpleSearchResponse

אלמנטים שהוסרו

- code

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

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