Documentación de la API de Infoproff - v3


Cómo empezar


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

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

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)
  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: Confederación Suiza (CHE), Georgia (GEO), Groenlandia (GRL), 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 Federal de Alemania (DEU), República Francesa (FRA), 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 Bielorrusia (BLR), República de Chipre (CYP), República de Estonia (EST), República de Finlandia (FIN), República de Kazajistán (KAZ), República de Moldavia (MDA), República de Polonia (POL), República de Uzbekistán (UZB)
Información importante:

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.

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

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


List of available countries for online credit reports: Reino de Bélgica (BEL), Reino de Suecia (SWE), Reino de los Países Bajos (NLD), República Kirguisa (KGZ), República de Estonia (EST), República de Finlandia (FIN), República de Kazajistán (KAZ), 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
  • 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: 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), 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), sv (Sueco), tr (Turco), uk (Ucraniano), 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
  • 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: 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), 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), sv (Sueco), tr (Turco), uk (Ucraniano), zh (Chino)

¿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
  • 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: 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), 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), sv (Sueco), tr (Turco), uk (Ucraniano), 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, bg, cs, da, de, el, fi, fr, hu, id, it, ja, ko, lt, nl, nb, pl, pt, ro, sk, sl, es, sv, tr, uk, 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: Confederación Suiza (CHE), Georgia (GEO), Groenlandia (GRL), 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 Federal de Alemania (DEU), República Francesa (FRA), 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 Bielorrusia (BLR), República de Chipre (CYP), República de Estonia (EST), República de Finlandia (FIN), República de Kazajistán (KAZ), República de Moldavia (MDA), República de Polonia (POL), República de Uzbekistán (UZB)
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: 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), 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), sv (Sueco), tr (Turco), uk (Ucraniano), 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 de SOAP (versión 3) en comparación con SOAP (versión 2)


Cambios de SOAP (versión 3) en comparación con SOAP (versión 2) [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: Confederación Suiza (CHE), Georgia (GEO), Groenlandia (GRL), 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 Federal de Alemania (DEU), República Francesa (FRA), 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 Bielorrusia (BLR), República de Chipre (CYP), República de Estonia (EST), República de Finlandia (FIN), República de Kazajistán (KAZ), República de Moldavia (MDA), República de Polonia (POL), República de Uzbekistán (UZB)

- 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: Reino de Bélgica (BEL), Reino de Suecia (SWE), Reino de los Países Bajos (NLD), República Kirguisa (KGZ), República de Estonia (EST), República de Finlandia (FIN), República de Kazajistán (KAZ), República de Polonia (POL)

- Available to download financial statements (using product: finances) in online mode: Estonia (EST), Sweden (SWE)

3) Function: GetReport

- Changes in of available languages: 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), 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), sv (Sueco), tr (Turco), uk (Ucraniano), zh (Chino)


Cambios de SOAP (versión 3) en comparación con SOAP (versión 2) [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

Nuevos elementos:

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

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.

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.