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.

{
  "drop_ship_purchase_order_update": {
    "drop_ship_purchase_order_id": "4gzny7pdj87mkvbkhc3gq74pjwh",
    "merchant_drop_ship_purchase_order_id": "LFOR12345ABDF",
    "merchant_drop_ship_purchase_order_record_id": "12345A",
    "items": [
      {
        "sku": "MP-12345",
        "current_serial_number": "SN1234",
        "new_serial_number": "SN4321"
      }
    ]
  }
}

{
  "request_id": "fb20f856-0f09-4927-b1b2-5393c68c589b",
  "code": "200",
  "status": "successful",
  "message": "The request has been queued and is considered successful.",
  "request_url": "/orders/123456"
}