Order Handling with Packages

Background

Items are moved digitally during order processing; they are later moved physically into packages. Afterwards, all order actions are executed on package-level.

Move to “Ready to Ship”/”Shipped”/”Delivered”

Once items are selected for an order and the order processing starts, items will be formed into a package. In this scenario, it is sufficient to set one item to the targeted status. Seller Center automatically applies the status change to all items within the same package.

In the Order Documentation, a Seller can find information that will be sent to the Shop’s order system.

For packages with multiple items, a random order item ID is used to send the status information to the Shop Order System (OMS). Based on this order item ID, all items from the package need to be changed accordingly on the Order Management System-side.

Cancellation

There are multiple cancellation reasons:

  • The customer calls customer service and wants to cancel either the whole order or a certain order item.
    • Possible reasons: The customer changed their mind, they mis-ordered, etc.
  • Seller needs to cancel either the whole order or specific item.
    • Possible reason: The item is not in stock anymore.

Cancellation on “Pending” Status

Cancellation on “Pending” status can be triggered either by automatic status updates from the Order System or by a Seller deciding to cancel an item by themself.

If a Seller starts to create a package, they need to take various details into consideration (e.g., select multiple items, choose a shipment provider, etc.).

When multiple order items are already part of a package and one item from the package is canceled, the whole package is canceled. The same behavior should be taken into consideration on the Shop Order System-side.

Cancellation of Packed Items

Possible scenarios:

  1. A Seller wants to cancel one item within an order when the package has been already created and the order package is not yet completely moved to “Ready to ship.”
  2. A package is already in the status of “Ready to ship” and the Sellers discovers while creating the physical package that some items are no longer in stock. Therefore, these items need to be canceled.

Seller Center provides two functionalities to ensure that the right items can be canceled:

  1. Cancellation on packed pending items
  2. Cancelation on order items in “Ready to ship” status
    In order to use both features, please create a TMLSD ticket in JIRA so that it can be enabled.

    For Rocket Labs Service Desk: the config parameter: order/one_item_cancellation needs to be enabled.

    (Failed) Delivery of Shipped Items

    The same logic is applied for delivered or failed delivery items. If one status of an order item has been changed, all connected order items of the package change their statuses as well. It is possible that some order items have been delivered and the remaining items are rejected by a customer.

    In this case, the Shop offers the option to “try on” the ordered items to their customers. The customer can decide on the spot if they want to keep all or some of the ordered items, or if they will be returned.

    In order to activate this feature, please create a ticket within TMLSD project in JIRA.

    For Rocket Labs, please take following actions to activate the feature:

  3. With these new API call versions, it is possible to set only selected items to either “Delivered” or “Failed delivery.” Only mentioned order items within the API call change their status. It does not matter whether the delivered call is sent first and then the failed delivery call to OMS, or vice versa. Regardless of the order, items will be processed.

    Changes for Seller

    Furthermore, there is additional information to consider when a Seller uses API in order to connect to Seller Center and proceed orders. The current version of the API documentation is reachable for Sellers in the help section.

    There are no changes during order processing when using the UI.