Έλεγχος KYB κυπριακών εταιρειών μέσω API

Επαληθεύστε ότι μια κυπριακή εταιρεία υπάρχει και ποια είναι η κατάστασή της, από τον αριθμό εγγραφής στο Τμήμα Εφόρου Εταιρειών, με μία κλήση REST και σε μορφή που μπορείτε να αρχειοθετήσετε.

Το πρόβλημα

Στην Κύπρο ο έλεγχος του νομικού προσώπου είναι μέρος των μέτρων δέουσας επιμέλειας για τον πελάτη. Ο περί της Παρεμπόδισης και Καταπολέμησης της Νομιμοποίησης Εσόδων από Παράνομες Δραστηριότητες Νόμος του 2007 (188(Ι)/2007) ορίζει στο άρθρο 2Α ποιες είναι οι υπόχρεες οντότητες, μεταξύ των οποίων τα πιστωτικά ιδρύματα, οι ελεγκτές, οι εξωτερικοί λογιστές και οι ανεξάρτητοι νομικοί επαγγελματίες, και τις υποχρεώνει να εξακριβώνουν την ταυτότητα του πελάτη τους. Αν ανήκετε σε αυτές, η ισχύουσα μορφή του νόμου και οι οδηγίες της αρμόδιας εποπτικής αρχής σας είναι η δεσμευτική πηγή· η σελίδα αυτή δεν αποτελεί νομική συμβουλή. Το πρώτο βήμα είναι πάντα το ίδιο: να βεβαιωθείτε ότι η εταιρεία είναι εγγεγραμμένη, με ποια επωνυμία, μορφή και έδρα, και αν είναι ενεργή ή σε διαδικασία διαγραφής ή εκκαθάρισης.

Στην πράξη αυτό γίνεται με χειροκίνητη αναζήτηση στο μητρώο και αντιγραφή αποτελεσμάτων σε έντυπο ή αρχείο. Είναι αργό, δεν κλιμακώνεται όταν έχετε εκατοντάδες πελάτες και δεν αφήνει αρχείο που να δείχνει τι ακριβώς είδατε και πότε. Αν έχετε και πελάτες από άλλες χώρες, κάθε χώρα έχει δικό της μητρώο, δικό της αναγνωριστικό και δική της μορφή.

Πώς δουλεύει με το API

Ο έλεγχος έχει τρία βήματα. Πρώτα βρίσκετε την εταιρεία από τον αριθμό εγγραφής, που δίνει ο πελάτης στα έγγραφα σύστασης. Μετά ζητάτε το πλήρες προφίλ με το id που επέστρεψε η αναζήτηση. Τέλος, αν θέλετε ειδοποίηση για αλλαγές, την προσθέτε στην παρακολούθηση.

curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=CY&company_number=HE165' \
  -H 'Authorization: Bearer rk_live_...'
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/{id}' \
  -H 'Authorization: Bearer rk_live_...'

curl -X POST 'https://api.prometiam.com/functions/v1/risk-api/monitor' \
  -H 'Authorization: Bearer rk_live_...' \
  -H 'Content-Type: application/json' \
  -d '{"company_id": 123, "country": "CY"}'

Αντικαταστήστε το {id} και το 123 με το id της αναζήτησης. Ο αριθμός HE165 είναι της Τράπεζας Κύπρου και ο HE835 της KEO PLC. Η παρακολούθηση στέλνει webhook όταν αλλάζει η κατάσταση, όταν η εταιρεία διαγράφεται, όταν υπάρχει αντιστοίχιση με κυρώσεις (beta) και όταν το μητρώο καταγράφει αλλαγή επωνυμίας, νομικής μορφής ή έδρας.

Τι παίρνετε

ΠεδίοΤι σημαίνει
company_nameΗ επωνυμία όπως υποβλήθηκε στο μητρώο, σε ελληνικούς ή λατινικούς χαρακτήρες
company_numberΟ αριθμός εγγραφής, π.χ. HE165
status και local_statusΤυποποιημένη κατάσταση και η κατάσταση με τα λόγια του μητρώου (διαγραφή σε εκκρεμότητα, εθελοντική ή υποχρεωτική εκκαθάριση, διαχείριση)
legal_form και local_legal_formΝομική μορφή: ιδιωτική, δημόσια ή περιορισμένη με εγγύηση
founding_dateΗμερομηνία σύστασης, όπου την δημοσιεύει το μητρώο
ΔιεύθυνσηΚαταστατική έδρα με την επαρχία

Τα κυπριακά δεδομένα ανανεώνονται μηνιαία. Για έλεγχο κατά την ένταξη του πελάτη αυτό αρκεί συνήθως, αλλά αν η απόφασή σας εξαρτάται από κάτι που έγινε μέσα στις τελευταίες εβδομάδες, επιβεβαιώστε το και στο ίδιο το μητρώο. Για το πώς δουλεύει το μητρώο, δείτε τον οδηγό για το ΤΕΕΔΙ.

Τι δεν παίρνετε για την Κύπρο

  • Δεν υπάρχουν διευθυντές, γραμματείς ή μέτοχοι. Για τον πραγματικό δικαιούχο χρειάζεστε άλλη πηγή. Διευθυντές επιστρέφει το API μόνο για Ισπανία, Γαλλία, Ηνωμένο Βασίλειο και Νορβηγία.
  • Δεν υπάρχει σήμα συμμόρφωσης προς το μητρώο, κωδικός δραστηριότητας, μετοχικό κεφάλαιο ή αριθμός ΦΠΑ.
  • Δεν υπάρχουν ανακοινώσεις αφερεγγυότητας για την Κύπρο. Η κατάσταση της εταιρείας δείχνει διαγραφή σε εκκρεμότητα, εθελοντική ή υποχρεωτική εκκαθάριση και διαχείριση.
  • Δεν επιστρέφονται ομόρρυθμες και ετερόρρυθμες εταιρείες ούτε εμπορικές επωνυμίες. Επιστρέφονται εταιρείες (ιδιωτικές, δημόσιες, περιορισμένες με εγγύηση) και αλλοδαπές εταιρείες.
  • Ο έλεγχος κυρώσεων (GET /sanctions/screen) είναι σε beta και ο έλεγχος PEP είναι σε beta μόνο για την Ισπανία.

Τα παραπάνω σημαίνουν ότι το API καλύπτει το βήμα «υπάρχει η εταιρεία και σε ποια κατάσταση», όχι ολόκληρη τη διαδικασία KYB. Τον πραγματικό δικαιούχο, τα έγγραφα και την αξιολόγηση κινδύνου τα συμπληρώνετε από τις δικές σας πηγές.

Ποιο πακέτο ταιριάζει

Για μικρό όγκο αρκεί το Starter (9,99 € τον μήνα, 1.000 μονάδες χρέωσης). Αν χρειάζεστε webhooks παρακολούθησης και πλήρη έλεγχο κυρώσεων σε beta, το Professional (29,99 €, 10.000 μονάδες χρέωσης). Οι οικονομικές καταστάσεις ανήκουν στο Scale και δεν αφορούν την Κύπρο. Όλες οι τιμές είναι δημόσιες.

Contains data from the Department of the Registrar of Companies and Intellectual Property (DRCOR), Republic of Cyprus, via data.gov.cy, CC BY 4.0

Σχετικές σελίδες

Ξεκινήστε τη δωρεάν δοκιμή 14 ημερών · Τεκμηρίωση API

Η δοκιμή διαρκεί 14 ημέρες και περιλαμβάνει 500 μονάδες χρέωσης. Απαιτείται κάρτα, δεν γίνεται καμία χρέωση κατά τη διάρκειά της, και στη συνέχεια ισχύει το πακέτο Starter (9,99 € τον μήνα), εκτός αν ακυρώσετε.

Frequently asked questions

Ποιο αναγνωριστικό χρησιμοποιώ για μια κυπριακή εταιρεία;
Τον αριθμό εγγραφής του ΤΕΕΔΙ, π.χ. HE165. Ψηφία χωρίς πρόθεμα διαβάζονται ως αριθμός εταιρείας (HE).
Μπορώ να βρω τους διευθυντές ή τους μετόχους;
Όχι. Για την Κύπρο το API δίνει μόνο στοιχεία εταιρείας.
Πώς ελέγχω τον αριθμό ΦΠΑ ενός κυπριακού πελάτη;
Το μητρώο δεν δημοσιεύει αριθμό ΦΠΑ και δεν μπορεί να προκύψει από τον αριθμό εγγραφής. Αν ο πελάτης σας τον δώσει, τον ελέγχετε με GET /vat/{number} (VIES).
Πόσο επίκαιρα είναι τα δεδομένα;
Ανανεώνονται μηνιαία. Για μεταγενέστερες αλλαγές ελέγξτε το μητρώο.
Μπορώ να δοκιμάσω δωρεάν;
Ναι: 14 ημέρες και 500 μονάδες χρέωσης, με κάρτα και χωρίς χρέωση κατά τη δοκιμή. Για μεμονωμένο αριθμό δοκιμάστε πρώτα το εργαλείο αναζήτησης.