概述
该接口主要用于第三方平台或自主研发者，通过调用【初盘单】的生成接口，将第三方的需要盘点的货品信息推送到Sunlike ERP或Online ERP系统中，从而生成Sunlike ERP或Online ERP系统的【初盘单】。
参数说明
1.请求方式
| 请求方式 |
POST |
| 接口地址 |
http://ERPAPI站点/DRPCP/ADDDATA |
| 格式 |
JSON |
| 编码类型 |
UTF-8 |
2.header参数
| Content-Type |
application/json |
| Authorization |
token |
授权接口所获取的值 |
3.请求参数
| 字段名称 |
字段代号 |
类型 |
长度 |
必填 |
固定值 |
备注 |
| 第三方单号 |
REF_NO |
|
|
是 |
|
第三方单号，必填 |
| 程序代号 |
PGM |
|
|
是 |
DRPCP |
|
| 字段名称 |
字段代号 |
类型 |
长度 |
必填 |
固定值 |
备注 |
| 数据表MF_CP |
| 单据别 |
CP_ID |
string |
2 |
是 |
QV |
|
| 单据号码 |
CP_NO |
string |
20 |
是 |
|
1.自动编码时，根据单据编码原则自动产生；
2.手工编码时，根据JSON的单据号码必填，且与REF_NO必须相同
3.目前删除和速查单据都只能通过online单号执行，不可以通过第三方单号，因此第三方须记录online单号 |
| 单据日期 |
CP_DD |
datetime |
0 |
是 |
|
格式为：YYYY-MM-DD |
| 单据类别 |
BIL_TYPE |
string |
10 |
|
|
|
| 盘点人 |
SAL_NO |
string |
12 |
|
|
|
| 部门 |
DEP |
string |
8 |
|
|
|
| 货架 |
SHELF |
string |
100 |
|
|
|
| 备注 |
REM |
string |
0 |
|
|
|
| 盘点单号 |
PT_NO |
string |
20 |
|
|
|
| 制单人 |
USR |
string |
12 |
是 |
|
|
| 制单时间 |
SYS_DATE |
datetime |
0 |
|
|
|
| 审核人 |
CHK_MAN |
string |
12 |
|
|
|
| 审核模板 |
MOB_ID |
string |
10 |
|
|
|
| 审核日期 |
CLS_DATE |
datetime |
0 |
|
|
|
| 最近修改人 |
MODIFY_MAN |
string |
12 |
|
|
|
| 最近修改时间 |
MODIFY_DD |
datetime |
0 |
|
|
|
| 锁单人 |
LOCK_MAN |
string |
12 |
|
|
|
| 锁单时间 |
LOCK_DATE |
datetime |
0 |
|
|
|
| 扫描人 |
SCAN_USR |
string |
12 |
|
|
|
| 扫描日期 |
SCAN_DATE |
datetime |
0 |
|
|
|
| 盘点单据别 |
CP_TYPE |
string |
1 |
是 |
|
1初盘单；2初盘单(批号）；3初盘单(序列号)；4初盘单(批号/非批号)；5初盘单(储位) |
| WMS产生的单据 |
WMS_ID |
string |
1 |
|
|
|
| 数据表TF_CP |
| 单据别 |
CP_ID |
string |
2 |
是 |
|
必须与MF_CP的CP_ID相同 |
| 单据号码 |
CP_NO |
string |
20 |
是 |
|
必须与MF_CP的CP_NO相同 |
| 项次 |
ITM |
integer |
0 |
是 |
|
|
| 货品代号 |
PRD_NO |
string |
30 |
是 |
|
|
| 特征 |
PRD_MARK |
string |
100 |
|
|
|
| 库位 |
WH |
string |
12 |
是 |
|
|
| 数量 |
QTY |
float |
0 |
|
|
|
| 批号 |
BAT_NO |
string |
40 |
|
|
|
| 摘要 |
REM |
string |
0 |
|
|
|
| 唯一项次 |
PRE_ITM |
integer |
0 |
|
|
|
| 单位 |
UNIT |
string |
1 |
是 |
|
|
| 数量否 |
QTY1 |
float |
0 |
|
|
|
| 箱号 |
NB_BOX_NO |
string |
255 |
|
|
|
| 储位代号 |
CHUW |
string |
60 |
|
|
|
4.自定义参数
| 字段名称 |
字段代号 |
类型 |
长度 |
是否 |
固定值 |
备注 |
| 数据表MF_CP_Z（表头自定义字段） |
| 自定义栏位1 |
自定义 |
string |
2 |
|
|
自定义字段可为文件、数字、日期、备注等类型，若为数字字段，可用于计算，例如自定义三个字段：JD_NO1,JD_NO2,JD_NO3，而JD_NO3=JD_NO1*JD_NO2，那么在JSON里只要上传JD_NO1和JD_NO2即可。 |
| 自定义栏位2 |
自定义 |
string |
|
|
|
| …… |
…… |
…… |
|
|
|
| 数据表TF_CP_Z（表头自定义字段） |
| 自定义栏位1 |
自定义 |
string |
2 |
|
|
自定义字段可为文件、数字、日期、备注等类型，若为数字字段，可用于计算，例如自定义三个字段：JD_NO1,JD_NO2,JD_NO3，而JD_NO3=JD_NO1*JD_NO2，那么在JSON里只要上传JD_NO1和JD_NO2即可。 |
| 自定义栏位2 |
自定义 |
string |
|
|
|
| …… |
…… |
…… |
|
|
|
请求JSON示例
{
"REF_NO": "QV20082600000001", //第三方单号，必填
"PGM": "DRPCP", //单据程序代号
"MF_CP": [ //新增单据表头信息
{
"CP_ID": "QV",
"CP_NO": "QV20082600000001",
"CP_DD": "2020-08-26 00:00:00",
"BIL_TYPE": "01",
"SAL_NO": "9999",
"DEP": "00000000",
"REM": "API产生",
"USR": "ADMIN",
"SYS_DATE": "2020-08-26 14:00:05",
"CP_TYPE": "4", //盘点单据别
"LJ_QV1": "外部单据" //新增单据表头自定义栏位信息
}
],
"TF_CP": [ //新增单据表身信息
{
"PRD_NO": "0001",
"PRD_NO1": "0001",
"PRD_MARK": "",
"WH": "9902",
"QTY": 100.0,
"SPC": "4L",
"BAR_CODE": "",
"CP_ID": "QV",
"CP_NO": "QV20082600000001",
"ITM": 1,
"ITM1": 3,
"PRE_ITM": 3,
"UNIT": "1",
"UT": "个",
"SIZE__NAME": "",
"GOOD__NAME": "",
"LJ_QV2": 10 //新增单据表身自定义栏位信息
},
{
"PRD_NO": "CA0002",
"PRD_NO1": "CA0002",
"PRD_MARK": "0101",
"WH": "9902",
"QTY": 100.0,
"BAT_NO": "20190515",
"BAT_NO__NAME": "酱油-P(2019-05-15)",
"BAR_CODE": "CA0002",
"CP_ID": "QV",
"CP_NO": "QV20082600000001",
"ITM": 2,
"ITM1": 4,
"PRE_ITM": 4,
"UNIT": "1",
"QTY1": 50000.0,
"UT": "包",
"SIZE": "01",
"GOOD": "01",
"SIZE__NAME": "S码",
"GOOD__NAME": "标准",
"LJ_QV2": 10
}
]
}
返回结果示例
{
"code": 0, //为0表示执行成功，其他表示错误
"message": "新增成功", //提示信息
"data": {
"MF_CP": [ //生成单据表头信息
{
"CP_ID": "QV",
"CP_NO": "QV20082600000001",
"CP_DD": "2020-08-26 00:00:00",
"BIL_TYPE": "01",
"SAL_NO": "9999",
"DEP": "00000000",
"REM": "API产生",
"USR": "ADMIN",
"SYS_DATE": "2020-08-26 14:30:54",
"CP_TYPE": "4",
"LJ_QV1": "外部单据"
}
],
"TF_CP": [ //生成单据表身信息
{
"PRD_NO": "0001",
"PRD_NO1": "0001",
"PRD_MARK": "",
"WH": "9902",
"QTY": 100.0,
"SPC": "4L",
"BAR_CODE": "",
"CP_ID": "QV",
"CP_NO": "QV20082600000001",
"ITM": 1,
"ITM1": 3,
"PRE_ITM": 3,
"UNIT": "1",
"UT": "个",
"LJ_QV2": 10.0
},
{
"PRD_NO": "CA0002",
"PRD_NO1": "CA0002",
"PRD_MARK": "0101",
"WH": "9902",
"QTY": 100.0,
"BAT_NO": "20190515",
"BAR_CODE": "CA0002",
"CP_ID": "QV",
"CP_NO": "QV20082600000001",
"ITM": 2,
"ITM1": 4,
"PRE_ITM": 4,
"UNIT": "1",
"QTY1": 50000.0,
"UT": "包",
"LJ_QV2": 10.0
}
],
"MF_CP_Z": [ //生成单据表头自定义栏位信息
{
"LJ_QV1": "外部单据",
"CP_ID": "QV",
"CP_NO": "QV20082600000001"
}
],
"TF_CP_Z": [ //生成单据表身自定义栏位信息
{
"LJ_QV2": 10.0,
"CP_ID": "QV",
"CP_NO": "QV20082600000001",
"ITM": 1
},
{
"LJ_QV2": 10.0,
"CP_ID": "QV",
"CP_NO": "QV20082600000001",
"ITM": 2
}
]
}
}