Τεκμηρίωση 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 παρέχει διάφορες υπηρεσίες:

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

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


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

  1. Αναζήτηση με βάση το όνομα της εταιρείας,
  2. Search by company code.
Κατάλογος διαθέσιμων χωρών: Βασίλειο της Δανίας (DNK), Βασίλειο της Ισπανίας (ESP), Βασίλειο της Νορβηγίας (NOR), Βασίλειο της Σουηδίας (SWE), Βασίλειο του Βελγίου (BEL), Βασίλειο των Κάτω Χωρών (NLD), Γαλλική Δημοκρατία (FRA), Γεωργία (GEO), Γροιλανδία (GRL), Δημοκρατία της Αυστρίας (AUT), Δημοκρατία της Εσθονίας (EST), Δημοκρατία της Κιργιζίας (KGZ), Δημοκρατία της Λευκορωσίας (BLR), Δημοκρατία της Μολδαβίας (MDA), Δημοκρατία της Πολωνίας (POL), Δημοκρατία της Φινλανδίας (FIN), Δημοκρατία του Αζερμπαϊτζάν (AZE), Δημοκρατία του Καζακστάν (KAZ), Δημοκρατία του Ουζμπεκιστάν (UZB), Ελβετική Συνομοσπονδία (CHE), Ηνωμένο Βασίλειο της Μεγάλης Βρετανίας και της Βόρειας Ιρλανδίας (GBR), Ιρλανδία (IRL), Ιταλική Δημοκρατία (ITA), Κυπριακή Δημοκρατία (CYP), Λαϊκή Δημοκρατία της Κίνας (CHN), Μογγολία (MNG), Ομοσπονδιακή Δημοκρατία της Γερμανίας (DEU), Πορτογαλική Δημοκρατία (PRT)
Σημαντικές πληροφορίες:

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

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)

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


Λειτουργία SimpleSearch

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

Λειτουργία SimpleSearch

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


List of available countries for online credit reports: Βασίλειο της Σουηδίας (SWE), Βασίλειο του Βελγίου (BEL), Βασίλειο των Κάτω Χωρών (NLD), Δημοκρατία της Εσθονίας (EST), Δημοκρατία της Κιργιζίας (KGZ), Δημοκρατία της Πολωνίας (POL), Δημοκρατία της Φινλανδίας (FIN), Δημοκρατία του Καζακστάν (KAZ)
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:

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.

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

  • Σε εξέλιξη - Έκθεση στο στάδιο της παραγωγής
  • 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
Κατάλογος διαθέσιμων γλωσσών: bg (Βουλγαρική), cs (Τσεχική), da (Δανικά), de (Γερμανικά), el (Ελληνική), en (Αγγλικά), es (Ισπανικά), et (Εσθονικά), fi (Φινλανδική), fr (Γαλλικά), hu (Ουγγρικό), id (Ινδονησιακή), it (Ιταλικά), ja (Ιαπωνικά), ko (Κορεάτικα), lt (Λιθουανικά), lv (Λετονία), nb (Νορβηγικό Bokmål), nl (Ολλανδικά), pl (Πολωνικά), pt (Πορτογαλικά), ro (Ρουμανικά), ru (Ρωσική), sk (Σλοβακική), sl (Σλοβενική), sv (Σουηδικά), tr (Τουρκικά), uk (Ουκρανικό), 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.

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

  • Σε εξέλιξη - Έκθεση στο στάδιο της παραγωγής
  • 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
Κατάλογος διαθέσιμων γλωσσών: bg (Βουλγαρική), cs (Τσεχική), da (Δανικά), de (Γερμανικά), el (Ελληνική), en (Αγγλικά), es (Ισπανικά), et (Εσθονικά), fi (Φινλανδική), fr (Γαλλικά), hu (Ουγγρικό), id (Ινδονησιακή), it (Ιταλικά), ja (Ιαπωνικά), ko (Κορεάτικα), lt (Λιθουανικά), lv (Λετονία), nb (Νορβηγικό Bokmål), nl (Ολλανδικά), pl (Πολωνικά), pt (Πορτογαλικά), ro (Ρουμανικά), ru (Ρωσική), sk (Σλοβακική), sl (Σλοβενική), sv (Σουηδικά), tr (Τουρκικά), uk (Ουκρανικό), zh (Κινέζικα)

Πώς να παραγγείλετε 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.

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

  • Σε εξέλιξη - Έκθεση στο στάδιο της παραγωγής
  • 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
Κατάλογος διαθέσιμων γλωσσών: bg (Βουλγαρική), cs (Τσεχική), da (Δανικά), de (Γερμανικά), el (Ελληνική), en (Αγγλικά), es (Ισπανικά), et (Εσθονικά), fi (Φινλανδική), fr (Γαλλικά), hu (Ουγγρικό), id (Ινδονησιακή), it (Ιταλικά), ja (Ιαπωνικά), ko (Κορεάτικα), lt (Λιθουανικά), lv (Λετονία), nb (Νορβηγικό Bokmål), nl (Ολλανδικά), pl (Πολωνικά), pt (Πορτογαλικά), ro (Ρουμανικά), ru (Ρωσική), sk (Σλοβακική), sl (Σλοβενική), sv (Σουηδικά), tr (Τουρκικά), uk (Ουκρανικό), 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 μέρη:

  1. Σταθερό μέρος https://www.infoproff.com/en/orders/files/
  2. Το μοναδικό σας hash, το οποίο παρέχουμε σε απάντηση
  3. 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, bg, cs, da, de, el, fi, fr, hu, id, it, ja, ko, lt, nl, nb, pl, pt, ro, sk, sl, es, sv, tr, uk, 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 μέρη:

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

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


Λειτουργία CreditOpinionCalculator

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


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

delivery_term:

  1. "o" = "Online"
  2. "n" = "Normal"
  3. "f" = "Flash"
  4. "s" = "SuperFlash"

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


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


Όλες οι λειτουργίες
  • Incorrect username/password or you have no permissions.
    Εισάγετε λάθος διαπιστευτήρια ή η πρόσβαση στο API είναι μπλοκαρισμένη.

Λειτουργία SimpleSearch
  1. You don't have permissions to search in this country.
    Κατάλογος διαθέσιμων χωρών: Βασίλειο της Δανίας (DNK), Βασίλειο της Ισπανίας (ESP), Βασίλειο της Νορβηγίας (NOR), Βασίλειο της Σουηδίας (SWE), Βασίλειο του Βελγίου (BEL), Βασίλειο των Κάτω Χωρών (NLD), Γαλλική Δημοκρατία (FRA), Γεωργία (GEO), Γροιλανδία (GRL), Δημοκρατία της Αυστρίας (AUT), Δημοκρατία της Εσθονίας (EST), Δημοκρατία της Κιργιζίας (KGZ), Δημοκρατία της Λευκορωσίας (BLR), Δημοκρατία της Μολδαβίας (MDA), Δημοκρατία της Πολωνίας (POL), Δημοκρατία της Φινλανδίας (FIN), Δημοκρατία του Αζερμπαϊτζάν (AZE), Δημοκρατία του Καζακστάν (KAZ), Δημοκρατία του Ουζμπεκιστάν (UZB), Ελβετική Συνομοσπονδία (CHE), Ηνωμένο Βασίλειο της Μεγάλης Βρετανίας και της Βόρειας Ιρλανδίας (GBR), Ιρλανδία (IRL), Ιταλική Δημοκρατία (ITA), Κυπριακή Δημοκρατία (CYP), Λαϊκή Δημοκρατία της Κίνας (CHN), Μογγολία (MNG), Ομοσπονδιακή Δημοκρατία της Γερμανίας (DEU), Πορτογαλική Δημοκρατία (PRT)
Λειτουργία Order
  1. This product is not available.
    Το εν λόγω προϊόν δεν μπορεί να βρεθεί και δεν είναι δυνατή η παραγγελία.
  2. You can't order report on company with legal form: "legal_form"
    Το σφάλμα αυτό ισχύει μόνο για: Βασίλειο της Σουηδίας (SWE)
    Στη Σουηδία δεν είναι δυνατόν να παραγγείλετε online έκθεση (delivery_term = "o") με τα επόμενα νομικά έντυπα:
    • enskild näringsidkare
    • kommanditbolag
    • handelsbolag
  3. 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
  4. Business Name or Reg Code is required
    Όταν παραγγέλνετε έκθεση εκτός σύνδεσης (delivery_term = "n", "f" ή "s"), απαιτείται η ένδειξη "Business Name" ή "Reg Code".
  5. Reg Code is required when delivery term is Online
    Όταν παραγγέλνετε online έκθεση (delivery_term = "o") απαιτείται ο "Reg Code".

Λειτουργία GetReport
  1. This language is not supported.
    Κατάλογος διαθέσιμων γλωσσών για τις αναφορές σε απευθείας σύνδεση: bg (Βουλγαρική), cs (Τσεχική), da (Δανικά), de (Γερμανικά), el (Ελληνική), en (Αγγλικά), es (Ισπανικά), et (Εσθονικά), fi (Φινλανδική), fr (Γαλλικά), hu (Ουγγρικό), id (Ινδονησιακή), it (Ιταλικά), ja (Ιαπωνικά), ko (Κορεάτικα), lt (Λιθουανικά), lv (Λετονία), nb (Νορβηγικό Bokmål), nl (Ολλανδικά), pl (Πολωνικά), pt (Πορτογαλικά), ro (Ρουμανικά), ru (Ρωσική), sk (Σλοβακική), sl (Σλοβενική), sv (Σουηδικά), tr (Τουρκικά), uk (Ουκρανικό), zh (Κινέζικα)

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

Λειτουργία OrderCancellation
  1. Your order is already canceled.
    Δεν έχετε πλέον την άδεια να ακυρώσετε την παραγγελία.

Λειτουργία OrderConfirmation
  1. 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: Βασίλειο της Δανίας (DNK), Βασίλειο της Ισπανίας (ESP), Βασίλειο της Νορβηγίας (NOR), Βασίλειο της Σουηδίας (SWE), Βασίλειο του Βελγίου (BEL), Βασίλειο των Κάτω Χωρών (NLD), Γαλλική Δημοκρατία (FRA), Γεωργία (GEO), Γροιλανδία (GRL), Δημοκρατία της Αυστρίας (AUT), Δημοκρατία της Εσθονίας (EST), Δημοκρατία της Κιργιζίας (KGZ), Δημοκρατία της Λευκορωσίας (BLR), Δημοκρατία της Μολδαβίας (MDA), Δημοκρατία της Πολωνίας (POL), Δημοκρατία της Φινλανδίας (FIN), Δημοκρατία του Αζερμπαϊτζάν (AZE), Δημοκρατία του Καζακστάν (KAZ), Δημοκρατία του Ουζμπεκιστάν (UZB), Ελβετική Συνομοσπονδία (CHE), Ηνωμένο Βασίλειο της Μεγάλης Βρετανίας και της Βόρειας Ιρλανδίας (GBR), Ιρλανδία (IRL), Ιταλική Δημοκρατία (ITA), Κυπριακή Δημοκρατία (CYP), Λαϊκή Δημοκρατία της Κίνας (CHN), Μογγολία (MNG), Ομοσπονδιακή Δημοκρατία της Γερμανίας (DEU), Πορτογαλική Δημοκρατία (PRT)

- 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: Βασίλειο της Σουηδίας (SWE), Βασίλειο του Βελγίου (BEL), Βασίλειο των Κάτω Χωρών (NLD), Δημοκρατία της Εσθονίας (EST), Δημοκρατία της Κιργιζίας (KGZ), Δημοκρατία της Πολωνίας (POL), Δημοκρατία της Φινλανδίας (FIN), Δημοκρατία του Καζακστάν (KAZ)

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

3) Function: GetReport

- Changes in of available languages: bg (Βουλγαρική), cs (Τσεχική), da (Δανικά), de (Γερμανικά), el (Ελληνική), en (Αγγλικά), es (Ισπανικά), et (Εσθονικά), fi (Φινλανδική), fr (Γαλλικά), hu (Ουγγρικό), id (Ινδονησιακή), it (Ιταλικά), ja (Ιαπωνικά), ko (Κορεάτικα), lt (Λιθουανικά), lv (Λετονία), nb (Νορβηγικό Bokmål), nl (Ολλανδικά), pl (Πολωνικά), pt (Πορτογαλικά), ro (Ρουμανικά), ru (Ρωσική), sk (Σλοβακική), sl (Σλοβενική), sv (Σουηδικά), tr (Τουρκικά), uk (Ουκρανικό), 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". Και δώστε τις ακόλουθες πληροφορίες:

  1. "Webhook URL" είναι η διεύθυνση URL όπου ο διακομιστής σας θα λαμβάνει αιτήσεις POST για webhook.
  2. "Μέγιστες προσπάθειες παράδοσης" είναι η ρύθμιση που ορίζει τον μέγιστο αριθμό προσπαθειών επανάληψης που πρέπει να γίνονται για την παράδοση ενός συμβάντος webhook όταν η αρχική προσπάθεια παράδοσης αποτυγχάνει.
  3. Το "Χρονικό όριο επανάληψης παράδοσης" είναι μια ρύθμιση που σας επιτρέπει να καθορίσετε το χρονικό διάστημα μεταξύ των επαναληπτικών προσπαθειών όταν αποτυγχάνει μια προσπάθεια παράδοσης ενός webhook.

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

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

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

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

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

Ακολουθεί ένα παράδειγμα ωφέλιμου φορτίου:
Παράδειγμα payload της νέας κατάστασης της παραγγελίας
Πιθανές τιμές του πεδίου "new_status":
  • "Finished" - μια παραγγελία έχει ολοκληρωθεί. Μια παραγγελία μπορεί να παραληφθεί;
  • "Updated" - ενημέρωση μιας παραγγελίας, προσθήκη δεδομένων σε μια ολοκληρωμένη παραγγελία;
  • "Canceled" - μια παραγγελία ακυρώνεται κατόπιν αιτήματος (ή συγκατάθεσης) του πελάτη;
  • "Rejected" - μια παραγγελία απορρίπτεται. Συνήθως επειδή είναι αδύνατο να εντοπιστεί μια εταιρεία.

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

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

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

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

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

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

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

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