Инфопрофф АПИ документација - v2

Промени верзију V2

Почетак

Веб сервис всдл и шеме се налазе овде:

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 - Преузмите све финансијске документе са свим елементима: ров_нумбер, ров_форматед_десцриптион, ров_ланг_кеи и ров_ордер.
  • GetLegalForms - Преузмите све правне форме за све доступне земље.
  • GetActivityClassificators - Набавите све кодове и описе за специфичне класификаторе делатности.
  • GetDictionaryStandardPhrases - Преузмите све стандардне фразе са тастерима и језиком.
  • GetAvailableProducts - Добијте листу доступних производа.
  • CreditOpinionCalculator - Калкулатор кредитног мишљења помаже да се додели кредитно мишљење о компанији.

АПИ пружа неколико услуга:

  1. Онлине кредитни извештаји за следеће земље: Република Финска (FIN), Краљевина Шведска (SWE)
  2. Офлајн извештаји за следеће земље: Све земље
  3. Калкулатор кредитног мишљења

Како тражити компанију?

Претрага предузећа се састоји од 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. Корисник потврђује наруџбу (функција „Потврда поруџбине“). Систем шаље налог за производњу и враћа тренутни статус производње.
  3. Корисник проверава статус налога (функција "ЦхкСтатус").
  4. Ако је налог спреман, Корисник може преузети извештај (функција „ГетРепорт“).
Листа доступних земаља: Република Финска (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)
Преузимање онлајн извештаја у пдф формату још увек није доступно.
Функција GetReport

Следећи статуси се користе за извештаје:

  • У току - Извештај у фази производње
  • Canceled - Отказана поруџбина
  • Finished - Извештај је спреман
  • Updated - Информација је додата готовом извештају
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Дошло је до техничке грешке у нашем систему. То значи да смо обавештени о овој грешци и да ћемо је поправити што је пре могуће. Бићете обавештени када ћете моћи да примите поруџбину.

Ако је статус извршења Finished или Updated , онда можете да добијете налог.

Како преузети извештај ван мреже?

Можете директно преузети ванмрежне извештаје. Ево упутства како то треба да урадите:

Захтев се састоји из 3 дела:

  1. Фиксни део хттпс://ввв.инфопрофф.цом/ен/ордерс/филес/
  2. Ваш јединствени хеш, који пружамо као одговор
  3. И фиксни део на крају /download

Како добити кредитно мишљење?

Функција CreditOpinionCalculator

Како доћи до додатних информација?

Функција GetClassifiersFinancialStatements
Функција GetActivityClassificators
Функција GetDictionaryStandardPhrases
Функција GetAvailableProducts

Могуће грешке

До ових грешака може доћи приликом упућивања захтева нашој веб услузи.

Све функције
  • Нетачно корисничко име/лозинка или немате дозволе.
    Уносите погрешне акредитиве или је ваш приступ АПИ-ју блокиран.
Функција SimpleSearch
  1. Немате дозволе за претрагу у овој земљи.
    Листа доступних земаља: Република Финска (FIN), Краљевина Шведска (SWE)
Функција Order
  1. Овај производ није доступан.
    Такав производ се не може наћи и није могуће наручити.
  2. Не можете наручити извештај о компанији са правном формом: "легал_форм"
    Ова грешка се односи само на: Краљевина Шведска (SWE)
    У Шведској није могуће наручити онлајн извештај (деливери_терм = "о") са следећим правним формама:
    • 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. Потребан је назив предузећа или регистарски код
    Приликом наручивања офлајн извештаја (деливери_терм = "н", "ф" или "с") "Назив предузећа" или "Рег Цоде" је обавезан.
  5. Рег код је потребан када је рок испоруке онлајн
    Приликом наручивања онлајн извештаја (деливери_терм = "о") "Рег Цоде" је обавезан.
Функција GetReport
  1. Овај језик није подржан.
    Листа доступних језика за онлајн извештаје: en (English), et (Estonian), ru (Russian), de (German)
Функције GetReport ChkStatus
  1. Нетачан ордер_ид.
    ИД поруџбине није могуће пронаћи. Добијате ИД поруџбине када користите функцију Order.
Функција OrderCancellation
  1. Your order is already canceled.
    Више немате дозволу да откажете поруџбину.
Функција OrderConfirmation
  1. Више немате дозволу да потврдите поруџбину. Потврда се може извршити у року од једног сата након што примите 'ордер_ид'.

СОАП (верзија 3) се мења у поређењу са СОАП-ом (верзија 2)

СОАП (верзија 3) се мења у поређењу са СОАП-ом (верзија 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!

Да бисте направили онлајн поруџбину, потребно је да добијете 'сеарцх_ресулт_ид' из функције 'СимплеСеарцх', а тек након тога можете да пошаљете онлајн (деливери_терм = 'о') поруџбину.

- Промене у листи доступних земаља за онлајн кредитне извештаје: 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)


СОАП (верзија 3) се мења у поређењу са СОАП-ом (верзија 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