> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alforse.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 合同

> 创建、查询、更新、导入、导出、OCR 复核并管理合同生命周期。

本页所有端点都需要租户 Bearer token，并受模块权限、主体范围和负责人范围约束。

| 端点                                               | 请求体/参数                                                                       | 权限                     |
| ------------------------------------------------ | ---------------------------------------------------------------------------- | ---------------------- |
| `GET /contracts`                                 | `page, pageSize, q, type, statusCode, payment, ownerId, subjectId, workflow` | `contract_view view`   |
| `GET /contracts/:id`                             | `id`                                                                         | `contract_view view`   |
| `POST /contracts`                                | `合同字段, dynamicFields, payments, terms`                                       | `contract_edit edit`   |
| `PATCH /contracts/:id`                           | `partial 合同字段`                                                               | `contract_edit edit`   |
| `DELETE /contracts/:id`                          | `id`                                                                         | `contract_delete edit` |
| `POST /contracts/bulk-delete`                    | `{ ids } max 1000`                                                           | `contract_delete edit` |
| `POST /contracts/bulk-attachment`                | `{ ids, contractAttachment }`                                                | `contract_edit edit`   |
| `POST /contracts/import`                         | `rows, xlsxBase64 or csv`                                                    | `contract_edit edit`   |
| `GET /contracts/export`                          | `filters, ids, profile`                                                      | `export edit`          |
| `POST /contracts/export`                         | `filters, ids, profile`                                                      | `export edit`          |
| `POST /contracts/extract`                        | `contractId, fileRef, fileName or text`                                      | `contract_edit edit`   |
| `PATCH /contracts/extractions/:runId/review`     | `fields, applyToContract, metadata`                                          | `contract_edit edit`   |
| `POST /contracts/:id/notes`                      | `{ label, value }`                                                           | `contract_edit edit`   |
| `POST /contracts/:id/terms`                      | `{ kind, title, date, note }`                                                | `contract_edit edit`   |
| `POST /contracts/:id/payments`                   | `付款行字段`                                                                      | `payment_entry edit`   |
| `POST /contracts/:id/fulfillment-tasks`          | `任务字段`                                                                       | `contract_edit edit`   |
| `PATCH /contracts/:id/fulfillment-tasks/:taskId` | `任务字段`                                                                       | `contract_edit edit`   |
| `POST /contracts/:id/invoices`                   | `发票字段`                                                                       | `invoice edit`         |