获取电子发票开票信息
查询消费者(买家)提交的开票申请信息,本接口入参中的apply_id和platform_tid可通过电子发票开票消息->1.16 淘宝电子发票开票申请消息获取。
友情提醒:获取上述开票信息,先要开通消息服务,并开通以下消息事件和接口:
1.淘宝电子发票开票申请消息
2.淘宝获取电子发票开票申请内容
1.请求参数:
请求URL:
参数名 | 类型 | 必须 | 示例值 | 说明 |
---|---|---|---|---|
appid | String | true | uwkahf@jfs92 | 合作伙伴AppId |
timestamp | String | true | 1633618722 | 当前时间戳 |
tb_seller_nick | String | true | kingdo | 淘宝卖家店铺登录账号,非店铺名称 |
sign | String | true | 999de41d862efaa6f1084ead3b3ba480 | 如何计算生成见示例代码 |
apply_id | String | true | 01vHi5FoMzQYnN | 发票申请ID |
platform_tid | String | true | 32324222 | 电商平台对应的订单号 |
2. 请求示例代码(Java)
@Test
public void AlibabaEinvoiceApplyGet() throws Exception {
Map<String, String> data = new HashMap<String, String>();
data.put("appid", Config.AppId);
Long timestamp = System.currentTimeMillis() / 1000;
data.put("timestamp", timestamp.toString());
data.put("tb_seller_nick", Config.TBSellerNick);
data.put("apply_id", "01vHi5FoMzQYnNfl4Uu2H8xOEsMzW5LYO4B_HZSANhC0Y");
data.put("platform_tid", "2178155486795837034");
// 签名
data.put("sign", Utils.Sign(data,Config.AppSecret));
// 调用服务API
doHttpRequest(Config.AlibabaEinvoiceApplyGetUrl ,data);
}
3. 返回结果
返回结果如下
{
"code":0,
"message":"ok",
"data":{
"apply_list":{
"apply":[
{
"business_type":1,
"extend_props":"null",
"gmt_create":"2021-10-25 16:23:53",
"gmt_modified_str":"2021-10-25 16:23:53",
"invoice_amount":"-35.00",
"invoice_items":{
"invoice_item":[
{
"amount":"-35.00",
"biz_order_id":"2178155486795837034",
"is_post_fee_row":false,
"item_name":"跳跳球儿童玩具大人弹跳球跳跳板幼儿园平衡蹦蹦球弹力球",
"price":"75.000000",
"quantity":"-1",
"row_type":"0",
"specification":"T0691"
}
]
},
"invoice_kind":1,
"invoice_type":"red",
"payer_address":"重庆市长寿区菩提街道桃花大道xx号x栋",
"payer_bank":"农业银行重庆长寿黄桷湾支行",
"payer_bankaccount":"311317010xxxxxxx",
"payer_name":"重庆金悦化工有限公司",
"payer_phone":"023407970xx",
"payer_register_no":"91500115MA5UTA0xxx",
"platform_code":"TM",
"platform_tid":"2178155486795837034",
"trigger_status":"refund_seller_confirm"
}
]
},
"is_success":true,
"request_id":"5u0kvey57n"
},
"trace_id":""
}
说明: code为0表示成功,非0为失败,message会包含失败原因。
4 返回参数说明
参数接口 | 参数类型 | 例子 | 说明 |
---|---|---|---|
business_type | LONG | 抬头类型,0=个人,1=企业 | |
invoice_amount | STRING | 开票金额 | |
invoice_kind | LONG | 发票种类,0=电子发票,1=纸质发票,2=纸质专票 | |
invoice_type | STRING | 发票类型,blue=蓝票,red=红票 | |
payer_address | STRING | 购买方企业地址,erp开票不返回,用来erp获取自动开票结果 | |
payer_bank | STRING | 购买方企业银行,erp开票不返回,用来erp获取自动开票结果 | |
payer_bankaccount | STRING | 购买方企业银行账号,erp开票不返回,用来erp获取自动开票结果 | |
payer_name | STRING | 购买方抬头 | |
payer_phone | STRING | 购买方企业电话 | |
payer_register_no | STRING | 购买方企业税号 | |
platform_code | STRING | 电商平台代码,TB,TM,ALIPAY,JD | |
platform_tid | STRING | 电商平台订单号 | |
trigger_status | STRING | 开票申请的触发类型,buyer_payed=卖家已付款,sent_goods=卖家已发货,buyer_confirm=买家确认收货,refund_seller_confirm=卖家同意退款,invoice_supply=买家申请补开发票,invoice_change=买家申请改抬头,change_paper=电换纸 | |
invoice_items | [] | 开票明细 | |
- amount | STRING | 开票金额 | |
- biz_order_id | STRING | 淘宝子订单号,阿里发票平台自动开票时才有 | |
- is_post_fee_row | BOOLEAN | false | 是否为运费行,,阿里发票平台自动开票时才有 |
- item_name | STRING | false | 发票项目名称(或商品名称) |
- price | STRING | false | 单价,格式:100.00(不含税) |
- quantity | STRING | false | 数量 |
- row_type | STRING | false | 发票行性质。0表示正常行,1表示折扣行,2表示被折扣行。比如充电器单价100元,折扣10元,则明细为2行,充电器行性质为2,折扣行性质为1。如果充电器没有折扣,则值应为0 |
- specification | STRING | false | 规格型号 |
文档更新时间: 2023-03-14 16:44 作者:admin