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

alibaba.einvoice.bill.sync (结算单同步)

电子发票业务,服务商同步结算单,包括结算单的增删改功能。最终用于开发票

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
invoice_items BillItemDo [] 必须
  • 最大列表长度:20
  • 结算商品单明细列表
    • └ item_name
    • String
    • 必须
    • 苹果
    • 商品名称
    • └ quantity
    • String
    • 必须
    • 10
    • 商品数量
    • └ amount
    • String
    • 必须
    • 1001.00
    • 价税合计,小数点后2两位
    • └ specification
    • String
    • 可选
    • X1
    • 规格型号,可选
    • └ unit
    • String
    • 可选
    • 商品单位
    • └ row_type
    • Number
    • 可选
    • 0
    • 1 折扣行 2被折扣行 0普通行
    status Number 必须 1 结算单同步操作:=1插入,=2更新,=3废弃删除
    order_date Date 必须 2017-08-21 12:00:00 结算单订单日期
    shop_name String 必须 杭州百大饭店 店铺名称,与后台店铺名称保持一致
    payee_register_no String 必须 2015020123123 税务登记证号
    invoice_price String 可选 1001.00 结算单可开票总金额(不填=sumPrice),小数点后2两位
    order_id String 必须 123456789 结算单订单ID
    sum_price String 必须 1001.00 结算单总价格,小数点后2两位
    platform String 必须 POS 调用平台,用于区分同一个税号下多个店铺来源["TB:淘宝","ALIPAY:支付宝","TM:天猫","JD:京东","DD:当当","PP:拍拍","YX:易讯","EBAY:ebay","QQ:QQ网购","AMAZON:亚马逊","SN:苏宁","GM:国美","WPH:唯品会","JM:聚美","LF:乐蜂","MGJ:蘑菇街","JS:聚尚","PX:拍鞋","YT:银泰","YHD:1号店","VANCL:凡客","YL:邮乐","YG:优购","1688:阿里巴巴","POS:POS门店","ELEME:饿了么","OTHER:其他"]
    brand_name String 可选 杭州百大 品牌名称,不填默认=shop_name
    shop_platform String 可选 POS 开票店铺的平台,默认等于platform
    qrcode QrCodeDo 可选 生成二维码参数,若不需要生成二维码,则不填
    • └ qr_type
    • Number
    • 可选
    • 1
    • 二维码返回数据类型:1=二维码背后的URL,2=二维码图片CDN URL,3=二维码二进制数据流
    • └ qr_logo
    • String
    • 可选
    • https://img.alicdn.com/bao/uploaded/i3/TB1qufoSpXXXXcmXVXXXXXXXXXX_!!0-item_pic.jpg_430x430q90.jpg
    • 二维码logo
    • └ width
    • Number
    • 可选
    • 450
    • 二维码宽度
    • └ height
    • Number
    • 可选
    • 450
    • 二维码高度

    响应参数

    名称 类型 示例值 描述
    error_message String 入参缺少 错误信息
    result String eeeeee 插入操作返回二维码
    ret_code String 0 返回码
    succ Boolean true success

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaEinvoiceBillSyncRequest req = new AlibabaEinvoiceBillSyncRequest();
    List<AlibabaEinvoiceBillSyncRequest.BillItemDo> list2 = new ArrayList<AlibabaEinvoiceBillSyncRequest.BillItemDo>();
    AlibabaEinvoiceBillSyncRequest.BillItemDo obj3 = new AlibabaEinvoiceBillSyncRequest.BillItemDo();
    list2.add(obj3);
    obj3.setItemName("苹果");
    obj3.setQuantity("10");
    obj3.setAmount("1001.00");
    obj3.setSpecification("X1");
    obj3.setUnit("只");
    obj3.setRowType(0L);
    req.setInvoiceItems(list2);
    req.setStatus(1L);
    req.setOrderDate(StringUtils.parseDateTime("2017-08-21 12:00:00"));
    req.setShopName("杭州百大饭店");
    req.setPayeeRegisterNo("2015020123123");
    req.setInvoicePrice("1001.00");
    req.setOrderId("123456789");
    req.setSumPrice("1001.00");
    req.setPlatform("POS");
    req.setBrandName("杭州百大");
    req.setShopPlatform("POS");
    AlibabaEinvoiceBillSyncRequest.QrCodeDo obj4 = new AlibabaEinvoiceBillSyncRequest.QrCodeDo();
    obj4.setQrType(1L);
    obj4.setQrLogo("https://img.alicdn.com/bao/uploaded/i3/TB1qufoSpXXXXcmXVXXXXXXXXXX_!!0-item_pic.jpg_430x430q90.jpg");
    obj4.setWidth(450L);
    obj4.setHeight(450L);
    req.setQrcode(obj4);
    AlibabaEinvoiceBillSyncResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_einvoice_bill_sync_response>
        <error_message>入参缺少</error_message>
        <result>eeeeee</result>
        <ret_code>0</ret_code>
        <succ>true</succ>
    </alibaba_einvoice_bill_sync_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

    返回
    顶部