淘宝开放平台

请求地址：

环境	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_register_request	InvoiceRegisterRequest	可选			发票登记请求体
└ operate_by String 可选操作人操作人 invoice_d_t_o RegisterInvoiceDTO 可选发票信息 └ invoice_remark String 可选备注123 发票备注 └ seller_country_code String 可选 CN 销方国家代码 └ purchaser_bank_info String 可选中国银行杭州支行购方银行信息 └ seller_bank_info String 可选中国银行杭州支行销方银行信息 └ purchaser_region_code String 可选可不填购方地区编码 └ purchaser_code String 可选可不填购方公司代码 └ cipher_text String 可选 11231431dfaf 发票密文（字符200位） └ qr_code_cipher_text String 可选二维码密文二维码密文 └ invoice_type String 可选 VAT_SPE/VAT_COMM 发票类型 └ paper_own_certify_flag Boolean 可选 true 纸票是否到票才认证 └ invoice_no String 可选 11223344 发票号码 └ file_download_http_url String 可选文件下载http地址文件下载http地址（优先级高于fileContent） └ machine_code String 可选机器编码机器编码 └ image_id String 可选影像id 影像id └ invoice_code String 可选 11223344 发票代码 └ purchaser_name String 可选购方名称购方名称 └ scan_account String 可选扫描账号扫描账号 └ tax_rate String 可选税率税率 └ electronic_type String 可选 PDF/OFD 电子发票类型 └ seller_tax_no String 可选销方税号销方税号 └ issue_country_type String 可选 MAINLAND/NON_MAINLAND 开票国家类型 └ reg_time Date 可选 2019-07-23 10:00:00 登记成功时间 └ related_order String 可选关联单据号关联单据号 └ purchaser_tax_no String 可选购方税号购方税号 └ image_file_name String 可选影像原始文件名称影像原始文件名称 └ register_channel String 可选 Api 登记渠道 └ check_sum String 可选校验码校验码 └ tax_amount String 可选 1.00 税额 └ issued_seller_name String 可选代开销方名称代开销方名称 └ excluding_tax_amount String 可选 100.00 不含税金额 └ reg_platform_code String 可选所属平台所属平台 └ qr_code_flag String 可选二维码标识二维码标识 └ reg_biz_identity_ou String 可选可不填登记的OU └ seller_name String 可选销方名称销方名称 └ reg_user String 可选登记人登记人 └ seller_code String 可选可不填销方code └ purchaser_country_code String 可选 CN 购方国家代码 └ currency String 可选 CNY 币种 └ issued_tax_no String 可选代开单位税号代开单位税号 └ effective_tax_amount String 可选 1.00 有效税额 └ purchaser_contact_info String 可选可不填购方地址及电话 └ amount String 可选发票总金额发票总金额 └ seller_region_code String 可选可不填销方地区编码 line_list RegisterInvoiceLineDTO [] 可选发票行列表发票行列表 └ row_no Number 可选 1 行号 └ invoice_line_type String 可选 NORMAL,DISCOUNT,DISCOUNTED 发票行类型 └ quantity_unit String 可选单位单位 └ goods_source_country String 可选货物来源国货物来源国 └ tax_category2 String 可选税种2 税种2 └ duty_free_memo String 可选免税注释免税注释 └ exchange_rate String 可选汇率汇率 └ local_currency_tax_amount2 String 可选本币税额2 本币税额2 └ local_currency_tax_amount1 String 可选本币税额1 本币税额1 └ model String 可选规格型号规格型号 └ currency String 可选币种币种 └ tax_categories String 可选税种税种 └ tax_rate2 String 可选税率2 税率2 └ goods_desc String 可选货物名称货物名称 └ place_of_supply String 可选供货地点供货地点 └ unit_price String 可选单价单价 └ amount String 可选含税金额含税金额 └ local_currency_tax_amount String 可选本币税额本币税额 └ quantity String 可选数量数量 └ local_currency_excluding_tax_amount String 可选本币不含税金额本币不含税金额 └ local_currency_amount String 可选本币含税总金额本币含税总金额 └ tax_amount1 String 可选税额1 税额1 └ tax_amount2 String 可选税额2 税额2 └ local_currency_code String 可选本币币种本币币种 └ supply_date Date 可选 2019-07-23 10:00:00 服务日期/供货日期 └ service_accounting_code String 可选服务核算代码服务核算代码 └ tax_rate String 可选税率税率 └ reverse_charge String 可选是否海外发票是否海外发票 └ local_currency_price String 可选本币单价本币单价 └ zero_rate_flag String 可选零税率类型零税率类型 └ tax_amount String 可选税额税额 └ excluding_tax_amount String 可选不含税金额不含税金额 └ invoice_date Date 可选 2019-07-23 10:00:00 开票日期 └ invoice_material String 可选 PAPER/ELECTRONIC 发票介质类型 └ seller_contact_info String 可选销方地址及电话销方地址及电话 └ authorized_dealer String 可选是否海外某些国家的发票使用是否海外某些国家的发票使用 └ reg_biz_identity_id Number 可选 1 登记时，最终所选的bizId └ reg_biz_identity_code String 可选可不填登记时，所属的业务身份 └ waybill_no String 可选运单号运单号 └ invoice_type_code String 可选 VAT_COMM 票种类型code └ request_no String 可选要求在业务系统内部唯一业务请求号【必填】 └ platform_code String 可选业务平台代码【必填】业务平台代码【必填】

名称	类型	示例值	描述
data	Number	12345	发票Id
succeeded	Boolean	true	是否成功
response_code	String	0000	响应码
response_msg	String	success	响应消息

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaCfoIncomingInvoiceRegisterRequest req = new AlibabaCfoIncomingInvoiceRegisterRequest();
AlibabaCfoIncomingInvoiceRegisterRequest.InvoiceRegisterRequest obj1 = new AlibabaCfoIncomingInvoiceRegisterRequest.InvoiceRegisterRequest();
obj1.setOperateBy("操作人");
AlibabaCfoIncomingInvoiceRegisterRequest.RegisterInvoiceDTO obj2 = new AlibabaCfoIncomingInvoiceRegisterRequest.RegisterInvoiceDTO();
obj2.setInvoiceRemark("备注123");
obj2.setSellerCountryCode("CN");
obj2.setPurchaserBankInfo("中国银行杭州支行");
obj2.setSellerBankInfo("中国银行杭州支行");
obj2.setPurchaserRegionCode("可不填");
obj2.setPurchaserCode("可不填");
obj2.setCipherText("11231431dfaf");
obj2.setQrCodeCipherText("二维码密文");
obj2.setInvoiceType("VAT_SPE/VAT_COMM");
obj2.setPaperOwnCertifyFlag(true);
obj2.setInvoiceNo("11223344");
obj2.setFileDownloadHttpUrl("文件下载http地址");
obj2.setMachineCode("机器编码");
obj2.setImageId("影像id");
obj2.setInvoiceCode("11223344");
obj2.setPurchaserName("购方名称");
obj2.setScanAccount("扫描账号");
obj2.setTaxRate("税率");
obj2.setElectronicType("PDF/OFD");
obj2.setSellerTaxNo("销方税号");
obj2.setIssueCountryType("MAINLAND/NON_MAINLAND");
obj2.setRegTime(StringUtils.parseDateTime("2019-07-23 10:00:00"));
obj2.setRelatedOrder("关联单据号");
obj2.setPurchaserTaxNo("购方税号");
obj2.setImageFileName("影像原始文件名称");
obj2.setRegisterChannel("Api");
obj2.setCheckSum("校验码");
obj2.setTaxAmount("1.00");
obj2.setIssuedSellerName("代开销方名称");
obj2.setExcludingTaxAmount("100.00");
obj2.setRegPlatformCode("所属平台");
obj2.setQrCodeFlag("二维码标识");
obj2.setRegBizIdentityOu("可不填");
obj2.setSellerName("销方名称");
obj2.setRegUser("登记人");
obj2.setSellerCode("可不填");
obj2.setPurchaserCountryCode("CN");
obj2.setCurrency("CNY");
obj2.setIssuedTaxNo("代开单位税号");
obj2.setEffectiveTaxAmount("1.00");
obj2.setPurchaserContactInfo("可不填");
obj2.setAmount("发票总金额");
obj2.setSellerRegionCode("可不填");
List<AlibabaCfoIncomingInvoiceRegisterRequest.RegisterInvoiceLineDTO> list4 = new ArrayList<AlibabaCfoIncomingInvoiceRegisterRequest.RegisterInvoiceLineDTO>();
AlibabaCfoIncomingInvoiceRegisterRequest.RegisterInvoiceLineDTO obj5 = new AlibabaCfoIncomingInvoiceRegisterRequest.RegisterInvoiceLineDTO();
list4.add(obj5);
obj5.setRowNo(1L);
obj5.setInvoiceLineType("NORMAL,DISCOUNT,DISCOUNTED");
obj5.setQuantityUnit("单位");
obj5.setGoodsSourceCountry("货物来源国");
obj5.setTaxCategory2("税种2");
obj5.setDutyFreeMemo("免税注释");
obj5.setExchangeRate("汇率");
obj5.setLocalCurrencyTaxAmount2("本币税额2");
obj5.setLocalCurrencyTaxAmount1("本币税额1");
obj5.setModel("规格型号");
obj5.setCurrency("币种");
obj5.setTaxCategories("税种");
obj5.setTaxRate2("税率2");
obj5.setGoodsDesc("货物名称");
obj5.setPlaceOfSupply("供货地点");
obj5.setUnitPrice("单价");
obj5.setAmount("含税金额");
obj5.setLocalCurrencyTaxAmount("本币税额");
obj5.setQuantity("数量");
obj5.setLocalCurrencyExcludingTaxAmount("本币不含税金额");
obj5.setLocalCurrencyAmount("本币含税总金额");
obj5.setTaxAmount1("税额1");
obj5.setTaxAmount2("税额2");
obj5.setLocalCurrencyCode("本币币种");
obj5.setSupplyDate(StringUtils.parseDateTime("2019-07-23 10:00:00"));
obj5.setServiceAccountingCode("服务核算代码");
obj5.setTaxRate("税率");
obj5.setReverseCharge("是否海外发票");
obj5.setLocalCurrencyPrice("本币单价");
obj5.setZeroRateFlag("零税率类型");
obj5.setTaxAmount("税额");
obj5.setExcludingTaxAmount("不含税金额");
obj2.setLineList(list4);
obj2.setInvoiceDate(StringUtils.parseDateTime("2019-07-23 10:00:00"));
obj2.setInvoiceMaterial("PAPER/ELECTRONIC");
obj2.setSellerContactInfo("销方地址及电话");
obj2.setAuthorizedDealer("是否海外某些国家的发票使用");
obj2.setRegBizIdentityId(1L);
obj2.setRegBizIdentityCode("可不填");
obj2.setWaybillNo("运单号");
obj2.setInvoiceTypeCode("VAT_COMM");
obj1.setInvoiceDTO(obj2);
obj1.setRequestNo("要求在业务系统内部唯一");
obj1.setPlatformCode("业务平台代码【必填】");
req.setInvoiceRegisterRequest(obj1);
AlibabaCfoIncomingInvoiceRegisterResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaCfoIncomingInvoiceRegisterRequest req = new AlibabaCfoIncomingInvoiceRegisterRequest();
AlibabaCfoIncomingInvoiceRegisterRequest.InvoiceRegisterRequestDomain obj1 = new AlibabaCfoIncomingInvoiceRegisterRequest.InvoiceRegisterRequestDomain();
obj1.OperateBy = "操作人";
AlibabaCfoIncomingInvoiceRegisterRequest.RegisterInvoiceDTODomain obj2 = new AlibabaCfoIncomingInvoiceRegisterRequest.RegisterInvoiceDTODomain();
obj2.InvoiceRemark = "备注123";
obj2.SellerCountryCode = "CN";
obj2.PurchaserBankInfo = "中国银行杭州支行";
obj2.SellerBankInfo = "中国银行杭州支行";
obj2.PurchaserRegionCode = "可不填";
obj2.PurchaserCode = "可不填";
obj2.CipherText = "11231431dfaf";
obj2.QrCodeCipherText = "二维码密文";
obj2.InvoiceType = "VAT_SPE/VAT_COMM";
obj2.PaperOwnCertifyFlag = true;
obj2.InvoiceNo = "11223344";
obj2.FileDownloadHttpUrl = "文件下载http地址";
obj2.MachineCode = "机器编码";
obj2.ImageId = "影像id";
obj2.InvoiceCode = "11223344";
obj2.PurchaserName = "购方名称";
obj2.ScanAccount = "扫描账号";
obj2.TaxRate = "税率";
obj2.ElectronicType = "PDF/OFD";
obj2.SellerTaxNo = "销方税号";
obj2.IssueCountryType = "MAINLAND/NON_MAINLAND";
obj2.RegTime = DateTime.Parse(2019-07-23 10:00:00");
obj2.RelatedOrder = "关联单据号";
obj2.PurchaserTaxNo = "购方税号";
obj2.ImageFileName = "影像原始文件名称";
obj2.RegisterChannel = "Api";
obj2.CheckSum = "校验码";
obj2.TaxAmount = "1.00";
obj2.IssuedSellerName = "代开销方名称";
obj2.ExcludingTaxAmount = "100.00";
obj2.RegPlatformCode = "所属平台";
obj2.QrCodeFlag = "二维码标识";
obj2.RegBizIdentityOu = "可不填";
obj2.SellerName = "销方名称";
obj2.RegUser = "登记人";
obj2.SellerCode = "可不填";
obj2.PurchaserCountryCode = "CN";
obj2.Currency = "CNY";
obj2.IssuedTaxNo = "代开单位税号";
obj2.EffectiveTaxAmount = "1.00";
obj2.PurchaserContactInfo = "可不填";
obj2.Amount = "发票总金额";
obj2.SellerRegionCode = "可不填";
List<AlibabaCfoIncomingInvoiceRegisterRequest.RegisterInvoiceLineDTODomain> list4 = new List<AlibabaCfoIncomingInvoiceRegisterRequest.RegisterInvoiceLineDTODomain>();
AlibabaCfoIncomingInvoiceRegisterRequest.RegisterInvoiceLineDTODomain obj5 = new AlibabaCfoIncomingInvoiceRegisterRequest.RegisterInvoiceLineDTODomain();
list4.Add(obj5);
obj5.RowNo = 1L;
obj5.InvoiceLineType = "NORMAL,DISCOUNT,DISCOUNTED";
obj5.QuantityUnit = "单位";
obj5.GoodsSourceCountry = "货物来源国";
obj5.TaxCategory2 = "税种2";
obj5.DutyFreeMemo = "免税注释";
obj5.ExchangeRate = "汇率";
obj5.LocalCurrencyTaxAmount2 = "本币税额2";
obj5.LocalCurrencyTaxAmount1 = "本币税额1";
obj5.Model = "规格型号";
obj5.Currency = "币种";
obj5.TaxCategories = "税种";
obj5.TaxRate2 = "税率2";
obj5.GoodsDesc = "货物名称";
obj5.PlaceOfSupply = "供货地点";
obj5.UnitPrice = "单价";
obj5.Amount = "含税金额";
obj5.LocalCurrencyTaxAmount = "本币税额";
obj5.Quantity = "数量";
obj5.LocalCurrencyExcludingTaxAmount = "本币不含税金额";
obj5.LocalCurrencyAmount = "本币含税总金额";
obj5.TaxAmount1 = "税额1";
obj5.TaxAmount2 = "税额2";
obj5.LocalCurrencyCode = "本币币种";
obj5.SupplyDate = DateTime.Parse(2019-07-23 10:00:00");
obj5.ServiceAccountingCode = "服务核算代码";
obj5.TaxRate = "税率";
obj5.ReverseCharge = "是否海外发票";
obj5.LocalCurrencyPrice = "本币单价";
obj5.ZeroRateFlag = "零税率类型";
obj5.TaxAmount = "税额";
obj5.ExcludingTaxAmount = "不含税金额";
obj2.LineList= list4;
obj2.InvoiceDate = DateTime.Parse(2019-07-23 10:00:00");
obj2.InvoiceMaterial = "PAPER/ELECTRONIC";
obj2.SellerContactInfo = "销方地址及电话";
obj2.AuthorizedDealer = "是否海外某些国家的发票使用";
obj2.RegBizIdentityId = 1L;
obj2.RegBizIdentityCode = "可不填";
obj2.WaybillNo = "运单号";
obj2.InvoiceTypeCode = "VAT_COMM";
obj1.InvoiceDTO= obj2;
obj1.RequestNo = "要求在业务系统内部唯一";
obj1.PlatformCode = "业务平台代码【必填】";
req.InvoiceRegisterRequest_ = obj1;
AlibabaCfoIncomingInvoiceRegisterResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaCfoIncomingInvoiceRegisterRequest;
$invoice_register_request = new InvoiceRegisterRequest;
$invoice_register_request->operate_by="操作人";
$invoice_d_t_o = new RegisterInvoiceDTO;
$invoice_d_t_o->invoice_remark="备注123";
$invoice_d_t_o->seller_country_code="CN";
$invoice_d_t_o->purchaser_bank_info="中国银行杭州支行";
$invoice_d_t_o->seller_bank_info="中国银行杭州支行";
$invoice_d_t_o->purchaser_region_code="可不填";
$invoice_d_t_o->purchaser_code="可不填";
$invoice_d_t_o->cipher_text="11231431dfaf";
$invoice_d_t_o->qr_code_cipher_text="二维码密文";
$invoice_d_t_o->invoice_type="VAT_SPE/VAT_COMM";
$invoice_d_t_o->paper_own_certify_flag="true";
$invoice_d_t_o->invoice_no="11223344";
$invoice_d_t_o->file_download_http_url="文件下载http地址";
$invoice_d_t_o->machine_code="机器编码";
$invoice_d_t_o->image_id="影像id";
$invoice_d_t_o->invoice_code="11223344";
$invoice_d_t_o->purchaser_name="购方名称";
$invoice_d_t_o->scan_account="扫描账号";
$invoice_d_t_o->tax_rate="税率";
$invoice_d_t_o->electronic_type="PDF/OFD";
$invoice_d_t_o->seller_tax_no="销方税号";
$invoice_d_t_o->issue_country_type="MAINLAND/NON_MAINLAND";
$invoice_d_t_o->reg_time="2019-07-23 10:00:00";
$invoice_d_t_o->related_order="关联单据号";
$invoice_d_t_o->purchaser_tax_no="购方税号";
$invoice_d_t_o->image_file_name="影像原始文件名称";
$invoice_d_t_o->register_channel="Api";
$invoice_d_t_o->check_sum="校验码";
$invoice_d_t_o->tax_amount="1.00";
$invoice_d_t_o->issued_seller_name="代开销方名称";
$invoice_d_t_o->excluding_tax_amount="100.00";
$invoice_d_t_o->reg_platform_code="所属平台";
$invoice_d_t_o->qr_code_flag="二维码标识";
$invoice_d_t_o->reg_biz_identity_ou="可不填";
$invoice_d_t_o->seller_name="销方名称";
$invoice_d_t_o->reg_user="登记人";
$invoice_d_t_o->seller_code="可不填";
$invoice_d_t_o->purchaser_country_code="CN";
$invoice_d_t_o->currency="CNY";
$invoice_d_t_o->issued_tax_no="代开单位税号";
$invoice_d_t_o->effective_tax_amount="1.00";
$invoice_d_t_o->purchaser_contact_info="可不填";
$invoice_d_t_o->amount="发票总金额";
$invoice_d_t_o->seller_region_code="可不填";
$line_list = new RegisterInvoiceLineDTO;
$line_list->row_no="1";
$line_list->invoice_line_type="NORMAL,DISCOUNT,DISCOUNTED";
$line_list->quantity_unit="单位";
$line_list->goods_source_country="货物来源国";
$line_list->tax_category2="税种2";
$line_list->duty_free_memo="免税注释";
$line_list->exchange_rate="汇率";
$line_list->local_currency_tax_amount2="本币税额2";
$line_list->local_currency_tax_amount1="本币税额1";
$line_list->model="规格型号";
$line_list->currency="币种";
$line_list->tax_categories="税种";
$line_list->tax_rate2="税率2";
$line_list->goods_desc="货物名称";
$line_list->place_of_supply="供货地点";
$line_list->unit_price="单价";
$line_list->amount="含税金额";
$line_list->local_currency_tax_amount="本币税额";
$line_list->quantity="数量";
$line_list->local_currency_excluding_tax_amount="本币不含税金额";
$line_list->local_currency_amount="本币含税总金额";
$line_list->tax_amount1="税额1";
$line_list->tax_amount2="税额2";
$line_list->local_currency_code="本币币种";
$line_list->supply_date="2019-07-23 10:00:00";
$line_list->service_accounting_code="服务核算代码";
$line_list->tax_rate="税率";
$line_list->reverse_charge="是否海外发票";
$line_list->local_currency_price="本币单价";
$line_list->zero_rate_flag="零税率类型";
$line_list->tax_amount="税额";
$line_list->excluding_tax_amount="不含税金额";
$invoice_d_t_o->line_list = $line_list;
$invoice_d_t_o->invoice_date="2019-07-23 10:00:00";
$invoice_d_t_o->invoice_material="PAPER/ELECTRONIC";
$invoice_d_t_o->seller_contact_info="销方地址及电话";
$invoice_d_t_o->authorized_dealer="是否海外某些国家的发票使用";
$invoice_d_t_o->reg_biz_identity_id="1";
$invoice_d_t_o->reg_biz_identity_code="可不填";
$invoice_d_t_o->waybill_no="运单号";
$invoice_d_t_o->invoice_type_code="VAT_COMM";
$invoice_register_request->invoice_d_t_o = $invoice_d_t_o;
$invoice_register_request->request_no="要求在业务系统内部唯一";
$invoice_register_request->platform_code="业务平台代码【必填】";
$req->setInvoiceRegisterRequest(json_encode($invoice_register_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=alibaba.cfo.incoming.invoice.register' \
-d 'partner_id=apidoc' \
-d 'sign=34FF4ED05C4DBD8136D9243A86D1136D' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-23+11%3A33%3A13' \
-d 'v=2.0' \
-d 'invoice_register_request=null'

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

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

req.invoice_register_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,"alibaba.cfo.incoming.invoice.register");
add_param(pRequest,"invoice_register_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',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('alibaba.cfo.incoming.invoice.register', {
	'invoice_register_request':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_cfo_incoming_invoice_register_response>
    <data>12345</data>
    <succeeded>true</succeeded>
    <response_code>0000</response_code>
    <response_msg>success</response_msg>
</alibaba_cfo_incoming_invoice_register_response>

{
    "alibaba_cfo_incoming_invoice_register_response":{
        "data":12345,
        "succeeded":true,
        "response_code":"0000",
        "response_msg":"success"
    }
}

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.cfo.incoming.invoice.register (发票登记接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ