淘宝开放平台

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
bureau_ledger_invoice_request	BureauLedgerInvoiceRequest	可选			请求体
└ e_ticket_itinerary String 可选电子票据行程单电子票据行程单 └ e_ticket_train String 可选电子票据火车票电子票据火车票 └ account_type String 可选 1 账户类型 └ amount_with_tax String 可选 23123.2 价税合计 └ amount_without_tax String 可选 23123.2 不含税金额 └ auth_remark String 可选认证备注认证备注 └ auth_status String 可选 1 认证状态 └ auth_style String 可选 1 认证方式 └ auth_tax_period String 可选 202501 认证所属期 └ auth_use String 可选 1 认证用途 └ biz_order_no String 可选业务订单号业务订单号 └ business_tag String 可选 1 业务标签 └ buyer_address_tel String 可选购买方地址及电话购买方地址及电话 └ buyer_bank_account String 可选购买方银行账号购买方银行账号 └ buyer_bank_info String 可选购买方开户行及账号购买方开户行及账号 └ buyer_bank_name String 可选购买方开户行名称购买方开户行名称 └ buyer_name String 可选购买方名称购买方名称 └ buyer_tax_no String 可选购买方纳税人识别号购买方纳税人识别号 └ buyer_tenant_code String 可选买方租户编码买方租户编码 └ cancl_check_time Date 可选 2025-01-10 11:04:23 取消查验时间 └ check_code String 可选校验码校验码 └ check_time Date 可选 2025-01-10 11:04:23 查验时间 └ check_user_name String 可选审核用户名审核用户名 └ cipher_mediumtext String 可选密文区密文区 └ create_time Date 可选 2025-01-10 11:04:23 创建时间 └ customer_no String 可选客户编号客户编号 └ data_source String 可选数据源数据源 └ date_issued Date 可选 2025-01-10 11:04:23 开票日期 details BureauLedgerInvoiceLineRequest [] 可选 [] 发票明细 └ amount_with_tax String 可选 123.2 含税金额 └ amount_without_tax String 可选 123.2 不含税金额 └ deduction String 可选 123.2 扣除额 └ goods_tax_no String 可选税收分类编码税收分类编码 └ goods_tax_no_version String 可选 1 编码版本号 └ item_code String 可选项目代码项目代码 └ item_name String 可选项目名称项目名称 └ quantity String 可选 1 数量 └ specifications String 可选规格型号规格型号 └ tax_amount String 可选 12.2 税额 └ tax_pre String 可选 1 是否享受税收优惠政策 └ tax_pre_con String 可选享受税收优惠政策内容享受税收优惠政策内容 └ tax_rate String 可选 0.06 税率 └ toll_end_date Date 可选 2025-01-10 11:04:23 通行日期止 └ toll_start_date Date 可选 2025-01-10 11:04:23 通行日期起 └ unit String 可选 1 数量单位 └ unit_price String 可选 1 单价 └ zero_tax String 可选 1 零税率标志 └ effective_tax_amount String 可选 12.1 有效税额 └ el_confirm_date Date 可选 2025-01-10 11:04:23 电子确认日期 └ el_sync_flag String 可选 1 电子同步标志 └ el_sync_time Date 可选 2025-01-10 11:04:23 电子同步时间 └ entry_status String 可选 1 录入状态 └ entry_time Date 可选 2025-01-10 11:04:23 录入时间 └ entry_user_name String 可选录入用户名录入用户名 └ exist_flag String 可选 1 存在标志 └ extended_attrs String 可选扩展属性扩展属性 └ function_group String 可选功能组功能组 └ function_group_way String 可选 1 功能组方式 └ invoice_code String 可选发票代码发票代码 └ invoice_color String 可选 1 发票颜色 └ invoice_no String 可选 1234 发票号码 └ invoice_no_compliance String 可选发票号码合规性发票号码合规性 └ invoice_source String 可选 1 发票来源 └ invoice_style_type String 可选 1 发票样式类型 └ invoice_type String 可选 1 发票类型 └ issuer String 可选开票人开票人 └ machine_code String 可选机器码机器码 └ match_amount String 可选 123.2 匹配金额 └ match_status String 可选 1 匹配状态 └ match_time Date 可选 2025-01-10 11:04:23 匹配时间 └ no_auth_reason String 可选未认证原因未认证原因 └ ofd_url String 可选 OFD文件URL OFD文件URL └ original_invoice_code String 可选原发票代码原发票代码 └ original_invoice_no String 可选原发票号码原发票号码 └ payee String 可选收款人收款人 └ pdf_url String 可选 PDF文件URL PDF文件URL └ red_letter_number String 可选红字发票编号红字发票编号 └ remark String 可选备注备注 └ retreat_remark String 可选撤回备注撤回备注 └ retreat_status String 可选 1 撤回状态 └ retreat_time Date 可选 2025-01-10 11:04:23 撤回时间 └ reverse_amount_with_tax String 可选 123 红冲价税合计 └ reverse_amount_without_tax String 可选 123 红冲不含税金额 └ reverse_flag String 可选 1 是否红冲标志 └ reverse_list String 可选红冲列表红冲列表 └ reverse_tax_amount String 可选 123 红冲税额 └ reverse_time Date 可选 2025-01-10 11:04:23 红冲时间 └ reviewer String 可选复核人复核人 └ risk_category_type String 可选 1 风险分类类型 └ risk_status String 可选 1 风险状态 └ sale_list_file_flag Number 可选 1 销货清单文件标志 └ seller_address String 可选销售方地址销售方地址 └ seller_address_tel String 可选销售方地址及电话销售方地址及电话 └ seller_bank_account String 可选销售方开户行及账号销售方开户行及账号 └ seller_bank_info String 可选销售方开银行信息销售方开银行信息 └ seller_bank_name String 可选销售方开户行名称销售方开户行名称 └ seller_name String 可选销售方名称销售方名称 └ seller_tax_no String 可选销售方纳税人识别号销售方纳税人识别号 └ seller_tel String 可选销售方电话销售方电话 └ seller_tenant_code String 可选卖方租户编码卖方租户编码 └ send_time Number 可选 1231231 发送时间（票易通侧） └ source String 可选 1 来源 └ special_additions String 可选特别附加项特别附加项 └ special_type String 可选 1 特殊类型 └ status String 可选 1 状态 └ tax_amount String 可选 212 税额 └ tax_invoice_source String 可选 1 税控发票来源 └ tax_rate String 可选 1 税率 └ tenant_code String 可选租户编码租户编码 └ transfer_status String 可选 1 转交状态 └ update_time Date 可选 2025-01-10 11:04:23 更新时间 └ verify_status String 可选 1 验证状态 └ verify_user_name String 可选验证用户名验证用户名 └ xml_url String 可选验证用户名 XML文件URL

名称	类型	示例值	描述
result	Response		返回响应
└ data Boolean true 返回值 └ response_code String true 是否成功 └ response_msg String 000 错误码 └ succeeded String 错误信息错误信息

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaCfoIncomingInvoiceLedgerPytSyncRequest req = new AlibabaCfoIncomingInvoiceLedgerPytSyncRequest();
AlibabaCfoIncomingInvoiceLedgerPytSyncRequest.BureauLedgerInvoiceRequest obj1 = new AlibabaCfoIncomingInvoiceLedgerPytSyncRequest.BureauLedgerInvoiceRequest();
obj1.setETicketItinerary("电子票据行程单");
obj1.setETicketTrain("电子票据火车票");
obj1.setAccountType("1");
obj1.setAmountWithTax("23123.2");
obj1.setAmountWithoutTax("23123.2");
obj1.setAuthRemark("认证备注");
obj1.setAuthStatus("1");
obj1.setAuthStyle("1");
obj1.setAuthTaxPeriod("202501");
obj1.setAuthUse("1");
obj1.setBizOrderNo("业务订单号");
obj1.setBusinessTag("1");
obj1.setBuyerAddressTel("购买方地址及电话");
obj1.setBuyerBankAccount("购买方银行账号");
obj1.setBuyerBankInfo("购买方开户行及账号");
obj1.setBuyerBankName("购买方开户行名称");
obj1.setBuyerName("购买方名称");
obj1.setBuyerTaxNo("购买方纳税人识别号");
obj1.setBuyerTenantCode("买方租户编码");
obj1.setCanclCheckTime(StringUtils.parseDateTime("2025-01-10 11:04:23"));
obj1.setCheckCode("校验码");
obj1.setCheckTime(StringUtils.parseDateTime("2025-01-10 11:04:23"));
obj1.setCheckUserName("审核用户名");
obj1.setCipherMediumtext("密文区");
obj1.setCreateTime(StringUtils.parseDateTime("2025-01-10 11:04:23"));
obj1.setCustomerNo("客户编号");
obj1.setDataSource("数据源");
obj1.setDateIssued(StringUtils.parseDateTime("2025-01-10 11:04:23"));
List<AlibabaCfoIncomingInvoiceLedgerPytSyncRequest.BureauLedgerInvoiceLineRequest> list3 = new ArrayList<AlibabaCfoIncomingInvoiceLedgerPytSyncRequest.BureauLedgerInvoiceLineRequest>();
AlibabaCfoIncomingInvoiceLedgerPytSyncRequest.BureauLedgerInvoiceLineRequest obj4 = new AlibabaCfoIncomingInvoiceLedgerPytSyncRequest.BureauLedgerInvoiceLineRequest();
list3.add(obj4);
obj4.setAmountWithTax("123.2");
obj4.setAmountWithoutTax("123.2");
obj4.setDeduction("123.2");
obj4.setGoodsTaxNo("税收分类编码");
obj4.setGoodsTaxNoVersion("1");
obj4.setItemCode("项目代码");
obj4.setItemName("项目名称");
obj4.setQuantity("1");
obj4.setSpecifications("规格型号");
obj4.setTaxAmount("12.2");
obj4.setTaxPre("1");
obj4.setTaxPreCon("享受税收优惠政策内容");
obj4.setTaxRate("0.06");
obj4.setTollEndDate(StringUtils.parseDateTime("2025-01-10 11:04:23"));
obj4.setTollStartDate(StringUtils.parseDateTime("2025-01-10 11:04:23"));
obj4.setUnit("1");
obj4.setUnitPrice("1");
obj4.setZeroTax("1");
obj1.setDetails(list3);
obj1.setEffectiveTaxAmount("12.1");
obj1.setElConfirmDate(StringUtils.parseDateTime("2025-01-10 11:04:23"));
obj1.setElSyncFlag("1");
obj1.setElSyncTime(StringUtils.parseDateTime("2025-01-10 11:04:23"));
obj1.setEntryStatus("1");
obj1.setEntryTime(StringUtils.parseDateTime("2025-01-10 11:04:23"));
obj1.setEntryUserName("录入用户名");
obj1.setExistFlag("1");
obj1.setExtendedAttrs("扩展属性");
obj1.setFunctionGroup("功能组");
obj1.setFunctionGroupWay("1");
obj1.setInvoiceCode("发票代码");
obj1.setInvoiceColor("1");
obj1.setInvoiceNo("1234");
obj1.setInvoiceNoCompliance("发票号码合规性");
obj1.setInvoiceSource("1");
obj1.setInvoiceStyleType("1");
obj1.setInvoiceType("1");
obj1.setIssuer("开票人");
obj1.setMachineCode("机器码");
obj1.setMatchAmount("123.2");
obj1.setMatchStatus("1");
obj1.setMatchTime(StringUtils.parseDateTime("2025-01-10 11:04:23"));
obj1.setNoAuthReason("未认证原因");
obj1.setOfdUrl("OFD文件URL");
obj1.setOriginalInvoiceCode("原发票代码");
obj1.setOriginalInvoiceNo("原发票号码");
obj1.setPayee("收款人");
obj1.setPdfUrl("PDF文件URL");
obj1.setRedLetterNumber("红字发票编号");
obj1.setRemark("备注");
obj1.setRetreatRemark("撤回备注");
obj1.setRetreatStatus("1");
obj1.setRetreatTime(StringUtils.parseDateTime("2025-01-10 11:04:23"));
obj1.setReverseAmountWithTax("123");
obj1.setReverseAmountWithoutTax("123");
obj1.setReverseFlag("1");
obj1.setReverseList("红冲列表");
obj1.setReverseTaxAmount("123");
obj1.setReverseTime(StringUtils.parseDateTime("2025-01-10 11:04:23"));
obj1.setReviewer("复核人");
obj1.setRiskCategoryType("1");
obj1.setRiskStatus("1");
obj1.setSaleListFileFlag(1L);
obj1.setSellerAddress("销售方地址");
obj1.setSellerAddressTel("销售方地址及电话");
obj1.setSellerBankAccount("销售方开户行及账号");
obj1.setSellerBankInfo("销售方开银行信息");
obj1.setSellerBankName("销售方开户行名称");
obj1.setSellerName("销售方名称");
obj1.setSellerTaxNo("销售方纳税人识别号");
obj1.setSellerTel("销售方电话");
obj1.setSellerTenantCode("卖方租户编码");
obj1.setSendTime(1231231L);
obj1.setSource("1");
obj1.setSpecialAdditions("特别附加项");
obj1.setSpecialType("1");
obj1.setStatus("1");
obj1.setTaxAmount("212");
obj1.setTaxInvoiceSource("1");
obj1.setTaxRate("1");
obj1.setTenantCode("租户编码");
obj1.setTransferStatus("1");
obj1.setUpdateTime(StringUtils.parseDateTime("2025-01-10 11:04:23"));
obj1.setVerifyStatus("1");
obj1.setVerifyUserName("验证用户名");
obj1.setXmlUrl("验证用户名");
req.setBureauLedgerInvoiceRequest(obj1);
AlibabaCfoIncomingInvoiceLedgerPytSyncResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaCfoIncomingInvoiceLedgerPytSyncRequest req = new AlibabaCfoIncomingInvoiceLedgerPytSyncRequest();
AlibabaCfoIncomingInvoiceLedgerPytSyncRequest.BureauLedgerInvoiceRequestDomain obj1 = new AlibabaCfoIncomingInvoiceLedgerPytSyncRequest.BureauLedgerInvoiceRequestDomain();
obj1.ETicketItinerary = "电子票据行程单";
obj1.ETicketTrain = "电子票据火车票";
obj1.AccountType = "1";
obj1.AmountWithTax = "23123.2";
obj1.AmountWithoutTax = "23123.2";
obj1.AuthRemark = "认证备注";
obj1.AuthStatus = "1";
obj1.AuthStyle = "1";
obj1.AuthTaxPeriod = "202501";
obj1.AuthUse = "1";
obj1.BizOrderNo = "业务订单号";
obj1.BusinessTag = "1";
obj1.BuyerAddressTel = "购买方地址及电话";
obj1.BuyerBankAccount = "购买方银行账号";
obj1.BuyerBankInfo = "购买方开户行及账号";
obj1.BuyerBankName = "购买方开户行名称";
obj1.BuyerName = "购买方名称";
obj1.BuyerTaxNo = "购买方纳税人识别号";
obj1.BuyerTenantCode = "买方租户编码";
obj1.CanclCheckTime = DateTime.Parse(2025-01-10 11:04:23");
obj1.CheckCode = "校验码";
obj1.CheckTime = DateTime.Parse(2025-01-10 11:04:23");
obj1.CheckUserName = "审核用户名";
obj1.CipherMediumtext = "密文区";
obj1.CreateTime = DateTime.Parse(2025-01-10 11:04:23");
obj1.CustomerNo = "客户编号";
obj1.DataSource = "数据源";
obj1.DateIssued = DateTime.Parse(2025-01-10 11:04:23");
List<AlibabaCfoIncomingInvoiceLedgerPytSyncRequest.BureauLedgerInvoiceLineRequestDomain> list3 = new List<AlibabaCfoIncomingInvoiceLedgerPytSyncRequest.BureauLedgerInvoiceLineRequestDomain>();
AlibabaCfoIncomingInvoiceLedgerPytSyncRequest.BureauLedgerInvoiceLineRequestDomain obj4 = new AlibabaCfoIncomingInvoiceLedgerPytSyncRequest.BureauLedgerInvoiceLineRequestDomain();
list3.Add(obj4);
obj4.AmountWithTax = "123.2";
obj4.AmountWithoutTax = "123.2";
obj4.Deduction = "123.2";
obj4.GoodsTaxNo = "税收分类编码";
obj4.GoodsTaxNoVersion = "1";
obj4.ItemCode = "项目代码";
obj4.ItemName = "项目名称";
obj4.Quantity = "1";
obj4.Specifications = "规格型号";
obj4.TaxAmount = "12.2";
obj4.TaxPre = "1";
obj4.TaxPreCon = "享受税收优惠政策内容";
obj4.TaxRate = "0.06";
obj4.TollEndDate = DateTime.Parse(2025-01-10 11:04:23");
obj4.TollStartDate = DateTime.Parse(2025-01-10 11:04:23");
obj4.Unit = "1";
obj4.UnitPrice = "1";
obj4.ZeroTax = "1";
obj1.Details= list3;
obj1.EffectiveTaxAmount = "12.1";
obj1.ElConfirmDate = DateTime.Parse(2025-01-10 11:04:23");
obj1.ElSyncFlag = "1";
obj1.ElSyncTime = DateTime.Parse(2025-01-10 11:04:23");
obj1.EntryStatus = "1";
obj1.EntryTime = DateTime.Parse(2025-01-10 11:04:23");
obj1.EntryUserName = "录入用户名";
obj1.ExistFlag = "1";
obj1.ExtendedAttrs = "扩展属性";
obj1.FunctionGroup = "功能组";
obj1.FunctionGroupWay = "1";
obj1.InvoiceCode = "发票代码";
obj1.InvoiceColor = "1";
obj1.InvoiceNo = "1234";
obj1.InvoiceNoCompliance = "发票号码合规性";
obj1.InvoiceSource = "1";
obj1.InvoiceStyleType = "1";
obj1.InvoiceType = "1";
obj1.Issuer = "开票人";
obj1.MachineCode = "机器码";
obj1.MatchAmount = "123.2";
obj1.MatchStatus = "1";
obj1.MatchTime = DateTime.Parse(2025-01-10 11:04:23");
obj1.NoAuthReason = "未认证原因";
obj1.OfdUrl = "OFD文件URL";
obj1.OriginalInvoiceCode = "原发票代码";
obj1.OriginalInvoiceNo = "原发票号码";
obj1.Payee = "收款人";
obj1.PdfUrl = "PDF文件URL";
obj1.RedLetterNumber = "红字发票编号";
obj1.Remark = "备注";
obj1.RetreatRemark = "撤回备注";
obj1.RetreatStatus = "1";
obj1.RetreatTime = DateTime.Parse(2025-01-10 11:04:23");
obj1.ReverseAmountWithTax = "123";
obj1.ReverseAmountWithoutTax = "123";
obj1.ReverseFlag = "1";
obj1.ReverseList = "红冲列表";
obj1.ReverseTaxAmount = "123";
obj1.ReverseTime = DateTime.Parse(2025-01-10 11:04:23");
obj1.Reviewer = "复核人";
obj1.RiskCategoryType = "1";
obj1.RiskStatus = "1";
obj1.SaleListFileFlag = 1L;
obj1.SellerAddress = "销售方地址";
obj1.SellerAddressTel = "销售方地址及电话";
obj1.SellerBankAccount = "销售方开户行及账号";
obj1.SellerBankInfo = "销售方开银行信息";
obj1.SellerBankName = "销售方开户行名称";
obj1.SellerName = "销售方名称";
obj1.SellerTaxNo = "销售方纳税人识别号";
obj1.SellerTel = "销售方电话";
obj1.SellerTenantCode = "卖方租户编码";
obj1.SendTime = 1231231L;
obj1.Source = "1";
obj1.SpecialAdditions = "特别附加项";
obj1.SpecialType = "1";
obj1.Status = "1";
obj1.TaxAmount = "212";
obj1.TaxInvoiceSource = "1";
obj1.TaxRate = "1";
obj1.TenantCode = "租户编码";
obj1.TransferStatus = "1";
obj1.UpdateTime = DateTime.Parse(2025-01-10 11:04:23");
obj1.VerifyStatus = "1";
obj1.VerifyUserName = "验证用户名";
obj1.XmlUrl = "验证用户名";
req.BureauLedgerInvoiceRequest_ = obj1;
AlibabaCfoIncomingInvoiceLedgerPytSyncResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaCfoIncomingInvoiceLedgerPytSyncRequest;
$bureau_ledger_invoice_request = new BureauLedgerInvoiceRequest;
$bureau_ledger_invoice_request->e_ticket_itinerary="电子票据行程单";
$bureau_ledger_invoice_request->e_ticket_train="电子票据火车票";
$bureau_ledger_invoice_request->account_type="1";
$bureau_ledger_invoice_request->amount_with_tax="23123.2";
$bureau_ledger_invoice_request->amount_without_tax="23123.2";
$bureau_ledger_invoice_request->auth_remark="认证备注";
$bureau_ledger_invoice_request->auth_status="1";
$bureau_ledger_invoice_request->auth_style="1";
$bureau_ledger_invoice_request->auth_tax_period="202501";
$bureau_ledger_invoice_request->auth_use="1";
$bureau_ledger_invoice_request->biz_order_no="业务订单号";
$bureau_ledger_invoice_request->business_tag="1";
$bureau_ledger_invoice_request->buyer_address_tel="购买方地址及电话";
$bureau_ledger_invoice_request->buyer_bank_account="购买方银行账号";
$bureau_ledger_invoice_request->buyer_bank_info="购买方开户行及账号";
$bureau_ledger_invoice_request->buyer_bank_name="购买方开户行名称";
$bureau_ledger_invoice_request->buyer_name="购买方名称";
$bureau_ledger_invoice_request->buyer_tax_no="购买方纳税人识别号";
$bureau_ledger_invoice_request->buyer_tenant_code="买方租户编码";
$bureau_ledger_invoice_request->cancl_check_time="2025-01-10 11:04:23";
$bureau_ledger_invoice_request->check_code="校验码";
$bureau_ledger_invoice_request->check_time="2025-01-10 11:04:23";
$bureau_ledger_invoice_request->check_user_name="审核用户名";
$bureau_ledger_invoice_request->cipher_mediumtext="密文区";
$bureau_ledger_invoice_request->create_time="2025-01-10 11:04:23";
$bureau_ledger_invoice_request->customer_no="客户编号";
$bureau_ledger_invoice_request->data_source="数据源";
$bureau_ledger_invoice_request->date_issued="2025-01-10 11:04:23";
$details = new BureauLedgerInvoiceLineRequest;
$details->amount_with_tax="123.2";
$details->amount_without_tax="123.2";
$details->deduction="123.2";
$details->goods_tax_no="税收分类编码";
$details->goods_tax_no_version="1";
$details->item_code="项目代码";
$details->item_name="项目名称";
$details->quantity="1";
$details->specifications="规格型号";
$details->tax_amount="12.2";
$details->tax_pre="1";
$details->tax_pre_con="享受税收优惠政策内容";
$details->tax_rate="0.06";
$details->toll_end_date="2025-01-10 11:04:23";
$details->toll_start_date="2025-01-10 11:04:23";
$details->unit="1";
$details->unit_price="1";
$details->zero_tax="1";
$bureau_ledger_invoice_request->details = $details;
$bureau_ledger_invoice_request->effective_tax_amount="12.1";
$bureau_ledger_invoice_request->el_confirm_date="2025-01-10 11:04:23";
$bureau_ledger_invoice_request->el_sync_flag="1";
$bureau_ledger_invoice_request->el_sync_time="2025-01-10 11:04:23";
$bureau_ledger_invoice_request->entry_status="1";
$bureau_ledger_invoice_request->entry_time="2025-01-10 11:04:23";
$bureau_ledger_invoice_request->entry_user_name="录入用户名";
$bureau_ledger_invoice_request->exist_flag="1";
$bureau_ledger_invoice_request->extended_attrs="扩展属性";
$bureau_ledger_invoice_request->function_group="功能组";
$bureau_ledger_invoice_request->function_group_way="1";
$bureau_ledger_invoice_request->invoice_code="发票代码";
$bureau_ledger_invoice_request->invoice_color="1";
$bureau_ledger_invoice_request->invoice_no="1234";
$bureau_ledger_invoice_request->invoice_no_compliance="发票号码合规性";
$bureau_ledger_invoice_request->invoice_source="1";
$bureau_ledger_invoice_request->invoice_style_type="1";
$bureau_ledger_invoice_request->invoice_type="1";
$bureau_ledger_invoice_request->issuer="开票人";
$bureau_ledger_invoice_request->machine_code="机器码";
$bureau_ledger_invoice_request->match_amount="123.2";
$bureau_ledger_invoice_request->match_status="1";
$bureau_ledger_invoice_request->match_time="2025-01-10 11:04:23";
$bureau_ledger_invoice_request->no_auth_reason="未认证原因";
$bureau_ledger_invoice_request->ofd_url="OFD文件URL";
$bureau_ledger_invoice_request->original_invoice_code="原发票代码";
$bureau_ledger_invoice_request->original_invoice_no="原发票号码";
$bureau_ledger_invoice_request->payee="收款人";
$bureau_ledger_invoice_request->pdf_url="PDF文件URL";
$bureau_ledger_invoice_request->red_letter_number="红字发票编号";
$bureau_ledger_invoice_request->remark="备注";
$bureau_ledger_invoice_request->retreat_remark="撤回备注";
$bureau_ledger_invoice_request->retreat_status="1";
$bureau_ledger_invoice_request->retreat_time="2025-01-10 11:04:23";
$bureau_ledger_invoice_request->reverse_amount_with_tax="123";
$bureau_ledger_invoice_request->reverse_amount_without_tax="123";
$bureau_ledger_invoice_request->reverse_flag="1";
$bureau_ledger_invoice_request->reverse_list="红冲列表";
$bureau_ledger_invoice_request->reverse_tax_amount="123";
$bureau_ledger_invoice_request->reverse_time="2025-01-10 11:04:23";
$bureau_ledger_invoice_request->reviewer="复核人";
$bureau_ledger_invoice_request->risk_category_type="1";
$bureau_ledger_invoice_request->risk_status="1";
$bureau_ledger_invoice_request->sale_list_file_flag="1";
$bureau_ledger_invoice_request->seller_address="销售方地址";
$bureau_ledger_invoice_request->seller_address_tel="销售方地址及电话";
$bureau_ledger_invoice_request->seller_bank_account="销售方开户行及账号";
$bureau_ledger_invoice_request->seller_bank_info="销售方开银行信息";
$bureau_ledger_invoice_request->seller_bank_name="销售方开户行名称";
$bureau_ledger_invoice_request->seller_name="销售方名称";
$bureau_ledger_invoice_request->seller_tax_no="销售方纳税人识别号";
$bureau_ledger_invoice_request->seller_tel="销售方电话";
$bureau_ledger_invoice_request->seller_tenant_code="卖方租户编码";
$bureau_ledger_invoice_request->send_time="1231231";
$bureau_ledger_invoice_request->source="1";
$bureau_ledger_invoice_request->special_additions="特别附加项";
$bureau_ledger_invoice_request->special_type="1";
$bureau_ledger_invoice_request->status="1";
$bureau_ledger_invoice_request->tax_amount="212";
$bureau_ledger_invoice_request->tax_invoice_source="1";
$bureau_ledger_invoice_request->tax_rate="1";
$bureau_ledger_invoice_request->tenant_code="租户编码";
$bureau_ledger_invoice_request->transfer_status="1";
$bureau_ledger_invoice_request->update_time="2025-01-10 11:04:23";
$bureau_ledger_invoice_request->verify_status="1";
$bureau_ledger_invoice_request->verify_user_name="验证用户名";
$bureau_ledger_invoice_request->xml_url="验证用户名";
$req->setBureauLedgerInvoiceRequest(json_encode($bureau_ledger_invoice_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.ledger.pyt.sync' \
-d 'partner_id=apidoc' \
-d 'sign=E157EB2878CDF6CE62467C056971317D' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-25+11%3A33%3A58' \
-d 'v=2.0' \
-d 'bureau_ledger_invoice_request=null'

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

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

req.bureau_ledger_invoice_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.ledger.pyt.sync");
add_param(pRequest,"bureau_ledger_invoice_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.ledger.pyt.sync', {
	'bureau_ledger_invoice_request':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_cfo_incoming_invoice_ledger_pyt_sync_response>
    <result>
        <data>true</data>
        <response_code>true</response_code>
        <response_msg>000</response_msg>
        <succeeded>错误信息</succeeded>
    </result>
</alibaba_cfo_incoming_invoice_ledger_pyt_sync_response>

{
    "alibaba_cfo_incoming_invoice_ledger_pyt_sync_response":{
        "result":{
            "data":true,
            "response_code":"true",
            "response_msg":"000",
            "succeeded":"错误信息"
        }
    }
}

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

alibaba.cfo.incoming.invoice.ledger.pyt.sync (票易通数据同步底账数据)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ