Programmatically add Purchase Order number

Programmatically add Purchase Order number

August 10, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Programmatically add Purchase Order number

Programmatically Adding Purchase Order Numbers in Magento

In many e-commerce scenarios, you may need to create orders programmatically, especially when dealing with background processes or third-party integrations. Magento provides robust APIs for this purpose, including the ability to use specific payment methods like Purchase Order (PO). However, inserting a PO number requires understanding how Magento handles payment data.

Understanding Magento’s Payment Method Setup

Magento stores payment method configurations in the core_config_data table. For the Purchase Order method, you’ll find it under the path payment/purchaseorder/active. By default, this is set to 0 (disabled). To enable it:

  1. Navigate to Stores > Configuration > Sales.
  2. Find the Payment Methods section.
  3. Expand the Purchase Order field and set Enable Purchase Order Payment Method to yes.

Setting Up the Payment Method Data

In your code, you’ve already set the payment method using:

$shippingAddress->setPaymentMethod($paymentMethod);
$quote->getPayment()->importData(array('method' => $paymentMethod));

This is correct for setting the payment method itself. However, to add additional data like a PO number, we need to work with the payment object in a different way.

Specifying Purchase Order Data

To insert the PO number, you can use the setData() method on the $quote->getPayment() object:

$poNumber = 'PO123456'; // Insert your actual PO number here
$quote->getPayment()->setData('po_number', $poNumber);

This sets the po_number field in the payment data array. Magento maps this to the purchase_order_number attribute when saving the order.

Saving the Quote as an Order

After setting all your order details, including the PO number, you can save it:

$quote->save();

Remember that for a purchase order method, the total due will typically be 0 since no immediate payment is required. You should adjust your quote totals accordingly.

Handling Purchase Orders in the Backend

When you create an order programmatically using a PO number, Magento will show this as a “Purchase Order” in the backend:

  • Navigate to Sales > Orders.
  • Find your newly created order.
  • In the “Payment Method” column, it will display “Purchase Order”.
  • The PO number you set should be visible under Payment Information when you view the order details.

Conclusion

Adding a Purchase Order number programmatically in Magento requires understanding how payment methods are handled and using the correct data manipulation functions. By setting the po_number field on the $quote->getPayment() object, you can ensure that this important information is saved alongside your order.

Always remember to test your code thoroughly, especially when dealing with financial transactions. For more advanced Magento development techniques, consider exploring our comprehensive guides at LaravelCompany.

Database API Configuration Orders

Our network