Το πρόσθετο Excel σάς επιτρέπει να ελέγχετε γρήγορα και αυτόματα οντότητες (εργολάβους) χρησιμοποιώντας το υπολογιστικό φύλλο Excel όσον αφορά την τρέχουσα κατάστασή τους στο σύστημα VIES.

Αυτό το κεφάλαιο περιέχει οδηγίες για τον τρόπο ενσωμάτωσης της εφαρμογής Microsoft Excel με το σύστημα nip24.pl. Το παρεχόμενο πρόσθετο έχει δοκιμαστεί με επιτυχία στις ακόλουθες εκδόσεις του 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], βρείτε την ενότητα Πρόσθετα και κάντε κλικ στο OfficeAdd-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, αλλάξτε την επιλογή υπολογισμού βιβλίου εργασίας σε Μη αυτόματη:

1. Από το File μενού, επιλέγω Options
2. Επισημάνετε το Formulas αυτί
3. Στην ενότητα Επιλογές υπολογισμού, επιλέξτε τη ρύθμιση: Manual και καταργήστε την επιλογή η πρόσθετη επιλογή: Recalculate the workbook before saving.
4. Είναι απαραίτητο να αποθηκεύσετε τις αλλαγές που έγιναν στο φύλλο.

Με το υπολογιστικό φύλλο 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) – Έγκυρο καθεστώς ΑΦΜ ΕΕ (Yes/No)
  
• $(TraderName) – Όνομα εργολάβου/προμηθευτή
• $(TraderCompanyType) – Είδος επιχείρησης
• $(TraderAddress) – Διεύθυνση αντισυμβαλλόμενου
• $(ID) – Μοναδικό αναγνωριστικό που δημιουργείται από το σύστημα VIES
• $(Date) – Η ημερομηνία δημιουργίας της απάντησης
• $(Source) – Η πηγή των δεδομένων

Προεπιλεγμένη μορφή: "$(TraderName), $(TraderAddress)"

Αν η χορδή "JSON" δίνεται ως το FORMAT παράμετρο, η συνάρτηση θα επιστρέψει το πλήρες αποτέλεσμα με τη μορφή μιας συμβολοσειράς JSON, η οποία μπορεί να αναλυθεί ελεύθερα και να επεξεργαστεί περαιτέρω:

=VIESAPI.VIES.DATA("PL7171642051";"JSON")

Έλεγχος κατάστασης λογαριασμού χρήστη (δωρεάν)

VIESAPI.STATUS.ACCOUNT() – Η συνάρτηση επιστρέφει βασικές πληροφορίες σχετικά με το πρόγραμμα που χρησιμοποιείται αυτήν τη στιγμή από τον χρήστη. Οι παράμετροι πρέπει να είναι:

• (προαιρετικός) FORMAT των δεδομένων που επιστράφηκαν (δείτε: Ετικέτες που μπορούν να χρησιμοποιηθούν ως FORMAT παράμετρος)

=VIESAPI.STATUS.ACCOUNT()

Προσοχή! Η κλήση της συνάρτησης δεν αυξάνει τον αριθμό των ερωτημάτων που γίνονται.

Οι ετικέτες που είναι διαθέσιμες στο VIESAPI.STATUS.ACCOUNT η λειτουργία μπορεί να χρησιμοποιηθεί ως FORMAT παράμετρος:

• $(BillingPlanName) – Όνομα του τρέχοντος τιμολογίου
• $(SubscriptionPrice) – Καθαρή τιμή της μηνιαίας συνδρομής
• $(ItemPrice) – Καθαρό κόστος ενιαίας διερεύνησης εκτός προγράμματος στο τυπικό πρόγραμμα
• $(ItemPriceStatus) – Καθαρό κόστος μιας μεμονωμένης έρευνας – VIES / Επιχειρηματική κατάσταση της οντότητας σε μεμονωμένο πρόγραμμα
• $(Limit) – Ο μέγιστος αριθμός ερωτημάτων στο σχέδιο
• $(RequestDelay) – Το ελάχιστο χρονικό διάστημα μεταξύ των αιτημάτων
• $(DomainLimit) – Μέγιστος αριθμός τομέων (κλειδιά API)
• $(OverPlanAllowed) – Δυνατότητα υπέρβασης του μέγιστου αριθμού ερωτημάτων στο σχέδιο
• $(ExcelAddIn) – Πρόσβαση χρησιμοποιώντας το πρόσθετο MS Excel
• $(Stats) – Πρόσβαση σε στατιστικά στοιχεία των ερωτημάτων που εκτελούνται
• $(NIPMonitor) – Πρόσβαση στην παρακολούθηση της κατάστασης VIES
• $(SearchByNIP) – Αναζήτηση με αριθμό φορολογικού μητρώου ΦΠΑ ΕΕ
• $(FuncGetVIESData) – Πρόσβαση σε λειτουργίες που ελέγχουν την κατάσταση της οντότητας στο σύστημα VIES
• $(VIESStatusCount) – Αριθμός ερωτήσεων που έγιναν σχετικά με την κατάσταση της οντότητας στο σύστημα 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, η οποία μπορεί να αναλυθεί ελεύθερα και να επεξεργαστεί περαιτέρω.

Άλλες χρήσιμες λειτουργίες (δωρεάν)

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