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

alibaba.einvoice.item.update (修改商品开票信息)

ERP通过接口将商品的开票信息同步给阿里发票平台,自动开票时将读取这些开票信息,需要联系阿里小二开通对应的权限

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
invoice_name String 可选 电视机 50寸
  • 最大长度:65
  • 商品的开票名称,对应发票的货物劳务名称,值DELETE时表示删除
    item_id Number 可选 18273482734 商品id,优先级高于outerId,商品必须归属于店铺,itemId和outerId不能同时为空
    item_no String 可选 1090511000000000000
  • 最大长度:19
  • 税收分类编码,需要精确到叶子节点,必须和taxRate同时修改或删除,值DELETE时表示删除
    sku_id Number 可选 18273482734 skuId,必须是itemId下的sku,填写skuId后,修改和删除sku的开票信息
    specification String 可选 Lmx
  • 最大长度:20
  • 规格型号,值DELETE时表示删除
    tax_rate String 可选 16
  • 最大长度:6
  • 税率,可选值0,3,4,5,6,10,11,13, 16,17,必须和itemNo同时修改或删除,值为DELETE时表示删除
    zero_rate_flag String 可选 0
  • 最大长度:6
  • 0税率标识,只有税率为0的情况才有值,0=出口零税率,1=免税,2=不征收,3=普通零税率,值为DELETE时表示删除
    unit String 可选
  • 最大长度:10
  • 单位,值DELETE时表示删除
    outer_id String 可选 335345 商家外部商品id,如果outerId对应了多个天猫sku,则会更新所有的sku开票信息。itemId和outerId不能同时为空
    update_sku Boolean 可选 false 是否根据outerId更新所有对应sku的开票信息,true=更新,false=开票信息维护在发票平台;自动开票时,根据skuId获取outerId,再根据outerId查询开票信息。outerId不为空时必填

    响应参数

    名称 类型 示例值 描述
    is_success Boolean true 修改结果

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaEinvoiceItemUpdateRequest req = new AlibabaEinvoiceItemUpdateRequest();
    req.setInvoiceName("电视机 50寸");
    req.setItemId(18273482734L);
    req.setItemNo("1090511000000000000");
    req.setSkuId(18273482734L);
    req.setSpecification("Lmx");
    req.setTaxRate("16");
    req.setZeroRateFlag("0");
    req.setUnit("个");
    req.setOuterId("335345");
    req.setUpdateSku(false);
    AlibabaEinvoiceItemUpdateResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_einvoice_item_update_response>
        <is_success>true</is_success>
    </alibaba_einvoice_item_update_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

    返回
    顶部