六、其他接口

1.企业工商信息接口

根据企业名称精准匹配工商信息。返回的 id 为平台线索数据唯一 id（与数据转出 clueItems[].id 相同），可用于内嵌企业详情页、已转移 / 未转移状态同步。

请求

GET /api/isv/v1/ent/base_info?oid=123456&keyword=北京示例制药股份有限公司

参数	必填	说明
`oid`	是	登录用户在我们系统的企业账号 ID，用于授权识别
`keyword`	是	企业名称，须与工商登记名称完全一致，否则查不到数据

返回结果

{
  "code": 0,
  "message": "成功",
  "data": {
    "id": "21dbe3a17add17414ssseaaa3f9710",  // 平台线索数据唯一 id（打开线索详情、状态同步等场景使用）
    "name": "北京xxx制药股份有限公司",            // 企业名称
    "uncid": "911100007226097xxx",            // 统一社会信用代码
    "regno": "3502062xxxx47"                  // 企业注册号
  },
  "traceId": "..."
}

2. 显示转移人

数据转移后，企业详情页可以设置显示【负责人】，可通过跨域 postMessage 向父页面获取负责人等信息。

平台 → 父页面（请求）

window.parent.postMessage({
    type: 'REQUEST_ENT_CRM_INFO',
    id: '...',           // 平台线索数据唯一 id（与数据转出 clueItems[].id 相同）
    oid: '...',          // 登录用户在我们系统的企业账号 ID
    uid: '...',          // 登录用户在我们系统的登录用户 ID
    ent_type: 'company'
}, '*')

父页面 → 平台（响应）

监听 RESPONSE_ENT_CRM_INFO，event.data.result 格式：

{
  "buttonLabel": "负责人",   // 为空或不返回则默认「负责人」；不展示则不返回该字段
  "buttonValue": "王*",     // 为空或不返回则用 items 里 name 拼接（、分隔）
  "hasCallModule": true,    // 是否对接外呼；false/不返回：PC 不展示拨号 icon，App 走原生拨号
  "enableCall": true,       // 当前用户是否有拨号权限
  "hasTransfer": false,     // false 不展示转移按钮；不返回或 true 展示
  "titles": [
    { "label": "负责人", "name": "item_user" },
    { "label": "所属模块", "name": "item_model" },
    { "label": "所属对象", "name": "item_title" }
  ],
  "items": [
    {
      "item_user": "客户公海",
      "item_model": "客户公海",
      "item_title": "重庆胜峰家具有限公司"
    }
  ]
}

注意：

hasTransfer 为 true/不返回，且无 buttonLabel/buttonValue 时，按钮展示为可转移
有 buttonLabel/buttonValue时展示[label：value],buttonValue 不允许为空

3.显示外呼拨号按钮

用户点击拨号时，iframe 发出：

window.parent.postMessage({
    type: 'REQUEST_APP_CALL',
    number: item.content || ''
}, '*')

父页面接收后执行你们自己的外呼逻辑。

4.相关企业详情跳转

默认线索详情内点击相关企业不会打开新详情。若需要支持：

平台 iframe 会向父页面发：

window.parent.postMessage({
    type: 'NAVIGATE_SKB_PATH',
    path: '/soukebox/soukebox/010beefffb3eb0565c613fd89ff717d7'
}, '*')

父页面监听后，新开你方详情页即可。Vue 示例：


<script setup>
import {onMounted, onUnmounted} from 'vue'

const handleMessage = (event) => {
  const data = event.data
  if (data && data.type === 'NAVIGATE_SKB_PATH' && data.path) {
    // path 末段即为线索 id，也可用你们已落库的 id 打开详情
    const detailUrl = `/skb/detail?path=${encodeURIComponent(data.path)}`
    window.open(detailUrl, '_blank')
  }
}

onMounted(() => window.addEventListener('message', handleMessage))
onUnmounted(() => window.removeEventListener('message', handleMessage))
</script>

5.数据转出-批量转移-网店

对于开通了跨境版套餐的用户，可以在搜电商平台-网店查询列表页面选择数据进行转出，此时转移的线索主体是网店

配置地址：企业配置中的 syncUrl。平台将调用该地址，把线索数据推送到你方。

调用关系：我方 → 你方 syncUrl

请求方法：POST

请求 Header

Header	必填	说明
`access-token`	是	开通代理商时下发的 access-token
`Content-Type`	是	`application/json`

Body 签名（本接口）

sign = md5(taskId + oid + uid + appSecret)

taskId、oid、uid：与 Body 中字段值一致（字符串拼接，顺序固定）
appSecret：开通代理商时下发的密钥
sign 放在 Body 字段中（不是 Header）

Body 完整示例

{
  "sign": "xxxx", // 必填，见上方签名算法：md5(taskId + oid + uid + appSecret)
  "taskId": 1111, // 必填，任务 id（异步回调结果时需要用到）
  "async": 1, // 是否异步：0-同步，1-异步；批量固定为 1，须通过「转出完成回写」接口回传结果
  "oid": "123456", // 必填，登录用户在我们系统的企业账号 ID（据此确定是你方哪个企业账号转出的）
  "uid": "789012", // 必填，登录用户在我们系统的登录用户 ID（据此确定是你方哪个用户转出的）
  "batchId": "387cf029d31ef28836486", // 数据批次 id（回调任务结果时需要用到）。任务完成（异常或正常结束）后，会再调用一次 batchId="0" 且不传线索数据，仅作任务结束通知；此时你方无需再回调
  "clueType": "ONLINE_SHOP", // 线索类型：ONLINE_SHOP=网店
  "syncTaskOption": { // 同步任务选项：企业客户选中的转移功能模块
    "name": "客户管理", // 转移功能模块名称
    "additionalParams": { // 模块额外参数（来自 additionalConfigUrl 返回的配置）
      "code": 111, // 额外自定义参数
      "desc": "管理客户信息" // 额外自定义参数
    }
  },
  "clueItems": [ // 本批次线索列表
    { // ---------- 网店线索样例（ONLINE_SHOP），转网店线索时，线索数据的字段格式 ----------
      "id": "70db8286de8f03c9883ee617bb411195", // 平台线索数据唯一 id
      "name": "温州市兴之昌汽车部件有限公司", // 网店名称
      "contactItems": [ // 联系方式列表（字段含义同工商企业）
        {
          "content": "13868787644", // 联系号码
          "type": 1, // 1手机；2固话；3QQ；4邮箱
          "contactName": "华**", // 联系人姓名
          "contactPosition": "市场营销部-员工", // 联系人职位
          "contactDepartment": "市场营销部", // 联系人部门
          "numStatus": "1", // 1实号；2异常；3未知；5疑似代理
          "labels": [ // 联系方式标签
            "推荐",
            "近期收录",
            "疑似代理"
          ],
          "sourceNames": [ // 来源站点名
            "钉钉企典",
            "英才网"
          ]
        }
      ]
    }
  ]
}

你方即时响应

HTTP 200，5 秒内响应（业务处理不完请先入队）
否则该批视为转移失败

{
  "error_code": 0, // 须固定返回 0，否则该批视为转移失败
  "message": "" // 响应消息
}

异步处理完成后，调用数据转出中「3. 转出完成回写处理结果」接口回传结果（不同线索类型调用的回调接口参数都一样，会通过taskId对于到具体的任务）。

6.数据转出-批量转移-海关进出口企业

对于开通了跨境版套餐的用户，可以在搜海关数据-进口企业/搜海关数据-出口企业列表页面选择数据进行转出，此时转移的线索主体是海关进出口企业