Documentación de la API de Infoproff - v4

Versión para Switch V4

Cómo empezar

El servicio web wsdl y los esquemas se encuentran aquí:

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 - Buscar información sobre empresas en diferentes países.
  • ChkFinance - Búsqueda de estados financieros disponibles.
  • Order - Crea un order_id y devuelve los duplicados. Los duplicados se seleccionan mediante los siguientes parámetros: country, product, reg_code.
  • OrderCancellation - Si ha enviado una solicitud de pedido y ha recibido el order_id, tiene la oportunidad de cancelar este pedido (si no ha entrado en producción).
  • OrderConfirmation - Después de recibir order_id tendrá que confirmar su pedido en el plazo de 1 hora. Si no confirma su pedido en el plazo de 1 hora, el pedido se cancelará automáticamente.
  • ChkStatus - Compruebe el estado del pedido.
  • GetReport - Obtenga informes terminados.
  • GetClassifiersFinancialStatements - Obtener todos los documentos financieros con todos los elementos: row_number, row_formated_description, row_lang_key y row_order.
  • GetLegalForms - Obtenga todos los formularios legales para todos los países disponibles.
  • GetActivityClassificators - Obtenga todos los códigos y descripciones para el clasificador de actividades específico.
  • GetDictionaryStandardPhrases - Obtenga todas las frases estándar con claves y lenguaje.
  • GetAvailableProducts - Obtenga una lista de productos disponibles.
  • CreditOpinionCalculator - La calculadora de opinión crediticia ayuda a asignar la opinión crediticia de una empresa.

La API ofrece varios servicios:

  1. Informes de crédito en línea para los siguientes países: República de Finlandia (FIN), Reino de Suecia (SWE), Reino de Bélgica (BEL), Reino de los Países Bajos (NLD), República de Estonia (EST), República de Kazajistán (KAZ), República de Polonia (POL), República Kirguisa (KGZ), República Popular de China (CHN), Mongolia (MNG)
  2. Informes fuera de línea para los siguientes países: Todos los países
  3. Calculadora de opinión de crédito

¿Cómo buscar una empresa?

La búsqueda de empresas consta de 2 opciones:

  1. Búsqueda por nombre de empresa,
  2. Search by company code.
Lista de países disponibles: Bosnia y Herzegovina (BIH), Canadá (CAN), Colectividad de San Martín (MAF), Commonwealth de Australia (AUS), Confederación Suiza (CHE), Costa de Marfil (CIV), Estado Plurinacional de Bolivia (BOL), Estado de Israel (ISR), Estado independiente de Samoa (WSM), Federación de Rusia (RUS), Georgia (GEO), Gran Ducado de Luxemburgo (LUX), Groenlandia (GRL), Guadalupe (GLP), Guayana Francesa (GUF), Hong Kong (HKG), Irlanda (IRL), Isla de Man (IMN), Japón (JPN), Kosovo (XXK), La Bailía de Jersey (JEY), Martinica (MTQ), Mayotte (MYT), Mongolia (MNG), Nueva Zelanda (NZL), Principado de Liechtenstein (LIE), Principado de Mónaco (MCO), Reino Unido de Gran Bretaña e Irlanda del Norte (GBR), Reino de Bélgica (BEL), Reino de Dinamarca (DNK), Reino de España (ESP), Reino de Marruecos (MAR), Reino de Noruega (NOR), Reino de Suecia (SWE), Reino de Tailandia (THA), Reino de los Países Bajos (NLD), República Argentina (ARG), República Bolivariana de Venezuela (VEN), República Checa (CZE), República Cooperativa de Guyana (GUY), República Democrática Federal de Etiopía (ETH), República Democrática Popular de Argelia (DZA), República Eslovaca (SVK), República Federal de Alemania (DEU), República Federal de Nigeria (NGA), República Federativa de Brasil (BRA), República Francesa (FRA), República Helénica (GRC), República Italiana (ITA), República Kirguisa (KGZ), República Oriental del Uruguay (URY), República Popular de China (CHN), República Portuguesa (PRT), República Socialista Democrática de Sri Lanka (LKA), República Togolesa (TGO), República Unida de Tanzania (TZA), República de Albania (ALB), República de Angola (AGO), República de Austria (AUT), República de Azerbaiyán (AZE), República de Benín (BEN), República de Bielorrusia (BLR), República de Botsuana (BWA), República de Bulgaria (BGR), República de Chile (CHL), República de China (TWN), República de Chipre (CYP), República de Croacia (HRV), República de Ecuador (ECU), República de Eslovenia (SVN), República de Estonia (EST), República de Filipinas (PHL), República de Finlandia (FIN), República de Gambia (GMB), República de Guinea (GIN), República de Hungría (HUN), República de Islandia (ISL), República de Kazajistán (KAZ), República de Kenia (KEN), República de Letonia (LVA), República de Lituania (LTU), República de Madagascar (MDG), República de Maldivas (MDV), República de Malta (MLT), República de Mauricio (MUS), República de Moldavia (MDA), República de Namibia (NAM), República de Perú (PER), República de Polonia (POL), República de Ruanda (RWA), República de San Marino (SMR), República de Serbia (SRB), República de Seychelles (SYC), República de Singapur (SGP), República de Sudáfrica (ZAF), República de Tayikistán (TJK), República de Uzbekistán (UZB), República de Zambia (ZMB), República de Zimbabue (ZWE), República del Congo (COG), República del Paraguay (PRY), Reunión (REU), Rumanía (ROU)

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.

Información 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.

El registro de Noruega no permite buscar empresas eliminadas por nombres. Por lo tanto, no podemos proporcionar un SimpleSearch por nombres dentro de las empresas eliminadas en Noruega.

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

A continuación puede encontrar el ejemplo:

Función SimpleSearch

Opción 2: Búsqueda por código de registro

Función SimpleSearch

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

Función UnifiedSearch

¿Cómo pedir un informe de crédito?

List of available countries for online credit reports: Confederación Suiza (CHE), Federación de Rusia (RUS), Gran Ducado de Luxemburgo (LUX), Irlanda (IRL), Mongolia (MNG), Reino Unido de Gran Bretaña e Irlanda del Norte (GBR), Reino de Bélgica (BEL), Reino de Dinamarca (DNK), Reino de España (ESP), Reino de Noruega (NOR), Reino de Suecia (SWE), Reino de los Países Bajos (NLD), República Checa (CZE), República Eslovaca (SVK), República Federal de Alemania (DEU), República Francesa (FRA), República Helénica (GRC), República Italiana (ITA), República Kirguisa (KGZ), República Popular de China (CHN), República Portuguesa (PRT), República de Austria (AUT), República de Azerbaiyán (AZE), República de Bulgaria (BGR), República de Croacia (HRV), República de Eslovenia (SVN), República de Estonia (EST), República de Finlandia (FIN), República de Hungría (HUN), República de Kazajistán (KAZ), República de Letonia (LVA), República de Malta (MLT), República de Moldavia (MDA), República de Polonia (POL)
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))

Función SimpleSearch

To order an Online/Offline with identification report you need to receive "<search_result_id>".
To do so, please follow the link: ¿Cómo buscar una 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))

Función 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))

Función 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))

Función 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))

Función 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.

En los informes se utilizan los siguientes estados:

  • En curso - Informe en la fase de producción
  • Identification pending - Preparación del informe en espera. Requiere datos adicionales del cliente.
  • Canceled - Pedido cancelado
  • Finished - El informe está listo
  • Updated - Se ha añadido información al informe final
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Se ha producido un error técnico en nuestro sistema. Esto significa que estamos informados de este error y lo solucionaremos lo antes posible. Se le informará cuando pueda recibir el pedido.

Si el estado de ejecución es Finished o Updated, entonces puede obtener una orden.

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

Función GetReport
Lista de idiomas disponibles: ar (Arabic), bg (Búlgaro), cs (Checa), da (Danés), de (Alemán), el (Griego), en (Inglés), es (Español), et (Estonio), fi (En finés), fr (Francés), he (Hebrew), hu (Húngaro), id (Indonesia), it (Italiano), ja (Japonés), ko (Coreano), lt (Lituania), lv (Letón), nb (Noruego Bokmål), nl (Holandés), pl (Polaco), pt (Portugués), ro (Rumano), ru (Ruso), sk (Eslovaquia), sl (Eslovenia), sr (Српски), sv (Sueco), th (Thai), tr (Turco), uk (Ucraniano), vi (Vietnamese), zh (Chino)

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

Función 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))

Función 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))

Función 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))

Función ChkStatus
For offline orders checking order status once every 30 minutes is acceptable frequency.

En los informes se utilizan los siguientes estados:

  • En curso - Informe en la fase de producción
  • Identification pending - Preparación del informe en espera. Requiere datos adicionales del cliente.
  • Canceled - Pedido cancelado
  • Finished - El informe está listo
  • Updated - Se ha añadido información al informe final
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Se ha producido un error técnico en nuestro sistema. Esto significa que estamos informados de este error y lo solucionaremos lo antes posible. Se le informará cuando pueda recibir el pedido.

Si el estado de ejecución es Finished o Updated, entonces puede obtener una orden.

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

Función GetReport
Lista de idiomas disponibles: ar (Arabic), bg (Búlgaro), cs (Checa), da (Danés), de (Alemán), el (Griego), en (Inglés), es (Español), et (Estonio), fi (En finés), fr (Francés), he (Hebrew), hu (Húngaro), id (Indonesia), it (Italiano), ja (Japonés), ko (Coreano), lt (Lituania), lv (Letón), nb (Noruego Bokmål), nl (Holandés), pl (Polaco), pt (Portugués), ro (Rumano), ru (Ruso), sk (Eslovaquia), sl (Eslovenia), sr (Српски), sv (Sueco), th (Thai), tr (Turco), uk (Ucraniano), vi (Vietnamese), zh (Chino)

¿Cómo solicitar un informe de crédito archivado?

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

Función 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: ¿Cómo buscar una 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

Función 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.

¿Cómo pedir estados financieros en línea?

STEP 1: Find a company

Función SimpleSearch

To order an online financial statements, you need to receive "<search_result_id>".
To do so, please follow the link: ¿Cómo buscar una 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: Búsqueda de estados financieros disponibles

Función ChkFinance

Esta función sólo es necesaria cuando se pide un producto: finances (Financial statements) con delivery_term = 'o'.

Lista de países disponibles: República de Estonia (EST), Reino de Suecia (SWE)

STEP 3: Pedir estados financieros

Función 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)

Función 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

Función 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

Función ChkStatus
  • - For online orders checking order status once every 5 seconds is acceptable frequency.

En los informes se utilizan los siguientes estados:

  • En curso - Informe en la fase de producción
  • Identification pending - Preparación del informe en espera. Requiere datos adicionales del cliente.
  • Canceled - Pedido cancelado
  • Finished - El informe está listo
  • Updated - Se ha añadido información al informe final
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Se ha producido un error técnico en nuestro sistema. Esto significa que estamos informados de este error y lo solucionaremos lo antes posible. Se le informará cuando pueda recibir el pedido.

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

Función GetReport
Lista de idiomas disponibles: ar (Arabic), bg (Búlgaro), cs (Checa), da (Danés), de (Alemán), el (Griego), en (Inglés), es (Español), et (Estonio), fi (En finés), fr (Francés), he (Hebrew), hu (Húngaro), id (Indonesia), it (Italiano), ja (Japonés), ko (Coreano), lt (Lituania), lv (Letón), nb (Noruego Bokmål), nl (Holandés), pl (Polaco), pt (Portugués), ro (Rumano), ru (Ruso), sk (Eslovaquia), sl (Eslovenia), sr (Српски), sv (Sueco), th (Thai), tr (Turco), uk (Ucraniano), vi (Vietnamese), zh (Chino)
To see the examples of xml request/response, please follow the link: How to get finished order?

¿Cómo se descargan los informes estándar (en formatos distintos del 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.

La solicitud consta de 3 partes:

  1. Parte fija https://www.infoproff.com/en/orders/files/
  2. Su hash único, que proporcionamos como respuesta
  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 (sin cambio), 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

¿Cómo descargar productos no estándar?

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.

La solicitud consta de 3 partes:

  1. Fixed part https://www.infoproff.com/en/orders/files/
  2. Su hash único, que proporcionamos como respuesta
  3. Y la parte fija al final /download

¿Cómo obtener un dictamen de crédito?

Función CreditOpinionCalculator

¿Cómo obtener información adicional?

Función GetClassifiersFinancialStatements
Función GetActivityClassificators
Función GetDictionaryStandardPhrases
Función GetAvailableProducts

delivery_term:

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

Posibles errores

Estos errores pueden producirse al realizar una solicitud a nuestro servicio web.

Todas las funciones
  • Incorrect username/password or you have no permissions.
    Está introduciendo credenciales incorrectas o su acceso a la API está bloqueado.
Función SimpleSearch
  1. You don't have permissions to search in this country.
    Lista de países disponibles: Bosnia y Herzegovina (BIH), Canadá (CAN), Colectividad de San Martín (MAF), Commonwealth de Australia (AUS), Confederación Suiza (CHE), Costa de Marfil (CIV), Estado Plurinacional de Bolivia (BOL), Estado de Israel (ISR), Estado independiente de Samoa (WSM), Federación de Rusia (RUS), Georgia (GEO), Gran Ducado de Luxemburgo (LUX), Groenlandia (GRL), Guadalupe (GLP), Guayana Francesa (GUF), Hong Kong (HKG), Irlanda (IRL), Isla de Man (IMN), Japón (JPN), Kosovo (XXK), La Bailía de Jersey (JEY), Martinica (MTQ), Mayotte (MYT), Mongolia (MNG), Nueva Zelanda (NZL), Principado de Liechtenstein (LIE), Principado de Mónaco (MCO), Reino Unido de Gran Bretaña e Irlanda del Norte (GBR), Reino de Bélgica (BEL), Reino de Dinamarca (DNK), Reino de España (ESP), Reino de Marruecos (MAR), Reino de Noruega (NOR), Reino de Suecia (SWE), Reino de Tailandia (THA), Reino de los Países Bajos (NLD), República Argentina (ARG), República Bolivariana de Venezuela (VEN), República Checa (CZE), República Cooperativa de Guyana (GUY), República Democrática Federal de Etiopía (ETH), República Democrática Popular de Argelia (DZA), República Eslovaca (SVK), República Federal de Alemania (DEU), República Federal de Nigeria (NGA), República Federativa de Brasil (BRA), República Francesa (FRA), República Helénica (GRC), República Italiana (ITA), República Kirguisa (KGZ), República Oriental del Uruguay (URY), República Popular de China (CHN), República Portuguesa (PRT), República Socialista Democrática de Sri Lanka (LKA), República Togolesa (TGO), República Unida de Tanzania (TZA), República de Albania (ALB), República de Angola (AGO), República de Austria (AUT), República de Azerbaiyán (AZE), República de Benín (BEN), República de Bielorrusia (BLR), República de Botsuana (BWA), República de Bulgaria (BGR), República de Chile (CHL), República de China (TWN), República de Chipre (CYP), República de Croacia (HRV), República de Ecuador (ECU), República de Eslovenia (SVN), República de Estonia (EST), República de Filipinas (PHL), República de Finlandia (FIN), República de Gambia (GMB), República de Guinea (GIN), República de Hungría (HUN), República de Islandia (ISL), República de Kazajistán (KAZ), República de Kenia (KEN), República de Letonia (LVA), República de Lituania (LTU), República de Madagascar (MDG), República de Maldivas (MDV), República de Malta (MLT), República de Mauricio (MUS), República de Moldavia (MDA), República de Namibia (NAM), República de Perú (PER), República de Polonia (POL), República de Ruanda (RWA), República de San Marino (SMR), República de Serbia (SRB), República de Seychelles (SYC), República de Singapur (SGP), República de Sudáfrica (ZAF), República de Tayikistán (TJK), República de Uzbekistán (UZB), República de Zambia (ZMB), República de Zimbabue (ZWE), República del Congo (COG), República del Paraguay (PRY), Reunión (REU), Rumanía (ROU)
Función Order
  1. This product is not available.
    Este producto no se puede encontrar y no es posible pedirlo.
  2. You can't order report on company with legal form: "legal_form"
    Este error sólo se aplica a: Reino de Suecia (SWE)
    En Suecia no es posible pedir el informe en línea (delivery_term = "o") con los siguientes formularios legales:
    • 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
    Cuando se pide un informe fuera de línea (delivery_term = "n", "f" o "s") se requiere "Nombre de la empresa" o "Código de registro".
  5. Reg Code is required when delivery term is Online
    Al pedir el informe en línea (delivery_term = "o") se requiere el "Código Reg".
Función GetReport
  1. This language is not supported.
    Lista de idiomas disponibles para los informes en línea: ar (Arabic), bg (Búlgaro), cs (Checa), da (Danés), de (Alemán), el (Griego), en (Inglés), es (Español), et (Estonio), fi (En finés), fr (Francés), he (Hebrew), hu (Húngaro), id (Indonesia), it (Italiano), ja (Japonés), ko (Coreano), lt (Lituania), lv (Letón), nb (Noruego Bokmål), nl (Holandés), pl (Polaco), pt (Portugués), ro (Rumano), ru (Ruso), sk (Eslovaquia), sl (Eslovenia), sr (Српски), sv (Sueco), th (Thai), tr (Turco), uk (Ucraniano), vi (Vietnamese), zh (Chino)
Funciones GetReport ChkStatus
  1. Incorrect order_id.
    No se puede encontrar el ID del pedido. Se obtiene el ID del pedido cuando se utiliza la función Order.
Función OrderCancellation
  1. Your order is already canceled.
    Ya no tienes permiso para cancelar el pedido.
Función OrderConfirmation
  1. You don't have permission to confirm the order anymore. Confirmation can be done within one hour after you recieved 'order_id'.

Cambios en SOAP (versión 4) con respecto a SOAP (versión 3)

Nuevas secciones

  • country_economic_overview — incluye las siguientes subsecciones: data_transparency_index, country_development_indicators, economic_forecast.
  • paid_taxes — información sobre los impuestos pagados.
  • tenders — Información sobre licitaciones.
  • sanctions — añadido a la sección « negative_information ».

Actualizaciones de secciones existentes

En las secciones beneficiaries, shareholders, managers y employees_data, se ha añadido el siguiente elemento:
  • source_type — tipo de fuente de datos (por ejemplo, official, mass_media, company_admin, etc.).
En la sección relations_of_persons, se ha añadido un nuevo elemento:
  • match_type
Se ha reestructurado la sección capital:
  • El elemento « capital_amount » ha pasado a denominarse « issued_capital ».
  • Se han añadido los siguientes elementos nuevos:
    • number_of_shares
    • share_value
    • authorized_capital
En la sección « employees_data »:
  • El nuevo elemento « group_figure » indica si los datos incluyen cifras agregadas a nivel de grupo (true).
  • El elemento source_type especifica el tipo de fuente de datos.
  • El elemento « is_estimated » ahora solo se incluye si su valor es « true ».
Nueva sección « assets_data »: consolida las secciones que existían anteriormente:
  • real_estate_data (anteriormente denominada « property_data »), « vehicles » y « machinery_and_equipment » (anteriormente denominada « assets »).
  • Futuras incorporaciones previstas: patents y biological_assets.
En la sección vehicles, se ha añadido un nuevo campo:
  • value
En la sección litigations, se han añadido los siguientes elementos:
  • content, instance, process, authority
En financial_statement/positions y summary/latest_turnovers, se ha añadido un nuevo elemento:
  • value_origin — describe el origen del valor; por ejemplo, el valor estimated: este valor se estima y calcula a partir de los datos disponibles utilizando lógica o IA.
En la sección branches_data, se han añadido los siguientes campos:
  • registration_number
  • director_name

Nota: Es posible que se produzcan pequeñas mejoras y ajustes durante la fase de estabilización.

Webhooks Settings

Visión general

Un webhook es una forma de que una aplicación proporcione a otras aplicaciones información en tiempo real. Nuestra función de webhook implementa devoluciones de llamada HTTP configuradas con una URL. Una carga HTTP POST se envía a esta URL en formato JSON cada vez que se produce un evento especificado. En el contexto de nuestro proyecto, hemos diseñado la función webhook para desencadenar eventos específicos.

Configuración de un Webhook

Para configurar un webhook para su aplicación, vaya a la página de configuración de la aplicación y busque la sección 'Configuración de Webhooks'. Y proporcione la siguiente información:

  1. "Webhook URL" es la URL donde tu servidor recibirá las peticiones POST de webhook.
  2. "Intentos máximos de entrega" es el ajuste que define el número máximo de intentos de reintento que se deben realizar para entregar un evento webhook cuando falla el intento de entrega inicial.
  3. "Delivery retry timeout" es un ajuste que permite especificar el intervalo de tiempo entre reintentos cuando falla un intento de entrega de un webhook.

Después de proporcionar estos datos, haga clic en "Guardar".

Tipos de eventos Webhook

  1. Nuevo estado del pedido

Carga útil del webhook

Cuando se produzca un evento, enviaremos una solicitud HTTP POST a la URL de carga útil con un cuerpo JSON que contenga información sobre el evento.

He aquí un ejemplo de carga útil:
Ejemplo de carga útil del nuevo estado del pedido
Valores posibles del campo "new_status":
  • "Finished" - un pedido está completo. Se puede recoger un pedido;
  • "Updated" - un pedido actualizado, datos añadidos a un pedido finalizado;
  • "Canceled" - se cancela un pedido a petición del cliente (o con su consentimiento);
  • "Rejected" - se rechaza un pedido. Normalmente porque es imposible identificar a una empresa.
  • "Identification pending" - Necesitamos más información del cliente antes de poder preparar un pedido..

Protección de los Webhooks

Es importante verificar que las peticiones POST enviadas a la URL de carga útil proceden de nuestra aplicación. Para ello, cada solicitud de webhook incluye una cabecera X-Signature.

Descripción de la firma

Para la firma utilizamos HMAC con el algoritmo SHA512.

Secret es una concatenación de App ID y Secret Key de la configuración de webhooks.

Es posible añadir sus propios parámetros get al endpoint para identificar al remitente si es necesario.

Solución de problemas

Un servidor debe responder en 10 segundos y devolver un código HTTP 2XX; de lo contrario, la entrega del webhook se considera fallida. En caso de fallo, la función intentará reenviar la solicitud de acuerdo con la política de entrega.