消费记录状态更新V2
- 接口:common/expenses/v2/update/status
- Method:POST
- 数据格式:JSON
- 接口说明:此接口用于消费记录状态更新. 可以将消费记录从未使用(0)更新为锁定(1)状态,也可以将消费记录从锁定(1)更新为未使用(0)状态.
- 其他补充信息:
- 当某条消费记录为锁定(1)状态时,在费控系统中将认为此消费记录已使用.
- 当消费记录关联票据未查验成功时,禁止更新消费记录状态.
- 当消费记录为组合记录时,消费记录的状态更新完成后,会联动更新其关联的所有票据.
参数:
请求参数
字段名称 |
字段类型 |
字段描述 |
是否必填 |
长度限制(字节) |
timestamp |
Long |
请求时间的时间戳 |
TRUE |
|
bizId |
Long |
业务唯一识别码 |
TRUE |
|
data.expense_id |
Integer |
消费记录编号,公司内唯一 |
TRUE |
|
data.status |
Integer |
消费记录状态,0,未使用,1已锁定 |
TRUE |
|
data.comments |
String |
备注信息,用户可以修改的 |
FALSE |
不能超过64字节 |
返回参数
字段名称 |
字段类型 |
字段描述 |
resCode |
Integer |
响应状态码(见附录) |
resMsg |
String |
响应信息描述 |
bizId |
Long |
业务唯一识别码 |
data.company_id |
Integer |
公司ID |
data.expense_id |
Integer |
消费记录ID |
data.status |
Integer |
消费记录状态 (-1,已删除;0,未使用;1,已锁定;2,已报销) |
data.exp_receipt_list[].receipt_id |
Integer |
发票ID |
data.exp_receipt_list[].invoice_type |
String |
发票类型(见附录) |
data.exp_receipt_list[].invoice_code |
String |
发票代码 |
data.exp_receipt_list[].invoice_num |
String |
发票号码 |
data.exp_receipt_list[].receipt_date |
Long |
发票日期 (时间戳 UTC) |
data.exp_receipt_list[].status |
Integer |
票据报销状态 (-1,已删除;0,未使用;1,已锁定;2,已报销) |
data.exp_receipt_list[].invoice_status |
String |
发票查验状态 (Y,已验真;F,查验失败;C,待查验;R,识别中;U,无法识别;I,已识别) |
data.exp_receipt_list[].purchase_invoice |
String |
采购发票标识 (Y,采购发票;N/null 非采购发票) |
data.exp_receipt_list[].submit_user |
String |
提交人 code |
data.exp_receipt_list[].created_by |
String |
归属人 code |
data.exp_receipt_list[].last_updated_by |
String |
最后更新人 code |
示例:
请求数据
{
"timestamp": "1670889600000",
"bizId": "089082e5-45b8-4f00-8ea5-260e91d8a539",
"data": {
"expense_id": 699807,
"status": 1,
"comments": "OA系统锁定此消费记录",
}
}
返回数据
{
"resCode": 200000,
"resMsg": "success",
"bizId": "089082e5-45b8-4f00-8ea5-260e91d8a539",
"data": {
"company_id": 3809,
"expense_id": 699807,
"status": 1,
"exp_receipt_list": [
{
"receipt_id": 588896,
"invoice_type": "11",
"invoice_code": "021001800107",
"invoice_num": "20255685",
"receipt_date": "1665705600000",
"status": 1,
"invoice_status": "Y",
"submit_user": "aoteman@sap.com",
"created_by": "aoteman@sap.com",
"last_updated_by": "aoteman@sap.com"
}
]
}
}