添加订单列表
接口说明: 批量添加业绩中的定订单信息
请求方式: POST（HTTPS)
请求地址: https://api.xinrenxinshi.com/v5/statistic/performance/order/add
请求Header:
| key | value |
|---|---|
| access_token | 获取的access_token的实际值 |
Query参数:
| key | value |
|---|---|
| sign | 签名值 |
Body参数:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| saleOrderDOList | List<SaleOrderDO> | Y | 需要添加的订单列表，每批次不超过1000个 |
| timestamp | Integer | Y | 请求时间戳(精确到毫秒） |
SaleOrderDO:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| orderId | String | Y | 客户订单id |
| customerName | String | Y | 客户名称 |
| customerIndustry | String | N | 所属行业 |
| clueTime | String | N | 首次接触线索日期 日期格式: yyyy-MM-dd |
| orderTime | String | Y | 订单日期 日期格式: yyyy-MM-dd |
| orderAmount | Double | Y | 订单金额 |
| saleEmployeeName | String | Y | 负责销售姓名 |
| saleEmployeeMobile | String | Y | 负责销售手机号，必须为系统存在的员工手机号 |
| saleOrderPaymentList | List<SaleOrderPaymentDO> | Y | 回款明细 |
SaleOrderPaymentDO:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| paymentTime | String | Y | 回款时间 日期格式: yyyy-MM-dd |
| paymentAmount | Double | Y | 回款金额 |
| arrAmountPerson | Double | Y | arr个人部分 |
| arrAmountDep | Double | Y | arr部门部分 |
返回结果:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| errcode | Integer | Y | 错误码枚举值,0:成功，其他值为失败 |
| errmsg | String | Y | 结果描述 |
| data | Integer | Y | 添加成功的订单数量 |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/statistic/performance/order/add?sign=tAMMvw%2FiNEMLd3jf4i6U510aZ1c%3D
请求Body示例:
{
"saleOrderDOList": [
{
"clueTime": "2024-01-01",
"customerIndustry": "测试0",
"customerName": "李四0",
"orderAmount": 12313.0,
"orderId": "244430",
"orderTime": "2024-01-02",
"saleEmployeeMobile": "18810055225",
"saleEmployeeName": "张三0",
"saleOrderPaymentList": [
{
"arrAmountDep": 123132.0,
"arrAmountPerson": 12330.0,
"paymentAmount": 1123.0,
"paymentTime": "2024-01-03"
},
{
"arrAmountDep": 123133.0,
"arrAmountPerson": 12331.0,
"paymentAmount": 1124.0,
"paymentTime": "2024-01-03"
}
]
},
{
"clueTime": "2024-01-01",
"customerIndustry": "测试1",
"customerName": "李四1",
"orderAmount": 12314.0,
"orderId": "244431",
"orderTime": "2024-01-02",
"saleEmployeeMobile": "18810055225",
"saleEmployeeName": "张三1",
"saleOrderPaymentList": [
{
"arrAmountDep": 123132.0,
"arrAmountPerson": 12330.0,
"paymentAmount": 1123.0,
"paymentTime": "2024-01-03"
},
{
"arrAmountDep": 123133.0,
"arrAmountPerson": 12331.0,
"paymentAmount": 1124.0,
"paymentTime": "2024-01-03"
}
]
},
{
"clueTime": "2024-01-01",
"customerIndustry": "测试2",
"customerName": "李四2",
"orderAmount": 12315.0,
"orderId": "244432",
"orderTime": "2024-01-02",
"saleEmployeeMobile": "18810055225",
"saleEmployeeName": "张三2",
"saleOrderPaymentList": [
{
"arrAmountDep": 123132.0,
"arrAmountPerson": 12330.0,
"paymentAmount": 1123.0,
"paymentTime": "2024-01-03"
},
{
"arrAmountDep": 123133.0,
"arrAmountPerson": 12331.0,
"paymentAmount": 1124.0,
"paymentTime": "2024-01-03"
}
]
},
{
"clueTime": "2024-01-01",
"customerIndustry": "测试3",
"customerName": "李四3",
"orderAmount": 12316.0,
"orderId": "244433",
"orderTime": "2024-01-02",
"saleEmployeeMobile": "18810055225",
"saleEmployeeName": "张三3",
"saleOrderPaymentList": [
{
"arrAmountDep": 123132.0,
"arrAmountPerson": 12330.0,
"paymentAmount": 1123.0,
"paymentTime": "2024-01-03"
},
{
"arrAmountDep": 123133.0,
"arrAmountPerson": 12331.0,
"paymentAmount": 1124.0,
"paymentTime": "2024-01-03"
}
]
},
{
"clueTime": "2024-01-01",
"customerIndustry": "测试4",
"customerName": "李四4",
"orderAmount": 12317.0,
"orderId": "244434",
"orderTime": "2024-01-02",
"saleEmployeeMobile": "18810055225",
"saleEmployeeName": "张三4",
"saleOrderPaymentList": [
{
"arrAmountDep": 123132.0,
"arrAmountPerson": 12330.0,
"paymentAmount": 1123.0,
"paymentTime": "2024-01-03"
},
{
"arrAmountDep": 123133.0,
"arrAmountPerson": 12331.0,
"paymentAmount": 1124.0,
"paymentTime": "2024-01-03"
}
]
}
],
"timestamp": 1721898829918
}
SDK请求示例(java):
StatisticsSaleOrderAddRequest request = new StatisticsSaleOrderAddRequest(access_token());
List<SaleOrderDO> saleOrderDOList= Lists.newArrayList();
for (int i = 0; i < 5; i++) {
SaleOrderDO saleOrderDO =new SaleOrderDO();
saleOrderDO.setOrderId("24443"+i);
saleOrderDO.setCustomerName("李四"+i);
saleOrderDO.setCustomerIndustry("测试"+i);
saleOrderDO.setClueTime("2024-01-01");
saleOrderDO.setSaleEmployeeMobile("18810055225");
saleOrderDO.setSaleEmployeeName("张三"+i);
saleOrderDO.setOrderAmount(12313.0+i);
saleOrderDO.setOrderTime("2024-01-02");
List<SaleOrderPaymentDO> saleOrderPaymentList = Lists.newArrayList();
for (int j = 0; j < 2; j++) {
SaleOrderPaymentDO saleOrderPaymentDO =new SaleOrderPaymentDO();
saleOrderPaymentDO.setPaymentTime("2024-01-03");
saleOrderPaymentDO.setPaymentAmount(1123.0+j);
saleOrderPaymentDO.setArrAmountDep(123132.0+j);
saleOrderPaymentDO.setArrAmountPerson(12330.0+j);
saleOrderPaymentList.add(saleOrderPaymentDO);
}
saleOrderDO.setSaleOrderPaymentList(saleOrderPaymentList);
saleOrderDOList.add(saleOrderDO);
}
request.setSaleOrderDOList(saleOrderDOList);
OpenapiResponse<Integer> integerOpenapiResponse = XrxsStatisticService.addSaleOrderList(request);
响应示例
{
"errcode": 0,
"errmsg": "成功",
"data": 10
}