保存单据

测试环境(除税控、数电和扫码开票外的接口）

https://api-dev.piaozone.com/test

POST

/m4/fpzs/expense/entry/save

提示

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

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/json

Body 参数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

可选

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

<= 50 字符

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

封面编号

可选

有封面编号才会通知影像

<= 120 字符

applyOrganizationCode

string

提单组织编码

可选

影像环节使用

<= 100 字符

applyOrganizationName

string

提单组织名称

可选

影像环节使用

<= 100 字符

expensePersonId

string

报销人ID

可选

用于业务系统展示

<= 64 字符

expensePersonName

string

报销人名称

可选

用于业务系统展示

<= 64 字符

expenseSystemSource

string

报销系统来源

可选

用于业务系统展示

<= 100 字符

expenseReviewer

string

报销系统审核人

可选

用于业务系统展示

<= 100 字符

remark

string

单据备注

可选

用于业务系统展示

<= 1000 字符

realExpenseAmount

string

实际报销金额

可选

用于业务系统展示

<= 18 字符

示例

{
    "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"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api-dev.piaozone.com/test/m4/fpzs/expense/entry/save' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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成功

application/json

Body

errcode

string

响应码

必需

0000成功，其他失败

description

string

描述

必需

traceId

string

追踪ID

必需

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

示例

成功示例异常示例

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

修改于 2025-03-13 07:22:03

缓存单据

更新单据状态