用途:在 Procore 平台上实现合规的提交单(Submittal)工作流,处理跨版本端点共存及 beta 接口风险,确保公司路由与通知策略不被破坏。
主要能力:按操作选择文档化的端点版本;有界分页列出提交单并获取代表性记录的工作流数据;解析项目用户与规范引用,通过文档化端点获取下一个编号;显式决定邮件通知行为;生成脱敏请求预览并要求审批后再执行变更;写后读取提交单及其工作流数据,以 Procore 为准核对实际工作流状态;将端点版本选择放入适配器并测试当前响应字段与失败形态。
使用方式:提交单接口使用 OAuth 2.0 Bearer 令牌认证,端点要求处需提供 Procore-Company-Id,并依赖主体的项目与提交单权限。使用 Read 与 Grep 检查端点版本、工作流字段与项目配置;仅在获批的适配器、测试、提案或回执上使用 Write 或 Edit;不得执行未获批准的提交单变更。输出需包含所选路由版本、项目、提交单标识、通知选择、观测到的工作流状态与回滚负责人。
适用场景:需要与 Procore 提交单 API 集成、且对版本兼容、权限、状态对账和通知控制有严格要求的工程管理自动化。
限制:需目标公司与项目已启用提交单功能,并逐操作审查当前端点版本与变更日志;使用 beta 接口须明确风险接受,不得标记为稳定。必填参与者或规范缺失时应停止变更;403 或 422 需保留提供方详情;写后读取不一致时须以 Procore 为准并暂停下游发布。