天心天思数字化API平台

生成【异常报废处理】接口

概述

该接口主要用于第三方平台或自主研发者，通过调用【异常报废处理】的生成接口，将第三方系统关于货品库存报废的信息推送到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     是 DRPXF  
字段名称 字段代号 类型 长度 必填 固定值 备注
数据表MF_IJ
单据别 IJ_ID string 2 是 XF XF
报废单号 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 int        
输单日期 SYS_DATE datetime        
区分来源POS单号标志 POS_ID string 1      
客户代号 CUS_NO string 12      
任务编号 TASK_ID int 0      
打印人 PRT_USR string 12      
申请单ID SQ_ID string 2      
申请单号 SQ_NO string 25      
  SQ_ITM int 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      
打印日期 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      
合同 CONTRACT string 80      
工程人员 CAS_MAN string 12      
WMS产生的单据 WMS_ID string 1      
字段名称 字段代号 类型 长度 必填 固定值 备注
数据表TF_IJ
单据别 IJ_ID string 2 是 XF 必须与表MF_IJ的IJ_ID相同
报废单号 IJ_NO string 20 是   必须与表MF_IJ的IJ_NO相同
项次 ITM int   是    
调整日期 IJ_DD datetime   是   必须与表MF_IJ的IJ_DD相同
货品代号 PRD_NO string 30 是    
品名 PRD_NAME string 160 是    
货品特征 PRD_MARK string 100      
库位 WH string 12      
单位 UNIT string 1 是    
数量 QTY float   是    
副单位数量 QTY1 float        
成本 CST float        
  IN_PRICE 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 int        
单据项次 EST_ITM int        
报废原因 SPC_NO string 10      
对方货号 SUP_PRD_NO string 40      
追踪项次 KEY_ITM int 0      
追踪箱条码 BOX_ITM int 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 int 0      
集团公司代号 DEP_RK string 8      
配位项次 PW_ITM int 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 int 0      
增减标志 ADD_ID string 1 是 + 填+
生产日期 SC_DD datetime 0      
已处理代销标志 GROUP_HDL_DX string 1      
来源单项次 BIL_ITM int 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 int 0      
替代品 PRD_NO_CHG string 255      
储位代号 CHUW string 60      
替代比率分母 CHG_RTO_BAS float 0      
出入库通知单据别 CRK_BIL_ID string 10      
出入库通知单号 CRK_BIL_NO string 100      
出入库通知单项次 CRK_BIL_ITM int 0      

请求JSON示例

{
  "REF_NO": "HYPXF2205120001",      //第三方单号，必填
  "PGM": "DRPXF",      //单据程序代号
  "MF_IJ": [       //新增单据表头信息
    {
      "IJ_ID": "XF",
      "IJ_NO": "",
      "IJ_DD": "2022-05-12 00:00:00",
      "FIX_CST": "2",
      "DEP": "965",
      "MAN_NO": "001",
      "USR": "ADMIN",
      "BIL_TYPE": "",
      "BIL_ID":"TR",           //来源异常通知单据别
      "BIL_NO":"TR2205120005"            //来源异常通知单号
    }
  ],
  "TF_IJ": [      //新增单据表身信息
    {
      "ADD_ID": "+",
      "IJ_ID": "XF",
      "IJ_NO": "",
      "ITM": 1,
      "IJ_DD": "2022-05-12 00:00:00",
      "PRD_NO": "WDP001",
      "PRD_NAME": "打印机",
      "PRD_MARK": "",
      "SPC_NO": "001",
      "WH": "0011",
      "UNIT": "1",
      "QTY": 1.0,
      "QTY1": 2.0,
      "CST": 0.0,
      "CST_STD": 0.0,
      "UP": 0.0,
      "PAK_UNIT": "",
      "PAK_EXC": 0.0,
      "PAK_NW": 0.0,
      "PAK_GW": 0.0,
      "PAK_MEAST": 0.0,
      "UNIT_DP": "",
      "CST_STD_UNIT": 0.0,
      "FIX_CST": "2",
      "BIL_ID":"TR",           //来源异常通知单据别
      "BIL_NO":"TR2205120005"            //来源异常通知单号
    }
  ]
}

返回结果示例

{
    "code": 0,           //为0表示执行成功，其他表示错误
    "message": "新增成功",            //提示信息
    "data": {
        "MF_IJ": [                      //生成单据表头信息
            {
                "IJ_ID": "XF",
                "IJ_NO": "XF2205120001",
                "IJ_DD": "2022-05-12 00:00:00",
                "FIX_CST": "2",
                "DEP": "965",
                "MAN_NO": "001",
                "REM": ";内部版本,禁止使用于商业或盈利用途,违者必究",
                "USR": "ADMIN",
                "CHK_MAN": "ADMIN",
                "PRT_SW": "N",
                "CLS_DATE": "2022-05-26 11:10:48",
                "BIL_TYPE": "",
                "SYS_DATE": "2022-05-26 11:10:48",
                "BIL_ID": "TR",
                "BIL_NO": "TR2205120005"
            }
        ],
        "TF_IJ": [                         //生成单据表身信息
            {
                "ADD_ID": "+",
                "IJ_ID": "XF",
                "IJ_NO": "XF2205120001",
                "ITM": 1,
                "IJ_DD": "2022-05-12 00:00:00",
                "PRD_NO": "WDP001",
                "PRD_NAME": "打印机",
                "PRD_MARK": "",
                "WH": "0011",
                "UNIT": "1",
                "QTY": 1.0,
                "QTY1": 2.0,
                "CST": 0.0,
                "CST_STD": 0.0,
                "FIX_CST": "2",
                "KEY_ITM": 1,
                "UP": 0.0,
                "PRE_ITM": 1,
                "BIL_ID": "TR",
                "BIL_NO": "TR2205120005",
                "PAK_UNIT": "",
                "PAK_EXC": 0.0,
                "PAK_NW": 0.0,
                "PAK_GW": 0.0,
                "PAK_MEAST": 0.0,
                "REM": "",
                "SPC_NO": "001",
                "UNIT_DP": "",
                "CST_STD_UNIT": 0.0
            }
        ],
        "BILL_STATE": {
            "READONLY": false,
            "READONLY_REM": []
        }
    }
}