凭证回传

接口：common/voucher/back
Method：POST
数据格式：JSON
限流信息：100次每天和50次每小时
接口说明：
- 单据唯一值unique可自定义配置字段（联系开发），默认配置字段为document_num
- 凭证状态gl_status必填，可选值为generated(已生成)、error(错误)
- 凭证号journal_num当且仅当凭证状态为generated时必填，其余情况非必填
- 总账消息gl_message当且仅当凭证状态为error时可用，其余情况不可用
- 记账日期gl_date非必填，为空时默认取当前时间
- 帐套名称ledger_name非必填，为空时默认取单据上的主帐套
- 如需回传凭证文件时，需要提前上传文件获取文件地址
- 如需回传制单人时，poster_user_code和poster_user_name任选其一

参数

请求参数

字段名称	字段类型	字段描述	是否必填	长度
bizId	String	唯一标识	`TRUE`	36
timestamp	Long	时间戳	`TRUE`	13
data	Object	请求数据	`TRUE`	/
data.unique	String	单据唯一值	`TRUE`	64
data.gl_status	String	凭证状态	`TRUE`	16
data.journal_num	String	凭证号	`FALSE`	255
data.gl_message	String	总账消息	`FALSE`	255
data.gl_date	Long	记账日期	`FALSE`	13
data.ledger_name	String	帐套名称	`FALSE`	255
data.file_name	String	文件名	`FALSE`	255
data.attachment_url	String	文件地址	`FALSE`	255
data.poster_user_code	String	制单人员工号	`ONE-OF`¹	64
data.poster_user_name	String	制单人用户名	`ONE-OF`¹	64

返回参数

字段名称	字段类型	字段描述
resCode	Integer	响应状态码
resMsg	String	返回信息描述

示例

请求数据

{
    "bizId": "b5cb0e8e-8cf8-463e-a112-2c14461f559f",
    "timestamp": 1672502400000,
    "data": {
        "unique": "EXP0000000001",
        "journal_num": "VOU0000000001",
        "gl_status": "generated",
        "gl_date": 1672502400000,
        "ledger_name": "主帐套",
        "file_name": "11138732.pdf",
        "attachment_url": "11-13/out/238ad5d1-0g23-8243-2965-d9a1345b4cb2.pdf",
        "poster_user_code": "U00000001"
    }
}

{
    "bizId": "0fd4fcdb-fb8f-475f-a885-e5adc71ed747",
    "timestamp": 1672588800000,
    "data": {
        "unique": "EXP0000000002",
        "gl_status": "error",
        "gl_message": "记账失败, 错误代码E001"
    }
}

返回数据

{
    "resCode": 200000,
    "resMsg": "SUCCESS"
}

{
    "resCode": 400200,
    "resMsg": "制单人poster_user_code值[U00000001]不存在"
}

results matching ""

No results matching ""