---
title: "Update a DropShipPurchaseOrder (async)"
method: POST
path: "/drop_ship_purchase_orders/update"
tags: ["Drop Ship Purchase Orders"]
---

# Update a DropShipPurchaseOrder (async)

`POST /drop_ship_purchase_orders/update`

## Request

- Base URL: `https://api.liftforward.com`
- URL: `https://api.liftforward.com/drop_ship_purchase_orders/update`
- Auth: API key in header `Api-Key`

When necessary the drop ship purchase order update api will allow the merchant to update the
serial number associated with the listed item.

One of the following 2 unique identifiers for the drop ship purchase order must be provided:
- `merchant_drop_ship_purchase_order_id` - The merchant's unique identifier for the drop ship purchase order.
- `drop_ship_purchase_order_id` - The LiftForward unique identifier for the drop ship purchase order, as
  sent in the drop ship purchase order notification webhook.

When both are provided, the drop ship purchase order is looked up by `drop_ship_purchase_order_id` only.
A 404 response means none of the merchant's drop ship purchase orders matched the identifier at the time
of the request.

The `items` parameter is required and must contain at least 1 object with a `current_serial_number` value that
has already been submitted to LiftForward. If found the api will return a success response and update the
serial_number on file with the provided `new_serial_number` value in the background.

## Request body

- PostDropShipPurchaseOrdersUpdate: Update a DropShipPurchaseOrder (async)
  - `drop_ship_purchase_order_update` DropShipPurchaseOrderUpdate, required
    - `drop_ship_purchase_order_id` string: LiftForward's drop ship purchase order Id
    - `merchant_drop_ship_purchase_order_id` string: Merchant's drop ship purchase order Id which is customer displayable
    - `merchant_drop_ship_purchase_order_record_id` string: Merchant's record Id which can be different than the customer displayable `merchant_drop_ship_purchase_order_id`
    - `items` DropShipPurchaseOrderUpdateItemEntity[], required: All items in the order are required
      - `sku` string, required: Merchant's product SKU
      - `current_serial_number` string: Current serial number of the device
      - `new_serial_number` string: New serial number of the device

## Response `201`

Update a DropShipPurchaseOrder (async)

- ApiAsyncResponse: ApiAsyncResponse model
  - `request_id` string, required: LiftForward's unique ID for a single API request
  - `code` string, required: HTTP response status code
  - `status` string, required: A value of 'success' is returned when status code in the 200 range. This action has been successfully completed or queued for processing and should be considered successful.
  - `message` string: Additional information about the status of the API request.
  - `request_url` string: The API endpoint that was called.
  - `request_parameters` object: Parameters submitted by the API call for confirmation.

## Other responses

- `400`: Invalid parameters
- `401`: Unauthorized
- `405`: Not Allowed
- `408`: Request Time Out
- `500`: Internal Service Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/liftforward/apis/device-as-a-service-merchant-apis-lift-daas-service-producti.md) - [All operations](https://skmtc.dev/liftforward/apis/device-as-a-service-merchant-apis-lift-daas-service-producti/llms.txt) - [OpenAPI document](https://skmtc.dev/liftforward/apis/device-as-a-service-merchant-apis-lift-daas-service-producti/revisions/5a1383ffd271?raw)