更新单据状态

POST/m4/fpzs/expense/invoice/status/update

:::tip

根据业务流程更新单据状态，同步更新发票报销状态到发票云
expenseStatus为1的时候，发票仍是未用状态，其他单据仍然可以绑定这张发票并通过合规性重复报销校验
:::

:::warning

第三方系统或二开单据对接发票助手，请关注逆向流程发票释放的处理。例如：单据废弃、单据删除、单据驳回关联在单据上的发票要解除关联关系或更改发票状态
当需要驳回和审批通过时，expenseStatus传对应的值即可
当expenseStatus从更高的状态变回1的时候，代表释放发票，单据此刻仍能查询到这张发票，因为关系没有解除，但发票已是未用状态，此时被其他单据采集的时候，不属于重复报销的情况
:::

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/json

client_id

string

发票云授权客户ID

必需

随着激活邮件下发

<= 20 字符

sign

string

签名

必需

签名, 签名规则根据加密方式来定，详情见对接约定中的签名规则部分

timestamp

string

时间戳

必需

用于签名验证，从1970年1月1日到当前的毫秒数

encType

string

签名加密类型

可选

0：MD5、1：SHA256、2：HMAC SHA256，不传默认MD5加密

bxd_key

string

单据ID

必需

用于区分单据唯一，可以使用一些唯一算法生成，每个单据务必不重复，重复则视为同一个单据

<= 50 字符

billnumber

string

单据编号

可选

用于业务系统展示

eid

string

用户ID

必需

对接系统的用户ID，后续用于发票查询

<= 80 字符

emptyCheck

integer

空单据校验

可选

传1时进行空单据校验，没有发票会返回失败，默认不校验

expenseStatus

number

单据状态

必需

1未用、30在用、60已用、65已入账

ticketParam

string

合规性校验设置

可选

格式如：11011

billType

string

单据类型

可选

默认值为""，即默认费用单据。 Tra 智能差旅行程单据，Pur 智能物品采购单据， BizOut |智能对公单据

invoiceData

array [object {5}]

可选

serialNo

string

发票流水号

可选

canBeDeduction

integer

是否可抵扣

可选

0不可 1 可以。由业务方决定发票是否可抵扣

entryAmount

number

入账税额

可选

outputReason

string

转出原因

可选

outputAmount

string

转出金额

可选

attachmentFids

string

附件流水号

可选

多个以英文逗号拼接，表示仅需这些附件

resource

string

产品线来源

可选

1发票云、2EAS、3Cloud、4苍穹、5星空、6k3w、7SAP、11泛微

<= 1 字符

remark

string

单据备注

可选

用于业务系统展示

<= 1000 字符

{
  "client_id": "string",
  "sign": "string",
  "timestamp": "string",
  "encType": "string",
  "bxd_key": "string",
  "billnumber": "string",
  "eid": "string",
  "emptyCheck": 0,
  "expenseStatus": 0,
  "ticketParam": "string",
  "billType": "string",
  "invoiceData": [
    {
      "serialNo": "string",
      "canBeDeduction": 0,
      "entryAmount": 0,
      "outputReason": "string",
      "outputAmount": "string"
    }
  ],
  "attachmentFids": "string",
  "resource": "s",
  "remark": "string"
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

errcode

string

响应码

必需

0000成功，其他失败

description

string

描述

必需

traceId

string

追踪ID

必需

用于出现异常，发票云定位日志使用

{
  "errcode": "0000",
  "description": "操作成功",
  "traceId": ""
}

最后修改时间： 4 个月前