四、开票接口
## 1.查询可开票订单列表接口
#### 接口地址:
/open/api/v1/invoices/queryUnbilled
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|是否必填|参数备注|
|-|-|-|-|
|invoiceCode|发票编码|是||
|mainstayId|主体ID|是||
|endData|查询时间结|否|时间格yyyy-MM 字符串类型即可|
|startData|查询时间开始|否|时间格yyyy-MM 字符串类型即可|
|pageNo|当前页1为第一页|否|Integer|
|pageSize|每页大小|否|Integer|
#### 响应参数说明:
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|billId|SSC订单号|int|是||
|thirdOrderId|第三方订单号|String|是||
|invoiceAmount|可开票金额(计算税点)|BigDecimal|是||
|invoiceContent|发票内容|String|是||
|billSuccessAmount|成功结算金额|BigDecimal| 是||
|billNum|结算人数|int|是||
|billSuccessNum|成功结算人数|int|是||
|createTime|订单结算时间|String|是|eg:2019-10-07 11:34:03|
|totalNum|总条数|Integer|是||
## 2.开发票接口
#### 接口地址:
/open/api/v1/invoices/create
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|是否必填|参数备注|
|-|-|-|-|
|taxNumbe|税号|是||
|invoiceTitle|发票抬头|是||
|billIds|平台订单ID|否|多个用英文逗号隔开(如果billIds不填写则batchNos必填)|
|batchNos|订单批次号|否|多个用英文逗号隔开(如果batchNos号不填写则billIds必填)|
|addressPhone|公司地址、电话|是|示例:浙江省杭州市余杭区 188888888|
|bankAccount|开户行及账号|是||
|invoiceType|发票类型|是|普票或者专票两种选择|
|recipient|收件人|是||
|phone|收件人联系电话|是||
|area|收件人所在地区|是||
|detailAddress|收件人详细地址|是||
|email|电子邮件|是||
|remark|备注|否|字数不可超过120个字|
|billFile|结算单文件|否|字数不可超过640个字符|
|billDesc|结算单说明|否|字数不可超过640个字符|
|sceneFile|场景说明文件|否|字数不可超过640个字符|
|sceneDesc|场景说明|否|字数不可超过640个字符|
#### 响应参数说明:
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|invoiceId|发票单号|String|是|生成发票后返回需要存储起来,方便后面查询状态|
## 3.合并开发票接口
#### 接口地址:
/open/api/v1/invoices/batchCreate
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|是否必填|参数备注|
|-|-|-|-|
|dateStart|开票开始时间|否|精确到秒示例:"2020-10-01 20:18:00",如果不填写则默认所有未开票的订单合并,该时间以订单同步的时间为条件进行查询|
|dateEnd|开票结束时间|否|精确到秒示例:"2020-10-02 20:18:00",,如果不填写则默认所有未开票的订单合并,该时间以订单同步的时间为条件进行查询|
|mainstayId|主体ID|是||
|invoiceCode|发票编码|是||
|taxNumbe|税号|是||
|invoiceTitle|发票抬头|是||
|addressPhone|公司地址、电话|是|示例:浙江省杭州市余杭区 188888888|
|bankAccount|开户行及账号|是||
|invoiceType|发票类型|是|普票或者专票两种选择|
|recipient|收件人|是||
|phone|收件人联系电话|是||
|area|收件人所在地区|是||
|detailAddress|收件人详细地址|是||
|email|电子邮件|是||
|remark|备注|否|字数不可超过120个字|
|billFile|结算单文件|否|字数不可超过640个字符|
|billDesc|结算单说明|否|字数不可超过640个字符|
|sceneFile|场景说明文件|否|字数不可超过640个字符|
|sceneDesc|场景说明|否|字数不可超过640个字符|
#### 响应参数说明:
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|invoiceId|发票单号|String|是|生成发票后返回需要存储起来,方便后面查询状态|
|totalInvoiceAmount|总开票金额|String|是|此次开票的总金额|
|totalBillSuccessAmount|总结算金额|String|是|此次开票订单所有的结算金额|
## 4.开票结果查询
#### 接口地址:
/open/api/v1/invoices/detail
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|是否必填|参数备注|
|-|-|-|-|
|invoiceId|发票单号|是||
#### 响应参数说明:
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|invoiceId|发票单号|String|是||
|invoiceTitle|发票抬头|String|是||
|taxNumbe|税号|String|是||
|addressPhone|地址、电话|String|是||
|addressee|收件地址|String|是||
|invoiceAmount|合并开票金额|String|是||
|bankAccount|开户行及账号|String|是||
|invoiceContent|发票内容|String|是||
|invoiceType|发票类型|String|是|普票或者专票|
|mainstayId|代征主体ID|int|是||
|mainstayName|代征主体|String|是||
|remark|备注|String|否||
|phone|联系电话|String|是||
|area|所在地区|是|String||
|detailAddress|详细地址|String|是||
|email|邮箱|String|是||
|expressCompany|快递公司|String|否||
|expressNo|快递单号|String|否||
|invoiceStatus|发票状态|int|是|详情请参考[发票状态码](doc:nD2opxYu)|
|refuseReason|拒绝原因|String|否||