跳到主要内容

新增BOM物料配方更改

| 基本信息​

信息值备注
接口名称新增BOM物料配方更改根据货品代号和版本号新增BOM物料配方更改
请求状态POSTRESTful方式
接口路径http://localhost:23798/api/Bom/AppendToEnc向服务器地址发送POST请求
远程模式http://www.linkerplus.com/api/ext_erp/Bom/AppendToEnc远程模式向服务器地址发送POST请求，需要ERP注册号注册远程模式，并在Headers添加sn参数

| 请求参数​

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​

参数名称类型是否必须参数值备注其它信息
object []是商品物料数据item 类型: object
PRD_NOstring是BCP1货品代号原商品物料表头存在的PRD_NO
PF_NOstring否1.0版本号原商品物料表头存在的PF_NO
BodyDataobject []是表身数据item 类型: object
PRD_NOstring是YL1货品代号该货品代号必须在系统货品资料存在，不存在的请先新增货品资料
PF_NOstring否2.0版本号该节点存在代表存在下层物料
PRD_MARKstring否TZ1货品特征
WH_NOstring否CK1仓库该仓库代号必须在系统仓库资料存在，不存在的请先新增仓库资料。为空时默认取0000
BOM_IDstring否Y是否虚拟件
QTYnumber否2用量
PRD_NO_CHGstring否YL2替代品代号该货品代号必须在系统货品资料存在，不存在的请先新增货品资料
ZC_NOstring否ZC1制程号码该制程代号必须在系统制程资料存在，不存在的请先新增制程资料
TW_IDstring否1是否托外
USEIN_NOstring否ZZ1组装代号该组装代号必须在系统组装资料存在，不存在的请先新增组装资料
QTY_BASnumber否1基数
LOS_RTOnumber否20损耗率
CSTnumber否5标准成本
PZ_IDstring否PZ配置信息
REMstring否这是商品物料表表身摘要

| 返回数据​

参数名称类型参数值备注其它信息
OkCountnumber1新增成功数
ErrorCountnumber1新增失败数
ErrorDataobject[]失败的数据"ErrorMsg"字段返回的是错误信息

| 调用范例​

BODY JSON​

一个商品物料关系产生一张物料配方更改单
[
    {                               //一个商品物料关系
        "PRD_NO": "ZCP",            //制成品货品代号 
        "PF_NO": "2.0",             //制成品版本号 
        "BodyData": [               //组成制成品的下级物料    
            {
                "PRD_NO": "BCP",    //半成品货品代号        
                "PF_NO": "1.0",     //半成品版本号，这里的货品代号与版本号就能关联前面的半成品
                "QTY": 2            //用量       
            },
            {
                "PRD_NO": "YL2",    //制成品的原料代号
                "QTY": 2            //用量       
            }
        ]
    }
]

返回的JSON​

{
    "OkCount": 0,                                //新增成功数
    "ErrorCount": 1,                             //新增失败数
    "ErrorData": [                               //失败的数据
        {
            "PRD_NO": "ZCP",
            "PF_NO": "2.0",
            "BodyData": [
                {
                    "PRD_NO": "BCP",
                    "PF_NO": "1.0",
                    "QTY": 2
                },
                {
                    "PRD_NO": "YL2",
                    "QTY": 2
                }
            ],
            "ErrorMsg": "子件货品代号[YL2]不存在." //错误信息
        }
    ]
}

| 备注​

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

请求参数与返回信息与新增商品物料接口一致，接口自动处理产生BOM物料配方更改单据。

注意BodyData会与原数据比较，当BodyData存在、原数据不存在时会新增表身记录，当BodyData存在、原数据也存在时会修改表身记录、当BodyData不存在、原数据存在时删除表身记录，所以BodyData中要包含调用系统商品物料表表身的所有数据。

新增完的BOM物料配方更改单据，需要登录ERP系统手动执行更改。

接口程序不处理审核，没有审核流直接终审，有审核流就处于未审状态。

可查看后台表LOG_BILLSAVE查看执行信息。