인포프로프 API 문서 - v3

버전 전환 V3

시작하기

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

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

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), 그리스 공화국 (GRC), 그린란드 (GRL), 남아프리카 공화국 (ZAF), 네덜란드 왕국 (NLD), 노르웨이 왕국 (NOR), 뉴질랜드 (NZL), 덴마크 왕국 (DNK), 독일 연방 공화국 (DEU), 라트비아 공화국 (LVA), 러시아 연방 (RUS), 루마니아 (ROU), 룩셈부르크 대공국 (LUX), 리히텐슈타인 공국 (LIE), 맨섬 (IMN), 모나코 공국 (MCO), 모로코 왕국 (MAR), 몰도바 공화국 (MDA), 몰디브 공화국 (MDV), 몰타 공화국 (MLT), 몽골 (MNG), 벨기에 왕국 (BEL), 벨라루스 공화국 (BLR), 보스니아 헤르체고비나 (BIH), 불가리아 공화국 (BGR), 브라질 연방 공화국 (BRA), 사모아 독립 국가 (WSM), 산마리노 공화국 (SMR), 세르비아 공화국 (SRB), 세이셸 공화국 (SYC), 스웨덴 왕국 (SWE), 스위스 연방 (CHE), 스페인 왕국 (ESP), 슬로바키아 공화국 (SVK), 슬로베니아 공화국 (SVN), 싱가포르 공화국 (SGP), 아랍 에미리트 (ARE), 아르헨티나 공화국 (ARG), 아이슬란드 공화국 (ISL), 아일랜드 (IRL), 아제르바이잔 공화국 (AZE), 알바니아 공화국 (ALB), 알제리 인민 민주 공화국 (DZA), 에스토니아 공화국 (EST), 에콰도르 공화국 (ECU), 영국 및 북아일랜드 연합 왕국 (GBR), 오스트리아 공화국 (AUT), 우즈베키스탄 공화국 (UZB), 이스라엘 국가 (ISR), 이탈리아 공화국 (ITA), 일본 (JPN), 저지의 베일리윅 (JEY), 중국 공화국 (TWN), 중화 인민 공화국 (CHN), 체코 공화국 (CZE), 카자흐스탄 공화국 (KAZ), 코소보 (XXK), 크로아티아 공화국 (HRV), 키르기즈 공화국 (KGZ), 키프로스 공화국 (CYP), 타지키스탄 공화국 (TJK), 파라과이 공화국 (PRY), 포르투갈 공화국 (PRT), 폴란드 공화국 (POL), 프랑스 공화국 (FRA), 핀란드 공화국 (FIN), 헝가리 공화국 (HUN), 호주 연방 (AUS), 홍콩 (HKG)
중요 정보:

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)

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

기능 SimpleSearch

옵션 2: 등록 코드로 검색

기능 SimpleSearch

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

기능 UnifiedSearch

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

List of available countries for online credit reports: 네덜란드 왕국 (NLD), 러시아 연방 (RUS), 몽골 (MNG), 벨기에 왕국 (BEL), 스웨덴 왕국 (SWE), 에스토니아 공화국 (EST), 중화 인민 공화국 (CHN), 카자흐스탄 공화국 (KAZ), 키르기즈 공화국 (KGZ), 폴란드 공화국 (POL), 핀란드 공화국 (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:

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 - 완성된 보고서에 정보가 추가되었습니다.
  • 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
사용 가능한 언어 목록: 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 (슬로베니아어), sr (Српски), 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 - 완성된 보고서에 정보가 추가되었습니다.
  • 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
사용 가능한 언어 목록: 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 (슬로베니아어), sr (Српски), sv (스웨덴어), tr (터키어), uk (Ukrainian), zh (중국어)

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

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.

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

  • 진행 중 - 제작 단계에서의 보고
  • 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
사용 가능한 언어 목록: 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 (슬로베니아어), sr (Српски), sv (스웨덴어), tr (터키어), uk (Ukrainian), 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, bg, cs, da, de, el, fi, fr, hu, id, it, ja, ko, lt, nl, nb, pl, pt, ro, sk, sl, es, sr, 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.

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

  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), 그리스 공화국 (GRC), 그린란드 (GRL), 남아프리카 공화국 (ZAF), 네덜란드 왕국 (NLD), 노르웨이 왕국 (NOR), 뉴질랜드 (NZL), 덴마크 왕국 (DNK), 독일 연방 공화국 (DEU), 라트비아 공화국 (LVA), 러시아 연방 (RUS), 루마니아 (ROU), 룩셈부르크 대공국 (LUX), 리히텐슈타인 공국 (LIE), 맨섬 (IMN), 모나코 공국 (MCO), 모로코 왕국 (MAR), 몰도바 공화국 (MDA), 몰디브 공화국 (MDV), 몰타 공화국 (MLT), 몽골 (MNG), 벨기에 왕국 (BEL), 벨라루스 공화국 (BLR), 보스니아 헤르체고비나 (BIH), 불가리아 공화국 (BGR), 브라질 연방 공화국 (BRA), 사모아 독립 국가 (WSM), 산마리노 공화국 (SMR), 세르비아 공화국 (SRB), 세이셸 공화국 (SYC), 스웨덴 왕국 (SWE), 스위스 연방 (CHE), 스페인 왕국 (ESP), 슬로바키아 공화국 (SVK), 슬로베니아 공화국 (SVN), 싱가포르 공화국 (SGP), 아랍 에미리트 (ARE), 아르헨티나 공화국 (ARG), 아이슬란드 공화국 (ISL), 아일랜드 (IRL), 아제르바이잔 공화국 (AZE), 알바니아 공화국 (ALB), 알제리 인민 민주 공화국 (DZA), 에스토니아 공화국 (EST), 에콰도르 공화국 (ECU), 영국 및 북아일랜드 연합 왕국 (GBR), 오스트리아 공화국 (AUT), 우즈베키스탄 공화국 (UZB), 이스라엘 국가 (ISR), 이탈리아 공화국 (ITA), 일본 (JPN), 저지의 베일리윅 (JEY), 중국 공화국 (TWN), 중화 인민 공화국 (CHN), 체코 공화국 (CZE), 카자흐스탄 공화국 (KAZ), 코소보 (XXK), 크로아티아 공화국 (HRV), 키르기즈 공화국 (KGZ), 키프로스 공화국 (CYP), 타지키스탄 공화국 (TJK), 파라과이 공화국 (PRY), 포르투갈 공화국 (PRT), 폴란드 공화국 (POL), 프랑스 공화국 (FRA), 핀란드 공화국 (FIN), 헝가리 공화국 (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.
    온라인 보고서에 사용할 수 있는 언어 목록: 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 (슬로베니아어), sr (Српски), sv (스웨덴어), tr (터키어), uk (Ukrainian), 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(버전 2)와 비교한 SOAP(버전 3)의 변경 사항

SOAP(버전 2)와 비교한 SOAP(버전 3)의 변경 사항 [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), 그리스 공화국 (GRC), 그린란드 (GRL), 남아프리카 공화국 (ZAF), 네덜란드 왕국 (NLD), 노르웨이 왕국 (NOR), 뉴질랜드 (NZL), 덴마크 왕국 (DNK), 독일 연방 공화국 (DEU), 라트비아 공화국 (LVA), 러시아 연방 (RUS), 루마니아 (ROU), 룩셈부르크 대공국 (LUX), 리히텐슈타인 공국 (LIE), 맨섬 (IMN), 모나코 공국 (MCO), 모로코 왕국 (MAR), 몰도바 공화국 (MDA), 몰디브 공화국 (MDV), 몰타 공화국 (MLT), 몽골 (MNG), 벨기에 왕국 (BEL), 벨라루스 공화국 (BLR), 보스니아 헤르체고비나 (BIH), 불가리아 공화국 (BGR), 브라질 연방 공화국 (BRA), 사모아 독립 국가 (WSM), 산마리노 공화국 (SMR), 세르비아 공화국 (SRB), 세이셸 공화국 (SYC), 스웨덴 왕국 (SWE), 스위스 연방 (CHE), 스페인 왕국 (ESP), 슬로바키아 공화국 (SVK), 슬로베니아 공화국 (SVN), 싱가포르 공화국 (SGP), 아랍 에미리트 (ARE), 아르헨티나 공화국 (ARG), 아이슬란드 공화국 (ISL), 아일랜드 (IRL), 아제르바이잔 공화국 (AZE), 알바니아 공화국 (ALB), 알제리 인민 민주 공화국 (DZA), 에스토니아 공화국 (EST), 에콰도르 공화국 (ECU), 영국 및 북아일랜드 연합 왕국 (GBR), 오스트리아 공화국 (AUT), 우즈베키스탄 공화국 (UZB), 이스라엘 국가 (ISR), 이탈리아 공화국 (ITA), 일본 (JPN), 저지의 베일리윅 (JEY), 중국 공화국 (TWN), 중화 인민 공화국 (CHN), 체코 공화국 (CZE), 카자흐스탄 공화국 (KAZ), 코소보 (XXK), 크로아티아 공화국 (HRV), 키르기즈 공화국 (KGZ), 키프로스 공화국 (CYP), 타지키스탄 공화국 (TJK), 파라과이 공화국 (PRY), 포르투갈 공화국 (PRT), 폴란드 공화국 (POL), 프랑스 공화국 (FRA), 핀란드 공화국 (FIN), 헝가리 공화국 (HUN), 호주 연방 (AUS), 홍콩 (HKG)

- 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), 러시아 연방 (RUS), 몽골 (MNG), 벨기에 왕국 (BEL), 스웨덴 왕국 (SWE), 에스토니아 공화국 (EST), 중화 인민 공화국 (CHN), 카자흐스탄 공화국 (KAZ), 키르기즈 공화국 (KGZ), 폴란드 공화국 (POL), 핀란드 공화국 (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 (슬로베니아어), sr (Српски), sv (스웨덴어), tr (터키어), uk (Ukrainian), zh (중국어)


SOAP(버전 2)와 비교한 SOAP(버전 3)의 변경 사항 [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

새로운 요소:

  • - search_result_id (is required for order with delivery_term = 'o')
  • - name_transliteration
  • - reg_code
  • - vat_code
  • - unified_legal_form

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" - 주문이 거부됩니다. 일반적으로 회사를 식별할 수 없기 때문입니다..

웹훅 보안

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

서명 설명

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

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

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

문제 해결

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