Ինֆոպրոֆֆ 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 ստանալուց հետո դուք պետք է մեկ ժամվա ընթացքում հաստատեք ձեր պատվերը։ Եթե մեկ ժամվա ընթացքում չհաստատեք, պատվերը ավտոմատ կերպով կչեղարկվի։
  • ChkStatus - Ստուգեք պատվերի կարգավիճակը։
  • GetReport - Ստացեք ավարտված զեկույցները։
  • GetClassifiersFinancialStatements - Ստացեք բոլոր ֆինանսական փաստաթղթերը՝ բոլոր տարրերով՝ row_number, row_formated_description, row_lang_key և row_order։
  • GetLegalForms - Ստացեք բոլոր իրավական ձևերը բոլոր մատչելի երկրների համար։
  • GetActivityClassificators - Ստացեք բոլոր կոդերն ու նկարագրությունները կոնկրետ գործունեության դասակարգչի համար։
  • GetDictionaryStandardPhrases - Ստացեք բոլոր ստանդարտ արտահայտությունները բանալիներով և լեզվով։
  • GetAvailableProducts - Ստացեք մատչելի ապրանքների ցանկը։
  • CreditOpinionCalculator - Քրեդիտային կարծիքի հաշվիչը օգնում է ընկերության համար վարկային կարծիք սահմանել։

API-ն տրամադրում է մի քանի ծառայություններ:

  1. Առցանց վարկային զեկույցներ հետևյալ երկրների համար: Ադրբեջան (AZE), Ավստրիա (AUT), Բելգիա (BEL), Բուլղարիա (BGR), Գերմանիա (DEU), Դանիա (DNK), Էստոնիա (EST), Իռլանդիա (IRL), Իսպանիա (ESP), Իտալիա (ITA), Լատվիա (LVA), Լեհաստան (POL), Լյուքսեմբուրգ (LUX), Խորվաթիա (HRV), Հունաստան (GRC), Հունգարիա (HUN), Ղազախստան (KAZ), Ղրղզստան (KGZ), Մալթա (MLT), Միացյալ Թագավորություն (GBR), Մոլդովա (MDA), Մոնղոլիա (MNG), Նիդերլանդներ (NLD), Նորվեգիա (NOR), Շվեդիա (SWE), Շվեյցարիա (CHE), Չեխիա (CZE), Չինաստան (CHN), Պորտուգալիա (PRT), Ռուսաստան (RUS), Սլովակիա (SVK), Սլովենիա (SVN), Ֆինլանդիա (FIN), Ֆրանսիա (FRA)
  2. Անլայն զեկույցներ հետևյալ երկրների համար: Բոլոր երկրները
  3. Վարկային կարծիքի հաշվիչ
  4. Company search

Ինչպե՞ս որոնել ընկերություն։

Ընկերության որոնումը բաղկացած է 2 տարբերակից:

  1. Ընկերության անվամբ որոնել,
  2. Գրանցման կոդով որոնել.
Մատչելի երկրների ցանկ: Ֆինլանդիա (FIN), Շվեդիա (SWE), Նորվեգիա (NOR), Դանիա (DNK)
Կարևոր տեղեկատվություն:
Նորվեգիայի ռեգիստրը չի թույլատրում անվանումներով փնտրել ջնջված ընկերությունները։ Ուստի մենք չենք կարող Նորվեգիայում ջնջված ընկերությունների համար անվանումներով SimpleSearch տրամադրել։
Field's length:
company_name varchar(512)
company_code varchar(64)

Ստորև կարող եք գտնել օրինակը։:

Ֆունկցիա SimpleSearch

Ընտրանք 2. Փնտրել գրանցման կոդով

Ֆունկցիա SimpleSearch

Ինչպե՞ս պատվիրել վարկային հաշվետվություն?

Գրանցումից մինչև զեկույցի ստացումը ընթացող գործընթացը բաղկացած է հետևյալ քայլերից:

  1. Օգտվողը գրանցում է նոր պատվեր (ֆունկցիա «Պատվեր»): Համակարգը վերադարձնում է պատվերի մանրամասները, վերջին 60 օրերի ընթացքում կատարված կրկնօրինակ պատվերների ցանկը և սպասում է պատվերի հաստատմանը:
  2. Օգտվողը հաստատում է պատվերը (ֆունկցիա «OrderConfirmation»): Համակարգը ուղարկում է պատվերը արտադրության և վերադարձնում է ընթացիկ արտադրական կարգավիճակը:
  3. Օգտվողը ստուգում է պատվերի կարգավիճակը (ֆունկցիա "ChkStatus")։
  4. Եթե պատվերը պատրաստ է, օգտվողը կարող է ներբեռնել զեկույցը (ֆունկցիա «GetReport»):
Մատչելի երկրների ցանկ: Ֆինլանդիա (FIN), Շվեդիա (SWE)
Field's length:
business_name varchar(512)
reg_code varchar(64)
vat_code varchar(64)
address varchar(512)
phone varchar(256)
email varchar(256)
additional_info varchar(512)
ref_code varchar(64)

Ստորև կարող եք գտնել օրինակը։:

Քայլ 1: Պատվիրել զեկույց

Օգտատերերը, ովքեր համարում են պատվերի հաստատման քայլը անպետք, կարող են օգտագործել "confirm_order" տարրը և փոխանցել "TRUE" արժեքը։

Սովորաբար առցանց ռեժիմում վարկային զեկույցը պատրաստելու համար պահանջվում է 10–20 վայրկյան։
Ուստի առցանց զեկույցների համար պետք է ստուգումներ կատարել յուրաքանչյուր 5 կամ ավելի վայրկյանում։

Թեստային հաշվի համար հասանելի ընկերությունների ցուցակ:

01120389 FIN, 01163231 FIN, 01332146 FIN, 01795458 FIN, 02245466 FIN, 07640633 FIN, 08481566 FIN, 08607931 FIN, 09484603 FIN, 09488655 FIN, 16366779 FIN, 16433070 FIN, 16457849 FIN, 16564505 FIN, 19148611 FIN, 20453920 FIN, 20453947 FIN, 26513621 FIN, 27019879 FIN, 27240442 FIN, 27330384 FIN, 27748684 FIN, 28725388 FIN, 29048796 FIN, 5560117482 SWE, 5564294089 SWE, 5566436035 SWE, 5569760464 SWE
Բացի այդ, առցանց զեկույցների (delivery_term = "o") համար կարող եք օգտագործել յուրաքանչյուր երկրի համար գեներացված նմուշները (գրանցման կոդ՝ «00000000»): Այս զեկույցները անվճար են և կարող են պատվիրվել թեստային հաշվով:
Ֆունկցիա Order
Ֆունկցիա OrderCancellation

Քայլ 2. Պատվերի հաստատում

Ֆունկցիա OrderConfirmation

Քայլ 3. Վիճակի ստուգում

Ֆունկցիա ChkStatus

Քայլ 4. Ստանալ զեկույցը

Առցանց զեկույցների համար հասանելի լեզուների ցանկ: en (English), et (Estonian), ru (Russian), de (German)
PDF ֆորմատով առցանց զեկույցը ներբեռնելը դեռևս հասանելի չէ։
Ֆունկցիա GetReport

Հաշվետվությունների համար օգտագործվում են հետևյալ կարգավիճակները։:

  • ընթացքի մեջ - Արտադրության փուլում հաշվետվություն
  • Canceled - Չեղարկված պատվեր
  • Finished - Հաշվետվությունը պատրաստ է
  • Updated - Տեղեկատվություն ավելացվեց ավարտված զեկույցին։
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Մեր համակարգում տեխնիկական սխալ է տեղի ունեցել։ Սա նշանակում է, որ մենք տեղեկացված ենք այս սխալի մասին և հնարավորինս շուտ կվերացնենք այն։ Ձեզ կտեղեկացնեն, երբ կարողանաք ստանալ պատվերը։

Եթե կատարման կարգավիճակը Finished կամ Updated է, ապա կարող եք ստանալ պատվեր։

Ինչպե՞ս ներբեռնել օֆլայն զեկույցը?

Դուք կարող եք անմիջապես ներբեռնել օֆլայն զեկույցները։ Ահա հրահանգը, թե ինչպես պետք է դա անել։

Հարցումը բաղկացած է երեք մասից:

  1. Փոխվել է մասը՝ https://www.infoproff.com/en/orders/files/
  2. Ձեր յուրահատուկ հեշը, որը մենք տրամադրում ենք որպես պատասխան
  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. Reg Code-ը պահանջվում է, երբ առաքման ձևը առցանց է։
    Օնլայն զեկույց պատվիրելիս (delivery_term="o") պահանջվում է «Reg Code»-ը։
Ֆունկցիա GetReport
  1. Այս լեզուն չի աջակցվում։
    Առցանց զեկույցների համար հասանելի լեզուների ցանկ: en (English), et (Estonian), ru (Russian), de (German)
Ֆունկցիաներ GetReport ChkStatus
  1. Սխալ order_id։
    Պատվերի ID-ն չի գտնվել։ Պատվերի 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)

- Ֆինանսական հաշվետվությունները (Օգտագործելով «Ֆինանսներ» արտադրանքը) առցանց ռեժիմում ներբեռնելու համար հասանելի են։: 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