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

Ξεκινώντας

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

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

Web service functions:

SimpleSearch - Αναζήτηση πληροφοριών για εταιρείες σε διάφορες χώρες.
ChkFinance - Αναζήτηση διαθέσιμων οικονομικών καταστάσεων.
Order - Δημιουργεί ένα order_id και επιστρέφει αντίγραφα. Τα αντίγραφα επιλέγονται από τις επόμενες παραμέτρους: country, product, 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 παρέχει διάφορες υπηρεσίες:

Ηλεκτρονικές πιστωτικές αναφορές για τις ακόλουθες χώρες: Αζερμπαϊτζάν (AZE), Αυστρία (AUT), Βέλγιο (BEL), Βουλγαρία (BGR), Γαλλία (FRA), Γερμανία (DEU), Δανία (DNK), Ελβετία (CHE), Ελλάδα (GRC), Εσθονία (EST), Ηνωμένο Βασίλειο (GBR), Ιρλανδία (IRL), Ισπανία (ESP), Ιταλία (ITA), Κάτω Χώρες (NLD), Κίνα (CHN), Καζακστάν (KAZ), Κιργιζία (KGZ), Κροατία (HRV), Λετονία (LVA), Λουξεμβούργο (LUX), Μάλτα (MLT), Μογγολία (MNG), Μολδαβία (MDA), Νορβηγία (NOR), Ουγγαρία (HUN), Πολωνία (POL), Πορτογαλία (PRT), Ρωσία (RUS), Σλοβακία (SVK), Σλοβενία (SVN), Σουηδία (SWE), Τσεχία (CZE), Φινλανδία (FIN)
Αναφορές εκτός σύνδεσης για τις ακόλουθες χώρες: Όλες οι χώρες
Υπολογιστής πιστωτικής γνώμης
Company search

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

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

Αναζήτηση με βάση το όνομα της εταιρείας,
Search by company code.

Κατάλογος διαθέσιμων χωρών: Άγιος Μαρίνος (SMR), Άγιος Μαρτίνος (MAF), Αγκόλα (AGO), Αζερμπαϊτζάν (AZE), Αιθιοπία (ETH), Ακτή Ελεφαντοστού (CIV), Αλβανία (ALB), Αλγερία (DZA), Αργεντινή (ARG), Αυστρία (AUT), Αυστραλία (AUS), Βέλγιο (BEL), Βενεζουέλα (VEN), Βολιβία (BOL), Βοσνία-Ερζεγοβίνη (BIH), Βουλγαρία (BGR), Βραζιλία (BRA), Γαλλία (FRA), Γερμανία (DEU), Γεωργία (GEO), Γκάμπια (GMB), Γουαδελούπη (GLP), Γουιάνα (GUF), Γουιάνα (GUY), Γουινέα (GIN), Γροιλανδία (GRL), Δανία (DNK), Ελβετία (CHE), Ελλάδα (GRC), Επανένωση (REU), Εσθονία (EST), Ζάμπια (ZMB), Ζιμπάμπουε (ZWE), Ηνωμένο Βασίλειο (GBR), Ιαπωνία (JPN), Ιρλανδία (IRL), Ισημερινός (ECU), Ισλανδία (ISL), Ισπανία (ESP), Ισραήλ (ISR), Ιταλία (ITA), Κάτω Χώρες (NLD), Κένυα (KEN), Κίνα (CHN), Κίνα (TWN), Καζακστάν (KAZ), Καναδάς (CAN), Κιργιζία (KGZ), Κονγκό (COG), Κροατία (HRV), Κόσοβο (XXK), Κύπρος (CYP), Λετονία (LVA), Λευκορωσία (BLR), Λιθουανία (LTU), Λιχτενστάιν (LIE), Λουξεμβούργο (LUX), Μάλτα (MLT), Μαγιότ (MYT), Μαδαγασκάρη (MDG), Μαλδίβες (MDV), Μαν (IMN), Μαρτινίκα (MTQ), Μαρόκο (MAR), Μαυρίκιος (MUS), Μογγολία (MNG), Μολδαβία (MDA), Μονακό (MCO), Μπενίν (BEN), Μποτσουάνα (BWA), Νέα Ζηλανδία (NZL), Ναμίμπια (NAM), Νιγηρία (NGA), Νορβηγία (NOR), Νότια Αφρική (ZAF), Ουγγαρία (HUN), Ουζμπεκιστάν (UZB), Ουρουγουάη (URY), Παραγουάη (PRY), Περού (PER), Πολωνία (POL), Πορτογαλία (PRT), Ρουάντα (RWA), Ρουμανία (ROU), Ρωσία (RUS), Σαμόα (WSM), Σερβία (SRB), Σεϋχέλλες (SYC), Σιγκαπούρη (SGP), Σλοβακία (SVK), Σλοβενία (SVN), Σουηδία (SWE), Σρι Λάνκα (LKA), Τανζανία (TZA), Τατζικιστάν (TJK), Ταϊλάνδη (THA), Τζέρζι (JEY), Τσεχία (CZE), Τόγκο (TGO), Φιλιππίνες (PHL), Φινλανδία (FIN), Χιλή (CHL), Χονγκ Κονγκ (HKG)

The search for other countries is performed only in the database of archived reports. If you do not find the desired company, enter the company details manually.

Σημαντικές πληροφορίες:

search_result_id can be acquired here for orders with delivery_term = "o" or delivery_term = "a".

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.

Το μητρώο της Νορβηγίας δεν επιτρέπει την αναζήτηση διαγραμμένων εταιρειών με βάση τα ονόματα. Ως εκ τούτου, δεν μπορούμε να παρέχουμε SimpleSearch με βάση τα ονόματα των διαγραμμένων εταιρειών στη Νορβηγία.

Field's length:
company_name varchar(512)
company_code varchar(64)

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

Επιλογή 1: Αναζήτηση με βάση το όνομα της εταιρείας

Λειτουργία SimpleSearch

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

Λειτουργία SimpleSearch

Option 3: Search by query (by name or code)

Λειτουργία UnifiedSearch

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

List of available countries for online credit reports: Αζερμπαϊτζάν (AZE), Αυστρία (AUT), Βέλγιο (BEL), Βουλγαρία (BGR), Γαλλία (FRA), Γερμανία (DEU), Δανία (DNK), Ελβετία (CHE), Ελλάδα (GRC), Εσθονία (EST), Ηνωμένο Βασίλειο (GBR), Ιρλανδία (IRL), Ισπανία (ESP), Ιταλία (ITA), Κάτω Χώρες (NLD), Κίνα (CHN), Καζακστάν (KAZ), Κιργιζία (KGZ), Κροατία (HRV), Λετονία (LVA), Λουξεμβούργο (LUX), Μάλτα (MLT), Μογγολία (MNG), Μολδαβία (MDA), Νορβηγία (NOR), Ουγγαρία (HUN), Πολωνία (POL), Πορτογαλία (PRT), Ρωσία (RUS), Σλοβακία (SVK), Σλοβενία (SVN), Σουηδία (SWE), Τσεχία (CZE), Φινλανδία (FIN)

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:

Online/Offline Order Example (with search_result_id)
Offline Order Example (without search_result_id)

STEP 1: Find a company (Online/Offline Order (with search_result_id))

Λειτουργία SimpleSearch

To order an Online/Offline with identification report you need to receive "<search_result_id>".
To do so, please follow the link: Πώς να αναζητήσετε μια εταιρεία;

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

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

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

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

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

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

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

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

STEP 6: Get report (Online/Offline Order (with search_result_id))

Λειτουργία GetReport

Κατάλογος διαθέσιμων γλωσσών: ar (Arabic), az (Azerbaijani), bg (Βουλγαρική), cs (Τσεχική), da (Δανικά), de (Γερμανικά), el (Ελληνική), en (Αγγλικά), es (Ισπανικά), et (Εσθονικά), fi (Φινλανδική), fr (Γαλλικά), he (Hebrew), hi (Hindi), hu (Ουγγρικό), hy (Armenian), id (Ινδονησιακή), it (Ιταλικά), ja (Ιαπωνικά), ka (Georgian), kk (Kazakh), ko (Κορεάτικα), lt (Λιθουανικά), lv (Λετονία), mn (Mongolian), ms (Malay), nb (Νορβηγικό Bokmål), nl (Ολλανδικά), pl (Πολωνικά), pt (Πορτογαλικά), ro (Ρουμανικά), ru (Ρωσική), sk (Σλοβακική), sl (Σλοβενική), sr (Српски), sv (Σουηδικά), th (Thai), tr (Τουρκικά), uk (Ουκρανικό), uz (Uzbek), vi (Vietnamese), zh (Κινέζικα)

STEP 1: Order a report (Offline Order (without search_result_id))

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

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

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

Λειτουργία ChkStatus

For offline orders checking order status once every 30 minutes is acceptable frequency.

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

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

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

STEP 5: Get report (Offline Order (without search_result_id))

Λειτουργία GetReport

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

Purchase of an archived report is available for all countries.

Below you can find the example of how to order and download archived reports:

STEP 1: Find a company

Λειτουργία SimpleSearch

To order an archived report you need to receive "<search_result_id>" which has an "<archived_reports>" section that contains a product you need.
To do so, please follow the link: Πώς να αναζητήσετε μια εταιρεία;

Example companies with archived reports:

Country: EST, Reg. Code: 12309116

Country: EST, Reg. Code: 12854256

Country: EST, Reg. Code: 12830238

Country: USA, Company name: Apple

STEP 2: Order a report

Λειτουργία Order

STEP 3: Order cancellation (Optional)

Just like the online/offline reports.

STEP 4: Order confirmation

Just like the online/offline reports.

STEP 5: Check order status

Just like the online/offline reports.

For archived orders checking order status once every 5 seconds is acceptable frequency.

STEP 6: Get report

Just like the online/offline reports.

Πώς να παραγγείλετε online οικονομικές καταστάσεις;

STEP 1: Find a company

Λειτουργία SimpleSearch

To order an online financial statements, you need to receive "<search_result_id>".
To do so, please follow the link: Πώς να αναζητήσετε μια εταιρεία;

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: Αναζήτηση διαθέσιμων οικονομικών καταστάσεων

Λειτουργία ChkFinance

Η λειτουργία αυτή απαιτείται μόνο κατά την παραγγελία ενός προϊόντος: finances (Financial statements) με delivery_term = 'o'.

Κατάλογος διαθέσιμων χωρών: Εσθονία (EST), Σουηδία (SWE)

STEP 3: Παραγγελία οικονομικών καταστάσεων

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

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

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

Λειτουργία ChkStatus

- For online orders checking order status once every 5 seconds is acceptable frequency.

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

Σε εξέλιξη - Έκθεση στο στάδιο της παραγωγής

Identification pending - Η προετοιμασία της έκθεσης βρίσκεται σε αναμονή. Απαιτεί πρόσθετα δεδομένα από τον πελάτη.

Canceled - Ακυρωμένη παραγγελία

Finished - Η έκθεση είναι έτοιμη

Updated - Προστέθηκαν πληροφορίες στην τελική έκθεση

Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).

Technical Error - Εμφανίστηκε ένα τεχνικό σφάλμα στο σύστημά μας. Αυτό σημαίνει ότι έχουμε ενημερωθεί για το σφάλμα και θα το διορθώσουμε το συντομότερο δυνατό. Θα ενημερωθείτε όταν θα είστε σε θέση να παραλάβετε την παραγγελία.

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

Λειτουργία GetReport

Κατάλογος διαθέσιμων γλωσσών: ar (Arabic), az (Azerbaijani), bg (Βουλγαρική), cs (Τσεχική), da (Δανικά), de (Γερμανικά), el (Ελληνική), en (Αγγλικά), es (Ισπανικά), et (Εσθονικά), fi (Φινλανδική), fr (Γαλλικά), he (Hebrew), hi (Hindi), hu (Ουγγρικό), hy (Armenian), id (Ινδονησιακή), it (Ιταλικά), ja (Ιαπωνικά), ka (Georgian), kk (Kazakh), ko (Κορεάτικα), lt (Λιθουανικά), lv (Λετονία), mn (Mongolian), ms (Malay), nb (Νορβηγικό Bokmål), nl (Ολλανδικά), pl (Πολωνικά), pt (Πορτογαλικά), ro (Ρουμανικά), ru (Ρωσική), sk (Σλοβακική), sl (Σλοβενική), sr (Српски), sv (Σουηδικά), th (Thai), tr (Τουρκικά), uk (Ουκρανικό), uz (Uzbek), vi (Vietnamese), zh (Κινέζικα)
To see the examples of xml request/response, please follow the link: How to get finished order?

Πώς να κατεβάσετε τυποποιημένες αναφορές (σε μορφές εκτός της 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.

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

Σταθερό μέρος https://www.infoproff.com/en/orders/files/

Το μοναδικό σας hash, το οποίο παρέχουμε σε απάντηση

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, ar, az, bg, cs, da, de, el, fi, fr, he, hi, hu, hy, id, it, ja, ka, kk, ko, lt, mn, ms, nl, nb, pl, pt, ro, sk, sl, es, sr, sv, th, tr, uk, uz, vi, zh
doc_type: pdf, html, docx, xlsx
currency_position: left, right
preferred_currency: XXX - Αρχικό (χωρίς ανταλλαγή), 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

Πώς να κατεβάσετε μη τυποποιημένα προϊόντα;

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.

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

Fixed part https://www.infoproff.com/en/orders/files/

Το μοναδικό σας hash, το οποίο παρέχουμε σε απάντηση

Και διορθωμένο μέρος στο τέλος /download

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

Λειτουργία CreditOpinionCalculator

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

Λειτουργία GetClassifiersFinancialStatements

Λειτουργία GetLegalForms

Λειτουργία GetActivityClassificators

Λειτουργία GetDictionaryStandardPhrases

Λειτουργία GetAvailableProducts

delivery_term:

"o" = "Online"

"n" = "Normal"

"f" = "Flash"

"s" = "SuperFlash"

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

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

Όλες οι λειτουργίες

Incorrect username/password or you have no permissions.

Εισάγετε λάθος διαπιστευτήρια ή η πρόσβαση στο API είναι μπλοκαρισμένη.

Λειτουργία SimpleSearch

You don't have permissions to search in this country.

Κατάλογος διαθέσιμων χωρών: Άγιος Μαρίνος (SMR), Άγιος Μαρτίνος (MAF), Αγκόλα (AGO), Αζερμπαϊτζάν (AZE), Αιθιοπία (ETH), Ακτή Ελεφαντοστού (CIV), Αλβανία (ALB), Αλγερία (DZA), Αργεντινή (ARG), Αυστρία (AUT), Αυστραλία (AUS), Βέλγιο (BEL), Βενεζουέλα (VEN), Βολιβία (BOL), Βοσνία-Ερζεγοβίνη (BIH), Βουλγαρία (BGR), Βραζιλία (BRA), Γαλλία (FRA), Γερμανία (DEU), Γεωργία (GEO), Γκάμπια (GMB), Γουαδελούπη (GLP), Γουιάνα (GUF), Γουιάνα (GUY), Γουινέα (GIN), Γροιλανδία (GRL), Δανία (DNK), Ελβετία (CHE), Ελλάδα (GRC), Επανένωση (REU), Εσθονία (EST), Ζάμπια (ZMB), Ζιμπάμπουε (ZWE), Ηνωμένο Βασίλειο (GBR), Ιαπωνία (JPN), Ιρλανδία (IRL), Ισημερινός (ECU), Ισλανδία (ISL), Ισπανία (ESP), Ισραήλ (ISR), Ιταλία (ITA), Κάτω Χώρες (NLD), Κένυα (KEN), Κίνα (CHN), Κίνα (TWN), Καζακστάν (KAZ), Καναδάς (CAN), Κιργιζία (KGZ), Κονγκό (COG), Κροατία (HRV), Κόσοβο (XXK), Κύπρος (CYP), Λετονία (LVA), Λευκορωσία (BLR), Λιθουανία (LTU), Λιχτενστάιν (LIE), Λουξεμβούργο (LUX), Μάλτα (MLT), Μαγιότ (MYT), Μαδαγασκάρη (MDG), Μαλδίβες (MDV), Μαν (IMN), Μαρτινίκα (MTQ), Μαρόκο (MAR), Μαυρίκιος (MUS), Μογγολία (MNG), Μολδαβία (MDA), Μονακό (MCO), Μπενίν (BEN), Μποτσουάνα (BWA), Νέα Ζηλανδία (NZL), Ναμίμπια (NAM), Νιγηρία (NGA), Νορβηγία (NOR), Νότια Αφρική (ZAF), Ουγγαρία (HUN), Ουζμπεκιστάν (UZB), Ουρουγουάη (URY), Παραγουάη (PRY), Περού (PER), Πολωνία (POL), Πορτογαλία (PRT), Ρουάντα (RWA), Ρουμανία (ROU), Ρωσία (RUS), Σαμόα (WSM), Σερβία (SRB), Σεϋχέλλες (SYC), Σιγκαπούρη (SGP), Σλοβακία (SVK), Σλοβενία (SVN), Σουηδία (SWE), Σρι Λάνκα (LKA), Τανζανία (TZA), Τατζικιστάν (TJK), Ταϊλάνδη (THA), Τζέρζι (JEY), Τσεχία (CZE), Τόγκο (TGO), Φιλιππίνες (PHL), Φινλανδία (FIN), Χιλή (CHL), Χονγκ Κονγκ (HKG)

Λειτουργία Order

This product is not available.

Το εν λόγω προϊόν δεν μπορεί να βρεθεί και δεν είναι δυνατή η παραγγελία.

You can't order report on company with legal form: "legal_form"

Το σφάλμα αυτό ισχύει μόνο για: Σουηδία (SWE)
Στη Σουηδία δεν είναι δυνατόν να παραγγείλετε online έκθεση (delivery_term = "o") με τα επόμενα νομικά έντυπα:

enskild näringsidkare

kommanditbolag

handelsbolag

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

Business Name or Reg Code is required

Όταν παραγγέλνετε έκθεση εκτός σύνδεσης (delivery_term = "n", "f" ή "s"), απαιτείται η ένδειξη "Business Name" ή "Reg Code".

Reg Code is required when delivery term is Online

Όταν παραγγέλνετε online έκθεση (delivery_term = "o") απαιτείται ο "Reg Code".

Λειτουργία GetReport

This language is not supported.

Κατάλογος διαθέσιμων γλωσσών για τις αναφορές σε απευθείας σύνδεση: ar (Arabic), az (Azerbaijani), bg (Βουλγαρική), cs (Τσεχική), da (Δανικά), de (Γερμανικά), el (Ελληνική), en (Αγγλικά), es (Ισπανικά), et (Εσθονικά), fi (Φινλανδική), fr (Γαλλικά), he (Hebrew), hi (Hindi), hu (Ουγγρικό), hy (Armenian), id (Ινδονησιακή), it (Ιταλικά), ja (Ιαπωνικά), ka (Georgian), kk (Kazakh), ko (Κορεάτικα), lt (Λιθουανικά), lv (Λετονία), mn (Mongolian), ms (Malay), nb (Νορβηγικό Bokmål), nl (Ολλανδικά), pl (Πολωνικά), pt (Πορτογαλικά), ro (Ρουμανικά), ru (Ρωσική), sk (Σλοβακική), sl (Σλοβενική), sr (Српски), sv (Σουηδικά), th (Thai), tr (Τουρκικά), uk (Ουκρανικό), uz (Uzbek), vi (Vietnamese), zh (Κινέζικα)

Λειτουργίες GetReport ChkStatus

Incorrect order_id.

Το αναγνωριστικό παραγγελίας δεν μπορεί να βρεθεί. Μπορείτε να λάβετε το αναγνωριστικό παραγγελίας όταν χρησιμοποιείτε τη λειτουργία Order.

Λειτουργία OrderCancellation

Your order is already canceled.

Δεν έχετε πλέον την άδεια να ακυρώσετε την παραγγελία.

Λειτουργία OrderConfirmation

You don't have permission to confirm the order anymore. Confirmation can be done within one hour after you recieved 'order_id'.

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

Αλλαγές στο SOAP (έκδοση 3) σε σύγκριση με το SOAP (έκδοση 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: Άγιος Μαρίνος (SMR), Άγιος Μαρτίνος (MAF), Αγκόλα (AGO), Αζερμπαϊτζάν (AZE), Αιθιοπία (ETH), Ακτή Ελεφαντοστού (CIV), Αλβανία (ALB), Αλγερία (DZA), Αργεντινή (ARG), Αυστρία (AUT), Αυστραλία (AUS), Βέλγιο (BEL), Βενεζουέλα (VEN), Βολιβία (BOL), Βοσνία-Ερζεγοβίνη (BIH), Βουλγαρία (BGR), Βραζιλία (BRA), Γαλλία (FRA), Γερμανία (DEU), Γεωργία (GEO), Γκάμπια (GMB), Γουαδελούπη (GLP), Γουιάνα (GUF), Γουιάνα (GUY), Γουινέα (GIN), Γροιλανδία (GRL), Δανία (DNK), Ελβετία (CHE), Ελλάδα (GRC), Επανένωση (REU), Εσθονία (EST), Ζάμπια (ZMB), Ζιμπάμπουε (ZWE), Ηνωμένο Βασίλειο (GBR), Ιαπωνία (JPN), Ιρλανδία (IRL), Ισημερινός (ECU), Ισλανδία (ISL), Ισπανία (ESP), Ισραήλ (ISR), Ιταλία (ITA), Κάτω Χώρες (NLD), Κένυα (KEN), Κίνα (CHN), Κίνα (TWN), Καζακστάν (KAZ), Καναδάς (CAN), Κιργιζία (KGZ), Κονγκό (COG), Κροατία (HRV), Κόσοβο (XXK), Κύπρος (CYP), Λετονία (LVA), Λευκορωσία (BLR), Λιθουανία (LTU), Λιχτενστάιν (LIE), Λουξεμβούργο (LUX), Μάλτα (MLT), Μαγιότ (MYT), Μαδαγασκάρη (MDG), Μαλδίβες (MDV), Μαν (IMN), Μαρτινίκα (MTQ), Μαρόκο (MAR), Μαυρίκιος (MUS), Μογγολία (MNG), Μολδαβία (MDA), Μονακό (MCO), Μπενίν (BEN), Μποτσουάνα (BWA), Νέα Ζηλανδία (NZL), Ναμίμπια (NAM), Νιγηρία (NGA), Νορβηγία (NOR), Νότια Αφρική (ZAF), Ουγγαρία (HUN), Ουζμπεκιστάν (UZB), Ουρουγουάη (URY), Παραγουάη (PRY), Περού (PER), Πολωνία (POL), Πορτογαλία (PRT), Ρουάντα (RWA), Ρουμανία (ROU), Ρωσία (RUS), Σαμόα (WSM), Σερβία (SRB), Σεϋχέλλες (SYC), Σιγκαπούρη (SGP), Σλοβακία (SVK), Σλοβενία (SVN), Σουηδία (SWE), Σρι Λάνκα (LKA), Τανζανία (TZA), Τατζικιστάν (TJK), Ταϊλάνδη (THA), Τζέρζι (JEY), Τσεχία (CZE), Τόγκο (TGO), Φιλιππίνες (PHL), Φινλανδία (FIN), Χιλή (CHL), Χονγκ Κονγκ (HKG)

- 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: Αζερμπαϊτζάν (AZE), Αυστρία (AUT), Βέλγιο (BEL), Βουλγαρία (BGR), Γαλλία (FRA), Γερμανία (DEU), Δανία (DNK), Ελβετία (CHE), Ελλάδα (GRC), Εσθονία (EST), Ηνωμένο Βασίλειο (GBR), Ιρλανδία (IRL), Ισπανία (ESP), Ιταλία (ITA), Κάτω Χώρες (NLD), Κίνα (CHN), Καζακστάν (KAZ), Κιργιζία (KGZ), Κροατία (HRV), Λετονία (LVA), Λουξεμβούργο (LUX), Μάλτα (MLT), Μογγολία (MNG), Μολδαβία (MDA), Νορβηγία (NOR), Ουγγαρία (HUN), Πολωνία (POL), Πορτογαλία (PRT), Ρωσία (RUS), Σλοβακία (SVK), Σλοβενία (SVN), Σουηδία (SWE), Τσεχία (CZE), Φινλανδία (FIN)

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

3) Function: GetReport

- Changes in of available languages: ar (Arabic), az (Azerbaijani), bg (Βουλγαρική), cs (Τσεχική), da (Δανικά), de (Γερμανικά), el (Ελληνική), en (Αγγλικά), es (Ισπανικά), et (Εσθονικά), fi (Φινλανδική), fr (Γαλλικά), he (Hebrew), hi (Hindi), hu (Ουγγρικό), hy (Armenian), id (Ινδονησιακή), it (Ιταλικά), ja (Ιαπωνικά), ka (Georgian), kk (Kazakh), ko (Κορεάτικα), lt (Λιθουανικά), lv (Λετονία), mn (Mongolian), ms (Malay), nb (Νορβηγικό Bokmål), nl (Ολλανδικά), pl (Πολωνικά), pt (Πορτογαλικά), ro (Ρουμανικά), ru (Ρωσική), sk (Σλοβακική), sl (Σλοβενική), sr (Српски), sv (Σουηδικά), th (Thai), tr (Τουρκικά), uk (Ουκρανικό), uz (Uzbek), vi (Vietnamese), zh (Κινέζικα)

Αλλαγές στο SOAP (έκδοση 3) σε σύγκριση με το SOAP (έκδοση 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

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

- search_result_id (is required for order with delivery_term = 'o')

- name_transliteration

- reg_code

- vat_code

- unified_legal_form

Webhooks Settings

Επισκόπηση

Ένα webhook είναι ένας τρόπος με τον οποίο μια εφαρμογή μπορεί να παρέχει σε άλλες εφαρμογές πληροφορίες σε πραγματικό χρόνο. Η λειτουργία webhook υλοποιεί κλήσεις HTTP που ρυθμίζονται με μια διεύθυνση URL. Ένα ωφέλιμο φορτίο HTTP POST αποστέλλεται σε αυτή τη διεύθυνση URL σε μορφή JSON κάθε φορά που συμβαίνει ένα καθορισμένο συμβάν. Στο πλαίσιο του έργου μας, έχουμε σχεδιάσει τη λειτουργία webhook για την ενεργοποίηση συγκεκριμένων συμβάντων.

Ρύθμιση ενός Webhook

Για να ρυθμίσετε ένα webhook για την εφαρμογή σας, μεταβείτε στη σελίδα ρυθμίσεων της εφαρμογής και αναζητήστε την ενότητα "Webhooks Settings". Και δώστε τις ακόλουθες πληροφορίες:

"Webhook URL" είναι η διεύθυνση URL όπου ο διακομιστής σας θα λαμβάνει αιτήσεις POST για webhook.

"Μέγιστες προσπάθειες παράδοσης" είναι η ρύθμιση που ορίζει τον μέγιστο αριθμό προσπαθειών επανάληψης που πρέπει να γίνονται για την παράδοση ενός συμβάντος webhook όταν η αρχική προσπάθεια παράδοσης αποτυγχάνει.

Το "Χρονικό όριο επανάληψης παράδοσης" είναι μια ρύθμιση που σας επιτρέπει να καθορίσετε το χρονικό διάστημα μεταξύ των επαναληπτικών προσπαθειών όταν αποτυγχάνει μια προσπάθεια παράδοσης ενός webhook.

Αφού δώσετε αυτά τα στοιχεία, κάντε κλικ στο "Save" (Αποθήκευση).

Τύποι συμβάντων Webhook

Νέα κατάσταση της παραγγελίας

Ωφέλιμο φορτίο Webhook

Όταν συμβεί ένα συμβάν, θα στείλουμε ένα αίτημα HTTP POST στη διεύθυνση URL ωφέλιμου φορτίου με ένα σώμα JSON που περιέχει πληροφορίες σχετικά με το συμβάν.

Ακολουθεί ένα παράδειγμα ωφέλιμου φορτίου:

Παράδειγμα payload της νέας κατάστασης της παραγγελίας

Πιθανές τιμές του πεδίου "new_status":

"Finished" - μια παραγγελία έχει ολοκληρωθεί. Μια παραγγελία μπορεί να παραληφθεί;

"Updated" - ενημέρωση μιας παραγγελίας, προσθήκη δεδομένων σε μια ολοκληρωμένη παραγγελία;

"Canceled" - μια παραγγελία ακυρώνεται κατόπιν αιτήματος (ή συγκατάθεσης) του πελάτη;

"Rejected" - μια παραγγελία απορρίπτεται. Συνήθως επειδή είναι αδύνατο να εντοπιστεί μια εταιρεία.

"Identification pending" - Χρειαζόμαστε περισσότερες πληροφορίες από τον πελάτη προτού μπορέσουμε να προετοιμάσουμε την παραγγελία..

Ασφάλιση των Webhooks σας

Είναι σημαντικό να επαληθεύσουμε ότι τα αιτήματα POST που αποστέλλονται στη διεύθυνση URL ωφέλιμου φορτίου προέρχονται από την εφαρμογή μας. Για να βοηθήσουμε σε αυτό, κάθε αίτηση webhook περιλαμβάνει μια κεφαλίδα X-Signature.

Περιγραφή υπογραφής

Για την υπογραφή χρησιμοποιούμε HMAC με τον αλγόριθμο SHA512.

Το Secret είναι μια συνένωση του App ID και του Secret Key από τις ρυθμίσεις webhooks.

Είναι δυνατό να προσθέσετε τα δικά σας παραμέτρους get στο τελικό σημείο για την αναγνώριση του αποστολέα, εάν είναι απαραίτητο.

Αντιμετώπιση προβλημάτων

Ο διακομιστής πρέπει να απαντήσει εντός 10 δευτερολέπτων και να επιστρέψει έναν κωδικό 2XX HTTP- διαφορετικά, η παράδοση του webhook θεωρείται αποτυχημένη. Σε περίπτωση αποτυχίας, η λειτουργία θα προσπαθήσει να στείλει εκ νέου το αίτημα σύμφωνα με την πολιτική παράδοσης.