淘宝开放平台

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
order	Order	必须			订单信息
└ actual_total_fee Number 必须 1000 买家实付给卖家的金额(注: 发生退款不改变)，单位：分 └ attributes String 可选 {k1:v1, k2:v2} 主订单扩展属性 └ card_no String 可选 123456 会员卡号 coupons Coupon [] 可选优惠券列表，店铺级优惠 └ coupon_code String 必须 123456 优惠券编码 └ coupon_name String 必须满100减50 优惠券名称 └ create_time Date 必须 2017-01-01 00:00:00 下单时间 details OrderDetail [] 必须子订单(商品)明细列表 └ actual_total_fee Number 必须 1000 子订单买家实付给卖家的金额，单位：分 └ approval_number String 可选国药准字H37021247 商品(药品)国药准字 └ attributes String 可选 {k3:v3, k4:v4} 子订单扩展属性 └ auction_cost_price Number 可选 100 商品(药品)成本价，单位：分 └ auction_id String 必须 1 商品(药品)ID，ERP 商品ID └ auction_ori_price Number 可选 200 商品(药品)原价定价，单位：分 └ auction_pict_url String 可选 http://xxx.png 商品(药品)主图 └ auction_price Number 必须 600 商品(药品)购买时单价，单位：分 └ auction_title String 必须感冒灵颗粒商品(药品)标题 └ bar_code String 可选 6923453463 商品(药品)条形码 └ batch_number String 可选 123456 商品(药品)批号 └ buy_amount Number 必须 2 商品(药品)购买数量 coupons Coupon [] 可选优惠券列表，商品级优惠 └ coupon_code String 必须 123456 优惠券编码 └ coupon_name String 必须单品满5元减2元优惠券名称 └ discount_fee Number 可选 200 子订单折扣金额，单位：分 └ gross_profit_rate String 可选 0 毛利率 └ pay_status Number 必须 0 子订单支付状态，若无分开支付，可以和主订单保持一致 └ refund_fee Number 可选 0 子订单退款金额 └ refund_status Number 必须 0 子定单退款状态 └ refund_time Date 可选 2017-01-01 00:00:00 子订单退款时间 └ total_fee Number 必须 1200 子订单订单总金额，单位：分 └ discount_fee Number 可选 200 主订单折扣金额 └ order_channel String 必须线下订单渠道(线下，饿了么，美团等) └ order_id String 必须 2018111100234 订单号(销售单号) └ pay_channel Number 可选 1 主订单支付渠道 └ pay_order_id String 可选 2018111100345 主订单支付单号 └ pay_status Number 必须 0 主订单支付状态 └ pay_time Date 可选 2017-01-01 00:00:00 主订单支付时间 └ refund_fee Number 可选 0 主订单退款金额 └ refund_status Number 必须 0 主订单退款状态 └ refund_time Date 可选 2017-01-01 00:00:00 主订单退款时间 └ sales String 可选 1 导购员(ERP员工姓名) └ sales_id String 可选张三导购员ID(ERP员工ID) └ shop_id String 必须 123456 门店(店铺)编码 └ shop_name String 必须格林大药房门店(店铺)名称 └ total_fee Number 必须 1200 主订单订单总金额，单位：分 └ erp_member_id String 可选 10002436 ERP会员ID

名称	类型	示例值	描述
result	ResponseResult		结果
└ error_code String INVALID_PARAM 错误码 └ error_msg String 参数错误错误信息 └ success Boolean false 是否成功

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAlihealthNrCrmOrderSyncRequest req = new AlibabaAlihealthNrCrmOrderSyncRequest();
AlibabaAlihealthNrCrmOrderSyncRequest.Order obj1 = new AlibabaAlihealthNrCrmOrderSyncRequest.Order();
obj1.setActualTotalFee(1000L);
obj1.setAttributes("{k1:v1, k2:v2}");
obj1.setCardNo("123456");
List<AlibabaAlihealthNrCrmOrderSyncRequest.Coupon> list3 = new ArrayList<AlibabaAlihealthNrCrmOrderSyncRequest.Coupon>();
AlibabaAlihealthNrCrmOrderSyncRequest.Coupon obj4 = new AlibabaAlihealthNrCrmOrderSyncRequest.Coupon();
list3.add(obj4);
obj4.setCouponCode("123456");
obj4.setCouponName("满100减50");
obj1.setCoupons(list3);
obj1.setCreateTime(StringUtils.parseDateTime("2017-01-01 00:00:00"));
List<AlibabaAlihealthNrCrmOrderSyncRequest.OrderDetail> list6 = new ArrayList<AlibabaAlihealthNrCrmOrderSyncRequest.OrderDetail>();
AlibabaAlihealthNrCrmOrderSyncRequest.OrderDetail obj7 = new AlibabaAlihealthNrCrmOrderSyncRequest.OrderDetail();
list6.add(obj7);
obj7.setActualTotalFee(1000L);
obj7.setApprovalNumber("国药准字H37021247");
obj7.setAttributes("{k3:v3, k4:v4}");
obj7.setAuctionCostPrice(100L);
obj7.setAuctionId("1");
obj7.setAuctionOriPrice(200L);
obj7.setAuctionPictUrl("http://xxx.png");
obj7.setAuctionPrice(600L);
obj7.setAuctionTitle("感冒灵颗粒");
obj7.setBarCode("6923453463");
obj7.setBatchNumber("123456");
obj7.setBuyAmount(2L);
List<AlibabaAlihealthNrCrmOrderSyncRequest.Coupon> list10 = new ArrayList<AlibabaAlihealthNrCrmOrderSyncRequest.Coupon>();
AlibabaAlihealthNrCrmOrderSyncRequest.Coupon obj11 = new AlibabaAlihealthNrCrmOrderSyncRequest.Coupon();
list10.add(obj11);
obj11.setCouponCode("123456");
obj11.setCouponName("单品满5元减2元");
list8.setCoupons(list10);
obj7.setDiscountFee(200L);
obj7.setGrossProfitRate("0");
obj7.setPayStatus(0L);
obj7.setRefundFee(0L);
obj7.setRefundStatus(0L);
obj7.setRefundTime(StringUtils.parseDateTime("2017-01-01 00:00:00"));
obj7.setTotalFee(1200L);
obj1.setDetails(list6);
obj1.setDiscountFee(200L);
obj1.setOrderChannel("线下");
obj1.setOrderId("2018111100234");
obj1.setPayChannel(1L);
obj1.setPayOrderId("2018111100345");
obj1.setPayStatus(0L);
obj1.setPayTime(StringUtils.parseDateTime("2017-01-01 00:00:00"));
obj1.setRefundFee(0L);
obj1.setRefundStatus(0L);
obj1.setRefundTime(StringUtils.parseDateTime("2017-01-01 00:00:00"));
obj1.setSales("1");
obj1.setSalesId("张三");
obj1.setShopId("123456");
obj1.setShopName("格林大药房");
obj1.setTotalFee(1200L);
obj1.setErpMemberId("10002436");
req.setOrder(obj1);
AlibabaAlihealthNrCrmOrderSyncResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaAlihealthNrCrmOrderSyncRequest req = new AlibabaAlihealthNrCrmOrderSyncRequest();
AlibabaAlihealthNrCrmOrderSyncRequest.OrderDomain obj1 = new AlibabaAlihealthNrCrmOrderSyncRequest.OrderDomain();
obj1.ActualTotalFee = 1000L;
obj1.Attributes = "{k1:v1, k2:v2}";
obj1.CardNo = "123456";
List<AlibabaAlihealthNrCrmOrderSyncRequest.CouponDomain> list3 = new List<AlibabaAlihealthNrCrmOrderSyncRequest.CouponDomain>();
AlibabaAlihealthNrCrmOrderSyncRequest.CouponDomain obj4 = new AlibabaAlihealthNrCrmOrderSyncRequest.CouponDomain();
list3.Add(obj4);
obj4.CouponCode = "123456";
obj4.CouponName = "满100减50";
obj1.Coupons= list3;
obj1.CreateTime = DateTime.Parse(2017-01-01 00:00:00");
List<AlibabaAlihealthNrCrmOrderSyncRequest.OrderDetailDomain> list6 = new List<AlibabaAlihealthNrCrmOrderSyncRequest.OrderDetailDomain>();
AlibabaAlihealthNrCrmOrderSyncRequest.OrderDetailDomain obj7 = new AlibabaAlihealthNrCrmOrderSyncRequest.OrderDetailDomain();
list6.Add(obj7);
obj7.ActualTotalFee = 1000L;
obj7.ApprovalNumber = "国药准字H37021247";
obj7.Attributes = "{k3:v3, k4:v4}";
obj7.AuctionCostPrice = 100L;
obj7.AuctionId = "1";
obj7.AuctionOriPrice = 200L;
obj7.AuctionPictUrl = "http://xxx.png";
obj7.AuctionPrice = 600L;
obj7.AuctionTitle = "感冒灵颗粒";
obj7.BarCode = "6923453463";
obj7.BatchNumber = "123456";
obj7.BuyAmount = 2L;
List<AlibabaAlihealthNrCrmOrderSyncRequest.CouponDomain> list9 = new List<AlibabaAlihealthNrCrmOrderSyncRequest.CouponDomain>();
AlibabaAlihealthNrCrmOrderSyncRequest.CouponDomain obj10 = new AlibabaAlihealthNrCrmOrderSyncRequest.CouponDomain();
list9.Add(obj10);
obj10.CouponCode = "123456";
obj10.CouponName = "单品满5元减2元";
obj7.Coupons= list9;
obj7.DiscountFee = 200L;
obj7.GrossProfitRate = "0";
obj7.PayStatus = 0L;
obj7.RefundFee = 0L;
obj7.RefundStatus = 0L;
obj7.RefundTime = DateTime.Parse(2017-01-01 00:00:00");
obj7.TotalFee = 1200L;
obj1.Details= list6;
obj1.DiscountFee = 200L;
obj1.OrderChannel = "线下";
obj1.OrderId = "2018111100234";
obj1.PayChannel = 1L;
obj1.PayOrderId = "2018111100345";
obj1.PayStatus = 0L;
obj1.PayTime = DateTime.Parse(2017-01-01 00:00:00");
obj1.RefundFee = 0L;
obj1.RefundStatus = 0L;
obj1.RefundTime = DateTime.Parse(2017-01-01 00:00:00");
obj1.Sales = "1";
obj1.SalesId = "张三";
obj1.ShopId = "123456";
obj1.ShopName = "格林大药房";
obj1.TotalFee = 1200L;
obj1.ErpMemberId = "10002436";
req.Order_ = obj1;
AlibabaAlihealthNrCrmOrderSyncResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaAlihealthNrCrmOrderSyncRequest;
$order = new Order;
$order->actual_total_fee="1000";
$order->attributes="{k1:v1, k2:v2}";
$order->card_no="123456";
$coupons = new Coupon;
$coupons->coupon_code="123456";
$coupons->coupon_name="满100减50";
$order->coupons = $coupons;
$order->create_time="2017-01-01 00:00:00";
$details = new OrderDetail;
$details->actual_total_fee="1000";
$details->approval_number="国药准字H37021247";
$details->attributes="{k3:v3, k4:v4}";
$details->auction_cost_price="100";
$details->auction_id="1";
$details->auction_ori_price="200";
$details->auction_pict_url="http://xxx.png";
$details->auction_price="600";
$details->auction_title="感冒灵颗粒";
$details->bar_code="6923453463";
$details->batch_number="123456";
$details->buy_amount="2";
$coupons = new Coupon;
$coupons->coupon_code="123456";
$coupons->coupon_name="单品满5元减2元";
$details->coupons = $coupons;
$details->discount_fee="200";
$details->gross_profit_rate="0";
$details->pay_status="0";
$details->refund_fee="0";
$details->refund_status="0";
$details->refund_time="2017-01-01 00:00:00";
$details->total_fee="1200";
$order->details = $details;
$order->discount_fee="200";
$order->order_channel="线下";
$order->order_id="2018111100234";
$order->pay_channel="1";
$order->pay_order_id="2018111100345";
$order->pay_status="0";
$order->pay_time="2017-01-01 00:00:00";
$order->refund_fee="0";
$order->refund_status="0";
$order->refund_time="2017-01-01 00:00:00";
$order->sales="1";
$order->sales_id="张三";
$order->shop_id="123456";
$order->shop_name="格林大药房";
$order->total_fee="1200";
$order->erp_member_id="10002436";
$req->setOrder(json_encode($order));
$resp = $c->execute($req);

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=alibaba.alihealth.nr.crm.order.sync' \
-d 'partner_id=apidoc' \
-d 'sign=1DFE5E36E5FED518CE0080AB379A77AD' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-19+18%3A45%3A57' \
-d 'v=2.0' \
-d 'order=null'

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

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

req.order=""
try:
	resp= req.getResponse()
	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,"alibaba.alihealth.nr.crm.order.sync");
add_param(pRequest,"order","数据结构JSON示例");
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);

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

client.execute('alibaba.alihealth.nr.crm.order.sync', {
	'order':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_alihealth_nr_crm_order_sync_response>
    <result>
        <error_code>INVALID_PARAM</error_code>
        <error_msg>参数错误</error_msg>
        <success>false</success>
    </result>
</alibaba_alihealth_nr_crm_order_sync_response>

{
    "alibaba_alihealth_nr_crm_order_sync_response":{
        "result":{
            "error_code":"INVALID_PARAM",
            "error_msg":"参数错误",
            "success":false
        }
    }
}

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下载

阿里健康-CRM

alibaba.alihealth.nr.crm.order.sync (ERP调用CRM - 同步订单)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ