生成【非生产退料单】接口
概述
该接口主要用于第三方平台或自主研发者，通过调用【非生产退料单】的生成接口，将第三方系统用于非生产原材料或物料退回的信息推送到Sunlike ERP或Online ERP系统中，从而生成Sunlike ERP或Online ERP系统的【非生产退料单】。
参数说明
1.请求方式
| 请求方式 | POST | |||||
| 接口地址 | http://ERPAPI站点/DRPIJ/ADDDATA | |||||
| 格式 | JSON | |||||
| 编码类型 | UTF-8 | |||||
2.header参数
| Content-Type | application/json | |||||
| Authorization | token | 授权接口所获取的值 | ||||
3.请求参数
| 字段名称 | 字段代号 | 类型 | 长度 | 必填 | 固定值 | 备注 |
| 第三方单号 | REF_NO | 是 | 第三方单号，必填 | |||
| 程序代号 | PGM | 是 | DRPXE | |||
| 字段名称 | 字段代号 | 类型 | 长度 | 必填 | 固定值 | 备注 |
| 数据表MF_IJ | ||||||
| 单据别(IJ;IQ;XA;XB;XC;XD;XE;XF;XG) | IJ_ID | string | 2 | 是 | XE | |
| 调整单号 | IJ_NO | string | 20 | 是 | 1.自动编码时，根据单据编码原则自动产生； 2.手工编码时，根据JSON的单据号码必填，且与REF_NO必须相同 3.目前删除和速查单据都只能通过online单号执行，不可以通过第三方单号，因此第三方须记录online单号 |
|
| 调整日期 | IJ_DD | datetime | 是 | 格式为：YYYY-MM-DD | ||
| 调整原因 | IJ_REASON | string | 4 | |||
| 成本别 | FIX_CST | string | 1 | 是 | 1固定成本；2变动成本 | |
| 借方会计科目 | ACC_NO_D | string | 20 | |||
| 贷方会计科目 | ACC_NO_C | string | 20 | |||
| 部门代号 | DEP | string | 8 | 是 | ||
| 凭证模版代号 | VOH_ID | string | 2 | |||
| 凭证号码 | VOH_NO | string | 20 | |||
| 盘点单号 | REF_NO | string | 20 | |||
| 批号 | BAT_NO | string | 40 | |||
| 经办人 | MAN_NO | string | 12 | |||
| 摘要 | REM | string | 30 | |||
| 录入员 | USR | string | 12 | 是 | ||
| 审核注记 | CHK_MAN | string | 12 | |||
| 打印注记 | PRT_SW | string | 1 | |||
| 拷贝注记 | CPY_SW | string | 1 | |||
| 来源单号 | BIL_NO | string | 20 | |||
| 来源单ID | BIL_ID | string | 2 | |||
| 终审日期 | CLS_DATE | datetime | ||||
| POS调整单跳号数量 | IJID | float | ||||
| 工程案号 | CAS_NO | string | 20 | |||
| 单据类别 | BIL_TYPE | string | 10 | |||
| 合同编号 | CNTT_NO | string | 40 | |||
| 标准成本损失 | ACC_NO_SS | string | 20 | |||
| 标准成本收益 | ACC_NO_SY | string | 20 | |||
| 审核模版 | MOB_ID | string | 10 | |||
| 锁单人 | LOCK_MAN | string | 12 | |||
| 锁单时间 | LOCK_DATE | datetime | 0 | |||
| 附件张数 | FJ_NUM | integer | ||||
| 输单日期 | SYS_DATE | datetime | ||||
| 区分来源POS单号标志 | POS_ID | string | 1 | |||
| 客户代号 | CUS_NO | string | 12 | |||
| 任务编号 | TASK_ID | integer | 0 | |||
| 打印人 | PRT_USR | string | 12 | |||
| 申请单ID | SQ_ID | string | 2 | |||
| 申请单号 | SQ_NO | string | 25 | |||
| 申请单项次 | SQ_ITM | integer | 0 | |||
| 是维修单 | ISSVS | string | 1 | |||
| 是否成本计算自动产生的单据 | FROMCB_CALC | string | 1 | |||
| 计划/受订单号 | JH_SO_NO | string | 20 | |||
| 调整发票差额 | TZZG | string | 1 | |||
| 作业人员代号(可多个) | YG_NO | string | 65 | |||
| 作废标记 | CANCEL_ID | string | 1 | |||
| 功能货币 | CUR_ID_IFRS | string | 4 | |||
| 汇率(功能货币) | EXC_RTO_IFRS | float | 0 | |||
| 打印日期 | PRT_DATE | datetime | 0 | |||
| 最近修改日期 | MODIFY_DD | datetime | 0 | |||
| 最近修改人 | MODIFY_MAN | string | 12 | |||
| 扫描状态 | SCAN_ID | string | 1 | |||
| 扫描人 | SCAN_USR | string | 12 | |||
| 扫描日期 | SCAN_DATE | datetime | 0 | |||
| 扫描人 | SCAN_USR1 | string | 12 | |||
| 扫描日期 | SCAN_DATE1 | datetime | 0 | |||
| 集团单据唯一值 | GROUP_KEY | string | 100 | |||
| 预设仓库向荣专案 | PRE_WH | string | 20 | |||
| 合同 | CONTRACT | string | 80 | |||
| 工程人员 | CAS_MAN | string | 12 | |||
| WMS产生的单据 | WMS_ID | string | 1 | |||
| 阿米巴转入 | AMB_I | string | 20 | |||
| 字段名称 | 字段代号 | 类型 | 长度 | 必填 | 固定值 | 备注 |
| 数据表TF_IJ | ||||||
| 单据别(IJ;IQ;XA;XB;XC;XD;XE;XF;XG) | IJ_ID | string | 2 | 是 | 必须与表MF_IJ的IJ_ID相同 | |
| 调整单号 | IJ_NO | string | 20 | 是 | 必须与表MF_IJ的IJ_NO相同 | |
| 项次 | ITM | integer | 是 | |||
| 调整日期 | IJ_DD | datetime | 是 | |||
| 货品代号 | PRD_NO | string | 30 | 是 | ||
| 品名 | PRD_NAME | string | 160 | |||
| 货品特征 | PRD_MARK | string | 100 | |||
| 库位 | WH | string | 12 | 是 | ||
| 单位 | UNIT | string | 1 | 是 | ||
| 数量 | QTY | float | ||||
| 副单位数量 | QTY1 | float | ||||
| 成本 | CST | float | ||||
| 成本别 | FIX_CST | string | 1 | 是 | 必须与表MF_IJ的FIX_CST相同 | |
| 批号 | BAT_NO | string | 40 | |||
| 摘要 | REM | string | 200 | |||
| 标准成本 | CST_STD | float | ||||
| 配方号 | ID_NO | string | 38 | |||
| POS调整单跳号数量 | IJID | float | ||||
| 合同编号 | CNTT_NO | string | 40 | |||
| 鞋服组合栏位 | COMPOSE_IDNO | string | 50 | |||
| 来源单ID | BIL_ID | string | 2 | |||
| 来源单号 | BIL_NO | string | 20 | |||
| 历次变动项 | PRE_ITM | integer | ||||
| 单据项次 | EST_ITM | integer | ||||
| 报废原因 | SPC_NO | string | 10 | |||
| 对方货号 | SUP_PRD_NO | string | 40 | |||
| 追踪项次 | KEY_ITM | integer | 0 | |||
| 追踪箱条码 | BOX_ITM | integer | 0 | |||
| 单价 | UP | float | 0 | |||
| 有效期 | VALID_DD | datetime | 0 | |||
| 入库日期 | RK_DD | datetime | 0 | |||
| 金额 | AMTN | float | 0 | |||
| 申请单ID | SQ_ID | string | 2 | |||
| 申请单号 | SQ_NO | string | 25 | |||
| 申请项次 | SQ_ITM | integer | 0 | |||
| 集团公司代号 | DEP_RK | string | 8 | |||
| 配位项次 | PW_ITM | integer | 0 | |||
| 订单原料 | PRD_NO_SO_RES | string | 30 | |||
| 原料成本 | CST_ML | float | 0 | |||
| 直接人工 | CST_MAN | float | 0 | |||
| 制造费用 | CST_MAK | float | 0 | |||
| 耗用物料 | CST_PRD | float | 0 | |||
| 托工费用 | CST_OUT | float | 0 | |||
| 原料成本(标) | CST_STD_ML | float | 0 | |||
| 直接人工(标) | CST_SMAN | float | 0 | |||
| 制造费用(标) | CST_SMAK | float | 0 | |||
| 耗用物料(标) | CST_SPRD | float | 0 | |||
| 托工费用(标) | CST_SOUT | float | 0 | |||
| 单位成本(主单位) | UP_MAIN | 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 | |||
| 合格转入标识 | QC_FLAG | string | 2 | |||
| 单位标准成本 | UP_STD | float | 0 | |||
| 对方特征 | SUP_PRD_MARK | string | 100 | |||
| 矩阵项次 | MATRIX_ITM | integer | 0 | |||
| 增减标志 | ADD_ID | string | 1 | 是 | – |
+：表示调增 -：表示调减 |
| 生产日期 | SC_DD | datetime | 0 | |||
| 已处理代销标志 | GROUP_HDL_DX | string | 1 | |||
| 来源单项次 | BIL_ITM | integer | 0 | |||
| 实际长度 | FAC_LEN | float | 0 | |||
| 标准配置代号 | XPM_NO | string | 20 | |||
| 选配配置代号 | XPM_NO1 | string | 20 | |||
| 需足量 | CHK_XZL | string | 1 | |||
| 新货品代号 | PRD_NO_NEW | string | 30 | |||
| 替代系数 | QTY_CHG_RTO | float | 0 | |||
| 替代比率 | CHG_RTO | string | 200 | |||
| 替代项次 | CHG_ITM | integer | 0 | |||
| 替代品 | PRD_NO_CHG | string | 255 | |||
| 储位代号 | CHUW | string | 60 | |||
| 替代比率分母 | CHG_RTO_BAS | float | 0 | |||
请求JSON示例
{ "REF_NO": "XE20082600000001", //第三方单号，必填 "PGM": "DRPXE", //单据识别代号 "MF_IJ": [ //新增单据表头信息 { "IJ_ID": "XE", "IJ_NO": "XE20082600000001", "IJ_DD": "2020-08-26 00:00:00", "FIX_CST": "1", "DEP": "00000000", "MAN_NO": "9999", "REM": "API产生", "USR": "ADMIN", "BIL_TYPE": "", "LJ_XE1": "外部单据" //新增单据表头自定义栏位信息 } ], "TF_IJ": [ //新增单据表身信息 { "ADD_ID": "+", "IJ_ID": "XE", "IJ_NO": "XE20082600000001", "ITM": 1, "IJ_DD": "2020-08-26 00:00:00", "PRD_NO": "0001", "PRD_NAME": "不粘锅", "PRD_MARK": "", "SPC": "4L", "WH": "9902", "UNIT": "1", "QTY": 10.0, "CST": 1117.738, "CST_STD": 0.0, "KEY_ITM": 1, "UP": 111.7738, "PRD_NO_NO": "0001", "CST_STD_UNIT": 0.0, "LJ_XE2": 10.0, //新增单据表身自定义栏位信息 "PRDNO": "0001" } ] }
返回结果示例
{ "code": 0, //为0表示执行成功，其他表示错误 "message": "新增成功", //提示信息 "data": { "MF_IJ": [ //生成单据表头信息 { "IJ_ID": "XE", "IJ_NO": "XE20082600000001", "IJ_DD": "2020-08-26 00:00:00", "FIX_CST": "1", "DEP": "00000000", "MAN_NO": "9999", "REM": "API产生", "USR": "ADMIN", "CHK_MAN": "ADMIN", "PRT_SW": "N", "CLS_DATE": "2020-08-26 00:00:00", "BIL_TYPE": "", "SYS_DATE": "2020-08-26 12:21:30", "LJ_XE1": "外部单据" } ], "TF_IJ": [ //生成单据表身信息 { "ADD_ID": "+", "IJ_ID": "XE", "IJ_NO": "XE20082600000001", "ITM": 1, "IJ_DD": "2020-08-26 00:00:00", "PRD_NO": "0001", "PRD_NAME": "不粘锅", "PRD_MARK": "", "SPC": "4L", "WH": "9902", "UNIT": "1", "QTY": 10.0, "CST": 1117.738, "CST_STD": 0.0, "FIX_CST": "1", "KEY_ITM": 1, "UP": 111.7738, "PRE_ITM": 1, "PRD_NO_NO": "0001", "CST_STD_UNIT": 0.0, "LJ_XE2": 10.0 } ], "MF_IJ_Z": [ //生成单据表头自定义栏位信息 { "LJ_XE1": "外部单据", "IJ_ID": "XE", "IJ_NO": "XE20082600000001" } ], "TF_IJ_Z": [ //生成单据表身自定义栏位信息 { "LJ_XE2": 10.0, "IJ_ID": "XE", "IJ_NO": "XE20082600000001", "ITM": 1 } ] } }