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

alibaba.einvoice.qrcode.create (扫码开票二维码生成)

扫码开票功能中的二维码生成接口,pos机等发起请求生成二维码

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
invoice_items BillItemDo [] 必须
  • 最大列表长度:20
  • 发票商品明细
    • └ item_name
    • String
    • 必须
    • 苹果
    • 商品名称
    • └ quantity
    • String
    • 可选
    • 1
    • 商品数量
    • └ amount
    • String
    • 必须
    • 100.1
    • 商品价税合计
    • └ specification
    • String
    • 可选
    • X1
    • 商品规格型号
    • └ unit
    • String
    • 可选
    • 商品单位
    payee_register_no String 必须 2015020123123 收款方税务登记证号
    order_id String 必须 18234561212 开票的订单号,同结算单订单号
    sum_price String 必须 100.1 开票金额
    source_id String 必须 12345 请求方唯一标识ID,例如POS机编码
    platform String 可选 default
  • 默认值:default
  • 请求方ERP系统平台,同结算单同步的platform,不填默认=platform
    qr_logo String 可选 https://img.alicdn.com/bao/uploaded/i3/TB1qufoSpXXXXcmXVXXXXXXXXXX_!!0-item_pic.jpg_430x430q90.jpg 二维码图片中间的logo
    width Number 可选 450 二维码图片宽度,默认=450
    height Number 可选 450 二维码图片高度,默认=450
    qr_type Number 必须 1 二维码返回类型:1=二维码背后的URL,2=二维码图片CDN URL,3=二维码二进制数据流

    响应参数

    名称 类型 示例值 描述
    result ResultSet {} result
    • └ error_message
    • String
    • 找不到原始结算单,请确认结算单已同步
    • errorMessage
    • └ result
    • String
    • http://api.alibaba-inc.com/my?spm=0.0.0.0.OoXYJ1
    • result
    • └ error_code
    • String
    • 0
    • errorCode

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaEinvoiceQrcodeCreateRequest req = new AlibabaEinvoiceQrcodeCreateRequest();
    List<AlibabaEinvoiceQrcodeCreateRequest.BillItemDo> list2 = new ArrayList<AlibabaEinvoiceQrcodeCreateRequest.BillItemDo>();
    AlibabaEinvoiceQrcodeCreateRequest.BillItemDo obj3 = new AlibabaEinvoiceQrcodeCreateRequest.BillItemDo();
    list2.add(obj3);
    obj3.setItemName("苹果");
    obj3.setQuantity("1");
    obj3.setAmount("100.1");
    obj3.setSpecification("X1");
    obj3.setUnit("只");
    req.setInvoiceItems(list2);
    req.setPayeeRegisterNo("2015020123123");
    req.setOrderId("18234561212");
    req.setSumPrice("100.1");
    req.setSourceId("12345");
    req.setPlatform("default");
    req.setQrLogo("https://img.alicdn.com/bao/uploaded/i3/TB1qufoSpXXXXcmXVXXXXXXXXXX_!!0-item_pic.jpg_430x430q90.jpg");
    req.setWidth(450L);
    req.setHeight(450L);
    req.setQrType(1L);
    AlibabaEinvoiceQrcodeCreateResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_einvoice_qrcode_create_response>
        <result>
            <error_message>找不到原始结算单,请确认结算单已同步</error_message>
            <result>http://api.alibaba-inc.com/my?spm=0.0.0.0.OoXYJ1</result>
            <error_code>0</error_code>
        </result>
    </alibaba_einvoice_qrcode_create_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>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部