销项发票创建
- url:/common/invoiceOutput/create
- method:post
- 数据格式:json
说明
请求参数
字段名称 |
字段类型 |
字段描述 |
是否必填 |
长度限制 |
bizId |
String |
业务唯一识别码 |
true |
36 |
timestamp |
Long |
当前次接口同步时间对应的时间戳 |
true |
13 |
data.user_code |
String |
员工号 |
true |
64 |
data.branch_code |
String |
分公司编码 (不传取单据号或作废单据号的branch_code) |
false |
64 |
data.document_num |
String |
单据号 |
false |
64 |
data.cancel_document_num |
String |
作废单据号 |
false |
64 |
data.invoice_type |
String |
发票类型 |
true |
10 |
data.receipt_date |
Long |
发票日期 |
false |
|
data.invoice_num |
String |
发票号码 |
false |
64 |
data.invoice_code |
String |
发票代码 |
false |
64 |
data.invoice_serial |
String |
发票校验码 |
false |
64 |
data.amount |
Decimal |
含税金额 |
false |
|
data.net_amount |
Decimal |
不含税金额 |
false |
|
data.tax_amount |
Decimal |
税额 |
false |
|
data.buyer_name |
String |
购买方名称 |
false |
255 |
data.buyer_tax_code |
String |
购买方税号 |
false |
255 |
data.buyer_address_phone |
String |
购买方地址电话 |
false |
255 |
data.buyer_bank_account |
String |
购买方开户行及账号 |
false |
255 |
data.saler_name |
String |
销售方名称 |
false |
255 |
data.saler_tax_code |
String |
销售方税号 |
false |
255 |
data.saler_address_phone |
String |
销售方地址电话 |
false |
255 |
data.saler_bank_account |
String |
销售方开户行及账号 |
false |
255 |
data.phone_number |
String |
手机号 |
false |
255 |
data.email_address |
String |
邮箱 |
false |
255 |
data.payee |
String |
收款人 |
false |
64 |
data.reviewer |
String |
复核人 |
false |
64 |
data.drawer |
String |
开票人 |
false |
64 |
data.comments |
String |
备注 |
false |
255 |
data.open_source |
String |
开票来源 |
false |
32 |
data.invoice_terminal |
String |
开票设备 |
false |
64 |
data.approved_date |
Long |
审批通过日期 |
false |
|
data.cancel_date |
Long |
作废日期 |
false |
|
data.email_status |
String |
邮件发送状态 (Y:发送成功 N:发送失败 E:无需发送) |
false |
64 |
data.output_status |
String |
开票状态 (submitted:待开票 approving:开票中 approved:开票成功 rejected:开票失败) |
true |
64 |
data.cancel_status |
String |
作废状态 (submitted:未作废 approving:作废中 approved:已作废 rejected:作废失败) |
true |
64 |
data.abnormal_status |
String |
异常状态 (normal:正常 reverse:红冲 cancel:作废) |
true |
64 |
data.type |
String |
单据类别 (normal:正常 reverse:红冲 cancel:作废) |
true |
64 |
data.attribute |
String |
自定义字段 |
false |
255 |
data.digital_attachments_status |
String |
发票附件状态 (E:待下载 R:下载中 Y:已下载 N:下载失败) |
false |
255 |
data.digital_attachments_message |
String |
发票附件消息 |
false |
255 |
data.invoice_attachments |
List |
发票附件 |
false |
|
data.invoice_details |
List |
发票明细 |
true |
data.invoice_attachments
字段名称 |
字段类型 |
字段描述 |
是否必填 |
长度限制 |
file_name |
String |
文件名称 |
true |
|
attachment_url |
String |
文件地址 |
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_code |
Decimal |
税率 |
false |
|
tax_amount |
Decimal |
税额 |
false |
请求示例
{
"bizId": "123456789",
"timestamp": 1662536452000,
"data": {
"user_code": "yrhch500",
"document_num": "REQ0000001814",
"invoice_type": "21",
"invoice_num": "25112000000065878368",
"invoice_code": null,
"invoice_serial": null,
"receipt_date": 1743442915000,
"buyer_name": "上海微创医疗器械(集团)有限公司虚拟单位",
"buyer_tax_code": "91990000000020968N",
"buyer_address_phone": "上海市1230018 上海市1230018",
"buyer_bank_account": "上海市1230018 1131313131231321313",
"saler_name": "上海微创医疗器械(集团)有限公司",
"saler_tax_code": "91310000607389788T",
"saler_address_phone": "北京市海淀区 1234567890",
"saler_bank_account": "交通银行海淀支行 140301615336",
"amount": 105.00,
"net_amount": 103.96,
"tax_amount": 1.04,
"payee": "王五",
"reviewer": "赵六",
"drawer": "孙七",
"output_status": "submitted",
"abnormal_status": "normal",
"type": "normal",
"invoice_attachments": [
{
"file_name": "21774/2021/09-13/formatFileBuild/9f75c023-7b59-4cba-a041-38ba06149d5e.pdf",
"attachment_url": "21774/2021/09-13/formatFileBuild/9f75c023-7b59-4cba-a041-38ba06149d5e.pdf"
}
],
"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"
}