인포프로프 API 문서 - v3

시작하기

웹 서비스 wsdl 및 스키마는 여기에 있습니다.:

http://wsdfn.infoproff.com/v3/

Web service functions:

SimpleSearch - 여러 국가의 회사 정보를 검색하세요.
ChkFinance - Search for available financial statements.
Order - order_id 를 생성하고 중복을 반환합니다. 다음 매개 변수에 의해 중복이 선택됩니다: country, product, reg_code.
OrderCancellation - 주문 요청을 보내고 order_id 을 받은 경우, 주문이 생산에 들어가지 않은 경우 해당 주문을 취소할 수 있습니다.
OrderConfirmation - order_id 을 받은 후 1시간 이내에 주문을 확인해야 합니다. 1시간 이내에 주문을 확인하지 않으면 주문이 자동으로 취소됩니다.
ChkStatus - 주문 상태를 확인합니다.
GetReport - 완성된 보고서를 받습니다.

GetClassifiersFinancialStatements - 행_번호, 행_포맷_설명, 행_랑_키, 행_순서 등 모든 요소가 포함된 모든 재무 문서를 가져옵니다.
GetLegalForms - 사용 가능한 모든 국가의 모든 법적 양식을 확인하세요.
GetActivityClassificators - 특정 활동 분류기에 대한 모든 코드와 설명을 확인하세요.
GetDictionaryStandardPhrases - 키와 언어가 포함된 모든 표준 문구를 확인하세요.
GetAvailableProducts - 사용 가능한 제품 목록을 확인하세요.

CreditOpinionCalculator - 신용 의견 계산기는 회사에 대한 신용 의견을 부여하는 데 도움이 됩니다.

API는 여러 가지 서비스를 제공합니다:

다음 국가의 온라인 신용 보고서: 핀란드 공화국 (FIN), 스웨덴 왕국 (SWE), 벨기에 왕국 (BEL), 네덜란드 왕국 (NLD), 에스토니아 공화국 (EST)
다음 국가에 대한 오프라인 보고서입니다: 모든 국가
신용 의견 계산기

회사를 검색하는 방법은 무엇인가요?

회사 검색은 두 가지 옵션으로 구성됩니다.:

회사명으로 검색,
Search by company code.

사용 가능한 국가 목록: Georgia (GEO), 그린란드 (GRL), 네덜란드 왕국 (NLD), 노르웨이 왕국 (NOR), 덴마크 왕국 (DNK), 독일 연방 공화국 (DEU), 몽골 (MNG), 벨기에 왕국 (BEL), 벨라루스 공화국 (BLR), 스웨덴 왕국 (SWE), 스위스 연방 (CHE), 스페인 왕국 (ESP), 아일랜드 (IRL), 아제르바이잔 공화국 (AZE), 에스토니아 공화국 (EST), 영국 및 북아일랜드 연합 왕국 (GBR), 오스트리아 공화국 (AUT), 우즈베키스탄 공화국 (UZB), 이탈리아 공화국 (ITA), 카자흐스탄 공화국 (KAZ), 키르기즈 공화국 (KGZ), 키프로스 공화국 (CYP), 포르투갈 공화국 (PRT), 폴란드 공화국 (POL), 프랑스 공화국 (FRA), 핀란드 공화국 (FIN)

중요 정보:

search_result_id can be acquired here for orders with delivery_term = "o".

It may take up to 20 seconds to respond to a search request in the following countries: United Kingdom, Ireland, France, Spain, Portugal, Germany, Italy, Austria, Switzerland.

노르웨이 등기부등본에서는 삭제된 회사를 이름으로 검색할 수 없습니다. 따라서 노르웨이에서 삭제된 회사 내 이름으로는 SimpleSearch 을 제공할 수 없습니다.

Field's length:
company_name varchar(512)
company_code varchar(64)

아래에서 예시를 확인할 수 있습니다.:

옵션 1: 회사명으로 검색

기능 SimpleSearch

옵션 2: 등록 코드로 검색

기능 SimpleSearch

신용 보고서는 어떻게 주문하나요?

List of available countries for online credit reports: 네덜란드 왕국 (NLD), 벨기에 왕국 (BEL), 스웨덴 왕국 (SWE), 에스토니아 공화국 (EST), 카자흐스탄 공화국 (KAZ), 키르기즈 공화국 (KGZ), 핀란드 공화국 (FIN)

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)

Below you can find the example of how to order and download reports:

Online/Offline Order Example (with search_result_id)
Offline Order Example (without search_result_id)

STEP 1: Find a company (Online/Offline Order (with search_result_id))

기능 SimpleSearch

To order an Online/Offline with identification report you need to receive "<search_result_id>".
To do so, please follow the link: 회사를 검색하는 방법은 무엇인가요?

The search allows you to accurately identify the company you wish to place an order for. For example, in some countries, there may be several companies with one registration number, or the same official name may belong to several companies.

STEP 2: Order a report (Online/Offline Order (with search_result_id))

기능 Order

If you won't use the element confirm_order, then you will receive <last_duplicates> in the XML response, so that you can decide if you really need to place an order.

STEP 3: Order cancellation (Optional) (Online/Offline Order (with search_result_id))

기능 OrderCancellation

If you wish to cancel the order, you can use this OrderCancellation function. If the order is already in progress, then you won't be able to cancel it.

STEP 4: Order confirmation (Online/Offline Order (with search_result_id))

기능 OrderConfirmation

If you didn't use the element "confirm_order", then you need to confirm your order.

STEP 5: Check order status (Online/Offline Order (with search_result_id))

기능 ChkStatus

- For offline orders checking order status once every 30 minutes is acceptable frequency.
- For online orders checking order status once every 5 seconds is acceptable frequency.

보고서에 사용되는 상태는 다음과 같습니다.:

진행 중 - 제작 단계에서의 보고
Canceled - 취소된 주문
Finished - 보고서가 준비되었습니다.
Updated - 완성된 보고서에 정보가 추가되었습니다.
Technical Error - 시스템에서 기술적 오류가 발생했습니다. 이 오류에 대해 알려드리며 최대한 빨리 수정하겠습니다. 주문을 수령할 수 있는 시점에 대해 알려드리겠습니다.

실행 상태가 Finished 또는 Updated 인 경우 주문을 받을 수 있습니다.

STEP 6: Get report (Online/Offline Order (with search_result_id))

기능 GetReport

사용 가능한 언어 목록: bg (불가리아어), cs (체코어), da (덴마크어), de (독일어), el (Greek), en (영어), es (스페인어), et (에스토니아어), fi (핀란드어), fr (프랑스어), hu (헝가리어), id (인도네시아어), it (이탈리아어), ja (일본어), ko (한국어), lt (리투아니아어), lv (라트비아어), nb (노르웨이 복말), nl (네덜란드어), pl (폴란드어), pt (포르투갈어), ro (루마니아어), ru (러시아어), sk (슬로바키아어), sl (슬로베니아어), sv (스웨덴어), tr (터키어), uk (Ukrainian), zh (중국어)

STEP 1: Order a report (Offline Order (without search_result_id))

기능 Order

If you won't use the element confirm_order, then you will receive <last_duplicates> in the XML response, so that you can decide if you really need to place an order.

STEP 2: Order cancellation (Optional) (Offline Order (without search_result_id))

기능 OrderCancellation

If you wish to cancel the order, you can use OrderCancellation function. If the order is already in progress, then you won't be able to cancel it.

STEP 3: Order confirmation (Offline Order (without search_result_id))

기능 OrderConfirmation

If you didn't use the element "confirm_order", then you need to confirm your order.

STEP 4: Status Checking (Offline Order (without search_result_id))

기능 ChkStatus

For offline orders checking order status once every 30 minutes is acceptable frequency.

보고서에 사용되는 상태는 다음과 같습니다.:

진행 중 - 제작 단계에서의 보고
Canceled - 취소된 주문
Finished - 보고서가 준비되었습니다.
Updated - 완성된 보고서에 정보가 추가되었습니다.
Technical Error - 시스템에서 기술적 오류가 발생했습니다. 이 오류에 대해 알려드리며 최대한 빨리 수정하겠습니다. 주문을 수령할 수 있는 시점에 대해 알려드리겠습니다.

실행 상태가 Finished 또는 Updated 인 경우 주문을 받을 수 있습니다.

STEP 5: Get report (Offline Order (without search_result_id))

기능 GetReport

온라인 재무 제표는 어떻게 주문하나요?

STEP 1: Find a company

기능 SimpleSearch

To order an online financial statements, you need to receive "<search_result_id>".
To do so, please follow the link: 회사를 검색하는 방법은 무엇인가요?

STEP 2: 사용 가능한 재무제표 검색

기능 ChkFinance

이 기능은 제품을 주문할 때만 필요합니다: finances (Financial statements) 와 delivery_term = 'o'.

사용 가능한 국가 목록: 에스토니아 공화국 (EST), 스웨덴 왕국 (SWE)

STEP 3: 재무 제표 주문

기능 Order

If you won't use the element confirm_order, then you will receive <last_duplicates> in the XML response, so that you can decide if you really need to place an order.

STEP 4: Order cancellation (Optional)

기능 OrderCancellation

If you wish to cancel the order, you can use this OrderCancellation function. If the order is already in progress, then you won't be able to cancel it.

To see the examples of xml request/response, please follow the link: How to cancel the order?

STEP 5: Order confirmation

기능 OrderConfirmation

If you didn't use the element "confirm_order", then you need to confirm your order.

To see the examples of xml request/response, please follow the link: How to confirm the order?

STEP 6: Check order status

기능 ChkStatus

- For online orders checking order status once every 5 seconds is acceptable frequency.

보고서에 사용되는 상태는 다음과 같습니다.:

진행 중 - 제작 단계에서의 보고
Canceled - 취소된 주문
Finished - 보고서가 준비되었습니다.
Updated - 완성된 보고서에 정보가 추가되었습니다.
Technical Error - 시스템에서 기술적 오류가 발생했습니다. 이 오류에 대해 알려드리며 최대한 빨리 수정하겠습니다. 주문을 수령할 수 있는 시점에 대해 알려드리겠습니다.

If the execution status is Finished or Updated, then you can get an order.

To see the examples of xml request/response, please follow the link: How to check order status?

STEP 7: Get report

기능 GetReport

To see the examples of xml request/response, please follow the link: How to get finished order?

표준 보고서(XML 이외의 형식)는 어떻게 다운로드하나요?

Types of standard product: 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.

요청은 세 부분으로 구성됩니다:

수정된 부분 https://www.infoproff.com/en/orders/files/
당사가 응답으로 제공하는 귀하의 고유 해시
And fixed part at the end /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, bg, cs, da, de, el, fi, fr, hu, id, it, ja, ko, lt, nl, nb, pl, pt, ro, sk, sl, es, sv, tr, uk, 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

비표준 제품은 어떻게 다운로드하나요?

Types of non-standard product: 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.

요청은 세 부분으로 구성됩니다:

Fixed part https://www.infoproff.com/en/orders/files/
당사가 응답으로 제공하는 귀하의 고유 해시
그리고 마지막에 고정된 부분 /download

신용 평가는 어떻게 받나요?

기능 CreditOpinionCalculator

추가 정보는 어떻게 얻나요?

기능 GetClassifiersFinancialStatements

기능 GetLegalForms

기능 GetActivityClassificators

기능 GetDictionaryStandardPhrases

기능 GetAvailableProducts

가능한 오류

이러한 오류는 웹 서비스를 요청하는 동안 발생할 수 있습니다..

모든 기능

Incorrect username/password or you have no permissions.

잘못된 자격 증명을 입력했거나 API 액세스가 차단되었습니다.

기능 SimpleSearch

You don't have permissions to search in this country.

사용 가능한 국가 목록: Georgia (GEO), 그린란드 (GRL), 네덜란드 왕국 (NLD), 노르웨이 왕국 (NOR), 덴마크 왕국 (DNK), 독일 연방 공화국 (DEU), 몽골 (MNG), 벨기에 왕국 (BEL), 벨라루스 공화국 (BLR), 스웨덴 왕국 (SWE), 스위스 연방 (CHE), 스페인 왕국 (ESP), 아일랜드 (IRL), 아제르바이잔 공화국 (AZE), 에스토니아 공화국 (EST), 영국 및 북아일랜드 연합 왕국 (GBR), 오스트리아 공화국 (AUT), 우즈베키스탄 공화국 (UZB), 이탈리아 공화국 (ITA), 카자흐스탄 공화국 (KAZ), 키르기즈 공화국 (KGZ), 키프로스 공화국 (CYP), 포르투갈 공화국 (PRT), 폴란드 공화국 (POL), 프랑스 공화국 (FRA), 핀란드 공화국 (FIN)

기능 Order

This product is not available.

해당 제품을 찾을 수 없으며 주문할 수 없습니다.
You can't order report on company with legal form: "legal_form"
이 오류는 다음에만 적용됩니다.: 스웨덴 왕국 (SWE)
스웨덴에서는 다음 법적 양식으로 온라인 보고서(배송 기간 = "O")를 주문할 수 없습니다:
- enskild näringsidkare
- kommanditbolag
- handelsbolag
When delivery term is Online, please use order_details_by_id with search_result_id.

This error only appears if you are trying to order online report without search_result_id.
It is important yo use order_details_by_id in OrderReportRequest
Business Name or Reg Code is required

오프라인 보고서 주문 시(배송 기간 = "n", "f" 또는 "s") "사업자명" 또는 "등록 코드"가 필요합니다.
Reg Code is required when delivery term is Online

온라인 보고서 주문 시(배송 기간 = "O") "등록 코드"가 필요합니다.

기능 GetReport

This language is not supported.

온라인 보고서에 사용할 수 있는 언어 목록: bg (불가리아어), cs (체코어), da (덴마크어), de (독일어), el (Greek), en (영어), es (스페인어), et (에스토니아어), fi (핀란드어), fr (프랑스어), hu (헝가리어), id (인도네시아어), it (이탈리아어), ja (일본어), ko (한국어), lt (리투아니아어), lv (라트비아어), nb (노르웨이 복말), nl (네덜란드어), pl (폴란드어), pt (포르투갈어), ro (루마니아어), ru (러시아어), sk (슬로바키아어), sl (슬로베니아어), sv (스웨덴어), tr (터키어), uk (Ukrainian), zh (중국어)

기능 GetReport ChkStatus

Incorrect order_id.

주문 ID를 찾을 수 없습니다. Order 함수를 사용하면 주문 ID를 얻을 수 있습니다.

기능 OrderCancellation

Your order is already canceled.

더 이상 주문을 취소할 수 있는 권한이 없습니다.

기능 OrderConfirmation

You don't have permission to confirm the order anymore. Confirmation can be done within one hour after you recieved 'order_id'.

SOAP (Version 3) changes compared to SOAP (Version 2)

SOAP (Version 3) changes compared to SOAP (Version 2) [Overview]

1) New function: ChkFinance

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

2) Function: SimpleSearch

- Changes in list of available countries: Georgia (GEO), 그린란드 (GRL), 네덜란드 왕국 (NLD), 노르웨이 왕국 (NOR), 덴마크 왕국 (DNK), 독일 연방 공화국 (DEU), 몽골 (MNG), 벨기에 왕국 (BEL), 벨라루스 공화국 (BLR), 스웨덴 왕국 (SWE), 스위스 연방 (CHE), 스페인 왕국 (ESP), 아일랜드 (IRL), 아제르바이잔 공화국 (AZE), 에스토니아 공화국 (EST), 영국 및 북아일랜드 연합 왕국 (GBR), 오스트리아 공화국 (AUT), 우즈베키스탄 공화국 (UZB), 이탈리아 공화국 (ITA), 카자흐스탄 공화국 (KAZ), 키르기즈 공화국 (KGZ), 키프로스 공화국 (CYP), 포르투갈 공화국 (PRT), 폴란드 공화국 (POL), 프랑스 공화국 (FRA), 핀란드 공화국 (FIN)

- 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) Function: Order

Identification is required!

To place an online order, you need to recieve 'search_result_id' from function 'SimpleSearch', and only after that you can place an online (delivery_term = 'o') order.

- Changes in list of available countries for online credit reports: 네덜란드 왕국 (NLD), 벨기에 왕국 (BEL), 스웨덴 왕국 (SWE), 에스토니아 공화국 (EST), 카자흐스탄 공화국 (KAZ), 키르기즈 공화국 (KGZ), 핀란드 공화국 (FIN)

- Available to download financial statements (using product: finances) in online mode: Estonia (EST), Sweden (SWE)

3) Function: GetReport

- Changes in of available languages: bg (불가리아어), cs (체코어), da (덴마크어), de (독일어), el (Greek), en (영어), es (스페인어), et (에스토니아어), fi (핀란드어), fr (프랑스어), hu (헝가리어), id (인도네시아어), it (이탈리아어), ja (일본어), ko (한국어), lt (리투아니아어), lv (라트비아어), nb (노르웨이 복말), nl (네덜란드어), pl (폴란드어), pt (포르투갈어), ro (루마니아어), ru (러시아어), sk (슬로바키아어), sl (슬로베니아어), sv (스웨덴어), tr (터키어), uk (Ukrainian), zh (중국어)

SOAP (Version 3) changes compared to SOAP (Version 2) [WSDL and XSD]

File: report.xsd

New elements:

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

New function:

- 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

New element:

- preferable_finances

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

3) SimpleSearchRequest

Removed element:

search_block.reg_code

New element:

search_block->company_code

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

4) SimpleSearchResponse

Removed elements

- code

New elements:

- search_result_id (is required for order with delivery_term = 'o')

- name_transliteration

- reg_code

- vat_code

- unified_legal_form