# DataFirefly FEC: exportação contabilística WooCommerce

> Apresentação O DataFirefly FEC transforma as suas encomendas WooCommerce em lançamentos contabilísticos em partida dobrada e exporta-os em sete formatos: o FEC oficial francês (obrigatório numa fiscalização, artigo L.47 A-I…

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

## Apresentação

O DataFirefly FEC transforma as suas encomendas WooCommerce em lançamentos contabilísticos em partida dobrada e exporta-os em sete formatos: o FEC oficial francês (obrigatório numa fiscalização, artigo L.47 A-I do LPF francês), Sage 100, EBP Compta, Pennylane, Tiime, Indy e Quadratus. Todos os lançamentos são verificados (equilíbrio entre débito e crédito) antes da exportação.

Os sete formatos destinam-se a uma contabilidade tratada segundo as normas francesas. Se a sua contabilidade é tratada noutro país, confirme com o seu contabilista que um destes formatos serve antes de o adotar como processo.

## Instalação

1. Descarregue o ficheiro `dfwoo-fec.zip` a partir da sua conta de cliente DataFirefly.
2. Na administração do WordPress, vá a **Plugins → Adicionar → Carregar plugin** e selecione o ZIP.
3. Clique em **Instalar agora** e depois em **Ativar**.
4. Aparece o menu **WooCommerce → Exportação contabilística FEC**.

Requisitos: WordPress 6.0+, WooCommerce 7.0+ (testado até à 9.4), PHP 7.4+. O plugin é compatível com HPOS (High-Performance Order Storage).

## Configuração inicial

Antes da primeira exportação, vá ao separador **Parâmetros contabilísticos** e preencha:

### Identidade da empresa

- **Designação social**: retomada nos descritivos dos lançamentos.
- **SIREN**: 9 dígitos, usado para dar nome ao ficheiro FEC oficial (`SIRENFECAAAAMMDD.txt`).

### Diários

Por predefinição: `VE` (diário de vendas) e `BQ` (diário de banco). Adapte os códigos se o seu contabilista usar outra nomenclatura (recomenda-se um máximo de 3 carateres para o Quadratus).

### Plano de contas

- **Conta de cliente**: 411000 por predefinição. Assinale «contas auxiliares por cliente» para gerar um auxiliar estável por cliente (C+ID nos clientes com sessão iniciada, G+hash do e-mail nos convidados).
- **Contas de proveitos**: 707000 vendas, 708500 portes, 709000 descontos, 708000 encargos diversos.
- **Contas de IVA por taxa**: 445712 (20%), 445711 (10%), 445713 (5,5%), 445714 (2,1%), 445715 (0%). Cada taxa detetada numa encomenda é repartida pela sua conta dedicada.
- **Contas de tesouraria por meio de pagamento**: deixe vazio para usar a conta bancária predefinida (512000), ou atribua uma conta distinta a cada gateway (por exemplo 512100 Stripe, 512200 PayPal) para facilitar a reconciliação bancária.

### Estados de encomenda

Duas definições independentes:

- **Estados que geram um lançamento de venda**: por predefinição Processing e Completed. O lançamento tem a data de criação da encomenda.
- **Estados que geram um lançamento de recebimento**: por predefinição Completed. O lançamento tem a data de pagamento registada pelo WooCommerce.

## Esquema contabilístico gerado

### Lançamento de venda (diário VE, data da encomenda)

- Débito 411 Cliente: total com IVA da encomenda
- Crédito 707 Vendas: montante sem IVA dos produtos, repartido por taxa de IVA
- Crédito 708 Portes: montante sem IVA do transporte, repartido por taxa
- Crédito 44571x IVA cobrado: IVA por taxa

### Lançamento de recebimento (diário BQ, data de pagamento)

- Débito 512 Banco (ou conta do meio de pagamento): total com IVA
- Crédito 411 Cliente: total com IVA

Cada lançamento é controlado: se o desvio entre débito e crédito ultrapassar 5 cêntimos, é rejeitado. Abaixo disso, o arredondamento é corrigido automaticamente na última linha.

## Exportar um ficheiro

1. Separador **Exportação**: escolha a data de início e a data de fim.
2. Selecione o formato no menu pendente.
3. Clique em **Pré-visualização (50 linhas)** para verificar visualmente a estrutura, ou diretamente em **Descarregar o ficheiro**.

## Detalhe dos formatos

### FEC (oficial, França)

18 colunas separadas por barra vertical (ou tabulação, à escolha): JournalCode, JournalLib, EcritureNum, EcritureDate, CompteNum, CompteLib, CompAuxNum, CompAuxLib, PieceRef, PieceDate, EcritureLib, Debit, Credit, EcritureLet, DateLet, ValidDate, Montantdevise, Idevise. Datas no formato AAAAMMDD, montantes com vírgula decimal. Codificação UTF-8 ou ISO-8859-15. Nome `SIRENFECAAAAMMDD.txt` conforme à DGFiP.

### Sage 100

CSV com ponto e vírgula, codificação Windows-1252, colunas compatíveis com a Importação parametrizável do Sage 100c: JournalCode, DateEcriture, Compte, TiersCompte, LibelleEcriture, Debit, Credit, NumPiece, DateEcheance, ReferenceFacture.

### EBP Compta

CSV com ponto e vírgula em Windows-1252 com sentido D/C por linha: JournalCode, Date, NumeroCompte, CompteTiers, LibelleEcriture, NumeroPiece, Montant, Sens.

### Pennylane

CSV UTF-8 com BOM, colunas nativas do Pennylane: Date, Journal, Numéro de pièce, Libellé, Compte, Compte auxiliaire, Débit, Crédit.

### Tiime

CSV UTF-8 com BOM: Date, Journal, Compte, Libelle, Debit, Credit, Piece, Tiers.

### Indy

CSV UTF-8 com BOM adaptado a independentes, com uma coluna Type que distingue Venda e Recebimento: Date, Type, Journal, Compte, Libelle, Debit, Credit, Reference.

### Quadratus

Ficheiro de texto ASCII de largura fixa (linhas «M» de 102 carateres), codificação Windows-1252, compatível com o Cegid Quadra Compta. Montantes em cêntimos alinhados à direita, datas DDMMAA.

O formato Quadratus varia ligeiramente consoante as versões do Cegid Quadra Compta. Valide a primeira exportação com o seu contabilista através da pré-visualização de 50 linhas; por vezes é necessário um ajuste de posições.

## Automatização com WP-CLI

O plugin fornece um comando CLI para as exportações agendadas:

```
wp dfwoo-fec export --from=2026-01-01 --to=2026-03-31 --format=fec --output=/caminho/fec-t1.txt
```

Opções: `--format` aceita fec, sage100, ebp, pennylane, tiime, indy e quadratus. Sem `--output`, o conteúdo é enviado para a saída padrão. Exemplo de cron mensal:

```
0 6 1 * * cd /var/www/site && wp dfwoo-fec export --from=$(date -d "last month" +%Y-%m-01) --to=$(date -d "last month" +%Y-%m-31) --format=fec --output=/exports/fec-mensal.txt
```

## Perguntas frequentes

### Os reembolsos e as notas de crédito são tratados?

A versão 1.0.0 exporta os lançamentos de venda e de recebimento. As notas de crédito estão previstas para uma versão posterior; até lá, introduza-as manualmente no seu programa de contabilidade.

### Posso exportar vários anos?

Sim, o intervalo de datas é livre. Em grandes volumes (mais de 10 000 encomendas), prefira o comando WP-CLI, que não está sujeito ao tempo limite do HTTP.

### O plugin altera as minhas encomendas?

Não, trabalha exclusivamente em leitura. Nenhum dado de encomenda é alterado e não é criada qualquer tabela.

## Suporte

Suporte técnico incluído durante 12 meses através da sua conta de cliente DataFirefly. Junte o ficheiro de pré-visualização e a versão do WooCommerce a qualquer pedido relativo a um formato de exportação.
