概述
该接口主要用于第三方平台或自主研发者，通过调用【到货确认单】的生成接口，将第三方系统的库存到货确认的信息推送到Sunlike ERP或Online ERP系统中，从而生成Sunlike ERP或Online ERP系统的【到货确认单】。
参数说明
1.请求方式
| 请求方式 |
POST |
| 接口地址 |
http://ERPAPI站点/DRPIZ/ADDDATA |
| 格式 |
JSON |
| 编码类型 |
UTF-8 |
2.header参数
| Content-Type |
application/json |
| Authorization |
token |
授权接口所获取的值 |
3.请求参数
| 字段名称 |
字段代号 |
类型 |
长度 |
必填 |
固定值 |
备注 |
| 第三方单号 |
REF_NO |
|
|
是 |
|
第三方单号，必填 |
| 程序代号 |
PGM |
|
|
是 |
DRPIZWIN |
|
| 字段名称 |
字段代号 |
类型 |
长度 |
必填 |
固定值 |
备注 |
| 数据表MF_IZ |
| 单据类别 |
IZ_ID |
string |
2 |
是 |
|
|
| 到货号码 |
IZ_NO |
string |
20 |
是 |
|
1.自动编码时，根据单据编码原则自动产生；
2.手工编码时，根据JSON的单据号码必填，且与REF_NO必须相同
3.目前删除和速查单据都只能通过online单号执行，不可以通过第三方单号，因此第三方须记录online单号 |
| 到货日期 |
IZ_DD |
datetime |
0 |
是 |
|
格式为：YYYY-MM-DD |
| 客户代号 |
CUS_NO |
string |
12 |
是 |
|
|
| 部门代号 |
DEP |
string |
8 |
是 |
|
|
| 制单人 |
USR |
string |
12 |
是 |
|
|
| 成本别 |
FIX_CST |
string |
1 |
是 |
|
1固定成本；2变动成本 |
| 凭证模版代号 |
VOH_ID |
string |
2 |
|
|
|
| 凭证单号 |
VOH_NO |
string |
20 |
|
|
|
| 终审人员 |
CHK_MAN |
string |
12 |
|
|
|
| 终审日期 |
CLS_DATE |
datetime |
0 |
|
|
|
| 经办人 |
SAL_NO |
string |
12 |
|
|
|
| 附件单数 |
FJ_NUM |
integer |
0 |
|
|
|
| 备注 |
REM |
string |
0 |
|
|
|
| 输单日期 |
SYS_DATE |
datetime |
0 |
|
|
|
| 打印注记 |
PRT_SW |
string |
1 |
|
|
|
| 打印人员 |
PRT_USR |
string |
12 |
|
|
|
| 拷贝注记 |
CPY_SW |
string |
1 |
|
|
|
| 单据类别 |
BIL_TYPE |
string |
10 |
|
|
|
| 来源单据类别 |
IC_ID |
string |
2 |
|
|
|
| 来源单据号码 |
IC_NO |
string |
25 |
|
|
|
| 锁单人 |
LOCK_MAN |
string |
12 |
|
|
|
| 锁单时间 |
LOCK_DATE |
datetime |
0 |
|
|
|
| 作废标记 |
CANCEL_ID |
string |
1 |
|
|
|
| 审核模版 |
MOB_ID |
string |
10 |
|
|
|
| 工程案号 |
CAS_NO |
string |
20 |
|
|
|
| 销货单号 |
PS_NO |
string |
20 |
|
|
|
| 客户订单号 |
CUS_OS_NO |
string |
30 |
|
|
|
| 打印日期 |
PRT_DATE |
datetime |
0 |
|
|
|
| 阶段编号 |
TASK_ID |
integer |
0 |
|
|
|
| 离线单号 |
OFF_IZ_NO |
string |
50 |
|
|
|
| 最近修改日期 |
MODIFY_DD |
datetime |
0 |
|
|
|
| 最近修改人 |
MODIFY_MAN |
string |
12 |
|
|
|
| 扫描人 |
SCAN_USR |
string |
12 |
|
|
|
| 扫描日期 |
SCAN_DATE |
datetime |
0 |
|
|
|
| WMS产生的单据 |
WMS_ID |
string |
1 |
|
|
|
| 数据表TF_IZ |
| 单据类别 |
IZ_ID |
string |
2 |
是 |
|
必须与MF_IZ的IZ_ID相同 |
| 到货单号 |
IZ_NO |
string |
20 |
是 |
|
必须与MF_IZ的IZ_NO相同 |
| 项次 |
ITM |
integer |
0 |
是 |
|
|
| 单据唯一项次 |
KEY_ITM |
integer |
0 |
是 |
|
|
| 产品代号 |
PRD_NO |
string |
30 |
是 |
|
|
| 货品特征 |
PRD_MARK |
string |
100 |
|
|
|
| 到货单位 |
UNIT |
string |
1 |
是 |
|
|
| 到货库位 |
WH |
string |
12 |
是 |
|
|
| 到货批号 |
BAT_NO |
string |
40 |
|
|
|
| 到货数量 |
QTY |
float |
0 |
|
|
|
| 副单位数量 |
QTY1 |
float |
0 |
|
|
|
| 损耗量 |
QTY_LOST |
float |
0 |
|
|
|
| 损耗量(副) |
QTY1_LOST |
float |
0 |
|
|
|
| 到货单位成本 |
UP |
float |
0 |
|
|
|
| 到货成本 |
AMTN_NET |
float |
0 |
|
|
|
| 损耗成本 |
AMTN_LOST |
float |
0 |
|
|
|
| 备注 |
REM |
string |
0 |
|
|
|
| 成本别 |
FIX_CST |
string |
1 |
是 |
|
必须与MF_IZ的FIX_CST相同 |
| 来源单据类别 |
IC_ID |
string |
2 |
|
|
|
| 来源单号 |
IC_NO |
string |
20 |
|
|
|
| 来源项次 |
IC_ITM |
integer |
0 |
|
|
|
| 来源单日期 |
IC_DD |
datetime |
0 |
|
|
|
| 原料成本 |
CST_ML |
float |
0 |
|
|
|
| 直接人工 |
CST_MAN |
float |
0 |
|
|
|
| 制造费用 |
CST_MAK |
float |
0 |
|
|
|
| 耗用物料 |
CST_PRD |
float |
0 |
|
|
|
| 托工费用 |
CST_OUT |
float |
0 |
|
|
|
| 单位成本(主单位) |
UP_MAIN |
float |
0 |
|
|
|
| 标准成本 |
CST_STD |
float |
0 |
|
|
|
| 原料成本(标) |
CST_STD_ML |
float |
0 |
|
|
|
| 直接人工(标) |
CST_SMAN |
float |
0 |
|
|
|
| 耗用物料(标) |
CST_SPRD |
float |
0 |
|
|
|
| 制造费用(标) |
CST_SMAK |
float |
0 |
|
|
|
| 托工费用(标) |
CST_SOUT |
float |
0 |
|
|
|
| 包装单位 |
PAK_UNIT |
string |
20 |
|
|
|
| 包装换算 |
PAK_EXC |
float |
0 |
|
|
|
| 净重(单) |
PAK_NW_N |
float |
0 |
|
|
|
| 包装净重 |
PAK_NW |
float |
0 |
|
|
|
| 包装净重单位 |
PAK_WEIGHT_UNIT |
string |
8 |
|
|
|
| 毛重(单) |
PAK_GW_N |
float |
0 |
|
|
|
| 包装毛重 |
PAK_GW |
float |
0 |
|
|
|
| 包装大小 |
PAK_MEAST |
float |
0 |
|
|
|
| 包装大小单位 |
PAK_MEAST_UNIT |
string |
8 |
|
|
|
| 单位标准成本 |
UP_STD |
float |
0 |
|
|
|
| 产品名称 |
PRD_NAME |
string |
160 |
|
|
|
| 异常处理状态 |
DEAL_ID |
string |
1 |
|
|
|
| 异常处理说明 |
DEAL_REM |
string |
0 |
|
|
|
| 受定单价 |
UP_SO |
float |
0 |
|
|
|
| 受定金额 |
AMT_SO |
float |
0 |
|
|
|
| 差异受定金额 |
AMT_DIFF_SO |
float |
0 |
|
|
|
| 搭赠品否 |
FREE_ID |
string |
1 |
|
|
|
| 包装类型 |
BZ_KND |
string |
20 |
|
|
|
| 受定单价（副） |
UP_QTY1_SO |
float |
0 |
|
|
|
| 实际到货单价 |
UP_IN |
float |
0 |
|
|
|
| 实际到货金额 |
AMTN_NET_IN |
float |
0 |
|
|
|
| 折扣 |
DIS_CNT |
float |
0 |
|
|
|
| 阶段编号 |
TASK_NO |
string |
30 |
|
|
|
| 促销代号 |
PRM_NO |
string |
20 |
|
|
|
| 储位代号 |
CHUW |
string |
60 |
|
|
|
4.自定义参数
| 字段名称 |
字段代号 |
类型 |
长度 |
是否 |
固定值 |
备注 |
| 数据表MF_IZ_Z（表头自定义字段） |
| 自定义栏位1 |
自定义 |
string |
2 |
|
|
自定义字段可为文件、数字、日期、备注等类型，若为数字字段，可用于计算，例如自定义三个字段：JD_NO1,JD_NO2,JD_NO3，而JD_NO3=JD_NO1*JD_NO2，那么在JSON里只要上传JD_NO1和JD_NO2即可。 |
| 自定义栏位2 |
自定义 |
string |
|
|
|
| …… |
…… |
…… |
|
|
|
| 数据表TF_IZ_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": "IZ20083100000001", //第三方单号，必填
"PGM": "DRPIZWIN", //单据程序代号
"MF_IZ": [ //新增单据表头信息
{
"IZ_ID": "IZ",
"IZ_NO": "IZ20083100000001",
"IZ_DD": "2020-08-31 00:00:00",
"CUS_NO": "C2004",
"DEP": "C2",
"USR": "ADMIN",
"BIL_TYPE":"",
"SAL_NO": "9999",
"REM": "API产生",
"IC_ID": "IO",
"IC_NO": "IO20082600000001"
}
],
"TF_IZ": [ //新增单据表身信息
{
"BAR_CODE": "",
"QTY_IC": 5.0,
"QTY_CFM": 0.0,
"SPC": "4L",
"WH1": "9902",
"IZ_ID": "IZ",
"IZ_NO": "IZ20083100000001",
"ITM": 1,
"KEY_ITM": 3,
"PRD_NO": "0001",
"PRD_MARK": "",
"UNIT": "1",
"WH": "C2004",
"QTY": 4.0,
"QTY_LOST": 1.0,
"UP": 123.0,
"AMTN_NET": 492.0,
"AMTN_LOST": 123.0,
"FIX_CST": "1",
"IC_ID": "IO",
"IC_NO": "IO20082600000001",
"IC_ITM": 1,
"IC_DD": "2020-08-26 00:00:00",
"CST_STD": 0.0,
"UP_STD": 0.0,
"PRD_NAME": "不粘锅",
"DEAL_ID": "F",
"AMT_SO": 0.0,
"AMT_DIFF_SO": 0.0,
"UP_IN": 123.0,
"AMTN_NET_IN": 492.0,
"PRM_NO": "",
"PRD_NO_NO": "0001",
"QTY_KZ_ORG": 5.0,
"SIZE__NAME": "",
"GOOD__NAME": ""
}
]
}
返回结果示例
{
"code": 0, //为0表示执行成功，其他表示错误
"message": "新增成功", //提示信息
"data": {
"MF_IZ": [ //生成单据表头信息
{
"IZ_ID": "IZ",
"IZ_NO": "IZ20083100000001",
"IZ_DD": "2020-08-31 00:00:00",
"CUS_NO": "C2004",
"DEP": "C2",
"USR": "ADMIN",
"CHK_MAN": "ADMIN",
"CLS_DATE": "2020-08-31 00:00:00",
"SAL_NO": "9999",
"REM": "API产生",
"SYS_DATE": "2020-08-31 12:05:37",
"BIL_TYPE": "",
"IC_ID": "IO",
"IC_NO": "IO20082600000001"
}
],
"TF_IZ": [ //生成单据表身信息
{
"BAR_CODE": "",
"QTY_IC": 5.0,
"QTY_CFM": 5.0,
"SPC": "4L",
"WH1": "9902",
"IZ_ID": "IZ",
"IZ_NO": "IZ20083100000001",
"ITM": 1,
"KEY_ITM": 3,
"PRD_NO": "0001",
"PRD_MARK": "",
"UNIT": "1",
"WH": "C2004",
"QTY": 4.0,
"QTY_LOST": 1.0,
"UP": 123.0,
"AMTN_NET": 492.0,
"AMTN_LOST": 123.0,
"FIX_CST": "1",
"IC_ID": "IO",
"IC_NO": "IO20082600000001",
"IC_ITM": 1,
"IC_DD": "2020-08-26 00:00:00",
"CST_STD": 0.0,
"UP_STD": 0.0,
"PRD_NAME": "不粘锅",
"DEAL_ID": "F",
"AMT_SO": 0.0,
"AMT_DIFF_SO": 0.0,
"UP_IN": 123.0,
"AMTN_NET_IN": 492.0,
"PRM_NO": "",
"PRD_NO_NO": "0001",
"QTY_KZ_ORG": 5.0
}
]
}
}