单据审核

接口：执行审核（Audit/ExecuteAudit）

基本信息

信息	值	备注
接口名称	执行审核	执行审核
请求状态	POST	RESTful方式
接口路径	http://localhost:23798/api/Audit/ExecuteAudit	向服务器地址发送POST请求
远程模式	http://www.linkerplus.com/api/ext_erp/Audit/ExecuteAudit	远程模式向服务器地址发送POST请求，需要ERP注册号注册远程模式，并在Headers添加sn参数
支持日期	2018-06-01	自该日期起支持

请求参数

Headers

参数名称	是否必须	参数值	备注
Content-Type	是	application/json	用于指定数据的传输类型
LoginId	是	e835943e-55c2-4bf0-832d-6f4166592941	用户登录的LoginId，取用户登录或账套验证接口返回的LoginId
UsrNo	否	ADMIN	用户代号。账套验证的LoginId需添加UsrNo，用户登录的LoginId则无需添加UsrNo
sn	否	MGR_REST_1001	远程模式需添加sn参数，MGR_REST_ERP注册号

Body

参数名称	类型	是否必须	参数值	备注
BIL_ID	string	是	PC	单据类别，如PC：采购入库单、SA：销售出库单等
BIL_NO	string	是	PC202511260001	单据号码
APP_YN	string	是	Y	Y：审核同意、N：审核不同意
BIL_ITM	number	否		单据项次，传0或者不传该参数代表审核整单
REM_SH	string	否		审核理由
NODEINDEX	string	否	-1	存在审核路由时，传对应的的提交项，如果没有审核路由，预设传"-1"
EFF_DD	string	否	2025-11-26 12:22:12	生效日期，格式：yyyy-MM-dd HH:mm:ss，终审时才可以传值
REASON	string	否	YY0001	修改原因代号，终审时才可以传值
ISPRETOSTART	string	否	T	审核不同意直接退回到制单人，T/F

提示

单据BIL_ID可以从ERP数据库TbrSystem中的表DATAEX中确定

返回数据（200 OK）

参数名称	类型	参数值	备注
BIL_ID	string	SO	单据别。SO：销售订单、SA：销售出库单等等
BIL_NO	string	SO2025B260004	单据号码
BIL_ITM	number	0	单据项次
hasExistsNode	string	T	有无审核节点。T/F
NodeData	array	[{"NodeIndex":0,"NodeName":"010[审核]"},{"NodeIndex":1,"NodeName":"020[020]"}]	审核节点数据

返回数据（400 Bad Request）

参数名称	类型	参数值	备注
Message	string		审核异常信息

调用范例

请求

{
    "APP_YN": "Y", // "Y":审核同意， "N":审核不同意
    "BIL_ID": "SO", // 单据别，SO：销售订单
    "BIL_NO": "SO2025B260004", // 单号
    "BIL_ITM": 0, // 单据项次
    "REM_SH": "审核理由", // 理由
    "NODEINDEX": "-1", // 存在审核路由时的提交项，如果没有预设传 "-1"
    //"EFF_DD": "2025-07-30 16:09:00", // 生效日期，格式：yyyy-MM-dd HH:mm:ss，终审时才可以传值
    //"REASON": "原因代号", // 修改原因代号，终审时才可以传值
    "ISPRETOSTART": "T" // 审核不同意直接退回制单人 "T"、"F"
}

返回

成功（200 OK）：有审核节点

{
    "BIL_ID": "SO",
    "BIL_NO": "SO2025B260004",
    "BIL_ITM": 0,
    "hasExistsNode": "T",
    "NodeData": [
        {
            "NodeIndex": 0,
            "NodeName": "010[审核]"
        },
        {
            "NodeIndex": 1,
            "NodeName": "020[020]"
        }
    ]
}

成功（200 OK）：无审核节点

{
    "BIL_ID": "SO",
    "BIL_NO": "SO2025B260004",
    "BIL_ITM": 0,
    "hasExistsNode": "F",
    "NodeData": null
}

失败（400 Bad Request）

{
    "Message": "您不是单据[SO2025B260004]当前审核节点的审核人."
}

备注

注意

必须在Headers里面传入用户登录或账套验证的LoginId

注意

账套验证方式产生LoginId，则需要在Headers里传入UsrNo