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

إصدار Switch V2

البدء

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

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

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

  • SimpleSearch - ابحث عن معلومات عن الشركات في مختلف البلدان.
  • Order - ينشئ order_id ويعيد التكرارات. يتم تحديد التكرارات بواسطة المعلمات التالية: country, product, delivery_term and reg_code.
  • OrderCancellation - إذا أرسلت طلبًا وتلقيت order_id، فيمكنك إلغاء هذا الطلب (إذا لم يدخل مرحلة الإنتاج).
  • OrderConfirmation - بعد الحصول على order_id ، سيتعين عليك تأكيد طلبك في غضون ساعة واحدة. إذا لم تقم بتأكيد طلبك في غضون ساعة واحدة، فسيتم إلغاء الطلب تلقائيًا.
  • ChkStatus - تحقق من حالة الطلب.
  • GetReport - احصل على التقارير النهائية.
  • GetClassifiersFinancialStatements - احصل على جميع المستندات المالية مع جميع العناصر: row_number و row_formated_description و row_lang_key و row_order.
  • GetLegalForms - احصل على جميع النماذج القانونية لجميع البلدان المتاحة.
  • GetActivityClassificators - احصل على جميع الرموز والأوصاف الخاصة بمصنف الأنشطة المحدد.
  • GetDictionaryStandardPhrases - احصل على جميع العبارات القياسية مع المفاتيح واللغة.
  • GetAvailableProducts - احصل على قائمة بالمنتجات المتاحة.
  • CreditOpinionCalculator - تساعد حاسبة الرأي الائتماني في تحديد الرأي الائتماني بشأن شركة ما.

تقدم API عدة خدمات:

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

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

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

  1. البحث حسب اسم الشركة,
  2. البحث حسب رمز التسجيل.
قائمة البلدان المتاحة: جمهورية فنلندا (FIN), مملكة السويد (SWE), مملكة النرويج (NOR), مملكة الدنمارك (DNK)
معلومات مهمة:
لا يسمح السجل النرويجي بالبحث عن الشركات المحذوفة بالأسماء. لذلك، لا يمكننا توفير {بحث بسيط} بالأسماء ضمن الشركات المحذوفة في النرويج.
Field's length:
company_name varchar(512)
company_code varchar(64)

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

الوظيفة SimpleSearch

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

الوظيفة SimpleSearch

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

يتكون الترتيب من التسجيل إلى استلام التقرير من الخطوات التالية:

  1. يقوم المستخدم بتسجيل طلب جديد (وظيفة "طلب"). يعرض النظام تفاصيل الطلب وقائمة الطلبات المكررة التي تم تقديمها خلال آخر 60 يومًا وينتظر تأكيد الطلب.
  2. يؤكد المستخدم الطلب (وظيفة "OrderConfirmation"). يرسل النظام الطلب للإنتاج ويعرض حالة الإنتاج الحالية.
  3. يقوم المستخدم بالتحقق من حالة الطلب (وظيفة "ChkStatus").
  4. إذا كان الطلب جاهزًا، فيمكن للمستخدم تنزيل التقرير (وظيفة "GetReport").
قائمة البلدان المتاحة: جمهورية فنلندا (FIN), مملكة السويد (SWE)
Field's length:
business_name varchar(512)
reg_code varchar(64)
vat_code varchar(64)
address varchar(512)
phone varchar(256)
email varchar(256)
additional_info varchar(512)
ref_code varchar(64)

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

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

يمكن للمستخدمين الذين يعتبرون خطوة تأكيد الطلب غير ضرورية استخدام العنصر "confirm_order" وتمرير القيمة "TRUE".

عادةً ما يستغرق إعداد تقرير الائتمان في الوضع عبر الإنترنت من 10 إلى 20 ثانية.
لذلك، بالنسبة للتقارير عبر الإنترنت، يجب إجراء عمليات التحقق كل 5 ثوانٍ أو أكثر.

قائمة الشركات المتاحة للحساب التجريبي:

01120389 FIN, 01163231 FIN, 01332146 FIN, 01795458 FIN, 02245466 FIN, 07640633 FIN, 08481566 FIN, 08607931 FIN, 09484603 FIN, 09488655 FIN, 16366779 FIN, 16433070 FIN, 16457849 FIN, 16564505 FIN, 19148611 FIN, 20453920 FIN, 20453947 FIN, 26513621 FIN, 27019879 FIN, 27240442 FIN, 27330384 FIN, 27748684 FIN, 28725388 FIN, 29048796 FIN, 5560117482 SWE, 5564294089 SWE, 5566436035 SWE, 5569760464 SWE
بالإضافة إلى ذلك، بالنسبة للتقارير عبر الإنترنت (delivery_term = "o")، يمكنك استخدام العينات التي تم إنشاؤها لكل بلد (استخدم: رمز التسجيل "00000000"). هذه التقارير مجانية ويمكن طلبها باستخدام حساب تجريبي.
الوظيفة Order
الوظيفة OrderCancellation

الخطوة 2. تأكيد الطلب

الوظيفة OrderConfirmation

الخطوة 3. التحقق من الحالة

الوظيفة ChkStatus

الخطوة 4. الحصول على التقرير

قائمة اللغات المتاحة للتقارير عبر الإنترنت: en (English), et (Estonian), ru (Russian), de (German)
تنزيل التقرير عبر الإنترنت بصيغة pdf غير متاح حتى الآن.
الوظيفة GetReport

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

  • قيد التنفيذ - تقرير في مرحلة الإنتاج
  • Canceled - طلبية ملغاة
  • Finished - التقرير جاهز
  • Updated - تمت إضافة معلومات إلى التقرير النهائي
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - حدث خطأ فني في نظامنا. هذا يعني أننا على علم بهذا الخطأ وسنقوم بإصلاحه في أسرع وقت ممكن. سيتم إخطارك عندما تصبح قادرًا على استلام الطلب.

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

كيفية تنزيل التقرير دون اتصال بالإنترنت؟

يمكنك تنزيل التقارير غير المتصلة بالإنترنت مباشرة. فيما يلي إرشادات حول كيفية القيام بذلك:

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

  1. الجزء الثابت https://www.infoproff.com/en/orders/files/
  2. التجزئة الفريدة الخاصة بك، والتي نقدمها لك رداً على ذلك
  3. والجزء الثابت في النهاية /download

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

الوظيفة CreditOpinionCalculator

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

الوظيفة GetClassifiersFinancialStatements
الوظيفة GetActivityClassificators
الوظيفة GetDictionaryStandardPhrases
الوظيفة GetAvailableProducts

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

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

جميع الوظائف
  • اسم المستخدم/كلمة المرور غير صحيحين أو ليس لديك أذونات.
    أنت تدخل بيانات اعتماد خاطئة أو أن وصولك إلى واجهة برمجة التطبيقات (API) محظور.
الوظيفة SimpleSearch
  1. ليس لديك أذونات للبحث في هذا البلد.
    قائمة البلدان المتاحة: جمهورية فنلندا (FIN), مملكة السويد (SWE)
الوظيفة Order
  1. هذا المنتج غير متوفر.
    لا يمكن العثور على هذا المنتج ولا يمكن طلبه.
  2. لا يمكنك طلب تقرير عن شركة ذات شكل قانوني: "legal_form"
    هذا الخطأ ينطبق فقط على: مملكة السويد (SWE)
    في السويد، لا يمكن طلب تقرير عبر الإنترنت (delivery_term = "o") باستخدام النماذج القانونية التالية:
    • enskild näringsidkare
    • kommanditbolag
    • handelsbolag
  3. هذه الشركة غير مدرجة في قائمة الاختبار.
    رمز تسجيل الشركة غير موجود في قائمة الاختبار لدينا.
    قائمة الشركات المتاحة للحساب التجريبي:
    01120389 FIN, 01163231 FIN, 01332146 FIN, 01795458 FIN, 02245466 FIN, 07640633 FIN, 08481566 FIN, 08607931 FIN, 09484603 FIN, 09488655 FIN, 16366779 FIN, 16433070 FIN, 16457849 FIN, 16564505 FIN, 19148611 FIN, 20453920 FIN, 20453947 FIN, 26513621 FIN, 27019879 FIN, 27240442 FIN, 27330384 FIN, 27748684 FIN, 28725388 FIN, 29048796 FIN, 5560117482 SWE, 5564294089 SWE, 5566436035 SWE, 5569760464 SWE
  4. اسم الشركة أو رمز التسجيل مطلوب
    عند طلب تقرير غير متصل بالإنترنت (delivery_term = "n" أو "f" أو "s")، يلزم إدخال "اسم الشركة" أو "رمز التسجيل".
  5. يُطلب رمز التسجيل عندما تكون شروط التسليم عبر الإنترنت
    عند طلب تقرير عبر الإنترنت (delivery_term = "o") ، يلزم إدخال "رمز التسجيل".
الوظيفة GetReport
  1. هذه اللغة غير مدعومة.
    قائمة اللغات المتاحة للتقارير عبر الإنترنت: en (English), et (Estonian), ru (Russian), de (German)
الوظائف GetReport ChkStatus
  1. رقم الطلب غير صحيح.
    لا يمكن العثور على معرف الطلب. يمكنك الحصول على معرف الطلب عند استخدام وظيفة Order.
الوظيفة OrderCancellation
  1. Your order is already canceled.
    لم يعد لديك الإذن لإلغاء الطلب.
الوظيفة OrderConfirmation
  1. لم يعد لديك الإذن لتأكيد الطلب. يمكن إجراء التأكيد في غضون ساعة واحدة بعد استلامك لـ "order_id".

التغييرات في SOAP (الإصدار 3) مقارنةً بـ SOAP (الإصدار 2)

التغييرات في SOAP (الإصدار 3) مقارنةً بـ SOAP (الإصدار 2) [نظرة عامة]

1) وظيفة جديدة: ChkFinance

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

2) الوظيفة: SimpleSearch

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

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

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

3) الوظيفة: Order
Identification is required!

لإجراء طلب عبر الإنترنت، يجب أن تتلقى "search_result_id" من وظيفة "SimpleSearch"، وبعد ذلك فقط يمكنك إجراء طلب عبر الإنترنت (delivery_term = 'o').

- تغييرات في قائمة البلدان المتاحة للحصول على تقارير الائتمان عبر الإنترنت: Finland (FIN), Sweden (SWE), Belgium (BEL), Netherlands (NLD), Estonia (EST)

- تتوفر البيانات المالية للتنزيل (باستخدام المنتج: الشؤون المالية) في الوضع عبر الإنترنت: Estonia (EST), Sweden (SWE)

3) الوظيفة: GetReport

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


التغييرات في SOAP (الإصدار 3) مقارنةً بـ SOAP (الإصدار 2) [WSDL and XSD]

File: report.xsd

عناصر جديدة:

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

وظيفة جديدة:

- ChkFinance

Function that allows you to search for available financial statements.

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

1) OrderReportRequest has a choice:

- order_details:

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

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

- order_details_by_id:

Using 'search_result_id'

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

2) order_details

عنصر جديد:

- preferable_finances

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

3) SimpleSearchRequest

العنصر الذي تمت إزالته:

search_block.reg_code

عنصر جديد:

search_block->company_code

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

4) SimpleSearchResponse

العناصر التي تمت إزالتها

- code

عناصر جديدة:

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