A aplicação cliente viesClient.exe permite a verificação rápida e automática das entidades (contratantes) a partir do nível da linha de comando (CLI/CMD) quanto ao seu estado atual no sistema VIES. O aplicativo também permite que você salve os dados baixados em um arquivo em 3 formatos:

  • JSON (formato de exibição padrão para stdout)
  • XML
  • MAP (chave do mapa de atributo = valor)

O aplicativo foi testado com sucesso nas seguintes versões do MS Windows: XP, 7 e 10.

A versão mais recente do aplicativo está sempre disponível para download no Download página.

A funcionalidade completa do aplicativo pode ser verificada – sem a necessidade de criar uma conta – usando o API de teste

Para usar o suplemento na API de produção, você precisa configurar uma conta no site viesapi.eu, adquirir um mínimo do plano de negócios e gerar uma chave de API e um identificador de chave de API.

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

O programa executável compartilhado viesClient.exe não requer instalação e não precisa ser executado em uma conta com privilégios administrativos. Para executar o programa, selecione o Command Prompt aplicação do Start menu ou tipo cmd no "Search programs and files campo e pressione Enter:

Após iniciar o console, vá até o diretório onde está o arquivo zip com viesClient.exe foi baixado e descompactado.

Iniciar o programa sem especificar parâmetros exibe a janela de ajuda.

Configuração

Lançando o viesClient.exe aplicativo sem especificar o API key ID e API key permite consultar o ambiente de teste (mais detalhes sobre o Teste a API VIES página).

Para se conectar ao ambiente de produção, é necessário chamar o viesClient.exe aplicação com os parâmetros de autenticação, que são:

  • keyid – o parâmetro deve conter o identificador de chave de API (ID) gerado na conta no site viesapi.eu,
  • key – o parâmetro deve conter a chave API (Chave) gerada na conta no site viesapi.eu.

Os detalhes sobre como gerar o identificador e a chave estão descritos no Documentação página. Abaixo está um exemplo de chamada do aplicativo com parâmetros de autenticação (keyid e key):
viesClient.exe -keyid XXXXXXXXXXXX -key YYYYYYYYYYYY -vies -euvat PL7171642051.

Sintaxe de chamada

Sintaxe de chamar o programa viesClient.exe:
viesClient.exe <action> [options].

Ações disponíveis :
-help – descrição dos parâmetros de chamada do programa
-account – retorna informações sobre o saldo da conta corrente de viesapi.eu
-vies – obter dados da empresa do VIES.

Opções disponíveis [opções]:

-keyid string – Identificador de chave de API
-key string - Chave API
-euvat number – Número de identificação do IVA da UE com prefixo do país
-format type
– formato dos dados retornados (JSON, MAP, XML), padrão: JSON
-file path
– nome e caminho para o arquivo de resultado, padrão: diretório de execução viesClient.exe
-proxy url
– Configuração do proxy HTTP (como URL http://user:password@hostname:port).

Exemplos

ATENÇÃO! Os exemplos a seguir são adaptados aos dados coletados no ambiente de teste. Para realizar verificações no ambiente de produção, adicione o –keyid e –key parâmetros com os valores apropriados para cada consulta.

1. Baixando os dados da empresa do VIES e exibindo o resultado no console no formato MAP:

viesClient.exe -vies -euvat PL5213003700 -map format

2. Exiba informações sobre o status atual da conta:

viesClient.exe -account.

3. Configuração de proxy HTTP:

viesClient.exe -vies -euvat PL7272445205 -proxy http://user:password@10.0.0.1:8080