版本: 1.2 | 发布日期: 07/02/2024

场景

经过之前的宣传活动，ABC 水果公司现在已经成为最知名的水果供应商之一。

零售店的采购经理可以直接从网上商店订购水果。大多数交易都是通过赊销进行的。

采购经理经常查询他们的信用余额以跟踪所需的付款。

销售部经理建议Chris增加一份类似于积分的报告。

Chris 想出来了如下报告。

参考文档

为了实现此报告，Chris 获取了未收应收发票。

HTTP 请求

GET http://[server]/jsf/rfws/erp/ac/ar/getOsInvoice/{beId}/{uId}/{AIId}/{recregId}/{multiRecId}

参数

名字	类型	说明
beId	int(Path)	必填. 企业法人 ID
uId	int(Path)	必填. 用户 ID
payRegId	int(Path)	必填. 必须输入 0。
multiPayId	int(Path)	必填. 必须输入 0。
AIId	int(Path)	必填. 应收对象 ID。应收对象类型记录的 ID，如果应收对象类型 = cus，该字段将代表客户 FM 的 ID。
AIType	string(Header)	必填. 应收对象类型。格式请参阅请求示例，内置支持这些类型：cus、 ven、 staff、 cnDept、virDept。
sDate	date(Header)	必填. 交易日期（由）
eDate	date(Header)	必填. 交易日期（至）
sDDate	date(Header)	必填. 到期日（由）
eDDate	date(Header)	必填. 到期日（至）
sStaff	string(Header)	职员编号（由）
eStaff	string(Header)	职员编号（至）
sTranType	string(Header)	发票的交易类型。格式请参阅请求示例，支持类型：arIni、arTran 和siso。
loadCrNote	int(Header)	默认为 0。如果为 1，结果将包括负的 AR 交易。
loadGroupCo	boolean(Header)	默认为false。如果为 true，结果将考虑客户的公司组数据。

在这种情况下，AIType必须是 cus 。 AIId 代表客户的实体 ID。是的，请再次使用编号检索 ID。

其他参数都很简单。

响应采用了典型的 M18 SqlTable 风格，可能会让人难以理解。为了简化，请只关注 values 属性。

values:[
   {
	   "tDate":"2017-09-01 00:00:00",
	   "cpDate":"2017-09-01 00:00:00",
	   "code":"KC_ART_20170901_001",
	   "virDeptId":3,
	   "st_desc":"KC_ART_20170901_001",
	   "amt":100.0,
	   "balInvDomAmt":110.0,
	   "sTranId":396,
	   "ce01Module":"arTran",
	   "sTranCode":"KC_ART_20170901_001",
	   "sTranTypeMess":"arTran",
	   "curId":1,
	   "AIType":"cus",
	   "rate":1.1,
	   "balAmt":100.0,
	   "id":396,
	   "sTranType":"arTran",
	   "curCode":"R",
	   "virDeptCode":"SALES01",
	   "AIId":6,
	   "invDomAmt":110.0,
	   "virDeptDesc":"Sales Team 1"
   },
   {
	   "tDate":"2017-09-01 00:00:00",
	   "cpDate":"2017-09-01 00:00:00",
	   "code":"KC_ART_20170901_002",
	   "virDeptId":3,
	   "st_desc":"KC_ART_20170901_002",
	   "amt":100.0,
	   "balInvDomAmt":110.0,
	   "sTranId":397,
	   "ce01Module":"arTran",
	   "sTranCode":"KC_ART_20170901_002",
	   "sTranTypeMess":"arTran",
	   "curId":1,
	   "AIType":"cus",
	   "rate":1.1,
	   "balAmt":100.0,
	   "id":397,
	   "sTranType":"arTran",
	   "curCode":"R",
	   "virDeptCode":"SALES01",
   },
]

该客户有两张未结清发票。

1. KC_ART_20170901_001 附 110 (以本地货币计算)
2. KC_ART_20170901_002 附 110 (以本地货币计算)

有了上述知识，我们就可以制作一份信贷余额报告了。

列出最近60天的报告请求示例

String beId = "19";String uId = "9";
String AIId = "6";
String recregId = "0";
String multiRecId = "0";
String AIType = "cus";
String sDate = "2024-1-15";
String eDate = "2024-3-15";
String sDDate = "1900-01-01";
String eDDate = "9999-12-31";
String sStaff = "";
String eStaff = "";
String loadCrNote = "1";
String sTranType = "arTran";
String loadGroupCo = "false";
String url = "http://" + server + "/jsf/rfws/erp/ac/ar/getOsInvoice/
   + beId + "/"
   + uId + "/"
   + AIId + "/"
   + recregId + "/"
   + multiPayId;"
Request request = new Request.Builder()
   .url(url)
   .addHeader("client_id", clientID)
   .addHeader("authorization", "Bearer " + token)
   .addHeader("cache-control", "no-cache")
   .addHeader("AIType", AIType)
   .addHeader("sDate", sDate)
   .addHeader("eDate", eDate)
   .addHeader("sDDate", sDDate)
   .addHeader("eDDate", eDDate)
   .addHeader("sStaff", sStaff)
   .addHeader("eStaff", eStaff)
   .addHeader("loadCrNote", loadCrNote)
   .addHeader("sTranType", sTranType)
   .addHeader("loadGroupCo", loadGroupCo)
   .build();
OkHttpClient client = new OkHttpClient();
Response response = client.newCall(request).execute();

响应示例

values:[
{
     "code": "KC_ART_001",
     "tDate": "2024-1-28",
     "balInvDomAmt": 2100.00,
},
{
     "code": "KC_ART_003",
     "tDate": "2024-3-11",
     "balInvDomAmt": 100.00,
},
{
     "code": "KC_ART_005",
     "tDate": "2024-2-18",
     "balInvDomAmt": 8641.00,
},
{
     "code": "KC_ART_006",
     "tDate": "2024-3-15",
     "balInvDomAmt": 221.10,
},
]