报告调度器
此跨功能服务允许客户定义调度计划，无需人工干预即可自动生成报告，确保运营和财务数据始终在正确的时间可用。
创建 Report Schedulers
POST /v1/report_schedulers）创建。该接口端点允许客户定义：
Report Schedulers 目录
Account-Based Schedulers
这些调度器生成与 Cobre Balance 账户相关的报告。
| Resource | Geo | Scheduler Layout | Account Provider ID | Generated Reports (file_layout) |
|---|---|---|---|---|
accounts | COL | cobre_balance_multicash_v1 | pr_col_cobre | cobre_balance_multicash_header_v1cobre_balance_multicash_detail_v1 |
cobre_balance_multicash_v1 调度器每次执行时生成两份报告：一个头部文件和一个明细文件。调度器布局
| Layout | Country | Description |
|---|---|---|
| cobre_balance_multicash_v1 | 哥伦比亚 | 为 Cobre Balance COL 账户生成每日 Multicash 报告。调度器在 COT 时间上午 05:00（UTC 时间上午 10:00） 运行，处理前一个工作日的数据，使用从 1 至 9999 的连续序号，并生成与银行系统兼容的输出文件。 |
对 Report Schedulers 执行的操作
🔑 Create
🔍 Retrieval
❌ Delete
描述： 创建一个新的报告调度器配置。执行该操作后的预期结果：
一个处于 active（激活）状态的 Report Scheduler 对象，包含： 📘 了解更多： 🔗 Create a Report Scheduler
一个处于 active（激活）状态的 Report Scheduler 对象，包含：
id（例如 reps_xxxxx）active_statusschedule_patternresource 和 layoutmetadatacreated_at 和 updated_atReport Scheduler 对象
关键属性
| 字段 | 描述 |
|---|---|
id | 调度器的唯一标识符（reps_XXXXX） |
active_status | 表示调度器是否处于激活状态 |
schedule_pattern | 基于 Cron 的执行模式 |
resource | 用于生成报告的资源 |
layout | 所应用的调度器布局 |
execution_number | 调度器已执 行的次数 |
metadata | 额外配置信息（例如 account_id） |
created_at | 创建时间戳 |
updated_at | 最后更新时间戳 |
如何开始
Identify automation requirements
确定哪些报告需要自动生成以及生成频率。
Select the appropriate scheduler layout
从 Report Schedulers 目录中选择与您的使用场景匹配的调度器布局。
Prepare required metadata
在创建调度器之前，确保所有必填元数据字段（例如
account_id）均已就绪。Create the report scheduler
使用 Create Report Scheduler API 激活自动化报告生成。
Monitor generated reports
通过 Reports API 检索并下载已生成的报告。
使用此 API 后的预期结果
Automated report generation
报告将按照定义的计划自动生成，无需人工干预。
Operational consistency
确保报告始终在相同时间以相同配置生成。
Reduced operational overhead
消除周期性工作流程中的手动报告创建操作。
Seamless integration with Reports API
生成的报告与手动创建的报告遵循相同的生命周期，可通过标准 Reports 接口端点进行检索和下载。
Modified at 2026-06-12 23:18:07