保存单据

POST/m4/fpzs/expense/entry/save

:::tip
只有缓存或保存单据后，调用查看发票界面才能正确展示单据下发票的数据
:::

请求参数

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 字符

data

array [object {4}]

可选

entryid

string

分录ID

可选

如果没有分录功能，可以传空

fid

array[string]

发票流水号

必需

costTypeId

string

费用类型ID

可选

<= 80 字符

costTypeName

string

费用类型名称

可选

<= 120 字符

attachmentFids

string

附件流水号

可选

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

creatorId

string

第三方制单人id

可选

用于业务系统展示

<= 60 字符

creatorName

string

第三方制单人名称

可选

用于业务系统展示

<= 80 字符

creatorPhone

string

第三方制单人手机号

可选

用于业务系统展示

<= 20 字符

creatorEmail

string

第三方制单人邮箱

可选

用于业务系统展示

<= 60 字符

resource

string

产品线来源

可选

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

<= 1 字符

coverBase64

string

封面文件base64

可选

通知影像使用的封面文件

coverFileType

string

封面文件类型

可选

pdf、jpg、png等，传递封面文件base64的时候必填

coverNumber

string

封面编号

可选

有封面编号才会通知影像

<= 100 字符

applyOrganizationCode

string

提单组织编码

可选

影像环节使用

<= 100 字符

applyOrganizationName

string

提单组织名称

可选

影像环节使用

<= 100 字符

expensePersonId

string

报销人ID

可选

用于业务系统展示

<= 64 字符

expensePersonName

string

报销人名称

可选

用于业务系统展示

<= 64 字符

expenseSystemSource

string

报销系统来源

可选

用于业务系统展示

<= 100 字符

expenseReviewer

string

报销系统审核人

可选

用于业务系统展示

<= 100 字符

remark

string

单据备注

可选

用于业务系统展示

<= 1000 字符

realExpenseAmount

string

实际报销金额

可选

用于业务系统展示

{
  "client_id": "string",
  "sign": "string",
  "timestamp": "string",
  "encType": "string",
  "bxd_key": "string",
  "billnumber": "string",
  "eid": "string",
  "data": [
    {
      "entryid": "string",
      "fid": [
        "string"
      ],
      "costTypeId": "string",
      "costTypeName": "string"
    }
  ],
  "attachmentFids": "string",
  "creatorId": "string",
  "creatorName": "string",
  "creatorPhone": "string",
  "creatorEmail": "string",
  "resource": "s",
  "coverBase64": "string",
  "coverFileType": "string",
  "coverNumber": "string",
  "applyOrganizationCode": "string",
  "applyOrganizationName": "string",
  "expensePersonId": "string",
  "expensePersonName": "string",
  "expenseSystemSource": "string",
  "expenseReviewer": "string",
  "remark": "string",
  "realExpenseAmount": "string"
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

errcode

string

响应码

必需

0000成功，其他失败

description

string

描述

必需

traceId

string

追踪ID

必需

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

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

最后修改时间： 5 个月前