微报账API文档

全票种状态批量修改

PATCH/ticket/states

本接口支持对发票进行批量修改状态：
1、传入全票种发票id，可以锁定或者释放发票状态；
2、同时支持传入第三方信息，比如动作描述，会记录（追加方式）在微报账发票维度的【第三方信息】字段中，用于追溯；
3、传入状态时，系统会检查将要修改的发票状态，非【已归档】状态均可修改，如果【已归档】状态，会修改失败；

请求参数

Query 参数

appId

string

签名所用的应用ID

必需

示例值:

123456

timestamp

string

必需

签名所用的时间戳（精确到毫秒）

示例值:

1557480235416

sig

string

签名

必需

示例值:

1a4ffff8440a1da3de7a71a3aea55c0d

ids

array[string]

发票id数组

必需

>= 1 items<= 200 items

state

enum<string>

状态

必需

单选，仅限列表枚举值

枚举值:

DEFAULTUSEPAYMENTEXTERNAL_SYSTEM_USE

externalData

string

第三方信息

可选

<= 200 字符

{
  "ids": [
    "61",
    "38"
  ],
  "state": "PAYMENT",
  "externalData": "2024-1-1 12:08:12 报销单支付动作"
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

code

integer

状态码

必需

data

boolean

必需

message

string

消息

必需

{
  "code": 0,
  "data": true,
  "message": ""
}

最后修改时间： 10 个月前