淘宝开放平台

请求地址：

环境	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。

名称	类型	是否必须	示例值	描述
orderBillCode	String	必须	A123	单据编号
orderWebCod	String	必须	A123	原单据号
shopCode	String	必须	HZ01	门店代码
billTime	String	必须	20171010	营业日期
quantity	Number	必须	100	数量
money	String	必须	100	标准价格
realMoney	String	必须	100	金额
discount	String	必须	9	折扣
paymethod	String	必须	支付方式：0-线上支付 1-线下支付',	支付方式
province	String	可选	浙江省	省
city	String	可选	杭州市	市
district	String	可选	余杭区	区
street	String	可选	文一西路	街道
creater	String	可选	张三	制单人
creationDate	String	可选	2017-11-11 12:00:00	制单日期
note	String	可选	备注信息	备注
shippingCode	String	可选	SF	快递代码
shippingSn	String	可选	201711110011	快递单号
salerEmployeeNo	String	可选	001	店员代码
chargeback	String	可选	标记可选；订单、退单、换货单、	退单
system	String	必须	来源系统 0-POS、1-中台、2-Retail、3-OMS、4-其他	来源系统
item	Item	可选		商品明细
└ skuCode String 可选 A001 商品条码 └ goodsCode String 必须 A001 商品代码 └ colorCode String 必须 A001 颜色代码 └ sizeCode String 必须 L 尺码代码 └ referencePrice String 必须 100 参考价 └ price String 必须 80 单价 └ discount String 必须 8 折扣 └ quantity String 必须 1000 数量 └ referenceAmount String 可选 1000 参考金额 └ amount String 必须 1000 金额 └ status String 必须 0-正常 1-促销 2-换购 3-赠品 4-让利 5-补差优惠 6-VIP叠加优惠 7-生日优惠 8-整单叠加优惠 9-积分换购 11-换货，12-已换货,13-打折状态
extendProps	String	可选	{"name":"名字"}	扩展属性
sourcePlatform	String	必须	来源平台：0-后台1-淘宝2-拍拍3-OS主站4-分销商5-京东11-亚马逊13-一号店等'	来源平台
sourceShopCode	String	必须	'来源店铺代码	'来源店铺代码
sourceShopName	String	必须	'来源店铺名称	'来源店铺名称
sourceChannelCode	String	必须	'来源渠道代码	'来源渠道代码
sourceChannelName	String	必须	'来源渠道名称	'来源渠道名称
orderShopCode	String	必须	'下单门店代码	'下单门店代码
customerMemo	String	可选	'顾客留言	'顾客留言
customerComment	String	可选	'客服备注	'客服备注
posOuterCode	String	可选	'结算代码	'结算代码
customerid	String	可选	customerid	customerid
oaidOrderSourceCode	String	可选	T1234567890	淘宝订单号
name	String	可选	张三	姓名
phone	String	可选	18888888888	手机号
shippingAddress	String	可选	余杭区969号小邮局	快递地址
oaid	String	可选	oaid	oaid

名称	类型	示例值	描述
resFlag	String	success\|failure	响应结果
resCode	String	1	1：成功；其他：失败
resMsg	String	msg	响应信息

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

QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret);
TaobaoPosWeborderSingleSyncRequest req = new TaobaoPosWeborderSingleSyncRequest();
req.setOrderBillCode("A123");
req.setOrderWebCod("A123");
req.setShopCode("HZ01");
req.setBillTime("20171010");
req.setQuantity(100L);
req.setMoney("100");
req.setRealMoney("100");
req.setDiscount("9");
req.setPaymethod("支付方式：0-线上支付 1-线下支付',");
req.setProvince("浙江省");
req.setCity("杭州市");
req.setDistrict("余杭区");
req.setStreet("文一西路");
req.setCreater("张三");
req.setCreationDate("2017-11-11 12:00:00");
req.setNote("备注信息");
req.setShippingCode("SF");
req.setShippingSn("201711110011");
req.setSalerEmployeeNo("001");
req.setChargeback("标记可选；订单、退单、换货单、");
req.setSystem("来源系统 0-POS、1-中台、2-Retail、3-OMS、4-其他");
TaobaoPosWeborderSingleSyncRequest.Item obj1 = new TaobaoPosWeborderSingleSyncRequest.Item();
obj1.setSkuCode("A001");
obj1.setGoodsCode("A001");
obj1.setColorCode("A001");
obj1.setSizeCode("L");
obj1.setReferencePrice("100");
obj1.setPrice("80");
obj1.setDiscount("8");
obj1.setQuantity("1000");
obj1.setReferenceAmount("1000");
obj1.setAmount("1000");
obj1.setStatus("0-正常 1-促销 2-换购 3-赠品 4-让利 5-补差优惠 6-VIP叠加优惠 7-生日优惠 8-整单叠加优惠 9-积分换购 11-换货，12-已换货,13-打折");
req.setItem(obj1);
req.setExtendProps("{\"name\":\"名字\"}");
req.setSourcePlatform("来源平台：0-后台1-淘宝2-拍拍3-OS主站4-分销商5-京东11-亚马逊13-一号店等'");
req.setSourceShopCode("'来源店铺代码");
req.setSourceShopName("'来源店铺名称");
req.setSourceChannelCode("'来源渠道代码");
req.setSourceChannelName("'来源渠道名称");
req.setOrderShopCode("'下单门店代码");
req.setCustomerMemo("'顾客留言");
req.setCustomerComment("'客服备注");
req.setPosOuterCode("'结算代码");
req.setCustomerid("customerid");
req.setOaidOrderSourceCode("T1234567890");
req.setName("张三");
req.setPhone("18888888888");
req.setShippingAddress("余杭区969号小邮局");
req.setOaid("oaid");
TaobaoPosWeborderSingleSyncResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
TaobaoPosWeborderSingleSyncRequest req = new TaobaoPosWeborderSingleSyncRequest();
req.OrderBillCode = "A123";
req.OrderWebCod = "A123";
req.ShopCode = "HZ01";
req.BillTime = "20171010";
req.Quantity = 100L;
req.Money = "100";
req.RealMoney = "100";
req.Discount = "9";
req.Paymethod = "支付方式：0-线上支付 1-线下支付',";
req.Province = "浙江省";
req.City = "杭州市";
req.District = "余杭区";
req.Street = "文一西路";
req.Creater = "张三";
req.CreationDate = "2017-11-11 12:00:00";
req.Note = "备注信息";
req.ShippingCode = "SF";
req.ShippingSn = "201711110011";
req.SalerEmployeeNo = "001";
req.Chargeback = "标记可选；订单、退单、换货单、";
req.System = "来源系统 0-POS、1-中台、2-Retail、3-OMS、4-其他";
TaobaoPosWeborderSingleSyncRequest.ItemDomain obj1 = new TaobaoPosWeborderSingleSyncRequest.ItemDomain();
obj1.SkuCode = "A001";
obj1.GoodsCode = "A001";
obj1.ColorCode = "A001";
obj1.SizeCode = "L";
obj1.ReferencePrice = "100";
obj1.Price = "80";
obj1.Discount = "8";
obj1.Quantity = "1000";
obj1.ReferenceAmount = "1000";
obj1.Amount = "1000";
obj1.Status = "0-正常 1-促销 2-换购 3-赠品 4-让利 5-补差优惠 6-VIP叠加优惠 7-生日优惠 8-整单叠加优惠 9-积分换购 11-换货，12-已换货,13-打折";
req.Item_ = obj1;
req.ExtendProps = "{\"name\":\"名字\"}";
req.SourcePlatform = "来源平台：0-后台1-淘宝2-拍拍3-OS主站4-分销商5-京东11-亚马逊13-一号店等'";
req.SourceShopCode = "'来源店铺代码";
req.SourceShopName = "'来源店铺名称";
req.SourceChannelCode = "'来源渠道代码";
req.SourceChannelName = "'来源渠道名称";
req.OrderShopCode = "'下单门店代码";
req.CustomerMemo = "'顾客留言";
req.CustomerComment = "'客服备注";
req.PosOuterCode = "'结算代码";
req.Customerid = "customerid";
req.OaidOrderSourceCode = "T1234567890";
req.Name = "张三";
req.Phone = "18888888888";
req.ShippingAddress = "余杭区969号小邮局";
req.Oaid = "oaid";
TaobaoPosWeborderSingleSyncResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TaobaoPosWeborderSingleSyncRequest;
$req->setOrderBillCode("A123");
$req->setOrderWebCod("A123");
$req->setShopCode("HZ01");
$req->setBillTime("20171010");
$req->setQuantity("100");
$req->setMoney("100");
$req->setRealMoney("100");
$req->setDiscount("9");
$req->setPaymethod("支付方式：0-线上支付 1-线下支付',");
$req->setProvince("浙江省");
$req->setCity("杭州市");
$req->setDistrict("余杭区");
$req->setStreet("文一西路");
$req->setCreater("张三");
$req->setCreationDate("2017-11-11 12:00:00");
$req->setNote("备注信息");
$req->setShippingCode("SF");
$req->setShippingSn("201711110011");
$req->setSalerEmployeeNo("001");
$req->setChargeback("标记可选；订单、退单、换货单、");
$req->setSystem("来源系统 0-POS、1-中台、2-Retail、3-OMS、4-其他");
$item = new Item;
$item->sku_code="A001";
$item->goods_code="A001";
$item->color_code="A001";
$item->size_code="L";
$item->reference_price="100";
$item->price="80";
$item->discount="8";
$item->quantity="1000";
$item->reference_amount="1000";
$item->amount="1000";
$item->status="0-正常 1-促销 2-换购 3-赠品 4-让利 5-补差优惠 6-VIP叠加优惠 7-生日优惠 8-整单叠加优惠 9-积分换购 11-换货，12-已换货,13-打折";
$req->setItem(json_encode($item));
$req->setExtendProps("{\"name\":\"名字\"}");
$req->setSourcePlatform("来源平台：0-后台1-淘宝2-拍拍3-OS主站4-分销商5-京东11-亚马逊13-一号店等'");
$req->setSourceShopCode("'来源店铺代码");
$req->setSourceShopName("'来源店铺名称");
$req->setSourceChannelCode("'来源渠道代码");
$req->setSourceChannelName("'来源渠道名称");
$req->setOrderShopCode("'下单门店代码");
$req->setCustomerMemo("'顾客留言");
$req->setCustomerComment("'客服备注");
$req->setPosOuterCode("'结算代码");
$req->setCustomerid("customerid");
$req->setOaidOrderSourceCode("T1234567890");
$req->setName("张三");
$req->setPhone("18888888888");
$req->setShippingAddress("余杭区969号小邮局");
$req->setOaid("oaid");
$resp = $c->execute($req, $sessionKey);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=qimen.taobao.pos.weborder.single.sync' \
-d 'partner_id=apidoc' \
-d 'session=3e7e1af5-0353-419e-9330-fb6874c85108' \
-d 'sign=1C5269A58326F1F20AD708F8D83A7EE5' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-29+05%3A45%3A21' \
-d 'v=2.0' \
-d 'billTime=20171010' \
-d 'chargeback=%E6%A0%87%E8%AE%B0%E5%8F%AF%E9%80%89%EF%BC%9B%E8%AE%A2%E5%8D%95%E3%80%81%E9%80%80%E5%8D%95%E3%80%81%E6%8D%A2%E8%B4%A7%E5%8D%95%E3%80%81' \
-d 'city=%E6%9D%AD%E5%B7%9E%E5%B8%82' \
-d 'creater=%E5%BC%A0%E4%B8%89' \
-d 'creationDate=2017-11-11+12%3A00%3A00' \
-d 'customerComment=%27%E5%AE%A2%E6%9C%8D%E5%A4%87%E6%B3%A8' \
-d 'customerMemo=%27%E9%A1%BE%E5%AE%A2%E7%95%99%E8%A8%80' \
-d 'customerid=customerid' \
-d 'discount=9' \
-d 'district=%E4%BD%99%E6%9D%AD%E5%8C%BA' \
-d 'extendProps=%7B%5C%22name%5C%22%3A%5C%22%E5%90%8D%E5%AD%97%5C%22%7D' \
-d 'item=null' \
-d 'money=100' \
-d 'name=%E5%BC%A0%E4%B8%89' \
-d 'note=%E5%A4%87%E6%B3%A8%E4%BF%A1%E6%81%AF' \
-d 'oaid=oaid' \
-d 'oaidOrderSourceCode=T1234567890' \
-d 'orderBillCode=A123' \
-d 'orderShopCode=%27%E4%B8%8B%E5%8D%95%E9%97%A8%E5%BA%97%E4%BB%A3%E7%A0%81' \
-d 'orderWebCod=A123' \
-d 'paymethod=%E6%94%AF%E4%BB%98%E6%96%B9%E5%BC%8F%EF%BC%9A0-%E7%BA%BF%E4%B8%8A%E6%94%AF%E4%BB%98+1-%E7%BA%BF%E4%B8%8B%E6%94%AF%E4%BB%98%27%2C' \
-d 'phone=18888888888' \
-d 'posOuterCode=%27%E7%BB%93%E7%AE%97%E4%BB%A3%E7%A0%81' \
-d 'province=%E6%B5%99%E6%B1%9F%E7%9C%81' \
-d 'quantity=100' \
-d 'realMoney=100' \
-d 'salerEmployeeNo=001' \
-d 'shippingAddress=%E4%BD%99%E6%9D%AD%E5%8C%BA969%E5%8F%B7%E5%B0%8F%E9%82%AE%E5%B1%80' \
-d 'shippingCode=SF' \
-d 'shippingSn=201711110011' \
-d 'shopCode=HZ01' \
-d 'sourceChannelCode=%27%E6%9D%A5%E6%BA%90%E6%B8%A0%E9%81%93%E4%BB%A3%E7%A0%81' \
-d 'sourceChannelName=%27%E6%9D%A5%E6%BA%90%E6%B8%A0%E9%81%93%E5%90%8D%E7%A7%B0' \
-d 'sourcePlatform=%E6%9D%A5%E6%BA%90%E5%B9%B3%E5%8F%B0%EF%BC%9A0-%E5%90%8E%E5%8F%B01-%E6%B7%98%E5%AE%9D2-%E6%8B%8D%E6%8B%8D3-OS%E4%B8%BB%E7%AB%994-%E5%88%86%E9%94%80%E5%95%865-%E4%BA%AC%E4%B8%9C11-%E4%BA%9A%E9%A9%AC%E9%80%8A13-%E4%B8%80%E5%8F%B7%E5%BA%97%E7%AD%89%27' \
-d 'sourceShopCode=%27%E6%9D%A5%E6%BA%90%E5%BA%97%E9%93%BA%E4%BB%A3%E7%A0%81' \
-d 'sourceShopName=%27%E6%9D%A5%E6%BA%90%E5%BA%97%E9%93%BA%E5%90%8D%E7%A7%B0' \
-d 'street=%E6%96%87%E4%B8%80%E8%A5%BF%E8%B7%AF' \
-d 'system=%E6%9D%A5%E6%BA%90%E7%B3%BB%E7%BB%9F+0-POS%E3%80%811-%E4%B8%AD%E5%8F%B0%E3%80%812-Retail%E3%80%813-OMS%E3%80%814-%E5%85%B6%E4%BB%96'

# -*- coding: utf-8 -*-
import top.api

req=top.api.AobaoPosWeborderSingleSyncRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.orderBillCode="A123"
req.orderWebCod="A123"
req.shopCode="HZ01"
req.billTime="20171010"
req.quantity=100
req.money="100"
req.realMoney="100"
req.discount="9"
req.paymethod="支付方式：0-线上支付 1-线下支付',"
req.province="浙江省"
req.city="杭州市"
req.district="余杭区"
req.street="文一西路"
req.creater="张三"
req.creationDate="2017-11-11 12:00:00"
req.note="备注信息"
req.shippingCode="SF"
req.shippingSn="201711110011"
req.salerEmployeeNo="001"
req.chargeback="标记可选；订单、退单、换货单、"
req.system="来源系统 0-POS、1-中台、2-Retail、3-OMS、4-其他"
req.item="数据结构示例JSON格式"
req.extendProps="{\"name\":\"名字\"}"
req.sourcePlatform="来源平台：0-后台1-淘宝2-拍拍3-OS主站4-分销商5-京东11-亚马逊13-一号店等'"
req.sourceShopCode="'来源店铺代码"
req.sourceShopName="'来源店铺名称"
req.sourceChannelCode="'来源渠道代码"
req.sourceChannelName="'来源渠道名称"
req.orderShopCode="'下单门店代码"
req.customerMemo="'顾客留言"
req.customerComment="'客服备注"
req.posOuterCode="'结算代码"
req.customerid="customerid"
req.oaidOrderSourceCode="T1234567890"
req.name="张三"
req.phone="18888888888"
req.shippingAddress="余杭区969号小邮局"
req.oaid="oaid"
try:
	resp= req.getResponse(sessionkey)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"qimen.taobao.pos.weborder.single.sync");
add_param(pRequest,"orderBillCode","A123");
add_param(pRequest,"orderWebCod","A123");
add_param(pRequest,"shopCode","HZ01");
add_param(pRequest,"billTime","20171010");
add_param(pRequest,"quantity","100");
add_param(pRequest,"money","100");
add_param(pRequest,"realMoney","100");
add_param(pRequest,"discount","9");
add_param(pRequest,"paymethod","支付方式：0-线上支付 1-线下支付',");
add_param(pRequest,"province","浙江省");
add_param(pRequest,"city","杭州市");
add_param(pRequest,"district","余杭区");
add_param(pRequest,"street","文一西路");
add_param(pRequest,"creater","张三");
add_param(pRequest,"creationDate","2017-11-11 12:00:00");
add_param(pRequest,"note","备注信息");
add_param(pRequest,"shippingCode","SF");
add_param(pRequest,"shippingSn","201711110011");
add_param(pRequest,"salerEmployeeNo","001");
add_param(pRequest,"chargeback","标记可选；订单、退单、换货单、");
add_param(pRequest,"system","来源系统 0-POS、1-中台、2-Retail、3-OMS、4-其他");
add_param(pRequest,"item","数据结构JSON示例");
add_param(pRequest,"extendProps","{\"name\":\"名字\"}");
add_param(pRequest,"sourcePlatform","来源平台：0-后台1-淘宝2-拍拍3-OS主站4-分销商5-京东11-亚马逊13-一号店等'");
add_param(pRequest,"sourceShopCode","'来源店铺代码");
add_param(pRequest,"sourceShopName","'来源店铺名称");
add_param(pRequest,"sourceChannelCode","'来源渠道代码");
add_param(pRequest,"sourceChannelName","'来源渠道名称");
add_param(pRequest,"orderShopCode","'下单门店代码");
add_param(pRequest,"customerMemo","'顾客留言");
add_param(pRequest,"customerComment","'客服备注");
add_param(pRequest,"posOuterCode","'结算代码");
add_param(pRequest,"customerid","customerid");
add_param(pRequest,"oaidOrderSourceCode","T1234567890");
add_param(pRequest,"name","张三");
add_param(pRequest,"phone","18888888888");
add_param(pRequest,"shippingAddress","余杭区969号小邮局");
add_param(pRequest,"oaid","oaid");
pResponse = top_execute(pClient,pRequest,sessionKey);
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);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('qimen.taobao.pos.weborder.single.sync', {
	'orderBillCode':'A123',
	'orderWebCod':'A123',
	'shopCode':'HZ01',
	'billTime':'20171010',
	'quantity':'100',
	'money':'100',
	'realMoney':'100',
	'discount':'9',
	'paymethod':'支付方式：0-线上支付 1-线下支付',',
	'province':'浙江省',
	'city':'杭州市',
	'district':'余杭区',
	'street':'文一西路',
	'creater':'张三',
	'creationDate':'2017-11-11 12:00:00',
	'note':'备注信息',
	'shippingCode':'SF',
	'shippingSn':'201711110011',
	'salerEmployeeNo':'001',
	'chargeback':'标记可选；订单、退单、换货单、',
	'system':'来源系统 0-POS、1-中台、2-Retail、3-OMS、4-其他',
	'item':'数据结构JSON示例',
	'extendProps':'{\"name\":\"名字\"}',
	'sourcePlatform':'来源平台：0-后台1-淘宝2-拍拍3-OS主站4-分销商5-京东11-亚马逊13-一号店等'',
	'sourceShopCode':''来源店铺代码',
	'sourceShopName':''来源店铺名称',
	'sourceChannelCode':''来源渠道代码',
	'sourceChannelName':''来源渠道名称',
	'orderShopCode':''下单门店代码',
	'customerMemo':''顾客留言',
	'customerComment':''客服备注',
	'posOuterCode':''结算代码',
	'customerid':'customerid',
	'oaidOrderSourceCode':'T1234567890',
	'name':'张三',
	'phone':'18888888888',
	'shippingAddress':'余杭区969号小邮局',
	'oaid':'oaid'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<resFlag>success|failure</resFlag>
<resCode>1</resCode>
<resMsg>msg</resMsg>

{
    "resFlag":"success|failure",
    "resCode":"1",
    "resMsg":"msg"
}

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>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案

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

qimen.taobao.pos.weborder.single.sync (单个线上销售单信息同步)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ