SaveFeeInfo.md 3.6 KB

1. 保存费用

接口功能

API服务做保存费用时调用该接口

URL

http://fee-service/feeApi/service

支持格式

JSON

HTTP请求方式

POST

协议接口
父元素名称 参数名称 约束 类型 长度 描述 取值说明
- orders 1 Object - 订单节点 -
- business 1 Array - 业务节点 -
orders
父元素名称 参数名称 约束 类型 长度 描述 取值说明
- orders 1 Object - 订单节点 -
orders appId 1 String 10 系统ID 由中心服务提供
orders transactionId 1 String 30 交互流水 appId+'00'+YYYYMMDD+10位序列
orders userId 1 String 30 用户ID 已有用户ID
orders orderTypeCd 1 String 4 订单类型 查看订单类型说明
orders requestTime 1 String 14 请求时间 YYYYMMDDhhmmss
orders remark 1 String 200 备注 备注
orders sign ? String 64 签名 查看加密说明
orders attrs ? Array - 订单属性 -
attrs specCd 1 String 12 规格编码 由中心服务提供
attrs value 1 String 50 属性值 -
orders response 1 Object - 返回结果节点 -
response code 1 String 4 返回状态 查看状态说明
response message 1 String 200 返回状态描述 -
business
父元素名称 参数名称 约束 类型 长度 描述 取值说明
- business ? Array - 业务节点 -
business businessTypeCd 1 String 12 业务类型编码 500100030002
business datas 1 Object - 数据节点 不同的服务下的节点不一样
datas businessFee 1 Object - 小区成员 小区成员
businessFee amount 1 String 30 - -
businessFee incomeObjId 1 String 30 - -
businessFee feeTypeCd 1 String 30 - -
businessFee startTime 1 String 30 - -
businessFee endTime 1 String 30 - -
businessFee communityId 1 String 30 - -
businessFee feeId 1 String 30 - -
businessFee userId 1 String 30 - -
businessFee payerObjId 1 String 30 - -
返回协议

当http返回状态不为200 时请求处理失败 body内容为失败的原因

当http返回状态为200时请求处理成功,body内容为返回内容,

举例

地址:http://fee-service/feeApi/service

请求头信息:
Content-Type:application/json

请求报文:

{
  "orders": {
    "appId": "外系统ID,分配得到",
    "transactionId": "100000000020180409224736000001",
    "userId": "用户ID",
    "orderTypeCd": "订单类型,查询,受理",
    "requestTime": "20180409224736",
    "remark": "备注",
    "sign": "这个服务是否要求MD5签名",
    "businessType":"I",
    "attrs": [{
      "specCd": "配置的字段ID",
      "value": "具体值"
    }]
  },
  "business": {
    "businessTypeCd": "600100030001",
    "bId":"1234567892",
    "remark": "备注",
    "datas": {
      "businessFee": {
                "amount":"填写具体值",
        "incomeObjId":"填写具体值",
        "feeTypeCd":"填写具体值",
        "startTime":"填写具体值",
        "endTime":"填写具体值",
        "communityId":"填写具体值",
        "feeId":"填写具体值",
        "userId":"填写具体值",
        "payerObjId":"填写具体值"
      }
    },
    "attrs": [{
      "specCd": "配置的字段ID",
      "value": "具体值"
    }]
  }
}

返回报文:
 {
	"orderTypeCd": "D",
	"response": {
		"code": "0000",
		"message": "成功"
	},
	"responseTime": "20190418102004",
	"bId": "202019041810750003",
	"businessType": "B",
	"transactionId": "3a5a411ec65a4c3f895935638aa1d2bc",
	"dataFlowId": "44fde86d39ce46f4b4aab5f6b14f3947"
}