淘宝开放平台

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
ae_local_return_issue_request	InsTopAeLocalReturnIssueRequest	必须			request
└ inst_policy_no String 必须机构保单号机构保单号 └ out_biz_no String 可选 21231241 幂等单号 └ biz_order_no String 必须 24141421 交易订单号 └ goods_name String 可选测试商品商品名称 └ goods_quantity String 可选 1 商品数量 └ shipment_time String 可选 1778229293 发货时间戳 └ order_amount String 可选 100 订单交易金额(单位分) └ order_currency String 可选 CNY 订单币种 └ insurance_end_time String 可选 1778229293 保单止期时间戳 └ buyer_region String 可选中国买家地区 └ premium String 可选 100 保费(单位分) └ premium_currency String 可选 CNY 保费币种 └ sum_insured String 可选 100 保额(单位分) holder InsAePersonDTO 必须投保人信息 └ uid String 可选 2424 投保人uid └ name String 可选测试名称投保人名称 └ id_card_type String 必须 10(身份证)、23(营业执照) 投保人证件类型 └ id_card_no String 必须 222 证件编号 └ id_card_name String 必须测试证件名称 └ bill_account_no String 可选 2088xx 投保人2088 bill_dto InsAeLocalReturnBillDTO 必须账单信息 └ payer_account String 必须 2088xx 付款人账户,商家IPAY账户/国内支付宝账户 └ payer_account_name String 可选测试账号付款人账户名 └ payer_account_org String 可选支付宝付款人开户机构,国际支付宝/支付宝支付科技有限公司 └ payee_account String 必须 2088xx 收款人账户,保司IPAY账户/保司国内支付宝账户 └ payee_account_name String 可选测试收款人名称 └ payee_account_org String 可选测试机构收款人开户机构 └ fund_flow_no String 可选 20260508xx 流水号 └ fee String 必须 100 发生的金额(单位分) └ fee_currency String 必须 CNY 金额币种(USD/CNY) └ need_forex_settlement Boolean 可选 true 是否需要结汇,true:需要,false:不需要 forex_settlement_info ForexSettlementInfo 可选结汇信息need_forex_settlement为true时必传 └ platform String 可选 AE 平台标识 └ reference_order_no String 可选 22412131 外部（电商平台）交易单号 └ payment_time String 可选 1778232451 支付时间戳 └ trans_amount String 可选 100 用户支付金额(单位分) └ trans_currency String 可选 USD 用户支付币种 └ trade_amount String 可选 100 交易金额(单位分\收款方收到金额) └ trade_currency String 可选 USD 交易币种 └ buyer_id String 可选 23141 买家ID └ buyer_name String 可选测试商家买家姓名/邮箱 └ buyer_country String 可选 USA 买家国家代码(3位英文) └ extend_info String 可选业务字段业务字段json字符串 └ insurance_start_time String 必须 1778655006 保单起期时间戳 └ prod_no String 必须 xx 机构产品号 └ buyer_id String 可选 xx 买家ID └ seller_id String 必须 xx 商家ID

名称	类型	示例值	描述
result	TopResult		result
model InsTopAeLocalReturnIssueResponse response └ policy_no String 202605208xx 保单号 └ error_code String SYSTEM_ERROR 错误码 └ error_msg String 系统异常错误描述 └ is_success Boolean true 是否成功

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlipayBaoxianAelocalreturnIssueRequest req = new AlipayBaoxianAelocalreturnIssueRequest();
AlipayBaoxianAelocalreturnIssueRequest.InsTopAeLocalReturnIssueRequest obj1 = new AlipayBaoxianAelocalreturnIssueRequest.InsTopAeLocalReturnIssueRequest();
obj1.setInstPolicyNo("机构保单号");
obj1.setOutBizNo("21231241");
obj1.setBizOrderNo("24141421");
obj1.setGoodsName("测试商品");
obj1.setGoodsQuantity("1");
obj1.setShipmentTime("1778229293");
obj1.setOrderAmount("100");
obj1.setOrderCurrency("CNY");
obj1.setInsuranceEndTime("1778229293");
obj1.setBuyerRegion("中国");
obj1.setPremium("100");
obj1.setPremiumCurrency("CNY");
obj1.setSumInsured("100");
AlipayBaoxianAelocalreturnIssueRequest.InsAePersonDTO obj2 = new AlipayBaoxianAelocalreturnIssueRequest.InsAePersonDTO();
obj2.setUid("2424");
obj2.setName("测试名称");
obj2.setIdCardType("10(身份证)、23(营业执照)");
obj2.setIdCardNo("222");
obj2.setIdCardName("测试");
obj2.setBillAccountNo("2088xx");
obj1.setHolder(obj2);
AlipayBaoxianAelocalreturnIssueRequest.InsAeLocalReturnBillDTO obj3 = new AlipayBaoxianAelocalreturnIssueRequest.InsAeLocalReturnBillDTO();
obj3.setPayerAccount("2088xx");
obj3.setPayerAccountName("测试账号");
obj3.setPayerAccountOrg("支付宝");
obj3.setPayeeAccount("2088xx");
obj3.setPayeeAccountName("测试");
obj3.setPayeeAccountOrg("测试机构");
obj3.setFundFlowNo("20260508xx");
obj3.setFee("100");
obj3.setFeeCurrency("CNY");
obj1.setBillDto(obj3);
obj1.setNeedForexSettlement(true);
AlipayBaoxianAelocalreturnIssueRequest.ForexSettlementInfo obj4 = new AlipayBaoxianAelocalreturnIssueRequest.ForexSettlementInfo();
obj4.setPlatform("AE");
obj4.setReferenceOrderNo("22412131");
obj4.setPaymentTime("1778232451");
obj4.setTransAmount("100");
obj4.setTransCurrency("USD");
obj4.setTradeAmount("100");
obj4.setTradeCurrency("USD");
obj4.setBuyerId("23141");
obj4.setBuyerName("测试商家");
obj4.setBuyerCountry("USA");
obj1.setForexSettlementInfo(obj4);
obj1.setExtendInfo("业务字段");
obj1.setInsuranceStartTime("1778655006");
obj1.setProdNo("xx");
obj1.setBuyerId("xx");
obj1.setSellerId("xx");
req.setAeLocalReturnIssueRequest(obj1);
AlipayBaoxianAelocalreturnIssueResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlipayBaoxianAelocalreturnIssueRequest req = new AlipayBaoxianAelocalreturnIssueRequest();
AlipayBaoxianAelocalreturnIssueRequest.InsTopAeLocalReturnIssueRequestDomain obj1 = new AlipayBaoxianAelocalreturnIssueRequest.InsTopAeLocalReturnIssueRequestDomain();
obj1.InstPolicyNo = "机构保单号";
obj1.OutBizNo = "21231241";
obj1.BizOrderNo = "24141421";
obj1.GoodsName = "测试商品";
obj1.GoodsQuantity = "1";
obj1.ShipmentTime = "1778229293";
obj1.OrderAmount = "100";
obj1.OrderCurrency = "CNY";
obj1.InsuranceEndTime = "1778229293";
obj1.BuyerRegion = "中国";
obj1.Premium = "100";
obj1.PremiumCurrency = "CNY";
obj1.SumInsured = "100";
AlipayBaoxianAelocalreturnIssueRequest.InsAePersonDTODomain obj2 = new AlipayBaoxianAelocalreturnIssueRequest.InsAePersonDTODomain();
obj2.Uid = "2424";
obj2.Name = "测试名称";
obj2.IdCardType = "10(身份证)、23(营业执照)";
obj2.IdCardNo = "222";
obj2.IdCardName = "测试";
obj2.BillAccountNo = "2088xx";
obj1.Holder= obj2;
AlipayBaoxianAelocalreturnIssueRequest.InsAeLocalReturnBillDTODomain obj3 = new AlipayBaoxianAelocalreturnIssueRequest.InsAeLocalReturnBillDTODomain();
obj3.PayerAccount = "2088xx";
obj3.PayerAccountName = "测试账号";
obj3.PayerAccountOrg = "支付宝";
obj3.PayeeAccount = "2088xx";
obj3.PayeeAccountName = "测试";
obj3.PayeeAccountOrg = "测试机构";
obj3.FundFlowNo = "20260508xx";
obj3.Fee = "100";
obj3.FeeCurrency = "CNY";
obj1.BillDto= obj3;
obj1.NeedForexSettlement = true;
AlipayBaoxianAelocalreturnIssueRequest.ForexSettlementInfoDomain obj4 = new AlipayBaoxianAelocalreturnIssueRequest.ForexSettlementInfoDomain();
obj4.Platform = "AE";
obj4.ReferenceOrderNo = "22412131";
obj4.PaymentTime = "1778232451";
obj4.TransAmount = "100";
obj4.TransCurrency = "USD";
obj4.TradeAmount = "100";
obj4.TradeCurrency = "USD";
obj4.BuyerId = "23141";
obj4.BuyerName = "测试商家";
obj4.BuyerCountry = "USA";
obj1.ForexSettlementInfo= obj4;
obj1.ExtendInfo = "业务字段";
obj1.InsuranceStartTime = "1778655006";
obj1.ProdNo = "xx";
obj1.BuyerId = "xx";
obj1.SellerId = "xx";
req.AeLocalReturnIssueRequest_ = obj1;
AlipayBaoxianAelocalreturnIssueResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlipayBaoxianAelocalreturnIssueRequest;
$ae_local_return_issue_request = new InsTopAeLocalReturnIssueRequest;
$ae_local_return_issue_request->inst_policy_no="机构保单号";
$ae_local_return_issue_request->out_biz_no="21231241";
$ae_local_return_issue_request->biz_order_no="24141421";
$ae_local_return_issue_request->goods_name="测试商品";
$ae_local_return_issue_request->goods_quantity="1";
$ae_local_return_issue_request->shipment_time="1778229293";
$ae_local_return_issue_request->order_amount="100";
$ae_local_return_issue_request->order_currency="CNY";
$ae_local_return_issue_request->insurance_end_time="1778229293";
$ae_local_return_issue_request->buyer_region="中国";
$ae_local_return_issue_request->premium="100";
$ae_local_return_issue_request->premium_currency="CNY";
$ae_local_return_issue_request->sum_insured="100";
$holder = new InsAePersonDTO;
$holder->uid="2424";
$holder->name="测试名称";
$holder->id_card_type="10(身份证)、23(营业执照)";
$holder->id_card_no="222";
$holder->id_card_name="测试";
$holder->bill_account_no="2088xx";
$ae_local_return_issue_request->holder = $holder;
$bill_dto = new InsAeLocalReturnBillDTO;
$bill_dto->payer_account="2088xx";
$bill_dto->payer_account_name="测试账号";
$bill_dto->payer_account_org="支付宝";
$bill_dto->payee_account="2088xx";
$bill_dto->payee_account_name="测试";
$bill_dto->payee_account_org="测试机构";
$bill_dto->fund_flow_no="20260508xx";
$bill_dto->fee="100";
$bill_dto->fee_currency="CNY";
$ae_local_return_issue_request->bill_dto = $bill_dto;
$ae_local_return_issue_request->need_forex_settlement="true";
$forex_settlement_info = new ForexSettlementInfo;
$forex_settlement_info->platform="AE";
$forex_settlement_info->reference_order_no="22412131";
$forex_settlement_info->payment_time="1778232451";
$forex_settlement_info->trans_amount="100";
$forex_settlement_info->trans_currency="USD";
$forex_settlement_info->trade_amount="100";
$forex_settlement_info->trade_currency="USD";
$forex_settlement_info->buyer_id="23141";
$forex_settlement_info->buyer_name="测试商家";
$forex_settlement_info->buyer_country="USA";
$ae_local_return_issue_request->forex_settlement_info = $forex_settlement_info;
$ae_local_return_issue_request->extend_info="业务字段";
$ae_local_return_issue_request->insurance_start_time="1778655006";
$ae_local_return_issue_request->prod_no="xx";
$ae_local_return_issue_request->buyer_id="xx";
$ae_local_return_issue_request->seller_id="xx";
$req->setAeLocalReturnIssueRequest(json_encode($ae_local_return_issue_request));
$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=alipay.baoxian.aelocalreturn.issue' \
-d 'partner_id=apidoc' \
-d 'sign=84FF70A49CA9AA631C24414CD511F896' \
-d 'sign_method=hmac' \
-d 'timestamp=2026-09-24+00%3A29%3A18' \
-d 'v=2.0' \
-d 'ae_local_return_issue_request=null'

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

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

req.ae_local_return_issue_request="数据结构示例JSON格式"
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,"alipay.baoxian.aelocalreturn.issue");
add_param(pRequest,"ae_local_return_issue_request","数据结构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',
	'url': 'http://gw.api.taobao.com/router/rest'
});

client.execute('alipay.baoxian.aelocalreturn.issue', {
	'ae_local_return_issue_request':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alipay_baoxian_aelocalreturn_issue_response>
    <result>
        <model>
            <policy_no>202605208xx</policy_no>
        </model>
        <error_code>SYSTEM_ERROR</error_code>
        <error_msg>系统异常</error_msg>
        <is_success>true</is_success>
    </result>
</alipay_baoxian_aelocalreturn_issue_response>

{
    "alipay_baoxian_aelocalreturn_issue_response":{
        "result":{
            "model":{
                "policy_no":"202605208xx"
            },
            "error_code":"SYSTEM_ERROR",
            "error_msg":"系统异常",
            "is_success":true
        }
    }
}

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

保险API

alipay.baoxian.aelocalreturn.issue (AE无忧退3.0出单接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ