tinywms.shipping-orders.create

新建订舱单

• 请求路由: tinywms.shipping-orders.create
• 交互模型: Request Response
• 访问限制: 无

请求

RSocket.rr({
  "route" : "tinywms.shipping-orders.create",
  "data" : {
    "bookingNo" : "SO12345678",
    "blNo" : "COSU1234567890",
    "carrier" : {
      "code" : "COSCO",
      "name" : "China Ocean Shipping Company"
    },
    "vessel" : "COSCO SHIPPING TAURUS",
    "voyage" : "023W",
    "serviceType" : "CY-CY",
    "shipper" : {
      "name" : "Shanghai Trading Co., Ltd.",
      "address" : "No. 123, Zhongshan Road",
      "contact" : "Mr. Zhang",
      "phone" : "+86-21-12345678"
    },
    "consignee" : {
      "name" : "Hamburg Import GmbH",
      "address" : "Hafenstrasse 1",
      "taxId" : "DE123456789"
    },
    "notifyParty" : {
      "name" : "Hamburg Logistics Service",
      "address" : "Logistics Park"
    },
    "pol" : {
      "code" : "CNSHA",
      "name" : "Shanghai",
      "etd" : "2023-11-01T10:00:00Z"
    },
    "pod" : {
      "code" : "DEHAM",
      "name" : "Hamburg",
      "eta" : "2023-12-05T14:00:00Z"
    },
    "containers" : [
      {
        "containerNo" : "CSNU1234567",
        "sealNo" : "123456",
        "type" : "40HQ",
        "pieceCount" : 500,
        "packageType" : "CARTONS",
        "grossWeight" : 18500.0,
        "measurement" : 65.5,
        "marks" : "N/M",
        "goodsDescription" : "LED LIGHTS"
      }
    ],
    "freightTerm" : "PREPAID",
    "charges" : [
      {
        "code" : "OFR",
        "currency" : "USD",
        "amount" : 2500.0,
        "paymentMode" : "PREPAID"
      }
    ],
    "status" : "CONFIRMED",
    "releaseDate" : "2023-10-25T09:00:00Z",
    "cutoffTime" : "2023-10-31T18:00:00Z",
    "remarks" : "Temperature control required: +5C"
  }
});

请求参数

名称	类型	必须	说明
shippingOrderId	String	否	订舱单系统ID
bookingNo	String	是	订舱号
entrustNo	String	否	委托单号
sellerInfo	Object	否	卖方
sellerInfo.unitId	String	否	往来单位id
sellerInfo.country	String	否	国家
sellerInfo.unitName	String	否	往来单位名称（中文）
sellerInfo.unitNameEn	String	否	往来单位名称（英文）
sellerInfo.unitAbbreviation	String	否	往来单位缩写
sellerInfo.unitAddress	String	否	往来单位地址（中文）
sellerInfo.unitAddressEn	String	否	往来单位地址（英文）
sellerInfo.contactPerson	Object	否	联系人信息
sellerInfo.contactPerson.username	String	否	用户标识
sellerInfo.contactPerson.name	String	否	用户名称
sellerInfo.contactPerson.mobile	String	否	用户手机号
sellerInfo.extraProps	Object	否	扩展信息
blNo	String	否	提单号
pickupAddress	String	否	提柜地址
dropOffAddress	String	否	还柜地址
customerInfo	Object	否	客户信息
customerInfo.unitId	String	否	往来单位id
customerInfo.country	String	否	国家
customerInfo.unitName	String	否	往来单位名称（中文）
customerInfo.unitNameEn	String	否	往来单位名称（英文）
customerInfo.unitAbbreviation	String	否	往来单位缩写
customerInfo.unitAddress	String	否	往来单位地址（中文）
customerInfo.unitAddressEn	String	否	往来单位地址（英文）
customerInfo.contactPerson	Object	否	联系人信息
customerInfo.contactPerson.username	String	否	用户标识
customerInfo.contactPerson.name	String	否	用户名称
customerInfo.contactPerson.mobile	String	否	用户手机号
customerInfo.extraProps	Object	否	扩展信息
carrier	Object	否	船公司信息
carrier.code	String	否	船公司代码
carrier.name	String	否	船公司名称
vessel	String	否	船名
voyage	String	否	航次
status	String	否	订舱状态 BOOKED - 已订舱待委派 ASSIGNING - 已订舱委派中 CONFIRMED - 已全部委派 COMPLETED - 所有任务已完成 CANCELLED - 已取消
shippingStatus	String	否	运输状态（同步自集装箱的 WMS 状态） LOADING - 装柜中 IN_TRANSIT - 运输中 ARRIVED - 到达目的港 LADEN_PICKED - 重箱提柜 EMPTY_RETURNED - 空箱还柜
releaseDate	String	否	放箱时间
cutoffTime	String	否	截关时间
pol	Object	否	起运港
pol.code	String	否	港口/地点代码。
pol.name	String	否	港口/地点名称。
pol.eta	String	否	预计到港时间（仅卸港用）
pol.etd	String	否	预计离港时间（仅装港用）
pod	Object	否	目的港
pod.code	String	否	港口/地点代码。
pod.name	String	否	港口/地点名称。
pod.eta	String	否	预计到港时间（仅卸港用）
pod.etd	String	否	预计离港时间（仅装港用）
consignee	String	否	收货人
targetWarehouse	Object	否	目标仓库
targetWarehouse.unitId	String	否	往来单位id
targetWarehouse.country	String	否	国家
targetWarehouse.unitName	String	否	往来单位名称（中文）
targetWarehouse.unitNameEn	String	否	往来单位名称（英文）
targetWarehouse.unitAbbreviation	String	否	往来单位缩写
targetWarehouse.unitAddress	String	否	往来单位地址（中文）
targetWarehouse.unitAddressEn	String	否	往来单位地址（英文）
targetWarehouse.contactPerson	Object	否	联系人信息
targetWarehouse.contactPerson.username	String	否	用户标识
targetWarehouse.contactPerson.name	String	否	用户名称
targetWarehouse.contactPerson.mobile	String	否	用户手机号
targetWarehouse.extraProps	Object	否	扩展信息
remarks	String	否	备注
containerLists	Object[]	否	集装箱清单
containerLists.[].type	String	否	集装箱类型(字典-container)
containerLists.[].name	String	否	集装箱类型名称
containerLists.[].count	Number	否	集装箱数量
containers	Object[]	否
containers.[].taskId	String	否	任务id
containers.[].containerNo	String	否	集装箱号
containers.[].driverInfo	Object	否	司机信息
containers.[].driverInfo.idNumber	String	否	身份证号
containers.[].driverInfo.licensePlate	Object	否	车牌信息
containers.[].driverInfo.licensePlate.mainland	String	否	大陆车牌号
containers.[].driverInfo.licensePlate.hk	String	否	香港车牌号
containers.[].driverInfo.licensePlate.macao	String	否	澳门车牌号
containers.[].driverInfo.licensePlate.trailerPlate	String	否	挂车号
containers.[].driverInfo.username	String	否	司机标识
containers.[].driverInfo.name	String	否	司机名称
containers.[].driverInfo.mobile	String	否	司机手机号
containers.[].sealNo	String	否	封签号
containers.[].containerType	String	否	集装箱类型
containers.[].containerName	String	否	集装箱名称
containers.[].tareWeightKGS	Number	否	柜重(公斤)
containers.[].tareWeightLBS	Number	否	柜重(磅)
containers.[].pieceCount	Number	否	件数
containers.[].packageType	String	否	包装单位
containers.[].marks	String	否	唛头
containers.[].goodsDescription	String	否	货物描述
containers.[].pickUpTime	String	否	提柜时间
containers.[].surcharges	Object[]	否	附加费列表
containers.[].surcharges.[].surchargeId	String	否	附加费id(字典id)
containers.[].surcharges.[].surchargeName	String	否	附加费名称(字典名称)
containers.[].surcharges.[].auditStatus	String	否	审核状态 PENDING_REVIEW - 待审核 APPROVED - 已审核 REJECTED - 退回
containers.[].surcharges.[].attachment	Object	否	附件信息
containers.[].surcharges.[].attachment.title	String	否	附件标题
containers.[].surcharges.[].attachment.description	String	否	附件说明
containers.[].surcharges.[].attachment.binaryId	String[]	否	附件id
containers.[].attachments	Object[]	否
containers.[].attachments.[].title	String	否	附件标题
containers.[].attachments.[].description	String	否	附件说明
containers.[].attachments.[].binaryId	String[]	否	附件id
attachments	Object[]	否	附件列表
attachments.[].title	String	否	附件标题
attachments.[].description	String	否	附件说明
attachments.[].binaryId	String[]	否	附件id
notifiedWmsStatuses	String[]	否	已通知过的wms状态 LOADING - 装柜中 IN_TRANSIT - 运输中 ARRIVED - 到达目的港 LADEN_PICKED - 重箱提柜 EMPTY_RETURNED - 空箱还柜
legalEntityId	String	否	法人主体id
customerId	String	否	客户id
extraProps	Object	否	扩展属性
crBy	String	否	创建者
upBy	String	否	最后修改者
crDate	String	否	创建时间
upDate	String	否	最后修改时间
tenantId	String	否	租户ID
id	Varies	否

返回

创建后的订舱单

{
  "bookingNo" : "SO12345678",
  "status" : "BOOKED"
}

返回属性

名称	类型	说明
shippingOrderId	String	订舱单系统ID
bookingNo	String	订舱号
entrustNo	String	委托单号
sellerInfo	Object	卖方
sellerInfo.unitId	String	往来单位id
sellerInfo.country	String	国家
sellerInfo.unitName	String	往来单位名称（中文）
sellerInfo.unitNameEn	String	往来单位名称（英文）
sellerInfo.unitAbbreviation	String	往来单位缩写
sellerInfo.unitAddress	String	往来单位地址（中文）
sellerInfo.unitAddressEn	String	往来单位地址（英文）
sellerInfo.contactPerson	Object	联系人信息
sellerInfo.contactPerson.username	String	用户标识
sellerInfo.contactPerson.name	String	用户名称
sellerInfo.contactPerson.mobile	String	用户手机号
sellerInfo.extraProps	Object	扩展信息
blNo	String	提单号
pickupAddress	String	提柜地址
dropOffAddress	String	还柜地址
customerInfo	Object	客户信息
customerInfo.unitId	String	往来单位id
customerInfo.country	String	国家
customerInfo.unitName	String	往来单位名称（中文）
customerInfo.unitNameEn	String	往来单位名称（英文）
customerInfo.unitAbbreviation	String	往来单位缩写
customerInfo.unitAddress	String	往来单位地址（中文）
customerInfo.unitAddressEn	String	往来单位地址（英文）
customerInfo.contactPerson	Object	联系人信息
customerInfo.contactPerson.username	String	用户标识
customerInfo.contactPerson.name	String	用户名称
customerInfo.contactPerson.mobile	String	用户手机号
customerInfo.extraProps	Object	扩展信息
carrier	Object	船公司信息
carrier.code	String	船公司代码
carrier.name	String	船公司名称
vessel	String	船名
voyage	String	航次
status	String	订舱状态 BOOKED - 已订舱待委派 ASSIGNING - 已订舱委派中 CONFIRMED - 已全部委派 COMPLETED - 所有任务已完成 CANCELLED - 已取消
shippingStatus	String	运输状态（同步自集装箱的 WMS 状态） LOADING - 装柜中 IN_TRANSIT - 运输中 ARRIVED - 到达目的港 LADEN_PICKED - 重箱提柜 EMPTY_RETURNED - 空箱还柜
releaseDate	String	放箱时间
cutoffTime	String	截关时间
pol	Object	起运港
pol.code	String	港口/地点代码。
pol.name	String	港口/地点名称。
pol.eta	String	预计到港时间（仅卸港用）
pol.etd	String	预计离港时间（仅装港用）
pod	Object	目的港
pod.code	String	港口/地点代码。
pod.name	String	港口/地点名称。
pod.eta	String	预计到港时间（仅卸港用）
pod.etd	String	预计离港时间（仅装港用）
consignee	String	收货人
targetWarehouse	Object	目标仓库
targetWarehouse.unitId	String	往来单位id
targetWarehouse.country	String	国家
targetWarehouse.unitName	String	往来单位名称（中文）
targetWarehouse.unitNameEn	String	往来单位名称（英文）
targetWarehouse.unitAbbreviation	String	往来单位缩写
targetWarehouse.unitAddress	String	往来单位地址（中文）
targetWarehouse.unitAddressEn	String	往来单位地址（英文）
targetWarehouse.contactPerson	Object	联系人信息
targetWarehouse.contactPerson.username	String	用户标识
targetWarehouse.contactPerson.name	String	用户名称
targetWarehouse.contactPerson.mobile	String	用户手机号
targetWarehouse.extraProps	Object	扩展信息
remarks	String	备注
containerLists	Object[]	集装箱清单
containerLists.[].type	String	集装箱类型(字典-container)
containerLists.[].name	String	集装箱类型名称
containerLists.[].count	Number	集装箱数量
containers	Object[]
containers.[].taskId	String	任务id
containers.[].containerNo	String	集装箱号
containers.[].driverInfo	Object	司机信息
containers.[].driverInfo.idNumber	String	身份证号
containers.[].driverInfo.licensePlate	Object	车牌信息
containers.[].driverInfo.licensePlate.mainland	String	大陆车牌号
containers.[].driverInfo.licensePlate.hk	String	香港车牌号
containers.[].driverInfo.licensePlate.macao	String	澳门车牌号
containers.[].driverInfo.licensePlate.trailerPlate	String	挂车号
containers.[].driverInfo.username	String	司机标识
containers.[].driverInfo.name	String	司机名称
containers.[].driverInfo.mobile	String	司机手机号
containers.[].sealNo	String	封签号
containers.[].containerType	String	集装箱类型
containers.[].containerName	String	集装箱名称
containers.[].tareWeightKGS	Number	柜重(公斤)
containers.[].tareWeightLBS	Number	柜重(磅)
containers.[].pieceCount	Number	件数
containers.[].packageType	String	包装单位
containers.[].marks	String	唛头
containers.[].goodsDescription	String	货物描述
containers.[].pickUpTime	String	提柜时间
containers.[].surcharges	Object[]	附加费列表
containers.[].surcharges.[].surchargeId	String	附加费id(字典id)
containers.[].surcharges.[].surchargeName	String	附加费名称(字典名称)
containers.[].surcharges.[].auditStatus	String	审核状态 PENDING_REVIEW - 待审核 APPROVED - 已审核 REJECTED - 退回
containers.[].surcharges.[].attachment	Object	附件信息
containers.[].surcharges.[].attachment.title	String	附件标题
containers.[].surcharges.[].attachment.description	String	附件说明
containers.[].surcharges.[].attachment.binaryId	String[]	附件id
containers.[].attachments	Object[]
containers.[].attachments.[].title	String	附件标题
containers.[].attachments.[].description	String	附件说明
containers.[].attachments.[].binaryId	String[]	附件id
attachments	Object[]	附件列表
attachments.[].title	String	附件标题
attachments.[].description	String	附件说明
attachments.[].binaryId	String[]	附件id
notifiedWmsStatuses	String[]	已通知过的wms状态 LOADING - 装柜中 IN_TRANSIT - 运输中 ARRIVED - 到达目的港 LADEN_PICKED - 重箱提柜 EMPTY_RETURNED - 空箱还柜
legalEntityId	String	法人主体id
customerId	String	客户id
extraProps	Object	扩展属性
crBy	String	创建者
upBy	String	最后修改者
crDate	String	创建时间
upDate	String	最后修改时间
tenantId	String	租户ID
id	Varies

下载结果模型定义