阿里安全开放平台-阿里聚安全

请求地址：

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

名称	类型	是否必须	示例值	描述
sum_tax	String	可选	1.00	税额（合计）
sum_price	String	可选	100.00	不含税金额（合计）
platform_tid	String	必须	1000001557272964	订单号
invoice_amount	String	必须	800.08	开票金额
payee_register_no	String	必须	20150201321123	销售方纳税人识别号（税号）
receiver_phone	String	可选	15601662656	收票人电话，纸票必填
checksum	String	可选	2384798473873	发票校验码
invoice_type	String	必须	blue	发票类型，blue=蓝票，red=红票
payer_name	String	必须	王五	购买方抬头
invoice_no	String	必须	00004349	发票号码
logistic_code	String	可选	19827234762	快递单号
payer_bankaccount	String	可选	招商银行 8372349	购买方银行及账号，专票必填
receiver	String	可选	王六	收票人姓名，纸票必填
need_logistic	Boolean	可选	true	是否需要物流，true：logistic_code和logistic_name必填，false：logistic_code和logistic_name不用填
payer_phone	String	可选	021-0987657	购买方电话，专票必填
normal_invoice_code	String	可选	111100000000	原蓝票发票代码，红票是必填
invoice_date	String	必须	2020-04-27	开票日期
invoice_code	String	必须	111100000001	发票代码
normal_invoice_no	String	可选	00004348	原蓝票发票号码，红票是必填
payer_address	String	可选	上海市浦东新区南泉北路888号	购买方地址，专票必填
logistic_name	String	可选	顺丰快递	快递公司
invoice_file_data	byte[]	可选	1011	发票数据，电票时必须上传PDF/OFD
payer_register_no	String	可选	20150201321124	购买方税号，企业抬头和专票时必填
invoice_kind	Number	必须	0	发票种类，0=电子发票,1=纸质发票,2=专票
business_type	Number	必须	0	抬头类型，0=个人，1=企业
platform_code	String	必须	TM	电商平台代码。TB=淘宝、TM=天猫、JD=京东、DD=当当、PP=拍拍、YX=易讯、EBAY=ebay、QQ=QQ网购、AMAZON=亚马逊、SN=苏宁、GM=国美、WPH=唯品会、JM=聚美、LF=乐蜂、MGJ=蘑菇街、JS=聚尚、PX=拍鞋、YT=银泰、YHD=1号店、VANCL=凡客、YL=邮乐、YG=优购、1688=阿里巴巴、POS=POS门店、OTHER=其他, (只传英文编码)
receiver_email	String	可选	zhangsan.ls@antfin.com	收票人邮箱，仅电子发票会发送邮箱
apply_id	String	必须	01jXbmhpR3p8W_XVKMp1VnD4qmf0YkILmkGWeTO2f65Xw	发票申请消息中的apply_id对应，回传发票需要指定applyId

名称	类型	示例值	描述
is_success	Boolean	false	是否成功标记

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaEinvoiceMinUploadRequest req = new AlibabaEinvoiceMinUploadRequest();
req.setSumTax("1.00");
req.setSumPrice("100.00");
req.setPlatformTid("1000001557272964");
req.setInvoiceAmount("800.08");
req.setPayeeRegisterNo("20150201321123");
req.setReceiverPhone("15601662656");
req.setChecksum("2384798473873");
req.setInvoiceType("blue");
req.setPayerName("王五");
req.setInvoiceNo("00004349");
req.setLogisticCode("19827234762");
req.setPayerBankaccount("招商银行 8372349");
req.setReceiver("王六");
req.setNeedLogistic(true);
req.setPayerPhone("021-0987657");
req.setNormalInvoiceCode("111100000000");
req.setInvoiceDate("2020-04-27");
req.setInvoiceCode("111100000001");
req.setNormalInvoiceNo("00004348");
req.setPayerAddress("上海市浦东新区南泉北路888号");
req.setLogisticName("顺丰快递");
req.setInvoiceFileData(new FileItem("/tmp/file.txt"));
req.setPayerRegisterNo("20150201321124");
req.setInvoiceKind(0L);
req.setBusinessType(0L);
req.setPlatformCode("TM");
req.setReceiverEmail("zhangsan.ls@antfin.com");
req.setApplyId("01jXbmhpR3p8W_XVKMp1VnD4qmf0YkILmkGWeTO2f65Xw");
AlibabaEinvoiceMinUploadResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaEinvoiceMinUploadRequest req = new AlibabaEinvoiceMinUploadRequest();
req.SumTax = "1.00";
req.SumPrice = "100.00";
req.PlatformTid = "1000001557272964";
req.InvoiceAmount = "800.08";
req.PayeeRegisterNo = "20150201321123";
req.ReceiverPhone = "15601662656";
req.Checksum = "2384798473873";
req.InvoiceType = "blue";
req.PayerName = "王五";
req.InvoiceNo = "00004349";
req.LogisticCode = "19827234762";
req.PayerBankaccount = "招商银行 8372349";
req.Receiver = "王六";
req.NeedLogistic = true;
req.PayerPhone = "021-0987657";
req.NormalInvoiceCode = "111100000000";
req.InvoiceDate = "2020-04-27";
req.InvoiceCode = "111100000001";
req.NormalInvoiceNo = "00004348";
req.PayerAddress = "上海市浦东新区南泉北路888号";
req.LogisticName = "顺丰快递";
req.InvoiceFileData = new FileItem("/tmp/file.txt");
req.PayerRegisterNo = "20150201321124";
req.InvoiceKind = 0L;
req.BusinessType = 0L;
req.PlatformCode = "TM";
req.ReceiverEmail = "zhangsan.ls@antfin.com";
req.ApplyId = "01jXbmhpR3p8W_XVKMp1VnD4qmf0YkILmkGWeTO2f65Xw";
AlibabaEinvoiceMinUploadResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaEinvoiceMinUploadRequest;
$req->setSumTax("1.00");
$req->setSumPrice("100.00");
$req->setPlatformTid("1000001557272964");
$req->setInvoiceAmount("800.08");
$req->setPayeeRegisterNo("20150201321123");
$req->setReceiverPhone("15601662656");
$req->setChecksum("2384798473873");
$req->setInvoiceType("blue");
$req->setPayerName("王五");
$req->setInvoiceNo("00004349");
$req->setLogisticCode("19827234762");
$req->setPayerBankaccount("招商银行 8372349");
$req->setReceiver("王六");
$req->setNeedLogistic("true");
$req->setPayerPhone("021-0987657");
$req->setNormalInvoiceCode("111100000000");
$req->setInvoiceDate("2020-04-27");
$req->setInvoiceCode("111100000001");
$req->setNormalInvoiceNo("00004348");
$req->setPayerAddress("上海市浦东新区南泉北路888号");
$req->setLogisticName("顺丰快递");
//附件上传的机制参见PHP CURL文档，在文件路径前加@符号即可
$req->setInvoiceFileData(@fileLocation);
$req->setPayerRegisterNo("20150201321124");
$req->setInvoiceKind("0");
$req->setBusinessType("0");
$req->setPlatformCode("TM");
$req->setReceiverEmail("zhangsan.ls@antfin.com");
$req->setApplyId("01jXbmhpR3p8W_XVKMp1VnD4qmf0YkILmkGWeTO2f65Xw");
$resp = $c->execute($req, $sessionKey);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:multipart/form-data;charset=utf-8' \
-F 'app_key=12129701' \
-F 'format=json' \
-F 'method=alibaba.einvoice.min.upload' \
-F 'partner_id=apidoc' \
-F 'session=f951b270-a037-4b3f-8e1f-f9beb27fce26' \
-F 'sign=6BD26E1AEC7FD0C12E9751A7262CF407' \
-F 'sign_method=hmac' \
-F 'timestamp=2025-04-27+21%3A28%3A21' \
-F 'v=2.0' \
-F 'apply_id=01jXbmhpR3p8W_XVKMp1VnD4qmf0YkILmkGWeTO2f65Xw' \
-F 'business_type=0' \
-F 'checksum=2384798473873' \
-F 'invoice_amount=800.08' \
-F 'invoice_code=111100000001' \
-F 'invoice_date=2020-04-27' \
-F 'invoice_kind=0' \
-F 'invoice_no=00004349' \
-F 'invoice_type=blue' \
-F 'logistic_code=19827234762' \
-F 'logistic_name=%E9%A1%BA%E4%B8%B0%E5%BF%AB%E9%80%92' \
-F 'need_logistic=true' \
-F 'normal_invoice_code=111100000000' \
-F 'normal_invoice_no=00004348' \
-F 'payee_register_no=20150201321123' \
-F 'payer_address=%E4%B8%8A%E6%B5%B7%E5%B8%82%E6%B5%A6%E4%B8%9C%E6%96%B0%E5%8C%BA%E5%8D%97%E6%B3%89%E5%8C%97%E8%B7%AF888%E5%8F%B7' \
-F 'payer_bankaccount=%E6%8B%9B%E5%95%86%E9%93%B6%E8%A1%8C+8372349' \
-F 'payer_name=%E7%8E%8B%E4%BA%94' \
-F 'payer_phone=021-0987657' \
-F 'payer_register_no=20150201321124' \
-F 'platform_code=TM' \
-F 'platform_tid=1000001557272964' \
-F 'receiver=%E7%8E%8B%E5%85%AD' \
-F 'receiver_email=zhangsan.ls%40antfin.com' \
-F 'receiver_phone=15601662656' \
-F 'sum_price=100.00' \
-F 'sum_tax=1.00' \
-F 'invoice_file_data=@/tmp/file.txt'

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

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

req.sum_tax="1.00"
req.sum_price="100.00"
req.platform_tid="1000001557272964"
req.invoice_amount="800.08"
req.payee_register_no="20150201321123"
req.receiver_phone="15601662656"
req.checksum="2384798473873"
req.invoice_type="blue"
req.payer_name="王五"
req.invoice_no="00004349"
req.logistic_code="19827234762"
req.payer_bankaccount="招商银行 8372349"
req.receiver="王六"
req.need_logistic=true
req.payer_phone="021-0987657"
req.normal_invoice_code="111100000000"
req.invoice_date="2020-04-27"
req.invoice_code="111100000001"
req.normal_invoice_no="00004348"
req.payer_address="上海市浦东新区南泉北路888号"
req.logistic_name="顺丰快递"
req.invoice_file_data=top.api.FileItem('abc.jpg',open('abc.jpg','rb'))
req.payer_register_no="20150201321124"
req.invoice_kind=0
req.business_type=0
req.platform_code="TM"
req.receiver_email="zhangsan.ls@antfin.com"
req.apply_id="01jXbmhpR3p8W_XVKMp1VnD4qmf0YkILmkGWeTO2f65Xw"
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,"alibaba.einvoice.min.upload");
add_param(pRequest,"sum_tax","1.00");
add_param(pRequest,"sum_price","100.00");
add_param(pRequest,"platform_tid","1000001557272964");
add_param(pRequest,"invoice_amount","800.08");
add_param(pRequest,"payee_register_no","20150201321123");
add_param(pRequest,"receiver_phone","15601662656");
add_param(pRequest,"checksum","2384798473873");
add_param(pRequest,"invoice_type","blue");
add_param(pRequest,"payer_name","王五");
add_param(pRequest,"invoice_no","00004349");
add_param(pRequest,"logistic_code","19827234762");
add_param(pRequest,"payer_bankaccount","招商银行 8372349");
add_param(pRequest,"receiver","王六");
add_param(pRequest,"need_logistic","true");
add_param(pRequest,"payer_phone","021-0987657");
add_param(pRequest,"normal_invoice_code","111100000000");
add_param(pRequest,"invoice_date","2020-04-27");
add_param(pRequest,"invoice_code","111100000001");
add_param(pRequest,"normal_invoice_no","00004348");
add_param(pRequest,"payer_address","上海市浦东新区南泉北路888号");
add_param(pRequest,"logistic_name","顺丰快递");
add_file_param(pRequest,"invoice_file_data","文件内容");
add_param(pRequest,"payer_register_no","20150201321124");
add_param(pRequest,"invoice_kind","0");
add_param(pRequest,"business_type","0");
add_param(pRequest,"platform_code","TM");
add_param(pRequest,"receiver_email","zhangsan.ls@antfin.com");
add_param(pRequest,"apply_id","01jXbmhpR3p8W_XVKMp1VnD4qmf0YkILmkGWeTO2f65Xw");
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('alibaba.einvoice.min.upload', {
	'sum_tax':'1.00',
	'sum_price':'100.00',
	'platform_tid':'1000001557272964',
	'invoice_amount':'800.08',
	'payee_register_no':'20150201321123',
	'receiver_phone':'15601662656',
	'checksum':'2384798473873',
	'invoice_type':'blue',
	'payer_name':'王五',
	'invoice_no':'00004349',
	'logistic_code':'19827234762',
	'payer_bankaccount':'招商银行 8372349',
	'receiver':'王六',
	'need_logistic':'true',
	'payer_phone':'021-0987657',
	'normal_invoice_code':'111100000000',
	'invoice_date':'2020-04-27',
	'invoice_code':'111100000001',
	'normal_invoice_no':'00004348',
	'payer_address':'上海市浦东新区南泉北路888号',
	'logistic_name':'顺丰快递',
	'invoice_file_data':'文件内容',
	'payer_register_no':'20150201321124',
	'invoice_kind':'0',
	'business_type':'0',
	'platform_code':'TM',
	'receiver_email':'zhangsan.ls@antfin.com',
	'apply_id':'01jXbmhpR3p8W_XVKMp1VnD4qmf0YkILmkGWeTO2f65Xw'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_einvoice_min_upload_response>
    <is_success>false</is_success>
</alibaba_einvoice_min_upload_response>

{
    "alibaba_einvoice_min_upload_response":{
        "is_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下载

电子发票

alibaba.einvoice.min.upload (发票回传服务（无需明细）)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ

用户导航

用户反馈

用户反馈

用户反馈