kehu51-crm

List Business Objects

列出当前用户有权限访问的业务对象。可用 keyword/capability 过滤；禁止传 tenant_id/company_id/user_id。

Search Business Records

按条件查询业务记录列表。filters 之间为 AND；field_id 必须来自 describe；禁止传 tenant_id/company_id/user_id/raw_sql。

Search Products

查询产品（只读），用于填写订单 line_items。返回的 line_item_hint 可直接作为 line_items 的一行（已含 DealCount/DealPrice/OriginalPrice），按需改数量即可；禁止编造产品名称或 SKU；ambiguous 时改用 SKU 或向用户澄清。禁止传 tenant_id/company_id/user_id/raw_sql。

Prepare Create Record

准备新增草稿：校验后返回 draft_id；不写业务表。values 必须用 describe(purpose=create) 返回的 field_id（禁止写 CusType/customer_type 字面量）。客户类型是合成字段「客户类型」，选项 1=企业/2=个人；不传默认个人。企业须类型=1 且 contacts_json 用 RealName/MobilePhone/Jobs。订单须 line_items_json。

Confirm And Commit

用户明确确认后正式提交草稿。需 draft_id、confirmation_token（来自 can_commit 的草稿响应）与 idempotency_key。支持 customer/contact/order/followup/task；成功返回 record_id 与 audit_id。

Get Business Record

按 record_id 查看单条详情。select_fields 使用 describe 返回的 field_id；禁止传 tenant_id/company_id/user_id。

Describe Business Object

获取业务对象字段 Schema。object_key 必须来自 list_business_objects；keywords 未命中时返回 FIELD_NOT_AVAILABLE，禁止猜测字段。

Get Current Context

确认当前是谁、属于哪家公司。入参必须为空对象 {}，禁止传 tenant_id/company_id/user_id。

Prepare Update Record

准备修改草稿：校验变更后返回 draft_id、record_version 与前后对比；不写正式业务表。订单可传 line_items_json 全量替换产品。

Update Draft

补充或修正草稿并续期；不写业务表。订单：line_items_json+replace_line_items。客户企业：values 补 CusType=1，contacts_json+replace_contacts（RealName/MobilePhone/Jobs，禁止 name/position）。