创建海外仓包裹

通过此接口，您可以创建海外仓包裹，以提供给我司拣货出库的指令。

请求规格说明

请求方式

POST api/packages

请求数据格式

完整请求数据格式说明
名称	类型	是否必须	描述	示例值
WarehouseCode	string	必须	我司海外仓库代码	BM
ReferenceId	string	必须	客单号，此单号在我司系统内，您只能有一条对应的记录若此单号已经存在，则会报错误代码为 `0x104004` 的错误当单号已经存在时，你可以选择使用新单号来创建，或者如果之前的单未确认交运的话，也可以通过调用删除未交运包裹接口将之前的单删除，而后再通过创建包裹接口重试。
SellingPlatformOrder	SellingPlatformOrder		销售平台订单信息
Shipper	Shipper		发件人
ShipppingProductId	string	必须	发货方式，请参考我司提供的报价表上的发货方式代码
ShippingAddress	Address	必须	收件人地址
Items	PackageItemsCreateRequest	必须	包裹内SKU明细
AutoConfirm	boolean	必须	是否自动确认交运。如你在创建时，包裹内明细以及地址信息均已确认OK，则可以将此值设置为`true` 否则您需要后续调用确认交运接口对包裹进行确认交运	false

Shipper 发件人
名称	类型	是否必须	描述	示例值
VatNo	string		发件人的 VatNo	SKU

PackageItemsCreateRequest 包裹内SKU明细说明
名称	类型	是否必须	描述	示例值
ItemIdType	string	必须	SKU明细中值的类型，您可以选择以下任意一种值类型 SKU: SKU StockUnitId: SKU在我司系统对应的库存编码	SKU
Items	PackageItemCreateRequest[]		SKU 列表

PackageItemCreateRequest 包裹内单件SKU格式说明
名称	类型	是否必须	描述	示例值
ItemId	string	必须	SKU或者我司库存编码
Quantity	int	必须	数量

示例请求

{
  "WarehouseCode": "BM",
  "ReferenceId": "REF160808003",
  "SellingPlatformOrder": null,
  "Shipper": null,
  "ShipppingProductId": "UKWHS_TEST",
  "ShippingAddress": {
    "Company": null,
    "Street1": "Baker Street 221B",
    "Street2": null,
    "Street3": null,
    "District": null,
    "City": "London",
    "Province": null,
    "Country": null,
    "CountryCode": "GB",
    "Postcode": "NW1 6XE",
    "Contacter": "Sherlock Holmes",
    "Tel": "07404200000",
    "Email": null,
    "TaxId": null
  },
  "Items": {
    "ItemIdType": "SKU",
    "Items": [{
      "ItemId": "ODM0003",
      "Quantity": 1
    }, {
      "ItemId": "ODM0004",
      "Quantity": 2
    }]
  },
  "AutoConfirm": false
}

返回数据格式说明

名称	类型	描述
ProcessCode	string	包裹在我司的处理号，唯一内部单号
IndexNumber	string	检索号
ReferenceId	string	客单号
TrackingNumber	string	跟踪号只有在确认交运后，我司系统才会对包裹的跟踪号进行分配并非所有发货方式都能在确认交运后立即获得跟踪号，您需要通过调用按处理号查找包裹接口或者搜索包裹接口来获取跟踪号分配信息
Status	string	包裹状态若选择了自动确认交运，此值为 Confirmed, 否则为 Draft

返回数据示例

{
  "Data": {
    "ProcessCode": "DEVGNA0000000134YQ",
    "IndexNumber": "93390000000134",
    "ReferenceId": "REF160808004",
    "TrackingNumber": "",
    "Status": "Draft"
  },
  "Succeeded": true,
  "Error": null
}

←返回海外仓对接文档首页