Skip to main content

Update a fulfillment


Update a fulfillment

You can update fulfillments on a sales or return order line item.

The Fulfillment and Return feature is in the Early Adopter phase. We are actively soliciting feedback from a small set of early adopters before releasing it as generally available. If you want to join this early adopter program, submit a request at Zuora Global Support.

There are two ways to update a fulfillment:

  • Use the Zuora UI.

Use the Zuora UI

Complete the following steps:

  1. Log in to the Zuora application and then navigate to Customers > Orders. The Orders page opens.
  2. Search for the order that contains the order line items. For information about how to search for an order, see View the Details of an Order.
  3. Open the order details page by clicking the order number in blue in the ORDER column.
    A sales order number starts with the prefix O-, for example, O-00007470, and a return order number starts with the prefix RMA-, for example, RMA-00007467.
  4. In the Sales Order Line Items or Return Order Line Items area, click the item name in blue in the ITEM NAME column to open the order line item details page.
  5. In the Fulfillment Details area, click the fulfillment number in blue, for example, F-00000003, to open the fulfillment details page.
  6. Click Edit at the top right to change the fulfillment details page to the edit mode.
  7. Perform the following updates:
    • If the fulfillment is in the Executing state, you can update editable fields in the Overview and Fulfillment Integration areas.
    • If the fulfillment is in the Booked, Send To Billing, or Complete state, you can create new fulfillment items or edit the existing fulfillment items in the Fulfillment Items area, and then click the save icon icon-save.png to make the update take effect.

Note: You can create multiple fulfillment items, but the number of fulfillment items should not be greater than the value of the Fulfillment Quantity field.

Click Save at the top right of the fulfillment details page to make the changes take effect.

Use the REST API

Use the Update a fulfillment operation to update a fulfillment. 

The following API request updates a fulfillment from the Executing state to the Booked state, and updates the quantity and trackingNumber fields.

Request PUT {{host}}/apps/v1/fulfillments/{key}
Request Body
"state": "Booked",
"quantity": 2,
"description": "return fulfillment",
"trackingNumber": "T-0009874"