发票开立请求

私有请求参数

索引 标识 名称 类型 要求 说明
1 Body 发票信息 Object[]
2 SerialNo 请求流水号 Nvarchar(30) 例:yyyyMMddHHmmssfff+6位随机数
3 CustomerName 购方-全称 Nvarchar(100) 购方-全称
4 CustomerCode 购方-识别号 Nvarchar(20) 购方-识别号
5 CustomerAddress 购方-地址 Nvarchar(79) 购方-地址
6 CustomerTel 购方-电话 Nvarchar(20) 购方-电话
7 CustomerBankName 购方-开户行名称 Nvarchar(69) 购方-开户行名称
8 CustomerBankAccount 购方-开户行账号 Nvarchar(30) 购方-开户行银行账号
9 PartnerBankName 销方-开户行名称 Nvarchar(69) 销方-开户行名称
10 PartnerBankAccount 销方-开户行账号 Nvarchar(30) 销方-开户行银行账号
11 Drawer 开票人 Nvarchar(8) 默认空则使用平台维护信息
12 Payee 收款人 Nvarchar(8) 默认空则使用平台维护信息
13 Reviewer 复核人 Nvarchar(8) 默认空则使用平台维护信息
14 Currency 币别 Nvarchar(20) 币别,包含USD、RMB
15 RemarkType 备注方式 int 0- 平台模板
1- 自定义,美金发票备注必填
2- 平台模板+自定义,发票备注必填
16 Remark 发票备注 Nvarchar(130) 发票备注,换行用<br/>
17 Email 邮箱 Nvarchar(50) 接收人邮箱
18 InvoiceDrawType 开票方式 Nvarchar(10) 10 – 电票
20 – 纸质普通发票
30 – 纸质专用发票
19 Details 发票明细 Object[]
20 ExpenseName 费用名称 Nvarchar(50) 平台维护,费用名称+币别不可重复
21 Item 项次 Int 从1开始
22 Type 发票行性质 Int 默认0
23 Code 商品编码 Nvarchar(50) 默认空
24 Spec 规格型号 Nvarchar(40) 默认空
25 Unit 单位 Nvarchar(1) 如果空,默认【票】
26 Price 商品单价 Decimal(18,2) 商品单价不为空时,商品数据不可为空
27 Quantity 商品数量 Int 商品数量不为空时,商品单价不可为空
28 Amount 小计 Decimal(18,2)

响应参数

索引 ID 名称 长度 必须 说明
1 Body 发票信息 Object[]
2 SerialNo 流水号 Nvarchar(30) 与请求流水号一致
3 CustomerName 购方-全称 Nvarchar(100) 购方-全称
4 CustomerCode 购方-识别号 Nvarchar(20) 购方-纳税识别号
5 CustomerAddress 购方-地址 Nvarchar(79) 购方-地址
6 CustomerTel 购方-电话 Nvarchar(20) 购方-电话
7 CustomerBankName 购方-开户行名称 Nvarchar(69) 购方-开户行名称
8 CustomerBankAccount 购方-开户行账号 Nvarchar(30) 购方-开户行银行账号
9 PartnerBankName 销方-开户行名称 Nvarchar(79) 销方-开户行名称
10 PartnerBankAccount 销方-开户行账号 nvarchar(30) 销方-开户行银行账号
11 Drawer 开票人 Nvarchar(8) 开票人
12 Payee 收款人 Nvarchar(8) 收款人
13 Reviewer 复核人 Nvarchar(8) 复核人
14 TotalAmount 价税合计金额 Decimal(18,2) 价税合计金额,人民币金额
15 Currency 币种 Nvarchar(50) 币别,包含USD、RMB
17 Remark 发票备注 Nvarchar(130) 发票备注,换行用<br/>
17 Email 邮箱 Nvarchar(50) 接收人邮箱
18 Details 发票明细 Object[]
19 Item 项次 Int
20 Type 发票行性质 Nvarchar(1) 发票行性质
21 Code 商品编码 Nvarchar(50) 商品编码
22 Name 商品名称 Nvarchar(90) 商品名称
23 Spec 规格型号 Nvarchar(40) 规格型号
24 Price 单价 Decimal(18,2) 单价
25 Quantity 数量 Int 数量:1
26 Uom 单位 Nvarchar(20) 单位:票
27 TaxRate 税率 Decimal(18,6) 税率:0.00
28 ZeroTaxrateFlag 零税率标识 Nvarchar(10) 零税率标识,包含:1-免税;2-不征税;3-普通零税率
29 Amount 小计 Decimal(18,6) 价税合计金额,人民币金额
30 CatalogCode 商品分类编码 Nvarchar(50) 商品分类编码
31 NoTaxAmount 不含税金额 Decimal(18,6) 不含税金额,人民币金额
32 TaxAmount 税额 Decimal(18,2) 税额

请求示例

JAVA
                    [{
                      "SerialNo": "",
                      "CustomerName": "",
                      "CustomerCode": "",
                      "CustomerAddress": "",
                      "CustomerTel": "",
                      "CustomerBankName": "",
                      "CustomerBankAccount": "",
                      "PartnerBankName": "",
                      "PartnerBankAccount": "",
                      "Drawer": "",
                      "Payee": "",
                      "Reviewer": "",
                      "Currency": "",
                      "RemarkType": "",
                      "Remark": "",
                      "Email": "",
                      "Details": [{
                        "ExpenseName": "",
                        "Item": "",
                        "Type": "",
                        "Code": "",
                        "Spec": "",
                  "Unit": "",
                        "Price": "",
                        "Quantity": "",
                        "Amount": ""
                      }, {
                        "ExpenseName": "",
                        "Item": "",
                        "Type": "",
                        "Code": "",
                        "Spec": "",
                  "Unit": "",
                        "Price": "",
                        "Quantity": "",
                        "Amount": ""
                      }]
                    }]
                  
                    
                  
复制代码
备注: 程序执行完后需要商户返回"success"字符(不包含引号)。如果商户未返回 success 这7个字符,荣e通服务器会不断重发通知,直到超过 24 小时 22 分钟。一般情况下,25 小时以内完成 8 次通知(通知的间隔频率一般是:4m,10m,10m,1h,2h,6h,15h)

响应示例

JAVA
                    [{
                      "SerialNo": "",
                      "CustomerName": "",
                      "CustomerCode": "",
                      "CustomerAddress": "",
                      "CustomerTel": "",
                      "CustomerBankName": "",
                      "CustomerBankAccount": "",
                      "PartnerBankName": "",
                      "PartnerBankAccount": "",
                      "Drawer": "",
                      "Payee": "",
                      "Reviewer": "",
                      "TotalAmount": "",
                      "Currency": "",
                      "Remark": "",
                      "Email": "",
                      "Details": [{
                        "Item": "",
                        "Type": "",
                        "Code": "",
                        "Spec": "",
                        "Price": "",
                        "Quantity": "",
                        "Uom": "",
                        "TaxRate": "",
                        "ZeroTaxrateFlag": "",
                        "Amount": "",
                        "CatalogCode": "",
                        "NoTaxAmount": "",
                        "TaxAmount": ""
                      }, {
                        "ExpenseName": "",
                        "Item": "",
                        "Type": "",
                        "Code": "",
                        "Spec": "",
                        "Price": "",
                        "Quantity": "",
                        "Uom": "",
                        "TaxRate": "",
                        "ZeroTaxrateFlag": "",
                        "Amount": "",
                        "CatalogCode": "",
                        "NoTaxAmount": "",
                        "TaxAmount": ""
                      }]
                    }]
                  
                      
                  
复制代码
  • 私有请求参数
  • 响应参数
  • 请求示例
  • 响应示例