天心天思数字化API平台

生成【非生产退料申请单】接口

概述

该接口主要用于第三方平台或自主研发者，通过调用【非生产退料申请单】的生成接口，将第三方用于非生产的原材料、物料退回的申请信息推送到Sunlike ERP或Online ERP系统中，从而生成Sunlike ERP或Online ERP系统的【非生产退料申请单】。

参数说明

1.请求方式

请求方式 POST
接口地址 http://ERPAPI站点/INVXPREQ/ADDDATA
格式 JSON
编码类型 UTF-8

2.header参数

Content-Type application/json
Authorization token 授权接口所获取的值

3.请求参数

字段名称 字段代号 类型 长度 必填 固定值 备注
第三方单号 REF_NO 　 　 是 　 第三方单号，必填
程序代号 PGM 　 　 是 INVTLREQ 　
字段名称 字段代号 类型 长度 必填 固定值 备注
数据表MF_SQD
申请单标识 SQ_ID string 2 是 WX 　
申请单 SQ_NO string 20 是 　 1.自动编码时，根据单据编码原则自动产生；
2.手工编码时，根据JSON的单据号码必填，且与REF_NO必须相同
3.目前删除和速查单据都只能通过online单号执行，不可以通过第三方单号，因此第三方须记录online单号
申请日期 SQ_DD datetime 　 是 　 格式为：YYYY-MM-DD
申请部门 DEP string 8 是 　 　
领料部门 DEP_ML string 8 　 　 　
单据类别 BIL_TYPE string 10 　 　 　
经办人 SAL_NO string 12 　 　 　
领料原因 REASON string 60 　 　 　
转单ID BIL_ID string 2 　 　 　
转出单号 BIL_NO string 20 　 　 　
结案 CLS_ID string 1 　 　 　
审核人 CHK_MAN string 12 　 　 　
终审日期 CLS_DATE datetime 　 　 　 　
制单人 USR string 12 是 　 　
输单日期 SYS_DATE datetime 　 　 　 　
打印注记 PRT_SW string 1 　 　 　
拷贝注记 CPY_SW string 1 　 　 　
备注 REM string 500 　 　 　
审核模版 MOB_ID string 10 　 　 　
锁单人 LOCK_MAN string 12 　 　 　
锁单时间 LOCK_DATE datetime 0 　 　 　
打印人员 PRT_USR string 12 　 　 　
报废类型 BF_TYPE string 1 　 　 　
工程案号 CAS_NO string 20 　 　 　
阶段编号 TASK_ID integer 0 　 　 　
批号 BAT_NO string 40 　 　 　
计划/受订单号 JH_SO_NO string 20 　 　 　
作废标记 CANCEL_ID string 1 　 　 　
分析标志 PO_OK string 1 　 　 　
打印日期 PRT_DATE datetime 0 　 　 　
最近修改日期 MODIFY_DD datetime 0 　 　 　
最近修改人 MODIFY_MAN string 12 　 　 　
工程人员 CAS_MAN string 12 　 　 　
集团单据唯一值 GROUP_KEY string 100 　 　 　
数据表TF_SQD
申请单标识 SQ_ID string 2 是 WX 必须与MF_SQD的SQ_ID相同
申请单号 SQ_NO string 20 是 　 必须与MF_SQD的SQ_NO相同
项次 ITM integer 　 是 　 　
品号 PRD_NO string 30 是 　 　
货品特征 PRD_MARK string 100 　 　 　
仓库 WH string 12 是 　 　
单位 UNIT string 1 是 　 　
数量 QTY float 　 　 　 　
数量(副) QTY1 float 0 　 　 　
已领料量 QTY_ML float 0 　 　 　
未审核领料量 QTY_ML_UNSH float 0 　 　 　
摘要 REM string 60 　 　 　
单据项次 EST_ITM integer 　 　 　 　
历次变动项 PRE_ITM integer 　 　 　 　
已报废量 QTY_MLED float 0 　 　 　
未审核报废量 QTY_MLED_UNSH float 0 　 　 　
领料/报废原因 SPC_NO string 10 　 　 　
配方 ID_NO string 38 　 　 　
批号 BAT_NO string 40 　 　 　
须足量 CHK_XZL string 1 　 　 　
转入单号 BIL_NO string 20 　 　 　
转入ID BIL_ID string 2 　 　 　
来源项次 BIL_ITM integer 0 　 　 　
储位代号 CHUW string 60 　 　 　
WMS出入库通知量 QTY_CRK_WMS float 0 　 　 　
WMS出入库通知量(副) QTY1_CRK_WMS float 0 　 　 　

请求JSON示例

{
  "REF_NO": "WX20082600000001",      //第三方单号，必填
  "PGM": "INVTLREQ",      //单据程序代号
  "MF_SQD": [      //新增单据表头信息
    {
      "SQ_ID": "WX",
      "SQ_NO": "WX20082600000001",
      "SQ_DD": "2020-08-26 00:00:00",
      "DEP": "00000000",
      "DEP_ML": "00101",
      "BIL_TYPE": "",
      "SAL_NO": "9999",
      "USR": "ADMIN",
      "SYS_DATE": "2020-08-26 10:37:03",
      "REM": "API产生",
      "MOB_ID": ""
    }
  ],
  "TF_SQD": [       //新增单据表身信息
    {
      "SQ_ID": "WX",
      "SQ_NO": "WX20082600000001",
      "ITM": 1,
      "PRD_NO": "0001",
      "PRD_MARK": "",
      "WH": "9902",
      "QTY": 11.0,
      "NAME": "不粘锅",
      "SPC": "4L",
      "UNIT": "1",
      "EST_ITM": 1,
      "PRE_ITM": 1,
      "ID_NO": "",
      "BAT_NO": "",
      "PRD_NO_NO": "0001",
      "LJ_SW2": 10.0,      //新增单据表身自定义栏位信息
      "SIZE__NAME": "",
      "GOOD__NAME": ""
    }
  ]
}

返回结果示例

{
  "code": 0,         //为0表示执行成功，其他表示错误
  "message": "新增成功",        //提示信息
  "data": {
    "MF_SQD": [             //生成单据表头信息
      {
        "SQ_ID": "WX",
        "SQ_NO": "WX20082600000001",
        "SQ_DD": "2020-08-26 00:00:00",
        "DEP": "00000000",
        "DEP_ML": "00101",
        "BIL_TYPE": "",
        "SAL_NO": "9999",
        "CHK_MAN": "ADMIN",
        "CLS_DATE": "2020-08-26 00:00:00",
        "USR": "ADMIN",
        "SYS_DATE": "2020-08-26 10:37:03",
        "PRT_SW": "N",
        "REM": "API产生",
        "MOB_ID": ""
      }
    ],
    "TF_SQD": [              //生成单据表身信息
      {
        "SQ_ID": "WX",
        "SQ_NO": "WX20082600000001",
        "ITM": 1,
        "PRD_NO": "0001",
        "PRD_MARK": "",
        "WH": "9902",
        "QTY": 11.0,
        "NAME": "不粘锅",
        "SPC": "4L",
        "UNIT": "1",
        "EST_ITM": 1,
        "PRE_ITM": 1,
        "ID_NO": "",
        "BAT_NO": "",
        "PRD_NO_NO": "0001",
        "LJ_SW2": 10.0
      }
    ],
    "MF_SQD_Z": [            //生成单据表头自定义栏位信息
      {
        "SQ_ID": "WX",
        "SQ_NO": "WX20082600000001"
      }
    ],
    "TF_SQD_Z": [               //生成单据表身自定义栏位信息
      {
        "LJ_SW2": 10.0,
        "SQ_ID": "WX",
        "SQ_NO": "WX20082600000001",
        "ITM": 1
      }
    ]
  }
}