【业务场景】

第三方对接系统业务单据时，可能要先查询预计可发量是否充足，以便判断是否允许对接生成业务单据，因此业务模块单独封装了【预计可发量查询】的WebAPI接口供外部调用。

【预计可发量查询接口说明及示例】

一、接口说明：

1.接口名称：GetExpectQty

   接口组件：Kingdee.K3.SCM.WebApi.ServicesStub.dll

   接口类名：Kingdee.K3.SCM.WebApi.ServicesStub.ExpectQtyQueryWebApi.cs

2.接口调用全称：

  SDK调用：Kingdee.K3.SCM.WebApi.ServicesStub.ExpectQtyQueryWebApi.GetExpectQty

  HTTP调用：http://服务器地址/k3cloud/Kingdee.K3.SCM.WebApi.ServicesStub.ExpectQtyQueryWebApi.GetExpectQty.common.kdsvc

3.接口输入参数说明：

4.接口输出结果说明：

二、接口调用示例：

<1>客户端调用示例：

1.1 构造登陆信息

//站点地址

string url = "http://domain/k3cloud/Kingdee.bos.webapi.ServicesStub.authservice.validateuser.common.kdsvc";

string dataCenterId ="账套Id";
string userName ="用户名";
string userPwd ="用户密码";

1.2 登录校验
var client = new Kingdee.BOS.WebApi.Client.K3CloudApiClient(url);
var ret = client.ValidateLogin(dataCenterId, userName, userPwd, 2052);
var jResult = JObject.Parse(ret);
var resultType = jResult["LoginResultType"].Value<int>();
if (resultType != 1 && resultType != -5) return;

1.3 构造查询预计可发量参数Demo：

string queryExpectQtyArgs="{\"Row\":1,\"StockOrgId\":{\"FNumber\":\"101.2\"},\"MaterialId\":{\"FNumber\":\"TestMat01\"}}"; 

1.4 客户端调用查询预计可发量接口：
 var result = client.Execute<string>("Kingdee.K3.SCM.WebApi.ServicesStub.ExpectQtyQueryWebApi.GetExpectQty", new object[]   {  queryExpectQtyArgs });        

<2>Postman测试验证：

2.1.先测试登陆接口：POST

http://domain/k3cloud/Kingdee.bos.webapi.ServicesStub.authservice.validateuser.common.kdsvc

Body录入JSON参数：

{acctid:'账套Id', userName:'用户名', password:'用户密码', lcid:2052 }

2.2测试查询预计可发量接口：POST

http://domain/k3cloud/Kingdee.K3.SCM.WebApi.ServicesStub.ExpectQtyQueryWebApi.GetExpectQty.common.kdsvc

JSON参数格式样例：根据【预计可发量参数】启用的统计维度 按需构造 参数：

{ "queryExpectQtyArgs":

     [{ 

             "Row":1,
              "StockOrgId": {"FNumber": "100"},
              "MaterialId": {"FNumber":"TestMat01"},
              "UnitId":{"FNumber":"Pcs"},
              "StockId": {"FNumber":"CK01"},
              "StockStatusId": {"FNumber":"KCZT01_SYS"},
              "BomId":{"FNumber":"TestMat01_V1.0"},
              "LotText":"Lot-01",
              "ProductDate":"2022-05-21",
              "ExpiryDate":"2025-05-21",
              "OwnerTypeId":"BD_OwnerOrg",
              "OwnerId":{"FNumber":"100"},
              "KeeperTypeId":"BD_KeeperOrg",
              "KeeperId":{"FNumber":"100"},             
              "MtoNo":"M.No001"

    }]

}

Body录入json参数：参数：多个物料一起查询时传数组参数Demo：

{ "queryExpectQtyArgs": 

     [{   

                  "Row":1,    

                 "StockOrgId": {"FNumber": "101.2"},    

                 "MaterialId": {"FNumber":"TestMat01"}  

      },

      {   

                  "Row":2,    

                 "StockOrgId": {"FNumber": "101.2"},    

                 "MaterialId": {"FNumber":"TestMat02"}  

      }] 

}

PostMan测试样例参考：

【延伸阅读】

星空 - 《预计可发量》 精华内容合辑