Documentação API Infoproff - v2

Versão de interruptor V2

Começar

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

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

Principais funções do serviço Web:

  • SimpleSearch - Pesquisar informação sobre empresas em diferentes países.
  • Order - Cria um order_id e devolve duplicados. As duplicatas são seleccionadas pelos parâmetros seguintes: country, product, delivery_term and 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: República da Finlândia (FIN), Reino da Suécia (SWE)
  2. Relatórios fora de linha para os seguintes países: Todos os países
  3. Calculadora de opinião de crédito

Como procurar uma empresa?

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

  1. Pesquisa por nome de empresa,
  2. Pesquisa por código de registo.
Lista de países disponíveis: República da Finlândia (FIN), Reino da Suécia (SWE), Reino da Noruega (NOR), Reino da Dinamarca (DNK)
Informação importante:
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

Como encomendar um relatório de crédito?

A ordem desde o registo até à recepção do relatório consiste nas seguintes etapas:

  1. O Utilizador regista uma nova ordem (função "Ordem"). O sistema devolve os detalhes da encomenda, lista de duplicados colocados nos últimos 60 dias e aguarda a confirmação da encomenda.
  2. O Utilizador confirma uma ordem (função "OrderConfirmation"). O sistema envia a encomenda para produção e devolve o estado de produção actual.
  3. O Utilizador verifica o estado da ordem (função "ChkStatus").
  4. Se uma encomenda estiver pronta, então o Utilizador pode descarregar o relatório (função "GetReport").
Lista de países disponíveis: República da Finlândia (FIN), Reino da Suécia (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)

Abaixo pode encontrar o exemplo:

PASSO 1: Relatório de encomenda

Os utilizadores que considerem desnecessária a etapa de confirmação da encomenda podem utilizar o elemento "confirm_order" e passar o valor "TRUE".

Normalmente demora 10-20 segundos a preparar o relatório de crédito em modo online.
Por conseguinte, para relatórios em linha, deve fazer verificações a cada 5 ou mais segundos.

Lista de empresas disponíveis para uma conta teste:

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
Além disso, para relatórios em linha (delivery_term = "o"), pode utilizar amostras geradas para cada país (utilizar: código de registo "00000000"). Estes relatórios são gratuitos e podem ser encomendados utilizando a conta teste.
Função Order
Função OrderCancellation

PASSO 2. Confirmação da encomenda

Função OrderConfirmation

PASSO 3: Verificação do estado

Função ChkStatus

PASSO 4. obter relatório

Lista de línguas disponíveis para relatórios online: en (English), et (Estonian), ru (Russian), de (German)
O Dowload do relatório Online em pdf ainda não está disponível.
Função GetReport

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

  • Em curso - Relatório na fase de produção
  • 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.

Como descarregar o relatório Offline?

Pode descarregar relatórios Offline directamente. Aqui está a instrução de como o deve fazer:

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

Possíveis erros

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

Todas as funções
  • Nome de utilizador/palavra-passe incorreto ou não tem permissões.
    Está a introduzir credenciais erradas ou o seu acesso API está bloqueado.
Função SimpleSearch
  1. Não tem autorização para fazer buscas neste país.
    Lista de países disponíveis: República da Finlândia (FIN), Reino da Suécia (SWE)
Função Order
  1. Este produto não está disponível.
    Tal produto não pode ser encontrado e não é possível encomendar.
  2. Não é possível encomendar um relatório sobre uma empresa com forma jurídica: "legal_form"
    Este erro só se aplica a: Reino da 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. Esta empresa não consta da lista de ensaios.
    O código de registo da empresa não está na nossa lista de teste.
    Lista de empresas disponíveis para uma conta teste:
    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. É necessário o nome da empresa ou o código de registo
    Ao encomendar relatório offline (delivery_term = "n", "f" ou "s") é necessário "Nome da empresa" ou "Reg Code".
  5. O código Reg é necessário quando o prazo de entrega é Online
    Ao encomendar o relatório online (delivery_term = "o") "Reg Code" é necessário.
Função GetReport
  1. Esta língua não é suportada.
    Lista de línguas disponíveis para relatórios online: en (English), et (Estonian), ru (Russian), de (German)
Funções GetReport ChkStatus
  1. Order_id incorreto.
    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. Já não tem autorização para confirmar a encomenda. A confirmação pode ser efectuada no prazo de uma hora após a receção de "order_id".

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

Alterações do SOAP (Versão 3) em relação ao SOAP (Versão 2) [Visão geral]

1) Nova função: ChkFinance

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

2) Função: 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) Função: Order
Identification is required!

Para efetuar uma encomenda em linha, é necessário receber o "search_result_id" da função "SimpleSearch" e só depois disso é possível efetuar uma encomenda em linha (delivery_term = "o").

- Alterações na lista de países disponíveis para relatórios de crédito em linha: Finland (FIN), Sweden (SWE), Belgium (BEL), Netherlands (NLD), Estonia (EST)

- Disponível para descarregar demonstrações financeiras (utilizando o produto: finanças) em modo online: Estonia (EST), Sweden (SWE)

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


Alterações do SOAP (Versão 3) em relação ao SOAP (Versão 2) [WSDL and XSD]

File: report.xsd

Novos elementos:

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

Nova função:

- 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

Novo elemento:

- preferable_finances

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

3) SimpleSearchRequest

Elemento removido:

search_block.reg_code

Novo elemento:

search_block->company_code

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

4) SimpleSearchResponse

Elementos removidos

- code

Novos elementos:

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