Πρόσθετο VIES για το Google Sheets™

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

Αυτή η τεκμηρίωση περιέχει οδηγίες σχετικά με τον τρόπο ενσωμάτωσης της εφαρμογής Google Sheets™ με το σύστημα VIES API.

 

 

Εγκατάσταση και διαμόρφωση

Εγκατάσταση

Μετά την είσοδό σας στον ιστότοπο του Google Workspace Marketplace https://workspace.google.com/marketplace/app/vies_api_eu_vat_validation/1043052728267, κάντε κλικ στο Install κουμπί.

Επιλογή του Λογαριασμού Google για τον οποίο θα πρέπει να είναι εγκατεστημένο και διαθέσιμο το πρόσθετο VIES Validator Google Sheets:

Στην επόμενη οθόνη μπορείτε να διαβάσετε το Πολιτική Απορρήτου και το ισχύον Όροι χρήσης, καθώς και το εύρος των δεδομένων σας που θα επεξεργαστούμε. Για να προχωρήσετε στο επόμενο βήμα της εγκατάστασης, πατήστε το Continue κουμπί.

Επιβεβαιώστε ότι έχετε παραχωρήσει τα απαραίτητα δικαιώματα για να λειτουργήσει σωστά το πρόσθετο και πατήστε το Allow κουμπί:

Το πρόσθετο VIES Validation έχει εγκατασταθεί με επιτυχία στον λογαριασμό σας και θα είναι διαθέσιμο μετά την εκκίνηση των Υπολογιστικών Φύλλων Google στην καρτέλα Επεκτάσεις. Για να συνεχίσετε, κάντε κλικ στο Next:

Η τελική οθόνη του προγράμματος εγκατάστασης θα σας ζητήσει να διαμορφώσετε το πρόσθετο. Κάνοντας κλικ στο "Complete additional setup nowΟ σύνδεσμος "" θα ανοίξει ένα νέο παράθυρο προγράμματος περιήγησης με την τρέχουσα σελίδα τεκμηρίωσης. Κάντε κλικ στο Done και ξεκινήστε τη διαμόρφωση του πρόσθετου όπως περιγράφεται στην ενότητα Διαμόρφωση.

Διαμόρφωση

Μετά την εγκατάσταση, το πρόσθετο έχει οριστεί στο δοκιμαστικό περιβάλλον από προεπιλογή (περισσότερες λεπτομέρειες για Test API σελίδα). Για να μπορείτε να καλείτε συναρτήσεις στο περιβάλλον παραγωγής, είναι απαραίτητο να διαμορφώσετε μία φορά την πρόσβαση στον ιστότοπο viesapi.eu. Για να το κάνετε αυτό, μεταβείτε σε οποιοδήποτε υπολογιστικό φύλλο Google Sheets™ και εκτελέστε τη συνάρτηση:

=VIESAPI_CONNECT_PRODUCTION("identifier";"key")

όπου οι παράμετροι της συνάρτησης είναι:

• identifier – η παράμετρος πρέπει να περιέχει το αναγνωριστικό (ID) που δημιουργείται στον λογαριασμό στον ιστότοπο viesapi.eu,
• key – η παράμετρος πρέπει να περιέχει το κλειδί που δημιουργείται στον λογαριασμό στον ιστότοπο viesapi.eu.

Λεπτομέρειες σχετικά με τη δημιουργία του αναγνωριστικού και του κλειδιού περιγράφονται στο Τεκμηρίωση δικτυακός τόπος.

Για να επαληθευτεί η ορθότητα της σύνδεσης με ένα δεδομένο API (δοκιμή ή παραγωγή), θα πρέπει να εκτελεστεί η ακόλουθη λειτουργία:

=VIESAPI_CONNECT_STATUS()

Το οποίο μπορεί να επιστρέψει τιμές:

• SUCCESS: Production – εάν το πρόσθετο έχει ρυθμιστεί σωστά για να λειτουργεί με το περιβάλλον παραγωγής,
• SUCCESS: Test – εάν το πρόσθετο έχει ρυθμιστεί σωστά για να λειτουργεί με το περιβάλλον δοκιμής,

• ERROR: Connection requires configuration – σε περίπτωση λανθασμένης διαμόρφωσης.

Αν προτιμάτε διαμόρφωση πλευρικής γραμμής, κάντε κλικ στο Extensions καρτέλα και, στη συνέχεια, επιλέξτε VIES API - EU VAT Validation και τέλος κάντε κλικ Show sidebar για να ενεργοποιήσετε την πλαϊνή μπάρα:

Στη συνέχεια, πηγαίνετε στο ID and Key καρτέλα για να εισαγάγετε το ID και Key στα κατάλληλα πεδία κειμένου, τα οποία είναι διαθέσιμα μετά τη σύνδεση στον λογαριασμό σας VIES API: https://viesapi.eu/sign-in/

Χρήση

Πριν χρησιμοποιήσετε το πρόσθετο, θα πρέπει να εξοικειωθείτε με τις ιδιαιτερότητες της λειτουργίας του:

• Όλες οι κλήσεις συναρτήσεων εκτελούνται σε ασύγχρονη λειτουργία, η οποία δεν προκαλεί το φαινόμενο παγώματος (καμία απόκριση) της εφαρμογής Google Sheets™.
• Η προσθήκη (εισαγωγή) μιας γραμμής ή στήλης δεν ανανεώνει όλες τις καθορισμένες κλήσεις συναρτήσεων.
• Η αντιγραφή ή η μετακίνηση κελιών που περιέχουν συναρτήσεις δεν ανανεώνει τις κλήσεις καθορισμένων λειτουργιών.
• Η διαγραφή μιας γραμμής ή στήλης θα ανανεώσει όλες τις καθορισμένες κλήσεις συναρτήσεων και θα στείλει ερωτήματα στο viesApi.eu (μόνο στην περίπτωση των προεπιλεγμένων ρυθμίσεων των Υπολογιστικών Φύλλων Google™). Η περιγραφή της αλλαγής των προεπιλεγμένων ρυθμίσεων περιλαμβάνεται στο κεφάλαιο Διαμόρφωση.
• Προσοχή! Δεν συνιστάται η εκτέλεση περισσότερων από 500 παράλληλων ερωτημάτων, επειδή το Google Sheets™ αντιμετωπίζει προβλήματα με τη διαχείριση μεγάλου αριθμού ασύγχρονων κλήσεων.

Λάβετε εταιρικά δεδομένα από το 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) – πρόσβαση στο πρόσθετο Google Sheets™ και Microsoft 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

Το Google Sheets™ είναι εμπορικό σήμα της Google LLC.