Tudo o que quer saber antes de instalar.
Uma análise detalhada de como o DfProforma Shopware: faturas pro forma no Shopware 6.7 com aceitação do cliente e conversão automática funciona, porque o construímos assim e o raciocínio por trás das funcionalidades acima.
A pro forma: a peça que falta ao B2B no Shopware
O Shopware 6.7 sabe emitir faturas, guias de remessa e notas de crédito, mas não pro formas. Ora, na quase totalidade dos contextos B2B, como equipamento industrial, serviços a empresas, compras públicas ou vendas por concurso, o cliente tem de receber um documento formal que aceita antes de a encomenda se tornar firme. O DfProforma preenche essa lacuna sem improvisos: um verdadeiro tipo de documento nativo do Shopware, com o seu próprio intervalo de numeração, o seu template de PDF com a sua marca, e um fluxo de aceitação autónomo com URL público seguro.
Como funciona, passo a passo
O seu comercial recebe uma encomenda, abre a ficha na administração do Shopware, clica em Pro forma e gera o documento. A extensão cria de imediato um verdadeiro documento Shopware df_proforma com o seu número PF e o seu PDF Twig com a sua marca, e guarda-o numa entidade DAL dedicada. Envia depois a pro forma por email, com um template transacional personalizável, multilingue, assinado com o nome do comercial. O email contém um URL público cifrado. O cliente clica, chega a uma página de aceitação autónoma (sem necessidade de conta Shopware), vê o resumo da encomenda e escolhe Aceitar ou Recusar com motivo. A assinatura fica com data e hora e é guardada. Os seus fluxos do Flow Builder são acionados automaticamente, a equipa é notificada e fica tudo registado para auditoria.
Fluxo de estados completo e auditável
Seis estados de negócio cobrem a totalidade do ciclo de vida de uma pro forma: rascunho (criada mas não enviada), enviada (à espera da resposta do cliente), aceite (o cliente clicou em Aceitar), recusada (o cliente clicou em Recusar com motivo), expirada (validade de 30 dias ultrapassada sem resposta) e convertida (encomenda subjacente paga). Cada transição é guardada com data ao segundo, identificador do ator, tipo de acionamento (comercial, cliente, sistema, pagamento) e payload JSON para metadados livres. Pode a qualquer momento reconstituir o histórico exato de uma pro forma, o que é útil em caso de litígio com o cliente, de auditoria interna ou de dúvida comercial.
URL público de aceitação sem atrito
É o principal contributo da extensão. Cada pro forma enviada tem um URL público do tipo a-sua-loja.com/proforma/accept/{token_assinado}. O token é cifrado e assinado com HMAC-SHA256 usando a chave secreta do Shopware, o que torna impossível a falsificação. O cliente abre o URL sem qualquer conta Shopware (a página contorna a autenticação normal da conta de cliente), vê um resumo cuidado da encomenda com linhas, preços e condições, e escolhe explicitamente Aceitar ou Recusar. Em caso de recusa, é pedido um campo Motivo obrigatório, útil para os comerciais poderem voltar a contactar o cliente com uma contraproposta. A assinatura fica com data e hora ao milissegundo, e o endereço IP do cliente é guardado como prova.
Conversão automática no recebimento, sem intervenção humana
Uma armadilha clássica das extensões de pro forma: depois de o cliente aceitar e pagar, o estado fica congelado em aceite enquanto alguém não o passar manualmente a convertida. O resultado é que o painel mente, os relatórios ficam errados e os comerciais gastam tempo a atualizar estados em vez de vender. O DfProforma resolve isso com um Subscriber no evento order_transaction.state.paid da máquina de estados do Shopware. Assim que a transação da encomenda passa a paga, a extensão deteta que há uma pro forma aceite associada a essa encomenda e passa o estado automaticamente a convertida, com o histórico de transição corretamente marcado (tipo de acionamento pagamento). Sem cliques, sem cron, sem intervenção.
Pronto para o Flow Builder: ligue os seus fluxos existentes
A extensão emite dois eventos de negócio normais do Shopware: ProformaGeneratedEvent (no momento da geração) e ProformaAcceptedEvent (no momento da aceitação pelo cliente). Ambos implementam a BusinessEventInterface e ficam automaticamente visíveis no acionador do Flow Builder. Pode assim ligar-lhes todos os seus fluxos existentes: notificação no Slack para a equipa de vendas quando uma pro forma é aceite, email de resumo interno, webhook para o seu CRM, atualização de um campo próprio no cliente, etiqueta automática na encomenda. Sem qualquer intervenção no código da extensão, tudo passa pela administração do Shopware.
Módulo Vite na administração com extensão da ficha de encomenda
A experiência do comercial está integrada diretamente na administração nativa do Shopware. Um novo separador Pro forma aparece na ficha de encomenda (extensão de sw-order-detail-base), com a lista das pro formas associadas a essa encomenda, o seu estado, as suas datas e o seu número PF. Três ações principais por documento: Gerar (criação inicial), Enviar (envio do PDF por email com template configurável), e as ações de transição manual (marcar como enviada, aceitar, recusar) para os casos excecionais em que quer forçar um estado. O bundle JavaScript da administração é em Vite (a extensão é entregue com o seu vite.config.mjs); depois da instalação, execute bin/build-administration.sh para recompilar o bundle global de administração, e o separador aparece.
Template de PDF em Twig totalmente personalizável
O PDF da pro forma é renderizado pelo motor Twig nativo do Shopware, a partir do template src/Resources/views/documents/proforma.html.twig entregue com a extensão. Pode sobrepô-lo a partir do seu tema ou da sua extensão própria seguindo a hierarquia normal de templates Twig do Shopware. O template entregue inclui um cabeçalho com o seu logotipo e os dados da empresa, um bloco de cliente, o resumo das linhas de encomenda, os totais com e sem IVA com repartição por taxa, uma faixa de resumo no rodapé (número PF, data de emissão, data de expiração), uma marca de água discreta e uma cor de marca configurável. Conformidade com a identidade visual da sua loja sem escrever uma linha de código.
Casos de uso típicos
Loja B2B de equipamento industrial: pro forma obrigatória antes da validação de encomendas acima de um limiar, aceitação do cliente online, conversão automática quando a transferência bancária é recebida. Serviços a empresas: documento enviado após o briefing do cliente, aceitação online com eventual motivo de recusa para iterar, conversão no pagamento do sinal. Compras públicas: documento formal exigido pelo adjudicante, histórico de transições auditável para conformidade, assinatura com data e hora e IP guardado. Loja de moda B2B grossista: pro forma enviada aos clientes revendedores, aceitação online sem terem de criar conta, conversão automática no pagamento. Marketplace vertical: pro formas enviadas a pedido para produtos sem stock, validade de 30 dias, expiração automática para libertar o pipeline.
Ainda não existem avaliações.