وثائق واجهة برمجة تطبيقات Infoproff - v3

إصدار Switch 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. تقارير الائتمان عبر الإنترنت للبلدان التالية: أذربيجان (AZE), ألمانيا (DEU), أيرلندا (IRL), إسبانيا (ESP), إستونيا (EST), إيطاليا (ITA), البرتغال (PRT), التشيك (CZE), الدنمارك (DNK), السويد (SWE), الصين (CHN), المملكة المتحدة (GBR), النرويج (NOR), النمسا (AUT), اليونان (GRC), بلجيكا (BEL), بلغاريا (BGR), بولندا (POL), روسيا (RUS), سلوفاكيا (SVK), سلوفينيا (SVN), سويسرا (CHE), فرنسا (FRA), فنلندا (FIN), قيرغيزستان (KGZ), كازاخستان (KAZ), كرواتيا (HRV), لاتفيا (LVA), لوكسمبورغ (LUX), مالطة (MLT), منغوليا (MNG), مولدوفا (MDA), هنغاريا (HUN), هولندا (NLD)
  2. تقارير غير متصلة بالإنترنت للبلدان التالية: جميع البلدان
  3. حاسبة رأي الائتمان
  4. Company search

كيفية البحث عن شركة؟

يتكون البحث عن الشركة من خيارين:

  1. البحث حسب اسم الشركة,
  2. Search by company code.
قائمة البلدان المتاحة: أذربيجان (AZE), أستراليا (AUS), ألبانيا (ALB), ألمانيا (DEU), أنغولا (AGO), أوروغواي (URY), أوزبكستان (UZB), أيرلندا (IRL), أيسلندا (ISL), إثيوبيا (ETH), إسبانيا (ESP), إستونيا (EST), إسرائيل (ISR), إيطاليا (ITA), الأرجنتين (ARG), الإكوادور (ECU), البرازيل (BRA), البرتغال (PRT), البوسنة والهرسك (BIH), التشيك (CZE), الجزائر (DZA), الدنمارك (DNK), السويد (SWE), الصين (CHN), الفلبين (PHL), الكونغو (COG), المالديف (MDV), المغرب (MAR), المملكة المتحدة (GBR), النرويج (NOR), النمسا (AUT), اليابان (JPN), اليونان (GRC), باراغواي (PRY), بلجيكا (BEL), بلغاريا (BGR), بنن (BEN), بوتسوانا (BWA), بولندا (POL), بوليفيا (BOL), بيرو (PER), بيلاروسيا (BLR), تايلاند (THA), تايوان (TWN), تشيلي (CHL), تنزانيا (TZA), توغو (TGO), جنوب أفريقيا (ZAF), جورجيا (GEO), جيرسي (JEY), رواندا (RWA), روسيا (RUS), رومانيا (ROU), زامبيا (ZMB), زمبابوي (ZWE), ساموا (WSM), سان مارتن (MAF), سان مارينو (SMR), سريلانكا (LKA), سلوفاكيا (SVK), سلوفينيا (SVN), سنغافورة (SGP), سويسرا (CHE), سيشيل (SYC), صربيا (SRB), طاجيكستان (TJK), غامبيا (GMB), غرينلاند (GRL), غوادلوب (GLP), غيانا (GUY), غيانا الفرنسية (GUF), غينيا (GIN), فرنسا (FRA), فنزويلا (VEN), فنلندا (FIN), قبرص (CYP), قيرغيزستان (KGZ), كازاخستان (KAZ), كرواتيا (HRV), كندا (CAN), كوت ديفوار (CIV), كوسوفو (XXK), كينيا (KEN), لاتفيا (LVA), لم شمل (REU), لوكسمبورغ (LUX), ليتوانيا (LTU), ليختنشتاين (LIE), مارتينيك (MTQ), مالطة (MLT), مان (IMN), مايوت (MYT), مدغشقر (MDG), منغوليا (MNG), موريشيوس (MUS), مولدوفا (MDA), موناكو (MCO), ناميبيا (NAM), نيجيريا (NGA), نيوزيلندا (NZL), هنغاريا (HUN), هولندا (NLD), هونغ كونغ (HKG)

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: أذربيجان (AZE), ألمانيا (DEU), أيرلندا (IRL), إسبانيا (ESP), إستونيا (EST), إيطاليا (ITA), البرتغال (PRT), التشيك (CZE), الدنمارك (DNK), السويد (SWE), الصين (CHN), المملكة المتحدة (GBR), النرويج (NOR), النمسا (AUT), اليونان (GRC), بلجيكا (BEL), بلغاريا (BGR), بولندا (POL), روسيا (RUS), سلوفاكيا (SVK), سلوفينيا (SVN), سويسرا (CHE), فرنسا (FRA), فنلندا (FIN), قيرغيزستان (KGZ), كازاخستان (KAZ), كرواتيا (HRV), لاتفيا (LVA), لوكسمبورغ (LUX), مالطة (MLT), منغوليا (MNG), مولدوفا (MDA), هنغاريا (HUN), هولندا (NLD)
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 - حدث خطأ فني في نظامنا. هذا يعني أننا على علم بهذا الخطأ وسنقوم بإصلاحه في أسرع وقت ممكن. سيتم إخطارك عندما تصبح قادرًا على استلام الطلب.

إذا كانت حالة التنفيذ {مكتملة} أو {محدثة}، فيمكنك الحصول على طلب.

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 - حدث خطأ فني في نظامنا. هذا يعني أننا على علم بهذا الخطأ وسنقوم بإصلاحه في أسرع وقت ممكن. سيتم إخطارك عندما تصبح قادرًا على استلام الطلب.

إذا كانت حالة التنفيذ {مكتملة} أو {محدثة}، فيمكنك الحصول على طلب.

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.

يتكون الطلب من 3 أجزاء:

  1. الجزء الثابت https://www.infoproff.com/en/orders/files/
  2. التجزئة الفريدة الخاصة بك، والتي نقدمها لك رداً على ذلك
  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.

يتكون الطلب من 3 أجزاء:

  1. Fixed part https://www.infoproff.com/en/orders/files/
  2. التجزئة الفريدة الخاصة بك، والتي نقدمها لك رداً على ذلك
  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.
    قائمة البلدان المتاحة: أذربيجان (AZE), أستراليا (AUS), ألبانيا (ALB), ألمانيا (DEU), أنغولا (AGO), أوروغواي (URY), أوزبكستان (UZB), أيرلندا (IRL), أيسلندا (ISL), إثيوبيا (ETH), إسبانيا (ESP), إستونيا (EST), إسرائيل (ISR), إيطاليا (ITA), الأرجنتين (ARG), الإكوادور (ECU), البرازيل (BRA), البرتغال (PRT), البوسنة والهرسك (BIH), التشيك (CZE), الجزائر (DZA), الدنمارك (DNK), السويد (SWE), الصين (CHN), الفلبين (PHL), الكونغو (COG), المالديف (MDV), المغرب (MAR), المملكة المتحدة (GBR), النرويج (NOR), النمسا (AUT), اليابان (JPN), اليونان (GRC), باراغواي (PRY), بلجيكا (BEL), بلغاريا (BGR), بنن (BEN), بوتسوانا (BWA), بولندا (POL), بوليفيا (BOL), بيرو (PER), بيلاروسيا (BLR), تايلاند (THA), تايوان (TWN), تشيلي (CHL), تنزانيا (TZA), توغو (TGO), جنوب أفريقيا (ZAF), جورجيا (GEO), جيرسي (JEY), رواندا (RWA), روسيا (RUS), رومانيا (ROU), زامبيا (ZMB), زمبابوي (ZWE), ساموا (WSM), سان مارتن (MAF), سان مارينو (SMR), سريلانكا (LKA), سلوفاكيا (SVK), سلوفينيا (SVN), سنغافورة (SGP), سويسرا (CHE), سيشيل (SYC), صربيا (SRB), طاجيكستان (TJK), غامبيا (GMB), غرينلاند (GRL), غوادلوب (GLP), غيانا (GUY), غيانا الفرنسية (GUF), غينيا (GIN), فرنسا (FRA), فنزويلا (VEN), فنلندا (FIN), قبرص (CYP), قيرغيزستان (KGZ), كازاخستان (KAZ), كرواتيا (HRV), كندا (CAN), كوت ديفوار (CIV), كوسوفو (XXK), كينيا (KEN), لاتفيا (LVA), لم شمل (REU), لوكسمبورغ (LUX), ليتوانيا (LTU), ليختنشتاين (LIE), مارتينيك (MTQ), مالطة (MLT), مان (IMN), مايوت (MYT), مدغشقر (MDG), منغوليا (MNG), موريشيوس (MUS), مولدوفا (MDA), موناكو (MCO), ناميبيا (NAM), نيجيريا (NGA), نيوزيلندا (NZL), هنغاريا (HUN), هولندا (NLD), هونغ كونغ (HKG)
الوظيفة 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: أذربيجان (AZE), أستراليا (AUS), ألبانيا (ALB), ألمانيا (DEU), أنغولا (AGO), أوروغواي (URY), أوزبكستان (UZB), أيرلندا (IRL), أيسلندا (ISL), إثيوبيا (ETH), إسبانيا (ESP), إستونيا (EST), إسرائيل (ISR), إيطاليا (ITA), الأرجنتين (ARG), الإكوادور (ECU), البرازيل (BRA), البرتغال (PRT), البوسنة والهرسك (BIH), التشيك (CZE), الجزائر (DZA), الدنمارك (DNK), السويد (SWE), الصين (CHN), الفلبين (PHL), الكونغو (COG), المالديف (MDV), المغرب (MAR), المملكة المتحدة (GBR), النرويج (NOR), النمسا (AUT), اليابان (JPN), اليونان (GRC), باراغواي (PRY), بلجيكا (BEL), بلغاريا (BGR), بنن (BEN), بوتسوانا (BWA), بولندا (POL), بوليفيا (BOL), بيرو (PER), بيلاروسيا (BLR), تايلاند (THA), تايوان (TWN), تشيلي (CHL), تنزانيا (TZA), توغو (TGO), جنوب أفريقيا (ZAF), جورجيا (GEO), جيرسي (JEY), رواندا (RWA), روسيا (RUS), رومانيا (ROU), زامبيا (ZMB), زمبابوي (ZWE), ساموا (WSM), سان مارتن (MAF), سان مارينو (SMR), سريلانكا (LKA), سلوفاكيا (SVK), سلوفينيا (SVN), سنغافورة (SGP), سويسرا (CHE), سيشيل (SYC), صربيا (SRB), طاجيكستان (TJK), غامبيا (GMB), غرينلاند (GRL), غوادلوب (GLP), غيانا (GUY), غيانا الفرنسية (GUF), غينيا (GIN), فرنسا (FRA), فنزويلا (VEN), فنلندا (FIN), قبرص (CYP), قيرغيزستان (KGZ), كازاخستان (KAZ), كرواتيا (HRV), كندا (CAN), كوت ديفوار (CIV), كوسوفو (XXK), كينيا (KEN), لاتفيا (LVA), لم شمل (REU), لوكسمبورغ (LUX), ليتوانيا (LTU), ليختنشتاين (LIE), مارتينيك (MTQ), مالطة (MLT), مان (IMN), مايوت (MYT), مدغشقر (MDG), منغوليا (MNG), موريشيوس (MUS), مولدوفا (MDA), موناكو (MCO), ناميبيا (NAM), نيجيريا (NGA), نيوزيلندا (NZL), هنغاريا (HUN), هولندا (NLD), هونغ كونغ (HKG)

- 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: أذربيجان (AZE), ألمانيا (DEU), أيرلندا (IRL), إسبانيا (ESP), إستونيا (EST), إيطاليا (ITA), البرتغال (PRT), التشيك (CZE), الدنمارك (DNK), السويد (SWE), الصين (CHN), المملكة المتحدة (GBR), النرويج (NOR), النمسا (AUT), اليونان (GRC), بلجيكا (BEL), بلغاريا (BGR), بولندا (POL), روسيا (RUS), سلوفاكيا (SVK), سلوفينيا (SVN), سويسرا (CHE), فرنسا (FRA), فنلندا (FIN), قيرغيزستان (KGZ), كازاخستان (KAZ), كرواتيا (HRV), لاتفيا (LVA), لوكسمبورغ (LUX), مالطة (MLT), منغوليا (MNG), مولدوفا (MDA), هنغاريا (HUN), هولندا (NLD)

- 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 إلى عنوان URL هذا بتنسيق JSON كلما وقع حدث محدد. في سياق مشروعنا، قمنا بتصميم وظيفة 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 فاشلاً. في حالة الفشل، ستحاول الميزة إعادة إرسال الطلب وفقًا لسياسة التسليم.

© وثائق واجهة برمجة تطبيقات Infoproff 2026