Το πρόσθετο Excel σάς επιτρέπει να ελέγχετε γρήγορα και αυτόματα οντότητες (εργολάβους) χρησιμοποιώντας το υπολογιστικό φύλλο Excel όσον αφορά την τρέχουσα κατάστασή τους στο σύστημα VIES.
Αυτό το κεφάλαιο περιέχει οδηγίες σχετικά με τον τρόπο ενσωμάτωσης της εφαρμογής Microsoft Excel με το σύστημα VIES API. Το παρεχόμενο πρόσθετο έχει δοκιμαστεί με επιτυχία στις ακόλουθες εκδόσεις του MS Excel: 2007, 2010, 2013, 2016, 2019 (στα λειτουργικά συστήματα Windows και MacOS) και 2021 (στα λειτουργικά συστήματα Windows και MacOS) και την έκδοση web του Excel365.
Η πιο πρόσφατη έκδοση του πρόσθετου για Excel 2007, 2010, 2013, 2016 και 2019 είναι πάντα διαθέσιμη για λήψη από το Λήψη σελίδας. Το πρόσθετο μπορεί να εγκατασταθεί σε εκδόσεις 32-bit και 64-bit του Excel. Προσοχή! Επιλέξτε την έκδοση (32 ή 64 bit) που ταιριάζει με την έκδοση του Excel, όχι το λειτουργικό σύστημα.
Για λήψη και εγκατάσταση του πρόσθετου για MacOS και Excel 2021 για Windows και Excel365, επισκεφτείτε το επίσημο κατάστημα της Microsoft: https://appsource.microsoft.com.
Μπορείτε να ελέγξετε την πλήρη λειτουργικότητα του πρόσθετου Excel – χωρίς την ανάγκη δημιουργίας λογαριασμού – χρησιμοποιώντας τα παρεχόμενα Test API. Η σελίδα περιγράφει επίσης τον τρόπο διαμόρφωσης ενός πρόσθετου Excel για χρήση στο API που παρέχεται για δοκιμή.
Η χρήση του πρόσθετου στο API παραγωγής απαιτεί τη δημιουργία λογαριασμού στον ιστότοπο viesapi.eu, την αγορά ενός ελάχιστου του Επιχειρηματικού σχεδίου και τη δημιουργία ενός κλειδιού και του αναγνωριστικού του. Η διαδικασία εγγραφής και δημιουργίας λογαριασμού καθώς και η δημιουργία κλειδιών έχουν περιγραφεί στο Τεκμηρίωση δικτυακός τόπος.
Εγκατάσταση και διαμόρφωση για MS Excel 2021 και Excel 365 από το Microsoft Store (AppSource)
Εγκατάσταση
Αφού εισέλθετε στον ιστότοπο του Microsoft Official Store https://appsource.microsoft.com, κάντε κλικ στο Get it now
κουμπί.
Θα εμφανιστεί ένα παράθυρο σύνδεσης στο οποίο πρέπει να εισαγάγετε τη διεύθυνση e-mail για την οποία έχετε δημιουργήσει λογαριασμό στη Microsoft (ιδιωτικό ή εταιρικό). Εάν δεν διαθέτετε τέτοιο λογαριασμό, μπορείτε να δημιουργήσετε έναν και να συνεχίσετε τη διαδικασία εγκατάστασης ή να διακόψετε την εγκατάσταση και να χρησιμοποιήσετε την επιλογή εγκατάστασης του πρόσθετου με έναν από τους τρόπους που περιγράφονται παραπάνω.
Για λήψη και εγκατάσταση του πρόσθετου από το Excel 2021 ή το Excel 365 (ιστός), μεταβείτε στο Insert
καρτέλα [1], βρείτε την ενότητα Πρόσθετα και κάντε κλικ στο Office
Add-ins
κουμπί [2]. Στη συνέχεια, στο παράθυρο που ανοίγει, πληκτρολογήστε τη λέξη "viesapi
′ [3] στο πεδίο αναζήτησης και πατήστε το εικονίδιο του μεγεθυντικού φακού. Ένα πρόσθετο που ονομάζεται "VIES API - EU VAT Validation
» θα πρέπει να βρεθεί, το οποίο θα πρέπει να εγκατασταθεί κάνοντας κλικ στο Add
κουμπί [4]. Όλα τα παραπάνω βήματα απεικονίζονται στο παρακάτω στιγμιότυπο οθόνης:
Αφού κάνετε κλικ στο Add
κουμπί, θα πρέπει να εμφανιστεί μια οθόνη όπου μπορείτε να διαβάσετε τους όρους άδειας χρήσης και τους κανόνες προστασίας του απορρήτου.
Για να ξεκινήσετε την εγκατάσταση του πρόσθετου, πατήστε Continue
κουμπί.
Διαμόρφωση
Αφού εγκαταστήσετε σωστά το πρόσθετο, θα πρέπει να δείτε μια οθόνη παρόμοια με αυτή που παρουσιάζεται παρακάτω. Στο Home menu
[1], βρείτε το εικονίδιο που αντιπροσωπεύει το VIES API Panel
[2] και κάντε κλικ σε αυτό για να εμφανιστεί το πλαϊνό πλαίσιο. Αμέσως μετά την εγκατάσταση, το πρόσθετο έχει ρυθμιστεί ώστε να λειτουργεί σε δοκιμαστικό περιβάλλον – λεπτομέρειες σχετικά με το Δοκιμαστική σελίδα API. Η χρήση του πρόσθετου στη δοκιμαστική λειτουργία δεν απαιτεί τη δημιουργία λογαριασμού στο viesapi.eu
δικτυακός τόπος.
Για να μεταβείτε το πρόσθετο στο περιβάλλον παραγωγής, κάντε κλικ στο ID and key
καρτέλα [3] και εισάγετε το Key
και κλειδί ID
, το οποίο μπορείτε να βρείτε αφού συνδεθείτε στον λογαριασμό σας στον ιστότοπο viesapi.eu στο «API Keys
καρτέλα ". Αφού εισαγάγετε και τις δύο τιμές, πατήστε το Save
κουμπί.
Εάν δεν έχετε ακόμη λογαριασμό στον ιστότοπό μας, κάντε κλικ στον σύνδεσμο στο viesapi.eu
[4] και περάστε από τη διαδικασία εγγραφής, η οποία περιγράφεται λεπτομερώς στο Τεκμηρίωση σελίδα.
Εγκατάσταση και διαμόρφωση για το Excel: 2007, 2010, 2013, 2016 και 2019
Εγκατάσταση
Αποκτήστε την πιο πρόσφατη έκδοση του πρόσθετου για Excel 2007, 2010, 2013, 2016 και 2019 από το Λήψη σελίδας. Εκκινήστε το MS Excel και μεταβείτε στο File> Options
, μετά επιλέξτε Add-ins
[1] από το μενού.
Στο κάτω μέρος των ρυθμίσεων, επιλέξτε Excel Add-ins
[2] και κάντε κλικ στο Go
κουμπί [3].
Οι προχωρημένοι χρήστες μπορούν να προσθέσουν ένα πρόσθετο από το Developer
καρτέλα [1] και μετά κάντε κλικ Excel Add-ins
[2] και κάντε κλικ στο Browse
[3] κουμπί:
Στο Add-ins
παράθυρο, κάντε κλικ στο Browse
κουμπί, μεταβείτε στον κατάλογο όπου το viesapi-ms-excel-addin-version-number.zip
Το αρχείο αποσυσκευάστηκε και επιλέξτε:
viesapiExcel.xll
– για την έκδοση 32-bit του Excel,viesapiExcel64.xll
– για την έκδοση 64-bit του Excel.
Η σωστή φόρτωση του πρόσθετου φαίνεται στην παρακάτω εικόνα [1].
Αρκεί να κάνετε κλικ στο OK
κουμπί [2] για να κάνετε τις λειτουργίες που υλοποιούνται στο πρόσθετο διαθέσιμες στο Excel.
Διαμόρφωση
Μετά την εγκατάσταση, το πρόσθετο έχει οριστεί στο δοκιμαστικό περιβάλλον από προεπιλογή (περισσότερες λεπτομέρειες για Test API σελίδα). Για να μπορέσετε να καλέσετε λειτουργίες στο περιβάλλον παραγωγής, είναι απαραίτητο να διαμορφώσετε μία φορά την πρόσβαση στον ιστότοπο viesapi.eu. Για να το κάνετε αυτό, μεταβείτε σε οποιοδήποτε υπολογιστικό φύλλο του Excel και εκτελέστε τη λειτουργία:
=VIESAPI.CONNECT.PRODUCTION("identifier";"key")
όπου οι παράμετροι της συνάρτησης είναι:
identifier
– η παράμετρος πρέπει να περιέχει το αναγνωριστικό (ID) που δημιουργείται στον λογαριασμό στον ιστότοπο viesapi.eu,key
– η παράμετρος πρέπει να περιέχει το κλειδί που δημιουργείται στον λογαριασμό στον ιστότοπο viesapi.eu.
Λεπτομέρειες σχετικά με τη δημιουργία του αναγνωριστικού και του κλειδιού περιγράφονται στο Τεκμηρίωση δικτυακός τόπος.
Για να επαληθευτεί η ορθότητα της σύνδεσης με ένα δεδομένο API (δοκιμή ή παραγωγή), θα πρέπει να εκτελεστεί η ακόλουθη λειτουργία:
=VIESAPI.CONNECT.STATUS()
Το οποίο μπορεί να επιστρέψει τιμές:
SUCCESS: Production
– εάν το πρόσθετο έχει ρυθμιστεί σωστά για να λειτουργεί με το περιβάλλον παραγωγής,SUCCESS: Test
– εάν το πρόσθετο έχει ρυθμιστεί σωστά για να λειτουργεί με το περιβάλλον δοκιμής,
ERROR: Connection requires configuration
– σε περίπτωση λανθασμένης διαμόρφωσης.
Από προεπιλογή, κάθε έγγραφο του Excel έχει ρυθμιστεί να υπολογίζει αυτόματα το υπολογιστικό φύλλο. Η ρύθμιση αυτής της επιλογής υποδηλώνει ότι όλοι οι τύποι καλούνται όταν γίνονται αλλαγές που επηρεάζουν τον τύπο. Ένα παράδειγμα αυτού είναι η διαγραφή μιας σειράς σε ένα φύλλο εργασίας.
Για να αποφύγετε την αυτόματη κλήση όλων των λειτουργιών που ορίζονται σε ένα δεδομένο φύλλο, η οποία σχετίζεται με την αυτόματη αποστολή ερωτημάτων στο API του ιστότοπου veisapi.eu, αλλάξτε την επιλογή υπολογισμού βιβλίου εργασίας σε Μη αυτόματη:
- Από το
File
μενού, επιλέγωOptions
- Επισημάνετε το
Formulas
αυτί - Στην ενότητα Επιλογές υπολογισμού, επιλέξτε τη ρύθμιση:
Manual
και καταργήστε την επιλογή η πρόσθετη επιλογή:Recalculate the workbook before saving
. - Είναι απαραίτητο να αποθηκεύσετε τις αλλαγές που έγιναν στο φύλλο.
Με το υπολογιστικό φύλλο Excel διαμορφωμένο με τέτοιο τρόπο, για να αναγκάσετε την ανανέωση όλων των καθορισμένων τύπων, πατήστε το συνδυασμό πλήκτρων:
CTRL + ALT + SHIFT + F9
Ενημερώστε την προσθήκη στην πιο πρόσφατη έκδοση
Προσοχή!Η ακόλουθη διαδικασία για την ενημέρωση του πρόσθετου Excel λειτουργεί σωστά για τις εκδόσεις MS Excel 2019, 2021 και Excel 365, όπου το πρόσθετο μπορεί να εγκατασταθεί από το Microsoft Store.
Προσοχή! Μετά την εγκατάσταση της πιο πρόσφατης έκδοσης, πρέπει να διαμορφώσετε ξανά το πρόσθετο, δηλαδή να εισάγετε και να αποθηκεύσετε το αναγνωριστικό και το κλειδί.
Για να εγκαταστήσετε την πιο πρόσφατη έκδοση του πρόσθετου Excel, ακολουθήστε τα εξής βήματα:
1. Ελέγξτε την έκδοση του εγκατεστημένου πρόσθετου καλώντας τον τύπο =VIESAPI.VERSION()
. Η τελευταία έκδοση του πρόσθετου είναι η 1.2.8
2. Εκκαθάριση της προσωρινής μνήμης του MS Excel, σύμφωνα με τη διαδικασία που περιγράφεται στην επίσημη σελίδα τεκμηρίωσης: https://learn.microsoft.com/en-us/office/dev/add-ins/testing/clear-cache
3. Αφού ολοκληρώσετε όλα τα βήματα από το σημείο 2, επανεκκινήστε την εφαρμογή MS Excel.
4. Κατά την επανεκκίνηση, η εφαρμογή MS Excel θα πραγματοποιήσει λήψη της πιο πρόσφατης έκδοσης του πρόσθετου από το Microsoft Store.
5. Διαμορφώστε το πρόσθετο εισάγοντας το αναγνωριστικό και το κλειδί που λήφθηκαν αφού συνδεθείτε στον λογαριασμό σας στο δικτυακός τόπος – Καρτέλα «API Keys».
Χρήση
Παρακολουθήστε πώς να επαληθεύετε αυτόματα και μαζικά την κατάσταση ΦΠΑ στην ΕΕ των εταιρειών στο σύστημα VIES χρησιμοποιώντας το πρόσθετο Excel:
Πριν χρησιμοποιήσετε το πρόσθετο, θα πρέπει να εξοικειωθείτε με τις ιδιαιτερότητες της λειτουργίας του:
- Όλες οι κλήσεις συναρτήσεων εκτελούνται σε ασύγχρονη λειτουργία, η οποία δεν προκαλεί το φαινόμενο παγώματος (χωρίς απόκριση) της εφαρμογής Excel.
- Η προσθήκη (εισαγωγή) μιας γραμμής ή στήλης δεν ανανεώνει όλες τις καθορισμένες κλήσεις συναρτήσεων.
- Η αντιγραφή ή η μετακίνηση κελιών που περιέχουν συναρτήσεις δεν ανανεώνει τις κλήσεις καθορισμένων λειτουργιών.
- Η διαγραφή μιας γραμμής ή στήλης θα ανανεώσει όλες τις καθορισμένες κλήσεις συναρτήσεων και θα στείλει ερωτήματα στο viesApi.eu (μόνο στην περίπτωση των προεπιλεγμένων ρυθμίσεων του Excel). Η περιγραφή της αλλαγής των προεπιλεγμένων ρυθμίσεων περιλαμβάνεται στο κεφάλαιο Διαμόρφωση.
- Προσοχή! Δεν συνιστάται η εκτέλεση περισσότερων από 500 παράλληλων ερωτημάτων, επειδή το Excel αντιμετωπίζει προβλήματα με το χειρισμό μεγάλου αριθμού ασύγχρονων κλήσεων.
Λάβετε εταιρικά δεδομένα από το VIES
VIESAPI.VIES.DATA()
– Η συνάρτηση ανακτά όλα τα διαθέσιμα εταιρικά δεδομένα απευθείας από το σύστημα VIES. Οι παράμετροι πρέπει να είναι:
- Ευρωπαϊκός αριθμός φορολογικού μητρώου (ΦΠΑ ΕΕ),
- (προαιρετικός)
FORMAT
των δεδομένων που επιστράφηκαν (δείτε: Ετικέτες που μπορούν να χρησιμοποιηθούν ωςFORMAT
παράμετρος).
=VIESAPI.VIES.DATA("PL7171642051")
Εάν χρειάζεστε μόνο την κατάσταση της εταιρείας στο VIES, χρησιμοποιήστε το ακόλουθο ερώτημα:
=VIESAPI.VIES.DATA("PL7171642051";"$(Valid)")
Εάν η κατάσταση που επιστράφηκε είναι Ναι, σημαίνει ότι η εταιρεία διαθέτει έγκυρο ΑΦΜ ΕΕ.
Ετικέτες διαθέσιμες στο VIESAPI.VIES.DATA
λειτουργία που μπορεί να χρησιμοποιηθεί ως FORMAT
παράμετρος:
$(UID)
– μοναδικό αναγνωριστικό που δημιουργείται από την υπηρεσία viesApi.eu$(CountryCode)
– κωδικός χώρας$(VATNumber)
– Ευρωπαϊκός αριθμός ΦΠΑ$(Valid)
– απάντηση από την υπηρεσία VIES, η οποία ενημερώνει για το τρέχον καθεστώς ΦΠΑ της ελεγχόμενης εταιρείας στην ΕΕ (Yes
/No
)$(TraderName)
– όνομα καταχώρισης εταιρείας$(TraderCompanyType)
– τύπος επιχείρησης$(TraderAddress)
– διεύθυνση εμπόρου όπου είναι εγγεγραμμένη η εταιρεία$(ID)
– μοναδικό αναγνωριστικό που δημιουργείται από το σύστημα VIES (αριθμός διαβούλευσης)$(Date)
– την ημερομηνία δημιουργίας της απάντησης$(Source)
– η πηγή των δεδομένων
Προεπιλεγμένη μορφή: "$(TraderName), $(TraderAddress)"
Αν η χορδή "JSON"
δίνεται ως το FORMAT
παράμετρο, η συνάρτηση θα επιστρέψει το πλήρες αποτέλεσμα με τη μορφή μιας συμβολοσειράς JSON, η οποία μπορεί να αναλυθεί ελεύθερα και να επεξεργαστεί περαιτέρω:
=VIESAPI.VIES.DATA("PL7171642051";"JSON")
Λήψη αναλυμένων δεδομένων εταιρείας από το VIES
VIESAPI.VIES.DATA.PARSED()
– Η συνάρτηση ανακτά όλα τα διαθέσιμα δεδομένα της εταιρείας απευθείας από το σύστημα VIES. Επιπλέον, το όνομα και η διεύθυνση της εταιρείας επιστρέφονται ως αναλυμένα δεδομένα, χωρισμένα σε ξεχωριστά χαρακτηριστικά. Οι παράμετροι θα πρέπει να είναι:
- Ευρωπαϊκός αριθμός φορολογικού μητρώου (ΦΠΑ ΕΕ),
- (προαιρετικός)
FORMAT
των δεδομένων που επιστράφηκαν (δείτε: Ετικέτες που μπορούν να χρησιμοποιηθούν ωςFORMAT
παράμετρος).
=VIESAPI.VIES.DATA.PARSED("PL7171642051")
Εάν χρειάζεστε μόνο την κατάσταση της εταιρείας στο VIES, χρησιμοποιήστε το ακόλουθο ερώτημα:
=VIESAPI.VIES.DATA.PARSED("PL7171642051";"$(Valid)")
Εάν η κατάσταση που επιστράφηκε είναι Ναι, σημαίνει ότι η εταιρεία διαθέτει έγκυρο ΑΦΜ ΕΕ.
Ετικέτες διαθέσιμες στο VIESAPI.VIES.DATA.PARSED
λειτουργία που μπορεί να χρησιμοποιηθεί ως FORMAT
παράμετρος:
$(UID)
– μοναδικό αναγνωριστικό που δημιουργείται από την υπηρεσία viesApi.eu$(CountryCode)
– κωδικός χώρας$(VATNumber)
– Ευρωπαϊκός αριθμός ΦΠΑ$(Valid)
– απάντηση από την υπηρεσία VIES, η οποία ενημερώνει για το τρέχον καθεστώς ΦΠΑ της ελεγχόμενης εταιρείας στην ΕΕ (Yes
/No
)$(TraderName)
– όνομα καταχώρισης εταιρείας$(TraderNameComponents.Name)
– επωνυμία εταιρείας από traderName (χωρίς νομική μορφή)$(TraderNameComponents.LegalForm)
– όνομα νομικής μορφής που εξάγεται από το traderName (χωρίς το όνομα της εταιρείας)$(TraderNameComponents.LegalFormCanonicalId)
– αναγνωριστικό λεξικού νομικής μορφής$(TraderNameComponents.LegalFormCanonicalName)
– όνομα νομικής μορφής στο λεξικό$(TraderCompanyType)
– τύπος επιχείρησης$(TraderAddress)
– διεύθυνση εμπόρου όπου είναι εγγεγραμμένη η εταιρεία$(TraderAddressComponents.Country)
– όνομα της χώρας εμπόρου στην εθνική της γλώσσα$(TraderAddressComponents.PostalCode)
– ταχυδρομικός κώδικας της διεύθυνσης του εμπόρου$(TraderAddressComponents.City)
– πόλη της διεύθυνσης του εμπόρου$(TraderAddressComponents.Street)
– οδός της διεύθυνσης του εμπόρου$(TraderAddressComponents.StreetNumber)
– αριθμός οδού και κτιρίου της διεύθυνσης του εμπόρου$(TraderAddressComponents.HouseNumber)
– αριθμός διαμερίσματος/γραφείου της διεύθυνσης του εμπόρου$(TraderAddressComponents.Other)
– άλλα στοιχεία διεύθυνσης (όνομα περιοχής, όνομα κτιρίου, αριθμός ορόφου κ.λπ.)$(ID)
– μοναδικό αναγνωριστικό που δημιουργείται από το σύστημα VIES (αριθμός διαβούλευσης)$(Date)
– την ημερομηνία δημιουργίας της απάντησης$(Source)
– η πηγή των δεδομένων
Προεπιλεγμένη μορφή: "$(TraderName), $(TraderAddress)"
Αν η χορδή "JSON"
δίνεται ως το FORMAT
παράμετρο, η συνάρτηση θα επιστρέψει το πλήρες αποτέλεσμα με τη μορφή μιας συμβολοσειράς JSON, η οποία μπορεί να αναλυθεί ελεύθερα και να επεξεργαστεί περαιτέρω:
=VIESAPI.VIES.DATA.PARSED("PL7171642051";"JSON")
Έλεγχος κατάστασης λογαριασμού χρήστη (δωρεάν)
VIESAPI.ACCOUNT.STATUS()
– Η συνάρτηση επιστρέφει βασικές πληροφορίες σχετικά με το πρόγραμμα που χρησιμοποιείται αυτήν τη στιγμή από τον χρήστη. Οι παράμετροι πρέπει να είναι:
- (προαιρετικός)
FORMAT
των δεδομένων που επιστράφηκαν (δείτε: Ετικέτες που μπορούν να χρησιμοποιηθούν ωςFORMAT
παράμετρος)
=VIESAPI.ACCOUNT.STATUS()
Προσοχή! Η κλήση της συνάρτησης δεν αυξάνει τον αριθμό των ερωτημάτων που γίνονται.
Οι ετικέτες που είναι διαθέσιμες στο VIESAPI.ACCOUNT.STATUS
η λειτουργία μπορεί να χρησιμοποιηθεί ως FORMAT
παράμετρος:
$(UID)
– μοναδικό αναγνωριστικό που δημιουργείται από την υπηρεσία viesApi.eu$(BillingPlanName)
– όνομα του τρέχοντος σχεδίου$(SubscriptionPrice)
– μηνιαία συνδρομή$(ItemPrice)
– κόστος ενός μόνο ερωτήματος εκτός του προγράμματος$(ItemPriceStatus)
– κόστος ανά ερώτημα – ΦΠΑ/VIES/Κατάσταση δραστηριότητας εταιρείας$(ItemPriceParsed)
– κόστος ανά ερώτημα – Κατάσταση ΦΠΑ/VIES/δραστηριότητας εταιρείας με αναλυμένα δεδομένα$(Limit)
– μέγιστος αριθμός ερωτημάτων στο σχέδιο$(RequestDelay)
– ελάχιστο χρονικό διάστημα μεταξύ ερωτημάτων$(DomainLimit)
– μέγιστος αριθμός τομέων (κλειδιά API)$(OverPlanAllowed)
– δυνατότητα υπέρβασης του μέγιστου αριθμού ερωτημάτων στο σχέδιο$(ExcelAddIn)
– πρόσβαση στο πρόσθετο του MS Excel$(Stats)
– πρόσβαση σε στατιστικά στοιχεία ερωτημάτων$(NIPMonitor)
– πρόσβαση στην παρακολούθηση της κατάστασης των εταιρειών: ΦΠΑ/VIES/Κατάσταση δραστηριότητας$(FuncGetVIESData)
– πρόσβαση σε λειτουργίες που επαληθεύουν την κατάσταση της εταιρείας στο σύστημα VIES$(FuncGetVIESDataParsed)
– πρόσβαση σε λειτουργίες που επαληθεύουν την κατάσταση της εταιρείας στο σύστημα VIES και αναλύουν το όνομα και τη διεύθυνση του συναλλασσόμενου$(VIESDataCount)
– αριθμός ερωτημάτων VIES που πραγματοποιήθηκαν αυτόν τον μήνα$(VIESDataParsedCount)
– αριθμός ερωτημάτων VIES με αναλυμένα δεδομένα που πραγματοποιήθηκαν αυτόν τον μήνα$(TotalCount)
– συνολικός αριθμός ερωτημάτων που πραγματοποιήθηκαν αυτόν τον μήνα
Προεπιλεγμένη ΜΟΡΦΗ: "Name of the current tariff plan: $(BillingPlanName), Monthly subscription net price: $(SubscriptionPrice), Maximum number of inquiries in the plan: $(Limit), Total number of queries made in the current month: $(TotalCount)"
Αν η χορδή "JSON"
δίνεται ως το FORMAT
παράμετρο, η συνάρτηση θα επιστρέψει το πλήρες αποτέλεσμα με τη μορφή συμβολοσειράς JSON, η οποία μπορεί να αναλυθεί ελεύθερα και να επεξεργαστεί περαιτέρω.
Έλεγχος κατάστασης συστήματος VIES (δωρεάν)
VIESAPI.VIES.STATUS()
– Αυτή η συνάρτηση σάς επιτρέπει να επαληθεύσετε την τρέχουσα κατάσταση του συστήματος VIES. Επιστρέφει μια συνολική κατάσταση που υποδεικνύει τη διαθεσιμότητα, καθώς και μια λίστα με τις μεμονωμένες χώρες-μέλη μαζί με την τρέχουσα κατάσταση διαθεσιμότητας των εθνικών τους συστημάτων. Οι παράμετροι θα πρέπει να είναι:
- (προαιρετικός)
FORMAT
των δεδομένων που επιστράφηκαν (δείτε: Ετικέτες που μπορούν να χρησιμοποιηθούν ωςFORMAT
παράμετρος)
=VIESAPI.VIES.STATUS()
Προσοχή! Η κλήση της συνάρτησης δεν αυξάνει τον αριθμό των ερωτημάτων που γίνονται.
Οι ετικέτες που είναι διαθέσιμες στο VIESAPI.VIES.STATUS
η λειτουργία μπορεί να χρησιμοποιηθεί ως FORMAT
παράμετρος:
$(UID)
– μοναδικό αναγνωριστικό που δημιουργείται από την υπηρεσία viesApi.eu$(Available)
– τρέχουσα διαθεσιμότητα του συστήματος VIES (Διαθέσιμο, Μερικώς διαθέσιμο, Μη διαθέσιμο)$(Countries)
– λίστα με τα κράτη-μέλη (Διαθέσιμο, Μη διαθέσιμο)$(AT), $(FR), $(PL), etc.
– κατάσταση διαθεσιμότητας μιας συγκεκριμένης χώρας-μέλους (χρησιμοποιήστε κεφαλαίο κωδικό χώρας 2 γραμμάτων ως τιμή ετικέτας)
Προεπιλεγμένη ΜΟΡΦΗ: "$(Available)"
Αν η χορδή "JSON"
δίνεται ως το FORMAT
παράμετρο, η συνάρτηση θα επιστρέψει το πλήρες αποτέλεσμα με τη μορφή συμβολοσειράς JSON, η οποία μπορεί να αναλυθεί ελεύθερα και να επεξεργαστεί περαιτέρω.
Άλλες χρήσιμες λειτουργίες (δωρεάν)
VIESAPI.ACCOUNT.STATUS.TOTAL()
– Η συνάρτηση επιστρέφει πληροφορίες σχετικά με τον συνολικό αριθμό ερωτήσεων που έγιναν τον τρέχοντα μήνα χρέωσης για έναν συγκεκριμένο λογαριασμό (όλα τα κλειδιά API). Επιστρέφει ακριβώς τον ίδιο αριθμό με το $(TotalCount)
ετικέτα στο VIESAPI.STATUS.ACCOUNT()
λειτουργία.
VIESAPI.ACCOUNT.STATUS.LIMIT()
– Η συνάρτηση επιστρέφει πληροφορίες σχετικά με τον μέγιστο αριθμό των διαθέσιμων ερωτημάτων στο σχέδιο που έχει επιλέξει ο χρήστης. Επιστρέφει ακριβώς τον ίδιο αριθμό με το $(Limit)
ετικέτα μέσα VIES.STATUS.ACCOUNT()
λειτουργία
VIESAPI.EUVAT.NORM()
– Αυτή η δυνατότητα διορθώνει και μορφοποιεί τον ΑΦΜ ΕΕ (καταργεί κενά και παύλες κ.λπ.) εκτός σύνδεσης και δεν ανακτά δεδομένα από το VIES:
=VIESAPI.EUVAT.NORM("PL 717-164-20-51")
VIESAPI.EUVAT.VALID()
– Η συνάρτηση ελέγχει μόνο την ορθότητα (σύνταξη, άθροισμα ελέγχου) του ΑΦΜ ΕΕ εκτός σύνδεσης και δεν ανακτά δεδομένα από το σύστημα VIES. Επιστροφές TRUE
εάν ο αριθμός είναι έγκυρος ή FALSE
εάν δεν ισχύει:
=VIESAPI.EUVAT.VALID("PL7171642051")
VIESAPI.CONNECTION.STATE()
– Η συνάρτηση επιστρέφει την τρέχουσα κατάσταση της διαμόρφωσης του πρόσθετου.
Εάν η συνάρτηση επιστρέψει την ακόλουθη τιμή, σημαίνει, μεταξύ άλλων ότι η ID
και API key
δεν σώθηκαν:
ERROR: Connection requires configuration
Μετά την αποθήκευση του API ID
και key
, η συνάρτηση θα πρέπει να επιστρέψει το ακόλουθο μήνυμα:
SUCCESS: Production