红字发票创建
- url:/common/invoiceOutput/redCreate
- method:post
- 数据格式:json
说明
请求参数
字段名称 |
字段类型 |
字段描述 |
是否必填 |
长度限制 |
bizId |
String |
业务唯一识别码 |
true |
36 |
timestamp |
Long |
当前次接口同步时间对应的时间戳 |
true |
13 |
data.user_code |
String |
员工号 |
true |
64 |
data.branch_code |
String |
分公司编码 |
true |
64 |
data.uuid |
String |
红字确认单UUID |
false |
36 |
data.confirmation_number |
String |
红字发票信息确认单编号 |
false |
255 |
data.user_identity |
String |
用户角色 (0:销方 1:购方) |
false |
255 |
data.enter_identity |
Long |
录入方身份 (0:销方 1:购方) |
false |
255 |
data.enter_date |
Long |
录入时间 |
false |
|
data.seller_name |
String |
销售方名称 |
false |
255 |
data.seller_tax_code |
String |
销售方纳税人识别号 |
false |
255 |
data.buyer_name |
String |
购买方名称 |
false |
255 |
data.buyer_tax_code |
String |
购买方纳税人识别号 |
false |
255 |
data.blue_invoice_type |
String |
蓝字发票类型 |
false |
10 |
data.blue_invoice_code |
String |
蓝字发票代码 |
false |
255 |
data.blue_invoice_num |
String |
蓝字发票号码 |
false |
255 |
data.blue_invoice_date |
Long |
蓝字发票开票日期 |
false |
|
data.blue_invoice_amount |
BigDecimal |
蓝字发票合计金额 |
false |
|
data.blue_invoice_tax_amount |
BigDecimal |
蓝字发票合计税额 |
false |
|
data.red_invoice_num |
String |
红字发票号码 |
false |
255 |
data.red_invoice_date |
Long |
红字发票日期 |
false |
|
data.red_offset_tax_amount |
BigDecimal |
红字冲销税额 |
false |
|
data.reason |
String |
冲红原因 (01:开票有误 02:销货退回 03:服务中止 04:销售折让) |
false |
2 |
data.message |
String |
备注 |
false |
255 |
data.invoice_details |
List |
发票明细 |
true |
data.invoice_details
字段名称 |
字段类型 |
字段描述 |
是否必填 |
长度限制 |
abbreviation |
String |
商品分类简称 |
false |
64 |
name |
String |
货物或应税劳务、服务名称 |
false |
64 |
specification |
String |
规格型号 |
false |
64 |
unit_name |
String |
单位 |
false |
64 |
quantity |
Decimal |
数量 |
false |
|
net_price |
Decimal |
不含税单价 |
false |
|
net_amount |
Decimal |
不含税金额 |
false |
|
tax_rate |
Decimal |
税率 |
false |
|
tax_amount |
Decimal |
税额 |
false |
请求示例
{
"bizId": "123456789",
"timestamp": 1662536452000,
"data": {
"user_code": "yrhch500",
"invoice_type": "21",
"invoice_num": "25112000000065878368",
"receipt_date": 1743442915000,
"buyer_name": "上海云简科技有限公司",
"buyer_tax_code": "91990000000020969",
"saler_name": "上海云简科技有限公司",
"saler_tax_code": "91990000000020969",
"blue_invoice_amount": 105.00,
"blue_invoice_tax_amount": 1.04,
"red_offset_tax_amount": 105.00,
"invoice_details": [
{
"name": "*燕麦*燕麦0136",
"abbreviation": "测试分类名称1",
"specification": "测试简称",
"unit_name": "克",
"net_price": 94.34,
"net_amount": 94.34,
"tax_rate": 0.06,
"quantity": 1.0,
"tax_amount": 5.66
},
{
"name": "*燕麦*燕麦0136",
"abbreviation": "测试分类名称1",
"specification": "测试简称",
"unit_name": "克",
"net_price": 94.34,
"net_amount": 94.34,
"tax_rate": 0.06,
"quantity": 1.0,
"tax_amount": 5.66
}
]
}
}
返回参数
字段名称 |
字段类型 |
字段描述 |
resCode |
Integer |
状态码 |
resMsg |
String |
描述 |
返回示例
{
"resCode": 200000,
"resMsg": "success"
}
{
"resCode": 500001,
"resMsg": "购买方银行账户字段长度不能超过255个字符, buyer_bank_account=287; 无效的发票状态, output_status=submitted-1; 无效的异常状态, abnormal_status=normal-1"
}