开票接口
## 1.个体户开票申请
说明:云纳税个体户向直营类型商户进行开票。
#### 接口地址:
/open/api/v1/yns/invoice/custom/create
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|参数类型|是否必填|参数备注|
|-|-|-|-|-|
|thirdOrderNo|客户订单号|String(32)|否|
|idCard|个体户身份证号|String(18)|是||
|mainstayId|注册地|Integer(2)|是||
|invoiceCode|货物或应税劳务、服务名称|String(64)|是|开票内容|
|settlementAmount|结算金额|BigDecimal(10,2)|是|该字段请传入含税价|
|customPaymentVoucher|文件|List(3)<String(255)>|是|传商户向个体户的打款回单url(该字段为数组,最多传3个url)|
|remark|备注|String(640)|否||
#### 响应参数说明:
|参数名称|参数含义|参数类型|是否必填|参数备注|
|-|-|-|-|-|
|invoiceBillNo|开票订单号|String|是|本次开票申请的唯一识别号|
|thirdOrderNo|客户订单号|String|否|入参时客户传入的唯一识别号|
## 2.开票信息状态回调接口
#### 回调类型:ynsInvoiceResult
#### 响应参数说明:
|参数名称|参数含义|参数类型|是否必填|参数备注|
|-|-|-|-|-|
|invoiceBillNo|开票订单号|String|是|本次开票申请的唯一识别号|
|thirdOrderNo|客户订单号|String|否|入参时客户传入的唯一识别号|
|purchaserInvoiceTitle|购买方发票抬头|String|是|例:xxxx有限公司|
|purchaserTaxNumber|购买方税号|String|否|例:91330100FS234(纳税人识别号)|
|purchaserAddressPhone|购买方地址、电话|String|否|例:浙江省杭州市滨江区网商路xx号 130xxxx3381|
|purchaserBankAccount|购买方开户行及账号|String|是|例:中国工商银行杭州富春支行 330501164xxxxxxx|
|sellerInvoiceTitle|购买方发票抬头|String|是|例:xxxx有限公司|
|sellerTaxNumber|购买方税号|String|是|例:91330100FS234(纳税人识别号)|
|sellerAddressPhone|购买方地址、电话|String|否|例:浙江省杭州市滨江区网商路xx号 130xxxx3381|
|sellerBankAccount|购买方开户行及账号|String|否|例:中国工商银行杭州富春支行 330501164xxxxxxx|
|invoiceCode|货物或应税劳务、服务名称|String|是|开票内容|
|settlementAmount|结算金额|BigDecimal|是|该字段请传入含税价|
|invoiceStatus|状态|Integer|是|0:待审核 1:已通过 2:已开票 3:已拒绝(每个状态流转都会回调)|
|refuseReason|拒绝原因|String|否|已拒绝有值|
|billInformation|票据URL|String|否|已开票有值|
|remark|备注|String|否||
## 3.开票信息查询接口
#### 接口地址:
/open/api/v1/yns/invoice/custom/query
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|参数类型|是否必填|参数备注|
|-|-|-|-|-|
|invoiceBillNo|开票订单号|String(32)|否|invoiceBillNo和thirdOrderNo二选一|
|thirdOrderNo|客户订单号|String(32)|否|invoiceBillNo和thirdOrderNo二选一|
#### 响应参数说明:
|参数名称|参数含义|参数类型|是否必填|参数备注|
|-|-|-|-|-|
|invoiceBillNo|开票订单号|String|是|本次开票申请的唯一识别号|
|thirdOrderNo|客户订单号|String|是|入参时客户传入的唯一识别号|
|purchaserInvoiceTitle|购买方发票抬头|String|是|例:xxxx有限公司|
|purchaserTaxNumber|购买方税号|String|否|例:91330100FS234(纳税人识别号)|
|purchaserAddressPhone|购买方地址、电话|String|否|例:浙江省杭州市滨江区网商路xx号 130xxxx3381|
|purchaserBankAccount|购买方开户行及账号|String|是|例:中国工商银行杭州富春支行 330501164xxxxxxx|
|sellerInvoiceTitle|销售方发票抬头|String|是|例:xxxx有限公司|
|sellerTaxNumber|销售方税号|String|是|例:91330100FS234(纳税人识别号)|
|sellerAddressPhone|销售方地址、电话|String|否|例:浙江省杭州市滨江区网商路xx号 130xxxx3381|
|sellerBankAccount|销售方开户行及账号|String|否|例:中国工商银行杭州富春支行 330501164xxxxxxx|
|invoiceCode|货物或应税劳务、服务名称|String|是|开票内容|
|settlementAmount|结算金额|BigDecimal|是|该字段请传入含税价|
|invoiceStatus|状态|Integer|是|0:待审核 1:已通过 2:已开票 3:已拒绝(每个状态流转都会回调)|
|refuseReason|拒绝原因|String|否|已拒绝有值|
|billInformation|票据URL|List<String>|否|已开票有值,可能存在多张票据|
|remark|备注|String|否||