淘宝开放平台

登录
文档中心 > API类目 > 电子发票

电子发票

alibaba.einvoice.create.result.get (ERP开票结果获取)

ERP开票结果获取

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
payee_register_no String 必须 123123123123 收款方税务登记证号
platform_code String 可选 tmall 电商平台代码。淘宝：taobao，天猫：tmall
platform_tid String 可选 12132 电商平台对应的订单号
serial_no String 可选 3123123123 流水号 (serial_no)和(platform_code,platform_tid)必须填写其中一组,serial_no优先级更高
out_shop_name String 可选 电子发票旗舰店 外部平台店铺名称，需要在阿里发票平台配置，只有当platform_code不为TB和TM时，这个字段才生效。注意：后台配置的店铺平台必须和入参platform_code一致

响应参数

名称 类型 示例值 描述
invoice_result_list InvoiceResult [] 开票返回结果数据列表
  • └ anti_fake_code
  • String
  • CF6B2F6168420008
  • 防伪码
  • └ ciphertext
  • String
  • demosdffsd-32432
  • 发票密文，密码区的字符串
  • └ device_no
  • String
  • sw1231
  • 税控设备编号(新版电子发票有)
  • └ erp_tid
  • String
  • 123123
  • erp自定义单据号
  • └ file_data_type
  • String
  • jpg
  • 文件类型(pdf,jpg,png)
  • └ file_path
  • String
  • demo
  • 发票PDF的下载地址(仅在单个查询接口上显示，批量查询不显示)
  • └ invoice_amount
  • String
  • 1232.00
  • 开票金额
  • └ invoice_code
  • String
  • 1231231234
  • 发票代码
  • └ invoice_date
  • String
  • 2014-4-21
  • 开票日期
  • └ invoice_no
  • String
  • 123123
  • 发票号码
  • └ platform_code
  • String
  • tmall
  • 电商平台代码。淘宝：taobao，天猫：tmall
  • └ platform_tid
  • String
  • 123123
  • 电商平台订单号
  • └ serial_no
  • String
  • 123123
  • 开票流水号，唯一标志开票请求。如果两次请求流水号相同，则表示重复请求。
  • └ status
  • String
  • waiting
  • 开票状态 (waiting = 开票中) 、(create_success = 开票成功)、(create_failed = 开票失败)
  • └ biz_error_code
  • String
  • demo
  • 错误编码
  • └ biz_error_msg
  • String
  • demo
  • 错误信息
  • invoice_items
  • InvoiceItem []
  • 电子发票明细，erp开票默认不返回，如果erp需要获取阿里发票平台自动开票的结果，需要先找阿里小二开通权限
  • └ unit
  • String
  • 台
  • 单位
  • └ sum_price
  • String
  • 1000.00
  • 总价，格式：100.00(不含税)
  • └ tax
  • String
  • 170.00
  • 税额
  • └ price
  • String
  • 100.00
  • 单价，格式：100.00(不含税)
  • └ item_no
  • String
  • 123456
  • 税收分类编码
  • └ item_name
  • String
  • 电视机
  • 发票项目名称（或商品名称）
  • └ specification
  • String
  • X100
  • 规格型号,可选
  • └ quantity
  • String
  • 10
  • 数量
  • └ tax_rate
  • String
  • 0.17
  • 税率。税率只能为0或0.03或0.04或0.06或0.11或0.13或0.17
  • └ row_type
  • String
  • 0
  • 发票行性质。0表示正常行，1表示折扣行，2表示被折扣行。比如充电器单价100元，折扣10元，则明细为2行，充电器行性质为2，折扣行性质为1。如果充电器没有折扣，则值应为0
  • └ amount
  • String
  • 1170.00
  • 价税合计。(等于sumPrice和tax之和)
  • └ zero_rate_flag
  • String
  • 0
  • 0税率标识，0=出口零税率，1=免税，2=不征收，3=普通零税率
  • └ outer_id
  • String
  • 281347
  • 商品的外部系统id，如果有sku则取sku的outerId，否则取item的outerId，，阿里发票平台自动开票时才有
  • └ biz_order_id
  • String
  • 20293843539452
  • 淘宝子订单号，阿里发票平台自动开票时才有
  • └ is_post_fee_row
  • Boolean
  • false
  • 是否为运费行，，阿里发票平台自动开票时才有
  • └ invoice_type
  • String
  • blud
  • 发票类型，blue=蓝票，red=红票
  • └ invoice_kind
  • Number
  • 0
  • 发票种类，0=电子发票，1=纸质发票，2=纸质专票
  • └ normal_invoice_code
  • String
  • 110293843838
  • 原蓝票发票代码，invoiceType=red时有值
  • └ normal_invoice_no
  • String
  • 28371928
  • 原蓝票发票号码，invoiceType=red时有值
  • └ payee_operator
  • String
  • 张三
  • 开票人，erp开票不返回，用来erp获取自动开票结果
  • └ payee_receiver
  • String
  • 李四
  • 收款人，erp开票不返回，用来erp获取自动开票结果
  • └ payee_checker
  • String
  • 王五
  • 复核人，erp开票不返回，用来erp获取自动开票结果
  • └ payer_name
  • String
  • 张三
  • 购买方抬头，erp开票不返回，用来erp获取自动开票结果
  • └ payer_register_no
  • String
  • 9128324928723P837
  • 购买方税号，erp开票不返回，用来erp获取自动开票结果
  • └ payer_phone
  • String
  • 010-29384
  • 购买方企业电话，erp开票不返回，用来erp获取自动开票结果
  • └ payer_address
  • String
  • 杭州市文一西路969号
  • 购买方企业地址，erp开票不返回，用来erp获取自动开票结果
  • └ payer_bankaccount
  • String
  • 网商银行 28239824323
  • 购买方企业银行及账号，erp开票不返回，用来erp获取自动开票结果
  • └ payee_register_no
  • String
  • 9128324928723P830
  • 销售方税号
  • └ invoice_time
  • String
  • 12:34:56
  • 开票时间，时分秒格式（注意：2019-04-11之后开具的发票才返回）
  • └ payee_name
  • String
  • 淘宝中国公司
  • 销售方企业名称

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
7
8
9
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaEinvoiceCreateResultGetRequest req = new AlibabaEinvoiceCreateResultGetRequest();
req.setPayeeRegisterNo("123123123123");
req.setPlatformCode("tmall");
req.setPlatformTid("12132");
req.setSerialNo("3123123123");
req.setOutShopName("电子发票旗舰店");
AlibabaEinvoiceCreateResultGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
<alibaba_einvoice_create_result_get_response>
    <invoice_result_list>
        <invoice_result>
            <anti_fake_code>CF6B2F6168420008</anti_fake_code>
            <ciphertext>demosdffsd-32432</ciphertext>
            <device_no>sw1231</device_no>
            <erp_tid>123123</erp_tid>
            <file_data_type>jpg</file_data_type>
            <file_path>demo</file_path>
            <invoice_amount>1232.00</invoice_amount>
            <invoice_code>1231231234</invoice_code>
            <invoice_date>2014-4-21</invoice_date>
            <invoice_no>123123</invoice_no>
            <platform_code>tmall</platform_code>
            <platform_tid>123123</platform_tid>
            <serial_no>123123</serial_no>
            <status>waiting</status>
            <biz_error_code>demo</biz_error_code>
            <biz_error_msg>demo</biz_error_msg>
            <invoice_items>
                <invoice_item>
                    <unit>台</unit>
                    <sum_price>1000.00</sum_price>
                    <tax>170.00</tax>
                    <price>100.00</price>
                    <item_no>123456</item_no>
                    <item_name>电视机</item_name>
                    <specification>X100</specification>
                    <quantity>10</quantity>
                    <tax_rate>0.17</tax_rate>
                    <row_type>0</row_type>
                    <amount>1170.00</amount>
                    <zero_rate_flag>0</zero_rate_flag>
                    <outer_id>281347</outer_id>
                    <biz_order_id>20293843539452</biz_order_id>
                    <is_post_fee_row>false</is_post_fee_row>
                </invoice_item>
            </invoice_items>
            <invoice_type>blud</invoice_type>
            <invoice_kind>0</invoice_kind>
            <normal_invoice_code>110293843838</normal_invoice_code>
            <normal_invoice_no>28371928</normal_invoice_no>
            <payee_operator>张三</payee_operator>
            <payee_receiver>李四</payee_receiver>
            <payee_checker>王五</payee_checker>
            <payer_name>张三</payer_name>
            <payer_register_no>9128324928723P837</payer_register_no>
            <payer_phone>010-29384</payer_phone>
            <payer_address>杭州市文一西路969号</payer_address>
            <payer_bankaccount>网商银行 28239824323</payer_bankaccount>
            <payee_register_no>9128324928723P830</payee_register_no>
            <invoice_time>12:34:56</invoice_time>
            <payee_name>淘宝中国公司</payee_name>
        </invoice_result>
    </invoice_result_list>
</alibaba_einvoice_create_result_get_response>

异常示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案
isp.isp-system.error 系统错误 联系小二排查
isp.system-error 系统错误 联系小二排查

API工具

API测试工具 错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问
返回
顶部