扩展信息根、子档案同步

接口信息

请求由现有 outing 入口按 COMPANY_ID 获取公司 ID。内部服务调用路径为 /common/thirdparty/syn/extend-infos/inner?platform=didi&companyId={companyId}，请求体与业务入口相同。业务调用方无需提供滴滴凭据、已有绑定或操作类型。

内部同步入口的 companyId 必须与当前认证公司身份一致，不能通过更改查询参数切换到其他公司。以下示例仅展示业务字段，调用时仍需沿用既有认证及公司上下文。

请求参数

Query 参数

Body 参数

data[] 参数

已确认创建的根档案再次提交新 name 不修改滴滴根名称。子档案同状态仍发送名称/父级更新。数组顺序不要求父级在前；先处理根，再按父子依赖新增/更新子项，最后删除。关联主体和跨根迁移不支持。不能通过空 parentCode 清除父级。

子档案 N 会删除自身及全部下级，不等同于停用。删除前查询滴滴树，无法确认范围则拒绝删除；若范围包含本批期望 Y 的子档案，也拒绝删除。已保存的下级绑定结果一并回写为 N 或未知。Y 会重新查询实际存在性，已删除项即使本地旧状态为 Y 也走重建；恢复父级不会自动恢复下级，同步源需提供下级的名称和层级重新提交。未提交的档案不是隐式删除对象，但可能受祖先级联删除影响。

根、子档案的判定

rootCode、parentCode 可省略或为 null，但不能传空字符串。接口不接收嵌套的 children 或滴滴原始 item_list，所有根、子档案都直接列在 data 数组中。name 在删除、停用或恢复请求中仍必填。

同步规则

请求是增量同步，不是全量替换。修改已有根下的子档案时，可以只提交子档案，不必重复提交根或未变更的兄弟节点。根、父级本次未提交时，必须在滴滴侧已存在；不能依赖本表恢复历史层级。父级创建失败时不发送依赖子项，根同步失败时不继续处理其本批子档案。

同批不允许同一根为 N 而其子项为 Y，也不允许跨根父级关系、重复编码或层级成环。层级校验可能在读取滴滴树后按根分组执行；整个请求不是跨服务原子事务，一组失败不代表其他根组未执行。

请求示例

1. 同批新增根和多级子档案

前提：本地尚未确认 cost 的绑定，需要新增该根及其子档案。编码仅作示例，请使用本公司、平台内未被其他根或子档案占用的稳定编码。

POST /common/thirdparty/syn/extend-infos?platform=didi
Content-Type: application/json
COMPANY_ID: 100

{
  "bizId": "extend-create-tree-001",
  "timestamp": 1793174400000,
  "data": [
    {"code": "cost", "name": "费用分类", "enabledFlag": "Y"},
    {"code": "cost-travel", "name": "差旅", "enabledFlag": "Y", "rootCode": "cost"},
    {"code": "cost-taxi", "name": "用车", "enabledFlag": "Y", "rootCode": "cost", "parentCode": "cost-travel"}
  ]
}

2. 已有根下追加子档案

前提：cost 根档案已存在。本次只新增其下第一级 cost-meal，不影响其他子档案。

{
  "bizId": "extend-add-child-001",
  "timestamp": 1793174400000,
  "data": [
    {"code": "cost-meal", "name": "餐饮", "enabledFlag": "Y", "rootCode": "cost"}
  ]
}

3. 修改子档案名称或父级

前提：cost-taxi、目标父级 cost-traffic 均已存在且同属 cost 根。下例将子档案改名，并移到目标父级下。仅改名时省略 parentCode 即可，原父级保持不变。

{
  "bizId": "extend-update-child-001",
  "timestamp": 1793174400000,
  "data": [
    {"code": "cost-taxi", "name": "市内交通", "enabledFlag": "Y", "rootCode": "cost", "parentCode": "cost-traffic"}
  ]
}

不能用 parentCode: ""、parentCode: null 或省略字段，将已有多级子档案移到根下第一级；当前实现不提供该种父级清除操作。

4. 删除子档案及全部下级

下例会级联删除 cost-travel 的全部下级，不只是删除本次提交的这一条。 调用方应先确认业务影响，且不要在同批要求其仍处于该子树内的下级为 Y。

{
  "bizId": "extend-delete-child-001",
  "timestamp": 1793174400000,
  "data": [
    {"code": "cost-travel", "name": "差旅", "enabledFlag": "N", "rootCode": "cost"}
  ]
}

5. 恢复已删除的父、子档案

前提：cost 根仍存在，cost-travel 和 cost-taxi 已删除。恢复需要重新提交各节点的名称和层级；仅传父级不会自动恢复其下级。下例先重建父级，再重建其子项。

{
  "bizId": "extend-restore-children-001",
  "timestamp": 1793174400000,
  "data": [
    {"code": "cost-travel", "name": "差旅", "enabledFlag": "Y", "rootCode": "cost"},
    {"code": "cost-taxi", "name": "用车", "enabledFlag": "Y", "rootCode": "cost", "parentCode": "cost-travel"}
  ]
}

6. 停用或恢复根档案

根档案继续使用原请求结构，不传 rootCode、parentCode。下例停用根；恢复时把 enabledFlag 改为 Y。根的停用/恢复不会走子档案的删除/重建动作。

{
  "bizId": "extend-disable-root-001",
  "timestamp": 1793174400000,
  "data": [
    {"code": "cost", "name": "费用分类", "enabledFlag": "N"}
  ]
}

响应参数

data[] 参数

首次同步没有绑定记录时继续处理，outing 不向 thirdparty 的该条明细传 binding；查到旧记录时附加对应绑定。绑定查询抛错、入参校验或服务调用整体失败时，错误由 resCode、resMsg 表达，data=[]。逐项失败按请求顺序返回；成功项不出现在 data 中。

响应示例

全部成功或无需同步：

{
  "resCode": 200000,
  "resMsg": "成功",
  "bizId": "extend-create-tree-001",
  "data": []
}

部分失败：

{
  "resCode": 500000,
  "resMsg": "部分档案同步失败",
  "bizId": "extend-create-tree-001",
  "data": [
    {"code": "cost-taxi", "reason": "滴滴拒绝同步"}
  ]
}

结果保存失败示例

{
  "resCode": 500502,
  "resMsg": "同步结果保存失败",
  "bizId": "extend-update-child-001",
  "data": [
    {"code": "cost-taxi", "reason": "同步结果保存失败"}
  ]
}