合同分析报告 API 接口文档

合同分析报告 API

该接口提供合同分析报告数据，包含合同数量、金额、退款金额、实际金额等信息，并支持根据日期、客户ID、合同状态、审核状态等条件进行筛选。

接口地址:

/api/contract_report

请求方式:

GET

请求参数:

| 参数名 | 说明 | 类型 | 是否必填 | 示例 |
|---|---|---|---|---| | contract_start_time | 合同开始日期 | string | 否 | 2023-01-01 | | contract_end_time | 合同结束日期 | string | 否 | 2023-01-31 | | customer_id | 客户ID | int | 否 | 1 | | status | 合同状态 | int | 否 | 1 | | audit_status | 审核状态 | int | 否 | 1 |

返回数据:

{
  "code": 1,
  "message": "获取成功",
  "data": {
    "customer_data": {
      "total_num": 10,
      "total_amount": 10000,
      "total_refund_amount": 100,
      "total_actual_amount": 9900
    },
    "contract_data": {
      "total_num": 10,
      "total_amount": 10000,
      "total_refund_amount": 100,
      "total_actual_amount": 9900
    },
    "contract_report_data": {
      "total_num": 10,
      "total_amount": 10000,
      "total_refund_amount": 100,
      "total_actual_amount": 9900
    },
    "customer_service_data": {
      "total_reply_num": 100,
      "total_call_num": 10,
      "total_visit_num": 10
    }
  }
}

数据字段说明:

| 字段名 | 说明 | |---|---| | customer_data | 客户报表数据 | | total_num | 客户数量 | | total_amount | 客户总金额 | | total_refund_amount | 客户总退款金额 | | total_actual_amount | 客户总实际金额 | | contract_data | 合同报表数据 | | total_num | 合同数量 | | total_amount | 合同总金额 | | total_refund_amount | 合同总退款金额 | | total_actual_amount | 合同总实际金额 | | contract_report_data | 合同分析报告数据 | | total_num | 合同数量 | | total_amount | 合同总金额 | | total_refund_amount | 合同总退款金额 | | total_actual_amount | 合同总实际金额 | | customer_service_data | 客服统计数据 | | total_reply_num | 客服总回复数量 | | total_call_num | 客服总通话数量 | | total_visit_num | 客服总访问数量 |

代码示例:

// 获取合同分析报告数据
$response = Http::get('http://your-api-url/api/contract_report', [  
    'contract_start_time' => '2023-01-01',
    'contract_end_time' => '2023-01-31',
]);

// 打印返回数据
print_r($response->json());

注意事项:

• 日期格式为 YYYY-MM-DD
• 合同状态、审核状态请参考相关文档
• 接口调用频率请参考相关文档