PrestaShop Checkout & Pagamento

Adicionar Campos Personalizados ao Checkout e ao Registo no PrestaShop 8 e 9

O número da ordem de compra dos seus clientes B2B, do checkout à fatura.

Os seus clientes profissionais precisam de indicar o número da ordem de compra, uma data de entrega ou o número da empresa, ou anexar um documento, e o PrestaShop não tem nenhum campo para isso. A informação chega na mensagem da encomenda, por e-mail ou não chega, e a fatura sai sem a referência que a contabilidade do cliente exige para pagar. Este módulo acrescenta campos personalizados ao checkout e ao formulário de registo, verifica-os antes da confirmação da encomenda e leva-os para onde precisa: página da encomenda, fatura PDF, guia de remessa, e-mails, lista de encomendas, ficha do cliente, exportações CSV e webservice. Cinco campos prontos a usar são criados na instalação e continuam totalmente editáveis.

Em resumo
  • Número da ordem de compra, data pretendida, SIRET, setor e anexo criados na instalação
  • 9 tipos de campo, guardados na encomenda ou na conta de cliente
  • Apresentação condicional, restrição por país de faturação e grupo de clientes
  • Valores na fatura PDF (cabeçalho ou fundo), nos e-mails, na lista de encomendas e nas exportações
  • Botão Encomendar bloqueado enquanto um campo obrigatório estiver vazio ou inválido
PrestaShop 8 e 9 B2B API webservice 8 idiomas
  • Reembolso em 30 dias
  • 12 meses de atualizações
  • Suporte em 24h
www.datafirefly.com/pt/
Adicionar Campos Personalizados ao Checkout e ao Registo no PrestaShop 8 e 9
v1.2.1 · atualizado 2026-09-30
O que faz

A versão curta.

01

Verificado antes da encomenda

Os campos são guardados durante a escrita. Enquanto um campo obrigatório estiver vazio ou inválido, o botão Encomendar (ou Continuar no passo de envio) fica bloqueado e o cliente vê a mensagem abaixo do campo. O servidor volta a verificar cada valor: formato, SIRET, data, extensão e conteúdo do ficheiro.

02

SIRET verificado, não apenas escrito

O tipo SIRET verifica os 14 dígitos e a chave de Luhn, incluindo a regra própria dos estabelecimentos de La Poste. O valor pode ser copiado para o campo SIRET nativo do cliente, usado pelo modo B2B do PrestaShop.

03

Uma data de entrega realista

Prazo mínimo em dias, horizonte máximo, apenas dias úteis e dias de encerramento: um dia, um período ou uma data anual como 25 de dezembro. A primeira data disponível é calculada e apresentada abaixo do campo.

04

Campos que se adaptam ao cliente

Um campo pode aparecer apenas quando outro tem um valor definido (o SIRET quando o cliente marca Sou uma empresa), apenas para certos países de faturação ou certos grupos de clientes. Um campo oculto nunca é obrigatório e o seu valor não é guardado.

05

Número da ordem de compra no cabeçalho da fatura

O PrestaShop não tem hook no cabeçalho da fatura. O módulo acrescenta um bloco delimitado ao modelo invoice.summary-tab.tpl do tema para mostrar os campos abaixo do número da fatura, onde o comprador os procura, e remove-o ao desinstalar. A posição no fundo da fatura continua disponível.

06

Encontrar uma encomenda pela referência do cliente

Cada campo pode tornar-se uma coluna filtrável da lista de encomendas, e os campos da conta de cliente uma coluna da lista de clientes. Escreva o número da ordem de compra no filtro e a encomenda aparece.

A versão longa

Tudo o que quer saber antes de instalar.

Uma análise detalhada de como o Adicionar Campos Personalizados ao Checkout e ao Registo no PrestaShop 8 e 9 funciona, porque o construímos assim e o raciocínio por trás das funcionalidades acima.

§ 01

O que o PrestaShop não sabe fazer

O PrestaShop oferece uma mensagem livre no passo de envio e, em modo B2B, os campos SIRET e APE na conta de cliente. Nada para um número de ordem de compra por encomenda, uma data de entrega pretendida ou um documento a anexar, e nenhuma forma de tornar estas informações obrigatórias. Os compradores profissionais escrevem-nas na mensagem ou enviam-nas por e-mail, o apoio ao cliente copia-as à mão e a fatura sai sem a referência que a contabilidade do cliente exige para pagar.

§ 02

Cada campo no momento certo

Os campos da empresa (SIRET, setor de atividade) são guardados na conta de cliente: introduzidos no registo ou na primeira encomenda, são depois pré-preenchidos e copiados para cada encomenda. Os campos da encomenda (ordem de compra, data pretendida, anexo) aparecem no checkout, no passo de pagamento ou de envio. Cada encomenda guarda uma cópia dos valores do dia em que foi feita.

§ 03

Para o apoio ao cliente, a contabilidade e o ERP

O número da ordem de compra e a data pretendida aparecem na página da encomenda, numa coluna filtrável da lista de encomendas, na fatura e na guia de remessa. A exportação CSV extrai as encomendas de um período com os seus campos, pronta para o Excel. Um ERP ou conector lê os mesmos valores pelo webservice do PrestaShop, com o recurso dfcf_values.

§ 04

Anexos sem risco para a loja

Um ficheiro enviado por um cliente é verificado duas vezes: a extensão tem de constar da lista permitida do campo e o conteúdo real tem de corresponder, por isso um script renomeado para .pdf é recusado. É guardado com um nome aleatório e sem extensão, numa pasta com acesso direto proibido. Só o cliente dono da encomenda e os funcionários do back office o podem descarregar.

§ 05

Campos adaptados a cada cliente

Um fabricante que vende em França e na Bélgica pode limitar o SIRET às moradas de faturação francesas, mostrar o número da ordem de compra apenas ao grupo Profissionais e pedir um documento só quando o cliente escolhe o setor Saúde. As condições encadeiam-se e um campo oculto nunca é exigido.