인포프로프 API 문서 - 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 - 행_번호, 행_포맷_설명, 행_랑_키, 행_순서 등 모든 요소가 포함된 모든 재무 문서를 가져옵니다.
GetLegalForms - 사용 가능한 모든 국가의 모든 법적 양식을 확인하세요.
GetActivityClassificators - 특정 활동 분류기에 대한 모든 코드와 설명을 확인하세요.
GetDictionaryStandardPhrases - 키와 언어가 포함된 모든 표준 문구를 확인하세요.
GetAvailableProducts - 사용 가능한 제품 목록을 확인하세요.
CreditOpinionCalculator - 신용 의견 계산기는 회사에 대한 신용 의견을 부여하는 데 도움이 됩니다.

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

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

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

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

회사명으로 검색,
등록 코드로 검색.

사용 가능한 국가 목록: 핀란드 공화국 (FIN), 스웨덴 왕국 (SWE), 노르웨이 왕국 (NOR), 덴마크 왕국 (DNK)

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

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

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

옵션 1: 회사명으로 검색

기능 SimpleSearch

옵션 2: 등록 코드로 검색

기능 SimpleSearch

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

등록부터 보고서 접수까지의 순서는 다음 단계로 구성됩니다.:

사용자가 새 주문을 등록합니다("주문" 기능). 시스템은 주문 세부 정보와 지난 60일 동안 접수된 중복 주문 목록을 반환하고 주문 확인을 기다립니다.
사용자가 주문을 확인합니다('주문 확인' 함수). 시스템이 생산 주문을 전송하고 현재 생산 상태를 반환합니다.
사용자가 주문 상태를 확인합니다("ChkStatus" 함수).
주문이 준비되면 사용자는 보고서를 다운로드할 수 있습니다("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" 사용). 이 보고서는 무료이며 테스트 계정을 사용하여 주문할 수 있습니다.

기능 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 인 경우 주문을 받을 수 있습니다.

오프라인 보고서는 어떻게 다운로드하나요?

오프라인 보고서를 직접 다운로드할 수 있습니다. 방법은 다음과 같습니다:

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

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

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

기능 CreditOpinionCalculator

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

기능 GetClassifiersFinancialStatements

기능 GetLegalForms

기능 GetActivityClassificators

기능 GetDictionaryStandardPhrases

기능 GetAvailableProducts

가능한 오류

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

모든 기능

사용자 이름/비밀번호가 잘못되었거나 권한이 없습니다.

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

기능 SimpleSearch

이 국가에서는 검색할 수 있는 권한이 없습니다.

사용 가능한 국가 목록: 핀란드 공화국 (FIN), 스웨덴 왕국 (SWE)

기능 Order

이 제품은 사용할 수 없습니다.

해당 제품을 찾을 수 없으며 주문할 수 없습니다.
법적 양식으로 회사에 대한 보고서를 주문할 수 없습니다: "legal_form"
이 오류는 다음에만 적용됩니다.: 스웨덴 왕국 (SWE)
스웨덴에서는 다음 법적 양식으로 온라인 보고서(배송 기간 = "O")를 주문할 수 없습니다:
- enskild näringsidkare
- kommanditbolag
- handelsbolag
이 회사는 테스트 목록에 없습니다.

회사 등록 코드가 테스트 목록에 없습니다.
테스트 계정으로 사용할 수 있는 회사 목록입니다:

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
사업자명 또는 등록번호 필수

오프라인 보고서 주문 시(배송 기간 = "n", "f" 또는 "s") "사업자명" 또는 "등록 코드"가 필요합니다.
배송 기간이 온라인인 경우 등록 코드가 필요합니다.

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

기능 GetReport

이 언어는 지원되지 않습니다.

온라인 보고서에 사용할 수 있는 언어 목록: en (English), et (Estonian), ru (Russian), de (German)

기능 GetReport ChkStatus

잘못된 order_id입니다.

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

기능 OrderCancellation

Your order is already canceled.

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

기능 OrderConfirmation

더 이상 주문을 확인할 수 있는 권한이 없습니다. 확인은 '주문_ID'를 받은 후 1시간 이내에 가능합니다.

SOAP(버전 2)와 비교한 SOAP(버전 3)의 변경 사항

SOAP(버전 2)와 비교한 SOAP(버전 3)의 변경 사항 [개요]

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'를 수신해야 하며, 그 후에만 온라인(배송 기간 = '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(버전 2)와 비교한 SOAP(버전 3)의 변경 사항 [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