删除记账凭证接口

接口概述

该接口用于删除主体下已有的记账凭证，每次删除一条。

• 请求方式：DELETE

• 请求 URL：https://openapi.elven.com/open/v4/journal

请求头参数

参数名	类型	必填	说明
elven-api-key	String	是	分配给您的API密钥
elven-api-sign	String	是	请求签名，用于验证请求合法性
elven-api-timestamp	String	是	请求时间戳，毫秒级

查看详细说明

Body参数

参数名	类型	必填	说明
journalNo	String	是	要删除的数据源的sourceId
journalImportSourceName	String	否	Journal 所属的 Source 名称。若传入，则仅在该 Source 范围内删除；若不传，则不限制。

请求示例

{
    "journalNo":"abcde-00001",
    "journalImportSourceName":""
}

响应参数

参数名	类型	说明
status	String	请求状态，值为 “success” 或 “failed”
data	Object	返回的主要数据，如果成功删除将会返回删除数据的 journalNo
requestId	String	请求的唯一标识符

响应示例

{
    "status": "success",
    "data": {
        "journalNo": "JN202508130003"
    },
    "requestId": "7e7e1d7c-0665-43d3-8f0e-7dd3b64438f8"
}

注意事项

1. 单次仅能删除 1 条 Journal。

2. 被删除的 Journal 不可恢复，请谨慎调用。

3. 若同时提供 journalNo 与 journalImportSourceName，则系统仅在该 Source 范围内删除 Journal。

4. 系统会严格校验 Journal 状态，满足限制条件的 Journal 将拒绝删除并返回错误信息。

5. 操作会完整记录到安全日志，便于审计。

错误信息

错误原因	报错文案
journalNo 没有匹配到 Journal	No journal was matched for the provided Journal No.
journalNo 匹配到多个 Journal	Multiple journals were matched for the provided Journal No.
匹配到已经在对账任务中匹配或者解释的 Journal	The journal is matched or explained in a reconciliation task and cannot be deleted.
匹配到已审核状态 Journal	The journal is approved and cannot be deleted.
匹配到 Valuation Automation 生成的 Journal	The journal was generated by valuation automation and cannot be deleted.