开票接口

## 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|否||