Bulk Order

A bulk order is a temporary list of items and quantities that is maintained outside of the shopping cart. Bulk orders are useful for shoppers who want to create a list of items without committing them to the cart and for shoppers who maintain an offline list of items that they repurchase regularly.

For example, a B2B shopper maintains an Excel sheet of frequently ordered part numbers and quantities. The shopper exports the list in the required format and copies the formatted list into a bulk order form. The shopper can edit the quantities or add another part to the order. When the bulk order list is complete, the shopper adds all the items in the list to the cart.

As a shopper adds items to a list, the items are stored as an array in the additemstocartform form.

Interface examples

You can find an example of a bulk order UI component in the B2B React PWA (Progressive Web Application) Storefront. This version of a bulk order component has a Quick Order tab and a Bulk Order tab. Both tabs use the same Cortex APIs.

Quick Order tab

In the Quick Order tab, shoppers can add up to ten items to the list. A shopper can copy and paste an item number from the catalog, use the drop-down list, or scan a bar code.

Bulk Order tab

In the Bulk Order tab, shoppers can paste an unlimited, formatted list of items from another source. The format is one itemSKU,quantity pair per line.

Cortex APIs

Use the following API resources to retrieve the array of items from the additemstocartform form and then add the items to a cart:

1. Read Add Items to Default Cart Form - Retrieve the array of items from the form
2. Add Items To Default Cart - Add the array of items to a cart

note

The API resources do not replace the Batch Add to Cart accelerator. The API resources support only item name and quantity. With the accelerator, shoppers can define other properties when adding items.