生成【生产缴库验收单】接口
概述
该接口主要用于第三方平台或自主研发者,通过调用【生产缴库验收单】的生成接口,将第三方系统的生产制成品缴库验收的信息推送到Sunlike ERP或Online ERP系统中,从而生成Sunlike ERP或Online ERP系统的【生产缴库验收单】。
参数说明
1.请求方式
| 请求方式 | POST | |||||
| 接口地址 | http://ERPAPI站点/MRPTY/ADDDATA | |||||
| 格式 | JSON | |||||
| 编码类型 | UTF-8 | |||||
2.header参数
| Content-Type | application/json | |||||
| Authorization | token | 授权接口所获取的值 | ||||
3.请求参数
| 字段名称 | 字段代号 | 类型 | 长度 | 必填 | 固定值 | 备注 |
| 第三方单号 | REF_NO | 是 | 第三方单号,必填 | |||
| 程序代号 | PGM | 是 |
MRPBN
|
|||
| 字段名称 | 字段代号 | 类型 | 长度 | 必填 | 固定值 | 备注 |
| 数据表MF_TY | ||||||
| 验收识别 | TY_ID | string | 2 | 是 | TP | |
| 验收单号 | TY_NO | string | 20 | 是 | 1.自动编码时,根据单据编码原则自动产生; 2.手工编码时,根据JSON的单据号码必填,且与REF_NO必须相同 3.目前删除和速查单据都只能通过online单号执行,不可以通过第三方单号,因此第三方须记录online单号 |
|
| 验收日 | TY_DD | datetime | 是 | 格式为:YYYY-MM-DD | ||
| 验收员 | SAL_NO | string | 12 | |||
| 结案否 | CLOSE_ID | string | 1 | |||
| 托工厂商 | CUS_NO | string | 12 | 是 | ||
| 转入单号 | TI_NO | string | 25 | |||
| 转出单号 | TB_NO | string | 20 | |||
| 备注 | REM | string | 100 | |||
| 制单人 | USR | string | 12 | 是 | ||
| 审核人 | CHK_MAN | string | 12 | |||
| 列印注记 | PRT_SW | string | 1 | |||
| 拷贝注记 | CPY_SW | string | 1 | |||
| 验收退回单结案否 | PRE_CLS_ID | string | 1 | |||
| 检验项目清单 | PRD_LIST | string | 80 | |||
| 来源单号 | BIL_NO | string | 20 | |||
| 来源单识别 | BIL_ID | string | 2 | |||
| 终审日期 | CLS_DATE | datetime | ||||
| 链接文档 | OLEFIELD | string | 100 | |||
| 单据类别 | BIL_TYPE | string | 10 | |||
| 部门 | DEP | string | 8 | |||
| 厂商订单 | CUS_OS_NO | string | 30 | |||
| 审核模版 | MOB_ID | string | 10 | |||
| 锁单人 | LOCK_MAN | string | 12 | |||
| 锁单时间 | LOCK_DATE | datetime | 0 | |||
| 输单日期 | SYS_DATE | datetime | ||||
| 入库单ID | TI_ID | string | 2 | |||
| 退回分销仓库 | FX_WH | string | 12 | |||
| 结案(合格量) | CLS_ID_OK | string | 1 | |||
| 结案(不合格量) | CLS_ID_LOST | string | 1 | |||
| 模板代号 | VOH_ID | string | 2 | |||
| 传票代号 | VOH_NO | string | 20 | |||
| 立帐方式 | ZHANG_ID | string | 1 | |||
| 税别 | TAX_ID | string | 1 | |||
| 立帐单号 | ARP_NO | string | 20 | |||
| 币别 | CUR_ID | string | 4 | |||
| 汇率 | EXC_RTO | float | 0 | |||
| 打印人员 | PRT_USR | string | 12 | |||
| 合同编号 | CNTT_NO | string | 40 | |||
| 检验类型(1.常规检验,2.复检) | CHK_KND | string | 1 | 是 | 默认值为1 | |
| 作废标记 | CANCEL_ID | string | 1 | |||
| 打印日期 | PRT_DATE | datetime | 0 | |||
| 最近修改日期 | MODIFY_DD | datetime | 0 | |||
| 最近修改人 | MODIFY_MAN | string | 12 | |||
| 扫描状态 | SCAN_ID | string | 1 | |||
| 扫描人 | SCAN_USR | string | 12 | |||
| 扫描日期 | SCAN_DATE | datetime | 0 | |||
| 影响采购单中的收料数量 | SL_ID | string | 1 | |||
| WMS产生的单据 | WMS_ID | string | 1 | |||
| 数据表TF_TY | ||||||
| 验收识别 | TY_ID | string | 2 | 是 | TP | |
| 验收单号 | TY_NO | string | 20 | 是 | 必须与MF_TY的TY_NO相同 | |
| 项次 | ITM | integer | 0 | 是 | ||
| 品号 | PRD_NO | string | 30 | 是 | ||
| 品名 | PRD_NAME | string | 160 | |||
| 货品特征 | PRD_MARK | string | 100 | |||
| 库位 | WH | string | 12 | 是 | ||
| 单位 | UNIT | string | 1 | 是 | ||
| 验收量 | QTY_CHK | float | 0 | 是 | ||
| 合格量 | QTY_OK | float | 0 | |||
| 不合格量 | QTY_LOST | float | 0 | |||
| 实际入库量 | QTY_RTN | float | 0 | |||
| 备注 | REM | string | 40 | |||
| 来源单号 | BIL_NO | string | 20 | |||
| 入库单号 | TI_NO | string | 20 | |||
| 批号 | BAT_NO | string | 40 | |||
| 制令单号 | MO_NO | string | 20 | |||
| 拷贝注记 | CPY_SW | string | 1 | |||
| 原因代号 | SPC_NO | string | 10 | |||
| 处理模式 | PRC_ID | string | 1 | |||
| 产生单据(QTY_LOST) | BUILD_BIL | string | 26 | |||
| 产生单据类别 | BUILD_BIL_ID | string | 2 | |||
| 追踪已交数量项次 | EST_ITM | integer | 0 | |||
| 产生单据(QTY_OK) | MM_NO | string | 20 | |||
| 原验收单项次 | PRE_ITM | integer | 0 | |||
| 退回数量 | QTY_PRE | float | 0 | |||
| 未审核退回量 | QTY_PRE_UNSH | float | 0 | |||
| 制程代号 | ZC_NO | string | 10 | |||
| 配方号 | ID_NO | string | 38 | |||
| 折价 | QC_UP | float | 0 | |||
| 验收量(副) | QTY1_CHK | float | 0 | |||
| 验收合格量[副] | QTY1_OK | float | 0 | |||
| 不合格量[副] | QTY1_LOST | float | 0 | |||
| 调整单号跟踪 | EST_BUILD_BIL | string | 26 | |||
| 搭赠注记 | FREE_ID | string | 1 | |||
| 追踪出库单项次 | CK_ITM | integer | ||||
| 验收退回单入库单号 | RK_NO | string | 20 | |||
| 鞋服组合栏位 | COMPOSE_IDNO | string | 50 | |||
| 有效期 | VALID_DD | datetime | ||||
| 收料单号 | SL_NO | string | 20 | |||
| 关联入库单项次 | TI_ITM | integer | ||||
| 送货单号 | SH_NO_CUS | string | 20 | |||
| 自动转移标识 | AUTO_MV | string | 1 | |||
| 转至单据 | MVTO_NO | string | 20 | |||
| 已转合格量 | QTY_OK_RTN | float | ||||
| 未审核合格量 | QTY_OK_RTN_UNSH | float | 0 | |||
| 已转不合格量 | QTY_LOST_RTN | float | ||||
| 未审核不合格量 | QTY_LOST_RTN_UNSH | float | 0 | |||
| 验收转单标识 | MM_ID | string | 2 | |||
| 配送退回原因[A.正常退货,B.残次品,C.质量问题Z.其他] | RTN_ID | string | 1 | |||
| 唯一项次 | KEY_ITM | integer | 0 | |||
| 工程案号 | CAS_NO | string | 20 | |||
| 阶段编号 | TASK_ID | integer | 0 | |||
| 工时[制成品送检仅有] | USED_TIME | float | 0 | |||
| 关封编号 | GF_NO | string | 20 | |||
| 客户/厂商订单 | CUS_OS_NO | string | 30 | |||
| 金额 | AMTN | float | 0 | |||
| 单价 | UP | float | 0 | |||
| 税 | TAX | float | 0 | |||
| 税率 | TAX_RTO | float | 0 | |||
| 外币 | AMT | float | 0 | |||
| 批次 | PC_NO | string | 30 | |||
| 转特殊检验量 | QTY_QC | float | 0 | |||
| 入库日期 | RK_DD | datetime | 0 | |||
| 集团公司 | DEP_RK | string | 8 | |||
| 合同编号 | CNTT_NO | string | 40 | |||
| 不合格审理单号 | LS_NO | string | 20 | |||
| 折扣额 | AMT_DIS_CNT | float | 0 | |||
| 复检日期 | RECHK_DD | datetime | 0 | |||
| 生产日期 | PRODU_DD | datetime | 0 | |||
| 资产代号 | FX_NO | string | 20 | |||
| 资产名称 | FX_NAME | string | 40 | |||
| 恢复送货自增ID | HFSH_ITM | integer | 0 | |||
| 已转合格量(副) | QTY1_OK_RTN | float | 0 | |||
| 未审核合格量(副) | QTY1_OK_RTN_UNSH | float | 0 | |||
| 已转不合格量(副) | QTY1_LOST_RTN | float | 0 | |||
| 未审核不合格量(副) | QTY1_LOST_RTN_UNSH | float | 0 | |||
| 退回数量(副) | QTY1_PRE | float | 0 | |||
| 未审核退回数量(副) | QTY1_PRE_UNSH | float | 0 | |||
| WMS出入库通知量 | QTY_CRK_WMS | float | 0 | |||
| WMS出入库通知量(副) | QTY1_CRK_WMS | float | 0 | |||
请求JSON示例
{
"REF_NO": "{{$guid}}",
"PGM": "MRPBN",
"MF_TY": [
{
"TY_ID": "TP",
"TY_NO": "",
"TY_DD": "2021-09-18 00:00:00",
"TI_NO": "T619180001",
"USR": "ADMIN",
"PRT_SW": "N",
"DEP": "00000000",
"TI_ID": "T6",
"CHK_KND": "1"
}
],
"TF_TY": [
{
"TY_ID": "TP",
"TY_NO": "",
"ITM": 1,
"PRD_NO": "1001",
"PRD_NAME": "1001制成品",
"PRD_MARK": "",
"WH": "00000000",
"UNIT": "1",
"QTY_CHK": 10.0,
"QTY_OK": 10.0,
"BIL_NO": "MO19180001",
"TI_NO": "T619180001",
"PRE_ITM": 1,
"ID_NO": "1001->1",
"QTY1_CHK": 20.0,
"QTY1_OK": 20.0,
"TI_ITM": 1,
"RK_DD": "2021-09-18 00:00:00"
}
]
}
返回结果示例
{
"code": 0, //0表示执行成功
"message": "新增成功",
"data": {
"MF_TY": [ //请求生成单据的表头参数
{
"TY_ID": "TP",
"TY_NO": "TP19180001",
"TY_DD": "2021-09-18 00:00:00",
"TI_NO": "T619180001",
"USR": "ADMIN",
"CHK_MAN": "ADMIN",
"PRT_SW": "N",
"CLS_DATE": "2021-09-18 00:00:00",
"DEP": "00000000",
"SYS_DATE": "2021-09-18 12:19:03",
"TI_ID": "T6",
"CHK_KND": "1"
}
],
"TF_TY": [ //请求生成单据的表身参数
{
"TY_ID": "TP",
"TY_NO": "TP19180001",
"ITM": 1,
"PRD_NO": "1001",
"PRD_NAME": "1001制成品",
"PRD_MARK": "",
"WH": "00000000",
"UNIT": "1",
"QTY_CHK": 10.0,
"QTY_OK": 10.0,
"BIL_NO": "MO19180001",
"TI_NO": "T619180001",
"PRE_ITM": 1,
"ID_NO": "1001->1",
"QTY1_CHK": 20.0,
"QTY1_OK": 20.0,
"TI_ITM": 1,
"RK_DD": "2021-09-18 00:00:00"
}
],
"BILL_STATE": {
"READONLY": false,
"READONLY_REM": []
}
}
}