Documentación de la API de Infoproff - v2

Versión para Switch V2

Cómo empezar

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

http://wsdfn.infoproff.com/v2/

Funciones principales del servicio web:

  • SimpleSearch - Buscar información sobre empresas en diferentes países.
  • Order - Crea un order_id y devuelve los duplicados. Los duplicados se seleccionan mediante los siguientes parámetros: country, product, delivery_term and 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)
  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. Búsqueda por código de registro.
Lista de países disponibles: República de Finlandia (FIN), Reino de Suecia (SWE), Reino de Noruega (NOR), Reino de Dinamarca (DNK)
Información importante:
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?

El orden desde el registro hasta la recepción del informe consta de estos pasos:

  1. El usuario registra un nuevo pedido (función "Pedido"). El sistema devuelve los detalles del pedido, la lista de duplicados realizados en los últimos 60 días y espera la confirmación del pedido.
  2. El usuario confirma un pedido (función "OrderConfirmation"). El sistema envía el pedido a producción y devuelve el estado actual de producción.
  3. El usuario comprueba el estado del pedido (función "ChkStatus").
  4. Si el pedido está listo, el usuario puede descargar el informe (función "GetReport").
Lista de países disponibles: República de Finlandia (FIN), Reino de Suecia (SWE)
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)

A continuación puede encontrar el ejemplo:

PASO 1: Pedir el informe

Los usuarios que consideren innecesario el paso de confirmación del pedido pueden utilizar el elemento "confirm_order" y pasar el valor "TRUE".

Normalmente se tarda entre 10 y 20 segundos en preparar el informe de crédito en modo online.
Por lo tanto, para los informes en línea, debe hacer comprobaciones cada 5 o más segundos.

Lista de empresas disponibles para una cuenta de prueba:

01120389 FIN, 01163231 FIN, 01332146 FIN, 01795458 FIN, 02245466 FIN, 07640633 FIN, 08481566 FIN, 08607931 FIN, 09484603 FIN, 09488655 FIN, 16366779 FIN, 16433070 FIN, 16457849 FIN, 16564505 FIN, 19148611 FIN, 20453920 FIN, 20453947 FIN, 26513621 FIN, 27019879 FIN, 27240442 FIN, 27330384 FIN, 27748684 FIN, 28725388 FIN, 29048796 FIN, 5560117482 SWE, 5564294089 SWE, 5566436035 SWE, 5569760464 SWE
Además, para los informes en línea (delivery_term = "o"), puede utilizar las muestras generadas para cada país (utilice: código de registro "00000000"). Estos informes son gratuitos y pueden solicitarse mediante una cuenta de prueba.
Función Order
Función OrderCancellation

PASO 2. Confirmación del pedido

Función OrderConfirmation

PASO 3. Comprobación del estado

Función ChkStatus

PASO 4. Obtener el informe

Lista de idiomas disponibles para los informes en línea: en (English), et (Estonian), ru (Russian), de (German)
La descarga del informe en línea en pdf aún no está disponible.
Función GetReport

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.

¿Cómo descargar el informe sin conexión?

Puede descargar directamente los informes sin conexión. Aquí están las instrucciones para hacerlo:

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

Posibles errores

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

Todas las funciones
  • Nombre de usuario/contraseña incorrectos o no tienes permisos.
    Está introduciendo credenciales incorrectas o su acceso a la API está bloqueado.
Función SimpleSearch
  1. No tiene permisos para registrar en este país.
    Lista de países disponibles: República de Finlandia (FIN), Reino de Suecia (SWE)
Función Order
  1. Este producto no está disponible.
    Este producto no se puede encontrar y no es posible pedirlo.
  2. No se puede pedir informe sobre empresa con forma jurídica: "forma_legal"
    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. Esta empresa no figura en la lista de pruebas.
    La sociedad no está en nuestra lista de pruebas.
    Lista de empresas disponibles para una cuenta de prueba:
    01120389 FIN, 01163231 FIN, 01332146 FIN, 01795458 FIN, 02245466 FIN, 07640633 FIN, 08481566 FIN, 08607931 FIN, 09484603 FIN, 09488655 FIN, 16366779 FIN, 16433070 FIN, 16457849 FIN, 16564505 FIN, 19148611 FIN, 20453920 FIN, 20453947 FIN, 26513621 FIN, 27019879 FIN, 27240442 FIN, 27330384 FIN, 27748684 FIN, 28725388 FIN, 29048796 FIN, 5560117482 SWE, 5564294089 SWE, 5566436035 SWE, 5569760464 SWE
  4. Se requiere el nombre de la empresa o el código de registro
    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. El código de registro es necesario cuando el plazo de entrega es en línea
    Al pedir el informe en línea (delivery_term = "o") se requiere el "Código Reg".
Función GetReport
  1. Este idioma no es compatible.
    Lista de idiomas disponibles para los informes en línea: en (English), et (Estonian), ru (Russian), de (German)
Funciones GetReport ChkStatus
  1. Order_id incorrecto.
    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. Ya no tienes permiso para confirmar el pedido. La confirmación puede realizarse en el plazo de una hora tras recibir '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) [Visión general]

1) Nueva función: ChkFinance

Allows you to search for available financial statements.
Currently available only in EST (Estonia), SWE (Sweden)

2) Función: SimpleSearch

- Changes in list of available countries: Finland (FIN), Sweden (SWE), Norway (NOR), Denmark (DNK), Belgium (BEL), Estonia (EST), Netherlands (NLD), United Kingdom (GBR), Ireland (IRL), France (FRA), Spain (ESP), Portugal (PRT), Germany (DEU), Italy (ITA), Austria (AUT), Switzerland (CHE), Cyprus (CYP)

- 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) Función: Order
Identification is required!

Para realizar un pedido en línea, necesita recibir 'search_result_id' de la función 'SimpleSearch', y sólo después de eso puede realizar un pedido en línea (delivery_term = 'o').

- Cambios en la lista de países disponibles para los informes de crédito en línea: Finland (FIN), Sweden (SWE), Belgium (BEL), Netherlands (NLD), Estonia (EST)

- Disponible para descargar estados financieros (utilizando el producto: finanzas) en modo online: Estonia (EST), Sweden (SWE)

3) Función: GetReport

- Changes in of available languages: en (English), et (Estonian), ru (Russian), de (German), zh (Chinese), ja (Japanese), bg (Bulgarian), cs (Czech), da (Danish), el (Greek), fi (Finnish), fr (French), hu (Hungarian), it (Italian), lv (Latvian), lt (Lithuanian), nl (Dutch), pl (Polish), pt (Portuguese), ro (Romanian), sk (Slovak), sl (Slovenian), es (Spanish), sv (Swedish)


Cambios de SOAP (versión 3) en comparación con SOAP (versión 2) [WSDL and XSD]

File: report.xsd

Nuevos elementos:

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

Nueva función:

- 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

Nuevo elemento:

- preferable_finances

NB: This element is required only ordering a product: finances (Financial statements) with delivery_term = 'o'.

3) SimpleSearchRequest

Elemento eliminado:

search_block.reg_code

Nuevo elemento:

search_block->company_code

NB: in some countries we allow to search companies by vat_code.

4) SimpleSearchResponse

Elementos eliminados

- code

Nuevos elementos:

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