ο viesapi-cli.exe client application allows for quick and automatic checking of entities (contractors) from the command line level (CLI / CMD) in terms of their current status in the VIES system. The application also allows you to save the downloaded data to a file in 3 formats:
- JSON
- PROP (list of properties in form of key = value)
- XML
Application has been successfully tested in the following versions of MS Windows: XP, 7, 10 and 11. The latest version of the application is always available for download from the Κατεβάστε σελίδα.
Η πλήρης λειτουργικότητα της εφαρμογής μπορεί να ελεγχθεί – χωρίς την ανάγκη δημιουργίας λογαριασμού – χρησιμοποιώντας τα παρεχόμενα Test API
Για να χρησιμοποιήσετε το πρόσθετο στο API παραγωγής, πρέπει να δημιουργήσετε έναν λογαριασμό στον ιστότοπο viesapi.eu, να αγοράσετε ένα ελάχιστο από το επιχειρηματικό σχέδιο και να δημιουργήσετε ένα κλειδί API και ένα αναγνωριστικό κλειδιού API.
Η διαδικασία εγγραφής και δημιουργίας λογαριασμού καθώς και η δημιουργία κλειδιών έχουν περιγραφεί στο Τεκμηρίωση δικτυακός τόπος.
Δραστηριοποίηση
Το κοινόχρηστο εκτελέσιμο πρόγραμμα viesapi-cli.exe δεν απαιτεί εγκατάσταση και δεν χρειάζεται να εκτελείται σε λογαριασμό με δικαιώματα διαχειριστή. Για να εκτελέσετε το πρόγραμμα, επιλέξτε το Command Prompt αίτηση από το Start μενού ή πληκτρολογήστε cmd in the Search programs and files πεδίο και πατήστε Enter:
Μετά την εκκίνηση της κονσόλας, μεταβείτε στον κατάλογο όπου βρίσκεται το αρχείο zip viesapi-cli.exe έγινε λήψη και αποσυσκευασία.
Η εκκίνηση του προγράμματος χωρίς τον καθορισμό παραμέτρων εμφανίζει το παράθυρο βοήθειας.
Διαμόρφωση
Εκκίνηση του viesapi-cli.exe αίτηση χωρίς να προσδιορίζεται η API key ID και API key σας επιτρέπει να ρωτήσετε το περιβάλλον δοκιμής (περισσότερες λεπτομέρειες για το Test VIES API σελίδα).
Για να συνδεθείτε στο περιβάλλον παραγωγής, είναι απαραίτητο να καλέσετε το viesapi-cli.exe εφαρμογή με τις παραμέτρους ελέγχου ταυτότητας, οι οποίες είναι:
keyid– η παράμετρος πρέπει να περιέχει το αναγνωριστικό κλειδιού API (ID) που δημιουργείται στον λογαριασμό στον ιστότοπο viesapi.eu,key– η παράμετρος πρέπει να περιέχει το κλειδί API (Κλειδί) που δημιουργείται στον λογαριασμό στον ιστότοπο viesapi.eu.
Λεπτομέρειες σχετικά με τη δημιουργία του αναγνωριστικού και του κλειδιού περιγράφονται στο Τεκμηρίωση σελίδα. Παρακάτω είναι ένα παράδειγμα κλήσης της εφαρμογής με παραμέτρους ελέγχου ταυτότητας (keyid και key):
viesapi-cli.exe -keyid XXXXXXXXXXXX -key YYYYYYYYYYYY -vies -format xml
Σύνταξη κλήσης
Syntax of calling the viesapi-cli.exe program:
viesapi-cli.exe <action>
Available actions:
-help – περιγραφή των παραμέτρων κλήσης προγράμματος
-vies – current VIES system status
-account – current account status
-data – get company data from VIES
-data-parsed – get company data from VIES with parsed data
-batch-upload – upload batch of VAT numbers and get batch token
-batch-download – check batch result and download data
Available options:
-keyid string – Αναγνωριστικό κλειδιού API
-key string – Κλειδί API
-euvat number – Αριθμός ΑΦΜ ΕΕ με πρόθεμα χώρας
-token string – batch token value
-format type – output format type (json, prop, xml), default: json
-file-in path – input file path
-file-out path – output file path
-proxy url – Διαμόρφωση διακομιστή μεσολάβησης HTTP (ως URL http://user:password@hostname:port)
Παραδείγματα
ΠΡΟΣΟΧΗ! Τα ακόλουθα παραδείγματα προσαρμόζονται στα δεδομένα που συλλέγονται στο περιβάλλον δοκιμής. Για να πραγματοποιήσετε ελέγχους στο περιβάλλον παραγωγής, προσθέστε το –keyid και –key παραμέτρους με τις κατάλληλες τιμές για κάθε ερώτημα.
1. Checks the current VIES system status and displays the result as XML:
viesapi-cli.exe -vies -format xml
2. Checks the current account status and saves the result to a JSON file:
viesapi-cli.exe -account -file-out result.json.
3. Downloads company data from VIES and displays the result as PROP:
viesapi-cli.exe -data -euvat PL5213003700 -format prop
4. Downloads company parsed data from VIES and saves the result to a JSON file:
viesapi-cli.exe -data-parsed -euvat PL5213003700 -file-out result.json
5. Uploads a batch file (one number per line) and receives a batch token for result checking:
viesapi-cli.exe -batch-upload -file-in numbers.csv
6. Checks the current batch status and saves the result to a JSON file:
viesapi-cli.exe -batch-download -token 1fd853a5-ac9e-490c-81a1-d4900a9c906c -file-out result.json