8.2 创建发票申请

简要描述：‌

企业可以使用该接口发起发票申请，平台收到申请后，会对发票申请进行审核、开票、邮寄操作。
企业根据8.1-kai-piao-ding-dan-lie-biao.md接口，选择需要开票的订单，填写发票邮寄地址，确定发票品目提交开票申请。

注意事项：‌

1、只支持多个订单合并开1张发票，或者仅1个订单开多张发票，不支持多个订单合并开多张发票。
2、关于单张发票面额限制：单张发票一般限额100万或者10万，如果是单服务商对接，单张发票限额可以向客服，如果是多服务商对接，建议使用8.4-kai-piao-pei-zhi-cha-xun.md进行配置查询。
3、关于专票、普票：如果是单服务商对接，可以向客服确认当前服务商能否开普票，如果是多服务商对接，建议使用8.4-kai-piao-pei-zhi-cha-xun.md接口进行配置查询。
4、关于电子、纸质发票：如果是单服务商对接，可以向客服确认当前服务商能否开纸质、电子发票，如果是多服务商对接，建议使用8.4-kai-piao-pei-zhi-cha-xun.md接口进行配置查询。
5、关于小额发票：有些服务商为了控制企业开票数量，会有小额发票限制，详情见8.4-kai-piao-pei-zhi-cha-xun.md

请求头参数：

Authorization: Bearer [accessToken]

请求URL：‌

/invoice/batch/add

请求方式：‌

POST

参数：‌

请求参数说明

参数	类型	是否必须	说明
参数	类型	是否必须	说明
providerId	string	否	服务商ID,当有多个服务商时，必填。
projectId	string	否	预开票的时候必填，如果填了此projectId则为预开票申请。
notifyUrl	string	否	接收该发票申请单处理结果的后端回调url。当该url没有传值时，系统会使用后台开发者配置中的回调链接。注意:该url必须为可以直接访问的http链接,例如:https://www.baidu.com
batchNo	string	是	批次号（调用方系统对该发票申请的唯一标识，每个批次订单必须唯一）。
corpName	string	是	发票抬头
bizLicenseCode	string	是	企业信用代码
invoiceType	int	是	发票类型: 0 企业增值税普通发票 1 增值税专用发票
bank	string	是	开户行
bankNo	string	是	开户行账号
registeredAddress	string	是	注册地址
registeredPhone	string	是	税务登记固定电话
expressName	string	否	收件人姓名，当申请的是纸质发票时，必须填写。
expressPhone	string	否	收件人电话，当申请的是纸质发票时，必须填写。
expressPostcode	string	否	邮编，当申请的是纸质发票时，必须填写。
expressAddress	string	否	收件地址，当申请的是纸质发票时，必须填写。
email	string	否	邮箱地址，当申请的是电子发票时，必须填写。
invoiceOrderIdList	List	是	发票订单ID集合,json格式字符串，例如["123","456"]。如果是预开票时，此值可以为空。
detailList	list	是	发票明细，参数说明见下表

detailList

参数	类型	是否必须	说明
detailNo	string	否	(系统调用方每张发票的唯一标识)
contentList	List	是	发票明细，参数说明见下方表格

contentList

参数	类型	是否必须	说明
contentNo	string	否	发票明细里调用方唯一标识
amount	double	是	明细金额
serviceAmount	double	否	如果是差额普票则必须填，取值可以从8.1开票订单列表里获取，如果是多个订单汇总，则需要将此金额汇总
content	string	是	开票品目

请求参数示例

{
  "batchNo": "20191015001",
  "providerId": "88888888888888888888",
  "projectId": "12345",
  "notifyUrl": "https://www.baidu.com",
  "corpName": "公司名称",
  "bizLicenseCode":"公司营业代码",
  "invoiceType":1,
  "bank":"中国银行xxxx支行",
  "bankNo":"123456",
  "registeredAddress":"注册地址信息",
  "registeredPhone":"0731-88888888",
  "expressName":"收件人姓名",
  "expressPhone":"收件人电话",
  "expressPostcode":"收件人邮编",
  "expressAddress":"收件人地址",
  "email":"收件人邮箱",
  "invoiceOrderIdList":["123","456"],
  "detailList": [
    {
      "detailNo": "123",
      "contentList":[
        {
          "contentNo": "1",
          "amount": 50000.62,
          "content": "*现代服务*技术服务费"
        },
        {
          "contentNo": "2",
          "amount": 30000.00,
          "content": "*现代服务*测试服务费"
        }
    ]
    },
    {
      "detailNo": "456",
      "contentList":[
        {
          "contentNo": "3",
          "amount": 100000.00,
          "content": "*现代服务*技术服务费"
        },
        {
          "contentNo": "4",
          "amount": 70000.00,
          "content": "*现代服务*测试服务费"
        }
    ]
    }
  ]
}

‌

响应参数说明

参数	类型	说明
id	string	平台订单唯一id，成功时返回
batchNo	string	批次号（调用方系统对该交易订单的唯一标识，每个批次订单必须唯一）。

‌

返回结果示例

成功示例
{
  "id": "362201688838242123",
  "batchNo":"20191015001"
}


失败示例
{
    "error": "BadRequest",
    "message": "参数错误"
}

8.2 创建发票申请

8.2 创建发票申请

results matching ""

No results matching ""