Skip to content

Get a restocking shipment

Request

Returns one of the merchant's restocking shipments.

Security
BearerAuth
Path
idinteger, (int64)required

The Hive ID of the restocking shipment.

curl -i -X GET \
  'https://hive-merchant-api.redocly.app/_mock/merchant-api-v1/mapi_v1_oas31/restocking_shipments/{id}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

The restocking shipment

Bodyapplication/json
barcodestringread-onlyrequired

The barcode that identifies the restocking shipment at the warehouse.

delivery_optionstringrequired

How the shipment is delivered to the warehouse.

Enum:"postal""courier""dropoff""hive_freight"
estimated_arrival_datestring or null, (date)required

The estimated arrival date.

idinteger, (int64)read-onlyrequired

Hive's unique identifier for the restocking shipment.

merchant_idinteger, (int64)read-onlyrequired

Hive's ID of the merchant the restocking shipment belongs to.

po_numberstring or nullrequired

Purchase order number.

restocking_shipment_itemsArray of objects(RestockingShipmentItem)required

The items in the shipment.

statusstringread-onlyrequired

The restocking shipment status:

  • created: created and not shipped yet.
  • shipped: on the way to the warehouse. Restocking shipments created through the API start here.
  • delivered: delivered to the warehouse, but its content is not checked yet.
  • arrived: Hive completed the arrival documentation: the packing slip is checked, and pictures of the shipment and its documents are uploaded.
  • processing: being unpacked, its items are being put into storage.
  • restocked: fully processed, all its items are in storage.
  • on_hold: processing is on hold.
  • cancelled: cancelled.
Enum:"created""shipped""delivered""arrived""processing""restocked""on_hold""cancelled"
supplier_namestring or nullrequired

Supplier name.

tracking_codestring or nullrequired

The shipment's tracking code.

warehouse_idinteger, (int64)required

Hive's ID of the destination warehouse.

Response
{
  "id": 13,
  "merchant_id": 1,
  "warehouse_id": 71,
  "estimated_arrival_date": "2022-12-01",
  "delivery_option": "postal",
  "tracking_code": "1234567",
  "po_number": null,
  "supplier_name": null,
  "status": "restocked",
  "barcode": "RS.13",
  "restocking_shipment_items": [
    { … }
  ]
}