Once shipments are created, order items can only be edited from the Shipments tab. By default, shipments are created automatically upon order submission which means you will always be editing orders at the shipment level. But if you have configured shipments to be created at a certain point after order submission, then you can edit the items directly as long as the order is in the Pending Shipments state.
This guide explains how to edit order items on both shipments and orders.
If the restrictEdit
flag is set to true on the order via API, then a user without the Override Order Update Restriction behavior will not be able to edit the order.
This includes changing the address, email, contact, attributes, or other details as well as performing any actions such as creating a new shipment, reassigning or updating existing shipments, editing shipment items or notes or custom data, canceling shipment line items, and adding a payment. However, the user will still be able to initiate and process returns.
Shipment Item Edits
Once shipments exist on an order, you can only edit order items at the shipment level.
- While viewing an order, click the Shipments tab.
- Expand the drop-down menu to the right of a line item to access item actions.
To reduce item quantity, use the Cancel Item action. To increase a quantity, a new order or shipment must be created for the additional amount and will be fulfilled separately. Make changes to the item-level tax, discounts, or fees via the shipment adjustment options.
Reassign Item
Manual Reassign will allow you to select a new fulfillment location for this line item, similar to manual reassignment at the shipment level.
Auto Reassign will use Order Routing logic to assign the line item to a new fulfillment location.
Transfer Item
If applicable for the shipment type and fulfillment configurations, Request Transfer will be available and will allow a new transfer shipment to be created to supply missing inventory for the assigned fulfillment location instead.
Edit Unit Price
After editing an item's unit price, the tax will be automatically recalculated.
- Click Edit Unit Price from the item actions menu.
- Enter the new Unit Price.
- Select the Reason For Change from the drop-down menu. If you select Other, then you will be prompted to specify the reason.
- Click Save.
Cancel Item
You can cancel all or partial quantity of an item. Crediting a payment is not necessary if editing or canceling a single item from a shipment.
- You can cancel either partial quantity or the full quantity of an item.
- Click Cancel Item from the item actions menu.
- Enter the quantity of the item that you want to cancel. For example, if an item has a starting quantity of 7 then cancelling 3 will change the shipment quantity to 4. Cancelling all 7 will remove the line item from the shipment entirely.
- Select a Cancel Reason from the drop-down.
- Click Cancel Items to confirm.
After canceling the item, it will be moved to a new Canceled Items tab in the shipment details. This allows you to view a record of items that were previously included in the shipment.
You can have your tenant configured to retain an item's handling fee when it is cancelled. In Order Management-Only implementations, the line item's handling fee will be redistributed onto other items in the shipment. In eCommerce + Order Management implementations that do not distinguish between order-level and item-level handling fees, the total handling fee will be retained. Contact Kibo Support to enable this behavior.
View Custom Data
Custom order data is passed to the shipments upon initial order creation, but any edits to the item-level custom data made after creation must be done on a per-shipment basis. This means that you should update any custom item data on every shipment within the order where needed because a change at the order level will not be applied across the board.
- Click View Custom Data from the item actions menu. This opens a modal displaying the item-level custom data that was applied to the shipment during order creation.
- Click Edit to change a custom data key. Note that these values are always treated as strings. Click Save after entering the new value.
- Click Delete to remove a data key from this item.
If you want to edit shipment-level custom data instead, rather than the custom data of individual items, you can do this from the Custom Data tab of the shipment details.
Gift Card Items
If an item is a digital product, such as a gift card, then it will be displayed as a "Digital" shipment type. The shipment information in the Order Admin will have an additional tab for Gift Card Details where the gift card number, PIN, recipient and sender names and emails, and gift message are displayed.
You can edit the recipient's name or email as well as the gift message and resend the gift card email to the recipient:
- Click into a text box to make changes. As with customer accounts, the maximum allowed length for an email address is 254 characters.
- Click Resend Gift Card Email to save changes and send the customer a new email with their gift card information.
Order Item Edits
If an order is in the Pending Shipment status (which must be enabled by configuring how long after order submission the shipments are created), then you can edit individual items and make adjustments before the shipment is created.
Repricing Behavior
Whether or not an edit reprices the order (updates its tax, discounts, shipping, and/or handling) depends on the type of edit being done. While implementations with eCommerce follow the same repricing behavior as when creating offline orders, Order Management implementations vary depending on whether or not you have a product catalog.
- Order Management-Only: All totals will be proportionally redistributed across the remaining item quantities when a quantity is decreased or an item is canceled. When editing an item's unit price or making adjustments to the order, shipping, and handling totals, then only the tax amount is refreshed (which requires tax to be configured in your tenant). This means that any discounts that were present when the order was placed will remain after editing a unit price or making adjustments.
- Order Management with Catalog: When the Refresh Pricing on Order site setting is enabled, repricing will follow the same behavior as when creating offline orders. This requires you to have payment gateways, tax, shipping carriers, and discounts configured. When this setting is disabled (which is the default), it will follow the same behavior as Order Management-Only.
If a new payment needs to be collected (such as after adding an item or changing the shipping that incurs extra shipping costs) then the payment will not be automatically collected. You must add a new payment to the order manually, which will immediately be Authorized.
Perform Edits
As these items have not yet been assigned to fulfillment locations, this allows you to add and remove items, decrease and increase quantities, and edit pricing (including order subtotals) all on the same screen.
- Click Edit Details while viewing the order details.
- This will open a modal similar to that of creating an offline order.
- In the line items table, you can edit the fulfillment method, unit price, and quantity of any existing items. You can also choose whether to subscribe to the item (and if so, change its frequency) if subscriptions are enabled. Add new items using the Product Search bar as needed.
- Expand the Order Adjustments, Shipping, Handling, and/or Tax & Duty sections of the order details to edit them. Make adjustments by adding or subtracting from each subtotal to recalculate the full order total.
Note that if the Disable Tax and Duty Adjustments site setting is enabled, then you will not be able to make edits to any of the tax or duty totals through the Admin UI.
- Other miscellaneous edits can be made to the order such as changing the pickup contact (if any pickup items were selected), applying coupons, changing the price list, and adding customer notes or a gift message.
- Click Save in the bottom right once all edits have been completed.