Il componente aggiuntivo Excel consente di controllare in modo rapido e automatico le entità (appaltatori) utilizzando il foglio di calcolo Excel in termini di stato corrente nel sistema VIES.

Questo capitolo contiene istruzioni su come integrare l'applicazione Microsoft Excel con il sistema nip24.pl. Il componente aggiuntivo fornito è stato testato con successo nelle seguenti versioni di MS Excel: 2007, 2010, 2013, 2016, 2019 (sui sistemi operativi Windows e MacOS) e 2021 (sui sistemi operativi Windows e MacOS) e la versione web di Excel365.

L'ultima versione del componente aggiuntivo per Excel 2007, 2010, 2013, 2016 e 2019 è sempre disponibile per il download dal Scarica pagina. Il componente aggiuntivo può essere installato sia nelle versioni a 32 bit che a 64 bit di Excel. Attenzione! Seleziona la versione (32 o 64 bit) che corrisponde alla versione di Excel, non il sistema operativo.

Per scaricare e installare il componente aggiuntivo per MacOS ed Excel 2021 per Windows ed Excel365, visitare il Microsoft Store ufficiale: https://appsource.microsoft.com.

È possibile verificare la piena funzionalità del componente aggiuntivo di Excel: senza la necessità di creare un account – utilizzando il fornito API di prova. La pagina descrive anche come configurare un componente aggiuntivo di Excel da utilizzare nell'API fornita per il test.

L'utilizzo dell'add-in nell'API di produzione richiede la creazione di un account sul sito viesapi.eu, l'acquisto di un minimo del piano Business e la generazione di una chiave e del relativo identificatore. Il processo di registrazione e creazione di un account, nonché la generazione di chiavi è stato descritto in Documentazione sito web.

Installazione e configurazione per MS Excel 2021 ed Excel 365 da Microsoft Store (AppSource)

Installazione

Dopo aver effettuato l'accesso al sito Web del Microsoft Store ufficiale https://appsource.microsoft.com, clicca il Get it now pulsante.

Verrà visualizzata una finestra di accesso in cui è necessario inserire l'indirizzo e-mail per il quale è stato creato un account con Microsoft (privato o aziendale). Se non si dispone di tale account, è possibile crearne uno e continuare il processo di installazione oppure interrompere l'installazione e utilizzare l'opzione per installare il componente aggiuntivo in uno dei modi descritti sopra.

Per scaricare e installare il componente aggiuntivo da Excel 2021 o Excel 365 (web), vai al Insert [1], trova la sezione Componenti aggiuntivi e fai clic su OfficeAdd-ins pulsante [2]. Quindi, nella finestra aperta, inserisci la parola 'viesapi ′ [3] nel campo di ricerca e premere l'icona della lente d'ingrandimento. Un componente aggiuntivo chiamato "VIES API - EU VAT Validation” dovrebbe essere trovato, che dovrebbe essere installato facendo clic su Add pulsante [4]. Tutti i passaggi precedenti sono illustrati nello screenshot qui sotto:

Dopo aver cliccato su Add , dovrebbe apparire una schermata in cui è possibile leggere i termini della licenza e le regole di protezione della privacy.

Per avviare l'installazione del componente aggiuntivo, premere Continue pulsante.

Configurazione

Dopo aver installato correttamente il plugin, dovresti vedere una schermata simile a quella presentata di seguito. Nel Home menu [1], trova l'icona che rappresenta il VIES API Panel [2] e fare clic su di esso per visualizzare il pannello laterale. Immediatamente dopo l'installazione, il componente aggiuntivo è configurato per funzionare in un ambiente di test - dettagli su Pagina API di prova. L'utilizzo del componente aggiuntivo in modalità test non richiede la creazione di un account sul viesapi.eu sito web.

Per passare il componente aggiuntivo all'ambiente di produzione, fare clic su ID and key [3] e inserire il Key e chiave ID, che puoi trovare dopo aver effettuato l'accesso al tuo account sul sito viesapi.eu nella sezione “API Keysscheda ". Dopo aver inserito entrambi i valori, premere il tasto Save pulsante.

Se non disponi ancora di un account sul nostro sito Web, fai clic sul collegamento all'indirizzo viesapi.eu [4] ed eseguire il processo di registrazione, che è descritto in dettaglio sul Documentazione pagina.

Installazione e configurazione per Excel: 2007, 2010, 2013, 2016 e 2019

Installazione

Ottieni l'ultima versione del componente aggiuntivo per Excel 2007, 2010, 2013, 2016 e 2019 dal Scarica pagina. Avvia MS Excel e vai su File> Options, quindi selezionare Add-ins [1] dal menu.

Nella parte inferiore delle impostazioni, seleziona Excel Add-ins [2] e fare clic su Go pulsante [3].

Gli utenti avanzati possono aggiungere un componente aggiuntivo da Developer scheda [1], quindi fare clic Excel Add-ins [2] e fare clic su Browse Pulsante [3]:

Nel Add-ins finestra, fare clic su Browse pulsante, vai alla directory in cui il viesapi-ms-excel-addin-version-number.zip il file è stato decompresso e selezionare:

• viesapiExcel.xll – per la versione a 32 bit di Excel,
• viesapiExcel64.xll – per la versione a 64 bit di Excel.

Il corretto caricamento del componente aggiuntivo è mostrato nella figura seguente [1].

È sufficiente fare clic su OK pulsante [2] per rendere disponibili in Excel le funzioni implementate nel componente aggiuntivo.

Configurazione

Dopo l'installazione, il plug-in è impostato sull'ambiente di test per impostazione predefinita (maggiori dettagli su API di prova pagina). Per poter richiamare le funzioni nell'ambiente di produzione, è necessario configurare una volta l'accesso al sito viesapi.eu. Per fare ciò, vai su qualsiasi foglio di calcolo Excel ed esegui la funzione:

=VIESAPI.CONNECT.PRODUCTION("identifier";"key")

dove i parametri della funzione sono:

• identifier – il parametro deve contenere l'identificativo (ID) generato sull'account sul sito viesapi.eu,
• key – il parametro deve contenere la Chiave generata sull'account sul sito viesapi.eu.

I dettagli sulla generazione dell'identificatore e della chiave sono descritti in Documentazione sito web.

Al fine di verificare la correttezza della connessione con una determinata API (test o produzione), è necessario eseguire la seguente funzione:

=VIESAPI.CONNECT.STATUS()

Che può restituire valori:

• SUCCESS: Production – se il componente aggiuntivo è configurato correttamente per funzionare con l'ambiente di produzione,
• SUCCESS: Test – se il componente aggiuntivo è configurato correttamente per funzionare con il file ambiente di test,

• ERROR: Connection requires configuration – in caso di configurazione errata.

Per impostazione predefinita, ogni documento Excel è impostato per calcolare automaticamente il foglio di calcolo. L'impostazione di questa opzione implica che tutte le formule vengano chiamate quando vengono apportate modifiche che influiscono sulla formula. Un esempio di ciò è eliminare una riga su un foglio di lavoro.

Per evitare il richiamo automatico di tutte le funzioni definite in un dato foglio, che è correlato all'invio automatico di query all'API del sito veisapi.eu, modificare l'opzione di calcolo della cartella di lavoro in Manuale:

1. Dal File menù, Selezionare Options
2. Evidenzia il Formulas scheda
3. Nella sezione Opzioni di calcolo, seleziona l'impostazione: Manual e deseleziona l'opzione aggiuntiva: Recalculate the workbook before saving.
4. È necessario salvare le modifiche apportate nel foglio.

Con il foglio Excel così configurato, per forzare l'aggiornamento di tutte le formule definite, premere la combinazione di tasti:

CTRL + ALT + SHIFT + F9

Aggiorna il plugin all'ultima versione

Attenzione!La seguente procedura per l'aggiornamento del componente aggiuntivo di Excel funziona correttamente per le versioni MS Excel 2019, 2021 ed Excel 365, in cui il componente aggiuntivo può essere installato da Microsoft Store.

Attenzione! Dopo aver installato l'ultima versione, è necessario riconfigurare il componente aggiuntivo, ovvero immettere e salvare l'ID e la chiave.

Per installare la versione più recente del componente aggiuntivo di Excel, seguire questi passaggi:

1. Controllare la versione del componente aggiuntivo installato chiamando la formula =VIESAPI.VERSION()L'ultima versione del componente aggiuntivo è 1.2.8

2. Cancellare la cache di MS Excel, secondo la procedura descritta nella pagina della documentazione ufficiale: https://learn.microsoft.com/en-us/office/dev/add-ins/testing/clear-cache

3. Dopo aver completato tutti i passaggi dal punto 2, riavviare l'applicazione MS Excel.

4. Durante il riavvio, l'applicazione MS Excel scaricherà la versione più recente del componente aggiuntivo da Microsoft Store.

5. Configura il componente aggiuntivo inserendo l'ID e la chiave scaricati dopo aver effettuato l'accesso al tuo account sul nostro sito web – Scheda “Chiavi API”.

Utilizzo

Guarda come verificare automaticamente e in modo massiccio lo stato IVA UE delle società nel sistema VIES utilizzando il nostro componente aggiuntivo Excel:

Prima di utilizzare il componente aggiuntivo, dovresti familiarizzare con le specifiche del suo funzionamento:

• Tutte le chiamate di funzione vengono eseguite in modalità asincrona, che non provoca l'effetto di blocco (nessuna risposta) dell'applicazione Excel.
• L'aggiunta (inserimento) di una riga o di una colonna non aggiorna tutte le chiamate di funzione definite.
• La copia o lo spostamento di celle che contengono funzioni non aggiorna le chiamate di funzione definite.
• L'eliminazione di una riga o di una colonna aggiornerà tutte le chiamate di funzione definite e invierà query a viesApi.eu (solo nel caso delle impostazioni predefinite di Excel). La descrizione della modifica delle impostazioni predefinite è inclusa nel capitolo Configurazione.
• Attenzione! Non è consigliabile eseguire più di 500 query parallele perché Excel ha problemi a gestire un numero elevato di chiamate asincrone.

Ottieni i dati aziendali da VIES

VIESAPI.VIES.DATA() – La funzione recupera tutti i dati aziendali disponibili direttamente dal sistema VIES. I parametri dovrebbero essere:

• codice fiscale europeo (IVA UE),
• (opzionale) FORMAT dei dati restituiti (vedi: Tag che possono essere utilizzati come file FORMAT parametro).

=VIESAPI.VIES.DATA("PL7171642051")

Se hai solo bisogno dello stato dell'azienda in VIES, utilizza la seguente query:

=VIESAPI.VIES.DATA("PL7171642051";"$(Valid)")

Se lo stato restituito è Sì, significa che l'azienda ha una partita IVA UE valida.

Tag disponibili nel VIESAPI.VIES.DATA funzione che può essere utilizzata come FORMAT parametro:

• $(UID) – Identificatore univoco generato dal servizio viesApi.eu
• $(CountryCode) - Prefisso internazionale
• $(VATNumber) – Partita IVA europea
• $(Valid) – Stato valido Partita IVA UE (Yes/No)
  
• $(TraderName) – Nome del contraente/fornitore
• $(TraderCompanyType) - Tipo di affari
• $(TraderAddress) – Indirizzo della controparte
• $(ID) – Identificatore univoco generato dal sistema VIES
• $(Date) – La data in cui è stata generata la risposta
• $(Source) – La fonte dei dati

Formato predefinito: "$(TraderName), $(TraderAddress)"

Se la stringa "JSON" è dato come il FORMAT parametro, la funzione restituirà il risultato completo sotto forma di una stringa JSON, che può essere liberamente analizzata ed elaborata ulteriormente:

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

Controllo dello stato dell'account utente (gratuito)

VIESAPI.STATUS.ACCOUNT() – La funzione restituisce le informazioni di base sul piano attualmente utilizzato dall'utente. I parametri dovrebbero essere:

• (opzionale) FORMAT dei dati restituiti (vedi: Tag che possono essere utilizzati come file FORMAT parametro)

=VIESAPI.STATUS.ACCOUNT()

Attenzione! La chiamata della funzione non aumenta il numero di query effettuate.

I tag disponibili in VIESAPI.STATUS.ACCOUNT la funzione può essere utilizzata come FORMAT parametro:

• $(BillingPlanName) – Nome del piano tariffario attuale
• $(SubscriptionPrice) – Prezzo netto dell'abbonamento mensile
• $(ItemPrice) – Costo netto di richiesta singola fuori piano nel piano standard
• $(ItemPriceStatus) – Costo netto di una singola richiesta – VIES / Stato aziendale dell'entità in un piano individuale
• $(Limit) – Il numero massimo di query nel piano
• $(RequestDelay) – L'intervallo di tempo minimo tra le richieste
• $(DomainLimit) – Numero massimo di domini (chiavi API)
• $(OverPlanAllowed) – Possibilità di superare il numero massimo di query nel piano
• $(ExcelAddIn) – Accesso tramite il componente aggiuntivo MS Excel
• $(Stats) – Accesso alle statistiche delle query eseguite
• $(NIPMonitor) – Accesso al monitoraggio dello stato VIES
• $(SearchByNIP) – Ricerca per partita IVA UE
• $(FuncGetVIESData) – Accesso a funzioni che controllano lo stato dell'entità nel sistema VIES
• $(VIESStatusCount) – Numero di richieste effettuate sullo stato dell'entità nel sistema VIES
• $(TotalCount) – Numero totale di query eseguite nel mese corrente

FORMATO predefinito: "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)"

Se la stringa "JSON" è dato come il FORMAT parametro, la funzione restituirà il risultato completo sotto forma di una stringa JSON, che può essere liberamente analizzata ed elaborata ulteriormente.

Altre utili funzioni (gratuite)

VIESAPI.ACCOUNT.STATUS.TOTAL() – La funzione restituisce informazioni sul numero totale di richieste effettuate nel mese di fatturazione corrente per un determinato account (tutte le chiavi API). Restituisce esattamente lo stesso numero di $(TotalCount) tag nel VIESAPI.STATUS.ACCOUNT() funzione.

VIESAPI.ACCOUNT.STATUS.LIMIT() – La funzione restituisce informazioni sul numero massimo di query disponibili nel piano selezionato dall'utente. Restituisce esattamente lo stesso numero di $(Limit) taggati VIES.STATUS.ACCOUNT() funzione

VIESAPI.EUVAT.NORM() – Questa funzione corregge e formatta la partita IVA UE (rimuove spazi e trattini ecc.) offline e non recupera alcun dato da VIES:

=VIESAPI.EUVAT.NORM("PL 717-164-20-51")

VIESAPI.EUVAT.VALID() – La funzione controlla solo offline la correttezza (sintassi, checksum) della partita IVA UE e non recupera alcun dato dal sistema VIES. ritorna TRUE se il numero è valido o FALSE se non è valido:

=VIESAPI.EUVAT.VALID("PL7171642051")

VIESAPI.CONNECTION.STATE() – La funzione restituisce lo stato corrente della configurazione del componente aggiuntivo.

Se la funzione restituisce il seguente valore, significa, tra l'altro, che il ID e API key non sono stati salvati:

ERROR: Connection requires configuration

Dopo aver salvato il API ID e key, la funzione dovrebbe restituire il seguente messaggio:

SUCCESS: Production