Skip to content

2.10、第三方系统费用接入接口


POST  

接口说明

请求Body参数

公共参数

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

私有参数

数据结构

名称
类型
必选
中文名
说明
InvNoString主键编号唯一(GUID)
StoreIDString项目ID项目数据接口
BuildingIDString大楼ID项目数据接口
CustomerIDString租户ID租户数据接口
ContractIDString合同ID合同主数据接口
IsMeterInt是否记表费用0:否;1:是
ChargeDJSON费用明细
   ChargeTypeCodeString费项编码
   ChargeTypeNameString费项名称
   StartDateString开始日期
   EndDateString结束日期
   LastQtyString上期读数
   CurQtyString本期读数
   CostQtyString使用量
   FreeQtyString免费使用量
   PriceString单价
   ChargeAmtString应收金额
   CollectionTypeInt收款标志1:已收款;0或者空为未收款;
   PaidAmtDecimal(18,2)实收金额如收款标志位1,则此字段不能为空
   PayMethodIDString支付方式ID费用收款支付方式接口如收款标志位1,则此字段不能为空
   PayDateDate收款日期如收款标志位1,则此字段值不能为空
   BankNostring银行账号如支付方式为银行卡或转账,则需收款的银行账号

请求示例

成功

json
{
	"appid": "1234560987",
	"format": "json",
	"items": [{
		"ChargeD": [{
			"ChargeAmt": 2000,
			"ChargeTypeCode": "1109",
			"EndDate": "2019-11-29",
			"CurQty": 0,
			"LastQty": 0,
			"StartDate": "2019-11-29",
			"Price": 0,
			"ChargeTypeName": "装修管理费",
			"CostQty": 0
		}],
		"ContractID": "CONTRACTSID-6456-HS",
		"CustomerID": "CUSTOMERID-4146-HS",
		"StoreID": "STOREID-164-HS",
		"BuildingID": "BUILDINGID-115-HS",
		"InvNo": "00B61DAF9C008977A245",
		"IsMeter": 0
	}],
	"sig": "H87Omq6HGVO14Sb6dypXtUUb3lk=",
	"ts": "20191129",
	"userip": ""
}

返回响应

数据结构

名称
类型
必选
中文名
说明
retInt返回码2000:成功;2001:失败
msgString描述

响应示例

成功

json
{
	"ret": 2000,
	"msg": "接口调用成功"
}

失败

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