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


البدء


توجد خدمة الويب wsdl والمخططات هنا:

https://wsdfn.infoproff.com/v4/

مجموعة Postman (API v4) — جاهزة للاستخدام:

https://www.postman.com/infoproff/infoproff-webservices/documentation/9kweer5/soap-api-v4

يوفر Postman طريقة مريحة لاختبار واجهة API لدينا دون الحاجة إلى كتابة أي تعليمات برمجية. ويمكنه أيضًا إنشاء أمثلة لطلبات HTTP تلقائيًا لمعظم لغات البرمجة الشائعة.

الطلبات التي يُنشئها Postman هي استدعاءات HTTP أساسية متوافقة مع واجهة SOAP API لدينا. ومع ذلك، للتكامل على مستوى الإنتاج، نوصي باستخدام عملاء SOAP مكتملة الميزات المتوفرة في معظم لغات البرمجة. يمكن لهذه العملاء العمل مباشرة مع WSDL وXSD، ومعالجة المخططات وأنواع البيانات وهياكل الرسائل تلقائياً.

استخدام عميل SOAP مخصص يضمن تكاملاً أكثر موثوقية ومتانة، ويقلل احتمال الأخطاء عند إنشاء رسائل SOAP وتحليلها.

تفاصيل المصادقة

طريقة المصادقة الأساسية هي HTTP Basic Auth. يُفضَّل ويُوصى باستخدام ترويسة Authorization مع بيانات الاعتماد المرمّزة.

يتوافق username مع App ID، وpassword هو Secret Key المرتبط. تُنشأ هذه القيم في قسم API Tokens في لوحة تحكم المستخدم وليست مرتبطة ببيانات الاعتماد المستخدمة لتسجيل الدخول إلى البوابة.

آلية authentication_block المستخدمة في إصدارات API السابقة ما زالت مدعومة للتوافق مع الإصدارات السابقة، لكنها تُعد مهملة ويجب عدم استخدامها في التكاملات الجديدة.

وظائف خدمة الويب:

  • 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), أوكرانيا (UKR), أيرلندا (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. البحث عن الشركات

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


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

  1. البحث حسب اسم الشركة,
  2. البحث برمز الشركة.
قائمة البلدان المتاحة: أذربيجان (AZE), أستراليا (AUS), ألبانيا (ALB), ألمانيا (DEU), أنغولا (AGO), أوروغواي (URY), أوزبكستان (UZB), أوكرانيا (UKR), أيرلندا (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), تركيا (TUR), تشيلي (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)

يتم البحث عن الدول الأخرى فقط في قاعدة بيانات التقارير المؤرشفة. إذا لم تجد الشركة المطلوبة، فأدخل تفاصيل الشركة يدوياً.

معلومات مهمة:

يمكن الحصول على search_result_id هنا للطلبات التي يكون فيها delivery_term = "o" أو delivery_term = "a".

قد يستغرق الرد على طلب البحث ما يصل إلى 20 ثانية في البلدان التالية: المملكة المتحدة, أيرلندا, فرنسا, إسبانيا, البرتغال, ألمانيا, إيطاليا, النمسا, سويسرا, تركيا.

لا يسمح السجل النرويجي بالبحث عن الشركات المحذوفة بالأسماء. لذلك، لا يمكننا توفير {بحث بسيط} بالأسماء ضمن الشركات المحذوفة في النرويج.

يدعم سجل الشركات التركي البحث في موقع SimpleSearch باستخدام اسم الشركة فقط — ولا يتوفر البحث باستخدام رمز التسجيل. يجب أن يحتوي استعلام البحث على 5 أحرف على الأقل. ولا تتم المطابقة إلا مع بداية اسم الشركة.

طول الحقل:
company_name varchar(512)
company_code varchar(64)

فيما يلي مثال على ذلك:


الوظيفة SimpleSearch

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:SimpleSearch>
            <SimpleSearchRequest>
                <search_block>
                    <company_name>biz group</company_name>
                    <country>SWE</country>
                </search_block>
            </SimpleSearchRequest>
        </ns0:SimpleSearch>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:SimpleSearchResponse>
            <SimpleSearchResponse>
                <search_result>
                    <item>
                        <search_result_id>7b459516-a36b-4f4a-83d9-7a1a864494df</search_result_id>
                        <name>ABČ Биз Sweden Groūp Āktiebolāg</name>
                        <name_transliteration>ABC Biz Sweden Group Aktiebolag</name_transliteration>
                        <historical_names>
                            <item>
                                <name>Groupama Asslcurazioni</name>
                            </item>
                            <item>
                                <name>Asslcurazioni</name>
                            </item>
                        </historical_names>
                        <reg_code>5592027779</reg_code>
                        <vat_code>TAX1125867</vat_code>
                        <static_code>6523456</static_code>
                        <legal_status>Active</legal_status>
                        <legal_form>Aktiebolag</legal_form>
                        <unified_legal_form>Limited liability company</unified_legal_form>
                        <legal_address>KLUBBSTIGEN 8, 17961, STENHAMRA, SVERIGE</legal_address>
                        <parent_company_code>3386027979</parent_company_code>
                        <archived_reports>
                            <item>
                                <product>kyc_report</product>
                                <revision_date>2023-04-20</revision_date>
                                <archived_report_cost>10</archived_report_cost>
                                <archived_report_cost_currency>EUR</archived_report_cost_currency>
                            </item>
                            <item>
                                <product>basic_report</product>
                                <revision_date>2023-06-29</revision_date>
                                <archived_report_cost>15.2</archived_report_cost>
                                <archived_report_cost_currency>EUR</archived_report_cost_currency>
                                <last_fin_report>
                                    <fin_report_year>2022</fin_report_year>
                                    <period_start>2022-01-01</period_start>
                                    <period_end>2022-12-31</period_end>
                                    <fin_period_duration_in_months>12</fin_period_duration_in_months>
                                </last_fin_report>
                            </item>
                            <item>
                                <product>full_report</product>
                                <revision_date>2022-04-13</revision_date>
                                <archived_report_cost>25.75</archived_report_cost>
                                <archived_report_cost_currency>EUR</archived_report_cost_currency>
                                <last_fin_report>
                                    <fin_report_year>2021</fin_report_year>
                                    <fin_period_start>2021-01-01</fin_period_start>
                                    <fin_period_end>2021-12-31</fin_period_end>
                                    <fin_period_duration_in_months>12</fin_period_duration_in_months>
                                </last_fin_report>
                            </item>
                        </archived_reports>
                    </item>
                    <item>
                        <search_result_id>fc8cec2a-5b59-4b30-b65c-ba2900669cd7</search_result_id>
                        <name>АДД Caprīccīo Groūp AB</name>
                        <name_transliteration>ADD Capriccio Group AB</name_transliteration>
                        <historical_names/>
                        <reg_code>5567769961</reg_code>
                        <vat_code/>
                        <static_code/>
                        <legal_status/>
                        <legal_form>Landsting</legal_form>
                        <unified_legal_form>State institution</unified_legal_form>
                        <legal_address>STUDENTBACKEN 1 12 TR, 11557, STOCKHOLM,
                            SVERIGE</legal_address>
                        <parent_company_code xsi:nil="true"/>
                    </item>
                    <item>
                        <search_result_id>4b9c5da2-3aac-4b9a-a308-f9c1e2ee8f32</search_result_id>
                        <name>AEE Good Group AB</name>
                        <name_transliteration>AEE Good Group AB</name_transliteration>
                        <historical_names/>
                        <reg_code>5591756685</reg_code>
                        <vat_code/>
                        <static_code/>
                        <legal_status>Active</legal_status>
                        <legal_form>Ömsesidigt försäkringsbolag</legal_form>
                        <unified_legal_form>Enterprise</unified_legal_form>
                        <legal_address>BOX 1, 18173, LIDINGÖ, SVERIGE</legal_address>
                        <parent_company_code xsi:nil="true"/>
                    </item>
                    ...
                </search_result>
            </SimpleSearchResponse>
        </ns1:SimpleSearchResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

الخيار 2: البحث بواسطة رمز التسجيل

الوظيفة SimpleSearch

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:SimpleSearch>
            <SimpleSearchRequest>
                <search_block>
                    <company_code>5592027779</company_code>
                    <country>SWE</country>
                </search_block>
            </SimpleSearchRequest>
        </ns0:SimpleSearch>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:SimpleSearchResponse>
            <SimpleSearchResponse>
                <item>
                    <search_result_id>7b459516-a36b-4f4a-83d9-7a1a864494df</search_result_id>
                    <name>ABČ Биз Sweden Groūp Āktiebolāg</name>
                    <name_transliteration>ABC Biz Sweden Group Aktiebolag</name_transliteration>
                    <historical_names>
                        <item>
                            <name>Groupama Asslcurazioni</name>
                        </item>
                        <item>
                            <name>Asslcurazioni</name>
                        </item>
                    </historical_names>
                    <reg_code>5592027779</reg_code>
                    <vat_code>TAX1125867</vat_code>
                    <static_code>6523456</static_code>
                    <legal_status>Active</legal_status>
                    <legal_form>Aktiebolag</legal_form>
                    <unified_legal_form>Limited liability company</unified_legal_form>
                    <legal_address>KLUBBSTIGEN 8, 17961, STENHAMRA, SVERIGE</legal_address>
                    <parent_company_code>3386027979</parent_company_code>
                </item>
            </SimpleSearchResponse>
        </ns1:SimpleSearchResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

الخيار 3: البحث بالاستعلام (بالاسم أو الرمز)

الوظيفة UnifiedSearch

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:SimpleSearch>
            <SimpleSearchRequest>
                <search_block>
                    <search_query>group</search_query>
                    <country>SWE</country>
                </search_block>
            </SimpleSearchRequest>
        </ns0:SimpleSearch>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:SimpleSearchResponse>
            <SimpleSearchResponse>
                <item>
                    <search_result_id>7b459516-a36b-4f4a-83d9-7a1a864494df</search_result_id>
                    <name>ABČ Биз Sweden Groūp Āktiebolāg</name>
                    <name_transliteration>ABC Biz Sweden Group Aktiebolag</name_transliteration>
                    <historical_names>
                        <item>
                            <name>Groupama Asslcurazioni</name>
                        </item>
                        <item>
                            <name>Asslcurazioni</name>
                        </item>
                    </historical_names>
                    <reg_code>5592027779</reg_code>
                    <vat_code>TAX1125867</vat_code>
                    <static_code>6523456</static_code>
                    <legal_status>Active</legal_status>
                    <legal_form>Aktiebolag</legal_form>
                    <unified_legal_form>Limited liability company</unified_legal_form>
                    <legal_address>KLUBBSTIGEN 8, 17961, STENHAMRA, SVERIGE</legal_address>
                    <parent_company_code>3386027979</parent_company_code>
                </item>
                <item>
                    <search_result_id>4b9c5da2-3aac-4b9a-a308-f9c1e2ee8f32</search_result_id>
                    <name>AEE Good Group AB</name>
                    <name_transliteration>AEE Good Group AB</name_transliteration>
                    <historical_names/>
                    <reg_code>5591756685</reg_code>
                    <vat_code/>
                    <static_code/>
                    <legal_status>Active</legal_status>
                    <legal_form>Ömsesidigt försäkringsbolag</legal_form>
                    <unified_legal_form>Enterprise</unified_legal_form>
                    <legal_address>BOX 1, 18173, LIDINGÖ, SVERIGE</legal_address>
                    <parent_company_code xsi:nil="true"/>
                </item>
            </SimpleSearchResponse>
        </ns1:SimpleSearchResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

كيفية طلب تقرير الائتمان؟


قائمة البلدان المتاحة لتقارير الائتمان عبر الإنترنت: أذربيجان (AZE), ألمانيا (DEU), أوكرانيا (UKR), أيرلندا (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)
طول الحقل:
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: العثور على شركة (طلب عبر الإنترنت/غير متصل (مع search_result_id))

الوظيفة SimpleSearch

لطلب تقرير Online/Offline with identification يلزمك الحصول على "<search_result_id>".
للقيام بذلك، يُرجى اتباع الرابط: كيفية البحث عن شركة؟

تتيح لك عملية البحث تحديد الشركة التي ترغب في تقديم طلب لها بدقة. على سبيل المثال، في بعض البلدان قد توجد عدة شركات برقم تسجيل واحد، أو قد ينتمي الاسم الرسمي نفسه إلى عدة شركات.

الخطوة 2: طلب تقرير (طلب عبر الإنترنت/غير متصل (مع search_result_id))

الوظيفة Order
إذا لم تستخدم العنصر confirm_order، فستتلقى <last_duplicates> في استجابة XML، حتى تتمكن من تحديد ما إذا كنت تحتاج فعلاً إلى تقديم طلب.

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:Order>
            <OrderReportRequest>
                <order_details_by_id>
                    <country>FIN</country>
                    <product>full_report</product>
                    <delivery_term>o</delivery_term>
                    <notification_of_completion>true</notification_of_completion>
                    <confirm_order>false</confirm_order>
                    <copy_notifiaction_to_other_emails>
                        <item>mail1@mail.com</item>
                    	<item>mail2@mail.com</item>
                    </copy_notifiaction_to_other_emails>
                    <company_details>
                        <search_result_id>60751300-4b72-451f-bf96-2a1a7cbe71c6</search_result_id>
                        <address>Company address</address>
                        <phone>Company phone</phone>
                        <email>Company email</email>
                        <additional_info>Additional information regarding company</additional_info>
                        <ref_code>YOUR REF CODE</ref_code> <!-- if you need it -->
                    </company_details>
                </order_details_by_id>
            </OrderReportRequest>
        </ns0:Order>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:OrderResponse>
            <OrderReportResponse>
                <order_data>
                    <order_id>90000055</order_id>
                    <order_hash>TE6PIomXrMIinvhD1DwgcdRbUS_hFrqZDX3t1eY_9N03fjazTF3OewkDCt6BczGL</order_hash>
                    <order_deadline>2019-09-09</order_deadline>
                    <price>25</price>
                    <currency>EUR</currency>
                    <request_time>2019-09-09 13:13:43</request_time>
                    <order_details>
                        <country>FIN</country>
                        <product>full_report</product>
                        <delivery_term>o</delivery_term>
                        <notification_of_completion>false</notification_of_completion>
                        <company_details>
                            <business_name>Company LLC</business_name>
                            <reg_code>08481566</reg_code>
                            <vat_code>000000001</vat_code>
                            <address>Company address</address>
                            <phone>Company phone</phone>
                            <email>Company email</email>
                            <additional_info>Additional information regarding company</additional_info>
                            <ref_code>ref_code</ref_code>
                        </company_details>
                    </order_details>
                    <order_status>Awaiting Confirmation</order_status>
                </order_data>
                <last_duplicates>
                    <order_data>
                        <order_id>90000054</order_id>
                        <order_hash>ZJHhHYIbpUp2xtZM1Jqg5QQYmnrLo2E7p-J8uP7BUF5_G7BNu5J0-nNVxKOeIxun</order_hash>
                        <order_deadline>2019-09-09 </order_deadline>
                        <price>25</price>
                        <currency>EUR</currency>
                        <request_time>2019-09-09 13:02:32</request_time>
                        <order_details>
                            <country>FIN</country>
                            <product>full_report</product>
                            <delivery_term>o</delivery_term>
                            <notification_of_completion>false</notification_of_completion>
                            <company_details>
                                <reg_code>08481566</reg_code>
                                <ref_code>ref_code</ref_code>
                            </company_details>
                        </order_details>
                        <order_status>Awaiting Confirmation</order_status>
                    </order_data>
                    <order_data>
                        <order_id>90000053</order_id>
                        <order_hash>X4Z6VL9KZd5bWsnWQ_NjdlfN2ix7M1jdwW_FrJ_IyIVKwkDipsx73dW3RMgVE8y0</order_hash>
                        <order_deadline>2019-08-02</order_deadline>
                        <price>25</price>
                        <currency>EUR</currency>
                        <request_time>2019-08-02 16:34:12</request_time>
                        <order_details>
                            <country>FIN</country>
                            <product>full_report</product>
                            <delivery_term>s</delivery_term>
                            <notification_of_completion>false</notification_of_completion>
                            <company_details>
                                <reg_code>08481566</reg_code>
                                <vat_code>000000001</vat_code>
                                <ref_code>ref_code</ref_code>
                            </company_details>
                        </order_details>
                        <order_status>Finished</order_status>
                    </order_data>
                </last_duplicates>
            </OrderReportResponse>
        </ns1:OrderResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

الخطوة 3: إلغاء الطلب (اختياري) (طلب عبر الإنترنت/غير متصل (مع search_result_id))

الوظيفة OrderCancellation
إذا رغبت في إلغاء الطلب، يمكنك استخدام دالة OrderCancellation هذه. إذا كان الطلب قيد التنفيذ بالفعل، فلن تتمكن من إلغائه.

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:OrderCancellation>
            <OrderCancellationRequest>
                <order_id>90000055</order_id>
            </OrderCancellationRequest>
        </ns0:OrderCancellation>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:OrderCancellationResponse>
            <OrderCancellationResponse>
                <order_data>
                    <order_id>90000055</order_id>
                    <order_hash>TE6PIomXrMIinvhD1DwgcdRbUS_hFrqZDX3t1eY_9N03fjazTF3OewkDCt6BczGL</order_hash>
                    <order_deadline>2019-09-09</order_deadline>
                    <price>25</price>
                    <currency>EUR</currency>
                    <request_time>2019-09-09 13:13:43</request_time>
                    <order_details>
                        <country>FIN</country>
                        <product>full_report</product>
                        <delivery_term>o</delivery_term>
                        <notification_of_completion>false</notification_of_completion>
                        <company_details>
                            <business_name>Company LLC</business_name>
                            <reg_code>08481566</reg_code>
                            <vat_code>000000001</vat_code>
                            <address>Company address</address>
                            <phone>Company phone</phone>
                            <email>Company email</email>
                            <additional_info>Additional information regarding company</additional_info>
                            <ref_code>ref_code</ref_code>
                        </company_details>
                    </order_details>
                    <order_status>Canceled</order_status>
                </order_data>
            </OrderCancellationResponse>
        </ns1:OrderCancellationResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

الخطوة 4: تأكيد الطلب (طلب عبر الإنترنت/غير متصل (مع search_result_id))

الوظيفة OrderConfirmation
إذا لم تستخدم العنصر "confirm_order"، فيجب عليك تأكيد طلبك.

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:OrderConfirmation>
            <OrderConfirmationRequest>
                <order_id>90000055</order_id>
            </OrderConfirmationRequest>
        </ns0:OrderConfirmation>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-EN>
        <ns1:OrderConfirmationResponse>
            <OrderConfirmationResponse>
                <order_data>
                    <order_id>90000055</order_id>
                    <order_hash>TE6PIomXrMIinvhD1DwgcdRbUS_hFrqZDX3t1eY_9N03fjazTF3OewkDCt6BczGL</order_hash>
                    <order_deadline>2019-09-09</order_deadline>
                    <price>25</price>
                    <currency>EUR</currency>
                    <request_time>2019-09-09 13:13:43</request_time>
                    <order_details>
                        <country>FIN</country>
                        <product>full_report</product>
                        <delivery_term>o</delivery_term>
                        <notification_of_completion>false</notification_of_completion>
                        <company_details>
                            <business_name>Company LLC</business_name>
                            <reg_code>08481566</reg_code>
                            <vat_code>000000001</vat_code>
                            <address>Company address</address>
                            <phone>Company phone</phone>
                            <email>Company email</email>
                            <additional_info>Additional information regarding company</additional_info>
                            <ref_code>ref_code</ref_code>
                        </company_details>
                    </order_details>
                    <order_status>In progress</order_status>
                </order_data>
            </OrderConfirmationResponse>
        </ns1:OrderConfirmationResponse>
    </SOAP-EN</div>V:Body>
</SOAP-ENV:Envelope>

الخطوة 5: التحقق من حالة الطلب (طلب عبر الإنترنت/غير متصل (مع search_result_id))

الوظيفة ChkStatus
  • - بالنسبة للطلبات غير المتصلة، فإن التحقق من حالة الطلب مرة كل 30 دقيقة يعد وتيرة مقبولة.
  • - بالنسبة للطلبات عبر الإنترنت، فإن التحقق من حالة الطلب مرة كل 5 ثوانٍ يعد وتيرة مقبولة.

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:ChkStatus>
            <ChkStatusRequest>
                <order_id>90000055</order_id>
            </ChkStatusRequest>
        </ns0:ChkStatus>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:ChkStatusResponse>
            <ChkStatusResponse>
                <order_data>
                    <order_id>90000055</order_id>
                    <order_hash>TE6PIomXrMIinvhD1DwgcdRbUS_hFrqZDX3t1eY_9N03fjazTF3OewkDCt6BczGL</order_hash>
                    <order_deadline>2019-09-09</order_deadline>
                    <price>25</price>
                    <currency>EUR</currency>
                    <request_time>2019-09-09 13:13:43</request_time>
                    <order_details>
                        <country>FIN</country>
                        <product>full_report</product>
                        <delivery_term>o</delivery_term>
                        <notification_of_completion>false</notification_of_completion>
                        <company_details>
                            <business_name>Company LLC</business_name>
                            <reg_code>08481566</reg_code>
                            <vat_code>000000001</vat_code>
                            <address>Company address</address>
                            <phone>Company phone</phone>
                            <email>Company email</email>
                            <additional_info>Additional information regarding company</additional_info>
                            <ref_code>ref_code</ref_code>
                        </company_details>
                    </order_details>
                    <order_status>Finished</order_status>
                </order_data>
            </ChkStatusResponse>
        </ns1:ChkStatusResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

تُستخدم الحالات التالية للتقارير:

  • قيد التنفيذ - تقرير في مرحلة الإنتاج
  • بانتظار التحديد - إعداد التقرير مؤجل. يتطلب بيانات إضافية من العميل.
  • ملغى - طلبية ملغاة
  • مكتمل - التقرير جاهز
  • محدَّث - تمت إضافة معلومات إلى التقرير النهائي
  • مرفوض - تم رفض الطلب (رصيد غير كافٍ، أو تفاصيل طلب غير صحيحة، أو سبب آخر).
  • خطأ تقني - حدث خطأ فني في نظامنا. هذا يعني أننا على علم بهذا الخطأ وسنقوم بإصلاحه في أسرع وقت ممكن. سيتم إخطارك عندما تصبح قادرًا على استلام الطلب.

إذا كانت حالة التنفيذ Finished أو Updated، يمكنك الحصول على الطلب.

الخطوة 6: الحصول على التقرير (طلب عبر الإنترنت/غير متصل (مع 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 (الصينية)

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:GetReport>
            <GetReportRequest>
                <order_id>90000055</order_id>
                <lang>en</lang>
            </GetReportRequest>
        </ns0:GetReport>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <SOAP-ENV:Body>
        <ns1:GetReportResponse>
            <GetReportResponse>
                <order_data>
                    <order_id>90000055</order_id>
                    <order_hash>TE6PIomXrMIinvhD1DwgcdRbUS_hFrqZDX3t1eY_9N03fjazTF3OewkDCt6BczGL</order_hash>
                    <order_deadline>2019-09-09</order_deadline>
                    <price>25</price>
                    <currency>EUR</currency>
                    <request_time>2019-09-09 13:13:43</request_time>
                    <order_details>
                        <country>FIN</country>
                        <product>full_report</product>
                        <delivery_term>o</delivery_term>
                        <notification_of_completion>false</notification_of_completion>
                        <company_details>
                            <business_name>Company LLC</business_name>
                            <reg_code>08481566</reg_code>
                            <vat_code>000000001</vat_code>
                            <address>Company address</address>
                            <phone>Company phone</phone>
                            <email>Company email</email>
                            <additional_info>Additional information regarding company</additional_info>
                            <ref_code>ref_code</ref_code>
                        </company_details>
                    </order_details>
                    <order_status>Finished</order_status>
                </order_data>
                <report>
                    <language>en</language>
                    <revision_date>2019-01-28</revision_date>
                    <identification>
                        <person_type key="101741" lang="en">company</person_type>
                        <name>Company LLC</name>
                        <code>0848156-6</code>
                        <code_origin>FIN</code_origin>
                    </identification>
                    <summary>
                        <name_in_the_register>Company LLC</name_in_the_register>
                        <name_in_english>Company name in English</name_in_english>
                        <registration_code>...</registration_code>
                        <taxpayer_code>...</taxpayer_code>
                        <legal_form>...</legal_form>
                        <unified_legal_form>...</unified_legal_form>
                        <legal_address>...</legal_address>
                        <office_address>...</office_address>
                        <telephone>...</telephone>
                        <fax>...</fax>
                        <email>...</email>
                        <www>...</www>
                        <legal_status>...</legal_status>
                        <capital>...</capital>
                        <capital_currency>...</capital_currency>
                        <foundation_date>...</foundation_date>
                        <deletion_date xsi:nil="..."/>
                        <remarks_on_payments>...</remarks_on_payments>
                        <export>...</export>
                        <import>...</import>
                        <litigations>...</litigations>
                        <main_activities>...</main_activities>
                        <latest_turnovers>...</latest_turnovers>
                        <credit_rating>...</credit_rating>
                        <credit_rating_description>...</credit_rating_description>
                        <credit_rating_limit>...</credit_rating_limit>
                    </summary>
                    <credit_opinions>...</credit_opinions>
                    <general_data>
                        <business_names_data>...</business_names_data>
                        <registration_data>...</registration_data>
                        <trade_names_data>...</trade_names_data>
                        <addresses_data>...</addresses_data>
                        <contacts_data>...</contacts_data>
                        <important_notifications_data>...</important_notifications_data>
                        <statuses_data>...</statuses_data>
                        <activities_data>...</activities_data>
                        <legal_form_data>...</legal_form_data>
                        <capital_data>...</capital_data>
                        <employees_data>...</employees_data>
                    </general_data>
                    <shareholders>...</shareholders>
                    <managers>...</managers>
                    <the_normal_regulations_of_the_representation_rights>...</the_normal_regulations_of_the_representation_rights>
                    <relations_of_persons>...</relations_of_persons>
                    <branches_data>...</branches_data>
                    <export_import_data>...</export_import_data>
                    <publications_data>...</publications_data>
                    <negative_information>...</negative_information>
                    <financial_statements_data>...</financial_statements_data>
                </report>
            </GetReportResponse>
        </ns1:GetReportResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

الخطوة 1: طلب تقرير (طلب غير متصل (بدون search_result_id))

الوظيفة Order
إذا لم تستخدم العنصر confirm_order، فستتلقى <last_duplicates> في استجابة XML، حتى تتمكن من تحديد ما إذا كنت تحتاج فعلاً إلى تقديم طلب.

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:Order>
            <OrderReportRequest>
                <order_details>
                    <country>RUS</country>
                    <product>full_report</product>
                    <delivery_term>n</delivery_term> <!-- available delivery_term: "n", "f" and "s" -->
                    <notification_of_completion>true</notification_of_completion>
                    <confirm_order>false</confirm_order>
                    <copy_notifiaction_to_other_emails>
                        <item>mail1@mail.com</item>
                        <item>mail2@mail.com</item>
                    </copy_notifiaction_to_other_emails>
                    <company_details>
                        <business_name>Company LLC</business_name> <!-- business_name or reg_code is required -->
                        <reg_code>123456789</reg_code> <!-- business_name or reg_code is required -->
                        <vat_code>000000001</vat_code>
                        <address>Company address</address>
                        <phone>Company phone</phone>
                        <email>Company email</email>
                        <additional_info>Additional information regarding company</additional_info>
                        <ref_code>YOUR REF CODE</ref_code> <!-- if you need it -->
                    </company_details>
                </order_details>
            </OrderReportRequest>
        </ns0:Order>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:OrderResponse>
            <OrderReportResponse>
                <order_data>
                    <order_id>1000000040</order_id>
                    <order_hash>pP0lMzDIsPgEClO0nHk5Lo_fsGLhqADVNzx3RPFJj5DOTHm-Z5vA_PMUgMJm84Di</order_hash>
                    <order_deadline>2019-09-09</order_deadline>
                    <price>25</price>
                    <currency>EUR</currency>
                    <request_time>2019-09-09 13:11:32</request_time>
                    <order_details>
                        <country>FIN</country>
                        <product>full_report</product>
                        <delivery_term>n</delivery_term>
                        <notification_of_completion>false</notification_of_completion>
                        <company_details>
                            <business_name>Company LLC</business_name>
                            <reg_code>123456789</reg_code>
                            <vat_code>000000001</vat_code>
                            <address>Company address</address>
                            <phone>Company phone</phone>
                            <email>Company email</email>
                            <additional_info>Additional information regarding company</additional_info>
                            <ref_code>YOUR REF CODE</ref_code>
                        </company_details>
                    </order_details>
                    <order_status>Awaiting Confirmation</order_status>
                </order_data>
                <last_duplicates>
                    <order_data>
                        <order_id>1000000035</order_id>
                        <order_hash>ZJHhHYIbpUp2xtZM1Jqg5QQYmnrLo2E7p-J8uP7BUF5_G7BNu5J0-nNVxKOeIxun</order_hash>
                        <order_deadline>2019-08-01 </order_deadline>
                        <price>25</price>
                        <currency>EUR</currency>
                        <request_time>2019-08-01 13:02:32</request_time>
                        <order_details>
                            <country>FIN</country>
                            <product>full_report</product>
                            <delivery_term>f</delivery_term>
                            <notification_of_completion>false</notification_of_completion>
                            <company_details>
                                <reg_code>123456789</reg_code>
                                <ref_code>ref_code</ref_code>
                            </company_details>
                        </order_details>
                        <order_status>Awaiting Confirmation</order_status>
                    </order_data>
                    <order_data>
                        <order_id>1000000036</order_id>
                        <order_hash>X4Z6VL9KZd5bWsnWQ_NjdlfN2ix7M1jdwW_FrJ_IyIVKwkDipsx73dW3RMgVE8y0</order_hash>
                        <order_deadline>2019-06-02</order_deadline>
                        <price>25</price>
                        <currency>EUR</currency>
                        <request_time>2019-06-02 16:34:12</request_time>
                        <order_details>
                            <country>FIN</country>
                            <product>full_report</product>
                            <delivery_term>o</delivery_term>
                            <notification_of_completion>false</notification_of_completion>
                            <company_details>
                                <reg_code>123456789</reg_code>
                                <ref_code>ref_code</ref_code>
                            </company_details>
                        </order_details>
                        <order_status>Finished</order_status>
                    </order_data>
                </last_duplicates>
            </OrderReportResponse>
        </ns1:OrderResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

الخطوة 2: إلغاء الطلب (اختياري) (طلب غير متصل (بدون search_result_id))

الوظيفة OrderCancellation
إذا رغبت في إلغاء الطلب، يمكنك استخدام دالة OrderCancellation. إذا كان الطلب قيد التنفيذ بالفعل، فلن تتمكن من إلغائه.

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:OrderCancellation>
            <OrderCancellationRequest>
                <order_id>1000000040</order_id>
            </OrderCancellationRequest>
        </ns0:OrderCancellation>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:OrderCancellationResponse>
            <OrderCancellationResponse>
                <order_data>
                    <order_id>1000000040</order_id>
                    <order_hash>pP0lMzDIsPgEClO0nHk5Lo_fsGLhqADVNzx3RPFJj5DOTHm-Z5vA_PMUgMJm84Di</order_hash>
                    <order_deadline>2019-09-09</order_deadline>
                    <price>25</price>
                    <currency>EUR</currency>
                    <request_time>2019-09-09 13:11:32</request_time>
                    <order_details>
                        <country>FIN</country>
                        <product>full_report</product>
                        <delivery_term>n</delivery_term>
                        <notification_of_completion>false</notification_of_completion>
                        <company_details>
                            <business_name>Company LLC</business_name>
                            <reg_code>123456789</reg_code>
                            <vat_code>000000001</vat_code>
                            <address>Company address</address>
                            <phone>Company phone</phone>
                            <email>Company email</email>
                            <additional_info>Additional information regarding company</additional_info>
                            <ref_code>YOUR REF CODE</ref_code>
                        </company_details>
                    </order_details>
                    <order_status>Canceled</order_status>
                </order_data>
            </OrderCancellationResponse>
        </ns1:OrderCancellationResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

الخطوة 3: تأكيد الطلب (طلب غير متصل (بدون search_result_id))

الوظيفة OrderConfirmation
إذا لم تستخدم العنصر "confirm_order"، فيجب عليك تأكيد طلبك.

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:OrderConfirmation>
            <OrderConfirmationRequest>
                <order_id>1000000040</order_id>
            </OrderConfirmationRequest>
        </ns0:OrderConfirmation>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-EN>
        <ns1:OrderConfirmationResponse>
            <OrderConfirmationResponse>
                <order_data>
                    <order_id>1000000040</order_id>
                    <order_hash>pP0lMzDIsPgEClO0nHk5Lo_fsGLhqADVNzx3RPFJj5DOTHm-Z5vA_PMUgMJm84Di</order_hash>
                    <order_deadline>2019-09-09</order_deadline>
                    <price>25</price>
                    <currency>EUR</currency>
                    <request_time>2019-09-09 13:11:32</request_time>
                    <order_details>
                        <country>FIN</country>
                        <product>full_report</product>
                        <delivery_term>n</delivery_term>
                        <notification_of_completion>false</notification_of_completion>
                        <company_details>
                            <business_name>Company LLC</business_name>
                            <reg_code>123456789</reg_code>
                            <vat_code>000000001</vat_code>
                            <address>Company address</address>
                            <phone>Company phone</phone>
                            <email>Company email</email>
                            <additional_info>Additional information regarding company</additional_info>
                            <ref_code>YOUR REF CODE</ref_code>
                        </company_details>
                    </order_details>
                    <order_status>In progress</order_status>
                </order_data>
            </OrderConfirmationResponse>
        </ns1:OrderConfirmationResponse>
    </SOAP-EN</div>V:Body>
</SOAP-ENV:Envelope>

الخطوة 4: التحقق من الحالة (طلب غير متصل (بدون search_result_id))

الوظيفة ChkStatus
بالنسبة للطلبات غير المتصلة، فإن التحقق من حالة الطلب مرة كل 30 دقيقة يعد وتيرة مقبولة.

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:ChkStatus>
            <ChkStatusRequest>
                <order_id>1000000040</order_id>
            </ChkStatusRequest>
        </ns0:ChkStatus>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:ChkStatusResponse>
            <ChkStatusResponse>
                <order_data>
                    <order_id>1000000040</order_id>
                    <order_hash>pP0lMzDIsPgEClO0nHk5Lo_fsGLhqADVNzx3RPFJj5DOTHm-Z5vA_PMUgMJm84Di</order_hash>
                    <order_deadline>2019-09-09</order_deadline>
                    <price>25</price>
                    <currency>EUR</currency>
                    <request_time>2019-09-09 13:11:32</request_time>
                    <order_details>
                        <country>FIN</country>
                        <product>full_report</product>
                        <delivery_term>n</delivery_term>
                        <notification_of_completion>false</notification_of_completion>
                        <company_details>
                            <business_name>Company LLC</business_name>
                            <reg_code>123456789</reg_code>
                            <vat_code>000000001</vat_code>
                            <address>Company address</address>
                            <phone>Company phone</phone>
                            <email>Company email</email>
                            <additional_info>Additional information regarding company</additional_info>
                            <ref_code>YOUR REF CODE</ref_code>
                        </company_details>
                    </order_details>
                    <order_status>Finished</order_status>
                </order_data>
            </ChkStatusResponse>
        </ns1:ChkStatusResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

تُستخدم الحالات التالية للتقارير:

  • قيد التنفيذ - تقرير في مرحلة الإنتاج
  • بانتظار التحديد - إعداد التقرير مؤجل. يتطلب بيانات إضافية من العميل.
  • ملغى - طلبية ملغاة
  • مكتمل - التقرير جاهز
  • محدَّث - تمت إضافة معلومات إلى التقرير النهائي
  • مرفوض - تم رفض الطلب (رصيد غير كافٍ، أو تفاصيل طلب غير صحيحة، أو سبب آخر).
  • خطأ تقني - حدث خطأ فني في نظامنا. هذا يعني أننا على علم بهذا الخطأ وسنقوم بإصلاحه في أسرع وقت ممكن. سيتم إخطارك عندما تصبح قادرًا على استلام الطلب.

إذا كانت حالة التنفيذ Finished أو Updated، يمكنك الحصول على الطلب.

الخطوة 5: الحصول على التقرير (طلب غير متصل (بدون 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 (الصينية)

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:GetReport>
            <GetReportRequest>
                <order_id>1000000040</order_id>
                <lang>en</lang>
            </GetReportRequest>
        </ns0:GetReport>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <SOAP-ENV:Body>
        <ns1:GetReportResponse>
            <GetReportResponse>
                <order_data>
                    <order_id>1000000040</order_id>
                    <order_hash>pP0lMzDIsPgEClO0nHk5Lo_fsGLhqADVNzx3RPFJj5DOTHm-Z5vA_PMUgMJm84Di</order_hash>
                    <order_deadline>2019-09-09</order_deadline>
                    <price>25</price>
                    <currency>EUR</currency>
                    <request_time>2019-09-09 13:11:32</request_time>
                    <order_details>
                        <country>FIN</country>
                        <product>full_report</product>
                        <delivery_term>n</delivery_term>
                        <notification_of_completion>false</notification_of_completion>
                        <company_details>
                            <business_name>Company LLC</business_name>
                            <reg_code>123456789</reg_code>
                            <vat_code>000000001</vat_code>
                            <address>Company address</address>
                            <phone>Company phone</phone>
                            <email>Company email</email>
                            <additional_info>Additional information regarding company</additional_info>
                            <ref_code>YOUR REF CODE</ref_code>
                        </company_details>
                    </order_details>
                    <order_status>Finished</order_status>
                </order_data>
                <report>
                    <language>en</language>
                    <revision_date>2019-01-28</revision_date>
                    <identification>
                        <person_type key="101741" lang="en">company</person_type>
                        <name>Company LLC</name>
                        <code>12345678-9</code>
                        <code_origin>FIN</code_origin>
                    </identification>
                    <summary>
                        <name_in_the_register>Company LLC</name_in_the_register>
                        <name_in_english>Company name in English</name_in_english>
                        <registration_code>...</registration_code>
                        <taxpayer_code>...</taxpayer_code>
                        <legal_form>...</legal_form>
                        <unified_legal_form>...</unified_legal_form>
                        <legal_address>...</legal_address>
                        <office_address>...</office_address>
                        <telephone>...</telephone>
                        <fax>...</fax>
                        <email>...</email>
                        <www>...</www>
                        <legal_status>...</legal_status>
                        <capital>...</capital>
                        <capital_currency>...</capital_currency>
                        <foundation_date>...</foundation_date>
                        <deletion_date xsi:nil="..."/>
                        <remarks_on_payments>...</remarks_on_payments>
                        <export>...</export>
                        <import>...</import>
                        <litigations>...</litigations>
                        <main_activities>...</main_activities>
                        <latest_turnovers>...</latest_turnovers>
                        <credit_rating>...</credit_rating>
                        <credit_rating_description>...</credit_rating_description>
                        <credit_rating_limit>...</credit_rating_limit>
                    </summary>
                    <credit_opinions>...</credit_opinions>
                    <general_data>
                        <business_names_data>...</business_names_data>
                        <registration_data>...</registration_data>
                        <trade_names_data>...</trade_names_data>
                        <addresses_data>...</addresses_data>
                        <contacts_data>...</contacts_data>
                        <important_notifications_data>...</important_notifications_data>
                        <statuses_data>...</statuses_data>
                        <activities_data>...</activities_data>
                        <legal_form_data>...</legal_form_data>
                        <capital_data>...</capital_data>
                        <employees_data>...</employees_data>
                    </general_data>
                    <shareholders>...</shareholders>
                    <managers>...</managers>
                    <the_normal_regulations_of_the_representation_rights>...</the_normal_regulations_of_the_representation_rights>
                    <relations_of_persons>...</relations_of_persons>
                    <branches_data>...</branches_data>
                    <export_import_data>...</export_import_data>
                    <publications_data>...</publications_data>
                    <negative_information>...</negative_information>
                    <financial_statements_data>...</financial_statements_data>
                </report>
            </GetReportResponse>
        </ns1:GetReportResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

كيفية طلب تقرير ائتماني محفوظ؟


شراء تقرير مؤرشف متاح لجميع البلدان.

أدناه يمكنك الاطلاع على مثال حول كيفية طلب وتنزيل التقارير المؤرشفة:

الخطوة 1: العثور على شركة

الوظيفة SimpleSearch

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:SimpleSearchResponse>
            <SimpleSearchResponse>
                <search_result>
                    <item>
                        <search_result_id>7b459516-a36b-4f4a-83d9-7a1a864494df</search_result_id>
                        <name>Example Company Name</name>
                        <reg_code>00000000</reg_code>
                        ...
                        <archived_reports> <!-- <?= t('docs', 'Section with available archived reports on this company') ?>-->
                            ...
                            <item>
                                <product>full_report</product>
                                <revision_date>2022-04-13</revision_date>
                                <archived_report_cost>15.75</archived_report_cost>
                                <archived_report_cost_currency>EUR</archived_report_cost_currency>
                                <last_fin_report>
                                    <fin_report_year>2021</fin_report_year>
                                    <fin_period_start>2021-01-01</fin_period_start>
                                    <fin_period_end>2021-12-31</fin_period_end>
                                    <fin_period_duration_in_months>12</fin_period_duration_in_months>
                                </last_fin_report>
                            </item>
                            ...
                        </archived_reports>
                    </item>
                    ...
                </search_result>
            </SimpleSearchResponse>
        </ns1:SimpleSearchResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

لطلب تقرير مؤرشف يلزمك الحصول على "<search_result_id>" الذي يحتوي على قسم "<archived_reports>" يتضمن المنتج الذي تحتاجه.
للقيام بذلك، يُرجى اتباع الرابط: كيفية البحث عن شركة؟

أمثلة على الشركات التي لديها تقارير مؤرشفة:

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

الخطوة 2: طلب تقرير

الوظيفة Order

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:Order>
            <OrderReportRequest>
                <order_details_by_id>
                    <country>FIN</country>
                    <product>full_report</product><!-- <?= t('docs', "Selected archived product for this company") ?> -->
                    <delivery_term>a</delivery_term> <!-- <?= t('docs', "Core difference, always 'a' = archive") ?> -->
                    <notification_of_completion>true</notification_of_completion>
                    <confirm_order>true</confirm_order>
                    <copy_notifiaction_to_other_emails>
                        <item>mail1@mail.com</item>
                    	<item>mail2@mail.com</item>
                    </copy_notifiaction_to_other_emails>
                    <company_details>
                        <search_result_id>7b459516-a36b-4f4a-83d9-7a1a864494df</search_result_id> <!-- <?= t('docs', 'Always required') ?> -->
                        <ref_code>YOUR REF CODE</ref_code> <!-- <?= t('docs', 'If you need it') ?> -->
                    </company_details>
                </order_details_by_id>
            </OrderReportRequest>
        </ns0:Order>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

الخطوة 3: إلغاء الطلب (اختياري)

تمامًا كما في التقارير عبر الإنترنت/غير المتصلة.

الخطوة 4: تأكيد الطلب

تمامًا كما في التقارير عبر الإنترنت/غير المتصلة.

الخطوة 5: التحقق من حالة الطلب

تمامًا كما في التقارير عبر الإنترنت/غير المتصلة.

بالنسبة لطلبات التقارير المؤرشفة، فإن التحقق من حالة الطلب مرة كل 5 ثوانٍ يعد وتيرة مقبولة.

الخطوة 6: الحصول على التقرير

تمامًا كما في التقارير عبر الإنترنت/غير المتصلة.

كيفية طلب البيانات المالية عبر الإنترنت؟


الخطوة 1: العثور على شركة

الوظيفة SimpleSearch

لطلب القوائم المالية عبر الإنترنت يلزمك الحصول على "<search_result_id>".
للقيام بذلك، يُرجى اتباع الرابط: كيفية البحث عن شركة؟

تتيح لك عملية البحث تحديد الشركة التي ترغب في تقديم طلب لها بدقة. على سبيل المثال، في بعض البلدان قد توجد عدة شركات برقم تسجيل واحد، أو قد ينتمي الاسم الرسمي نفسه إلى عدة شركات.

الخطوة 2: البحث عن البيانات المالية المتاحة

الوظيفة ChkFinance

هذه الوظيفة مطلوبة فقط عند طلب منتج: finances (Financial statements) مع delivery_term = 'o'.

قائمة البلدان المتاحة: إستونيا (EST), السويد (SWE)

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:ChkFinance>
            <ChkFinanceRequest>
                <finance_check_block>
                    <search_result_id>0f6b91f8-3d1b-4901-9d1f-6920afca0667</search_result_id>
                    <country>EST</country>
                </finance_check_block>
            </ChkFinanceRequest>
        </ns0:ChkFinance>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <SOAP-ENV:Body>
        <ns1:ChkFinanceResponse>
            <ChkFinanceResponse>
                <finance_check_result>
                    <search_result_id>0f6b91f8-3d1b-4901-9d1f-6920afca0667</search_result_id>
                    <name>00000000 EHITUS</name>
                    <reg_code>00000000</reg_code>
                    <vat_code xsi:nil="true"/>
                    <legal_status>Entered into the register</legal_status>
                    <legal_form>Aktsiaselts</legal_form>
                    <legal_address>Järvevana tee 9g, Kesklinna linnaosa, Tallinn, Harju maakond,
                        11314, Eesti</legal_address>
                    <financial_statements>
                        <item>
                            <available_year>2021</available_year>
                        </item>
                        <item>
                            <available_year>2020</available_year>
                        </item>
                        <item>
                            <available_year>2019</available_year>
                        </item>
                        <item>
                            <available_year>2018</available_year>
                        </item>
                        <item>
                            <available_year>2017</available_year>
                        </item>
                        <item>
                            <available_year>2016</available_year>
                        </item>
                        <item>
                            <available_year>2015</available_year>
                        </item>
                        <item>
                            <available_year>2014</available_year>
                        </item>
                        <item>
                            <available_year>2013</available_year>
                        </item>
                    </financial_statements>
                </finance_check_result>
            </ChkFinanceResponse>
        </ns1:ChkFinanceResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

الخطوة 3: طلب البيانات المالية

الوظيفة Order
إذا لم تستخدم العنصر confirm_order، فستتلقى <last_duplicates> في استجابة XML، حتى تتمكن من تحديد ما إذا كنت تحتاج فعلاً إلى تقديم طلب.

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:Order>
            <OrderReportRequest>
                <order_details_by_id>
                    <country>EST</country>
                    <product>finances</product>
                    <delivery_term>o</delivery_term>
                    <preferable_finances> <!-- only neccasery for product: 'finances' -->
                        <item>2021</item>
                        <item>2020</item>
                    </preferable_finances>
                    <notification_of_completion>true</notification_of_completion>
                    <confirm_order>false</confirm_order>
                    <copy_notifiaction_to_other_emails>
                        <item>mail1@mail.com</item>
                    	<item>mail2@mail.com</item>
                    </copy_notifiaction_to_other_emails>
                    <company_details>
                        <search_result_id>60751300-4b72-451f-bf96-2a1a7cbe71c6</search_result_id>
                        <ref_code>YOUR REF CODE</ref_code> <!-- if you need it -->
                    </company_details>
                </order_details_by_id>
            </OrderReportRequest>
        </ns0:Order>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:OrderResponse>
            <OrderReportResponse>
                <order_data>
                    <order_id>90000055</order_id>
                    <order_hash>TE6PIomXrMIinvhD1DwgcdRbUS_hFrqZDX3t1eY_9N03fjazTF3OewkDCt6BczGL</order_hash>
                    <order_deadline>2019-09-09</order_deadline>
                    <price>25</price>
                    <currency>EUR</currency>
                    <request_time>2019-09-09 13:13:43</request_time>
                    <order_details>
                        <country>EST</country>
                        <product>finances</product>
                        <delivery_term>o</delivery_term>
                        <preferable_finances>
                            <item>2021</item>
                            <item>2020</item>
                        </preferable_finances>
                        <notification_of_completion>false</notification_of_completion>
                        <company_details>
                            <business_name>00000000 EHITUS</business_name>
                            <reg_code>00000000</reg_code>
                            <ref_code>YOUR REF CODE</ref_code>
                        </company_details>
                    </order_details>
                    <order_status>Awaiting Confirmation</order_status>
                </order_data>
                <last_duplicates>
                    <order_data>
                        <order_id>90000054</order_id>
                        <order_hash>ZJHhHYIbpUp2xtZM1Jqg5QQYmnrLo2E7p-J8uP7BUF5_G7BNu5J0-nNVxKOeIxun</order_hash>
                        <order_deadline>2019-09-09 </order_deadline>
                        <price>25</price>
                        <currency>EUR</currency>
                        <request_time>2019-09-09 13:02:32</request_time>
                        <order_details>
                            <country>EST</country>
                            <product>finances</product>
                            <delivery_term>o</delivery_term>
                            <preferable_finances>
                                <item>2020</item>
                                <item>2019</item>
                            </preferable_finances>
                            <notification_of_completion>false</notification_of_completion>
                            <company_details>
                                <business_name>00000000 EHITUS</business_name>
                                <reg_code>00000000</reg_code>
                                <ref_code>YOUR REF CODE</ref_code>
                            </company_details>
                        </order_details>
                        <order_status>Awaiting Confirmation</order_status>
                    </order_data>
                    <order_data>
                        <order_id>90000053</order_id>
                        <order_hash>X4Z6VL9KZd5bWsnWQ_NjdlfN2ix7M1jdwW_FrJ_IyIVKwkDipsx73dW3RMgVE8y0</order_hash>
                        <order_deadline>2019-08-02</order_deadline>
                        <price>25</price>
                        <currency>EUR</currency>
                        <request_time>2019-08-02 16:34:12</request_time>
                        <order_details>
                            <country>EST</country>
                            <product>finances</product>
                            <delivery_term>o</delivery_term>
                            <preferable_finances>
                                <item>2018</item>
                            </preferable_finances>
                            <notification_of_completion>false</notification_of_completion>
                            <company_details>
                                <business_name>00000000 EHITUS</business_name>
                                <reg_code>00000000</reg_code>
                                <ref_code>YOUR REF CODE</ref_code>
                            </company_details>
                        </order_details>
                        <order_status>Finished</order_status>
                    </order_data>
                </last_duplicates>
            </OrderReportResponse>
        </ns1:OrderResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

الخطوة 4: إلغاء الطلب (اختياري)

الوظيفة OrderCancellation
إذا رغبت في إلغاء الطلب، يمكنك استخدام دالة OrderCancellation هذه. إذا كان الطلب قيد التنفيذ بالفعل، فلن تتمكن من إلغائه.
للاطلاع على أمثلة طلب/استجابة XML، يُرجى اتباع الرابط: كيف ألغي الطلب؟

الخطوة 5: تأكيد الطلب

الوظيفة OrderConfirmation
إذا لم تستخدم العنصر "confirm_order"، فيجب عليك تأكيد طلبك.
للاطلاع على أمثلة طلب/استجابة XML، يُرجى اتباع الرابط: كيف أؤكد الطلب؟

الخطوة 6: التحقق من حالة الطلب

الوظيفة ChkStatus
  • - بالنسبة للطلبات عبر الإنترنت، فإن التحقق من حالة الطلب مرة كل 5 ثوانٍ يعد وتيرة مقبولة.

تُستخدم الحالات التالية للتقارير:

  • قيد التنفيذ - تقرير في مرحلة الإنتاج
  • بانتظار التحديد - إعداد التقرير مؤجل. يتطلب بيانات إضافية من العميل.
  • ملغى - طلبية ملغاة
  • مكتمل - التقرير جاهز
  • محدَّث - تمت إضافة معلومات إلى التقرير النهائي
  • مرفوض - تم رفض الطلب (رصيد غير كافٍ، أو تفاصيل طلب غير صحيحة، أو سبب آخر).
  • خطأ تقني - حدث خطأ فني في نظامنا. هذا يعني أننا على علم بهذا الخطأ وسنقوم بإصلاحه في أسرع وقت ممكن. سيتم إخطارك عندما تصبح قادرًا على استلام الطلب.

إذا كانت حالة التنفيذ Finished أو Updated، يمكنك الحصول على الطلب.

للاطلاع على أمثلة طلب/استجابة XML، يُرجى اتباع الرابط: كيف أتحقق من حالة الطلب؟

الخطوة 7: الحصول على التقرير

الوظيفة 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 (الصينية)
للاطلاع على أمثلة طلب/استجابة XML، يُرجى اتباع الرابط: كيف أحصل على الطلب المكتمل؟

كيفية تنزيل التقارير القياسية (بتنسيقات أخرى غير XML)؟


أنواع المنتجات القياسية: 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. التجزئة الفريدة الخاصة بك، والتي نقدمها لك رداً على ذلك
    <order_hash>
  3. والجزء الثابت في النهاية /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

كيفية تنزيل المنتجات غير القياسية؟


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

كيفية الحصول على رأي ائتماني؟


الوظيفة CreditOpinionCalculator

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns0="http://infoproff.com/">
   <SOAP-ENV:Header />
   <SOAP-ENV:Body>
      <ns0:CreditOpinionCalculator>
         <CreditOpinionCalculatorRequest>
            <order_details>
               <country>XXX</country>
               <product>credit_opinion_calculator</product>
               <delivery_term>o</delivery_term>
               <lang>en</lang>
               <ref_code>test1</ref_code>
               <initial_data>
                  <general_data>
                     <status>REG</status>
                     <foundation>1996-11-13</foundation>
                     <nace2code>22.21</nace2code>
                     <employees>
                        <item>
                           <number_of_employees>236</number_of_employees>
                           <year>2018</year>
                           <period_end_date>2018-12-31</period_end_date>
                        </item>
                        <item>
                           <number_of_employees>216</number_of_employees>
                           <year>2017</year>
                           <period_end_date>2017-12-31</period_end_date>
                        </item>
                        <item>
                           <number_of_employees>210</number_of_employees>
                           <year>2016</year>
                           <period_end_date>2016-12-31</period_end_date>
                        </item>
                     </employees>
                  </general_data>
                  <debts>
                     <unpaid_debts>
                        <total_amount>100000000</total_amount>
                        <currency_name>EUR</currency_name>
                        <currency_exchange_rate_to_eur>1</currency_exchange_rate_to_eur>
                     </unpaid_debts>
                     <last_registered_debt>2020-01-15</last_registered_debt>
                  </debts>
                  <financial_elements>
                     <item>
                        <year>2018</year>
                        <period>12</period>
                        <currency>EUR</currency>
                        <scale>1</scale>
                        <currency_exchange_rate_to_eur>1</currency_exchange_rate_to_eur>
                        <period_start_date>2018-01-01</period_start_date>
                        <period_end_date>2018-12-31</period_end_date>
                        <positions>
                           <position>
                              <position_code>1000</position_code>
                              <value>29089411</value>
                           </position>
                           <position>
                              <position_code>1010</position_code>
                              <value>6556256</value>
                           </position>
                           <position>
                              <position_code>1020</position_code>
                              <value>20895813</value>
                           </position>
                           <position>
                              <position_code>1100</position_code>
                              <value>26347731</value>
                           </position>
                           <position>
                              <position_code>1110</position_code>
                              <value>6422249</value>
                           </position>
                           </position>
                           <position>
                              <position_code>1130</position_code>
                              <value>315255</value>
                           </position>
                           <position>
                              <position_code>1200</position_code>
                              <value>55437150</value>
                           </position>
                           <position>
                              <position_code>1300</position_code>
                              <value>13563874</value>
                           </position>
                           <position>
                              <position_code>1310</position_code>
                              <value>2141431</value>
                           </position>
                           <position>
                              <position_code>1400</position_code>
                              <value>41542005</value>
                           </position>
                           <position>
                              <position_code>1410</position_code>
                              <value>10780537</value>
                           </position>
                           <position>
                              <position_code>1420</position_code>
                              <value>30761468</value>
                           </position>
                           <position>
                              <position_code>1500</position_code>
                              <value>55437150</value>
                           </position>
                           <position>
                              <position_code>1600</position_code>
                              <value>32763727</value>
                           </position>
                           <position>
                              <position_code>1700</position_code>
                              <value>-11583299</value>
                           </position>
                           <position>
                              <position_code>1800</position_code>
                              <value>1852455</value>
                           </position>
                           <position>
                              <position_code>1900</position_code>
                              <value>4604983</value>
                           </position>
                           <position>
                              <position_code>2000</position_code>
                              <value>3876811</value>
                           </position>
                        </positions>
                     </item>
                     <item>
                        <year>2017</year>
                        <period>12</period>
                        <currency>EUR</currency>
                        <scale>1</scale>
                        <currency_exchange_rate_to_eur>1</currency_exchange_rate_to_eur>
                        <period_start_date>2017-01-01</period_start_date>
                        <period_end_date>2017-12-31</period_end_date>
                        <positions>
                           <position>
                              <position_code>1000</position_code>
                              <value>27956649</value>
                           </position>
                           <position>
                              <position_code>1010</position_code>
                              <value>6699710</value>
                           </position>
                           <position>
                              <position_code>1020</position_code>
                              <value>20784951</value>
                           </position>
                           <position>
                              <position_code>1100</position_code>
                              <value>13530424</value>
                           </position>
                           <position>
                              <position_code>1110</position_code>
                              <value>5848610</value>
                           </position>
                           <position>
                              <position_code>1120</position_code>
                              <value>7350656</value>
                           </position>
                           <position>
                              <position_code>1130</position_code>
                              <value>331158</value>
                           </position>
                           <position>
                              <position_code>1200</position_code>
                              <value>41487080</value>
                           </position>
                           <position>
                              <position_code>1300</position_code>
                              <value>13233015</value>
                           </position>
                           <position>
                              <position_code>1310</position_code>
                              <value>2141431</value>
                           </position>
                           <position>
                              <position_code>1400</position_code>
                              <value>28234892</value>
                           </position>
                           <position>
                              <position_code>1410</position_code>
                              <value>4000000</value>
                           </position>
                           <position>
                              <position_code>1420</position_code>
                              <value>24234892</value>
                           </position>
                           <position>
                              <position_code>1500</position_code>
                              <value>41487080</value>
                           </position>
                           <position>
                              <position_code>1600</position_code>
                              <value>38508619</value>
                           </position>
                           <position>
                              <position_code>1700</position_code>
                              <value>-13380841</value>
                           </position>
                           <position>
                              <position_code>1800</position_code>
                              <value>4020449</value>
                           </position>
                           <position>
                              <position_code>1900</position_code>
                              <value>3071074</value>
                           </position>
                           <position>
                              <position_code>2000</position_code>
                              <value>2211543</value>
                           </position>
                        </positions>
                     </item>
                     <item>
                        <year>2016</year>
                        <period>12</period>
                        <currency>EUR</currency>
                        <scale>1</scale>
                        <currency_exchange_rate_to_eur>1</currency_exchange_rate_to_eur>
                        <period_start_date>2016-01-01</period_start_date>
                        <period_end_date>2016-12-31</period_end_date>
                        <positions>
                           <position>
                              <position_code>1000</position_code>
                              <value>23098292</value>
                           </position>
                           <position>
                              <position_code>1010</position_code>
                              <value>6251447</value>
                           </position>
                           <position>
                              <position_code>1020</position_code>
                              <value>16338678</value>
                           </position>
                           <position>
                              <position_code>1100</position_code>
                              <value>11104261</value>
                           </position>
                           <position>
                              <position_code>1110</position_code>
                              <value>5111604</value>
                           </position>
                           <position>
                              <position_code>1120</position_code>
                              <value>4657457</value>
                           </position>
                           <position>
                              <position_code>1130</position_code>
                              <value>1335200</value>
                           </position>
                           <position>
                              <position_code>1200</position_code>
                              <value>34202560</value>
                           </position>
                           <position>
                              <position_code>1300</position_code>
                              <value>12554095</value>
                           </position>
                           <position>
                              <position_code>1310</position_code>
                              <value>2141431</value>
                           </position>
                           <position>
                              <position_code>1400</position_code>
                              <value>21617540</value>
                           </position>
                           <position>
                              <position_code>1410</position_code>
                              <value>2000000</value>
                           </position>
                           <position>
                              <position_code>1420</position_code>
                              <value>19617540</value>
                           </position>
                           <position>
                              <position_code>1500</position_code>
                              <value>34202560</value>
                           </position>
                           <position>
                              <position_code>1600</position_code>
                              <value>34392412</value>
                           </position>
                           <position>
                              <position_code>1700</position_code>
                              <value>-12182016</value>
                           </position>
                           <position>
                              <position_code>1800</position_code>
                              <value>2520984</value>
                           </position>
                           <position>
                              <position_code>1900</position_code>
                              <value>-335799</value>
                           </position>
                           <position>
                              <position_code>2000</position_code>
                              <value>-764980</value>
                           </position>
                        </positions>
                     </item>
                  </financial_elements>
               </initial_data>
            </order_details>
         </CreditOpinionCalculatorRequest>
      </ns0:CreditOpinionCalculator>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://infoproff.com/">
   <SOAP-ENV:Body>
      <ns1:CreditOpinionCalculatorResponse>
         <CreditOpinionCalculatorResponse>
            <order_data>
               <order_id>1444</order_id>
               <order_hash>MpfreVp7EFZ7piIMQykCnfevRjyDOKNuAi5uAvy3XHBVAKpMXsLD99URoYppb7Ry</order_hash>
               <order_deadline>2020-01-27</order_deadline>
               <price>1.5</price>
               <currency>EUR</currency>
               <request_time>2020-01-27 14:09:27</request_time>
               <order_status>Finished</order_status>
            </order_data>
            <credit_opinion>
               <language>en</language>
               <ref_code>test1</ref_code>
               <credit_opinion>
                  <item>
                     <credit_rating>CCC</credit_rating>
                     <rating_description>Risk above normal. Short term credit only.</rating_description>
                     <credit_limit>154000</credit_limit>
                     <credit_limit_currency>EUR</credit_limit_currency>
                     <latest_turnover_type>R12</latest_turnover_type>
                     <latest_turnover_range>20 000 001 - 50 000 000</latest_turnover_range>
                     <rating_explanation>
                        <explanation>Long-established company.</explanation>
                        <explanation>Latest turnover range 20 000 001 - 50 000 000 EUR.</explanation>
                        <explanation>The company had downfall in turnover during the known financial periods (at least once).</explanation>
                        <explanation>Within last years company's turnover had a slight decrease (growth rate).</explanation>
                        <explanation>Equity of the company is at a normal level.</explanation>
                        <explanation>Current ratio of the company is at a low level.</explanation>
                        <explanation>Quick ratio of the company is at a very low level.</explanation>
                        <explanation>Profitability of the company is at a very high level (in relation to equity).</explanation>
                     </rating_explanation>
                  </item>
               </credit_opinion>
            </credit_opinion>
         </CreditOpinionCalculatorResponse>
      </ns1:CreditOpinionCalculatorResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

كيف يمكن الحصول على معلومات إضافية؟


الوظيفة GetClassifiersFinancialStatements

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:GetClassifiersFinancialStatements>
            <GetClassifiersFinancialStatementsRequest/>
        </ns0:GetClassifiersFinancialStatements>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:GetClassifiersFinancialStatementsResponse>
            <GetClassifiersFinancialStatementsResponse>
                <financial_statements>
                    <item>
                        <subtype_id>97</subtype_id>
                        <subtype_description>Income statement format 2</subtype_description>
                        <row_number>333100</row_number>
                        <row_formated_description>basic earnings (loss) per
                            share</row_formated_description>
                        <row_lang_key>6886</row_lang_key>
                        <row_order>340</row_order>
                    </item>
                    <item>
                        <subtype_id>97</subtype_id>
                        <subtype_description>Income statement format 2</subtype_description>
                        <row_number>323600</row_number>
                        <row_formated_description>interest income</row_formated_description>
                        <row_lang_key>3686</row_lang_key>
                        <row_order>170</row_order>
                    </item>
					...
                    <item>
                        <subtype_id>89</subtype_id>
                        <subtype_description>Financial key ratios</subtype_description>
                        <row_number>3080</row_number>
                        <row_formated_description>Quick ratio</row_formated_description>
                        <row_lang_key>7644</row_lang_key>
                        <row_order>80</row_order>
                    </item>
                    <item>
                        <subtype_id>89</subtype_id>
                        <subtype_description>Financial key ratios</subtype_description>
                        <row_number>3060</row_number>
                        <row_formated_description>Leverage</row_formated_description>
                        <row_lang_key>7541</row_lang_key>
                        <row_order>60</row_order>
                    </item>
                </financial_statements>
            </GetClassifiersFinancialStatementsResponse>
        </ns1:GetClassifiersFinancialStatementsResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:GetLegalForms>
            <GetLegalFormsRequest/>
        </ns0:GetLegalForms>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <SOAP-ENV:Body>
        <ns1:GetLegalFormsResponse>
            <GetLegalFormsResponse>
                <legal_forms>
                    <item>
                        <country>BLR</country>
                        <language>RUS</language>
                        <legal_form>Крестьянское (фермерское) хозяйство</legal_form>
                        <lang_key>268</lang_key>
                    </item>
                    <item>
                        <country>BLR</country>
                        <language>RUS</language>
                        <legal_form>Крестьянское хозяйство</legal_form>
                        <lang_key>268</lang_key>
                    </item>
                    <item>
                        <country>UKR</country>
                        <language>UKR</language>
                        <legal_form>Споживчий кооператив</legal_form>
                        <lang_key>264</lang_key>
                    </item>
                     <item>
                        <country>RUS</country>
                        <language>RUS</language>
                        <legal_form>АКЦИОНЕРНОЕ ОБЩЕСТВО</legal_form>
                        <lang_key>263</lang_key>
                    </item>
                </legal_forms>
            </GetLegalFormsResponse>
        </ns1:GetLegalFormsResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
الوظيفة GetActivityClassificators

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:GetActivityClassificators>
            <GetActivityClassificatorsRequest>
                <classificator_type>CLASSIFICATOR_TYPE</classificator_type>
            </GetActivityClassificatorsRequest>
        </ns0:GetActivityClassificators>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

CLASSIFICATOR_TYPE:
"EMTAK 2008"
"NACE Rev.2"
"КВЕД 2005"
"КВЕД 2010"
"ОКВЭД 2"
"ОКВЭД 2007"
"SBI"

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:GetActivityClassificatorsResponse>
            <GetActivityClassificatorsResponse>
                <classificator_type>NACE Rev.2</classificator_type>
                <activities>
                    <item>
                        <activity_description>ACCOMMODATION AND FOOD SERVICE ACTIVITIES</activity_description>
                        <activity_code>I</activity_code>
                        <activity_language>ENG</activity_language>
                        <activity_lang_key>10673</activity_lang_key>
                    </item>
					...
                    <item>
                        <activity_description>HUMAN HEALTH AND SOCIAL WORK
                            ACTIVITIES</activity_description>
                        <activity_code>Q</activity_code>
                        <activity_language>ENG</activity_language>
                        <activity_lang_key>10858</activity_lang_key>
                    </item>
                 </activities>
            </GetActivityClassificatorsResponse>
        </ns1:GetActivityClassificatorsResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
الوظيفة GetDictionaryStandardPhrases

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:GetDictionaryStandardPhrases>
            <GetDictionaryStandardPhrasesRequest/>
        </ns0:GetDictionaryStandardPhrases>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:GetDictionaryStandardPhrasesResponse>
            <GetDictionaryStandardPhrasesResponse>
                <dictionary_standard_phrases>
                    <item>
                        <dictionary_lang_key>6612</dictionary_lang_key>
                        <dictionary_category>opinion_comment</dictionary_category>
                        <dictionary_language>ENG</dictionary_language>
                        <dictionary_value>Company was in a merger process and financial statements
                            after merger are not available.</dictionary_value>
                    </item>
                    <item>
                        <dictionary_lang_key>101806</dictionary_lang_key>
                        <dictionary_category>asset_subtype</dictionary_category>
                        <dictionary_language>ENG</dictionary_language>
                        <dictionary_value>Property intended for varied purposes</dictionary_value>
                    </item>
					...
                    <item>
                        <dictionary_lang_key>252</dictionary_lang_key>
                        <dictionary_category>town_settlement_village_type</dictionary_category>
                        <dictionary_language>ENG</dictionary_language>
                        <dictionary_value>district</dictionary_value>
                    </item>
                    <item>
                        <dictionary_lang_key>254</dictionary_lang_key>
                        <dictionary_category>town_settlement_village_type</dictionary_category>
                        <dictionary_language>ENG</dictionary_language>
                        <dictionary_value>county</dictionary_value>
                    </item>
                </dictionary_standard_phrases>
            </GetDictionaryStandardPhrasesResponse>
        </ns1:GetDictionaryStandardPhrasesResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
الوظيفة GetAvailableProducts

delivery_term:

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

<!-- Request -->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns0="http://infoproff.com/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns0:GetAvailableProducts>
            <GetAvailableProductsRequest/>
        </ns0:GetAvailableProducts>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="http://infoproff.com/">
    <SOAP-ENV:Body>
        <ns1:GetAvailableProductsResponse>
            <GetAvailableProductsResponse>
                <available_products>
                    <item>
                        <country>RUS</country>
                        <product>full_report</product>
                        <delivery_term>n</delivery_term>
                        <full_description>Full Report (Normal)</full_description>
                        <maximum_delivery_working_days>7</maximum_delivery_working_days>
                        <price>28.00</price>
                    </item>
                    <item>
                        <country>SWE</country>
                        <product>full_report</product>
                        <delivery_term>o</delivery_term>
                        <full_description>Full Report (Normal)</full_description>
                        <maximum_delivery_working_days>0</maximum_delivery_working_days>
                        <price>25.00</price>
                    </item>
                    <item>
                        <country>FIN</country>
                        <product>full_report</product>
                        <delivery_term>o</delivery_term>
                        <full_description>Full Report (Normal)</full_description>
                        <maximum_delivery_working_days>0</maximum_delivery_working_days>
                        <price>25.00</price>
                    </item>
                </available_products>
            </GetAvailableProductsResponse>
        </ns1:GetAvailableProductsResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

الأخطاء المحتملة


قد تحدث هذه الأخطاء أثناء إرسال طلب إلى خدمة الويب الخاصة بنا..


جميع الوظائف
  • 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), أوكرانيا (UKR), أيرلندا (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), تركيا (TUR), تشيلي (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.
    يظهر هذا الخطأ فقط إذا حاولت طلب تقرير عبر الإنترنت دون search_result_id.
    من المهم استخدام order_details_by_id في 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 (الإصدار 4) مقارنةً بـ SOAP (الإصدار 3)


أقسام جديدة

  • country_economic_overview — تشمل الأقسام الفرعية التالية:
    • data_transparency_index
    • country_development_indicators
    • economic_forecast
  • paid_taxes — معلومات عن الضرائب المدفوعة.
  • tenders — معلومات عن المناقصات.
  • sanctions — تمت إضافتها إلى قسم " negative_information " (الأسئلة الشائعة).

تحديثات على الأقسام الحالية

في أقسام " beneficiaries" و" shareholders" و" managers" و" employees_data"، تمت إضافة العنصر التالي:
  • source_type — نوع مصدر البيانات (على سبيل المثال، official ، mass_media ، company_admin ، إلخ).
في قسم relations_of_persons ، تمت إضافة عنصر جديد:
  • match_type
تمت إعادة هيكلة قسم capital:
  • تمت إعادة تسمية عنصر " capital_amount " إلى " issued_capital".
  • تمت إضافة العناصر الجديدة التالية:
    • number_of_shares
    • share_value
    • authorized_capital
في قسم " employees_data " (مستخدمون متعددون):
  • يشير العنصر الجديد " group_figure " إلى ما إذا كانت البيانات تتضمن أرقامًا مجمعة على مستوى المجموعة (true).
  • يحدد العنصر source_type نوع مصدر البيانات.
  • يتم الآن تضمين العنصر " is_estimated " فقط إذا كانت قيمته true.
قسم جديد " assets_data " — يدمج الأقسام الموجودة سابقًا:
  • real_estate_data (المسمى سابقًا property_datavehicles ، machinery_and_equipment (المسمى سابقًا assets).
  • الإضافات المخطط لها في المستقبل: patents و biological_assets.
في قسم vehicles ، تمت إضافة حقل جديد:
  • value
في قسم " litigations " (مستقبل الموقع)، تمت إضافة العناصر التالية:
  • content، instance ، process ، authority
في financial_statement/positions و summary/latest_turnovers ، تمت إضافة عنصر جديد:
  • value_origin — يصف أصل القيمة؛ على سبيل المثال، القيمة estimated - هذه القيمة مقدرة ومحسوبة بناءً على البيانات المتاحة باستخدام المنطق أو الذكاء الاصطناعي.
في قسم branches_data ، تمت إضافة الحقول التالية:
  • registration_number
  • director_name

ملاحظة: قد تحدث بعض التحسينات والتعديلات الطفيفة خلال مرحلة الاستقرار.

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 يحتوي على معلومات حول الحدث.

فيما يلي مثال على الحمولة:
مثال على الحمولة في حالة الطلب الجديدة

                {
                    "event_type": "new_status",
                    "order_id": 12345,
                    "client_ref_number": "98765",
                    "new_status": "Finished"
                    "reason": "..." # Optional, an example here could be the reason for the "Rejected" status
                }
            
القيم المحتملة لحقل " "new_status" ":
  • "Finished" - اكتمل الطلب. يمكن استلام الطلب;
  • "Updated" - طلب محدث، بيانات مضافة إلى طلب مكتمل;
  • "Canceled" - تم إلغاء الطلب بناءً على طلب العميل (أو بموافقته);
  • "Rejected" - رفض الطلب. عادةً بسبب استحالة تحديد هوية الشركة.
  • "Identification pending" - نحتاج إلى مزيد من المعلومات من العميل قبل أن نتمكن من إعداد الطلب..

تأمين Webhooks

من المهم التحقق من أن طلبات POST المرسلة إلى عنوان URL للحمولة تأتي من تطبيقنا. للمساعدة في ذلك، يتضمن كل طلب webhook رأس X-Signature.

وصف التوقيع

للتوقيع، نستخدم HMAC مع خوارزمية SHA512.

السر هو سلسلة من معرف التطبيق والمفتاح السري من إعدادات webhooks.


                #!/bin/bash

                payload='{"key1": "value1","key2": "value2"}'
                secret='$app_id$secret_key'

                # Generate HMAC SHA512 signature
                signature=$(echo -n "$payload" | openssl dgst -sha512 -hmac "$secret" | awk '{print $2}')

                # Send request
                curl -X POST \
                  -H "Content-Type: application/json" \
                  -H "X-Signature: $signature" \
                  -d "$payload" \
                  https://example.com/api/endpoint
            

من الممكن إضافة معلمات الحصول الخاصة بك إلى نقطة النهاية لتحديد المرسل إذا لزم الأمر.


                https://example.com/api/endpoint?custom_token=c3606e43c40d4556b64a4ad8c72f554e
            

استكشاف الأخطاء وإصلاحها

يجب أن يستجيب الخادم في غضون 10 ثوانٍ ويعيد رمز HTTP 2XX؛ وإلا، يعتبر تسليم webhook فاشلاً. في حالة الفشل، ستحاول الميزة إعادة إرسال الطلب وفقًا لسياسة التسليم.