跳到主要内容

新增 BOM 物料配方更改

基本信息​

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

请求参数​

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"字段返回的是错误信息

调用范例​

Request​

一个商品物料关系产生一张物料配方更改单

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

Response​

{
    "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查看执行信息。