# Update a restocking shipment (replace only, allowed if status is "shipped" or "created")

Updates an existing restocking shipment. Only allowed if the shipment status is "shipped" or "created". This operation replaces the entire resource.

Endpoint: PUT /restocking_shipments/{id}
Version: 2.0.0
Security: BearerAuth

## Path parameters:

  - `id` (integer, required)
    Restocking Shipment ID

## Request fields (application/json):

  - `delivery_option` (string)
    Delivery option for the restocking shipment. Possible values:
- courier: Delivered by courier service
- dropoff: Dropped off at designated location
- hive_freight: Delivered using Hive freight service
- postal: Delivered via postal service
    Enum: "courier", "dropoff", "hive_freight", "postal"

  - `estimated_arrival_date` (string)
    Estimated arrival date

  - `po_number` (string)
    Purchase order number

  - `restocking_shipment_items` (array)
    A list of items in the shipment. See RestockingShipmentItem.

  - `restocking_shipment_items.announced_quantity` (integer, required)

  - `restocking_shipment_items.remarks` (string)

  - `restocking_shipment_items.sku_code` (string)
    The merchant's SKU identifier - required if sku_id is not provided

  - `restocking_shipment_items.sku_id` (integer)
    Hive SKU identifier - required if sku_code is not provided

  - `restocking_shipment_items.total_cost_in_cents` (integer)

  - `supplier_name` (string)
    Supplier name

  - `tracking_code` (string)
    Shipment tracking code

  - `warehouse_id` (integer)
    The ID of the Hive destination warehouse

## Response 200 fields (application/json):

  - `arrived_at` (string,null)
    When the shipment was arrived

  - `barcode` (string,null)
    The barcode of the shipment

  - `created_at` (string)
    When the shipment was created

  - `delivery_option` (string)
    Delivery option for the restocking shipment. Possible values:
- courier: Delivered by courier service
- dropoff: Dropped off at designated location
- hive_freight: Delivered using Hive freight service
- postal: Delivered via postal service
    Enum: "courier", "dropoff", "hive_freight", "postal"

  - `estimated_arrival_date` (string,null)
    Estimated arrival date

  - `id` (integer, required)
    Hive's unique identifier

  - `po_number` (string,null)
    Purchase order number

  - `restocking_shipment_items` (array, required)
    A list of items in the shipment. See RestockingShipmentItem.

  - `restocking_shipment_items.announced_quantity` (integer)
    Quantity of this item in the shipment

  - `restocking_shipment_items.arrived_quantity` (integer, required)
    Arrived quantity of this item (after shipment is received)

  - `restocking_shipment_items.damaged_quantity` (integer, required)
    Damaged quantity of this item (after shipment is received)

  - `restocking_shipment_items.missing_quantity` (integer, required)
    Missing quantity of this item (after shipment is received)

  - `restocking_shipment_items.remarks` (string,null)
    Free text for remarks

  - `restocking_shipment_items.sku_code` (string, required)
    The merchant's SKU identifier - required if sku_id is not provided

  - `restocking_shipment_items.sku_id` (integer, required)
    Hive SKU identifier - required if sku_code is not provided

  - `restocking_shipment_items.total_cost_in_cents` (integer,null)
    Cost in cents

  - `status` (string, required)
    Restocking shipment status. Possible values:
  - arrived: Hive completed the arrival documentation, checked packing slip, picture of shipment and documents are uploaded
  - cancelled: the restocking shipment is cancelled by merchant
  - created: the restocking shipment is created and not yet shipped
  - processing: the restocking shipment is getting unpacked and its items are getting restocked into storage boxes and pallets
  - received: the restocking shipment is delivered to the fulfillment center, but its content is not verified yet
  - restocked: the restocking shipment is fully processed in the fulfillment center and its items are completely restocked
  - shipped: initial status meaning that restocking shipment is on the way
    Enum: "arrived", "cancelled", "created", "processing", "received", "restocked", "shipped"

  - `supplier_name` (string,null)
    Supplier name

  - `tracking_code` (string,null)
    Shipment tracking code

  - `updated_at` (string)
    When the shipment was last updated

  - `warehouse_id` (integer, required)
    The ID of the Hive destination warehouse

## Response 400 fields (application/json):

  - `errors` (any, required)
    Error information. Can be:
- Object with field names as keys and error arrays as values (for validation errors)
- Array of error objects with message, code, and optional metadata
- Array of strings (for simple error messages)

  - `success` (boolean)
    Indicates if the request was successful

  - `title` (string)
    A brief, human-readable message about the error

  - `status` (integer)
    HTTP status code

## Response 401 fields (application/json):

  - `errors` (any, required)
    Error information. Can be:
- Object with field names as keys and error arrays as values (for validation errors)
- Array of error objects with message, code, and optional metadata
- Array of strings (for simple error messages)

  - `success` (boolean)
    Indicates if the request was successful

  - `title` (string)
    A brief, human-readable message about the error

  - `status` (integer)
    HTTP status code

## Response 403 fields (application/json):

  - `errors` (any, required)
    Error information. Can be:
- Object with field names as keys and error arrays as values (for validation errors)
- Array of error objects with message, code, and optional metadata
- Array of strings (for simple error messages)

  - `success` (boolean)
    Indicates if the request was successful

  - `title` (string)
    A brief, human-readable message about the error

  - `status` (integer)
    HTTP status code

## Response 404 fields (application/json):

  - `errors` (any, required)
    Error information. Can be:
- Object with field names as keys and error arrays as values (for validation errors)
- Array of error objects with message, code, and optional metadata
- Array of strings (for simple error messages)

  - `success` (boolean)
    Indicates if the request was successful

  - `title` (string)
    A brief, human-readable message about the error

  - `status` (integer)
    HTTP status code

## Response 422 fields (application/json):

  - `errors` (any, required)
    Error information. Can be:
- Object with field names as keys and error arrays as values (for validation errors)
- Array of error objects with message, code, and optional metadata
- Array of strings (for simple error messages)

  - `success` (boolean)
    Indicates if the request was successful

  - `title` (string)
    A brief, human-readable message about the error

  - `status` (integer)
    HTTP status code

## Response 429 fields (application/json):

  - `errors` (any, required)
    Error information. Can be:
- Object with field names as keys and error arrays as values (for validation errors)
- Array of error objects with message, code, and optional metadata
- Array of strings (for simple error messages)

  - `success` (boolean)
    Indicates if the request was successful

  - `title` (string)
    A brief, human-readable message about the error

  - `status` (integer)
    HTTP status code