# E-reporting e Plateforme Agréée (PDP): documentação

> 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.…

- Página: <https://www.datafirefly.com/pt/documentation/e-reporting-prestashop/>
- Idioma: pt
- Atualizado em: 2026-09-02
- Outros idiomas: [fr](https://www.datafirefly.com/documentation/e-reporting-prestashop/index.md), [en](https://www.datafirefly.com/en/documentation/e-reporting-prestashop/index.md), [es](https://www.datafirefly.com/es/documentation/e-reporting-prestashop/index.md), [de](https://www.datafirefly.com/de/documentation/e-reporting-prestashop/index.md), [it](https://www.datafirefly.com/it/documentation/e-reporting-prestashop/index.md), [pl](https://www.datafirefly.com/pl/documentation/e-reporting-prestashop/index.md), [nl](https://www.datafirefly.com/nl/documentation/e-reporting-prestashop/index.md)
- Índice: <https://www.datafirefly.com/pt/documentation/llms.txt>

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

1. No back-office, abra **Módulos > Gestor de módulos**, clique em **Carregar um módulo** e selecione o ficheiro ZIP.
2. Terminada a instalação, clique em **Configurar**. O módulo cria automaticamente as suas tabelas e um separador **E-reporting** em **Encomendas**.
3. 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.