Инфопрофф API құжаттамасы - v2

Нұсқаны ауыстыру V2

Бастау

Веб-қызметтің WSDL және схемалары мына жерде орналасқан:

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

Веб-қызметтің негізгі функциялары:

  • SimpleSearch - Әртүрлі елдердегі компаниялар туралы ақпаратты іздеңіз.
  • Order - order_id жасайды және қайталанатын жазбаларды қайтарады. Қайталанатын жазбалар келесі параметрлер арқылы таңдалады: country, product, delivery_term and reg_code.
  • OrderCancellation - Егер сіз тапсырыс сұранымын жіберіп, order_id нөмірін алсаңыз, бұл тапсырысты (егер ол өндіріске жіберілмеген болса) жою мүмкіндігіңіз бар.
  • OrderConfirmation - order_id алынғаннан кейін тапсырысыңызды 1 сағат ішінде растауыңыз қажет. Егер 1 сағат ішінде растамасаңыз, тапсырыс автоматты түрде жойылады.
  • ChkStatus - Тапсырыстың мәртебесін тексеру.
  • GetReport - Дайын есептерді алыңыз.
  • GetClassifiersFinancialStatements - Барлық financial documents элементтерін row_number, row_formated_description, row_lang_key және row_order мәндерімен алыңыз.
  • GetLegalForms - Барлық қолжетімді елдер үшін барлық заңды формаларды алыңыз.
  • GetActivityClassificators - Белгілі бір әрекет классификаторы үшін барлық кодтар мен сипаттамаларды алыңыз.
  • GetDictionaryStandardPhrases - Барлық стандартты тіркестерді кілттері мен тілімен алыңыз.
  • GetAvailableProducts - Қолжетімді өнімдер тізімін алыңыз.
  • CreditOpinionCalculator - Кредиттік пікір калькуляторы компанияға кредиттік пікір тағайындауға көмектеседі.

API бірнеше қызметтерді ұсынады:

  1. Төмендегі елдер үшін онлайн несиелік есептер: Австрия (AUT), Бельгия (BEL), Болгария (BGR), Венгрия (HUN), Германия (DEU), Грекия (GRC), Дания (DNK), Ирландия (IRL), Испания (ESP), Италия (ITA), Латвия (LVA), Люксембург (LUX), Мальта (MLT), Молдова (MDA), Моңғолия (MNG), Нидерланды (NLD), Норвегия (NOR), Польша (POL), Португалия (PRT), Ресей (RUS), Словакия (SVK), Словения (SVN), Финляндия (FIN), Франция (FRA), Хорватия (HRV), Чехия (CZE), Швейцария (CHE), Швеция (SWE), Эстония (EST), Қазақстан (KAZ), Қырғызстан (KGZ), Қытай (CHN), Ұлыбритания (GBR), Әзірбайжан (AZE)
  2. Төмендегі елдер үшін офлайн есептер: Барлық елдер
  3. Несиелік пікір есептегіші
  4. Company search

Компанияны қалай іздеуге болады?

Компанияны іздеу 2 нұсқадан тұрады:

  1. Компания атауы бойынша іздеу,
  2. Тіркеу коды бойынша іздеу.
Қолжетімді елдер тізімі: Финляндия (FIN), Швеция (SWE), Норвегия (NOR), Дания (DNK)
Маңызды ақпарат:
Норвегия тіркеуі жойылған компанияларды атаулары бойынша іздеуге мүмкіндік бермейді. Сондықтан біз Норвегиядағы жойылған компаниялар бойынша атаулар бойынша қарапайым іздеу ұсына алмаймыз.
Field's length:
company_name varchar(512)
company_code varchar(64)

Төменде мысалды таба аласыз.:

Функция SimpleSearch

2-нұсқа: тіркеу коды бойынша іздеу

Функция SimpleSearch

Кредиттік есепті қалай сұратуға болады?

Тіркеуден есепті алуға дейінгі тәртіп мына қадамдардан тұрады:

  1. Пайдаланушы жаңа тапсырыс тіркейді («Order» функциясы). Жүйе тапсырыс мәліметтерін, соңғы 60 күнде жасалған қайталанатын тапсырыстар тізімін қайтарады және тапсырысты растауды күтеді.
  2. Пайдаланушы тапсырысты растайды («OrderConfirmation» функциясы). Жүйе тапсырысты өндіріске жібереді және ағымдағы өндіріс мәртебесін қайтарады.
  3. Пайдаланушы тапсырыстың мәртебесін тексереді (функция "ChkStatus").
  4. Егер тапсырыс дайын болса, пайдаланушы есепті жүктеп ала алады (GetReport функциясы).
Қолжетімді елдер тізімі: Финляндия (FIN), Швеция (SWE)
Field's length:
business_name varchar(512)
reg_code varchar(64)
vat_code varchar(64)
address varchar(512)
phone varchar(256)
email varchar(256)
additional_info varchar(512)
ref_code varchar(64)

Төменде мысалды таба аласыз.:

1-қадам: Есепті тапсырыс беру

Тапсырысты растау қадамын қажетсіз деп есептейтін пайдаланушылар "confirm_order" элементін пайдаланып, "TRUE" мәнін жібере алады.

Әдетте онлайн режимде несиелік есепті дайындауға 10–20 секунд кетеді.
Сондықтан онлайн есептер үшін тексерулерді әр 5 секунд сайын немесе одан жиі орындауыңыз керек.

Тесттік есептік жазба үшін қолжетімді компаниялар тізімі:

01120389 FIN, 01163231 FIN, 01332146 FIN, 01795458 FIN, 02245466 FIN, 07640633 FIN, 08481566 FIN, 08607931 FIN, 09484603 FIN, 09488655 FIN, 16366779 FIN, 16433070 FIN, 16457849 FIN, 16564505 FIN, 19148611 FIN, 20453920 FIN, 20453947 FIN, 26513621 FIN, 27019879 FIN, 27240442 FIN, 27330384 FIN, 27748684 FIN, 28725388 FIN, 29048796 FIN, 5560117482 SWE, 5564294089 SWE, 5566436035 SWE, 5569760464 SWE
Сонымен қатар, (delivery_term = "o") онлайн есептері үшін әр елге арналған үлгілерді пайдалануға болады (тіркеу коды: "00000000"). Бұл есептер тегін және тестілік есептік жазба арқылы тапсырыс беруге болады.
Функция Order
Функция OrderCancellation

2-қадам. Тапсырысты растау

Функция OrderConfirmation

3-қадам. Мәртебесін тексеру

Функция ChkStatus

4-қадам. Есепті алу

Онлайн есептер үшін қолжетімді тілдер тізімі: en (English), et (Estonian), ru (Russian), de (German)
Онлайн есепті PDF форматында жүктеу әлі қолжетімді емес.
Функция GetReport

Есептер үшін келесі күйлер қолданылады:

  • Жүріп жатыр - Өндіріс кезеңіндегі есеп
  • Canceled - Бүкілген тапсырыс
  • Finished - Есеп дайын
  • Updated - Дайын есепке ақпарат қосылды.
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Жүйемізде техникалық ақау пайда болды. Бұл бізге ақау туралы хабарланғанын және оны мүмкіндігінше тез арада түзететінімізді білдіреді. Тапсырысты қашан ала алатыныңыз туралы сізге хабарланады.

Орындау мәртебесі Finished немесе Updated болса, тапсырысты ала аласыз.

Офлайн есепті қалай жүктеуге болады?

Сіз офлайн есептерді тікелей жүктей аласыз. Міне, оны қалай жасау керектігі жөніндегі нұсқаулық:

Өтінім 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") "Business Name" немесе "Reg Code" көрсету қажет.
  5. Жеткізу шарты онлайн болғанда Reg Code талап етіледі.
    Онлайн есепті тапсырыс берерде (delivery_term = "o") "Reg Code" талап етіледі.
Функция GetReport
  1. Бұл тіл қолдау көрсетілмейді.
    Онлайн есептер үшін қолжетімді тілдер тізімі: en (English), et (Estonian), ru (Russian), de (German)
Функциялар GetReport ChkStatus
  1. Дұрыс емес order_id.
    Тапсырыс идентификаторын табу мүмкін емес. 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!

Онлайн тапсырыс беру үшін 'SimpleSearch' функциясынан 'search_result_id' алу қажет, және тек содан кейін ғана онлайн (delivery_term = 'o') тапсырыс бере аласыз.

- Онлайн несиелік есептерге қолжетімді елдер тізіміндегі өзгерістер: Finland (FIN), Sweden (SWE), Belgium (BEL), Netherlands (NLD), Estonia (EST)

- Қаржылық есептілікті (өнім: finances) онлайн режимде жүктеп алуға болады.: 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