Τεκμηρίωση API Infoproff - v2

Έκδοση Switch V2

Ξεκινώντας

Η wsdl και τα σχήματα της υπηρεσίας ιστού βρίσκονται εδώ:

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

Κύριες λειτουργίες της υπηρεσίας ιστού:

  • SimpleSearch - Αναζήτηση πληροφοριών για εταιρείες σε διάφορες χώρες.
  • Order - Δημιουργεί ένα order_id και επιστρέφει αντίγραφα. Τα αντίγραφα επιλέγονται από τις επόμενες παραμέτρους: country, product, delivery_term and reg_code.
  • OrderCancellation - Εάν στείλατε ένα αίτημα παραγγελίας και λάβατε το order_id, έχετε τη δυνατότητα να ακυρώσετε αυτή την παραγγελία (εάν δεν έχει μπει στην παραγωγή).
  • OrderConfirmation - Αφού λάβετε το order_id θα πρέπει να επιβεβαιώσετε την παραγγελία σας εντός 1 ώρας. Εάν δεν επιβεβαιώσετε την παραγγελία σας εντός 1 ώρας, η παραγγελία θα ακυρωθεί αυτόματα.
  • ChkStatus - Ελέγξτε την κατάσταση της παραγγελίας.
  • GetReport - Λάβετε τελειωμένες αναφορές.
  • GetClassifiersFinancialStatements - Λήψη όλων των οικονομικών εγγράφων με όλα τα στοιχεία: row_number, row_formated_description, row_lang_key και row_order.
  • GetLegalForms - Αποκτήστε όλα τα νομικά έντυπα για όλες τις διαθέσιμες χώρες.
  • GetActivityClassificators - Λάβετε όλους τους κωδικούς και τις περιγραφές για συγκεκριμένο ταξινομητή δραστηριότητας.
  • GetDictionaryStandardPhrases - Αποκτήστε όλες τις τυποποιημένες φράσεις με κλειδιά και γλώσσα.
  • GetAvailableProducts - Λάβετε μια λίστα με τα διαθέσιμα προϊόντα.
  • CreditOpinionCalculator - Ο Υπολογιστής πιστωτικής γνώμης βοηθά στην ανάθεση πιστωτικής γνώμης σε μια εταιρεία.

Το API παρέχει διάφορες υπηρεσίες:

  1. Ηλεκτρονικές πιστωτικές αναφορές για τις ακόλουθες χώρες: Δημοκρατία της Φινλανδίας (FIN), Βασίλειο της Σουηδίας (SWE)
  2. Αναφορές εκτός σύνδεσης για τις ακόλουθες χώρες: Όλες οι χώρες
  3. Υπολογιστής πιστωτικής γνώμης

Πώς να αναζητήσετε μια εταιρεία;

Η αναζήτηση εταιρείας αποτελείται από 2 επιλογές:

  1. Αναζήτηση με βάση το όνομα της εταιρείας,
  2. Αναζήτηση με κωδικό εγγραφής.
Κατάλογος διαθέσιμων χωρών: Δημοκρατία της Φινλανδίας (FIN), Βασίλειο της Σουηδίας (SWE), Βασίλειο της Νορβηγίας (NOR), Βασίλειο της Δανίας (DNK)
Σημαντικές πληροφορίες:
Το μητρώο της Νορβηγίας δεν επιτρέπει την αναζήτηση διαγραμμένων εταιρειών με βάση τα ονόματα. Ως εκ τούτου, δεν μπορούμε να παρέχουμε SimpleSearch με βάση τα ονόματα των διαγραμμένων εταιρειών στη Νορβηγία.
Field's length:
company_name varchar(512)
company_code varchar(64)

Παρακάτω μπορείτε να βρείτε το παράδειγμα:

Λειτουργία SimpleSearch

Επιλογή 2: Αναζήτηση με βάση τον κωδικό εγγραφής

Λειτουργία SimpleSearch

Πώς να παραγγείλετε μια πιστωτική έκθεση;

Η σειρά από την εγγραφή έως την παραλαβή της έκθεσης αποτελείται από τα εξής βήματα:

  1. Ο χρήστης καταχωρεί μια νέα παραγγελία (λειτουργία "Order"). Το σύστημα επιστρέφει τα στοιχεία της παραγγελίας, τον κατάλογο των αντιγράφων που τοποθετήθηκαν τις τελευταίες 60 ημέρες και αναμένει την επιβεβαίωση της παραγγελίας.
  2. Ο χρήστης επιβεβαιώνει μια παραγγελία (λειτουργία "OrderConfirmation"). Το σύστημα στέλνει την παραγγελία για παραγωγή και επιστρέφει την τρέχουσα κατάσταση παραγωγής.
  3. Ο χρήστης ελέγχει την κατάσταση της παραγγελίας (λειτουργία "ChkStatus").
  4. Εάν μια παραγγελία είναι έτοιμη, τότε ο χρήστης μπορεί να κατεβάσει την έκθεση (λειτουργία "GetReport").
Κατάλογος διαθέσιμων χωρών: Δημοκρατία της Φινλανδίας (FIN), Βασίλειο της Σουηδίας (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)

Παρακάτω μπορείτε να βρείτε το παράδειγμα:

ΒΗΜΑ 1: Παραγγελία έκθεσης

Οι χρήστες που θεωρούν περιττό το βήμα της επιβεβαίωσης της παραγγελίας μπορούν να χρησιμοποιήσουν το στοιχείο "confirm_order" και να δώσουν την τιμή "TRUE".

Συνήθως χρειάζονται 10-20 δευτερόλεπτα για την προετοιμασία της πιστωτικής έκθεσης σε απευθείας σύνδεση.
Επομένως, για τις επιγραμμικές αναφορές, θα πρέπει να πραγματοποιείτε ελέγχους κάθε 5 ή περισσότερα δευτερόλεπτα.

Κατάλογος των διαθέσιμων εταιρειών για έναν δοκιμαστικό λογαριασμό:

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
Επιπλέον, για τις ηλεκτρονικές εκθέσεις (delivery_term = "o"), μπορείτε να χρησιμοποιήσετε δείγματα που δημιουργούνται για κάθε χώρα (χρήση: κωδικός καταχώρισης "00000000"). Αυτές οι εκθέσεις είναι δωρεάν και μπορείτε να τις παραγγείλετε χρησιμοποιώντας τον λογαριασμό δοκιμής.
Λειτουργία Order
Λειτουργία OrderCancellation

ΒΗΜΑ 2. Επιβεβαίωση παραγγελίας

Λειτουργία OrderConfirmation

ΒΗΜΑ 3. Έλεγχος κατάστασης

Λειτουργία ChkStatus

ΒΗΜΑ 4. Αποκτήστε την έκθεση

Κατάλογος διαθέσιμων γλωσσών για τις αναφορές σε απευθείας σύνδεση: en (English), et (Estonian), ru (Russian), de (German)
Η μεταφόρτωση της ηλεκτρονικής έκθεσης σε pdf δεν είναι ακόμη διαθέσιμη.
Λειτουργία GetReport

Για τις αναφορές χρησιμοποιούνται οι ακόλουθες καταστάσεις:

  • Σε εξέλιξη - Έκθεση στο στάδιο της παραγωγής
  • Canceled - Ακυρωμένη παραγγελία
  • Finished - Η έκθεση είναι έτοιμη
  • Updated - Προστέθηκαν πληροφορίες στην τελική έκθεση
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Εμφανίστηκε ένα τεχνικό σφάλμα στο σύστημά μας. Αυτό σημαίνει ότι έχουμε ενημερωθεί για το σφάλμα και θα το διορθώσουμε το συντομότερο δυνατό. Θα ενημερωθείτε όταν θα είστε σε θέση να παραλάβετε την παραγγελία.

Εάν η κατάσταση εκτέλεσης είναι Finished ή Updated, τότε μπορείτε να λάβετε μια εντολή.

Πώς μπορείτε να κατεβάσετε την έκθεση εκτός σύνδεσης;

Μπορείτε να κατεβάσετε απευθείας τις αναφορές Offline. Εδώ είναι οι οδηγίες για το πώς πρέπει να το κάνετε:

Η αίτηση αποτελείται από 3 μέρη:

  1. Σταθερό μέρος https://www.infoproff.com/en/orders/files/
  2. Το μοναδικό σας hash, το οποίο παρέχουμε σε απάντηση
  3. Και διορθωμένο μέρος στο τέλος /download

Πώς να λάβετε πιστωτική γνώμη;

Λειτουργία CreditOpinionCalculator

Πώς να λάβετε πρόσθετες πληροφορίες;

Λειτουργία GetClassifiersFinancialStatements
Λειτουργία GetActivityClassificators
Λειτουργία GetDictionaryStandardPhrases
Λειτουργία GetAvailableProducts

Πιθανά σφάλματα

Αυτά τα σφάλματα ενδέχεται να εμφανιστούν κατά την υποβολή αιτήματος στην υπηρεσία ιστού μας.

Όλες οι λειτουργίες
  • Λανθασμένο όνομα χρήστη/κωδικός πρόσβασης ή δεν έχετε δικαιώματα.
    Εισάγετε λάθος διαπιστευτήρια ή η πρόσβαση στο API είναι μπλοκαρισμένη.
Λειτουργία SimpleSearch
  1. Δεν έχετε δικαιώματα έρευνας σε αυτή τη χώρα.
    Κατάλογος διαθέσιμων χωρών: Δημοκρατία της Φινλανδίας (FIN), Βασίλειο της Σουηδίας (SWE)
Λειτουργία Order
  1. Αυτό το προϊόν δεν είναι διαθέσιμο.
    Το εν λόγω προϊόν δεν μπορεί να βρεθεί και δεν είναι δυνατή η παραγγελία.
  2. Δεν μπορείτε να παραγγείλετε έκθεση για εταιρεία με νομική μορφή: "legal_form"
    Το σφάλμα αυτό ισχύει μόνο για: Βασίλειο της Σουηδίας (SWE)
    Στη Σουηδία δεν είναι δυνατόν να παραγγείλετε online έκθεση (delivery_term = "o") με τα επόμενα νομικά έντυπα:
    • enskild näringsidkare
    • kommanditbolag
    • handelsbolag
  3. Η εταιρεία αυτή δεν περιλαμβάνεται στον κατάλογο δοκιμών.
    Ο κωδικός εγγραφής της εταιρείας δεν περιλαμβάνεται στη λίστα δοκιμών μας.
    Κατάλογος των διαθέσιμων εταιρειών για έναν δοκιμαστικό λογαριασμό:
    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. Απαιτείται επωνυμία επιχείρησης ή κωδικός Reg
    Όταν παραγγέλνετε έκθεση εκτός σύνδεσης (delivery_term = "n", "f" ή "s"), απαιτείται η ένδειξη "Business Name" ή "Reg Code".
  5. Ο κωδικός Reg απαιτείται όταν ο όρος παράδοσης είναι Online
    Όταν παραγγέλνετε online έκθεση (delivery_term = "o") απαιτείται ο "Reg Code".
Λειτουργία GetReport
  1. Αυτή η γλώσσα δεν υποστηρίζεται.
    Κατάλογος διαθέσιμων γλωσσών για τις αναφορές σε απευθείας σύνδεση: en (English), et (Estonian), ru (Russian), de (German)
Λειτουργίες GetReport ChkStatus
  1. Λανθασμένο order_id.
    Το αναγνωριστικό παραγγελίας δεν μπορεί να βρεθεί. Μπορείτε να λάβετε το αναγνωριστικό παραγγελίας όταν χρησιμοποιείτε τη λειτουργία Order.
Λειτουργία OrderCancellation
  1. Your order is already canceled.
    Δεν έχετε πλέον την άδεια να ακυρώσετε την παραγγελία.
Λειτουργία OrderConfirmation
  1. Δεν έχετε πλέον την άδεια να επιβεβαιώσετε την παραγγελία. Η επιβεβαίωση μπορεί να γίνει εντός μίας ώρας αφότου λάβετε το 'order_id'.

Αλλαγές στο SOAP (έκδοση 3) σε σύγκριση με το SOAP (έκδοση 2)

Αλλαγές στο SOAP (έκδοση 3) σε σύγκριση με το SOAP (έκδοση 2) [Επισκόπηση]

1) Νέα λειτουργία: ChkFinance

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

2) Λειτουργία: 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) Λειτουργία: Order
Identification is required!

Για να κάνετε μια online παραγγελία, πρέπει να λάβετε το 'search_result_id' από τη λειτουργία 'SimpleSearch' και μόνο μετά από αυτό μπορείτε να κάνετε μια online (delivery_term = 'o') παραγγελία.

- Αλλαγές στον κατάλογο των διαθέσιμων χωρών για online αναφορές πιστοληπτικής ικανότητας: Finland (FIN), Sweden (SWE), Belgium (BEL), Netherlands (NLD), Estonia (EST)

- Διαθέσιμο για τη λήψη οικονομικών καταστάσεων (χρησιμοποιώντας το προϊόν: finances) σε online λειτουργία: Estonia (EST), Sweden (SWE)

3) Λειτουργία: 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)


Αλλαγές στο SOAP (έκδοση 3) σε σύγκριση με το SOAP (έκδοση 2) [WSDL and XSD]

File: report.xsd

Νέα στοιχεία:

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

Νέα λειτουργία:

- 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

Νέο στοιχείο:

- preferable_finances

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

3) SimpleSearchRequest

Αφαιρεθέν στοιχείο:

search_block.reg_code

Νέο στοιχείο:

search_block->company_code

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

4) SimpleSearchResponse

Αφαιρεθέντα στοιχεία

- code

Νέα στοιχεία:

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