E-reporting e Plateforme Agréée (PDP): documentação
Instalar e configurar o módulo de e-reporting francês: regime de IVA, periodicidade, depósito PDP (API ou manual), ciclo de vida das faturas e cron automático.
Este módulo transmite à administração fiscal francesa os dados das suas transações B2C (e-reporting) e o ciclo de vida das suas faturas, no âmbito da reforma francesa da faturação eletrónica. Gera o fluxo no formato esperado pela DGFiP (semântica CII, fluxo 10, em XML e JSON) e deposita-o na sua Plateforme Agréée (PDP), ou permite-lhe depositá-lo manualmente. Este guia cobre a instalação, a configuração e a utilização quotidiana.
Âmbito para uma loja portuguesa. Este módulo responde a uma obrigação exclusivamente francesa: destina-se às empresas com SIREN sujeitas ao IVA em França (incluindo lojas portuguesas com estabelecimento ou registo de IVA em França). Não cobre as obrigações portuguesas equivalentes: comunicação do SAF-T (PT), ATCUD e código QR, faturação eletrónica B2G via CIUS-PT e eSPap, que passam por um software de faturação certificado pela AT.
Lembrete regulamentar (França). A partir de 1 de setembro de 2026, a receção das faturas eletrónicas é obrigatória para todas as empresas, e a emissão bem como o e-reporting tornam-se obrigatórios para as grandes e médias empresas. As PME, microempresas e empresários em nome individual seguem a 1 de setembro de 2027. Cada transmissão de e-reporting em falta é punível com uma coima de 250 € (limite de 45 000 €/ano).
Pré-requisitos
- PrestaShop 8.0 a 9.x, PHP 7.4 a 8.3.
- O seu número SIREN (9 algarismos).
- O conhecimento do seu regime de IVA francês (réel normal, réel simplifié ou franchise en base).
- Para o depósito automático: as informações de ligação fornecidas pela sua Plateforme Agréée (URL de depósito, URL de estado, credenciais OAuth2 ou chave API). Estas informações não são necessárias em modo manual.
Instalação
- No back-office, abra Módulos > Gestor de módulos, clique em Carregar um módulo e selecione o ficheiro ZIP.
- Terminada a instalação, clique em Configurar. O módulo cria automaticamente as suas tabelas e um separador E-reporting em Encomendas.
- Vá ao separador Definições para a configuração inicial.
Configuração inicial
Todas as definições estão no separador Definições da página de configuração do módulo.
Identidade e regime
- SIREN: o seu número de 9 algarismos. Identifica a parte vendedora em cada fluxo transmitido.
- Regime de IVA: determina a periodicidade das suas transmissões. Réel normal = decendial, réel simplifié = mensal, franchise en base = bimestral.
- Tipo de atividade: bens, serviços ou misto. As atividades de serviços e mistas desencadeiam o acompanhamento das cobranças, porque aí o IVA é exigível na cobrança.
- Data de início: primeira data a partir da qual o módulo recolhe as transações. Fixe-a, no mínimo, na sua data de entrada na obrigação.
Opções de recolha
- Incluir as vendas intracomunitárias B2B: acrescenta ao fluxo as vendas a profissionais de outro Estado-membro da UE, também sujeitas a e-reporting.
- Incluir as notas de crédito: integra as notas de crédito (order slips) no fluxo em montantes negativos.
Escolha do modo de depósito
A definição Modo PDP determina como os fluxos são transmitidos.
Modo manual
O módulo gera os fluxos; descarrega-os em XML ou JSON e deposita-os você mesmo no portal da sua plataforma, marcando depois a transmissão como depositada. É o modo recomendado se a sua plataforma ainda não expuser uma API, ou se preferir manter o controlo.
Modo API
O módulo deposita automaticamente os fluxos na sua plataforma. Preencha:
- URL de depósito e URL de estado fornecidos pela sua plataforma.
- Modo de autenticação: OAuth2 (client credentials), chave API ou Bearer estático.
- Consoante o modo: URL do token, Client ID e Client Secret para OAuth2; ou Chave API; ou token Bearer.
- Formato do payload: XML ou JSON, consoante o que a API da sua plataforma espera.
Use o botão Testar a ligação PDP para validar as suas credenciais antes da passagem a produção.
O segredo é conservado. Quando guarda as definições deixando o campo Client Secret ou Chave API vazio, o valor anteriormente guardado é conservado. Não precisa portanto de reintroduzir o segredo a cada alteração.
Gerar e transmitir um período
A partir do painel
O separador Painel mostra os períodos devidos, cada um com a sua data-limite legal. Um período em atraso é assinalado a vermelho. Clique em Gerar em frente a um período para produzir o seu fluxo. O botão Gerar tudo processa de uma vez todos os períodos vencidos.
A partir do separador Transmissões
O separador Transmissões lista todos os fluxos gerados com o seu estado. Para cada transmissão pode:
- Consultar o detalhe da repartição por taxa de IVA.
- Descarregar o fluxo em XML ou JSON.
- Em modo API, clicar em Enviar à PDP.
- Em modo manual, marcar a transmissão como depositada, e depois aceite ou rejeitada consoante o retorno da plataforma.
- Eliminar uma transmissão enquanto não tiver sido submetida.
Estados de uma transmissão. Uma transmissão passa pelos estados rascunho, gerada, submetida, aceite, rejeitada ou erro. Uma transmissão já submetida ou aceite já não pode ser eliminada, para preservar a sua pista de auditoria.
Periodicidade segundo o regime
O módulo calcula automaticamente os períodos em função do regime configurado, em conformidade com o decreto francês 2022-1299:
- Réel normal, decendial: três períodos por mês (de 1 a 10, de 11 a 20, de 21 ao fim do mês). Cada fluxo deve ser depositado nos 10 dias seguintes ao fim do período.
- Réel simplifié, mensal: uma transmissão por mês, a depositar entre 25 e 30 do mês seguinte.
- Franchise en base, bimestral: uma transmissão de dois em dois meses.
Como os montantes são calculados
O módulo reconstitui a repartição por taxa de IVA a partir das linhas de encomenda reais. Acrescenta os portes à taxa da transportadora, integra o embrulho de oferta e reporta as diferenças de arredondamento e os descontos para a maior rubrica, de modo que os totais transmitidos correspondam exatamente aos totais das suas encomendas. As encomendas em moeda estrangeira são convertidas à taxa registada no momento da venda. As notas de crédito, se ativadas, são integradas em montantes negativos e afetadas proporcionalmente às taxas da encomenda de origem.
Ciclo de vida das faturas
O separador Ciclo de vida permite acompanhar os estados das suas faturas: depósito, rejeição, recusa e cobrança. As cobranças são detetadas automaticamente a partir dos pagamentos PrestaShop, e a passagem de uma encomenda a um estado « pago » regista o estado cobrado. Pode também introduzir manualmente um estado para uma dada encomenda. Cada ficha de encomenda do back-office mostra, além disso, um painel que resume o seu estado de e-reporting.
Automatização por cron
O separador Painel mostra um URL de cron protegido por um token. Configure uma tarefa agendada (cron) no seu alojamento para chamar este URL, por exemplo uma vez por dia. A cada chamada, o módulo gera todos os períodos vencidos e, se a opção Submissão automática estiver ativada em modo API, deposita os fluxos na sua plataforma.
Mantenha o URL de cron confidencial. Contém um token que autoriza a geração e a submissão dos fluxos. Não o partilhe publicamente. Se pensar que foi exposto, regenere o token nas definições.
Modo de teste
Ative o Modo de teste para validar toda a cadeia sem efeito real. Cada fluxo transmitido neste modo tem o indicador de teste previsto pelo formato oficial: a sua plataforma trata-o como um ensaio. Uma faixa MODO DE TESTE permanece visível na interface enquanto a opção estiver ativa. Desative-a antes da primeira transmissão real.
Perguntas frequentes
Estou abrangido se só vender a particulares?
Sim, se estiver sujeito ao IVA em França. As vendas B2C são precisamente o objeto do e-reporting: os seus dados de transações devem ser transmitidos periodicamente, mesmo que não seja emitida nenhuma fatura eletrónica.
O módulo funciona com a minha Plateforme Agréée?
O cliente API é genérico e compatível com qualquer plataforma que exponha uma API REST com autenticação OAuth2, chave API ou Bearer. Se a sua plataforma não tiver API, o modo manual continua disponível.
É compatível com o módulo Factur-X DataFirefly?
Sim. Os dois módulos são complementares: o Factur-X cobre a faturação eletrónica B2B, este módulo cobre o e-reporting das transações B2C e o ciclo de vida das faturas. Podem ser usados em conjunto sem conflito.
O que acontece se instalar o módulo a meio do ano?
Defina a Data de início na data a partir da qual está sujeito à obrigação. O módulo só gera períodos a partir dessa data.