Η wsdl και τα σχήματα της υπηρεσίας ιστού βρίσκονται εδώ:
https://wsdfn.infoproff.com/v4/
Postman Collection (API v4) — Ready for Use:
https://www.postman.com/infoproff/infoproff-webservices/documentation/9kweer5/soap-api-v4
Postman provides a convenient way to test our API without the need to write any code. It can also automatically generate example HTTP requests for most common programming languages.
The requests generated by Postman are basic HTTP calls compatible with our SOAP API. However, for production-grade integration, we recommend using fully featured SOAP clients available in most programming languages. These clients can work directly with WSDL and XSD, automatically handling schemas, data types, and message structures.
Using a dedicated SOAP client ensures a more reliable and robust integration, reducing the likelihood of errors when constructing and parsing SOAP messages.
Authentification details
The primary authentication method is HTTP Basic Auth. Using the Authorization header with encoded credentials is the preferred and recommended approach.
The username corresponds to the App ID, and the password is the associated Secret Key. These values are generated in the API Tokens section of the user dashboard and are not related to the credentials used for logging into the portal.
The authentication_block mechanism, used in previous API versions, is still supported for backward compatibility but is considered deprecated and should not be used in new integrations.
Web service functions:
Το API παρέχει διάφορες υπηρεσίες:
Η αναζήτηση εταιρείας αποτελείται από 2 επιλογές:
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 με βάση τα ονόματα των διαγραμμένων εταιρειών στη Νορβηγία.
Παρακάτω μπορείτε να βρείτε το παράδειγμα:
Below you can find the example of how to order and download reports:
To order an Online/Offline with identification report you need to receive "<search_result_id>".
To do so, please follow the link: Πώς να αναζητήσετε μια εταιρεία;
Για τις αναφορές χρησιμοποιούνται οι ακόλουθες καταστάσεις:
Εάν η κατάσταση εκτέλεσης είναι Finished ή Updated, τότε μπορείτε να λάβετε μια εντολή.
Για τις αναφορές χρησιμοποιούνται οι ακόλουθες καταστάσεις:
Εάν η κατάσταση εκτέλεσης είναι Finished ή Updated, τότε μπορείτε να λάβετε μια εντολή.
Below you can find the example of how to order and download archived reports:
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:
Just like the online/offline reports.
Just like the online/offline reports.
Just like the online/offline reports.
Just like the online/offline reports.
To order an online financial statements, you need to receive "<search_result_id>".
To do so, please follow the link: Πώς να αναζητήσετε μια εταιρεία;
Η λειτουργία αυτή απαιτείται μόνο κατά την παραγγελία ενός προϊόντος: finances (Financial statements) με delivery_term = 'o'.
Για τις αναφορές χρησιμοποιούνται οι ακόλουθες καταστάσεις:
If the execution status is Finished or Updated, then you can get an order.
Η αίτηση αποτελείται από 3 μέρη:
/report?&lang=en&doc_type=pdf¤cy_position=left&preferred_currency=EUR
https://www.infoproff.com/en/orders/files/<order_hash>/report?&lang=en&doc_type=pdf¤cy_position=left&preferred_currency=EUR
Η αίτηση αποτελείται από 3 μέρη:
delivery_term:
Αυτά τα σφάλματα ενδέχεται να εμφανιστούν κατά την υποβολή αιτήματος στην υπηρεσία ιστού μας.
country_economic_overview — περιλαμβάνει τις ακόλουθες υποενότητες: data_transparency_index, country_development_indicators, economic_forecast.paid_taxes — πληροφορίες σχετικά με τους καταβληθέντες φόρους.tenders — πληροφορίες σχετικά με διαγωνισμούς.sanctions — προστέθηκε στην ενότητα « negative_information ». beneficiaries, shareholders, managers και employees_data προστέθηκε το ακόλουθο στοιχείο:source_type — τύπος πηγής δεδομένων (π.χ. official, mass_media, company_admin, κ.λπ.). relations_of_persons » (Πρόσθετες πληροφορίες), προστέθηκε ένα νέο στοιχείο:match_typecapital αναδιαρθρώθηκε:capital_amount » (Πηγή) μετονομάστηκε σε « issued_capital » (Πηγή). number_of_sharesshare_valueauthorized_capitalemployees_data »:group_figure » υποδεικνύει εάν τα δεδομένα περιλαμβάνουν συγκεντρωτικά στοιχεία σε επίπεδο ομάδας (true). source_type καθορίζει τον τύπο της πηγής δεδομένων.is_estimated » περιλαμβάνεται πλέον μόνο εάν η τιμή του είναι « true ». assets_data » — ενοποιεί τις ενότητες που υπήρχαν προηγουμένως:real_estate_data (προηγουμένως ονομαζόμενη property_data), vehicles, machinery_and_equipment (προηγουμένως ονομαζόμενη assets). patents » και « biological_assets ». vehicles, έχει προστεθεί ένα νέο πεδίο:valuelitigations, έχουν προστεθεί τα ακόλουθα στοιχεία:content, instance, process, authorityfinancial_statement/positions » και « summary/latest_turnovers » έχει προστεθεί ένα νέο στοιχείο:value_origin — περιγράφει την προέλευση της τιμής · για παράδειγμα, η τιμή « estimated » - αυτή η τιμή εκτιμάται και υπολογίζεται με βάση τα διαθέσιμα δεδομένα χρησιμοποιώντας λογική ή τεχνητή νοημοσύνη.branches_data, έχουν προστεθεί τα ακόλουθα πεδία:registration_numberdirector_nameΣημείωση: Μικρές βελτιώσεις και προσαρμογές ενδέχεται να πραγματοποιηθούν κατά τη φάση σταθεροποίησης.
Ένα webhook είναι ένας τρόπος με τον οποίο μια εφαρμογή μπορεί να παρέχει σε άλλες εφαρμογές πληροφορίες σε πραγματικό χρόνο. Η λειτουργία webhook υλοποιεί κλήσεις HTTP που ρυθμίζονται με μια διεύθυνση URL. Ένα ωφέλιμο φορτίο HTTP POST αποστέλλεται σε αυτή τη διεύθυνση URL σε μορφή JSON κάθε φορά που συμβαίνει ένα καθορισμένο συμβάν. Στο πλαίσιο του έργου μας, έχουμε σχεδιάσει τη λειτουργία webhook για την ενεργοποίηση συγκεκριμένων συμβάντων.
Για να ρυθμίσετε ένα webhook για την εφαρμογή σας, μεταβείτε στη σελίδα ρυθμίσεων της εφαρμογής και αναζητήστε την ενότητα "Webhooks Settings". Και δώστε τις ακόλουθες πληροφορίες:
Αφού δώσετε αυτά τα στοιχεία, κάντε κλικ στο "Save" (Αποθήκευση).
Όταν συμβεί ένα συμβάν, θα στείλουμε ένα αίτημα HTTP POST στη διεύθυνση URL ωφέλιμου φορτίου με ένα σώμα JSON που περιέχει πληροφορίες σχετικά με το συμβάν.
Είναι σημαντικό να επαληθεύσουμε ότι τα αιτήματα POST που αποστέλλονται στη διεύθυνση URL ωφέλιμου φορτίου προέρχονται από την εφαρμογή μας. Για να βοηθήσουμε σε αυτό, κάθε αίτηση webhook περιλαμβάνει μια κεφαλίδα X-Signature.
Για την υπογραφή χρησιμοποιούμε HMAC με τον αλγόριθμο SHA512.
Το Secret είναι μια συνένωση του App ID και του Secret Key από τις ρυθμίσεις webhooks.
Είναι δυνατό να προσθέσετε τα δικά σας παραμέτρους get στο τελικό σημείο για την αναγνώριση του αποστολέα, εάν είναι απαραίτητο.
Ο διακομιστής πρέπει να απαντήσει εντός 10 δευτερολέπτων και να επιστρέψει έναν κωδικό 2XX HTTP- διαφορετικά, η παράδοση του webhook θεωρείται αποτυχημένη. Σε περίπτωση αποτυχίας, η λειτουργία θα προσπαθήσει να στείλει εκ νέου το αίτημα σύμφωνα με την πολιτική παράδοσης.