Introdução

O serviço Viesapi.eu fornece dados de empreendedores selecionados usando serviços web, bibliotecas de programação e aplicativos dedicados. Ao utilizar o software disponível (bibliotecas, aplicativos e add-in Excel) seus clientes poderão:

verifique o status do número de IVA da UE dos contratados no sistema VIES,
baixe os detalhes da empresa do sistema VIES,
preenchimento automático dos formulários de fatura,

da maneira mais rápida possível.

Este documento descreve em detalhes quais etapas devem ser tomadas para uma integração adequada com o serviço viesapi.eu.

Atenção! A funcionalidade completa pode ser verificada usando Teste a API VIES. Utilizando o API TEST é possível conferir todas as funções oferecidas nos planos pagos sem a necessidade de criar uma conta.

Siga as etapas abaixo para acessar a interface da API de produção.

O primeiro passo é se cadastrar no sistema e criar uma conta. Graças ao qual será possível baixar o software e configurá-lo posteriormente para uma comunicação adequada com os serviços da web fornecidos pelo serviço viesapi.eu.

Cadastro

É necessário o registo de uma entidade que pretenda utilizar a funcionalidade do serviço viesapi.eu. Para fazer isso, acesse o Cadastro página e preencha o formulário apropriado. O pré-requisito para usar o serviço viesapi.eu é a aceitação dos regulamentos. Preenchendo corretamente o formulário e clicando no botão Inscrever-se botão criará uma conta no serviço viesapi.eu e sua ativação automática.

Conecte-se

É possível fazer login em uma conta ativada após inserir o Guia de login e arquivamento no endereço de e-mail e senha definidos durante o cadastro. Após a autenticação correta, é possível gerenciar a conta. O usuário pode gerar identificadores e chaves de acesso em sua conta, que são utilizados para autenticá-lo no sistema.

Gerando um identificador (identifier) e uma chave de acesso (key)

Ao fazer login pela primeira vez, um identifier é gerado automaticamente junto com o correspondente key. o identifier é público e não requer proteção, enquanto o key é privado e não deve ser disponibilizado a terceiros. Além disso, para aumentar a segurança, o usuário pode entrar no IP address de onde podem vir as consultas. Pode ser, por exemplo, o endereço IP de uma loja online. Não há limite para o número de pares de chaves e identificadores gerados. Caso o usuário não queira usar nenhum par identificador-chave, ele pode desativá-lo alterando seu status.

Chaves de API

Métodos de acesso à API VIES atualmente disponíveis

Abaixo apresentamos os possíveis métodos de acesso à API VIES. Clique no título ou no link para a documentação para obter detalhes.

1. Bibliotecas de programação: PHP, .NET (C#, Visual Basic, SQL Server, Access, Dynamics, FoxPro), Python, Java, C/C++, JavaScript

Documentação técnica e descrição detalhada de como usar as bibliotecas disponíveis no Documentação aba.

Os arquivos das bibliotecas podem ser baixados do site vinculado Download.

2. Suplemento da API do Microsoft Excel VIES

Para as pessoas que usam o aplicativo Excel diariamente, preparamos um add-in fácil de usar. Permite-lhe verificar eficazmente (sem conhecimentos de programação) o estado de uma entidade na lista branca, registo de IVA e sistema VIES, bem como pesquisar e descarregar dados de entidades e verificar o seu estado atual de atividade empresarial.

Detalhes de instalação, configuração e uso no Suplemento da API do MS Excel VIES página.

3. Verificador de aplicativos de IVA da UE (GUI)

O aplicativo VIES Checker permite carregar qualquer arquivo CSV para verificar entidades (contratantes), cujos números de IVA da UE são salvos em arquivo CSV em termos de seu status no sistema VIES.

Detalhes de instalação, configuração e uso descritos diretamente no Aplicativo de Verificador VIES página.

O aplicativo não requer instalação e direitos de administrador para ser executado. Você pode baixá-lo do Download página.

4. Verificador de IVA da UE CLI/CMD

O VIES CLI/CMD Checker é uma aplicação cliente que permite a verificação rápida e automática das entidades (contratantes) a partir do nível de linha de comando (CLI/CMD) quanto ao seu estado atual no sistema VIES.

Detalhes de instalação, configuração e uso descritos diretamente no CLI/CMD do verificador VIES página.