批量更新发票状态

POST

http://127.0.0.1/cgi-bin/card/invoice/reimburse/updatestatusbatch

智慧硬件开发/电子发票

最后修改时间：2022-08-30 03:03:35

责任人：未设置

接口说明：发票平台可以通过该接口对某个成员的一批发票进行锁定、解锁和报销操作。注意，报销状态为不可逆状态，请开发者慎重调用。

权限说明：仅认证的企业微信账号有接口权限

注：
报销方须保证在报销、锁定、解锁后及时将状态同步至微信端，保证用户发票可以正常使用
批量更新发票状态接口为事务性操作，如果其中一张发票更新失败，列表中的其它发票状态更新也会无法执行，恢复到接口调用前的状态

文档ID: 11634
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90286
https://open.work.weixin.qq.com/api/doc/90001/90422
https://open.work.weixin.qq.com/api/doc/90002/90904

请求参数

Query 参数

access_token

string

调用接口凭证

必需

示例值:

Body 参数application/json

reimburse_status

string

必需

发票报销状态 INVOICE_REIMBURSE_INIT：发票初始状态，未锁定；INVOICE_REIMBURSE_LOCK：发票已锁定，无法重复提交报销;INVOICE_REIMBURSE_CLOSURE:发票已核销，从用户卡包中移除

invoice_list

array [object {2}]

必需

发票列表，必须全部属于同一个openid

encrypt_code

string

可选

发票卡券的加密code，和card_id共同构成一张发票卡券的唯一标识

card_id

string

可选

发票卡券的card_id

openid

string

必需

用户openid，可用“userid与openid互换接口”获取

示例

{
  "openid": "OPENID",
  "reimburse_status": "INVOICE_REIMBURSE_INIT",
  "invoice_list": [
    {
      "card_id": "cardid_1",
      "encrypt_code": "encrypt_code_1"
    },
    {
      "card_id": "cardid_2",
      "encrypt_code": "encrypt_code_2"
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'http://127.0.0.1/cgi-bin/card/invoice/reimburse/updatestatusbatch?access_token={{accesstoken}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "openid": "OPENID",
    "reimburse_status": "INVOICE_REIMBURSE_INIT",
    "invoice_list": [
        {
            "card_id": "cardid_1",
            "encrypt_code": "encrypt_code_1"
        },
        {
            "card_id": "cardid_2",
            "encrypt_code": "encrypt_code_2"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

errcode

integer

必需

errmsg

string

必需

示例

{
  "errcode": 0,
  "errmsg": "string"
}

更新发票状态

批量查询电子发票