Skip to content

2.3、租户主数据接口


GET  

接口说明

获取租户信息,包含租户编码、租户名称等。
租户相关信息的创建、修改、删除都调用此接口获取。

请求Query参数

公共参数

请求时必须传入公共参数,详见公共接口说明

私有参数

数据结构

名称
类型
必选
中文名
说明
timesstring时间上一次获取数据最大截止时间,时间格式:yyyy-MM-dd hh:mm:ss 第一次获取该数据时传2000-01-01 00:00:00或初始化时提供excel格式的初始化数据
pagenostring页数需要获取第几页数据(接口默认每页100条数据)

请求示例(参数需要进行URL编码):

http://10.1.69.126:8099/ess/master/getcustomerinfo?appid=1234560987&ts=20190910&sig=KsLPiDYwMj5Aj1UG5RUPc58iouu=&format=json&userip=192.168.0.10&times=2000-01-01 23:59:59&pageno=1

返回响应

数据结构

名称
类型
必选
中文名
说明
CustomerIDSting租户ID
Los_CustomerIDString租赁租户ID
CustomerCodeString租户编码
CustomerNameString租户名称
CustomerTypeint租户类型1:公司;2:个人
TaxCodeString税号
TaxpayerQualificationstring纳税人资格
RegAddrstring注册地址
CustomerModeint商户类别1:库内;2:库外
CustomerStatusInt商户状态1:有效;10:黑名单
ContactInfoJSON商户联系人信息
   CustomerContactIDString联系人ID
   StoreIDString项目ID
   ContactManString联系人姓名
   MobileTelString移动电话
   BillContactint是否默认账单联系人0:否;1:是
BankInfoJSON银行信息
   BankInfoIDString银行信息ID
   StoreIDString项目ID
   AccountTypeint账户类型1:一般户;2:基本户
   BankAcctSting银行账号
   BankNameSting开户银行
   DefaultAccountint是否为默认银行账号0:否;1:是
RecordTimeString记录时间yyyy-MM-dd hh:ss:mm

响应示例

成功

json
{
	"items": [{
		"CustomerID": "45f2f676-f930-af0a-b662-eca263df9b06",
		"CustomerCode": "CODE19082700002",
		"CustomerName": "悦已容(精品)有限公司",
		"CustomerType": "2",
		"TaxCode": "234236345345675452",
		"TaxpayerQualification": "小规模纳税人",
		"RegAddr": "北京市朝阳区西大望路",
		"CustomerMode": 1,
		"CustomerStatus": 1,
		"ContactInfo": [{
			"CustomerContactID": "123",
			"StoreID": "bed76a1b-8bfc-4064-8168-f8b8714ecfdd",
			"ContactMan": "B哥",
			"MobileTel": "13211909890",
			"BillContact": 1
		}],
		"BankInfo": [{
			"BankInfoID": "1d8fbd74-5533-4e32-a117-bef6f74cc4c7",
			"StoreID": "6f5b8df0-480e-44c7-a328-edc53254fd47",
			"AccountType": 1,
			"BankAcct": "6121121212121",
			"BankName": "中国银行2",
			"DefaultAccount": 0
		}],
		"RecordTime": "2019-11-01 17:20:00"
	}]
}

失败

json
{
	"ret": 2001,
	"msg": "获取数据失败"
}