天心天思数字化API平台

生成【销货退回检验单】接口

概述

该接口主要用于第三方平台或自主研发者，通过调用【销货退回检验单】的生成接口，将第三方系统的客户退货入库检验的信息推送到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 　 　 是 DRPTA 　
字段名称 字段代号 类型 长度 必填 固定值 备注
数据表MF_TY
验收识别 TY_ID string 2 是 TA 　
验收单号 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 是 TA 　
验收单号 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 　 　 　

4.自定义参数

字段名称 字段代号 类型 长度 是否 固定值 备注
数据表MF_TY_Z（表头自定义字段）
自定义栏位1 自定义 string 2 　 　 自定义字段可为文件、数字、日期、备注等类型，若为数字字段，可用于计算，例如自定义三个字段：JD_NO1,JD_NO2,JD_NO3，而JD_NO3=JD_NO1*JD_NO2，那么在JSON里只要上传JD_NO1和JD_NO2即可。
自定义栏位2 自定义 string 　 　 　
…… …… …… 　 　 　
数据表TF_TY_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": "TA20082700000001",      //第三方单号，必填
  "PGM": "DRPTA",      //单据程序代号
  "MF_TY": [      //新增单据表头信息
    {
      "TY_ID": "TA",
      "TY_NO": "TA20082700000001",
      "TY_DD": "2020-08-27 00:00:00",
      "SAL_NO": "9999",
      "CUS_NO": "0008",
      "TI_NO": "T420082700000001",
      "REM": "API产生",
      "USR": "ADMIN",
      "BIL_NO": "YX20082700000001",
      "BIL_ID": "YX",
      "BIL_TYPE": "01",
      "DEP": "00000000",
      "CHK_KND": "1",
      "LJ_TA1": "外部单据"      //新增单据表头自定义栏位信息
    }
  ],
  "TF_TY": [      //新增单据表身信息
    {
      "TY_ID": "TA",
      "TY_NO": "TA20082700000001",
      "ITM": 1,
      "PRD_NO": "0001",
      "PRD_NAME": "不粘锅",
      "PRD_MARK": "",
      "WH": "9902",
      "UNIT": "1",
      "QTY_CHK": 10.0,
      "QTY_LOST": 10.0,
      "BIL_NO": "YX20082700000001",
      "TI_NO": "T420082700000001",
      "SPC_NO": "01",
      "PRE_ITM": 1,
      "VALID_DD": "2020-08-27 00:00:00",
      "TI_ITM": 1,
      "QTY_ORG": 10.0,
      "QTY1_ORG": 0.0,
      "SL_NO": "YX20082700000001",
      "LJ_TA2": 10.0,      //新增单据表身自定义栏位信息
      "SIZE__NAME": "",
      "GOOD__NAME": "",
      "PRD_NO_NO": "0001"
    }
  ]
}

返回结果示例

{
    "code": 0,             //为0表示执行成功，其他表示错误
    "message": "新增成功",           //提示信息
    "data": {
        "MF_TY": [                      //生成单据表头信息
            {
                "TY_ID": "TA",
                "TY_NO": "TA20082700000001",
                "TY_DD": "2020-08-27 00:00:00",
                "SAL_NO": "9999",
                "CUS_NO": "0008",
                "TI_NO": "T420082700000001",
                "REM": "API产生",
                "USR": "ADMIN",
                "PRT_SW": "N",
                "BIL_NO": "YX20082700000001",
                "BIL_ID": "YX",
                "BIL_TYPE": "01",
                "DEP": "00000000",
                "MOB_ID": "01",
                "SYS_DATE": "2020-08-28 10:29:28",
                "CHK_KND": "1",
                "LJ_TA1": "外部单据"
            }
        ],
        "TF_TY": [                  //生成单据表身信息
            {
                "TY_ID": "TA",
                "TY_NO": "TA20082700000001",
                "ITM": 1,
                "PRD_NO": "0001",
                "PRD_NAME": "不粘锅",
                "PRD_MARK": "",
                "WH": "9902",
                "UNIT": "1",
                "QTY_CHK": 10.0,
                "QTY_LOST": 10.0,
                "BIL_NO": "YX20082700000001",
                "TI_NO": "T420082700000001",
                "SPC_NO": "01",
                "PRE_ITM": 1,
                "VALID_DD": "2020-08-27 00:00:00",
                "TI_ITM": 1,
                "QTY_ORG": 10.0,
                "QTY1_ORG": 0.0,
                "SL_NO": "YX20082700000001",
                "LJ_TA2": 10.0
            }
        ],
        "MF_TY_Z": [                       //生成单据表头自定义栏位信息
            {
                "LJ_TA1": "外部单据",
                "TY_ID": "TA",
                "TY_NO": "TA20082700000001"
            }
        ],
        "TF_TY_Z": [                //生成单据表身自定义栏位信息     
            {
                "LJ_TA2": 10.0,
                "TY_ID": "TA",
                "TY_NO": "TA20082700000001",
                "ITM": 1
            }
        ]
    }
}