天心天思数字化API平台

转单接口–转入来源托工送检单生成【托工缴回验收单】T7->TO

概述

该接口主要用于第三方平台或自主研发者，通过调用【托工缴回验收单】的转单接口，将第三方的制成品或半成品送检的信息推送到Sunlike ERP或Online ERP系统中，从而生成Sunlike ERP或Online ERP系统的【托工缴回验收单】。

参数说明

1.请求方式

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

2.header参数

Content-Type application/json
Authorization token 获取每次登录的值

3.请求参数

请求JSON示例

{
  "REF_NO": "HYPTO2310250002", //第三方单号，必填
  "PGM": "MRPTO",              //程序代号，必填
  "MF_TY": [                    //请求生成单据的表头参数信息
    {
      "TY_ID": "TO",            //生成单据别，必填
      "TY_NO": "",              //ERP为自动编号，则取ERP系统编码；为手工编码，则与REF_NO必须相同
      "TRAN_BIL_ID":"T7",       //来源单据别，必填
      "USR":"ADMIN",            //制单人，必填
      "CHK_KND": 1     //检验类型：1.常规检验,2.复检；默认为1
    }
  ],
  "TF_TY": [                    //请求生成单据的表身参数信息，变更表身资料
    {
      "TY_ID": "TO",            //生成单据别，必填
      "TY_NO": "",
      "ITM": 1,                 //表身项次，必填
      "TRAN_BIL_ID":"T7",       //来源单据别，必填
      "TRAN_BIL_NO":"T702501090001",         //来源单号，必填
      "TRAN_BIL_ITM":1,         //转单项次，可通过查询接口查来源单表身TRAN_BIL_ITM的值，必填
      "QTY_CHK": 5,         //验货数量
      "QTY_OK": 2,         //合格数量
      "QTY_LOST": 3,      //不合格数量
      "SPC_NO":"01",      //不合格原因,不合格数量有值时为必填
      "PRC_ID":"4"       //不合格处理建议：1、验收退回,2、让步接收，4、复检；不合格数量有值时为必填
    }
  ]
}

返回结果示例

{
  "code": 0,    //为0表示执行成功，其他表示错误
  "message": "新增成功",
  "data": {
      "MF_TY": [    //生成托工验收单表头内容      
    {
              "TY_ID": "TO",
              "TY_NO": "TO02501090001",
              "TY_DD": "2025-01-09 00:00:00",
              "SAL_NO": "",
              "CUS_NO": "GYS001",
              "TI_NO": "T702501090001",
              "REM": ";内部版本,禁止使用于商业或盈利用途,违者必究",
              "USR": "ADMIN",
              "CHK_MAN": "ADMIN",
              "PRT_SW": "N",
              "BIL_NO": "TW02501090001",
              "BIL_ID": "TW",
              "CLS_DATE": "2025-01-09 00:00:00",
              "DEP": "00000000",
              "SYS_DATE": "2025-01-09 12:18:10",
              "CHK_KND": "1",
              "TRAN_BIL_ID": "T7"
          }
      ],
      "TF_TY": [   //生成托工验收单表身内容
          {
              "TY_ID": "TO",
              "TY_NO": "TO02501090001",
              "ITM": 1,
              "PRD_NO": "HYCP001",
              "PRD_NAME": "成品HYCP001",
              "PRD_MARK": "",
              "WH": "C002",
              "UNIT": "1",
              "QTY_CHK": 5.0,
              "QTY_OK": 2.0,
              "QTY_LOST": 3.0,
              "REM": ";内部版本,禁止使用于商业或盈利用途,违者必究",
              "BIL_NO": "TW02501090001",
              "TI_NO": "T702501090001",
              "SPC_NO": "01",
              "PRC_ID": "4",
              "EST_ITM": 1,
              "PRE_ITM": 1,
              "ID_NO": "HYCP001->",
              "VALID_DD": "2025-01-08 00:00:00",
              "TI_ITM": 1,
              "RK_DD": "2025-01-09 00:00:00",
              "TRAN_BIL_ITM": 1,
              "TRAN_BIL_ID": "T7",
              "TRAN_BIL_NO": "T702501090001"
          }
      ],
      "BILL_STATE": {
          "READONLY": false,
          "READONLY_REM": []
      }
  }
}