VAT OSS Autopilot: guia completo

Apresentação

O VAT OSS Autopilot automatiza a gestão do IVA intra-UE da sua loja WooCommerce: cálculo em tempo real da taxa do país de consumo, validação VIES dos números de IVA B2B com autoliquidação, geração da declaração OSS trimestral (CSV resumo, CSV detalhado, XML da DGFiP francesa) e vigilância de limiares de volume de negócios totalmente configuráveis.

Requisitos

• WordPress 6.2 ou superior
• WooCommerce 7.0 ou superior (testado até à 9.4)
• PHP 7.4 no mínimo (compatível de 8.0 a 8.3)
• Extensões PHP: SOAP (validação VIES), DOM (exportação XML), ZipArchive (pacote ZIP)
• Os impostos do WooCommerce têm de estar ativos (WooCommerce → Definições → Geral → Ativar os impostos)

Instalação

1. Descarregue o ficheiro vat-oss-autopilot.zip a partir da sua conta DataFirefly.
2. Na administração do WordPress, vá a Plugins → Adicionar → Carregar plugin.
3. Selecione o ZIP, clique em Instalar agora e depois em Ativar.
4. Aparece um novo menu VAT OSS na barra lateral da administração.

Na ativação, o plugin cria a tabela wp_vat_oss_sales (registo das vendas OSS) e pré-preenche três limiares de exemplo do regime francês, que pode alterar ou eliminar livremente.

Configuração inicial

1. Identificação fiscal

Vá a VAT OSS → Definições e preencha:

• País de estabelecimento: o país onde está registado no OSS. As vendas para esse país continuam a ser geridas pela sua configuração habitual do WooCommerce (fora do âmbito OSS).
• Número de IVA: o seu número intracomunitário (por exemplo PT999999999). Consta do cabeçalho do XML da declaração.
• Designação social, e-mail, telefone, IBAN, BIC: informações retomadas no bloco Operator do XML.

2. Validação VIES

• Ativar a validação VIES: consulta o serviço da Comissão Europeia a cada introdução de número de IVA no checkout (tempo limite de 8 segundos).
• Aplicar autoliquidação B2B: coloca o IVA a 0% (reverse charge) nos clientes profissionais intra-UE cujo número tenha sido validado.
• Duração da cache VIES: em segundos, 30 dias por predefinição (2592000). Cada número validado fica em cache para não sobrecarregar o VIES desnecessariamente.

3. Tipo de atividade predefinido

Escolha Mercadorias ou Serviços. Este tipo serve para repartir o volume de negócios pelos limiares e pela declaração OSS. Pode substituí-lo produto a produto: em cada ficha de produto WooCommerce, separador IVA, campo Tipo OSS.

Taxas de IVA da UE

A página VAT OSS → Taxas de IVA lista os 27 Estados-Membros com três colunas: taxa normal, taxa reduzida, taxa super-reduzida. Os valores predefinidos estão atualizados à data de publicação do plugin.

A taxa aplicada no checkout depende da classe de imposto do produto no WooCommerce: a classe normal usa a taxa normal, uma classe que contenha «reduced» ou «reduzida» usa a taxa reduzida, e uma classe que contenha «super» usa a taxa super-reduzida.

Funcionamento no checkout

1. O cliente indica o país de faturação; o plugin aplica automaticamente a taxa do país se for uma venda intra-UE elegível ao OSS.
2. Aparece um campo opcional Número de IVA intracomunitário nos campos de faturação.
3. Assim que é introduzido (com debounce de 600 ms), uma validação AJAX consulta o VIES e apresenta o resultado: visto verde com a designação social, ou cruz vermelha.
4. Se o número for válido e a autoliquidação estiver ativa, o IVA passa a 0% com a designação «IVA (autoliquidação)» e os totais são recalculados.
5. O número, o estado de validação e a designação social ficam guardados nos metadados da encomenda.

Seguimento das vendas OSS

Cada encomenda que passe ao estado Concluída ou Em processamento é registada na tabela de seguimento, repartida por taxa de IVA e tipo de produto. Os portes são associados à taxa dominante da encomenda. Os reembolsos geram automaticamente linhas negativas.

Ficam excluídas da declaração OSS: as vendas domésticas (país de estabelecimento) e as vendas B2B com número VIES validado (autoliquidação).

Painel

A página VAT OSS → Painel mostra, para o trimestre em curso: a base sem IVA do OSS, o IVA a entregar, a comparação com o trimestre anterior, o número de países envolvidos, a repartição detalhada por país e taxa, e o estado de progressão de cada limiar configurado.

Geração da declaração OSS

Em VAT OSS → Declaração OSS, escolha o ano e o trimestre (o trimestre anterior vem pré-selecionado) e clique no formato pretendido:

• CSV resumo: agregado por país e taxa, codificado em UTF-8 com BOM e separador ponto e vírgula (abertura direta no Excel). É o ficheiro a usar para a introdução manual no portal.
• CSV detalhado: uma linha por encomenda e por taxa, com número de encomenda, tipo de cliente e número de IVA. Serve de trilho de auditoria contabilística.
• XML no formato FR: conforme ao esquema OSS-Union da DGFiP francesa (namespace urn:dgfip:oss:union:v1), com blocos Header, Operator, Supplies por país de consumo e Totals. Pronto a carregar no portal fiscal francês.
• Tudo em ZIP: os três ficheiros num arquivo.

Limiares configuráveis

A página VAT OSS → Limiares permite definir tantos limiares quantos forem necessários. Cada linha tem:

• Designação: texto livre (por exemplo «Venda de mercadorias»)
• Montante e moeda: o teto anual a vigiar
• Tipo: Mercadorias, Serviços, ou Tudo (volume de negócios global)
• Alertas (%): patamares separados por vírgulas (por exemplo 80,90,100)

A cada encomenda, o plugin recalcula o volume de negócios anual do tipo em causa. Quando um patamar é ultrapassado, é enviado um e-mail para o endereço de administração do site e aparece um aviso persistente na administração. Cada patamar só desencadeia um alerta por ano fiscal.

Na instalação vêm pré-preenchidos três limiares de exemplo (regime simplificado francês): 85 000 € de mercadorias, 37 500 € de serviços e 25 000 € de isenção de IVA. Adapte-os à sua situação ou elimine-os.

Manutenção

• Limpar a cache VIES: botão em VAT OSS → Definições, força uma revalidação de todos os números na próxima passagem pela caixa.
• Desativação: conserva todos os dados (tabela, opções, histórico).
• Desinstalação: elimina a tabela wp_vat_oss_sales, todas as opções, a cache VIES e os metadados de encomendas (incluindo a tabela HPOS wc_orders_meta).

Resolução de problemas

A validação VIES não dispara

• Verifique que a extensão PHP SOAP está instalada no servidor.
• Verifique que a validação está ativa em VAT OSS → Definições.
• O VIES tem manutenções regulares do lado da Comissão Europeia. Tente mais tarde: o recurso com IVA aplicado protege as suas encomendas.

A taxa aplicada não é a esperada

• As vendas para o seu país de estabelecimento usam a configuração nativa do WooCommerce, e não a referência do plugin.
• Verifique a classe de imposto do produto: é ela que determina se é usada a taxa normal, reduzida ou super-reduzida.
• Verifique a taxa do país de destino em VAT OSS → Taxas de IVA.

Uma encomenda não aparece na declaração

• Só são registadas as encomendas no estado Concluída ou Em processamento.
• As vendas B2B com número VIES validado são excluídas propositadamente (autoliquidação, fora do OSS).
• As vendas domésticas estão fora do âmbito do OSS.

FAQ

Posso usar o plugin fora de França?

Sim. O país de estabelecimento é configurável, os limiares são totalmente personalizáveis e a interface existe em 5 idiomas. Apenas a exportação XML segue o esquema francês da DGFiP; para os outros portais nacionais, use o CSV resumo, que serve para a introdução manual.

O plugin trata o regime IOSS (importações)?

Não, esta versão cobre o regime OSS-União (vendas intra-UE). O regime IOSS para as importações abaixo de 150 € não está incluído.

Os dados estão em conformidade com o RGPD?

O plugin guarda apenas os dados necessários à declaração fiscal: país, montantes, taxas e número de IVA (dado profissional). Nenhum dado é transmitido a terceiros, para além da chamada oficial ao VIES da Comissão Europeia.