淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
invoice_type	String	必须	blue		发票类型，blue=蓝票，red=红票
invoice_items	InvoiceItem []	必须		最大列表长度：200	发票明细
└ tax_rate String 必须 0.00 税率 └ tax String 必须 0.00 税额 └ specification String 可选 XM837 规格型号 └ row_type String 必须 0 发票行性质。0表示正常行，1表示折扣行，2表示被折扣行。比如充电器单价100元，折扣10元，则明细为2行，充电器行性质为2，折扣行性质为1。如果充电器没有折扣，则值应为0 └ item_no String 必须 1090512990000000000 税收分类编码，长度19位 └ item_name String 必须洗衣机货物劳务名称 └ price String 可选 100.00 单价，正常行必填，折扣行选填 └ quantity String 可选 1 数量，正常行必填，折扣行选填 └ unit String 可选台单位 └ sum_price String 必须 100.00 不含税金额 └ amount String 必须 100.00 价税合计
normal_invoice_no	String	可选	00004348		原蓝票发票号码，红票是必填
invoice_no	String	必须	00004349		发票号码
invoice_code	String	可选	111100000001	最大长度：12	发票代码
normal_invoice_code	String	可选	111100000000	最大长度：12	原蓝票发票代码，红票是必填
payee_register_no	String	必须	20150201321123	最大长度：21	销售方纳税人识别号（税号）
invoice_amount	String	必须	100.00		开票金额
invoice_date	String	必须	2018-04-01		开票日期
platform_tid	String	必须	1000001557272964		订单号
payer_name	String	必须	张三		购买方抬头
invoice_kind	Number	必须	0		发票种类，0=电子发票,1=纸质发票,2=专票，3=电子专用发票，4=全电普通发票，5=全电专用发票
business_type	Number	必须	0		抬头类型，0=个人，1=企业
checksum	String	可选	2384798473873		发票校验码
invoice_file_data	byte[]	可选	11		发票数据，电子发票上传PDF
sum_price	String	必须	100.00		不含税金额（合计）
sum_tax	String	必须	0.00		税额（合计）
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=其他, (只传英文编码)
payer_register_no	String	可选	20150201321124		购买方税号，企业抬头和专票时必填
payer_phone	String	可选	0571-1938334		购买方电话，专票必填
payer_address	String	可选	杭州市余杭区文一西路969号		购买方地址，专票必填
payer_bankaccount	String	可选	招商银行 8372349		购买方银行及账号，专票必填
receiver	String	可选	李四		收票人姓名，纸票必填
receiver_email	String	可选	82374@taobao.com		收票人邮箱，仅电子发票会发送邮箱
receiver_phone	String	可选	16678127635		收票人电话，纸票必填
logistic_code	String	可选	19827234762		快递单号
logistic_name	String	可选	天天快递		快递公司
need_logistic	Boolean	可选	true		是否需要物流，true：logistic_code和logistic_name必填，false：logistic_code和logistic_name不用填
serial_no	String	可选	E937928347P		开票申请流水号，从开票申请消息中获取

名称	类型	示例值	描述
is_success	Boolean	true	发票上传是否成功

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaEinvoiceDetailUploadRequest req = new AlibabaEinvoiceDetailUploadRequest();
req.setInvoiceType("blue");
List<AlibabaEinvoiceDetailUploadRequest.InvoiceItem> list2 = new ArrayList<AlibabaEinvoiceDetailUploadRequest.InvoiceItem>();
AlibabaEinvoiceDetailUploadRequest.InvoiceItem obj3 = new AlibabaEinvoiceDetailUploadRequest.InvoiceItem();
list2.add(obj3);
obj3.setTaxRate("0.00");
obj3.setTax("0.00");
obj3.setSpecification("XM837");
obj3.setRowType("0");
obj3.setItemNo("1090512990000000000");
obj3.setItemName("洗衣机");
obj3.setPrice("100.00");
obj3.setQuantity("1");
obj3.setUnit("台");
obj3.setSumPrice("100.00");
obj3.setAmount("100.00");
req.setInvoiceItems(list2);
req.setNormalInvoiceNo("00004348");
req.setInvoiceNo("00004349");
req.setInvoiceCode("111100000001");
req.setNormalInvoiceCode("111100000000");
req.setPayeeRegisterNo("20150201321123");
req.setInvoiceAmount("100.00");
req.setInvoiceDate("2018-04-01");
req.setPlatformTid("1000001557272964");
req.setPayerName("张三");
req.setInvoiceKind(0L);
req.setBusinessType(0L);
req.setChecksum("2384798473873");
req.setInvoiceFileData(new FileItem("/tmp/file.txt"));
req.setSumPrice("100.00");
req.setSumTax("0.00");
req.setPlatformCode("TM");
req.setPayerRegisterNo("20150201321124");
req.setPayerPhone("0571-1938334");
req.setPayerAddress("杭州市余杭区文一西路969号");
req.setPayerBankaccount("招商银行 8372349");
req.setReceiver("李四");
req.setReceiverEmail("82374@taobao.com");
req.setReceiverPhone("16678127635");
req.setLogisticCode("19827234762");
req.setLogisticName("天天快递");
req.setNeedLogistic(true);
req.setSerialNo("E937928347P");
AlibabaEinvoiceDetailUploadResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaEinvoiceDetailUploadRequest req = new AlibabaEinvoiceDetailUploadRequest();
req.InvoiceType = "blue";
List<AlibabaEinvoiceDetailUploadRequest.InvoiceItemDomain> list2 = new List<AlibabaEinvoiceDetailUploadRequest.InvoiceItemDomain>();
AlibabaEinvoiceDetailUploadRequest.InvoiceItemDomain obj3 = new AlibabaEinvoiceDetailUploadRequest.InvoiceItemDomain();
list2.Add(obj3);
obj3.TaxRate = "0.00";
obj3.Tax = "0.00";
obj3.Specification = "XM837";
obj3.RowType = "0";
obj3.ItemNo = "1090512990000000000";
obj3.ItemName = "洗衣机";
obj3.Price = "100.00";
obj3.Quantity = "1";
obj3.Unit = "台";
obj3.SumPrice = "100.00";
obj3.Amount = "100.00";
req.InvoiceItems_ = list2;
req.NormalInvoiceNo = "00004348";
req.InvoiceNo = "00004349";
req.InvoiceCode = "111100000001";
req.NormalInvoiceCode = "111100000000";
req.PayeeRegisterNo = "20150201321123";
req.InvoiceAmount = "100.00";
req.InvoiceDate = "2018-04-01";
req.PlatformTid = "1000001557272964";
req.PayerName = "张三";
req.InvoiceKind = 0L;
req.BusinessType = 0L;
req.Checksum = "2384798473873";
req.InvoiceFileData = new FileItem("/tmp/file.txt");
req.SumPrice = "100.00";
req.SumTax = "0.00";
req.PlatformCode = "TM";
req.PayerRegisterNo = "20150201321124";
req.PayerPhone = "0571-1938334";
req.PayerAddress = "杭州市余杭区文一西路969号";
req.PayerBankaccount = "招商银行 8372349";
req.Receiver = "李四";
req.ReceiverEmail = "82374@taobao.com";
req.ReceiverPhone = "16678127635";
req.LogisticCode = "19827234762";
req.LogisticName = "天天快递";
req.NeedLogistic = true;
req.SerialNo = "E937928347P";
AlibabaEinvoiceDetailUploadResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaEinvoiceDetailUploadRequest;
$req->setInvoiceType("blue");
$invoice_items = new InvoiceItem;
$invoice_items->tax_rate="0.00";
$invoice_items->tax="0.00";
$invoice_items->specification="XM837";
$invoice_items->row_type="0";
$invoice_items->item_no="1090512990000000000";
$invoice_items->item_name="洗衣机";
$invoice_items->price="100.00";
$invoice_items->quantity="1";
$invoice_items->unit="台";
$invoice_items->sum_price="100.00";
$invoice_items->amount="100.00";
$req->setInvoiceItems(json_encode($invoice_items));
$req->setNormalInvoiceNo("00004348");
$req->setInvoiceNo("00004349");
$req->setInvoiceCode("111100000001");
$req->setNormalInvoiceCode("111100000000");
$req->setPayeeRegisterNo("20150201321123");
$req->setInvoiceAmount("100.00");
$req->setInvoiceDate("2018-04-01");
$req->setPlatformTid("1000001557272964");
$req->setPayerName("张三");
$req->setInvoiceKind("0");
$req->setBusinessType("0");
$req->setChecksum("2384798473873");
//附件上传的机制参见PHP CURL文档，在文件路径前加@符号即可
$req->setInvoiceFileData(@fileLocation);
$req->setSumPrice("100.00");
$req->setSumTax("0.00");
$req->setPlatformCode("TM");
$req->setPayerRegisterNo("20150201321124");
$req->setPayerPhone("0571-1938334");
$req->setPayerAddress("杭州市余杭区文一西路969号");
$req->setPayerBankaccount("招商银行 8372349");
$req->setReceiver("李四");
$req->setReceiverEmail("82374@taobao.com");
$req->setReceiverPhone("16678127635");
$req->setLogisticCode("19827234762");
$req->setLogisticName("天天快递");
$req->setNeedLogistic("true");
$req->setSerialNo("E937928347P");
$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.detail.upload' \
-F 'partner_id=apidoc' \
-F 'session=bed7fab2-f100-4146-a584-24b4d18e2360' \
-F 'sign=2E9BE7BC8E5BE6272338FA52C16FD1F8' \
-F 'sign_method=hmac' \
-F 'timestamp=2025-04-29+17%3A16%3A25' \
-F 'v=2.0' \
-F 'business_type=0' \
-F 'checksum=2384798473873' \
-F 'invoice_amount=100.00' \
-F 'invoice_code=111100000001' \
-F 'invoice_date=2018-04-01' \
-F 'invoice_items=%7B%7D' \
-F 'invoice_kind=0' \
-F 'invoice_no=00004349' \
-F 'invoice_type=blue' \
-F 'logistic_code=19827234762' \
-F 'logistic_name=%E5%A4%A9%E5%A4%A9%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=%E6%9D%AD%E5%B7%9E%E5%B8%82%E4%BD%99%E6%9D%AD%E5%8C%BA%E6%96%87%E4%B8%80%E8%A5%BF%E8%B7%AF969%E5%8F%B7' \
-F 'payer_bankaccount=%E6%8B%9B%E5%95%86%E9%93%B6%E8%A1%8C+8372349' \
-F 'payer_name=%E5%BC%A0%E4%B8%89' \
-F 'payer_phone=0571-1938334' \
-F 'payer_register_no=20150201321124' \
-F 'platform_code=TM' \
-F 'platform_tid=1000001557272964' \
-F 'receiver=%E6%9D%8E%E5%9B%9B' \
-F 'receiver_email=82374%40taobao.com' \
-F 'receiver_phone=16678127635' \
-F 'serial_no=E937928347P' \
-F 'sum_price=100.00' \
-F 'sum_tax=0.00' \
-F 'invoice_file_data=@/tmp/file.txt'

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

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

req.invoice_type="blue"
req.invoice_items="[{}]"
req.normal_invoice_no="00004348"
req.invoice_no="00004349"
req.invoice_code="111100000001"
req.normal_invoice_code="111100000000"
req.payee_register_no="20150201321123"
req.invoice_amount="100.00"
req.invoice_date="2018-04-01"
req.platform_tid="1000001557272964"
req.payer_name="张三"
req.invoice_kind=0
req.business_type=0
req.checksum="2384798473873"
req.invoice_file_data=top.api.FileItem('abc.jpg',open('abc.jpg','rb'))
req.sum_price="100.00"
req.sum_tax="0.00"
req.platform_code="TM"
req.payer_register_no="20150201321124"
req.payer_phone="0571-1938334"
req.payer_address="杭州市余杭区文一西路969号"
req.payer_bankaccount="招商银行 8372349"
req.receiver="李四"
req.receiver_email="82374@taobao.com"
req.receiver_phone="16678127635"
req.logistic_code="19827234762"
req.logistic_name="天天快递"
req.need_logistic=true
req.serial_no="E937928347P"
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.detail.upload");
add_param(pRequest,"invoice_type","blue");
add_param(pRequest,"invoice_items","数据结构JSON示例");
add_param(pRequest,"normal_invoice_no","00004348");
add_param(pRequest,"invoice_no","00004349");
add_param(pRequest,"invoice_code","111100000001");
add_param(pRequest,"normal_invoice_code","111100000000");
add_param(pRequest,"payee_register_no","20150201321123");
add_param(pRequest,"invoice_amount","100.00");
add_param(pRequest,"invoice_date","2018-04-01");
add_param(pRequest,"platform_tid","1000001557272964");
add_param(pRequest,"payer_name","张三");
add_param(pRequest,"invoice_kind","0");
add_param(pRequest,"business_type","0");
add_param(pRequest,"checksum","2384798473873");
add_file_param(pRequest,"invoice_file_data","文件内容");
add_param(pRequest,"sum_price","100.00");
add_param(pRequest,"sum_tax","0.00");
add_param(pRequest,"platform_code","TM");
add_param(pRequest,"payer_register_no","20150201321124");
add_param(pRequest,"payer_phone","0571-1938334");
add_param(pRequest,"payer_address","杭州市余杭区文一西路969号");
add_param(pRequest,"payer_bankaccount","招商银行 8372349");
add_param(pRequest,"receiver","李四");
add_param(pRequest,"receiver_email","82374@taobao.com");
add_param(pRequest,"receiver_phone","16678127635");
add_param(pRequest,"logistic_code","19827234762");
add_param(pRequest,"logistic_name","天天快递");
add_param(pRequest,"need_logistic","true");
add_param(pRequest,"serial_no","E937928347P");
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.detail.upload', {
	'invoice_type':'blue',
	'invoice_items':'数据结构JSON示例',
	'normal_invoice_no':'00004348',
	'invoice_no':'00004349',
	'invoice_code':'111100000001',
	'normal_invoice_code':'111100000000',
	'payee_register_no':'20150201321123',
	'invoice_amount':'100.00',
	'invoice_date':'2018-04-01',
	'platform_tid':'1000001557272964',
	'payer_name':'张三',
	'invoice_kind':'0',
	'business_type':'0',
	'checksum':'2384798473873',
	'invoice_file_data':'文件内容',
	'sum_price':'100.00',
	'sum_tax':'0.00',
	'platform_code':'TM',
	'payer_register_no':'20150201321124',
	'payer_phone':'0571-1938334',
	'payer_address':'杭州市余杭区文一西路969号',
	'payer_bankaccount':'招商银行 8372349',
	'receiver':'李四',
	'receiver_email':'82374@taobao.com',
	'receiver_phone':'16678127635',
	'logistic_code':'19827234762',
	'logistic_name':'天天快递',
	'need_logistic':'true',
	'serial_no':'E937928347P'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_einvoice_detail_upload_response>
    <is_success>true</is_success>
</alibaba_einvoice_detail_upload_response>

{
    "alibaba_einvoice_detail_upload_response":{
        "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"
	}
}

错误码	错误描述	解决方案
isv.invalid-parameter	参数错误	根据错误提示修改报文重新提交
isv.payee-register-no-mismatch	政府补贴一品多地订单，上传的税号和订单上的税号不匹配	修改上传的税号

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

开放平台

电子发票

alibaba.einvoice.detail.upload (ERP上传发票数据给阿里发票平台)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ