跳转到内容
Cheeli 文档
返回官网

获取电子发票开票信息

查询消费者（买家）提交的开票申请信息，本接口入参中的apply_id和platform_tid可通过电子发票开票消息->1.16 淘宝电子发票开票申请消息获取。

友情提醒：获取上述开票信息，先要开通消息服务，并开通以下消息事件和接口： 1.淘宝电子发票开票申请消息 2.淘宝获取电子发票开票申请内容

一、请求参数

请求URL:

POST https://kf.fw199.com/gateway/taobao/einvoice/apply/get

参数名类型必须示例值说明
appidStringtrueuwkahf@jfs92合作伙伴AppId
timestampStringtrue1633618722当前时间戳
tb_seller_nickStringtruekingdo淘宝卖家店铺登录账号，非店铺名称
signStringtrue999de41d862efaa6f1084ead3b3ba480如何计算生成见示例代码
apply_idStringtrue01vHi5FoMzQYnN发票申请ID
platform_tidStringtrue32324222电商平台对应的订单号

二、请求示例代码

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);


    }

三、返回结果

返回结果如下

{
    "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会包含失败原因。

四、返回参数说明

参数接口参数类型例子说明
business_typeLONG抬头类型，0=个人，1=企业
invoice_amountSTRING开票金额
invoice_kindLONG发票种类，0=电子发票，1=纸质发票，2=纸质专票
invoice_typeSTRING发票类型，blue=蓝票，red=红票
payer_addressSTRING购买方企业地址，erp开票不返回，用来erp获取自动开票结果
payer_bankSTRING购买方企业银行，erp开票不返回，用来erp获取自动开票结果
payer_bankaccountSTRING购买方企业银行账号，erp开票不返回，用来erp获取自动开票结果
payer_nameSTRING购买方抬头
payer_phoneSTRING购买方企业电话
payer_register_noSTRING购买方企业税号
platform_codeSTRING电商平台代码,TB,TM,ALIPAY,JD
platform_tidSTRING电商平台订单号
trigger_statusSTRING开票申请的触发类型，buyer_payed=卖家已付款，sent_goods=卖家已发货，buyer_confirm=买家确认收货，refund_seller_confirm=卖家同意退款，invoice_supply=买家申请补开发票，invoice_change=买家申请改抬头，change_paper=电换纸
invoice_items[]开票明细
- amountSTRING开票金额
- biz_order_idSTRING淘宝子订单号，阿里发票平台自动开票时才有
- is_post_fee_rowBOOLEANfalse是否为运费行，，阿里发票平台自动开票时才有
- item_nameSTRINGfalse发票项目名称（或商品名称）
- priceSTRINGfalse单价，格式：100.00(不含税)
- quantitySTRINGfalse数量
- row_typeSTRINGfalse发票行性质。0表示正常行，1表示折扣行，2表示被折扣行。比如充电器单价100元，折扣10元，则明细为2行，充电器行性质为2，折扣行性质为1。如果充电器没有折扣，则值应为0
- specificationSTRINGfalse规格型号