Documentația API Infoproff - v2


Noțiuni introductive


Serviciul web wsdl și schemele sunt localizate aici:

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

Funcțiile principale ale serviciului web:

  • SimpleSearch - Căutați informații despre companii din diferite țări.
  • Order - Creează un order_id și returnează duplicatele. Dublurile sunt selectate după următorii parametri: country, product, delivery_term and reg_code.
  • OrderCancellation - Dacă ați trimis o cerere de comandă și ați primit order_id, aveți posibilitatea de a anula această comandă (dacă nu a intrat în producție).
  • OrderConfirmation - După ce ați primit order_id, va trebui să confirmați comanda în termen de 1 oră. Dacă nu confirmați comanda în termen de 1 oră, aceasta va fi anulată automat.
  • ChkStatus - Verificați starea comenzii.
  • GetReport - Obțineți rapoarte finalizate.
  • GetClassifiersFinancialStatements - Obține toate documentele financiare cu toate elementele: row_number, row_formated_description, row_lang_key și row_order.
  • GetLegalForms - Obțineți toate formularele juridice pentru toate țările disponibile.
  • GetActivityClassificators - Obțineți toate codurile și descrierile pentru un anumit clasificator de activități.
  • GetDictionaryStandardPhrases - Obțineți toate frazele standard cu chei și limbă.
  • GetAvailableProducts - Obțineți o listă de produse disponibile.
  • CreditOpinionCalculator - Calculatorul de opinie de credit ajută la atribuirea opiniei de credit pentru o companie.

API oferă mai multe servicii:

  1. Rapoarte de credit online pentru următoarele țări: Republica Finlanda (FIN), Regatul Suediei (SWE)
  2. Rapoarte offline pentru următoarele țări: Toate țările
  3. Calculator de opinie de credit

Cum să căutați o companie?


Căutarea companiei constă în 2 opțiuni:

  1. Căutare după numele companiei,
  2. Căutare după codul de înregistrare.
Lista țărilor disponibile: Republica Finlanda (FIN), Regatul Suediei (SWE), Regatul Norvegiei (NOR), Regatul Danemarcei (DNK)
Informații importante:
Registrul norvegian nu permite căutarea după nume a societăților șterse. Prin urmare, nu putem oferi SimpleSearch după nume în cadrul societăților șterse din Norvegia.
Field's length:
company_name varchar(512)
company_code varchar(64)

Mai jos puteți găsi un exemplu:


Funcția SimpleSearch

Opțiunea 2: Căutați după codul de înregistrare

Funcția SimpleSearch

Cum să comandați un raport de credit?


Ordinea de la înregistrare până la primirea raportului constă în următoarele etape:

  1. Utilizatorul înregistrează o nouă comandă (funcția "Comandă"). Sistemul returnează detaliile comenzii, lista de duplicate plasate în ultimele 60 de zile și așteaptă confirmarea comenzii.
  2. Utilizatorul confirmă o comandă (funcția "OrderConfirmation"). Sistemul trimite comanda spre producție și returnează starea actuală a producției.
  3. Utilizatorul verifică starea comenzii (funcția "ChkStatus").
  4. Dacă o comandă este gata, atunci utilizatorul poate descărca raportul (funcția "GetReport").
Lista țărilor disponibile: Republica Finlanda (FIN), Regatul Suediei (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)

Mai jos puteți găsi un exemplu:


PASUL 1: Comandați raportul

Utilizatorii care consideră că etapa de confirmare a comenzii nu este necesară pot utiliza elementul "confirm_order" și pot transmite valoarea "TRUE".

De obicei, pregătirea raportului de credit în modul online durează 10-20 de secunde.
Prin urmare, pentru rapoartele online, ar trebui să faceți verificări la fiecare 5 sau mai multe secunde.

Lista companiilor disponibile pentru un cont de test:

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
În plus, pentru rapoartele online (delivery_term = "o"), puteți utiliza eșantioane generate pentru fiecare țară (utilizați: codul de înregistrare "00000000"). Aceste rapoarte sunt gratuite și pot fi comandate utilizând contul de testare.
Funcția Order

Funcția OrderCancellation

PASUL 2. Confirmarea comenzii

Funcția OrderConfirmation

PASUL 3. Verificarea stării

Funcția ChkStatus

PASUL 4. Obțineți raportul

Lista limbilor disponibile pentru rapoartele online: en (English), et (Estonian), ru (Russian), de (German)
Descărcarea raportului online în format pdf nu este încă disponibilă.
Funcția GetReport

Următoarele stări sunt utilizate pentru rapoarte:

  • În curs de desfășurare - Raport în faza de producție
  • Canceled - Comandă anulată
  • Finished - Raportul este gata
  • Updated - Au fost adăugate informații la raportul final
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - A apărut o eroare tehnică în sistemul nostru. Aceasta înseamnă că suntem informați despre această eroare și o vom remedia cât mai curând posibil. Veți fi informat când veți putea primi comanda.

În cazul în care starea de execuție este Finished sau Updated, atunci puteți obține un ordin.

Cum se descarcă raportul offline?


Puteți descărca direct rapoartele offline. Iată instrucțiunile pentru a face acest lucru:

Cererea este formată din 3 părți:

  1. Partea fixă https://www.infoproff.com/en/orders/files/
  2. Hash-ul dvs. unic, pe care îl furnizăm ca răspuns
  3. Și partea fixă de la sfârșit /download

Cum să obțineți avizul de credit?


Funcția CreditOpinionCalculator

Cum se pot obține informații suplimentare?


Funcția GetClassifiersFinancialStatements
Funcția GetActivityClassificators
Funcția GetDictionaryStandardPhrases
Funcția GetAvailableProducts

Erori posibile


Aceste erori pot apărea în timp ce faceți o cerere către serviciul nostru web.


Toate funcțiile
  • Nume de utilizator/parolă incorectă sau nu aveți permisiuni.
    Ați introdus acreditări greșite sau accesul la API este blocat.

Funcția SimpleSearch
  1. Nu aveți permisiuni de percheziție în această țară.
    Lista țărilor disponibile: Republica Finlanda (FIN), Regatul Suediei (SWE)
Funcția Order
  1. Acest produs nu este disponibil.
    Un astfel de produs nu poate fi găsit și nu este posibil să fie comandat.
  2. Nu puteți comanda un raport privind o societate cu formă juridică: "legal_form"
    Această eroare se aplică numai la: Regatul Suediei (SWE)
    În Suedia nu este posibil să se comande raportul online (delivery_term = "o") cu următoarele formulare legale:
    • enskild näringsidkare
    • kommanditbolag
    • handelsbolag
  3. Această companie nu se află pe lista de testare.
    Codul de înregistrare al societății nu se află în lista noastră de testare.
    Lista companiilor disponibile pentru un cont de test:
    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. Este necesară denumirea firmei sau codul de înregistrare
    Atunci când se comandă un raport offline (delivery_term = "n", "f" sau "s"), este necesar "Business Name" sau "Reg Code".
  5. Codul Reg este necesar atunci când termenul de livrare este Online
    În cazul în care comandați raportul online (delivery_term = "o"), este necesar "Reg Code".

Funcția GetReport
  1. Această limbă nu este acceptată.
    Lista limbilor disponibile pentru rapoartele online: en (English), et (Estonian), ru (Russian), de (German)

Funcții GetReport ChkStatus
  1. Incorect order_id.
    ID-ul comenzii nu poate fi găsit. Veți obține ID-ul comenzii atunci când utilizați funcția Order.

Funcția OrderCancellation
  1. Your order is already canceled.
    Nu mai aveți permisiunea de a anula comanda.

Funcția OrderConfirmation
  1. Nu mai aveți permisiunea de a confirma comanda. Confirmarea se poate face în termen de o oră după ce ați primit "order_id".

Modificări SOAP (versiunea 3) în comparație cu SOAP (versiunea 2)


Modificări SOAP (versiunea 3) în comparație cu SOAP (versiunea 2) [Prezentare generală]

1) Funcție nouă: ChkFinance

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

2) Funcția: 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) Funcția: Order
Identification is required!

Pentru a plasa o comandă online, trebuie să primiți "search_result_id" de la funcția "SimpleSearch", și numai după aceea puteți plasa o comandă online (delivery_term = "o").

- Modificări în lista țărilor disponibile pentru rapoartele de credit online: Finland (FIN), Sweden (SWE), Belgium (BEL), Netherlands (NLD), Estonia (EST)

- Disponibil pentru a descărca situațiile financiare (folosind produsul: finanțe) în modul online: Estonia (EST), Sweden (SWE)

3) Funcția: 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)


Modificări SOAP (versiunea 3) în comparație cu SOAP (versiunea 2) [WSDL and XSD]

File: report.xsd

Elemente noi:

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

Funcție nouă:

- 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

Element nou:

- preferable_finances

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

3) SimpleSearchRequest

Element eliminat:

search_block.reg_code

Element nou:

search_block->company_code

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

4) SimpleSearchResponse

Elemente eliminate

- code

Elemente noi:

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