BOM切割分装单保存

| 基本信息

信息	值	备注
接口名称	BOM切割分装单保存	根据单据ID来新增单据（包括修改）
请求状态	POST	RESTful方式
接口路径	http://localhost:23798/api/Bill/SaveBill	向服务器地址发送POST请求
远程模式	http://www.linkerplus.com/api/ext_erp/Bill/SaveBill	远程模式向服务器地址发送POST请求，需要ERP注册号注册远程模式，并在Headers添加sn参数

| 请求参数

Headers

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

Body

参数名称	类型	是否必须	参数值	备注	其它信息
HeadData	object	是		表头数据
EntryOrderId	string	否	WMS00001	调用方业务编码	调用方唯一编码，关联ERP单据，且避免重复提交，当提交的EntryOrderId重复时返回提示。为空则没有该项检测
CallId	string	是	MD	调用的单据识别号	"MD":表示BOM切割分装单
CallNo	string	否	MD0C240001	调用的单据号码	传入该值代表修改原单据信息，新增数据时无需添加
PrdNo	string	是	BCP1	切割成品
Unit	string	否	1	计量单位
DepNo	string	否	SCB	切割部门	部门代号
SalNo	string	否	CG001	经办人	业务员代号
WhNo	string	否	CW01	成品仓库	为空时默认取0000
BatNo	string	否	PH01	批号
PrdMark	string	否	TZ01	特征
IdNo	string	否	BCP1->1	配方
Qty	number	是	1	切割数量
Qty1	number	否	6	切割副数量
ExpMth	string	否	1	成本方式	1.不分摊2.分摊成本3.固定子件成本4.固定损失5.分摊损失；为空时默认取1
Cst	number	否	1	成品成本
Rem	string	否	这是表头备注	备注
UsrNo	string	否	ADMIN	制单人	账套验证的LoginId需添加UsrNo，用户登录的LoginId则无需添加UsrNo
ExtendProps	object	否	"CS_NO":"HT0C220001", “ZDY": "自定义"	表头扩展功能	包括表头的其它字段以及用户自定义字段，字段名需与数据库表名一致
NotUseAuditFlow	string	否	T/F	跳过审核流程，自动审核。默认不跳过	当传"T"时，该单据通过接口生成时，不考虑审核流程，直接自动终审
BodyData	object []	是		表身数据	item 类型: object
CallItm	number	否	1	原单项次	HeadData中CallNo存在并有值时才生效，传入该值代表修改原单据表身对应PRE_ITM列的信息，新增数据时无需添加
PrdNo	string	是	YL1	材料号
WhNo	string	否	003	材料库	为空时默认取0000
BatNo	string	否	PH01	批号
PrdMark	string	否	TZ01	特征
PrdLoc	string	否	CW01	储位
Unit	string	否	1	单位
Qty	number	是	3	主数量
Qty1	number	否	6	副数量
UseinNo	string	否	WZ1	组装位置
WhereUse	string	否	WH1	位号
Rem	string	否	这是表身摘要	摘要
IsDelete	string	否	F	删除行	CallItm存在并有值时才生效，传入该值为T代表删除原单据表身对应PRE_ITM列，不删除行时无需添加
ExtendProps	object	否	"CPY_SW":"1", “ZDY": "自定义", "SEQ_ITM":1	表身扩展功能	包括表身的其它字段以及用户自定义字段，字段名需与数据库表名一致

| 返回数据

参数名称	类型	参数值	备注
EntryOrderId	string	WMS00001	调用方业务编码
CallID	string	MD	调用的单据识别号
CallNO	string	MD0C240001	生成的单据号码
CallOK	string	T	执行是否成功, 是:"T" 否:"F"
Data	string	"TF_TABNAME": "TF_MB", "BIL_ITM": "0", "MF_TABNAME": "MF_MB", "BIL_NO": "MD0C240001", "BIL_ID": "MD"	单据信息,JOSN字符串格式
ErrorStr	string		错误信息

| 调用范例

BODY JSON

无需赋值的字段不需要添加，转入来源单或修改原单据时传入的字段代表修改原值

无来源示范
{
    "HeadData":{                            //必须,表头数据
        "EntryOrderId":"WMS00001",          //非必须,调用方业务编码
        "CallId":"MD",                      //必须,调用的单据识别号,"MD":表示BOM切割分装单
        "PrdNo":"BCP1",                     //必须,切割成品
        "Qty":"2"                           //必须,切割数量
    },
    "BodyData":[                            //必须,表身数据
        {
            "PrdNo":"YL1",                  //必须,材料号
            "Qty":3                         //必须,主数量
        },
        {
            "PrdNo":"YL2",                  //必须,材料号
            "Qty":6                         //必须,主数量
        }
    ]
}

完整字段
{
    "HeadData":{                            //必须,表头数据
        "EntryOrderId":"WMS00001",          //非必须,调用方业务编码
        "CallId":"MD",                      //必须,调用的单据识别号,"MD":表示BOM切割分装单
        "CallNo":"MD0C240001",              //非必须,调用的单据号码,传入该值代表修改原单据信息，新增数据时无需添加
        "PrdNo":"BCP1",                     //必须,切割成品
        "Unit":"1",                         //非必须,计量单位
        "DepNo":"CSB",                      //非必须,切割部门
        "WhNo":"001",                       //非必须,成品仓库
        "SalNo":"CG001",                    //非必须,经办人
        "BatNo":"PH01",                     //非必须,批号
        "PrdMark":"TZ01",                   //非必须,特征
        "IdNo":"BCP1->1",                   //非必须,配方
        "Qty":2,                            //必须,切割数量
        "Qty1":0,                           //非必须,切割副数量
        "ExpMth":"1",                       //非必须,成本方式
        "Cst":2,                            //非必须,成品成本
        "Rem":"这是表头备注",                 //非必须,备注
        "UsrNo":"ADMIN",                    //非必须,制单人,采用账套验证方式获取LoginId时必须
        "ExtendProps":{                     //非必须,扩展功能，包括表头的其他字段以及用户自定义字段
            "CS_NO":"HT0C220001"            //字段名需与数据库表名一致
        }
    },
    "BodyData":[                            //必须,表身数据
        {
            "CallItm":1,                    //非必须,原单项次，传入该值代表修改原单据表身对应PRE_ITM列的信息，新增数据时无需添加
            "PrdNo":"YL1",                  //必须,材料号
            "WhNo":"003",                   //非必须,材料库
            "BatNo":"PH01",                 //非必须,批号
            "PrdMark":"TZ01",               //非必须,特征
            "PrdLoc":"CW01",                //非必须,储位
            "Unit":"1",                     //非必须,单位
            "Qty":3,                        //必须,主数量
            "Qty1":6,                       //非必须,副数量
            "UseinNo":"WZ1",                //非必须,组装位置
            "WhereUse":"WH1",               //非必须,位号
            "Rem":"这是表身摘要",             //非必须,摘要
            "IsDelete":"F",                 //非必须,删除行，传入该值为T代表删除原单据表身对应PRE_ITM列，不删除行时无需添加
            "ExtendProps":{                 //非必须,扩展功能，包括表身的其他字段以及用户自定义字段
                "CPY_SW":"1"                //字段名需与数据库表名一致
            }
        }
    ]
}

添加序列号

无来源需添加SeqData
{
    "HeadData":{
        "EntryOrderId":"WMS00001",
        "CallId":"MD",              
        "PrdNo":"BCP1",                                        
        "Qty":"2"                          
    },
    "BodyData":[
        {
            "PrdNo":"XLH",                  //必须，序列号货品
            "Qty":2,                        //必须，需要和序列号数量总和相等
            "ExtendProps":{
                "SEQ_ITM":1                 //必须，需要对应SeqData中的"SEQ_ITM"
            }
        }
    ],
    "SeqData": [                            //必须，序列号数据
        {
            "SEQ_NO": "A01",                //必须，序列号
            "SEQ_ITM": 1,                   //必须，需要对应"BodyData""ExtendProps"中的"SEQ_ITM"
            "QTY": 1                        //必须，数量，固定为1
        },
        {
            "SEQ_NO": "A02",                //必须，序列号
            "SEQ_ITM": 1,                   //必须，需要对应"BodyData""ExtendProps"中的"SEQ_ITM"
            "QTY": 1                        //必须，数量，固定为1
        }
    ]
}

返回的JSON

{
    "EntryOrderId": "WMS00001",                         //调用方业务编码
    "CallID": "MD",                                     //调用的单据识别号
    "CallNO": "MD0C240001",                             //生成的单据号码
    "CallOK": "T",                                      //执行是否成功, 是:"T" 否:"F"
    "Data": "{\r\n  \"TF_TABNAME\": \"TF_MB\",\r\n  \"BIL_ITM\": \"0\",\r\n  \"MF_TABNAME\": \"MF_MB\",\r\n  \"BIL_NO\": \"MD0C240001\",\r\n  \"BIL_ID\": \"MD\"\r\n}",          //单据信息,JOSN字符串格式
    "ErrorStr": ""                                      //错误信息
}

| 备注

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

当采用的是账套验证获取的LoginId，那么HeadData中UsrNo就是制单人，不能为空。采用用户登录的LoginId则无需添加UsrNo，用户即制单人。

Body中JSON字段，尽量不要添加赋空值的字段。

ExtendProps中为拓展字段，需要对应数据库表的字段，自定义字段同样在这里处理。

统一字段与接口所需数据库表字段重复时，只取统一字段的值。

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

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

当HeadData中EntryOrderId不为空时，可查看后台表LOG_OTHERSAVE查看单据关联信息。

EntryOrderId：为同一次调用动作的唯一ID，全局唯一，建议采用随机uuid/guid；例如调用方请求第一次时，无响应信息或者响应错误后再请求一次时，该EntryOrderId应相同，为同一次调用动作。相反，调用方第一次调用返回成功信息后，删除了单据（无论删除ERP单据还是调用方单据），再重新调用一次，此时EntryOrderId是不能与没删除前的EntryOrderId相同。简而言之，只要调用接口返回成功信息后的EntryOrderId就不能再重复调用。