인포프로프 API 문서 - v4

버전 전환 V4

시작하기

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

https://wsdfn.infoproff.com/v4/

Postman Collection (API v4) — Ready for Use:

https://www.postman.com/infoproff/infoproff-webservices/documentation/9kweer5/soap-api-v4

Postman provides a convenient way to test our API without the need to write any code. It can also automatically generate example HTTP requests for most common programming languages.

The requests generated by Postman are basic HTTP calls compatible with our SOAP API. However, for production-grade integration, we recommend using fully featured SOAP clients available in most programming languages. These clients can work directly with WSDL and XSD, automatically handling schemas, data types, and message structures.

Using a dedicated SOAP client ensures a more reliable and robust integration, reducing the likelihood of errors when constructing and parsing SOAP messages.

Authentification details

The primary authentication method is HTTP Basic Auth. Using the Authorization header with encoded credentials is the preferred and recommended approach.

The username corresponds to the App ID, and the password is the associated Secret Key. These values are generated in the API Tokens section of the user dashboard and are not related to the credentials used for logging into the portal.

The authentication_block mechanism, used in previous API versions, is still supported for backward compatibility but is considered deprecated and should not be used in new integrations.

Web service functions:

  • SimpleSearch - 여러 국가의 회사 정보를 검색하세요.
  • ChkFinance - 사용 가능한 재무제표를 검색합니다.
  • Order - order_id 를 생성하고 중복을 반환합니다. 다음 매개 변수에 의해 중복이 선택됩니다: country, product, reg_code.
  • OrderCancellation - 주문 요청을 보내고 order_id 을 받은 경우, 주문이 생산에 들어가지 않은 경우 해당 주문을 취소할 수 있습니다.
  • OrderConfirmation - order_id 을 받은 후 1시간 이내에 주문을 확인해야 합니다. 1시간 이내에 주문을 확인하지 않으면 주문이 자동으로 취소됩니다.
  • ChkStatus - 주문 상태를 확인합니다.
  • GetReport - 완성된 보고서를 받습니다.
  • GetClassifiersFinancialStatements - 행_번호, 행_포맷_설명, 행_랑_키, 행_순서 등 모든 요소가 포함된 모든 재무 문서를 가져옵니다.
  • GetLegalForms - 사용 가능한 모든 국가의 모든 법적 양식을 확인하세요.
  • GetActivityClassificators - 특정 활동 분류기에 대한 모든 코드와 설명을 확인하세요.
  • GetDictionaryStandardPhrases - 키와 언어가 포함된 모든 표준 문구를 확인하세요.
  • GetAvailableProducts - 사용 가능한 제품 목록을 확인하세요.
  • CreditOpinionCalculator - 신용 의견 계산기는 회사에 대한 신용 의견을 부여하는 데 도움이 됩니다.

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

  1. 다음 국가의 온라인 신용 보고서: 핀란드 공화국 (FIN), 스웨덴 왕국 (SWE), 벨기에 왕국 (BEL), 네덜란드 왕국 (NLD), 에스토니아 공화국 (EST), 카자흐스탄 공화국 (KAZ), 폴란드 공화국 (POL), 키르기즈 공화국 (KGZ), 중화 인민 공화국 (CHN), 몽골 (MNG)
  2. 다음 국가에 대한 오프라인 보고서입니다: 모든 국가
  3. 신용 의견 계산기

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

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

  1. 회사명으로 검색,
  2. Search by company code.
사용 가능한 국가 목록: Georgia (GEO), 가이아나 협동조합 공화국 (GUY), 감비아 공화국 (GMB), 과들루프 (GLP), 그리스 공화국 (GRC), 그린란드 (GRL), 기니 공화국 (GIN), 나미비아 공화국 (NAM), 나이지리아 연방 공화국 (NGA), 남아프리카 공화국 (ZAF), 네덜란드 왕국 (NLD), 노르웨이 왕국 (NOR), 뉴질랜드 (NZL), 덴마크 왕국 (DNK), 독일 연방 공화국 (DEU), 라트비아 공화국 (LVA), 러시아 연방 (RUS), 루마니아 (ROU), 룩셈부르크 대공국 (LUX), 르완다 공화국 (RWA), 리투아니아 공화국 (LTU), 리히텐슈타인 공국 (LIE), 마다가스카르 공화국 (MDG), 마르티니크 (MTQ), 마요트 (MYT), 맨섬 (IMN), 모나코 공국 (MCO), 모로코 왕국 (MAR), 모리셔스 공화국 (MUS), 몰도바 공화국 (MDA), 몰디브 공화국 (MDV), 몰타 공화국 (MLT), 몽골 (MNG), 베냉 공화국 (BEN), 베네수엘라 볼리바르 공화국 (VEN), 벨기에 왕국 (BEL), 벨라루스 공화국 (BLR), 보스니아 헤르체고비나 (BIH), 보츠와나 공화국 (BWA), 볼리비아 다민족 국가 (BOL), 불가리아 공화국 (BGR), 브라질 연방 공화국 (BRA), 사모아 독립 국가 (WSM), 산마리노 공화국 (SMR), 세르비아 공화국 (SRB), 세이셸 공화국 (SYC), 세인트 마틴의 집단성 (MAF), 스리랑카 민주 사회주의 공화국 (LKA), 스웨덴 왕국 (SWE), 스위스 연방 (CHE), 스페인 왕국 (ESP), 슬로바키아 공화국 (SVK), 슬로베니아 공화국 (SVN), 싱가포르 공화국 (SGP), 아르헨티나 공화국 (ARG), 아이슬란드 공화국 (ISL), 아일랜드 (IRL), 아제르바이잔 공화국 (AZE), 알바니아 공화국 (ALB), 알제리 인민 민주 공화국 (DZA), 앙골라 공화국 (AGO), 에스토니아 공화국 (EST), 에콰도르 공화국 (ECU), 에티오피아 연방 민주 공화국 (ETH), 영국 및 북아일랜드 연합 왕국 (GBR), 오스트리아 공화국 (AUT), 우루과이 동부 공화국 (URY), 우즈베키스탄 공화국 (UZB), 이스라엘 국가 (ISR), 이탈리아 공화국 (ITA), 일본 (JPN), 잠비아 공화국 (ZMB), 재결합 (REU), 저지의 베일리윅 (JEY), 중국 공화국 (TWN), 중화 인민 공화국 (CHN), 짐바브웨 공화국 (ZWE), 체코 공화국 (CZE), 칠레 공화국 (CHL), 카자흐스탄 공화국 (KAZ), 캐나다 (CAN), 케냐 공화국 (KEN), 코소보 (XXK), 코트디부아르 (CIV), 콩고 공화국 (COG), 크로아티아 공화국 (HRV), 키르기즈 공화국 (KGZ), 키프로스 공화국 (CYP), 타지키스탄 공화국 (TJK), 탄자니아 연합 공화국 (TZA), 태국 왕국 (THA), 토고 공화국 (TGO), 파라과이 공화국 (PRY), 페루 공화국 (PER), 포르투갈 공화국 (PRT), 폴란드 공화국 (POL), 프랑스 공화국 (FRA), 프랑스령 기아나 (GUF), 핀란드 공화국 (FIN), 필리핀 공화국 (PHL), 헝가리 공화국 (HUN), 호주 연방 (AUS), 홍콩 (HKG)

The search for other countries is performed only in the database of archived reports. If you do not find the desired company, enter the company details manually.

중요 정보:

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

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)

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

기능 SimpleSearch

옵션 2: 등록 코드로 검색

기능 SimpleSearch

Option 3: Search by query (by name or code)

기능 UnifiedSearch

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

List of available countries for online credit reports: 그리스 공화국 (GRC), 네덜란드 왕국 (NLD), 노르웨이 왕국 (NOR), 덴마크 왕국 (DNK), 독일 연방 공화국 (DEU), 라트비아 공화국 (LVA), 러시아 연방 (RUS), 룩셈부르크 대공국 (LUX), 몰도바 공화국 (MDA), 몰타 공화국 (MLT), 몽골 (MNG), 벨기에 왕국 (BEL), 불가리아 공화국 (BGR), 스웨덴 왕국 (SWE), 스위스 연방 (CHE), 스페인 왕국 (ESP), 슬로바키아 공화국 (SVK), 슬로베니아 공화국 (SVN), 아일랜드 (IRL), 아제르바이잔 공화국 (AZE), 에스토니아 공화국 (EST), 영국 및 북아일랜드 연합 왕국 (GBR), 오스트리아 공화국 (AUT), 이탈리아 공화국 (ITA), 중화 인민 공화국 (CHN), 체코 공화국 (CZE), 카자흐스탄 공화국 (KAZ), 크로아티아 공화국 (HRV), 키르기즈 공화국 (KGZ), 포르투갈 공화국 (PRT), 폴란드 공화국 (POL), 프랑스 공화국 (FRA), 핀란드 공화국 (FIN), 헝가리 공화국 (HUN)
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:

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.

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

  • 진행 중 - 제작 단계에서의 보고
  • Identification pending - 보류 중인 보고서 준비 중입니다. 클라이언트의 추가 데이터가 필요합니다.
  • Canceled - 취소된 주문
  • Finished - 보고서가 준비되었습니다.
  • Updated - 완성된 보고서에 정보가 추가되었습니다.
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - 시스템에서 기술적 오류가 발생했습니다. 이 오류에 대해 알려드리며 최대한 빨리 수정하겠습니다. 주문을 수령할 수 있는 시점에 대해 알려드리겠습니다.

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

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

기능 GetReport
사용 가능한 언어 목록: ar (Arabic), bg (불가리아어), cs (체코어), da (덴마크어), de (독일어), el (Greek), en (영어), es (스페인어), et (에스토니아어), fi (핀란드어), fr (프랑스어), he (Hebrew), hu (헝가리어), id (인도네시아어), it (이탈리아어), ja (일본어), ko (한국어), lt (리투아니아어), lv (라트비아어), nb (노르웨이 복말), nl (네덜란드어), pl (폴란드어), pt (포르투갈어), ro (루마니아어), ru (러시아어), sk (슬로바키아어), sl (슬로베니아어), sr (Српски), sv (스웨덴어), th (Thai), tr (터키어), uk (Ukrainian), vi (Vietnamese), 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.

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

  • 진행 중 - 제작 단계에서의 보고
  • Identification pending - 보류 중인 보고서 준비 중입니다. 클라이언트의 추가 데이터가 필요합니다.
  • Canceled - 취소된 주문
  • Finished - 보고서가 준비되었습니다.
  • Updated - 완성된 보고서에 정보가 추가되었습니다.
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - 시스템에서 기술적 오류가 발생했습니다. 이 오류에 대해 알려드리며 최대한 빨리 수정하겠습니다. 주문을 수령할 수 있는 시점에 대해 알려드리겠습니다.

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

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

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

보관된 신용 보고서를 주문하는 방법은 무엇인가요?

Purchase of an archived report is available for all countries.

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

STEP 1: Find a company

기능 SimpleSearch

To order an archived report you need to receive "<search_result_id>" which has an "<archived_reports>" section that contains a product you need.
To do so, please follow the link: 회사를 검색하는 방법은 무엇인가요?

Example companies with archived reports:

  • Country: EST, Reg. Code: 12309116
  • Country: EST, Reg. Code: 12854256
  • Country: EST, Reg. Code: 12830238
  • Country: USA, Company name: Apple

STEP 2: Order a report

기능 Order

STEP 3: Order cancellation (Optional)

Just like the online/offline reports.

STEP 4: Order confirmation

Just like the online/offline reports.

STEP 5: Check order status

Just like the online/offline reports.

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

STEP 6: Get report

Just like the online/offline reports.

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

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: 회사를 검색하는 방법은 무엇인가요?

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: 사용 가능한 재무제표 검색

기능 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.

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

  • 진행 중 - 제작 단계에서의 보고
  • Identification pending - 보류 중인 보고서 준비 중입니다. 클라이언트의 추가 데이터가 필요합니다.
  • Canceled - 취소된 주문
  • Finished - 보고서가 준비되었습니다.
  • Updated - 완성된 보고서에 정보가 추가되었습니다.
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • 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
사용 가능한 언어 목록: ar (Arabic), bg (불가리아어), cs (체코어), da (덴마크어), de (독일어), el (Greek), en (영어), es (스페인어), et (에스토니아어), fi (핀란드어), fr (프랑스어), he (Hebrew), hu (헝가리어), id (인도네시아어), it (이탈리아어), ja (일본어), ko (한국어), lt (리투아니아어), lv (라트비아어), nb (노르웨이 복말), nl (네덜란드어), pl (폴란드어), pt (포르투갈어), ro (루마니아어), ru (러시아어), sk (슬로바키아어), sl (슬로베니아어), sr (Српски), sv (스웨덴어), th (Thai), tr (터키어), uk (Ukrainian), vi (Vietnamese), zh (중국어)
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.

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

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

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

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

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

기능 CreditOpinionCalculator

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

기능 GetClassifiersFinancialStatements
기능 GetActivityClassificators
기능 GetDictionaryStandardPhrases
기능 GetAvailableProducts

delivery_term:

  1. "o" = "Online"
  2. "n" = "Normal"
  3. "f" = "Flash"
  4. "s" = "SuperFlash"

가능한 오류

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

모든 기능
  • Incorrect username/password or you have no permissions.
    잘못된 자격 증명을 입력했거나 API 액세스가 차단되었습니다.
기능 SimpleSearch
  1. You don't have permissions to search in this country.
    사용 가능한 국가 목록: Georgia (GEO), 가이아나 협동조합 공화국 (GUY), 감비아 공화국 (GMB), 과들루프 (GLP), 그리스 공화국 (GRC), 그린란드 (GRL), 기니 공화국 (GIN), 나미비아 공화국 (NAM), 나이지리아 연방 공화국 (NGA), 남아프리카 공화국 (ZAF), 네덜란드 왕국 (NLD), 노르웨이 왕국 (NOR), 뉴질랜드 (NZL), 덴마크 왕국 (DNK), 독일 연방 공화국 (DEU), 라트비아 공화국 (LVA), 러시아 연방 (RUS), 루마니아 (ROU), 룩셈부르크 대공국 (LUX), 르완다 공화국 (RWA), 리투아니아 공화국 (LTU), 리히텐슈타인 공국 (LIE), 마다가스카르 공화국 (MDG), 마르티니크 (MTQ), 마요트 (MYT), 맨섬 (IMN), 모나코 공국 (MCO), 모로코 왕국 (MAR), 모리셔스 공화국 (MUS), 몰도바 공화국 (MDA), 몰디브 공화국 (MDV), 몰타 공화국 (MLT), 몽골 (MNG), 베냉 공화국 (BEN), 베네수엘라 볼리바르 공화국 (VEN), 벨기에 왕국 (BEL), 벨라루스 공화국 (BLR), 보스니아 헤르체고비나 (BIH), 보츠와나 공화국 (BWA), 볼리비아 다민족 국가 (BOL), 불가리아 공화국 (BGR), 브라질 연방 공화국 (BRA), 사모아 독립 국가 (WSM), 산마리노 공화국 (SMR), 세르비아 공화국 (SRB), 세이셸 공화국 (SYC), 세인트 마틴의 집단성 (MAF), 스리랑카 민주 사회주의 공화국 (LKA), 스웨덴 왕국 (SWE), 스위스 연방 (CHE), 스페인 왕국 (ESP), 슬로바키아 공화국 (SVK), 슬로베니아 공화국 (SVN), 싱가포르 공화국 (SGP), 아르헨티나 공화국 (ARG), 아이슬란드 공화국 (ISL), 아일랜드 (IRL), 아제르바이잔 공화국 (AZE), 알바니아 공화국 (ALB), 알제리 인민 민주 공화국 (DZA), 앙골라 공화국 (AGO), 에스토니아 공화국 (EST), 에콰도르 공화국 (ECU), 에티오피아 연방 민주 공화국 (ETH), 영국 및 북아일랜드 연합 왕국 (GBR), 오스트리아 공화국 (AUT), 우루과이 동부 공화국 (URY), 우즈베키스탄 공화국 (UZB), 이스라엘 국가 (ISR), 이탈리아 공화국 (ITA), 일본 (JPN), 잠비아 공화국 (ZMB), 재결합 (REU), 저지의 베일리윅 (JEY), 중국 공화국 (TWN), 중화 인민 공화국 (CHN), 짐바브웨 공화국 (ZWE), 체코 공화국 (CZE), 칠레 공화국 (CHL), 카자흐스탄 공화국 (KAZ), 캐나다 (CAN), 케냐 공화국 (KEN), 코소보 (XXK), 코트디부아르 (CIV), 콩고 공화국 (COG), 크로아티아 공화국 (HRV), 키르기즈 공화국 (KGZ), 키프로스 공화국 (CYP), 타지키스탄 공화국 (TJK), 탄자니아 연합 공화국 (TZA), 태국 왕국 (THA), 토고 공화국 (TGO), 파라과이 공화국 (PRY), 페루 공화국 (PER), 포르투갈 공화국 (PRT), 폴란드 공화국 (POL), 프랑스 공화국 (FRA), 프랑스령 기아나 (GUF), 핀란드 공화국 (FIN), 필리핀 공화국 (PHL), 헝가리 공화국 (HUN), 호주 연방 (AUS), 홍콩 (HKG)
기능 Order
  1. This product is not available.
    해당 제품을 찾을 수 없으며 주문할 수 없습니다.
  2. You can't order report on company with legal form: "legal_form"
    이 오류는 다음에만 적용됩니다.: 스웨덴 왕국 (SWE)
    스웨덴에서는 다음 법적 양식으로 온라인 보고서(배송 기간 = "O")를 주문할 수 없습니다:
    • enskild näringsidkare
    • kommanditbolag
    • handelsbolag
  3. 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
  4. Business Name or Reg Code is required
    오프라인 보고서 주문 시(배송 기간 = "n", "f" 또는 "s") "사업자명" 또는 "등록 코드"가 필요합니다.
  5. Reg Code is required when delivery term is Online
    온라인 보고서 주문 시(배송 기간 = "O") "등록 코드"가 필요합니다.
기능 GetReport
  1. This language is not supported.
    온라인 보고서에 사용할 수 있는 언어 목록: ar (Arabic), bg (불가리아어), cs (체코어), da (덴마크어), de (독일어), el (Greek), en (영어), es (스페인어), et (에스토니아어), fi (핀란드어), fr (프랑스어), he (Hebrew), hu (헝가리어), id (인도네시아어), it (이탈리아어), ja (일본어), ko (한국어), lt (리투아니아어), lv (라트비아어), nb (노르웨이 복말), nl (네덜란드어), pl (폴란드어), pt (포르투갈어), ro (루마니아어), ru (러시아어), sk (슬로바키아어), sl (슬로베니아어), sr (Српски), sv (스웨덴어), th (Thai), tr (터키어), uk (Ukrainian), vi (Vietnamese), zh (중국어)
기능 GetReport ChkStatus
  1. Incorrect order_id.
    주문 ID를 찾을 수 없습니다. Order 함수를 사용하면 주문 ID를 얻을 수 있습니다.
기능 OrderCancellation
  1. Your order is already canceled.
    더 이상 주문을 취소할 수 있는 권한이 없습니다.
기능 OrderConfirmation
  1. You don't have permission to confirm the order anymore. Confirmation can be done within one hour after you recieved 'order_id'.

SOAP(버전 4)는 SOAP(버전 3)과 비교하여 다음과 같은 변경 사항이 있습니다.

새 섹션

  • country_economic_overview — 다음 하위 섹션을 포함합니다: data_transparency_index, country_development_indicators, economic_forecast.
  • paid_taxes — 납부한 세금에 대한 정보.
  • tenders — 입찰 관련 정보.
  • sanctions — ' negative_information ' 섹션에 추가되었습니다.

기존 섹션의 업데이트

beneficiaries, shareholders, managers, 및 employees_data 섹션에 다음 요소가 추가되었습니다:
  • source_type — 데이터 소스 유형 (예: official, mass_media, company_admin 등).
relations_of_persons 섹션에 새로운 요소가 추가되었습니다:
  • match_type
capital 섹션이 재구조화되었습니다:
  • capital_amount 요소는 issued_capital 로 이름이 변경되었습니다.
  • 다음 새로운 요소가 추가되었습니다:
    • number_of_shares
    • share_value
    • authorized_capital
employees_data 섹션에서:
  • 새로운 요소 ' group_figure '는 데이터에 그룹 수준 집계 값이 포함되어 있는지 여부를 표시합니다 (true).
  • source_type 요소는 데이터 소스 유형을 지정합니다.
  • 요소 ' is_estimated '는 이제 값이 ' true'인 경우에만 포함됩니다.
새로운 ' assets_data ' 섹션 — 기존 섹션을 통합합니다:
  • real_estate_data (이전 이름: property_data), vehicles, machinery_and_equipment (이전 이름: assets).
  • 향후 추가 예정: patents 및 biological_assets.
vehicles 섹션에 새로운 필드가 추가되었습니다:
  • value
litigations 섹션에 다음 요소가 추가되었습니다:
  • content, instance, process, authority
financial_statement/positions 및 summary/latest_turnovers 에 새로운 요소가 추가되었습니다:
  • value_origin — 값의 출처를 설명합니다. 예를 들어, 값 ' estimated '는 사용 가능한 데이터에 기반해 논리나 AI를 통해 추정 및 계산된 값입니다.
branches_data 섹션에는 다음과 같은 필드가 추가되었습니다:
  • registration_number
  • director_name

참고: 안정화 단계에서 작은 개선 사항이나 조정 사항이 추가될 수 있습니다.

Webhooks Settings

개요

웹후크는 애플리케이션이 다른 애플리케이션에 실시간 정보를 제공하는 방법입니다. 웹후크 기능은 URL로 구성된 HTTP 콜백을 구현합니다. 지정된 이벤트가 발생할 때마다 HTTP POST 페이로드가 JSON 형식으로 이 URL로 전송됩니다. 저희 프로젝트에서는 특정 이벤트를 트리거하도록 웹후크 기능을 설계했습니다.

웹훅 설정하기

애플리케이션에 웹훅을 설정하려면 애플리케이션 설정 페이지로 이동하여 '웹훅 설정' 섹션을 찾습니다. 그리고 다음 정보를 입력합니다:

  1. "웹훅 URL "은 서버가 웹훅 POST 요청을 수신할 URL입니다.
  2. '배달 최대 시도 횟수'는 초기 배달 시도가 실패했을 때 웹훅 이벤트를 배달하기 위해 수행해야 하는 최대 재시도 횟수를 정의하는 설정입니다.
  3. '배달 재시도 시간 제한'은 웹훅 배달 시도가 실패했을 때 재시도 간격을 지정할 수 있는 설정입니다.

세부 정보를 입력한 후 '저장'을 클릭합니다.

웹훅 이벤트 유형

  1. 새로운 주문 상태

웹훅 페이로드

이벤트가 발생하면 이벤트에 대한 정보가 포함된 JSON 본문과 함께 페이로드 URL로 HTTP POST 요청을 전송합니다.

페이로드 예시는 다음과 같습니다:
새로운 주문 상태의 페이로드 예시
"new_status" 필드의 가능한 값:
  • "Finished" - 주문이 완료된 것입니다. 주문 수령 가능;
  • "Updated" - 주문 업데이트, 완료된 주문에 데이터 추가;
  • "Canceled" - 고객의 요청(또는 동의)에 따라 주문이 취소된 경우;
  • "Rejected" - 주문이 거부됩니다. 일반적으로 회사를 식별할 수 없기 때문입니다..
  • "Identification pending" - 주문을 준비하기 전에 고객으로부터 더 많은 정보가 필요합니다..

웹훅 보안

페이로드 URL로 전송되는 POST 요청이 애플리케이션에서 보낸 것인지 확인하는 것이 중요합니다. 이를 지원하기 위해 모든 웹훅 요청에는 X-서명 헤더가 포함됩니다.

서명 설명

서명을 위해 SHA512 알고리즘이 포함된 HMAC을 사용합니다.

시크릿은 웹훅 설정에서 앱 ID와 시크릿 키를 연결한 것입니다.

필요한 경우 발신자를 식별하기 위해 엔드포인트에 고유한 get 매개변수를 추가할 수 있습니다.

문제 해결

서버는 10초 이내에 응답하고 2XX HTTP 코드를 반환해야 하며, 그렇지 않으면 웹훅 전송에 실패한 것으로 간주합니다. 실패할 경우 기능에서는 전송 정책에 따라 요청을 다시 보내려고 시도합니다.