O VIES (sistema de intercâmbio de informação sobre o IVA) da UE é o pilar do comércio B2B transfronteiriço. Como toda a infraestrutura, não é perfeito. Manutenção programada ou falha de servidor: uma indisponibilidade pode chegar no pior momento—no checkout do cliente.
Para uma empresa que aspira à conformidade ViDA, « o sistema estava em baixo » não é desculpa válida para rastreabilidade em falta. Assim pode gerir as falhas do VIES de forma profissional e legal.
1 Por que o VIES falha (e por que não é um único sistema)
O VIES é uma « passagem » para 27 bases fiscais nacionais. Numa validação, o pedido sai do portal da Comissão para a base do país correspondente.
Se a Itália ou a Alemanha atualizam os seus servidores fiscais, o VIES não consegue verificar os números desses países.
Em períodos de declarações, os tempos de resposta podem abrandar muito.
Se um servidor nacional não responder em poucos segundos, o VIES devolve « Não disponível » ou MS_UNAVAILABLE.
Não deixe que uma falha temporária do VIES interrompa um fluxo de IVA rigoroso. A camada proprietária de resiliência da VIESAC combina SmartRouter™, SmartCache™, ligações monitorizadas a registos locais, histórico de validação verificado, sinais de estado por país e controlos de qualidade assistidos por IA. A resposta oficial VIES em direto mantém-se sempre decisiva: durante a demora, a VIESAC regista o contexto, gere filas e novas tentativas controladas e mantém claramente o estado pendente ou limitado.
2 Códigos de erro VIES e resolução de problemas (API SOAP)
Uma vez que o VIES é uma porta de entrada em tempo real para 27 sistemas nacionais, os erros que recebe (frequentemente designados por SOAP Fault Codes) seguem padrões específicos. Compreendê-los é fundamental para a conformidade com o ViDA, onde uma falha técnica pode bloquear o seu reporte digital em tempo real (DRR). Eis como o VIESAC proporciona resiliência técnica contra estas falhas.
| Código de erro (SOAP) e padrão | Análise técnica e solução VIESAC |
|---|---|
INVALID_INPUT (201) Malformed VAT number or request input | Input needs correction: remove invalid characters, spacing or a malformed country prefix, then retry. VIESAC can normalize ordinary formatting noise before the live call; it never changes or assumes the official result. |
INVALID_REQUESTER_INFO (202) Requester VAT details cannot be confirmed | Review the requester details: correct the VAT number supplied for the requester and send a fresh request. This fault concerns the requester data, not the validity of the VAT number being checked. |
SERVICE_UNAVAILABLE (300) Central VIES service is temporarily unavailable | Central service interruption: record the failed attempt and retry with controlled backoff. An unavailable service is a technical state, never evidence that the target VAT number is invalid. |
MS_UNAVAILABLE (301) Member State service is under maintenance or unavailable | Official national source is temporarily unavailable: preserve the timestamp and audit context, then recheck through VIES after the Member State service recovers. Do not convert this into an invalid result. |
TIMEOUT (302) Official endpoint did not respond within the response window | Response window exceeded: keep the check pending and place it in a controlled retry queue. A timeout is distinct from an invalid VAT number and from VIES concurrency-limit faults. |
VAT_BLOCKED (400) Official VAT status is blocked | Official restriction: retain the live fault in the audit trail and resolve it through the appropriate business or tax process. It must not be turned into a fallback approval. |
IP_BLOCKED (401) VIES usage-protection control has been triggered | Request protection applies: reduce request pressure, queue the check and retry responsibly. This protects the public service and is not a decision about the target VAT number. |
GLOBAL_MAX_CONCURRENT_REQ (500) Global maximum number of concurrent VIES requests reached | Global request-count limit: VIES has reached its simultaneous-request ceiling. VIESAC uses controlled pacing and queues the request for a later fresh official response. |
GLOBAL_MAX_CONCURRENT_REQ_TIME (501) Global concurrent-request time limit reached | Global time-based concurrency limit: pause with controlled backoff before retrying. This is a capacity signal, not the same fault as TIMEOUT (302) and not a VAT-status result. |
MS_MAX_CONCURRENT_REQ (600) Member State maximum number of concurrent requests reached | Member State request-count limit: the national VIES route has reached its simultaneous-request ceiling. Preserve the attempt and retry the official route when capacity returns. |
MS_MAX_CONCURRENT_REQ_TIME (601) Member State concurrent-request time limit reached | Member State time-based concurrency limit: apply controlled backoff and recheck through the official route. It is a capacity condition, not TIMEOUT (302) or an invalid VAT number. |
3 Regra de ouro: « Não disponível » ≠ « Inválido »
Erro frequente: confundir um timeout técnico com um número de IVA inválido.
Atenção: Se o seu sistema rejeitar automaticamente o cliente porque o VIES está temporariamente em baixo, perde faturação. Inversamente, aplicar 0 % de IVA sem verificação posterior expõe a multas pesadas numa inspeção.
Na prática: Documente cada tentativa, lance novas tentativas inteligentes e comunique com clareza ao utilizador—nunca trate « não disponível » como « inválido ».
4 Conduta a seguir: estratégia em 3 passos
Quando o VIES está em baixo, siga estes passos para proteger vendas e conformidade:
- 1. Documentar cada tentativa — Para o auditor, uma « tentativa » só existe se houver registo. Registe sempre: número introduzido, marca temporal exata, mensagem de erro (ex. « Serviço não disponível » ou « MS_UNAVAILABLE »).
- 2. Novas tentativas inteligentes — Não faça o cliente esperar em « Pagar ». Aceite a encomenda e agende uma reverificação em segundo plano. O sistema deve tentar novamente de 30 em 30 ou de 60 em 60 minutos até obter « Válido » ou « Inválido ».
- 3. Comunicar com transparência — Indique com clareza: « A validação do IVA está temporariamente indisponível (manutenção de servidores UE). Validaremos o seu estado em breve e atualizaremos a fatura. » Assim acalma e limita o abandono do carrinho.
Essa janela de 30–60 minutos é típica de sistemas convencionais—eles simplesmente consultam com essa pouca frequência. Com o VIESAC, tecnologia assíncrona, pedidos e servidores distribuídos e VIESAC AI permitem-nos monitorizar a disponibilidade VIES quase em tempo real e entregar a sua auditoria assim que o serviço responder.
Como o VIESAC automatiza a gestão das indisponibilidades
Gerir manualmente novas tentativas e logs é um pesadelo. O VIESAC foi concebido para absorver a instabilidade dos servidores públicos.
- →Novas tentativas e fila automáticas: Se o VIES estiver em baixo, o nosso sistema coloca o pedido em fila e tenta novamente até concluir.
- →Estados claros: Distinguimos « Inválido » e « Serviço não disponível » para o seu fluxo continuar sem bloqueios.
- →Rastreabilidade completa: O VIESAC armazena um certificado digital permanente por cada verificação—também após várias tentativas—estará pronto para auditoria ViDA.
Experimente o VIESAC — Novas tentativas automáticas e rastreabilidade
Dica prática
Não deixe que uma falha de servidor no estrangeiro trave o seu crescimento. Utilize uma API de validação de IVA da UE com lógica de nova tentativa ou o nosso plugin WooCommerce para o checkout nunca bloquear e a sua rastreabilidade se manter completa. Consulte também como validar o IVA da UE para auditoria.