文档中心 > API类目 > 淘宝物流API

qimen.taobao.logistics.tms.portdeparture.transportorder.create (港到仓作业单创建)

淘天下发港到仓作业单给港到仓服务商

公共参数

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
request	Request	可选			请求
└ ownerCode String 必须 AX766232 货主编码 └ resourceCode String 必须 STA 港到仓资源编码 └ orderCode String 必须 YS776762 港到仓作业单号 └ orderType String 必须 TOB_PORT_TO_WAREHOUSE 港到仓作业单单据类型 relatedOrders RelatedOrder [] 可选关联单据信息（如清关作业单号） └ orderCode String 可选 QG8877623 关联的单据编号 └ orderType String 可选 TOB_CLEARANCE 关联的单据类型(TOB_CLEARANCE=清关作业单) └ extendProps Map 可选扩展属性 basicInfo BasicInfo 可选基础信息 └ fromRegion String 可选美国起运国/地区（使用中文文描） └ fromLocation String 可选西雅图起运港（始发机场）（使用中文文描） └ fromCustomsArea String 可选西雅图起运仓关区（使用中文文描） └ fromWarehouse String 可选仓A 起运仓（使用中文文描） └ toRegion String 可选中国目的国/地区（使用中文文描） └ toLocation String 可选上海目的港（到达机场）（使用中文文描） └ toCustomsArea String 可选上海吴淞目的仓关区（使用中文文描） └ toWarehouse String 可选仓01 目的仓（使用中文文描） └ extendProps Map 可选扩展属性 transportInfo TransportInfo 可选港到仓运输信息 └ entryPort String 可选上海吴淞进境口岸（使用中文文描） └ loadingTypePortToWH String 可选 FTL 港到仓运输方式(FTL-整车) shipperInfo ShipperInfo 可选发货人（发货人将展示在提单上） └ name String 可选张三姓名 └ companyName String 可选富勒斯公司公司名称 └ phone String 可选 58867727 电话 └ email String 可选 a@demo.com 邮箱 └ country String 可选中国国家（使用中文文描） └ province String 可选浙江省省（使用中文文描） └ city String 可选杭州市市（使用中文文描） └ area String 可选余杭区区（使用中文文描） └ address String 可选永寿街9号详细地址 └ zipCode String 可选 100086 邮编 └ socialCreditCode String 可选 90822X1092 统一社会信用代码 └ extendProps Map 可选扩展属性 consigneeInfo ConsigneeInfo 可选收货人（收货人将展示在提单上） └ name String 可选孙七姓名 └ companyName String 可选拉威尔公司公司名称 └ phone String 可选 58867727 电话 └ email String 可选 a@demo.com 邮箱 └ country String 可选中国国家（使用中文文描） └ province String 可选浙江省省（使用中文文描） └ city String 可选杭州市市（使用中文文描） └ area String 可选余杭区区（使用中文文描） └ address String 可选永寿街9号详细地址 └ socialCreditCode String 可选 90822X1093 统一社会信用代码 └ zipCode String 可选 100086 邮编 └ extendProps Map 可选扩展属性 notifyPersonInfo NotifyPersonInfo 可选通知人（通知人将展示在提单上） └ name String 可选王五姓名 └ companyName String 可选 true 瓦格纳公司公司名称 └ phone String 可选 58867727 电话 └ email String 可选 a@demo.com 邮箱 └ country String 可选中国国家（使用中文文描） └ province String 可选浙江省省（使用中文文描） └ city String 可选杭州市市（使用中文文描） └ area String 可选余杭区区（使用中文文描） └ address String 可选永寿街9号详细地址 └ zipCode String 可选 100086 邮编 └ socialCreditCode String 可选 90822X1092 统一社会信用代码 └ extendProps Map 可选扩展属性 bookingPartyInfo BookingPartyInfo 可选商家联系人信息（物流状态和费用确认通知会发送到商家联系人邮箱，可支持填入多个邮箱） └ name String 可选赵六姓名 └ phone String 可选 58867727 电话 └ emails String [] 可选 zhaoliu@b.com 邮箱清单 └ extendProps Map 可选扩展属性 supplierInfo SupplierInfo 可选供应商 └ name String 可选孙七姓名 └ companyName String 可选拉威尔公司公司名称 └ phone String 可选 58867727 电话 └ email String 可选 a@demo.com 邮箱 └ country String 可选中国国家（使用中文文描） └ province String 可选浙江省省（使用中文文描） └ city String 可选杭州市市（使用中文文描） └ area String 可选余杭区区（使用中文文描） └ address String 可选永寿街9号详细地址 └ zipCode String 可选 100086 邮编 └ socialCreditCode String 可选 90822X1092 统一社会信用代码 └ extendProps Map 可选扩展属性 packageInfo PackageInfo 可选装箱信息 └ totalVolume String 可选 1 总体积（立方米） └ totalWeight String 可选 2 总重量（KG） packageInfoItems PackageInfoItem [] 可选包装明细 └ packageType String 可选 1 包装单位（1=托盘、2=装箱） └ qty Number 可选 1 数量 └ width String 可选 200 长度（厘米） └ length String 可选 200 宽度（厘米） └ height String 可选 100 高度（厘米） └ overlayTray String 可选 0 是否叠托（1=是、0=否） └ trayType String 可选 1 托盘材质（1=塑料、2=木质（IPPC）、3=木质（无IPPC）、4=纸质） └ extendProps Map 可选扩展属性 └ extendProps Map 可选扩展属性 loadInfo LoadInfo 可选装箱信息 └ extendProps Map 可选扩展属性 └ productType String 可选 NORMAL 货品类型（NORMAL=普通品、DANGER=危险品、TEMPERATURE=温控品） └ productDesc String 可选 lipstick 货品描述（请填写英文品名，如lipstick, paper diaper…） └ loadingType String 可选 FCL 装箱方式（FCL=整箱、LCL=拼箱） └ temperature String 可选 -5 商品温度要求（℃） containerTypes ContainerType [] 可选柜型与数量 └ containerType String 可选 20GP 柜型（20GP、40GP、40HQ、20RF、40RF） └ qty Number 可选 20 数量 └ extendProps Map 可选扩展属性 carrierInfo CarrierInfo 可选头程承运信息 └ mblNo String 可选 BOL112 主提单号 └ transportMode String 可选 OCEAN 运输方式（AIR=空运、OCEAN=海运、RAILWAY=铁路、TRUCK=陆运） └ hblNo String 可选 BOL112-1 分提单号 └ carrierName String 可选 ABC 承运商 └ shippingName String 可选通达船名 └ flightNo String 可选 101 航次 └ flightDate String 可选 2023-12-16 航班日期（YYYY-DD-MM） └ expectArrivePortDate String 可选 2023-12-16 期望到港时间（YYYY-MM-DD） └ containerCodes String [] 可选集装箱编号 └ extendProps Map 可选扩展属性 items Item [] 必须商品明细 └ itemCode String 必须 752877229 商品编码 └ itemName String 可选唇膏商品名称 └ qty Number 必须 20 数量 └ originRegion String 可选 US 原产国编码 └ purchasePrice String 可选 6.77 采购单价 └ currency String 可选 USD 币种 └ totalPrice String 可选 135.4 总价 └ volume String 可选 0.5 合计体积 (立方米） └ weight String 可选 0.5 合计重量 (kg） └ produceCode String 可选 EX123 生产批号 └ productDate String 可选 2023-03-06 生产日期（YYYY-MM-DD） └ expiryDate String 可选 2026-03-05 失效日期（YYYY-MM-DD） └ extendProps Map 可选扩展属性 packagingItems PackagingItem [] 可选装箱明细 └ itemCode String 可选 752877229 商品编码 └ itemQuantity Number 可选 20 商品数量 └ palletNo String 可选 P01 托盘编号 └ boxNo String 可选 B01 B01 箱号 └ packagingItemLineNo String 可选 LI0010 装箱明细行号 └ extendProps Map 可选扩展属性 attachments Attachment [] 可选港到仓文件清单 └ url String 可选 https://a.demo.com/a.xlsx URL，有效期：1年 └ name String 可选提单文件文件名称 └ attachmentType String 可选 BOL 文件类型（MSDS=MSDS文件、BOL=提单文件） └ fileType String 可选 pdf 文件类型 └ extendProps Map 可选扩展属性 └ extendProps Map 可选扩展属性

响应参数

名称	类型	示例值	描述
response	Response		返回
└ success Boolean false 是否成功，true-成功; false-失败 └ biz_error_code String E0001 错误编码 └ biz_error_msg String invalid app key 错误描述 └ retry Boolean false 是否可重试 true-可重试 └ outerOrderCode String EXT11234 服务商系统的港到仓作业单号

请求示例

{"request":{"orderType":"TOB_PORT_TO_WAREHOUSE","notifyPersonInfo":{"area":"余杭区","country":"中国","zipCode":"100086","address":"永寿街9号","province":"浙江省","phone":"58867727","city":"杭州市","companyName":"true\t瓦格纳公司","name":"王五","extendProps":"","socialCreditCode":"90822X1092","email":"a@demo.com"},"transportInfo":{"loadingTypePortToWH":"FTL","entryPort":"上海吴淞"},"attachments":[{"attachmentType":"BOL","name":"提单文件","extendProps":"","url":"https://a.demo.com/a.xlsx","fileType":"pdf"}],"ownerCode":"AX766232","packagingItems":[{"itemQuantity":20,"boxNo":"B01","packagingItemLineNo":"LI0010","itemCode":"752877229","extendProps":"","palletNo":"P01"}],"loadInfo":{"productDesc":"lipstick","temperature":"-5","extendProps":"","loadingType":"FCL","productType":"NORMAL","containerTypes":[{"containerType":"20GP","qty":20,"extendProps":""}]},"shipperInfo":{"area":"余杭区","country":"中国","zipCode":"100086","address":"永寿街9号","province":"浙江省","phone":"58867727","city":"杭州市","companyName":"富勒斯公司","name":"张三","extendProps":"","socialCreditCode":"90822X1092","email":"a@demo.com"},"basicInfo":{"toWarehouse":"仓01","toRegion":"中国","fromCustomsArea":"西雅图","fromWarehouse":"仓A","extendProps":"","fromLocation":"西雅图","toCustomsArea":"上海吴淞","fromRegion":"美国","toLocation":"上海"},"supplierInfo":{"area":"余杭区","country":"中国","zipCode":"100086","address":"永寿街9号","province":"浙江省","phone":"58867727","city":"杭州市","companyName":"拉威尔公司","name":"孙七","extendProps":"","socialCreditCode":"90822X1092","email":"a@demo.com"},"carrierInfo":{"expectArrivePortDate":"2023-12-16","flightNo":"101","hblNo":"BOL112-1","carrierName":"ABC","shippingName":"通达","flightDate":"2023-12-16","mblNo":"BOL112","containerCodes":[""],"transportMode":"OCEAN","extendProps":""},"resourceCode":"STA","bookingPartyInfo":{"emails":["zhaoliu@b.com"],"phone":"58867727","name":"赵六","extendProps":""},"consigneeInfo":{"area":"余杭区","country":"中国","zipCode":"100086","address":"永寿街9号","province":"浙江省","phone":"58867727","city":"杭州市","companyName":"拉威尔公司","name":"孙七","extendProps":"","socialCreditCode":"90822X1093","email":"a@demo.com"},"extendProps":"","orderCode":"YS776762","relatedOrders":[{"orderType":"TOB_CLEARANCE","extendProps":"","orderCode":"QG8877623"}],"packageInfo":{"totalVolume":"1","packageInfoItems":[{"trayType":"1","qty":1,"overlayTray":"0","width":"200","length":"200","extendProps":"","packageType":"1","height":"100"}],"totalWeight":"2","extendProps":""},"items":[{"totalPrice":"135.4","originRegion":"US","itemCode":"752877229","weight":"0.5","purchasePrice":"6.77","productDate":"2023-03-06","volume":"0.5","expiryDate":"2026-03-05","produceCode":"EX123","itemName":"唇膏","qty":20,"extendProps":"","currency":"USD"}]}}

响应示例

{
    "response":{
        "success":false,
        "biz_error_code":"E0001",
        "biz_error_msg":"invalid app key",
        "retry":false,
        "outerOrderCode":"EXT11234"
    }
}

验签示例

{"response":{"biz_error_msg":"Illegal request","success":"不等于true","biz_error_code":"sign-check-failure"}}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

淘宝物流API

qimen.taobao.logistics.tms.portdeparture.transportorder.create (港到仓作业单创建)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ