Documentația API Infoproff - v4

Versiunea Switch V4

Noțiuni introductive

Serviciul web wsdl și schemele sunt localizate aici:

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 - Căutați informații despre companii din diferite țări.
  • ChkFinance - Căutați situațiile financiare disponibile.
  • Order - Creează un order_id și returnează duplicatele. Dublurile sunt selectate după următorii parametri: country, product, reg_code.
  • OrderCancellation - Dacă ați trimis o cerere de comandă și ați primit order_id, aveți posibilitatea de a anula această comandă (dacă nu a intrat în producție).
  • OrderConfirmation - După ce ați primit order_id, va trebui să confirmați comanda în termen de 1 oră. Dacă nu confirmați comanda în termen de 1 oră, aceasta va fi anulată automat.
  • ChkStatus - Verificați starea comenzii.
  • GetReport - Obțineți rapoarte finalizate.
  • GetClassifiersFinancialStatements - Obține toate documentele financiare cu toate elementele: row_number, row_formated_description, row_lang_key și row_order.
  • GetLegalForms - Obțineți toate formularele juridice pentru toate țările disponibile.
  • GetActivityClassificators - Obțineți toate codurile și descrierile pentru un anumit clasificator de activități.
  • GetDictionaryStandardPhrases - Obțineți toate frazele standard cu chei și limbă.
  • GetAvailableProducts - Obțineți o listă de produse disponibile.
  • CreditOpinionCalculator - Calculatorul de opinie de credit ajută la atribuirea opiniei de credit pentru o companie.

API oferă mai multe servicii:

  1. Rapoarte de credit online pentru următoarele țări: Republica Finlanda (FIN), Regatul Suediei (SWE), Regatul Belgiei (BEL), Regatul Țărilor de Jos (NLD), Republica Estonia (EST), Republica Kazahstan (KAZ), Republica Polonă (POL), Republica Kârgâzstan (KGZ), Republica Populară Chineză (CHN), Mongolia (MNG)
  2. Rapoarte offline pentru următoarele țări: Toate țările
  3. Calculator de opinie de credit

Cum să căutați o companie?

Căutarea companiei constă în 2 opțiuni:

  1. Căutare după numele companiei,
  2. Search by company code.
Lista țărilor disponibile: Bazilicul Jersey (JEY), Bosnia și Herțegovina (BIH), Canada (CAN), Coasta de Fildeș (CIV), Colectivitatea Saint Martin (MAF), Commonwealth-ul Australiei (AUS), Confederația Elvețiană (CHE), Federația Rusă (RUS), Georgia (GEO), Groenlanda (GRL), Guadelupa (GLP), Guiana Franceză (GUF), Hong Kong (HKG), Insula Man (IMN), Irlanda (IRL), Japonia (JPN), Kosovo (XXK), Marele Ducat al Luxemburgului (LUX), Martinica (MTQ), Mayotte (MYT), Mongolia (MNG), Noua Zeelandă (NZL), Principatul Liechtenstein (LIE), Principatul Monaco (MCO), Regatul Belgiei (BEL), Regatul Danemarcei (DNK), Regatul Marocului (MAR), Regatul Norvegiei (NOR), Regatul Spaniei (ESP), Regatul Suediei (SWE), Regatul Thailandei (THA), Regatul Unit al Marii Britanii și Irlandei de Nord (GBR), Regatul Țărilor de Jos (NLD), Republica Africa de Sud (ZAF), Republica Albania (ALB), Republica Algeriană Democratică și Populară (DZA), Republica Angola (AGO), Republica Argentina (ARG), Republica Austria (AUT), Republica Azerbaidjan (AZE), Republica Belarus (BLR), Republica Benin (BEN), Republica Bolivariană a Venezuelei (VEN), Republica Botswana (BWA), Republica Bulgaria (BGR), Republica Cehă (CZE), Republica Chile (CHL), Republica Cipru (CYP), Republica Congo (COG), Republica Cooperativă din Guyana (GUY), Republica Croația (HRV), Republica Democratică Socialistă Sri Lanka (LKA), Republica Ecuador (ECU), Republica Elenă (GRC), Republica Estonia (EST), Republica Federală Democrată Etiopia (ETH), Republica Federală Germania (DEU), Republica Federală Nigeria (NGA), Republica Federativă a Braziliei (BRA), Republica Filipine (PHL), Republica Finlanda (FIN), Republica Franceză (FRA), Republica Gambia (GMB), Republica Guineea (GIN), Republica Islanda (ISL), Republica Italiană (ITA), Republica Kazahstan (KAZ), Republica Kenya (KEN), Republica Kârgâzstan (KGZ), Republica Letonia (LVA), Republica Lituania (LTU), Republica Madagascar (MDG), Republica Maldive (MDV), Republica Malta (MLT), Republica Mauritius (MUS), Republica Moldova (MDA), Republica Namibia (NAM), Republica Orientală a Uruguayului (URY), Republica Paraguay (PRY), Republica Peru (PER), Republica Polonă (POL), Republica Populară Chineză (CHN), Republica Populară Chineză (TWN), Republica Portugheză (PRT), Republica Rwanda (RWA), Republica San Marino (SMR), Republica Serbia (SRB), Republica Seychelles (SYC), Republica Singapore (SGP), Republica Slovacă (SVK), Republica Slovenia (SVN), Republica Tadjikistan (TJK), Republica Togo (TGO), Republica Ungară (HUN), Republica Unită a Tanzaniei (TZA), Republica Uzbekistan (UZB), Republica Zambia (ZMB), Republica Zimbabwe (ZWE), Reuniune (REU), România (ROU), Statul Israel (ISR), Statul Plurinațional al Boliviei (BOL), Statul independent Samoa (WSM)

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.

Informații importante:

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.

Registrul norvegian nu permite căutarea după nume a societăților șterse. Prin urmare, nu putem oferi SimpleSearch după nume în cadrul societăților șterse din Norvegia.

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

Mai jos puteți găsi un exemplu:

Funcția SimpleSearch

Opțiunea 2: Căutați după codul de înregistrare

Funcția SimpleSearch

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

Funcția UnifiedSearch

Cum să comandați un raport de credit?

List of available countries for online credit reports: Confederația Elvețiană (CHE), Federația Rusă (RUS), Irlanda (IRL), Marele Ducat al Luxemburgului (LUX), Mongolia (MNG), Regatul Belgiei (BEL), Regatul Danemarcei (DNK), Regatul Norvegiei (NOR), Regatul Spaniei (ESP), Regatul Suediei (SWE), Regatul Unit al Marii Britanii și Irlandei de Nord (GBR), Regatul Țărilor de Jos (NLD), Republica Austria (AUT), Republica Azerbaidjan (AZE), Republica Bulgaria (BGR), Republica Cehă (CZE), Republica Croația (HRV), Republica Elenă (GRC), Republica Estonia (EST), Republica Federală Germania (DEU), Republica Finlanda (FIN), Republica Franceză (FRA), Republica Italiană (ITA), Republica Kazahstan (KAZ), Republica Kârgâzstan (KGZ), Republica Letonia (LVA), Republica Malta (MLT), Republica Moldova (MDA), Republica Polonă (POL), Republica Populară Chineză (CHN), Republica Portugheză (PRT), Republica Slovacă (SVK), Republica Slovenia (SVN), Republica Ungară (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))

Funcția SimpleSearch

To order an Online/Offline with identification report you need to receive "<search_result_id>".
To do so, please follow the link: Cum să căutați o companie?

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))

Funcția 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))

Funcția 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))

Funcția 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))

Funcția 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.

Următoarele stări sunt utilizate pentru rapoarte:

  • În curs de desfășurare - Raport în faza de producție
  • Identification pending - Elaborarea raportului este în așteptare. Necesită date suplimentare de la client.
  • Canceled - Comandă anulată
  • Finished - Raportul este gata
  • Updated - Au fost adăugate informații la raportul final
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - A apărut o eroare tehnică în sistemul nostru. Aceasta înseamnă că suntem informați despre această eroare și o vom remedia cât mai curând posibil. Veți fi informat când veți putea primi comanda.

În cazul în care starea de execuție este Finished sau Updated, atunci puteți obține un ordin.

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

Funcția GetReport
Lista de limbi disponibile: ar (Arabic), bg (Bulgară), cs (Cehia), da (Daneză), de (Germană), el (Greacă), en (Engleză), es (Spaniolă), et (Estoniană), fi (Finlandeză), fr (Franceză), he (Hebrew), hu (Maghiară), id (Indoneziană), it (Italian), ja (Japoneză), ko (Coreeană), lt (Lituaniene), lv (Letonă), nb (Norvegiană Bokmål), nl (Olandeză), pl (Poloneză), pt (Portugheză), ro (Românesc), ru (Rusă), sk (Slovacă), sl (Slovenă), sr (Српски), sv (Suedeză), th (Thai), tr (Turcă), uk (Ucraineană), vi (Vietnamese), zh (Chineză)

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

Funcția 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))

Funcția 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))

Funcția 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))

Funcția ChkStatus
For offline orders checking order status once every 30 minutes is acceptable frequency.

Următoarele stări sunt utilizate pentru rapoarte:

  • În curs de desfășurare - Raport în faza de producție
  • Identification pending - Elaborarea raportului este în așteptare. Necesită date suplimentare de la client.
  • Canceled - Comandă anulată
  • Finished - Raportul este gata
  • Updated - Au fost adăugate informații la raportul final
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - A apărut o eroare tehnică în sistemul nostru. Aceasta înseamnă că suntem informați despre această eroare și o vom remedia cât mai curând posibil. Veți fi informat când veți putea primi comanda.

În cazul în care starea de execuție este Finished sau Updated, atunci puteți obține un ordin.

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

Funcția GetReport
Lista de limbi disponibile: ar (Arabic), bg (Bulgară), cs (Cehia), da (Daneză), de (Germană), el (Greacă), en (Engleză), es (Spaniolă), et (Estoniană), fi (Finlandeză), fr (Franceză), he (Hebrew), hu (Maghiară), id (Indoneziană), it (Italian), ja (Japoneză), ko (Coreeană), lt (Lituaniene), lv (Letonă), nb (Norvegiană Bokmål), nl (Olandeză), pl (Poloneză), pt (Portugheză), ro (Românesc), ru (Rusă), sk (Slovacă), sl (Slovenă), sr (Српски), sv (Suedeză), th (Thai), tr (Turcă), uk (Ucraineană), vi (Vietnamese), zh (Chineză)

Cum să comandați un raport de credit arhivat?

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

Funcția 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: Cum să căutați o companie?

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

Funcția 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.

Cum să comandați situații financiare online?

STEP 1: Find a company

Funcția SimpleSearch

To order an online financial statements, you need to receive "<search_result_id>".
To do so, please follow the link: Cum să căutați o companie?

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: Căutați situațiile financiare disponibile

Funcția ChkFinance

Această funcție este necesară numai atunci când se comandă un produs: finances (Financial statements) cu delivery_term = 'o'.

Lista țărilor disponibile: Republica Estonia (EST), Regatul Suediei (SWE)

STEP 3: Comandați situațiile financiare

Funcția 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)

Funcția 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

Funcția 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

Funcția ChkStatus
  • - For online orders checking order status once every 5 seconds is acceptable frequency.

Următoarele stări sunt utilizate pentru rapoarte:

  • În curs de desfășurare - Raport în faza de producție
  • Identification pending - Elaborarea raportului este în așteptare. Necesită date suplimentare de la client.
  • Canceled - Comandă anulată
  • Finished - Raportul este gata
  • Updated - Au fost adăugate informații la raportul final
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - A apărut o eroare tehnică în sistemul nostru. Aceasta înseamnă că suntem informați despre această eroare și o vom remedia cât mai curând posibil. Veți fi informat când veți putea primi comanda.

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

Funcția GetReport
Lista de limbi disponibile: ar (Arabic), bg (Bulgară), cs (Cehia), da (Daneză), de (Germană), el (Greacă), en (Engleză), es (Spaniolă), et (Estoniană), fi (Finlandeză), fr (Franceză), he (Hebrew), hu (Maghiară), id (Indoneziană), it (Italian), ja (Japoneză), ko (Coreeană), lt (Lituaniene), lv (Letonă), nb (Norvegiană Bokmål), nl (Olandeză), pl (Poloneză), pt (Portugheză), ro (Românesc), ru (Rusă), sk (Slovacă), sl (Slovenă), sr (Српски), sv (Suedeză), th (Thai), tr (Turcă), uk (Ucraineană), vi (Vietnamese), zh (Chineză)
To see the examples of xml request/response, please follow the link: How to get finished order?

Cum se pot descărca rapoarte standard (în alte formate decât 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.

Cererea este formată din 3 părți:

  1. Partea fixă https://www.infoproff.com/en/orders/files/
  2. Hash-ul dvs. unic, pe care îl furnizăm ca răspuns
  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 - Original (fără schimb), 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

Cum să descărcați produse non-standard?

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.

Cererea este formată din 3 părți:

  1. Fixed part https://www.infoproff.com/en/orders/files/
  2. Hash-ul dvs. unic, pe care îl furnizăm ca răspuns
  3. Și partea fixă de la sfârșit /download

Cum să obțineți avizul de credit?

Funcția CreditOpinionCalculator

Cum se pot obține informații suplimentare?

Funcția GetClassifiersFinancialStatements
Funcția GetActivityClassificators
Funcția GetDictionaryStandardPhrases
Funcția GetAvailableProducts

delivery_term:

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

Erori posibile

Aceste erori pot apărea în timp ce faceți o cerere către serviciul nostru web.

Toate funcțiile
  • Incorrect username/password or you have no permissions.
    Ați introdus acreditări greșite sau accesul la API este blocat.
Funcția SimpleSearch
  1. You don't have permissions to search in this country.
    Lista țărilor disponibile: Bazilicul Jersey (JEY), Bosnia și Herțegovina (BIH), Canada (CAN), Coasta de Fildeș (CIV), Colectivitatea Saint Martin (MAF), Commonwealth-ul Australiei (AUS), Confederația Elvețiană (CHE), Federația Rusă (RUS), Georgia (GEO), Groenlanda (GRL), Guadelupa (GLP), Guiana Franceză (GUF), Hong Kong (HKG), Insula Man (IMN), Irlanda (IRL), Japonia (JPN), Kosovo (XXK), Marele Ducat al Luxemburgului (LUX), Martinica (MTQ), Mayotte (MYT), Mongolia (MNG), Noua Zeelandă (NZL), Principatul Liechtenstein (LIE), Principatul Monaco (MCO), Regatul Belgiei (BEL), Regatul Danemarcei (DNK), Regatul Marocului (MAR), Regatul Norvegiei (NOR), Regatul Spaniei (ESP), Regatul Suediei (SWE), Regatul Thailandei (THA), Regatul Unit al Marii Britanii și Irlandei de Nord (GBR), Regatul Țărilor de Jos (NLD), Republica Africa de Sud (ZAF), Republica Albania (ALB), Republica Algeriană Democratică și Populară (DZA), Republica Angola (AGO), Republica Argentina (ARG), Republica Austria (AUT), Republica Azerbaidjan (AZE), Republica Belarus (BLR), Republica Benin (BEN), Republica Bolivariană a Venezuelei (VEN), Republica Botswana (BWA), Republica Bulgaria (BGR), Republica Cehă (CZE), Republica Chile (CHL), Republica Cipru (CYP), Republica Congo (COG), Republica Cooperativă din Guyana (GUY), Republica Croația (HRV), Republica Democratică Socialistă Sri Lanka (LKA), Republica Ecuador (ECU), Republica Elenă (GRC), Republica Estonia (EST), Republica Federală Democrată Etiopia (ETH), Republica Federală Germania (DEU), Republica Federală Nigeria (NGA), Republica Federativă a Braziliei (BRA), Republica Filipine (PHL), Republica Finlanda (FIN), Republica Franceză (FRA), Republica Gambia (GMB), Republica Guineea (GIN), Republica Islanda (ISL), Republica Italiană (ITA), Republica Kazahstan (KAZ), Republica Kenya (KEN), Republica Kârgâzstan (KGZ), Republica Letonia (LVA), Republica Lituania (LTU), Republica Madagascar (MDG), Republica Maldive (MDV), Republica Malta (MLT), Republica Mauritius (MUS), Republica Moldova (MDA), Republica Namibia (NAM), Republica Orientală a Uruguayului (URY), Republica Paraguay (PRY), Republica Peru (PER), Republica Polonă (POL), Republica Populară Chineză (CHN), Republica Populară Chineză (TWN), Republica Portugheză (PRT), Republica Rwanda (RWA), Republica San Marino (SMR), Republica Serbia (SRB), Republica Seychelles (SYC), Republica Singapore (SGP), Republica Slovacă (SVK), Republica Slovenia (SVN), Republica Tadjikistan (TJK), Republica Togo (TGO), Republica Ungară (HUN), Republica Unită a Tanzaniei (TZA), Republica Uzbekistan (UZB), Republica Zambia (ZMB), Republica Zimbabwe (ZWE), Reuniune (REU), România (ROU), Statul Israel (ISR), Statul Plurinațional al Boliviei (BOL), Statul independent Samoa (WSM)
Funcția Order
  1. This product is not available.
    Un astfel de produs nu poate fi găsit și nu este posibil să fie comandat.
  2. You can't order report on company with legal form: "legal_form"
    Această eroare se aplică numai la: Regatul Suediei (SWE)
    În Suedia nu este posibil să se comande raportul online (delivery_term = "o") cu următoarele formulare legale:
    • 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
    Atunci când se comandă un raport offline (delivery_term = "n", "f" sau "s"), este necesar "Business Name" sau "Reg Code".
  5. Reg Code is required when delivery term is Online
    În cazul în care comandați raportul online (delivery_term = "o"), este necesar "Reg Code".
Funcția GetReport
  1. This language is not supported.
    Lista limbilor disponibile pentru rapoartele online: ar (Arabic), bg (Bulgară), cs (Cehia), da (Daneză), de (Germană), el (Greacă), en (Engleză), es (Spaniolă), et (Estoniană), fi (Finlandeză), fr (Franceză), he (Hebrew), hu (Maghiară), id (Indoneziană), it (Italian), ja (Japoneză), ko (Coreeană), lt (Lituaniene), lv (Letonă), nb (Norvegiană Bokmål), nl (Olandeză), pl (Poloneză), pt (Portugheză), ro (Românesc), ru (Rusă), sk (Slovacă), sl (Slovenă), sr (Српски), sv (Suedeză), th (Thai), tr (Turcă), uk (Ucraineană), vi (Vietnamese), zh (Chineză)
Funcții GetReport ChkStatus
  1. Incorrect order_id.
    ID-ul comenzii nu poate fi găsit. Veți obține ID-ul comenzii atunci când utilizați funcția Order.
Funcția OrderCancellation
  1. Your order is already canceled.
    Nu mai aveți permisiunea de a anula comanda.
Funcția OrderConfirmation
  1. You don't have permission to confirm the order anymore. Confirmation can be done within one hour after you recieved 'order_id'.

Modificări SOAP (versiunea 4) față de SOAP (versiunea 3)

Secțiuni noi

  • country_economic_overview — include următoarele subsecțiuni: data_transparency_index, country_development_indicators, economic_forecast.
  • paid_taxes — informații despre impozitele plătite.
  • tenders — informații despre licitații.
  • sanctions — adăugate la secțiunea „ negative_information ”.

Actualizări ale secțiunilor existente

În secțiunile beneficiaries, shareholders, managers și employees_data, a fost adăugat următorul element:
  • source_type — tipul sursei de date (de exemplu, official, mass_media, company_admin, etc.).
În secțiunea „ relations_of_persons ”, a fost adăugat un element nou:
  • match_type
Secțiunea „ capital ” a fost restructurată:
  • Elementul „ capital_amount ” a fost redenumit „ issued_capital ”.
  • Au fost adăugate următoarele elemente noi:
    • number_of_shares
    • share_value
    • authorized_capital
În secțiunea „ employees_data ” (Deschidere la nivel de grup):
  • Elementul nou „ group_figure ” indică dacă datele includ cifre agregate la nivel de grup (true).
  • Elementul „ source_type ” specifică tipul sursei de date.
  • Elementul „ is_estimated ” este inclus acum numai dacă valoarea sa este „ true ”.
Noua secțiune „ assets_data ” — consolidează secțiunile existente anterior:
  • real_estate_data (denumită anterior „ property_data ”), „ vehicles ” și „ machinery_and_equipment ” (denumită anterior „ assets ”).
  • Adăugiri viitoare planificate: „ patents ” și „ biological_assets ”.
În secțiunea vehicles, a fost adăugat un nou câmp:
  • value
În secțiunea litigations, au fost adăugate următoarele elemente:
  • content, instance, process, authority
În financial_statement/positions și summary/latest_turnovers, a fost adăugat un element nou:
  • value_origin — descrie originea valorii; de exemplu, valoarea „ estimated ” - această valoare este estimată și calculată pe baza datelor disponibile utilizând logica sau IA.
În secțiunea branches_data, au fost adăugate următoarele câmpuri:
  • registration_number
  • director_name

Notă: În faza de stabilizare pot apărea încă îmbunătățiri și ajustări minore.

Webhooks Settings

Prezentare generală

Un webhook este o modalitate prin care o aplicație poate furniza altor aplicații informații în timp real. Caracteristica noastră webhook implementează callback-uri HTTP configurate cu un URL. O sarcină utilă HTTP POST este trimisă la acest URL în format JSON ori de câte ori apare un eveniment specificat. În contextul proiectului nostru, am conceput funcția webhook pentru a declanșa evenimente specifice.

Configurarea unui Webhook

Pentru a configura un webhook pentru aplicația dvs., navigați pe pagina de setări a aplicației și căutați secțiunea "Setări Webhooks". Și furnizați următoarele informații:

  1. "Webhook URL" este URL-ul la care serverul dvs. va primi solicitările POST ale webhook-ului.
  2. "Încercări maxime de livrare" este setarea care definește numărul maxim de încercări de reluare a livrării unui eveniment webhook atunci când încercarea inițială de livrare eșuează.
  3. "Delivery retry timeout" este o setare care vă permite să specificați intervalul de timp dintre încercări atunci când o încercare de livrare a unui webhook eșuează.

După ce ați furnizat aceste detalii, faceți clic pe "Save" (Salvare).

Tipuri de evenimente Webhook

  1. Noul statut al comenzii

Webhook Payload

Atunci când se produce un eveniment, vom trimite o cerere HTTP POST la URL-ul de plată cu un corp JSON care conține informații despre eveniment.

Iată un exemplu de sarcină utilă:
Exemplu de sarcină utilă a noului statut al comenzii
Valori posibile ale câmpului "new_status":
  • "Finished" - o comandă este completă. O comandă poate fi ridicată;
  • "Updated" - o comandă actualizată, date adăugate la o comandă finalizată;
  • "Canceled" - o comandă este anulată la cererea (sau cu acordul) unui client;
  • "Rejected" - un ordin este respins. De obicei, pentru că este imposibil să se identifice o societate.
  • "Identification pending" - avem nevoie de mai multe informații de la client înainte de a putea pregăti o comandă..

Asigurarea securizării Webhooks

Este important să verificăm dacă solicitările POST trimise către URL-ul de plată provin din aplicația noastră. Pentru a vă ajuta în acest sens, fiecare cerere webhook include un antet X-Signature.

Descriere semnătură

Pentru semnare folosim HMAC cu algoritmul SHA512.

Secret este o concatenare a ID-ului aplicației și a cheii secrete din setările webhooks.

Dacă este necesar, este posibil să se adauge la punctul final propriul parametru get params pentru a identifica expeditorul.

Depanare

Un server trebuie să răspundă în termen de 10 secunde și să returneze un cod HTTP 2XX; în caz contrar, livrarea webhook-ului este considerată un eșec. În caz de eșec, funcția va încerca să retrimită cererea în sus, în conformitate cu politica de livrare.