WDOnline – Invoice payment for woocommerce

O WDOnline Invoice Payment for WooCommerce adiciona um método flexível de pagamento por fatura ao WooCommerce. Foi concebido para lojas B2B, clientes grossistas e outras empresas que permitem aos clientes aprovados efetuar encomendas a crédito. O plugin permite controlar quem pode pagar por fatura, atribuir prazos de pagamento e limites de crédito, impedir que os clientes ultrapassem o crédito disponível, gerir informações de faturação e disponibilizar aos clientes uma visão geral dedicada das faturas em A minha conta.

Requisitos

• WordPress 6.5 ou posterior
• WooCommerce 8.0 ou posterior
• PHP 7.4 ou posterior
• O cliente deve ter uma conta de utilizador WordPress e ter sessão iniciada para utilizar o pagamento por fatura

Os clientes convidados não podem utilizar o pagamento por fatura, pois o plugin necessita de uma conta de cliente para determinar a elegibilidade, os prazos de pagamento, os limites de crédito e os saldos das faturas por pagar.

Instalação

1. Aceda a Plugins → Adicionar novo plugin no WordPress.
2. Clique em Carregar plugin.
3. Selecione o ficheiro ZIP do plugin.
4. Clique em Instalar agora.
5. Ative o WDOnline Invoice Payment for WooCommerce.
6. Aceda a WD Online → WDOnline Invoice Payment for WooCommerce.

O plugin funciona de forma independente e não necessita de um plugin base separado da WD Online.

Separadores de administração

A página de administração do plugin contém três separadores:

• Gateway – Configure o método de pagamento, os prazos de pagamento, os controlos de crédito, as funcionalidades opcionais e as predefinições dos perfis.
• Invoice orders (Encomendas com pagamento por fatura) – Consulte as encomendas efetuadas com pagamento por fatura.
• User roles (Perfis de utilizador) – Crie e gira perfis de cliente.

O separador User roles (Perfis de utilizador) está disponível apenas para administradores.

Configuração rápida

Para uma configuração básica:

1. Abra o separador Gateway.
2. Ative Enable invoice payment (Ativar pagamento por fatura).
3. Introduza o prazo de pagamento predefinido, por exemplo, 14 ou 30 dias.
4. Defina um limite de crédito predefinido ou introduza 0 para crédito ilimitado.
5. Decida se o pagamento por fatura deve estar ativado globalmente ou apenas para determinados perfis de utilizador.
6. Reveja as definições em Role defaults (Predefinições dos perfis).
7. Guarde as definições.
8. Edite os clientes individualmente se necessitarem de prazos, limites de crédito ou regras de acesso diferentes.

Definições do gateway

Ativar pagamento por fatura

Esta definição ativa ou desativa o método de pagamento por fatura na finalização da compra. Desativar o gateway não elimina as encomendas existentes com pagamento por fatura, as definições dos clientes, as faturas PDF carregadas, os saldos ou o histórico de faturas.

Título na finalização da compra

O título é o nome apresentado junto do método de pagamento. Pode utilizar o marcador {days} para apresentar o prazo de pagamento efetivamente aplicado ao cliente. Por exemplo: Fatura – {days} dias Para um cliente com um prazo de 30 dias, o título será apresentado como Fatura – 30 dias.

Descrição na finalização da compra

A descrição é apresentada quando o cliente seleciona o pagamento por fatura. O marcador {days} também pode ser utilizado aqui.

Instruções da encomenda

As instruções da encomenda são apresentadas após a finalização da compra e nos emails relevantes da encomenda enviados ao cliente. Utilize {days} para incluir o prazo de pagamento atribuído à encomenda.

Estado da encomenda após a finalização da compra

Escolha o estado WooCommerce atribuído depois de uma encomenda ser efetuada com pagamento por fatura:

• Em processamento
• Em espera
• Pagamento pendente

O estado da encomenda WooCommerce e o estado da fatura do plugin são separados. Assim, uma encomenda pode estar em processamento enquanto a respetiva fatura ainda não foi criada ou continua por pagar.

Encomendas virtuais

Ative esta opção se pretender permitir o pagamento por fatura em encomendas que contenham apenas produtos virtuais.

Predefinições globais

As predefinições globais aplicam-se quando não são substituídas por uma definição individual do cliente ou específica do perfil.

Elegibilidade predefinida

Ative esta opção para permitir, por predefinição, o pagamento por fatura aos clientes com sessão iniciada. Se esta opção estiver desativada, o pagamento por fatura pode continuar a ser ativado para determinados perfis de utilizador ou clientes individuais.

Prazos de pagamento predefinidos

Introduza o número predefinido de dias que os clientes têm para pagar a partir da data da fatura. Os prazos de pagamento são calculados a partir da data da fatura, não da data da encomenda. Se uma encomenda for efetuada a 1 de setembro, faturada a 5 de setembro e tiver um prazo de 30 dias, a data de vencimento será 5 de outubro.

Controlo de crédito

Limite de crédito predefinido

O limite de crédito é a exposição total máxima permitida para um cliente em compras com pagamento por fatura.

• Introduza um montante positivo para definir um limite.
• Introduza 0 para crédito ilimitado.

O plugin calcula o crédito disponível da seguinte forma: Limite de crédito − saldo das faturas por pagar = crédito disponível A exposição inclui encomendas por pagar efetuadas com o WDOnline Invoice Payment, incluindo aquelas a que ainda não foi atribuído um número ou uma data de fatura. Isto impede que um cliente efetue várias encomendas que, no total, ultrapassem o limite de crédito antes da emissão da primeira fatura. As encomendas com pagamento por fatura canceladas, falhadas, reembolsadas e pagas são excluídas conforme aplicável.

Mensagem sobre o limite de crédito na finalização da compra

Esta mensagem é apresentada quando o pagamento por fatura deixa de estar disponível porque a nova encomenda ultrapassaria o crédito disponível do cliente. Estão disponíveis os seguintes marcadores:

• {credit_limit} – O limite de crédito efetivamente aplicado ao cliente
• {available_credit} – O crédito restante após considerar as encomendas em aberto com pagamento por fatura
• {order_total} – O total atual na finalização da compra

Faturas vencidas

Ative Block invoice payment when the customer has overdue invoice orders (Bloquear o pagamento por fatura quando o cliente tem encomendas com faturas vencidas) para impedir que clientes com faturas vencidas efetuem novas encomendas com pagamento por fatura.

Período de tolerância

O período de tolerância acrescenta um determinado número de dias após a data de vencimento antes de a fatura ser considerada em atraso. Por exemplo, uma fatura com vencimento a 1 de outubro e um período de tolerância de três dias passa a ser considerada em atraso após 4 de outubro.

Funcionalidades opcionais

A secção Features (Funcionalidades) permite escolher que partes administrativas e destinadas aos clientes do plugin estão ativas. Desativar uma funcionalidade oculta a respetiva interface, mas não elimina as informações das faturas guardadas, as definições dos clientes, o histórico de encomendas, os saldos ou os documentos carregados.

Perfil do cliente – Pagamentos por fatura

Mostra o acesso ao pagamento por fatura, os prazos de pagamento, os controlos de crédito e as informações sobre o saldo das faturas ao editar um utilizador WordPress. Também adiciona informações sobre faturas à lista de utilizadores.

Encomendas – Estado da fatura

Adiciona informações sobre o vencimento das faturas e filtros por estado da fatura à lista de encomendas WooCommerce.

Encomenda – Gestão da fatura

Adiciona o painel Invoice payment (Pagamento por fatura) às encomendas individuais do WooCommerce. Este painel é utilizado para gerir números de fatura, datas, estados, datas de pagamento e documentos PDF.

Painel – Visão geral dos pagamentos por fatura

Adiciona um widget de resumo das faturas ao painel principal do WordPress para os utilizadores com permissão para gerir o WooCommerce.

Conta do cliente – Saldo e histórico de faturas

Adiciona a secção Invoice payments (Pagamentos por fatura) à área A minha conta do WooCommerce do cliente. Pode apresentar prazos de pagamento, saldos, histórico de faturas, estados, datas de vencimento e downloads protegidos de PDF. As seguintes definições dependem desta funcionalidade e só podem ser ativadas quando esta estiver ativa:

• Conta do cliente – Limite de crédito – Mostra ou oculta o limite de crédito total do cliente.
• Conta do cliente – Crédito disponível para pagamento por fatura – Mostra ou oculta o crédito restante disponível do cliente para pagamento por fatura.

Ocultar estes valores não desativa o controlo de crédito. O plugin continuará a aplicar o limite de crédito do cliente na finalização da compra.

Etiqueta do menu A minha conta

Introduza o texto utilizado no item de menu da área de conta do cliente. Esta definição altera apenas a etiqueta visível e não modifica o URL do endpoint.

Título da página A minha conta

Introduza o título apresentado no topo da página de faturas do cliente.

Encomendas – Faturas PDF externas

Permite o carregamento seguro de faturas PDF nas encomendas com pagamento por fatura. Os clientes podem descarregar as suas faturas PDF a partir da respetiva conta depois de iniciarem sessão.

Predefinições dos perfis

As predefinições dos perfis permitem atribuir condições de pagamento por fatura diferentes aos vários perfis de utilizador do WordPress ou WooCommerce. Para cada perfil, pode configurar:

• Acesso ao pagamento por fatura
• Prazos de pagamento
• Limite de crédito
• Gestão de faturas vencidas

As opções disponíveis incluem utilizar a predefinição global, ativar ou desativar o pagamento por fatura, introduzir prazos de pagamento específicos do perfil, atribuir um limite de crédito específico e permitir ou bloquear o pagamento por fatura quando existem faturas vencidas. A prioridade das definições é:

1. Definições individuais do cliente
2. Definições do perfil de utilizador
3. Predefinições globais

Por exemplo, o prazo de pagamento global pode ser de 14 dias, enquanto os clientes grossistas recebem 30 dias e um cliente específico recebe 60 dias.

Criar perfis de cliente

Abra o separador User roles (Perfis de utilizador) para criar um novo perfil.

1. Introduza um nome para o perfil.
2. Introduza um slug técnico opcional. Se deixar o campo vazio, o plugin gera um a partir do nome do perfil.
3. Selecione um perfil existente cujas permissões devem ser copiadas.
4. Para contas normais de clientes B2B, recomenda-se copiar o perfil Customer (Cliente) do WooCommerce.
5. Crie o perfil.

O novo perfil aparecerá automaticamente em Role defaults (Predefinições dos perfis). O separador Perfis de utilizador também apresenta todos os perfis existentes, os respetivos slugs técnicos, as suas origens e o número de utilizadores atribuídos. Apenas os perfis criados através deste plugin podem ser eliminados nesta página. Um perfil não pode ser eliminado enquanto estiver atribuído a um ou mais utilizadores. Os perfis do WordPress, do WooCommerce e de terceiros estão protegidos.

Definições individuais do cliente

As definições individuais sobrepõem-se às predefinições dos perfis e às predefinições globais. Para configurar um cliente:

1. Aceda a Utilizadores no WordPress.
2. Edite o cliente relevante.
3. Localize a secção Invoice payment (Pagamento por fatura).
4. Configure os campos necessários.
5. Atualize o utilizador.

Acesso ao pagamento por fatura

Escolha se o cliente deve herdar a definição do perfil ou a global, ser explicitamente autorizado ou ser explicitamente impedido de utilizar o pagamento por fatura.

Prazos de pagamento

Introduza o prazo de pagamento do cliente em dias. Deixe o campo vazio para herdar a predefinição do perfil ou a global.

Limite de crédito

Introduza o limite de crédito do cliente. Deixe o campo vazio para herdar a predefinição do perfil ou a global, ou introduza 0 para crédito ilimitado.

Gestão de faturas vencidas

Escolha se o cliente deve herdar a regra predefinida, ser bloqueado quando existem faturas vencidas ou continuar autorizado a utilizar o pagamento por fatura apesar de ter faturas vencidas. O perfil do cliente também apresenta os prazos de pagamento efetivamente aplicados, o saldo das faturas por pagar, o crédito disponível e o montante em atraso quando a funcionalidade administrativa correspondente está ativada.

Comportamento na finalização da compra

O pagamento por fatura só é apresentado quando todas as condições relevantes são cumpridas. O cliente deve:

• Ter sessão iniciada
• Ser elegível para pagamento por fatura
• Ter crédito disponível suficiente, exceto quando o crédito é ilimitado
• Cumprir as regras relativas a faturas vencidas
• Cumprir a definição relativa a encomendas virtuais quando a encomenda contém apenas produtos virtuais

Se o limite de crédito for ultrapassado, o pagamento por fatura é removido e é apresentada a mensagem de crédito configurada. A mensagem é atualizada quando o total da compra muda. O plugin volta a validar as regras de crédito quando a encomenda é submetida. Esta validação no servidor impede a conclusão da compra com pagamento por fatura se a conta já não cumprir as regras.

Gerir encomendas com pagamento por fatura

As encomendas efetuadas com pagamento por fatura contêm um painel Invoice payment (Pagamento por fatura) no editor de encomendas do WooCommerce.

Prazos de pagamento

Os prazos de pagamento efetivamente aplicados ao cliente são guardados na encomenda durante a finalização da compra. Alterações posteriores à conta do cliente não modificam as encomendas existentes.

Número da fatura

Introduza o número da fatura gerado pelo seu sistema de contabilidade ou faturação.

Data da fatura

Introduza a data de emissão da fatura. A data de vencimento é calculada a partir desta data e dos prazos de pagamento guardados na encomenda.

Data de vencimento

A data de vencimento é calculada automaticamente. Só é calculada depois de ser introduzida uma data de fatura ou de a encomenda ser marcada como faturada.

Estado da fatura

O estado da fatura é gerido independentemente do estado normal da encomenda WooCommerce. Dependendo das informações disponíveis e das ações efetuadas, uma fatura pode ser apresentada como:

• Não faturada
• Faturada
• Paga
• Em atraso

Utilize os botões do painel da encomenda para marcar uma fatura como emitida, paga ou por pagar.

Carregar uma fatura PDF externa

O plugin não gera faturas. Se criar faturas num sistema de contabilidade externo, pode carregar o PDF final para a encomenda WooCommerce correspondente.

1. Abra a encomenda.
2. Localize Invoice PDF (Fatura PDF) no painel Pagamento por fatura.
3. Selecione um ficheiro PDF.
4. Clique em Upload PDF (Carregar PDF) ou Replace PDF (Substituir PDF).
5. Atualize a encomenda, se necessário.

O nome original do ficheiro PDF é apresentado acima de View current PDF (Ver PDF atual) no editor da encomenda. Os ficheiros PDF são guardados de forma privada com nomes internos aleatórios. Não são adicionados à biblioteca multimédia pública do WordPress nem ficam acessíveis através de um URL multimédia público. Os downloads são geridos através do WordPress e exigem autorização. O acesso está limitado aos administradores autorizados e ao cliente a quem pertence a encomenda. O tamanho máximo do ficheiro PDF é de 10 MB.

Visão geral das encomendas com pagamento por fatura

Abra o separador Invoice orders (Encomendas com pagamento por fatura) para consultar as encomendas efetuadas com o WDOnline Invoice Payment. A visão geral inclui:

• Número da encomenda
• Data da encomenda
• Cliente
• Estado da encomenda WooCommerce
• Estado da fatura
• Data de vencimento
• Total da encomenda

Utilize o filtro de estado da encomenda para restringir a lista. Clique num número de encomenda para abrir o editor de encomendas do WooCommerce.

Área A minha conta do cliente

Quando a funcionalidade da conta do cliente está ativada, os clientes elegíveis e os clientes com encomendas anteriores com pagamento por fatura dispõem de um item de menu Invoice payments (Pagamentos por fatura) em A minha conta. Dependendo das definições de apresentação, a página pode mostrar:

• Prazos de pagamento atuais
• Saldo das faturas por pagar
• Limite de crédito
• Crédito disponível para pagamento por fatura
• Montante em atraso
• Histórico de encomendas com pagamento por fatura
• Número da fatura
• Data da fatura
• Data de vencimento
• Estado da fatura
• Total da encomenda
• Download seguro da fatura PDF

Os clientes podem continuar a consultar o histórico de encomendas com pagamento por fatura mesmo que este método seja posteriormente desativado para novas encomendas na sua conta.

Visão geral dos pagamentos por fatura no painel

O widget do painel do WordPress oferece aos gestores da loja uma visão rápida da atividade dos pagamentos por fatura. As informações disponíveis incluem:

• Vendas com pagamento por fatura
• Número de encomendas com pagamento por fatura
• Número de clientes que utilizam o pagamento por fatura
• Valor médio das encomendas com pagamento por fatura
• Faturas pagas
• Tempo médio de pagamento
• Saldo das faturas por pagar
• Montante em atraso
• Faturas com vencimento nos próximos sete dias
• Cliente com o maior valor de compras com pagamento por fatura
• Os cinco principais clientes por compras com pagamento por fatura
• Evolução do saldo por pagar quando existem dados históricos suficientes

As estatísticas podem ser filtradas por períodos predefinidos ou por um intervalo de datas personalizado. O widget utiliza cálculos em cache para melhorar o desempenho e pode ser atualizado manualmente.

Emails e detalhes da encomenda

O plugin pode apresentar instruções de pagamento por fatura, prazos de pagamento, datas das faturas, datas de vencimento e estados das faturas nos emails relevantes enviados aos clientes pelo WooCommerce e nos detalhes das encomendas. Como os prazos de pagamento são guardados na encomenda, as informações mantêm-se consistentes mesmo que as definições atuais da conta do cliente sejam alteradas posteriormente.

Tradução

Todos os textos padrão do plugin estão escritos em inglês e utilizam o sistema de tradução do WordPress. O plugin inclui um modelo POT e é compatível com:

• Pacotes de idiomas do WordPress
• Loco Translate
• Processos de tradução padrão com ficheiros PO e MO

Os títulos personalizados na finalização da compra, as descrições, as instruções, as etiquetas da conta, os títulos das páginas e as mensagens sobre o limite de crédito também podem ser editados diretamente nas definições do plugin.

Compatibilidade com WooCommerce

O plugin suporta:

• Finalização de compras clássica do WooCommerce
• Blocos de finalização de compras do WooCommerce
• High-Performance Order Storage (HPOS) do WooCommerce
• Sistema tradicional de armazenamento de encomendas do WooCommerce

Diagnóstico de suporte opcional

O plugin pode integrar-se com o WD Online Support Diagnostics quando esse plugin separado está instalado. A integração de diagnóstico é opcional. O WDOnline Invoice Payment continua a funcionar normalmente quando o plugin de diagnóstico não está instalado ou está desativado. As verificações de diagnóstico podem ajudar a identificar problemas de configuração sem enviar automaticamente dados de telemetria ou informações dos clientes para serviços externos.

Resolução de problemas

O pagamento por fatura não aparece na finalização da compra

Verifique o seguinte:

1. O gateway está ativado.
2. O cliente tem sessão iniciada.
3. As definições do cliente, do perfil ou as predefinições globais permitem o pagamento por fatura.
4. A encomenda não ultrapassa o crédito disponível.
5. O cliente não está bloqueado devido a uma fatura vencida.
6. As encomendas virtuais são permitidas se o carrinho contiver apenas produtos virtuais.

As definições individuais do cliente têm prioridade sobre as definições do perfil e as globais, por isso verifique sempre o perfil do cliente quando o resultado for inesperado.

O crédito disponível do cliente parece incorreto

Reveja as encomendas em aberto do cliente com pagamento por fatura. As encomendas por pagar efetuadas com este método contam para a exposição de crédito mesmo que ainda não tenham uma data ou um número de fatura atribuídos. Verifique também se uma fatura foi marcada como paga e se os reembolsos ou cancelamentos foram registados corretamente no WooCommerce.

A data de vencimento não é apresentada

A data de vencimento só é calculada depois de ser introduzida uma data de fatura ou de a encomenda ser marcada como faturada.

A ligação Pagamentos por fatura na conta apresenta uma página 404

Atualize para a versão mais recente do plugin. Se o problema persistir, aceda a Definições → Ligações permanentes no WordPress e clique uma vez em Guardar alterações para reconstruir as regras de reescrita dos URL.

Não é possível carregar um PDF

Confirme que:

• O ficheiro selecionado é um PDF válido
• O ficheiro não ultrapassa os 10 MB
• O diretório de carregamentos do WordPress tem permissões de escrita
• A funcionalidade de faturas PDF externas está ativada

Não é possível eliminar um perfil de utilizador

Apenas os perfis criados através deste plugin podem ser eliminados no separador Perfis de utilizador. Atribua todos os utilizadores a outro perfil antes de eliminar um perfil criado pelo plugin.

Procedimento de configuração recomendado

Para a maioria das lojas B2B, a seguinte abordagem oferece um controlo claro:

1. Mantenha desativada a elegibilidade global para pagamento por fatura.
2. Crie ou selecione um ou mais perfis de clientes B2B aprovados.
3. Ative o pagamento por fatura e defina prazos padrão para esses perfis.
4. Atribua os clientes aprovados ao perfil adequado.
5. Utilize as definições individuais dos clientes apenas para exceções.
6. Defina limites de crédito realistas e ative o bloqueio por faturas vencidas quando apropriado.
7. Reveja regularmente as encomendas com pagamento por fatura e os saldos por pagar.

Esta configuração garante que o pagamento por fatura está disponível apenas para clientes aprovados, permitindo simultaneamente acordos individuais quando necessário.