Βεβαιωθείτε ότι ο προμηθευτής είναι ενεργή εταιρεία πριν τον πληρώσετε και μάθετε εγκαίρως αν μπει σε διαγραφή ή εκκαθάριση, με τον αριθμό εγγραφής και μία κλήση API.
Ένας προμηθευτής που εξαφανίζεται κοστίζει. Πληρώνετε προκαταβολές, αποθηκεύετε δεδομένα σε αυτόν ή στηρίζετε μια παραγωγική αλυσίδα, και ξαφνικά η εταιρεία βρίσκεται σε εκκαθάριση ή έχει διαγραφεί από το μητρώο επειδή δεν υπέβαλε τις ετήσιες δηλώσεις του. Για τα τμήματα αγορών και τα λογιστήρια, ο έλεγχος ενός προμηθευτή σημαίνει πρώτα απ’ όλα ένα πράγμα: η εταιρεία υπάρχει, με την επωνυμία που βλέπετε στο τιμολόγιο, και δεν είναι σε διαδικασία διαγραφής ή εκκαθάρισης.
Αν συνεργάζεστε με προμηθευτές σε περισσότερες από μία χώρες, ο χειροκίνητος έλεγχος σε κάθε εθνικό μητρώο δεν κρατιέται για πολύ και καταλήγει να γίνεται μόνο στην αρχή της συνεργασίας.
Αποθηκεύετε για κάθε προμηθευτή τον αριθμό εγγραφής και τον ελέγχετε με GET /companies/search. Για να μη ρωτάτε κάθε εβδομάδα, προσθέτετε τον προμηθευτή στην παρακολούθηση: το API στέλνει webhook όταν αλλάξει η κατάστασή του.
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=CY&company_number=HE835' \ -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"}'
Το HE835 είναι η KEO PLC, παράδειγμα δημόσιας εταιρείας. Το company_id είναι το id που επέστρεψε η αναζήτηση. Για συγκεκριμένα συμβάντα του μητρώου (αλλαγή επωνυμίας, κατάστασης, νομικής μορφής ή έδρας) χρησιμοποιήστε GET /company-events/search?country=CY&company_number=HE835.
status, local_status): διαγραφή σε εκκρεμότητα, εθελοντική εκκαθάριση, υποχρεωτική εκκαθάριση, διαχείριση.HE835) και το id που επέστρεψε η αναζήτηση, ώστε κάθε επόμενος έλεγχος να γίνεται με το ίδιο αναγνωριστικό.status και local_status) και την ημερομηνία του ελέγχου, ως απόδειξη για το τι ίσχυε όταν εγκρίνατε τον προμηθευτή.Αν η επωνυμία στο τιμολόγιο διαφέρει από αυτήν του μητρώου, μην πληρώσετε πριν ζητήσετε εξήγηση από τον προμηθευτή: μπορεί να πρόκειται για πρόσφατη αλλαγή επωνυμίας ή για λάθος στα στοιχεία τιμολόγησης. Αν η αναζήτηση με αριθμό δεν επιστρέψει τίποτα, ελέγξτε το πρόθεμα (HE ή AE) και τα ψηφία, και δοκιμάστε με την επωνυμία. Μια ομόρρυθμη ή ετερόρρυθμη εταιρεία δεν θα βρεθεί σε καμία περίπτωση.
Τα κυπριακά δεδομένα ανανεώνονται μηνιαία, άρα και οι ειδοποιήσεις έρχονται με αυτόν τον ρυθμό. Μια αλλαγή που έγινε σήμερα δεν θα φανεί αμέσως. Αν πρόκειται για μεγάλη πληρωμή, ελέγξτε και το ίδιο το μητρώο πριν την εκτελέσετε. Τα συμβάντα φέρουν ημερομηνία από τη στιγμή που η αλλαγή εμφανίστηκε στα δεδομένα του μητρώου και δεν υπάρχουν πριν από την πρώτη φόρτωση των κυπριακών δεδομένων, τον Οκτώβριο 2026.
GET /vat/{number}.Η παρακολούθηση με webhook περιλαμβάνεται στο Professional (29,99 € τον μήνα, 10.000 μονάδες χρέωσης). Αν ελέγχετε προμηθευτές μόνο όταν τους προσθέτετε, το Starter (9,99 €, 1.000 μονάδες χρέωσης) αρκεί. Δείτε τις τιμές.
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 € τον μήνα), εκτός αν ακυρώσετε.