跳转到主要内容
POST
/
client
/
shipments
/
create
Create a shipment
curl --request POST \
  --url https://api.ship.uniuni.com/prod/client/shipments/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "recipient": {
    "name": "Jane Doe",
    "phone": "+1-604-123-4567",
    "email": "jane@example.com",
    "signature": false
  },
  "address": {
    "address1": "3460 Cawthra Road",
    "city": "Mississauga",
    "province": "ON",
    "postalCode": "L5A 2Y1",
    "country": "CA"
  },
  "dimensions": {
    "length": 1,
    "width": 1,
    "height": 1,
    "dimensionUnit": "INCH"
  },
  "weight": {
    "value": 1,
    "weightUnit": "LB"
  },
  "postageType": "STANDARD",
  "note": "Gift Box",
  "shipmentLineItems": [
    {
      "description": "T-shirt",
      "quantity": 1,
      "unit_value": 10,
      "currency": "CAD"
    }
  ]
}
'
{
  "message": "Shipment created successfully",
  "code": 0,
  "data": {
    "orderNumber": "UNI031455E90",
    "trackingId": "UR07300000000005351",
    "recipient": {
      "name": "Jane Doe",
      "phone": "+1-604-123-4567",
      "email": "jane@example.com"
    },
    "address": {
      "address1": "2455 Meadowvale Blvd",
      "city": "Mississauga",
      "province": "ON",
      "postalCode": "L5N 0H1",
      "country": "CA"
    },
    "dimensions": {
      "length": 1,
      "width": 1,
      "height": 1,
      "dimensionUnit": "INCH"
    },
    "weight": {
      "value": 1,
      "weightUnit": "LB"
    },
    "status": "DRAFT",
    "note": "Gift Box",
    "createdAt": "2025-07-30T18:32:11.455Z",
    "updatedAt": "2025-07-30T18:32:11.899Z",
    "rates": {
      "postageType": "NEXT DAY",
      "postageFee": 4.88,
      "tax": 0.63,
      "total": 5.51,
      "currency": "CAD"
    },
    "shipmentLineItems": [
      {
        "description": "T-shirt",
        "quantity": 1,
        "unit_value": 10,
        "currency": "CAD"
      }
    ]
  }
}
购买货件并打印面单后，请访问ship.uniuni.com/locations确认您的投递点，或访问ship.uniuni.com/pickups申请上门取件服务（如可用）。
shipmentLineItems 为必填项。 每个货件必须包含至少一个物品（shipmentLineItems 数组需包含 >= 1 个元素）。省略该字段或发送空数组将返回 422 PayloadValidationError 错误。
跨境货件（加拿大 → 美国）：shipmentLineItems中的每个物品还必须包含hs_code、country_of_origin以及标识制造商的description。缺少此信息的货件可能会在边境被扣留。

授权

​
Authorization
string
header
必填

API access token generated from the UniUni Platform dashboard.

请求体

application/json
​
recipient
object
必填
​
address
object
必填
​
weight
object
必填
​
shipmentLineItems
object[]
必填

Line items describing the contents. Must contain at least one item.

Minimum array length: 1
​
dimensions
object

Package dimensions. Provide either dimensions or packagingId, not both.

​
packagingId
integer

ID of a pre-configured packaging profile. Use instead of dimensions if the package matches a saved profile.

​
postageType
enum<string>

Preferred postage type. Domestic shipments typically use SAME DAY, NEXT DAY, or STANDARD. Cross-border CA→US shipments use USPS Ground Advantage (DDP) or PostNL International Packet Tracked (DDU). If the requested type is unavailable, an available type is selected automatically.

可用选项:
PUBLICATION,
SAME DAY,
NEXT DAY,
STANDARD,
USPS Ground Advantage,
PostNL International Packet Tracked,
OTHER
​
note
string

Optional note, up to 200 characters.

Maximum string length: 200
​
insuranceRequired
boolean

Whether parcel protection (insurance) is required for this shipment.

​
orderNumber
string

Optional client-provided order reference.

响应

Shipment created or error returned

​
message
string
必填

Additional information about the request status.

​
code
integer
必填

Status code. 0 indicates success.

​
data
object