全票种状态批量修改

PATCH

/ticket/states

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

请求参数

Query 参数

appId

string

签名所用的应用ID

必需

示例值:

123456

timestamp

string

必需

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

示例值:

1557480235416

sig

string

签名

必需

示例值:

1a4ffff8440a1da3de7a71a3aea55c0d

Body 参数application/json

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 报销单支付动作"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PATCH '/ticket/states?appId=123456&timestamp=1557480235416&sig=1a4ffff8440a1da3de7a71a3aea55c0d' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ids": [
        "61",
        "38"
    ],
    "state": "PAYMENT",
    "externalData": "2024-1-1 12:08:12 报销单支付动作"
}'

返回响应

🟢200成功

application/json

Body

code

integer

状态码

必需

data

boolean

必需

message

string

消息

必需

示例

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

修改于 2024-05-07 09:48:54

查询全票种详情

查询员工报账单列表