ο viesapi-cli.exe
Η εφαρμογή-πελάτης επιτρέπει τον γρήγορο και αυτόματο έλεγχο των οντοτήτων (εργολάβων) από το επίπεδο γραμμής εντολών (CLI / CMD) ως προς την τρέχουσα κατάστασή τους στο σύστημα VIES. Η εφαρμογή σάς επιτρέπει επίσης να αποθηκεύσετε τα δεδομένα που έχετε λάβει σε ένα αρχείο σε 3 μορφές:
- JSON
- PROP (λίστα ιδιοτήτων με τη μορφή κλειδιού = τιμής)
- XML
Η εφαρμογή έχει δοκιμαστεί με επιτυχία στις ακόλουθες εκδόσεις των MS Windows: XP, 7, 10 και 11. Η τελευταία έκδοση της εφαρμογής είναι πάντα διαθέσιμη για λήψη από το Κατεβάστε σελίδα.
Η πλήρης λειτουργικότητα της εφαρμογής μπορεί να ελεγχθεί – χωρίς την ανάγκη δημιουργίας λογαριασμού – χρησιμοποιώντας τα παρεχόμενα Test API
Για να χρησιμοποιήσετε το πρόσθετο στο API παραγωγής, πρέπει να δημιουργήσετε έναν λογαριασμό στον ιστότοπο viesapi.eu, να αγοράσετε ένα ελάχιστο από το επιχειρηματικό σχέδιο και να δημιουργήσετε ένα κλειδί API και ένα αναγνωριστικό κλειδιού API.
Η διαδικασία εγγραφής και δημιουργίας λογαριασμού καθώς και η δημιουργία κλειδιών έχουν περιγραφεί στο Τεκμηρίωση δικτυακός τόπος.
Δραστηριοποίηση
Το κοινόχρηστο εκτελέσιμο πρόγραμμα viesapi-cli.exe
δεν απαιτεί εγκατάσταση και δεν χρειάζεται να εκτελείται σε λογαριασμό με δικαιώματα διαχειριστή. Για να εκτελέσετε το πρόγραμμα, επιλέξτε το Command Prompt
αίτηση από το Start
μενού ή πληκτρολογήστε cmd
στο 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
Σύνταξη κλήσης
Σύνταξη της κλήσης του viesapi-cli.exe
πρόγραμμα:
viesapi-cli.exe <action>
Διαθέσιμες ενέργειες:
-help
– περιγραφή των παραμέτρων κλήσης προγράμματος
-vies
– τρέχουσα κατάσταση του συστήματος VIES
-account
– κατάσταση τρεχούμενου λογαριασμού
-data
– λήψη δεδομένων εταιρείας από το VIES
-data-parsed
– λήψη εταιρικών δεδομένων από το VIES με αναλυμένα δεδομένα
-batch-upload
– μεταφορτώστε μια παρτίδα αριθμών ΦΠΑ και λάβετε ένα διακριτικό παρτίδας
-batch-download
– ελέγξτε το αποτέλεσμα της παρτίδας και κατεβάστε δεδομένα
Διαθέσιμες επιλογές:
-keyid string
– Αναγνωριστικό κλειδιού API
-key string
– Κλειδί API
-euvat number
– Αριθμός ΑΦΜ ΕΕ με πρόθεμα χώρας
-token string
– αξία συμβολαίου παρτίδας
-format type
– τύπος μορφής εξόδου (json, prop, xml), προεπιλογή: json
-file-in path
– διαδρομή αρχείου εισαγωγής
-file-out path
– διαδρομή αρχείου εξόδου
-proxy url
– Διαμόρφωση διακομιστή μεσολάβησης HTTP (ως URL http://user:password@hostname:port
)
Παραδείγματα
ΠΡΟΣΟΧΗ! Τα ακόλουθα παραδείγματα προσαρμόζονται στα δεδομένα που συλλέγονται στο περιβάλλον δοκιμής. Για να πραγματοποιήσετε ελέγχους στο περιβάλλον παραγωγής, προσθέστε το –keyid
και –key
παραμέτρους με τις κατάλληλες τιμές για κάθε ερώτημα.
1. Ελέγχει την τρέχουσα κατάσταση του συστήματος VIES και εμφανίζει το αποτέλεσμα ως XML:
viesapi-cli.exe -vies -format xml
2. Ελέγχει την τρέχουσα κατάσταση του λογαριασμού και αποθηκεύει το αποτέλεσμα σε ένα αρχείο JSON:
viesapi-cli.exe -account -file-out result.json
.
3. Λήψη δεδομένων εταιρείας από το VIES και εμφάνιση του αποτελέσματος ως PROP:
viesapi-cli.exe -data -euvat PL5213003700 -format prop
4. Λήψη δεδομένων που έχει αναλύσει η εταιρεία από το VIES και αποθήκευση του αποτελέσματος σε αρχείο JSON:
viesapi-cli.exe -data-parsed -euvat PL5213003700 -file-out result.json
5. Ανεβάζει ένα αρχείο δέσμης (έναν αριθμό ανά γραμμή) και λαμβάνει ένα διακριτικό δέσμης για έλεγχο αποτελεσμάτων:
viesapi-cli.exe -batch-upload -file-in numbers.csv
6. Ελέγχει την τρέχουσα κατάσταση της παρτίδας και αποθηκεύει το αποτέλεσμα σε ένα αρχείο JSON:
viesapi-cli.exe -batch-download -token 1fd853a5-ac9e-490c-81a1-d4900a9c906c -file-out result.json