淘宝开放平台

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
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。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
purchase_order_code	String	可选	LBX002000101387001		采购单号当orderType=CGRK时，使用
warehouse_code	String	必须	WUZHOU-0001		仓库编码统仓统配等无需ERP指定仓储编码的情况填OTHER
operator_code	String	可选	1697680011		操作员编码
operator_name	String	可选	小二		操作员名称
operate_time	String	可选	2015-03-19 19:25:06		操作时间 YYYY-MM-DD HH:MM:SS
sender_info	SenderInfo	可选			发件人信息
└ sender_infocompany String 可选公司名称公司名称 └ sender_infoname String 可选姓名姓名 └ sender_infozip_code String 可选 332211 邮编 └ sender_infotel String 可选 332211 固定电话 └ sender_infomobile String 可选 332211 移动电话 └ sender_infoemail String 可选 rp@163.com 电子邮箱 └ sender_infocountry_code String 可选国家二字码国家二字码 └ sender_infoprovince String 可选浙江省省份 └ sender_infocity String 可选杭州市城市 └ sender_infoarea String 可选西湖区区域 └ sender_infotown String 可选村镇村镇 └ sender_infodetail_address String 可选详细地址详细地址
receiver_info	ReceiverInfo	可选			收件人信息
└ receiver_infocompany String 可选公司名称公司名称 └ receiver_infoname String 可选姓名姓名 └ receiver_infozip_code String 可选邮编邮编 └ receiver_infotel String 可选固定电话固定电话 └ receiver_infomobile String 可选移动电话移动电话 └ receiver_infoemail String 可选电子邮箱电子邮箱 └ receiver_infocountry_code String 可选国家二字码国家二字码 └ receiver_infoprovince String 可选省份省份 └ receiver_infocity String 可选城市城市 └ receiver_infoarea String 可选区域区域 └ receiver_infotown String 可选村镇村镇 └ receiver_infodetail_address String 可选详细地址详细地址
remark	String	可选	备注		备注
extend_props	String	可选	扩展属性		扩展属性
supplier_name	String	可选	天猫海外商家测试香港		供应商名称
supplier_code	String	可选	1697680011		供应商编码
express_code	String	可选	60002251724		运单号
logistics_name	String	可选	顺丰		物流公司名称
logistics_code	String	可选	SF		物流公司编码 SF=顺丰、EMS=标准快递、EYB=经济快件、ZJS=宅急送、YTO=圆通? 、ZTO=中通 (ZTO) 、HTKY=百世汇通、UC=优速、STO=申通、TTKDEX=天天快递? 、QFKD=全峰、FAST=快捷、POSTB=邮政小包? 、GTO=国通、YUNDA=韵达、JD=京东配送、DD=当当宅配、AMAZON=亚马逊物流、OTHER=其他(只传英文编码)
expect_end_time	String	可选	2012-07-29 12:05:09		最迟预期到货时间
expect_start_time	String	可选	2012-07-29 12:05:09		预期到货时间
related_orders	RelatedOrderInfo []	可选		最大列表长度：20	关联的订单
related_order RelatedOrderInfo 可选关联的订单 └ order_code String 可选 LBX002000101378001 关联的订单编号 └ order_type String 可选 CK 关联的订单类型，CG=采购单, CK=出库单，RK=入库单
order_type	String	必须	QTRK		业务类型 (CGRK=采购入库, QTRK=其他入库，B2BRK=B2B入库 (只传英文编码)
order_create_time	String	可选	LBX002000101387001		订单创建时间YYYY-MM-DD HH:MM:SS
order_lines	OrderLineInfo []	可选		最大列表长度：20	入库单信息
order_line OrderLineInfo 可选入库单信息 └ batch_code String 可选批次编码批次编码 └ produce_code String 可选生产批号生产批号 └ expire_date String 可选 2012-09-17 15:16:44 商品过期日期YYYY-MM-DD └ product_date String 可选 2012-09-17 15:16:44 商品生产日期 YYYY-MM-DD └ inventory_type String 可选库存类型库存类型ZP=正品, CC=残次,JS=机损, XS= 箱损，默认为ZP └ retail_price Number 可选 90 零售价 └ purchase_price Number 可选 80 采购价 └ sku_property String 可选商品属性商品属性 └ plan_qty Number 必须 1 应收商品数量 └ item_name String 可选商品名称商品名称 └ item_id String 必须仓储系统商品ID 仓储系统商品ID └ item_code String 必须商品编码商品编码 └ order_line_no String 可选入库单的行号入库单的行号 └ out_biz_code String 可选外部业务编码外部业务编码, 消息ID, 用于去重，当单据需要分批次发送时使用
entry_in_order_code	String	必须	LBX001512105549004		入库单号
entry_in_owner_code	String	必须	306146512		入库单货主编码
entry_out_order_code	String	可选	LBX002000101378001		对应出库单号
entry_out_owner_code	String	可选	10000		出库单货主编码

名称	类型	示例值	描述
flag	String	failure	flag
errorcode	String	code	code
message	String	message	message

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
IcpOrderStockinordermessagetoerpRequest req = new IcpOrderStockinordermessagetoerpRequest();
req.setPurchaseOrderCode("LBX002000101387001");
req.setWarehouseCode("WUZHOU-0001");
req.setOperatorCode("1697680011");
req.setOperatorName("小二");
req.setOperateTime("2015-03-19 19:25:06");
IcpOrderStockinordermessagetoerpRequest.SenderInfo obj1 = new IcpOrderStockinordermessagetoerpRequest.SenderInfo();
obj1.setSenderInfocompany("公司名称");
obj1.setSenderInfoname("姓名");
obj1.setSenderInfozipCode("332211");
obj1.setSenderInfotel("332211");
obj1.setSenderInfomobile("332211");
obj1.setSenderInfoemail("rp@163.com");
obj1.setSenderInfocountryCode("国家二字码");
obj1.setSenderInfoprovince("浙江省");
obj1.setSenderInfocity("杭州市");
obj1.setSenderInfoarea("西湖区");
obj1.setSenderInfotown("村镇");
obj1.setSenderInfodetailAddress("详细地址");
req.setSenderInfo(obj1);
IcpOrderStockinordermessagetoerpRequest.ReceiverInfo obj2 = new IcpOrderStockinordermessagetoerpRequest.ReceiverInfo();
obj2.setReceiverInfocompany("公司名称");
obj2.setReceiverInfoname("姓名");
obj2.setReceiverInfozipCode("邮编");
obj2.setReceiverInfotel("固定电话");
obj2.setReceiverInfomobile("移动电话");
obj2.setReceiverInfoemail("电子邮箱");
obj2.setReceiverInfocountryCode("国家二字码");
obj2.setReceiverInfoprovince("省份");
obj2.setReceiverInfocity("城市");
obj2.setReceiverInfoarea("区域");
obj2.setReceiverInfotown("村镇");
obj2.setReceiverInfodetailAddress("详细地址");
req.setReceiverInfo(obj2);
req.setRemark("备注");
req.setExtendProps("扩展属性");
req.setSupplierName("天猫海外商家测试香港");
req.setSupplierCode("1697680011");
req.setExpressCode("60002251724");
req.setLogisticsName("顺丰");
req.setLogisticsCode("SF");
req.setExpectEndTime("2012-07-29 12:05:09");
req.setExpectStartTime("2012-07-29 12:05:09");
List<IcpOrderStockinordermessagetoerpRequest.RelatedOrderInfo> list4 = new ArrayList<IcpOrderStockinordermessagetoerpRequest.RelatedOrderInfo>();
IcpOrderStockinordermessagetoerpRequest.RelatedOrderInfo obj5 = new IcpOrderStockinordermessagetoerpRequest.RelatedOrderInfo();
list4.add(obj5);
IcpOrderStockinordermessagetoerpRequest.RelatedOrderInfo obj7 = new IcpOrderStockinordermessagetoerpRequest.RelatedOrderInfo();
obj7.setOrderCode("LBX002000101378001");
obj7.setOrderType("CK");
list6.setRelatedOrder(obj7);
req.setRelatedOrders(list4);
req.setOrderType("QTRK");
req.setOrderCreateTime("LBX002000101387001");
List<IcpOrderStockinordermessagetoerpRequest.OrderLineInfo> list9 = new ArrayList<IcpOrderStockinordermessagetoerpRequest.OrderLineInfo>();
IcpOrderStockinordermessagetoerpRequest.OrderLineInfo obj10 = new IcpOrderStockinordermessagetoerpRequest.OrderLineInfo();
list9.add(obj10);
IcpOrderStockinordermessagetoerpRequest.OrderLineInfo obj12 = new IcpOrderStockinordermessagetoerpRequest.OrderLineInfo();
obj12.setBatchCode("批次编码");
obj12.setProduceCode("生产批号");
obj12.setExpireDate("2012-09-17 15:16:44");
obj12.setProductDate("2012-09-17 15:16:44");
obj12.setInventoryType("库存类型");
obj12.setRetailPrice(90L);
obj12.setPurchasePrice(80L);
obj12.setSkuProperty("商品属性");
obj12.setPlanQty(1L);
obj12.setItemName("商品名称");
obj12.setItemId("仓储系统商品ID");
obj12.setItemCode("商品编码");
obj12.setOrderLineNo("入库单的行号");
obj12.setOutBizCode("外部业务编码");
list11.setOrderLine(obj12);
req.setOrderLines(list9);
req.setEntryInOrderCode("LBX001512105549004");
req.setEntryInOwnerCode("306146512");
req.setEntryOutOrderCode("LBX002000101378001");
req.setEntryOutOwnerCode("10000");
IcpOrderStockinordermessagetoerpResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
IcpOrderStockinordermessagetoerpRequest req = new IcpOrderStockinordermessagetoerpRequest();
req.PurchaseOrderCode = "LBX002000101387001";
req.WarehouseCode = "WUZHOU-0001";
req.OperatorCode = "1697680011";
req.OperatorName = "小二";
req.OperateTime = "2015-03-19 19:25:06";
IcpOrderStockinordermessagetoerpRequest.SenderInfoDomain obj1 = new IcpOrderStockinordermessagetoerpRequest.SenderInfoDomain();
obj1.SenderInfocompany = "公司名称";
obj1.SenderInfoname = "姓名";
obj1.SenderInfozipCode = "332211";
obj1.SenderInfotel = "332211";
obj1.SenderInfomobile = "332211";
obj1.SenderInfoemail = "rp@163.com";
obj1.SenderInfocountryCode = "国家二字码";
obj1.SenderInfoprovince = "浙江省";
obj1.SenderInfocity = "杭州市";
obj1.SenderInfoarea = "西湖区";
obj1.SenderInfotown = "村镇";
obj1.SenderInfodetailAddress = "详细地址";
req.SenderInfo_ = obj1;
IcpOrderStockinordermessagetoerpRequest.ReceiverInfoDomain obj2 = new IcpOrderStockinordermessagetoerpRequest.ReceiverInfoDomain();
obj2.ReceiverInfocompany = "公司名称";
obj2.ReceiverInfoname = "姓名";
obj2.ReceiverInfozipCode = "邮编";
obj2.ReceiverInfotel = "固定电话";
obj2.ReceiverInfomobile = "移动电话";
obj2.ReceiverInfoemail = "电子邮箱";
obj2.ReceiverInfocountryCode = "国家二字码";
obj2.ReceiverInfoprovince = "省份";
obj2.ReceiverInfocity = "城市";
obj2.ReceiverInfoarea = "区域";
obj2.ReceiverInfotown = "村镇";
obj2.ReceiverInfodetailAddress = "详细地址";
req.ReceiverInfo_ = obj2;
req.Remark = "备注";
req.ExtendProps = "扩展属性";
req.SupplierName = "天猫海外商家测试香港";
req.SupplierCode = "1697680011";
req.ExpressCode = "60002251724";
req.LogisticsName = "顺丰";
req.LogisticsCode = "SF";
req.ExpectEndTime = "2012-07-29 12:05:09";
req.ExpectStartTime = "2012-07-29 12:05:09";
List<IcpOrderStockinordermessagetoerpRequest.RelatedOrderInfoDomain> list4 = new List<IcpOrderStockinordermessagetoerpRequest.RelatedOrderInfoDomain>();
IcpOrderStockinordermessagetoerpRequest.RelatedOrderInfoDomain obj5 = new IcpOrderStockinordermessagetoerpRequest.RelatedOrderInfoDomain();
list4.Add(obj5);
IcpOrderStockinordermessagetoerpRequest.RelatedOrderInfoDomain obj6 = new IcpOrderStockinordermessagetoerpRequest.RelatedOrderInfoDomain();
obj6.OrderCode = "LBX002000101378001";
obj6.OrderType = "CK";
obj5.RelatedOrder= obj6;
req.RelatedOrders_ = list4;
req.OrderType = "QTRK";
req.OrderCreateTime = "LBX002000101387001";
List<IcpOrderStockinordermessagetoerpRequest.OrderLineInfoDomain> list8 = new List<IcpOrderStockinordermessagetoerpRequest.OrderLineInfoDomain>();
IcpOrderStockinordermessagetoerpRequest.OrderLineInfoDomain obj9 = new IcpOrderStockinordermessagetoerpRequest.OrderLineInfoDomain();
list8.Add(obj9);
IcpOrderStockinordermessagetoerpRequest.OrderLineInfoDomain obj10 = new IcpOrderStockinordermessagetoerpRequest.OrderLineInfoDomain();
obj10.BatchCode = "批次编码";
obj10.ProduceCode = "生产批号";
obj10.ExpireDate = "2012-09-17 15:16:44";
obj10.ProductDate = "2012-09-17 15:16:44";
obj10.InventoryType = "库存类型";
obj10.RetailPrice = 90L;
obj10.PurchasePrice = 80L;
obj10.SkuProperty = "商品属性";
obj10.PlanQty = 1L;
obj10.ItemName = "商品名称";
obj10.ItemId = "仓储系统商品ID";
obj10.ItemCode = "商品编码";
obj10.OrderLineNo = "入库单的行号";
obj10.OutBizCode = "外部业务编码";
obj9.OrderLine= obj10;
req.OrderLines_ = list8;
req.EntryInOrderCode = "LBX001512105549004";
req.EntryInOwnerCode = "306146512";
req.EntryOutOrderCode = "LBX002000101378001";
req.EntryOutOwnerCode = "10000";
IcpOrderStockinordermessagetoerpResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new IcpOrderStockinordermessagetoerpRequest;
$req->setPurchaseOrderCode("LBX002000101387001");
$req->setWarehouseCode("WUZHOU-0001");
$req->setOperatorCode("1697680011");
$req->setOperatorName("小二");
$req->setOperateTime("2015-03-19 19:25:06");
$sender_info = new SenderInfo;
$sender_info->sender_infocompany="公司名称";
$sender_info->sender_infoname="姓名";
$sender_info->sender_infozip_code="332211";
$sender_info->sender_infotel="332211";
$sender_info->sender_infomobile="332211";
$sender_info->sender_infoemail="rp@163.com";
$sender_info->sender_infocountry_code="国家二字码";
$sender_info->sender_infoprovince="浙江省";
$sender_info->sender_infocity="杭州市";
$sender_info->sender_infoarea="西湖区";
$sender_info->sender_infotown="村镇";
$sender_info->sender_infodetail_address="详细地址";
$req->setSenderInfo(json_encode($sender_info));
$receiver_info = new ReceiverInfo;
$receiver_info->receiver_infocompany="公司名称";
$receiver_info->receiver_infoname="姓名";
$receiver_info->receiver_infozip_code="邮编";
$receiver_info->receiver_infotel="固定电话";
$receiver_info->receiver_infomobile="移动电话";
$receiver_info->receiver_infoemail="电子邮箱";
$receiver_info->receiver_infocountry_code="国家二字码";
$receiver_info->receiver_infoprovince="省份";
$receiver_info->receiver_infocity="城市";
$receiver_info->receiver_infoarea="区域";
$receiver_info->receiver_infotown="村镇";
$receiver_info->receiver_infodetail_address="详细地址";
$req->setReceiverInfo(json_encode($receiver_info));
$req->setRemark("备注");
$req->setExtendProps("扩展属性");
$req->setSupplierName("天猫海外商家测试香港");
$req->setSupplierCode("1697680011");
$req->setExpressCode("60002251724");
$req->setLogisticsName("顺丰");
$req->setLogisticsCode("SF");
$req->setExpectEndTime("2012-07-29 12:05:09");
$req->setExpectStartTime("2012-07-29 12:05:09");
$related_orders = new RelatedOrderInfo;
$related_order = new RelatedOrderInfo;
$related_order->order_code="LBX002000101378001";
$related_order->order_type="CK";
$related_orders->related_order = $related_order;
$req->setRelatedOrders(json_encode($related_orders));
$req->setOrderType("QTRK");
$req->setOrderCreateTime("LBX002000101387001");
$order_lines = new OrderLineInfo;
$order_line = new OrderLineInfo;
$order_line->batch_code="批次编码";
$order_line->produce_code="生产批号";
$order_line->expire_date="2012-09-17 15:16:44";
$order_line->product_date="2012-09-17 15:16:44";
$order_line->inventory_type="库存类型";
$order_line->retail_price="90";
$order_line->purchase_price="80";
$order_line->sku_property="商品属性";
$order_line->plan_qty="1";
$order_line->item_name="商品名称";
$order_line->item_id="仓储系统商品ID";
$order_line->item_code="商品编码";
$order_line->order_line_no="入库单的行号";
$order_line->out_biz_code="外部业务编码";
$order_lines->order_line = $order_line;
$req->setOrderLines(json_encode($order_lines));
$req->setEntryInOrderCode("LBX001512105549004");
$req->setEntryInOwnerCode("306146512");
$req->setEntryOutOrderCode("LBX002000101378001");
$req->setEntryOutOwnerCode("10000");
$resp = $c->execute($req);

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"taobao.icp.order.stockinordermessagetoerp");
add_param(pRequest,"purchase_order_code","LBX002000101387001");
add_param(pRequest,"warehouse_code","WUZHOU-0001");
add_param(pRequest,"operator_code","1697680011");
add_param(pRequest,"operator_name","小二");
add_param(pRequest,"operate_time","2015-03-19 19:25:06");
add_param(pRequest,"sender_info","数据结构JSON示例");
add_param(pRequest,"receiver_info","数据结构JSON示例");
add_param(pRequest,"remark","备注");
add_param(pRequest,"extend_props","扩展属性");
add_param(pRequest,"supplier_name","天猫海外商家测试香港");
add_param(pRequest,"supplier_code","1697680011");
add_param(pRequest,"express_code","60002251724");
add_param(pRequest,"logistics_name","顺丰");
add_param(pRequest,"logistics_code","SF");
add_param(pRequest,"expect_end_time","2012-07-29 12:05:09");
add_param(pRequest,"expect_start_time","2012-07-29 12:05:09");
add_param(pRequest,"related_orders","数据结构JSON示例");
add_param(pRequest,"order_type","QTRK");
add_param(pRequest,"order_create_time","LBX002000101387001");
add_param(pRequest,"order_lines","数据结构JSON示例");
add_param(pRequest,"entry_in_order_code","LBX001512105549004");
add_param(pRequest,"entry_in_owner_code","306146512");
add_param(pRequest,"entry_out_order_code","LBX002000101378001");
add_param(pRequest,"entry_out_owner_code","10000");
pResponse = top_execute(pClient,pRequest,NULL);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
    pTopResponseIterator ite = init_response_iterator(pResponse);
    pResultItem pResultItem = alloc_result_item();
    while(parseNext(ite, pResultItem) == 0){
        printf("%s:%s\n",pResultItem->key,pResultItem->value);
    }
    destroy_response_iterator(ite);
    destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

XML示例
JSON示例

<icp_order_stockinordermessagetoerp_response>
    <flag>failure</flag>
    <errorcode>code</errorcode>
    <message>message</message>
</icp_order_stockinordermessagetoerp_response>

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

交易API

taobao.icp.order.stockinordermessagetoerp (stockinordermessagetoerp)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ