文档中心 > 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
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示例
<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示例
<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

FAQ

返回
顶部