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

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.

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

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.

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.