Introdução
A aplicação VIES Checker permite carregar qualquer ficheiro CSV e verificar as entidades (contratantes) que aparecem neste ficheiro quanto ao seu estado atual no Sistema VIES.
O aplicativo lançado foi testado com sucesso nas seguintes versões do MS Windows: 7/8/8.1/10 e 11. O aplicativo pode ser instalado nas versões de 32 e 64 bits do sistema operacional Windows.
A versão mais recente do aplicativo VIES Checker está sempre disponível para download no Download página.
Para usar o aplicativo, você precisa criar uma conta no viesapi.eu
site e gerar uma chave e seu identificador. O processo de registro e criação de uma conta, bem como geração de chaves, foi descrito no Documentação local na rede Internet.
Ativação
Depois de baixar o aplicativo e salvá-lo no seu computador local, descompacte o arquivo ZIP. A versão portátil do aplicativo (viesapi-app-portable.zip
) não requer instalação e pode ser executado usando uma conta de usuário comum (não requer direitos de administrador). A versão do instalador (viesapi-app-setup.exe
) também não requer privilégios administrativos e, para instalá-lo, basta executar o arquivo EXE.
Configuração
Depois de iniciar o aplicativo, é necessário definir as configurações uma vez. Para fazer isso, clique no botão Settings
botão no menu principal.
No Identifier
campo, insira o valor que foi gerado ao criar uma conta no viesapi.eu
portal - API Keys
aba, Identifier
coluna. No entanto, no Key
campo, insira o valor que foi gerado ao criar uma conta no viesapi.eu
portal - API Keys
aba, Key
coluna.
A guia Opções tem três opções padrão:
Check for updates when the application starts
– Esta configuração permite a verificação automática de novas versões quando o aplicativo é iniciado.Normalize the format of VAT numbers when loading data
– Esta opção permite a normalização dos números de IVA da UE no arquivo CSV.Use batch checking when applicable
– selecionar esta opção aplica o modo de lote aos registros para os quais ocorreu o erro “O número máximo de consultas simultâneas para este Estado-Membro foi atingido” (MS_MAX_CONCURRENT_REQ)
Se a conexão com a Internet for realizada por meio de um servidor proxy, vá para o Proxy HTTP
guia, selecione o Connect via the proxy server option below
e preencha os campos com os dados apropriados.
Descrição do menu principal
A figura abaixo mostra os botões disponíveis no menu principal do programa:
Load file
– permite selecionar um arquivo de texto na CSV
formato. O formato da linha é vatEU [, companyName], onde:
vatEU
– Número de IVA da UE com base no qual a verificação da entidade será realizada,companyName
- Nome da companhia (opcional)
No caso de um arquivo CSV, o vatEU
campo é obrigatório e o companyName
field é um campo opcional e não precisa estar presente. O registro pode conter apenas o número de IVA da UE.
De acordo com o formato CSV, os campos de texto devem estar entre aspas e separados por vírgula, ex.: “PL7171642051”, “CompanyXYZ”
Delete selected
– Exclui todas as linhas selecionadas.
Delete all
– Exclui todas as linhas carregadas do arquivo CSV.
Start checking
– o botão inicia a verificação de todos os cheques selecionados. O estatuto VIES do contribuinte pode ser verificado para entidades registadas num dos Estados-Membros da União Europeia.
Save results
– pressionando o botão, você pode salvar os resultados das verificações em um arquivo XLS (Microsoft Excel) ou texto CSV.
Settings
– chama o separador para introduzir o identificador e a chave.
Manage your account
– pressionar o botão permite que você acesse rapidamente a página de login do portal viesapi.eu.
Documentation
– clicar no link irá redirecioná-lo para esta documentação.
Contact
– pressionando o botão, você pode criar automaticamente um e-mail.
Check for update
– permite que você verifique se uma nova versão do aplicativo está disponível. Esta opção só está disponível na versão do instalador (setup.exe).
Verificando as entidades salvas no arquivo CSV
Para verificar as entidades registradas no arquivo CSV, execute:
- Abra o arquivo CSV e carregue seu conteúdo usando o
Load file
botão. - Para realizar a verificação, pressione o botão
Start checking
botão.
Será exibida uma janela informando sobre o andamento do processo de verificação:
Como você pode ver na imagem acima, o aplicativo é muito rápido, pois verificou mais de 2.000 registros no VIES em menos de 20 minutos. O que dá um desempenho de 1,6 consultas por segundo. No entanto, você deve saber que o desempenho do aplicativo depende principalmente da disponibilidade e estabilidade do próprio sistema VIES.
Notícia importante: A very important feature is the ability to resubmit requests automatically if the The maximum number of concurrent requests has been reached (MS_MAX_CONCURRENT_REQ)
error occurs. This is a very common error when verifying contractors from Germany, France, the Czech Republic, Denmark, and sometimes Belgium. You can read more about this issue in our blog article: [SOLVED] VIES ERROR: “The maximum number of concurrent requests has been reached”. To work around this issue, the application implements a mechanism for batch-based, asynchronous submission of requests that were not correctly handled by VIES the first time due to the error described above. After completing the first iteration of checks, the application collects all EU VAT numbers for which the above error was returned, generates batches for them, and sends them to VIES for batch verification of VAT activity status.
Após a conclusão da verificação, selecionar uma linha específica permite a visualização no painel direito do programa (Details
aba):
Os resultados obtidos podem ser filtrados digitando o texto de pesquisa no campo sob o nome de uma determinada coluna ou salvos em um arquivo de texto XLS (Microsoft Excel) ou CSV pressionando o botão Save results
botão.
Você também pode ir ao Account
guia a qualquer momento, onde você encontrará:
- Informações sobre o Plano ativo.
- Lista de funcionalidades disponíveis no Plano atual.
- Estatísticas relacionadas às consultas realizadas desde o início do mês.