Can a customer order without filling in a required field?

Not in the standard checkout: the Place order button stays locked and the server checks every value. A payment module that creates the order without going through the payment step, such as an express payment button on the product page, bypasses this check. In that case the module adds a private note to the order listing the missing fields.

Where does the PO number appear on the invoice?

Your choice: in the header below the invoice number, or at the bottom of the invoice. For the header, the module adds a delimited block to the pdf/invoice.summary-tab.tpl template of your theme, creates this file from the PrestaShop one if it does not exist, keeps a backup of an already customised version and removes the block on uninstall. Each field can be set for the invoice, the delivery slip or neither.

Do the values appear in the order confirmation email?

Yes, through the {dfcf_fields} variable, which inserts every value as a table, and {dfcf_po_number}, {dfcf_desired_date} and the other codes for a single value. Add them to your order_conf and new_order templates. They are available in every email that contains the order ID.

Can a value be changed after the order?

Yes, from the Custom fields card on the back-office order page, attachment included. Customer account fields are edited from the customer page, and by the customer in My personal information for those shown at registration.

Is the module compatible with DataFirefly Invoice Editor?

Yes with the bottom-of-invoice position: the invoice editor keeps the content modules add through the displayPDFInvoice hook and lets you choose where it goes. The header position relies on the invoice.summary-tab.tpl template, which the invoice editor replaces: with it, keep the Bottom of the invoice setting.

Do the fields work for guest orders?

Yes. Order fields are saved on the cart and then copied to the order. Customer account fields are saved on the guest account PrestaShop creates at checkout.

How does an ERP retrieve the values?

Enable the dfcf_values resource in the permissions of a webservice key (Advanced Parameters > Webservice), then call /api/dfcf_values?filter[id_order]=[123]&display=full. Each value is returned with the field code and label and a link to the order and the customer.

Does the module modify PrestaShop files?

It adds no class override and does not touch core files. The only write outside its folder is the block added to the invoice template of the theme, and only if you choose the header position.

Custom Checkout & Registration Fields PrestaShop 8/9

Add Custom Checkout & Registration Fields to PrestaShop 8 & 9 (PO Number, Delivery Date)

Your B2B customers' PO number, from checkout to invoice.

Your business customers need to enter their purchase order number, a delivery date or their company ID, or attach a document, and PrestaShop has no field for any of it. The information ends up in the order message, in an email or nowhere, and the invoice goes out without the reference the customer's accounts department needs to pay it. This module adds custom fields to the checkout and the registration form, checks them before the order is placed and carries them wherever you need them: order page, PDF invoice, delivery slip, emails, order list, customer page, CSV exports and webservice. Five ready-to-use fields are created on install and remain fully editable.

At a glance

PO number, requested date, SIRET, sector and attachment created on install
9 field types, stored on the order or on the customer account
Conditional display, billing country and customer group restrictions
Values on the PDF invoice (header or bottom), emails, order list and exports
Place order button locked while a required field is empty or invalid

PrestaShop 8 & 9 B2B Webservice API 8 languages

30-day refund

12 months updates

24h support

The long version

Everything you'd want to know before you install.

A detailed look at how Add Custom Checkout & Registration Fields to PrestaShop 8 & 9 (PO Number, Delivery Date) works, why we built it the way we did, and the thinking behind the features above.

§ 01

What PrestaShop cannot do

PrestaShop offers a free message at the delivery step and, in B2B mode, SIRET and APE fields on the customer account. Nothing for a purchase order number per order, a requested delivery date or a document to attach, and no way to make this information mandatory. Business buyers write it in the message or send it by email, customer service copies it by hand, and the invoice goes out without the reference the customer's accounts department requires to pay it.

§ 02

Each field at the right point of the journey

Company fields (SIRET, business sector) are saved on the customer account: entered at registration or with the first order, they are prefilled afterwards and copied to each order. Order fields (PO number, requested date, attachment) appear in the checkout, at the payment or delivery step. Each order keeps a copy of the values from the day it was placed.

§ 03

For customer service, accounting and the ERP

The PO number and requested date appear on the order page, in a searchable column of the order list, on the invoice and on the delivery slip. The CSV export lists the orders of a period with their fields, ready for Excel. An ERP or connector reads the same values through the PrestaShop webservice, with the dfcf_values resource.

§ 04

Attachments with no risk for the shop

A file sent by a customer is checked twice: its extension must be in the allowed list of the field, and its real content must match, so a script renamed to .pdf is refused. It is stored with a random name and no extension, in a folder where direct access is denied. Only the customer who owns the order and back-office employees can download it.

§ 05

Fields adapted to each customer

A manufacturer selling in France and Belgium can limit the SIRET to French billing addresses, show the PO number only to the Professionals group and ask for a document only when the customer picks the Healthcare sector. Conditions can be chained and a hidden field is never required.

Add Custom Checkout & Registration Fields to PrestaShop 8 & 9 (PO Number, Delivery Date)

The short version.

Checked before the order

SIRET verified, not just typed

A realistic delivery date

Fields that adapt to the customer

PO number in the invoice header

Find an order by the customer's reference