7.1.1. O que faz a integração Moloni–WordPress
Objetivo
No final deste artigo vai conseguir:
perceber o fluxo: encomenda WooCommerce → Moloni (documento/cliente/artigos);
saber quais as automatizações disponíveis (documentos, notas de crédito, produtos, stock);
reconhecer os limites mais comuns para evitar erros e tickets desnecessários.
1) O que a integração faz (visão simples)
A integração liga a sua loja WooCommerce ao Moloni para permitir emissão de documentos de venda certificados pela AT diretamente a partir do WordPress, automatizando processos como criação de documentos, clientes e artigos.
Na prática, a integração é usada para:
-
Criar documentos automaticamente com base nas encomendas;
-
Criar notas de crédito automaticamente (em cenários suportados);
-
Sincronizar produtos do WooCommerce para o Moloni (evita recriar artigos manualmente);
Sincronizar stocks do Moloni para o WordPress (útil quando o stock “mestre” está no Moloni).
2) Fluxo típico (o que acontece quando entra uma encomenda)
-
O cliente faz uma compra no WooCommerce.
O plugin Moloni usa os dados da encomenda para:
-
identificar/criar o cliente no Moloni (se ainda não existir);
-
identificar/criar o artigo (produto) no Moloni quando necessário;
-
criar o documento no Moloni (ex.: fatura, fatura-recibo, etc., conforme configuração).
-
-
Dependendo do que definir, o documento pode ficar em rascunho ou fechado. A possibilidade de trabalhar com rascunhos existe no Moloni para permitir ajustes antes do fecho.
3) Principais vantagens (porquê vale a pena)
1) Faturação mais rápida e consistente
Com o plugin, a criação de documentos pode ser automática, reduzindo trabalho manual e erros de transcrição.
2) Criação automática de clientes e artigos
O plugin pode criar clientes e artigos no Moloni com base na loja, evitando duplicação de trabalho e mantendo consistência de dados.
3) Sincronização de produtos e stock
-
Produtos WooCommerce → Moloni (sincronização de artigos)
-
Stock Moloni → WordPress (atualização do stock na loja quando há movimentos no Moloni; pode demorar alguns minutos por ser feito por evento agendado).
4) Notificações e modo de diagnóstico (quando algo falha)
O plugin permite definir um email para ser notificado quando falha a emissão automática e inclui modo DEBUG para diagnóstico técnico (usar apenas quando necessário).
4) Limites e condições (o que a integração NÃO resolve sozinha)
Aqui está a parte mais importante para evitar surpresas.
1) “Automático” não significa “sem validação”
Se os dados da encomenda estiverem incompletos ou incoerentes (ex.: NIF/morada/país, impostos mal configurados, diferenças nos totais), o documento pode ficar em rascunho para permitir correção antes do fecho. O próprio Moloni suporta a lógica de rascunho para permitir edições antes do fecho.
Boa prática Uebyou: começar com rascunho, validar processo, e só depois evoluir para fechado (automatização total).
2) Dependência do WordPress/WooCommerce (plugins, cache, recursos)
A integração depende do estado do WordPress (updates, compatibilidades, cache, segurança, cron/eventos). Por exemplo, a sincronização de stocks é feita por evento agendado, podendo haver atraso e dependência do agendamento funcionar corretamente.
3) Autenticação e “sessões” (tokens) podem expirar
O Moloni usa autenticação OAuth 2.0 para ligação à API, com tokens que têm validade e precisam de renovação quando expiram. Quando isto falha (ex.: token expirado, falha de renovação, timeouts), a emissão automática pode parar até reautenticar.
4) O plugin tem evolução contínua (correções e mudanças)
Como qualquer integração, o plugin é atualizado e pode haver correções específicas relacionadas com o fecho de documentos e validações, conforme changelogs do Moloni.