Atualizado em: 01 de setembro de 2025

Documentação: DPCSJ

Descontos e Parcelas com/sem juros para WooCommerce (WooTatitas) — Guia de Integração para Desenvolvedores

Guia rápido para programadores que desejam usar este plugin como base em seus projetos.

Aviso importante

Este plugin pode mudar funcionalidades sem aviso prévio para acompanhar atualizações do WooCommerce.

Toda customização é de responsabilidade do desenvolvedor. Não edite os arquivos originais do plugin. Faça suas alterações em código externo:

um plugin próprio (preferencialmente must‑use),
um plugin adicional do seu projeto, ou
o functions.php de um tema filho.
Utilize hooks (actions/filters) documentados. Alterações diretas no plugin serão sobrescritas em atualizações.

1) Capabilidades funcionais

Descontos por método de pagamento (ex.: Pix, Cartão, Boleto, etc.): configuração global, por produto simples e por variação (prioridade: variação > produto > global).
Mensagens de desconto no catálogo/checkout e ícones (Pix/Cartão/Boleto/Parcelas) configuráveis.
Parcelamento:
Sem juros ou com juros por parcela.
Quantidade máxima de parcelas, prefixo/sufixo e formatação exibidos no produto e refletidos no checkout.
Checkout:
Ao selecionar/alterar o método de pagamento, o DPCSJ recalcula o deal e aplica o desconto como “fee negativo” (padrão WooCommerce), mantendo o pedido auditável.
Exibição opcional de notices orientativos no fluxo de pagamento.

2) Escopo de produto

Simples: configurações por produto; mensagem e desconto aplicados conforme método.
Variável: governança por variação (o produto-pai exibe apenas diretrizes). A exibição no produto muda dinamicamente conforme a variação selecionada.
Virtual e baixável: compatível. Frete não interfere nos cálculos de desconto; a exibição de parcelamento permanece contextual ao preço da variação/produto.
Cupons: por padrão, o desconto do DPCSJ é lançado como fee no carrinho. Em WooCommerce, cupons são aplicados antes de fees. Ajustes de negócio podem ser feitos via filters para alinhar a sua política comercial.

3) Painel e Governança de UI

Configurações Gerais (admin):
Ativação de mensagens globais, definição de ícones habilitados e parâmetros visuais.
Log e Sistema: informações operacionais e checks de saúde.
Descontos por método: percentuais por gateway em nível global, com alertas para tratar individualização por produto/variação quando necessário.
Parcelamento: escolha entre sem juros ou com juros por parcela, definição de quantidade máxima, prefixo e sufixo.
Personalização de CSS: controles de tipografia, cores, espaçamento e um modo sazonal (Black Friday) para boost de conversão.

4) Comportamento no checkout

Detecção do método de pagamento: o DPCSJ acompanha a mudança do método na etapa “Revisar e pagar” e atualiza o cenário de desconto.
Aplicação do desconto: o valor é materializado como fee negativo no carrinho/pedido (nomeado como “Desconto (…método…)” por padrão), garantindo: Transparência no order total, Rastreabilidade por item (order item fee) e Compatibilidade com relatórios.
Persistência no pedido: o fee é marcado em tempo de criação do pedido para facilitar conciliação e relatórios internos da loja.

Recomendação de arquitetura: trate o fee do DPCSJ como linha de negócio independente nas integrações de ERP/BI, sem misturar com descontos de cupom. Isso dá previsibilidade e compliance fiscal.

5) Endpoints e sinais úteis

AJAX público (read-only):
wootatitas_dpcsj_check_icons_enabled → retorna JSON com flags dos ícones habilitados (pix/cartão/boleto/parcelas).

Caso de uso: temas/headless podem consumir para renderizar badges contextuais sem acoplar-se a options.

6) Logs & Debug

Logs internos protegidos por pasta dedicada do plugin. Trate como dados sensíveis.
Eventos típicos registrados incluem alterações de método de pagamento e decisões de aplicar/ignorar desconto (com contexto para troubleshooting).
Dev-tips de teste:
Varie o método de pagamento no checkout e valide o fee negativo.
Em produto variável, altere a variação e confirme a atualização das mensagens/parcelas.
Acople seus filters e valide em pedido real (não só em cart preview).

7) Boas práticas de extensão

Encapsule toda a lógica de negócio em um plugin MU e evite OOP a menos que haja necessidade extrema (diretriz de engenharia da casa).
Não substitua classes/templates: prefira hooks.
Evite dependências de rótulo: se renomear o fee, utilize wootatitas_dpcsj_is_fee_discount para manter rastreabilidade.
Relatórios/ERP: trate o fee DPCSJ como centro de custo/receita separado de cupons — clareza contábil = menos retrabalho.

8) Matriz de compatibilidade e bordas de operação

Gateways não mapeados: o DPCSJ busca gateways registrados; se indisponíveis em tempo de execução, usa um fallback conhecido. Teste ambientes com gateways white-label.
Cupons: por padrão, cupons entram antes do fee de desconto. Se a sua política exigir outra ordem ou base de cálculo, amarre via filtros/estratégia própria no seu plugin MU.
Variações: toda decisão de desconto/parcelamento considera a variação ativa.

9) Segurança & compliance

HTTPS no checkout sempre.
Logs fora do alcance público.
Atualizações: mantenha o plugin atualizado para garantir aderência a mudanças do WooCommerce e dos gateways.

Como instalar

Veja nosso guia de como instalar nosso plugin:

Compre nosso plugin

Gostou do que viu? Compre o nosso plugin:

Direto ao ponto

Sem enrolação

Comercializamos plugins na esperança de que seja útil, porém, é importante observar que ele é fornecido SEM NENHUMA GARANTIA inclusive sem a garantia implícita de ADEQUAÇÃO A UM DETERMINADO FIM.

Estamos sempre prontos para aprimorar nosso plugin e personalizá-lo de acordo com suas necessidades específicas. Não hesite em nos contatar a qualquer momento, estamos aqui para ajudá-lo.