Documentação API Infoproff - v4

Versão de interruptor V4

Começar

Serviço Web wsdl e esquemas estão aqui localizados:

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 - Pesquisar informação sobre empresas em diferentes países.
  • ChkFinance - Procurar demonstrações financeiras disponíveis.
  • Order - Cria um order_id e devolve duplicados. As duplicatas são seleccionadas pelos parâmetros seguintes: country, product, reg_code.
  • OrderCancellation - Se enviou um pedido de encomenda e recebeu o order_id, tem a oportunidade de cancelar esta encomenda (se não tiver entrado em produção).
  • OrderConfirmation - Depois de receber order_id terá de confirmar a sua encomenda dentro de 1 hora. Se não confirmar a sua encomenda no prazo de 1 hora, a encomenda será cancelada automaticamente.
  • ChkStatus - Verificar o estado da encomenda.
  • GetReport - Obter relatórios finais.
  • GetClassifiersFinancialStatements - Obter todos os documentos financeiros com todos os elementos: row_number, row_formated_description, row_lang_key e row_order.
  • GetLegalForms - Obtenha todas as formas legais para todos os países disponíveis.
  • GetActivityClassificators - Obtenha todos os códigos e descrições para o classificador de actividades específicas.
  • GetDictionaryStandardPhrases - Obtenha todas as frases padrão com chaves e linguagem.
  • GetAvailableProducts - Obter uma lista dos produtos disponíveis.
  • CreditOpinionCalculator - A calculadora de opinião de crédito ajuda a atribuir opinião de crédito sobre uma empresa.

A API fornece vários serviços:

  1. Relatórios de crédito online para os seguintes países: Alemanha (DEU), Azerbaijão (AZE), Bulgária (BGR), Bélgica (BEL), Cazaquistão (KAZ), China (CHN), Chéquia (CZE), Croácia (HRV), Dinamarca (DNK), Eslováquia (SVK), Eslovénia (SVN), Espanha (ESP), Estónia (EST), Finlândia (FIN), França (FRA), Grécia (GRC), Hungria (HUN), Irlanda (IRL), Itália (ITA), Letónia (LVA), Luxemburgo (LUX), Malta (MLT), Moldávia (MDA), Mongólia (MNG), Noruega (NOR), Países Baixos (NLD), Polónia (POL), Portugal (PRT), Quirguistão (KGZ), Reino Unido (GBR), Rússia (RUS), Suécia (SWE), Suíça (CHE), Áustria (AUT)
  2. Relatórios fora de linha para os seguintes países: Todos os países
  3. Calculadora de opinião de crédito
  4. Company search

Como procurar uma empresa?

A pesquisa da empresa consiste em 2 opções:

  1. Pesquisa por nome de empresa,
  2. Search by company code.
Lista de países disponíveis: Albânia (ALB), Alemanha (DEU), Angola (AGO), Argentina (ARG), Argélia (DZA), Austrália (AUS), Azerbaijão (AZE), Benim (BEN), Bielorrússia (BLR), Bolívia (BOL), Botsuana (BWA), Brasil (BRA), Bulgária (BGR), Bélgica (BEL), Bósnia e Herzegovina (BIH), Canadá (CAN), Cazaquistão (KAZ), Chile (CHL), China (CHN), Chipre (CYP), Chéquia (CZE), Congo (COG), Costa do Marfim (CIV), Croácia (HRV), Dinamarca (DNK), Equador (ECU), Eslováquia (SVK), Eslovénia (SVN), Espanha (ESP), Estónia (EST), Etiópia (ETH), Filipinas (PHL), Finlândia (FIN), França (FRA), Geórgia (GEO), Gronelândia (GRL), Grécia (GRC), Guadalupe (GLP), Guiana (GUY), Guiana Francesa (GUF), Guiné (GIN), Gâmbia (GMB), Hong Kong (HKG), Hungria (HUN), Irlanda (IRL), Islândia (ISL), Israel (ISR), Itália (ITA), Japão (JPN), Jersey (JEY), Kosovo (XXK), Letónia (LVA), Listenstaine (LIE), Lituânia (LTU), Luxemburgo (LUX), Madagáscar (MDG), Maldivas (MDV), Malta (MLT), Man (IMN), Marrocos (MAR), Martinica (MTQ), Maurícia (MUS), Mayotte (MYT), Moldávia (MDA), Mongólia (MNG), Mónaco (MCO), Namíbia (NAM), Nigéria (NGA), Noruega (NOR), Nova Zelândia (NZL), Paraguai (PRY), Países Baixos (NLD), Peru (PER), Polónia (POL), Portugal (PRT), Quirguistão (KGZ), Quénia (KEN), Reino Unido (GBR), Reunião (REU), Roménia (ROU), Ruanda (RWA), Rússia (RUS), Samoa (WSM), Seychelles (SYC), Singapura (SGP), Sri Lanka (LKA), Suécia (SWE), Suíça (CHE), São Marino (SMR), São Martinho (MAF), Sérvia (SRB), Tailândia (THA), Taiwan (TWN), Tajiquistão (TJK), Tanzânia (TZA), Togo (TGO), Uruguai (URY), Uzbequistão (UZB), Venezuela (VEN), Zimbabué (ZWE), Zâmbia (ZMB), África do Sul (ZAF), Áustria (AUT)

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ções importantes:

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.

O registo da Noruega não permite pesquisar empresas apagadas por nomes. Por conseguinte, não podemos fornecer um SimpleSearch por nomes dentro de empresas eliminadas na Noruega.

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

Abaixo pode encontrar o exemplo:

Função SimpleSearch

Opção 2: Pesquisa por código de registo

Função SimpleSearch

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

Função UnifiedSearch

Como encomendar um relatório de crédito?

List of available countries for online credit reports: Alemanha (DEU), Azerbaijão (AZE), Bulgária (BGR), Bélgica (BEL), Cazaquistão (KAZ), China (CHN), Chéquia (CZE), Croácia (HRV), Dinamarca (DNK), Eslováquia (SVK), Eslovénia (SVN), Espanha (ESP), Estónia (EST), Finlândia (FIN), França (FRA), Grécia (GRC), Hungria (HUN), Irlanda (IRL), Itália (ITA), Letónia (LVA), Luxemburgo (LUX), Malta (MLT), Moldávia (MDA), Mongólia (MNG), Noruega (NOR), Países Baixos (NLD), Polónia (POL), Portugal (PRT), Quirguistão (KGZ), Reino Unido (GBR), Rússia (RUS), Suécia (SWE), Suíça (CHE), Áustria (AUT)
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))

Função SimpleSearch

To order an Online/Offline with identification report you need to receive "<search_result_id>".
To do so, please follow the link: Como procurar uma empresa?

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

Função 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))

Função 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))

Função 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))

Função 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.

Os seguintes estados são utilizados para relatórios:

  • Em curso - Relatório na fase de produção
  • Identification pending - A preparação do relatório está em espera. Requer dados adicionais do cliente.
  • Canceled - Ordem cancelada
  • Finished - O relatório está pronto
  • Updated - A informação foi acrescentada ao relatório final
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Ocorreu um erro técnico no nosso sistema. Isto significa que somos informados sobre este erro e que o iremos corrigir o mais rapidamente possível. Será informado quando puder receber a encomenda.

Se o estado de execução for Finished ou Updated, então poderá obter uma encomenda.

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

Função GetReport
Lista das línguas disponíveis: ar (Arabic), az (Azerbaijani), bg (búlgaro), cs (Checo), da (Dinamarquesa), de (alemão), el (grego), en (Inglês), es (Espanhol), et (Estónio), fi (finlandês), fr (francês), he (Hebrew), hi (Hindi), hu (húngaro), hy (Armenian), id (indonésio), it (italiano), ja (Japonês), ka (Georgian), kk (Kazakh), ko (coreano), lt (lituano), lv (letão), mn (Mongolian), ms (Malay), nb (Norueguês Bokmål), nl (holandês), pl (Polaco), pt (Português), ro (romeno), ru (Russo), sk (Eslovaco), sl (esloveno), sr (Српски), sv (Sueco), th (Thai), tr (Turco), uk (ucraniano), uz (Uzbek), vi (Vietnamese), zh (Chinês)

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

Função 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))

Função 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))

Função 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))

Função ChkStatus
For offline orders checking order status once every 30 minutes is acceptable frequency.

Os seguintes estados são utilizados para relatórios:

  • Em curso - Relatório na fase de produção
  • Identification pending - A preparação do relatório está em espera. Requer dados adicionais do cliente.
  • Canceled - Ordem cancelada
  • Finished - O relatório está pronto
  • Updated - A informação foi acrescentada ao relatório final
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Ocorreu um erro técnico no nosso sistema. Isto significa que somos informados sobre este erro e que o iremos corrigir o mais rapidamente possível. Será informado quando puder receber a encomenda.

Se o estado de execução for Finished ou Updated, então poderá obter uma encomenda.

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

Função GetReport
Lista das línguas disponíveis: ar (Arabic), az (Azerbaijani), bg (búlgaro), cs (Checo), da (Dinamarquesa), de (alemão), el (grego), en (Inglês), es (Espanhol), et (Estónio), fi (finlandês), fr (francês), he (Hebrew), hi (Hindi), hu (húngaro), hy (Armenian), id (indonésio), it (italiano), ja (Japonês), ka (Georgian), kk (Kazakh), ko (coreano), lt (lituano), lv (letão), mn (Mongolian), ms (Malay), nb (Norueguês Bokmål), nl (holandês), pl (Polaco), pt (Português), ro (romeno), ru (Russo), sk (Eslovaco), sl (esloveno), sr (Српски), sv (Sueco), th (Thai), tr (Turco), uk (ucraniano), uz (Uzbek), vi (Vietnamese), zh (Chinês)

Como pedir um relatório de crédito arquivado?

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

Função 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: Como procurar uma empresa?

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

Função 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.

Como encomendar demonstrações financeiras em linha?

STEP 1: Find a company

Função SimpleSearch

To order an online financial statements, you need to receive "<search_result_id>".
To do so, please follow the link: Como procurar uma empresa?

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: Pesquisa de demonstrações financeiras disponíveis

Função ChkFinance

Esta função só é necessária quando se encomenda um produto: finances (Financial statements) com delivery_term = 'o'.

Lista de países disponíveis: Estónia (EST), Suécia (SWE)

STEP 3: Encomendar demonstrações financeiras

Função 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)

Função 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

Função 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

Função ChkStatus
  • - For online orders checking order status once every 5 seconds is acceptable frequency.

Os seguintes estados são utilizados para relatórios:

  • Em curso - Relatório na fase de produção
  • Identification pending - A preparação do relatório está em espera. Requer dados adicionais do cliente.
  • Canceled - Ordem cancelada
  • Finished - O relatório está pronto
  • Updated - A informação foi acrescentada ao relatório final
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Ocorreu um erro técnico no nosso sistema. Isto significa que somos informados sobre este erro e que o iremos corrigir o mais rapidamente possível. Será informado quando puder receber a encomenda.

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

Função GetReport
Lista das línguas disponíveis: ar (Arabic), az (Azerbaijani), bg (búlgaro), cs (Checo), da (Dinamarquesa), de (alemão), el (grego), en (Inglês), es (Espanhol), et (Estónio), fi (finlandês), fr (francês), he (Hebrew), hi (Hindi), hu (húngaro), hy (Armenian), id (indonésio), it (italiano), ja (Japonês), ka (Georgian), kk (Kazakh), ko (coreano), lt (lituano), lv (letão), mn (Mongolian), ms (Malay), nb (Norueguês Bokmål), nl (holandês), pl (Polaco), pt (Português), ro (romeno), ru (Russo), sk (Eslovaco), sl (esloveno), sr (Српски), sv (Sueco), th (Thai), tr (Turco), uk (ucraniano), uz (Uzbek), vi (Vietnamese), zh (Chinês)
To see the examples of xml request/response, please follow the link: How to get finished order?

Como descarregar relatórios padrão (em formatos diferentes de 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.

O pedido é composto por 3 partes:

  1. Parte fixa https://www.infoproff.com/en/orders/files/
  2. O seu haxixe único, que nós fornecemos em resposta
  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, az, bg, cs, da, de, el, fi, fr, he, hi, hu, hy, id, it, ja, ka, kk, ko, lt, mn, ms, nl, nb, pl, pt, ro, sk, sl, es, sr, sv, th, tr, uk, uz, vi, zh
doc_type: pdf, html, docx, xlsx
currency_position: left, right
preferred_currency: XXX - Original (sem conversão), 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

Como descarregar produtos não normalizados?

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.

O pedido é composto por 3 partes:

  1. Fixed part https://www.infoproff.com/en/orders/files/
  2. O seu haxixe único, que nós fornecemos em resposta
  3. E parte fixa no final /download

Como obter a opinião de crédito?

Função CreditOpinionCalculator

Como obter informações adicionais?

Função GetClassifiersFinancialStatements
Função GetActivityClassificators
Função GetDictionaryStandardPhrases
Função GetAvailableProducts

delivery_term:

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

Possíveis erros

Estes erros podem ocorrer ao fazer o pedido ao nosso serviço web.

Todas as funções
  • Incorrect username/password or you have no permissions.
    Está a introduzir credenciais erradas ou o seu acesso API está bloqueado.
Função SimpleSearch
  1. You don't have permissions to search in this country.
    Lista de países disponíveis: Albânia (ALB), Alemanha (DEU), Angola (AGO), Argentina (ARG), Argélia (DZA), Austrália (AUS), Azerbaijão (AZE), Benim (BEN), Bielorrússia (BLR), Bolívia (BOL), Botsuana (BWA), Brasil (BRA), Bulgária (BGR), Bélgica (BEL), Bósnia e Herzegovina (BIH), Canadá (CAN), Cazaquistão (KAZ), Chile (CHL), China (CHN), Chipre (CYP), Chéquia (CZE), Congo (COG), Costa do Marfim (CIV), Croácia (HRV), Dinamarca (DNK), Equador (ECU), Eslováquia (SVK), Eslovénia (SVN), Espanha (ESP), Estónia (EST), Etiópia (ETH), Filipinas (PHL), Finlândia (FIN), França (FRA), Geórgia (GEO), Gronelândia (GRL), Grécia (GRC), Guadalupe (GLP), Guiana (GUY), Guiana Francesa (GUF), Guiné (GIN), Gâmbia (GMB), Hong Kong (HKG), Hungria (HUN), Irlanda (IRL), Islândia (ISL), Israel (ISR), Itália (ITA), Japão (JPN), Jersey (JEY), Kosovo (XXK), Letónia (LVA), Listenstaine (LIE), Lituânia (LTU), Luxemburgo (LUX), Madagáscar (MDG), Maldivas (MDV), Malta (MLT), Man (IMN), Marrocos (MAR), Martinica (MTQ), Maurícia (MUS), Mayotte (MYT), Moldávia (MDA), Mongólia (MNG), Mónaco (MCO), Namíbia (NAM), Nigéria (NGA), Noruega (NOR), Nova Zelândia (NZL), Paraguai (PRY), Países Baixos (NLD), Peru (PER), Polónia (POL), Portugal (PRT), Quirguistão (KGZ), Quénia (KEN), Reino Unido (GBR), Reunião (REU), Roménia (ROU), Ruanda (RWA), Rússia (RUS), Samoa (WSM), Seychelles (SYC), Singapura (SGP), Sri Lanka (LKA), Suécia (SWE), Suíça (CHE), São Marino (SMR), São Martinho (MAF), Sérvia (SRB), Tailândia (THA), Taiwan (TWN), Tajiquistão (TJK), Tanzânia (TZA), Togo (TGO), Uruguai (URY), Uzbequistão (UZB), Venezuela (VEN), Zimbabué (ZWE), Zâmbia (ZMB), África do Sul (ZAF), Áustria (AUT)
Função Order
  1. This product is not available.
    Tal produto não pode ser encontrado e não é possível encomendar.
  2. You can't order report on company with legal form: "legal_form"
    Este erro só se aplica a: Suécia (SWE)
    Na Suécia não é possível encomendar o relatório online (delivery_term = "o") com as próximas formas legais:
    • 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
    Ao encomendar relatório offline (delivery_term = "n", "f" ou "s") é necessário "Nome da empresa" ou "Reg Code".
  5. Reg Code is required when delivery term is Online
    Ao encomendar o relatório online (delivery_term = "o") "Reg Code" é necessário.
Função GetReport
  1. This language is not supported.
    Lista de línguas disponíveis para relatórios online: ar (Arabic), az (Azerbaijani), bg (búlgaro), cs (Checo), da (Dinamarquesa), de (alemão), el (grego), en (Inglês), es (Espanhol), et (Estónio), fi (finlandês), fr (francês), he (Hebrew), hi (Hindi), hu (húngaro), hy (Armenian), id (indonésio), it (italiano), ja (Japonês), ka (Georgian), kk (Kazakh), ko (coreano), lt (lituano), lv (letão), mn (Mongolian), ms (Malay), nb (Norueguês Bokmål), nl (holandês), pl (Polaco), pt (Português), ro (romeno), ru (Russo), sk (Eslovaco), sl (esloveno), sr (Српски), sv (Sueco), th (Thai), tr (Turco), uk (ucraniano), uz (Uzbek), vi (Vietnamese), zh (Chinês)
Funções GetReport ChkStatus
  1. Incorrect order_id.
    Não é possível encontrar a identificação da encomenda. Obtém-se o ID de encomenda quando se utiliza a função Order.
Função OrderCancellation
  1. Your order is already canceled.
    Já não tem autorização para cancelar a encomenda.
Função OrderConfirmation
  1. You don't have permission to confirm the order anymore. Confirmation can be done within one hour after you recieved 'order_id'.

Alterações do SOAP (Versão 4) em relação ao SOAP (Versão 3)

Novas secções

  • country_economic_overview — inclui as seguintes subseções: data_transparency_index, country_development_indicators, economic_forecast.
  • paid_taxes — informações sobre impostos pagos.
  • tenders — informações sobre concursos.
  • sanctions — adicionado à secção negative_information.

Atualizações nas secções existentes

Nas secções beneficiaries, shareholders, managers e employees_data, foi adicionado o seguinte elemento:
  • source_type — tipo de fonte de dados (por exemplo, official, mass_media, company_admin, etc.).
Na secção relations_of_persons, foi adicionado um novo elemento:
  • match_type
A secção capital foi reestruturada:
  • O elemento « capital_amount » foi renomeado para « issued_capital ».
  • Foram adicionados os seguintes novos elementos:
    • number_of_shares
    • share_value
    • authorized_capital
Na secção « employees_data »:
  • O novo elemento « group_figure » indica se os dados incluem valores agregados ao nível do grupo (true).
  • O elemento source_type especifica o tipo de fonte de dados.
  • O elemento « is_estimated » agora só é incluído se o seu valor for « true ».
Nova secção « assets_data » — consolida secções anteriormente existentes:
  • real_estate_data (anteriormente denominada « property_data »), « vehicles » e « machinery_and_equipment » (anteriormente denominada « assets »).
  • Adições futuras planeadas: patents e biological_assets.
Na secção vehicles, foi adicionado um novo campo:
  • value
Na secção litigations, foram adicionados os seguintes elementos:
  • content, instance, process, authority
Em financial_statement/positions e summary/latest_turnovers, foi adicionado um novo elemento:
  • value_origin — descreve a origem do valor; por exemplo, o valor estimated - este valor é estimado e calculado com base nos dados disponíveis utilizando lógica ou IA.
Na secção branches_data, foram adicionados os seguintes campos:
  • registration_number
  • director_name

Nota: Pequenas melhorias e ajustes ainda podem ocorrer durante a fase de estabilização.

Webhooks Settings

Visão geral

Um webhook é uma forma de uma aplicação fornecer a outras aplicações informações em tempo real. A nossa funcionalidade de webhook implementa chamadas de retorno HTTP configuradas com um URL. Um payload HTTP POST é enviado para este URL em formato JSON sempre que ocorre um evento especificado. No contexto do nosso projeto, concebemos a função webhook para desencadear eventos específicos.

Configurar um Webhook

Para configurar um webhook para a sua aplicação, navegue até à página de definições da aplicação e procure a secção "Definições de webhooks". E forneça as seguintes informações:

  1. O "URL do webhook" é o URL onde o seu servidor receberá os pedidos POST do webhook.
  2. "Máximo de tentativas de entrega" é a definição que define o número máximo de tentativas de repetição que devem ser efectuadas para entregar um evento webhook quando a tentativa de entrega inicial falha.
  3. O "Tempo limite de nova tentativa de entrega" é uma definição que permite especificar o intervalo de tempo entre novas tentativas quando uma tentativa de entrega de um webhook falha.

Depois de fornecer estes dados, clique em "Guardar".

Tipos de eventos Webhook

  1. Novo estatuto da encomenda

Carga do Webhook

Quando ocorre um evento, enviamos um pedido HTTP POST para o URL de carga com um corpo JSON que contém informações sobre o evento.

Aqui está um exemplo de carga útil:
Exemplo de carga útil do novo estatuto da encomenda
Valores possíveis do campo "new_status":
  • "Finished" - uma encomenda está concluída. Uma encomenda pode ser levantada;
  • "Updated" - uma ordem actualizada, dados adicionados a uma ordem concluída;
  • "Canceled" - uma encomenda é cancelada a pedido (ou com o consentimento) de um cliente;
  • "Rejected" - uma encomenda é rejeitada. Geralmente porque é impossível identificar uma empresa.
  • "Identification pending" - Precisamos de mais informações do cliente antes de podermos preparar a encomenda..

Proteger os Webhooks

É importante verificar se os pedidos POST enviados para o URL de carga útil são da nossa aplicação. Para ajudar com isso, cada pedido de webhook inclui um cabeçalho X-Signature.

Descrição da assinatura

Para a assinatura, utilizamos o HMAC com o algoritmo SHA512.

O segredo é uma concatenação da ID da aplicação e da chave secreta das definições dos webhooks.

É possível adicionar os seus próprios parâmetros get ao ponto final para identificar o remetente, se necessário.

Resolução de problemas

Um servidor tem de responder no prazo de 10 segundos e devolver um código HTTP 2XX; caso contrário, a entrega do webhook é considerada falhada. Em caso de falha, a funcionalidade tentará reenviar o pedido de acordo com a política de entrega.