获取电子发票开票信息

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

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

1.请求参数:

请求URL:

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

参数名 类型 必须 示例值 说明
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