天心天思数字化API平台

查询【采购单】接口

概述

该接口主要用于第三方平台或自主研发者，通过调用【采购单】的查询接口，将Sunlike ERP或Online ERP系统中的【采购单】信息调出至第三方平台中显示。

参数说明

1.请求方式

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

2.header参数

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

3.请求参数

字段名称 字段代号 类型 长度 必填 固定值 备注
数据表MF_POS
程序代号 PGM 　 　 是 DRPPO 　
采购/受订区分 OS_ID string 2 是 　 值的范围：PO; SO(PO采购单；SO受订单)
单号 OS_NO string 20 　 　 ERP的单据号码

4.转单项次参数

转单项次参数 说明
TRAN_BIL_ITM 当使用转单接口时需传转单项次参数值，该参数值可通过当前单据的GETDATA查询接口返回结果查看，为虚拟字段，该参数值是抓取当前单据表身非变动唯一项次TF_POS.PRE_ITM的字段值。

请求JSON示例

{
    "PGM":"DRPPO",           //单据程序代号
    "OS_ID":"PO",                //单据识别代号
    "OS_NO":"PO20081700000001"            //ERP的单据号码
}

返回结果示例

{
  "code": 0,                          //为0表示执行成功，其他表示错误
  "message": "查询成功",      //提示信息
  "data": {
    "MF_POS": [                   //查询单据表头信息
      {
        "OS_ID": "PO",
        "OS_NO": "PO20081700000001",
        "OS_DD": "2020-08-17 00:00:00",
        "CUS_NO": "C1000",
        "SAL_NO": "0001",
        "EST_DD": "2020-08-17 00:00:00",
        "TAX_ID": "2",
        "BIL_TYPE": "01",
        "REM": "API生产",
        "PAY_MTH": "1",
        "PAY_DAYS": 1,
        "CHK_DAYS": 30,
        "PAY_REM": "结帐期:2020-09-01;票据到期日:2020-10-01",
        "SEND_MTH": "1",
        "DIS_CNT": 0.0,
        "PO_DEP": "001",
        "PAY_DD": "2020-09-01 00:00:00",
        "CHK_DD": "2020-08-17 00:00:00",
        "INT_DAYS": 30,
        "USR": "0001",
        "PRT_SW": "N",
        "CLS_DATE": "2020-08-17 00:00:00",
        "CHK_MAN": "0001",
        "EXC_RTO": 1.0,
        "TOT_QTY": 200.0,
        "SYS_DATE": "2020-08-17 16:12:48",
        "HS_ID": "F",
        "HIS_PRICE": "T",
        "PRE_ID": "F",
        "MOB_ID": "01",
        "BIL_COUNT": 0,
        "BIL_FILE_COUNT": 0,
        "LJ_PO1": "AAAAAAAAAA"          //单据表头自定义栏位
      }
    ],
    "TF_POS": [                              //查询单据表身信息
      {
        "OS_ID": "PO",
        "OS_NO": "PO20081700000001",
        "ITM": 1,
        "PRD_NO": "00221",
        "PRD_NAME": "00221制程一原料",
        "PRD_MARK": "0101",
        "WH": "002",
        "UNIT": "1",
        "QTY": 100.0,
        "UP": 2.0,
        "AMT": 200.0,
        "AMTN": 190.48,
        "TAX_RTO": 5.0,
        "TAX": 9.52,
        "PRE_ITM": 1,
        "QTY1": 200.0,
        "UP_QTY1": 1.0,
        "EST_DD": "2020-08-17 00:00:00",
        "CST_STD": 0.0,
        "OS_DD": "2020-08-17 00:00:00",
        "EST_ITM": 1,
        "CUS_OS_NO": "",
        "UNCFM_ID": "F",
        "GROUP_DEP": "",
        "CUS_NO": "C1000",
        "SCM_USR": "0001",
        "SCM_DD": "2020-08-17 00:00:00",
        "SUP_PRD_NO": "",
        "SUP_PRD_NM": "",
        "SUP_PRD_MARK": "",
        "UP_PO": 0.0,
        "GETUP_FROM": "0",
        "CHK_TAX": "F",
        "CST_STD_UNIT": 0.0,
        "PRD_NO_NO": "00221",
        "WLGL_UP": "2.00000000",
        "TRAN_BIL_ITM": 1,          //转单项次
        "LJ_PO2": 1.0              //单据表头自定义栏位
      }
    ]
  }
}