文档中心 > API类目 > 银泰开放平台

alibaba.mos.invoice.customer.batchapplyinvoice (点击申请开票)

订单开票列表页,点击申请开票(批量开票,合并开票)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param OrderOpenInvoiceParam 必须 请求入参
  • └ trade_nos
  • String []
  • 必须
  • 202407090915208207
  • OC订单号列表,用于标识需要开票的具体交易记录
  • └ user_id
  • Number
  • 必须
  • 2196520845
  • 用户id
  • └ open_invoice_type
  • String
  • 必须
  • 0
  • 开票类型,0 表示批量开票,1 表示合并开票,参考 OpenInvoiceTypeEnum 枚举
  • └ invoice_content_type
  • String
  • 必须
  • 1
  • 发票内容类型,1 表示商品类别,2 表示小票明细,参考 InvoiceContentTypeEnum 枹举
  • └ order_type
  • String
  • 必须
  • 1
  • 开票订单类型,具体含义依据 InvoiceOrderTypeEnum 枚举确定,对于储值卡订单特别标注

响应参数

名称 类型 示例值 描述
result SingleResult 返回结果
  • apply_open_invoice_merge_list
  • OrderMergeInvoice
  • 申请发票合并的列表,每个元素代表一笔或多笔交易的合并开票申请
  • └ amount
  • String
  • 100
  • 订单合并开票金额,单位为分
  • └ item_title_cut_off
  • Boolean
  • true
  • 商品名称是否被截断的标志,true 表示至少有一行商品名称被截断,此时整个列表返回为 true
  • └ cut_item_title_list
  • Boolean
  • [{"itemTitleFront":"Apple iPhone Xs Max 256GB Space Gray","itemTitleRear":"(Space Gray)"},{"itemTitleFront":"Samsung Galaxy Note 10+ 5G","itemTitleRear":""}]
  • 发生截断的商品名称列表,每条记录是一个Map,键分别为 "itemTitleFront" (商品名称前半部分) 和 "itemTitleRear" (商品名称后半部分,已被截断的部分,需要特殊标记)
  • └ user_email
  • String
  • yinlanlan@szkemin.com
  • 用户接收发票的电子邮件地址
  • user_purchaser_list
  • InvoiceTitle
  • 个人发票抬头列表,用于个人类型的发票申请
  • └ purchaser_title
  • String
  • 张三
  • 发票抬头,即购方名称
  • └ purchaser_tax_no
  • String
  • 123456789012345678
  • 税号,一般为企业纳税人识别号
  • └ purchaser_type
  • String
  • 0
  • 购方类型,参考 com.alibaba.mos.invoice.customer.enums.oper.PurchaserTypeEnum 枚举,区分个人或企业客户
  • company_purchaser_list
  • InvoiceTitle
  • 企业发票抬头列表,用于企业类型的发票申请
  • └ purchaser_title
  • String
  • 张三
  • 发票抬头,即购方名称
  • └ purchaser_tax_no
  • String
  • 123456789012345678
  • 税号,一般为企业纳税人识别号
  • └ purchaser_type
  • String
  • 0
  • 购方类型,参考 com.alibaba.mos.invoice.customer.enums.oper.PurchaserTypeEnum 枚举,区分个人或企业客户
  • └ item_title_cut_off
  • Boolean
  • true
  • 标志位,指示商品名称在发票上是否被截断,通常是因为长度限制而触发

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaMosInvoiceCustomerBatchapplyinvoiceRequest req = new AlibabaMosInvoiceCustomerBatchapplyinvoiceRequest();
AlibabaMosInvoiceCustomerBatchapplyinvoiceRequest.OrderOpenInvoiceParam obj1 = new AlibabaMosInvoiceCustomerBatchapplyinvoiceRequest.OrderOpenInvoiceParam();
obj1.setTradeNos("202407090915208207");
obj1.setUserId(2196520845L);
obj1.setOpenInvoiceType("0");
obj1.setInvoiceContentType("1");
obj1.setOrderType("1");
req.setParam(obj1);
AlibabaMosInvoiceCustomerBatchapplyinvoiceResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_mos_invoice_customer_batchapplyinvoice_response>
    <result>
        <apply_open_invoice_merge_list>
            <amount>100</amount>
            <item_title_cut_off>true</item_title_cut_off>
            <cut_item_title_list>[{&quot;itemTitleFront&quot;:&quot;Apple iPhone Xs Max 256GB Space Gray&quot;,&quot;itemTitleRear&quot;:&quot;(Space Gray)&quot;},{&quot;itemTitleFront&quot;:&quot;Samsung Galaxy Note 10+ 5G&quot;,&quot;itemTitleRear&quot;:&quot;&quot;}]</cut_item_title_list>
        </apply_open_invoice_merge_list>
        <user_email>yinlanlan@szkemin.com</user_email>
        <user_purchaser_list>
            <purchaser_title>张三</purchaser_title>
            <purchaser_tax_no>123456789012345678</purchaser_tax_no>
            <purchaser_type>0</purchaser_type>
        </user_purchaser_list>
        <company_purchaser_list>
            <purchaser_title>张三</purchaser_title>
            <purchaser_tax_no>123456789012345678</purchaser_tax_no>
            <purchaser_type>0</purchaser_type>
        </company_purchaser_list>
        <item_title_cut_off>true</item_title_cut_off>
    </result>
</alibaba_mos_invoice_customer_batchapplyinvoice_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

返回
顶部