UCC海外站 · 国内竞价大厅车源同步需求说明
目标：将国内竞价大厅车源同步到海外站，经海外运营审核后展示，用于获取询价 / 找车 / 代采线索。
1. 背景说明
本期做什么国内竞价车辆同步至海外站；海外运营审核上架；海外用户提交询价 / 找车 / 代采意向；国内状态变化后海外自动更新。
核心原因
- 国内竞价周期短，海外客户决策、销售跟进、保证金确认通常来不及匹配单台车。
- 海外站前台应弱化“立即竞拍这台车”，强化“Find Similar Cars / Ask UCC to Source”。
- 线索生命周期必须独立于车辆：车辆结束、成交、流拍后，线索仍可继续跟进。
2. Flow 流程图
1国内竞价大厅
在拍车源同步
在拍车源同步
2海外站接收
3硬规则校验
4车源待审核
5补充信息
审核上架
审核上架
6国内车辆
竞价结束同步
竞价结束同步
7海外站对应
下架车辆
下架车辆
3. 通用技术规则
| 规则 | 要求 |
|---|---|
| 接口鉴权 | 接口需做鉴权校验，具体鉴权方式由双方技术约定，例如 Token、签名、白名单等。 |
| 接口方向 | 数据由国内系统提供给 UCC。若采用国内主动推送，则字段为请求字段；若采用 UCC 拉取，则字段为返回字段。 |
| 唯一键 | domesticVehicleId + auctionId。同一车辆重新上拍视为新记录。 |
| 价格同步 | 当前价不逐笔同步，按固定时间间隔同步最新价格，或详情页按需拉取。 |
提供给 UCC 接口一：车辆列表接口
范围：竞价大厅的在拍车源，含报废车，不含有保留价拍卖、政企专场、顺序拍。
用途：提供海外站列表页所需的车辆基础字段。列表接口只提供列表展示必要信息，详情信息通过车辆详情接口获取。
PUSH / GET 车辆列表接口
/api/auction/vehicles支持国内按批次主动推送给 UCC；也支持 UCC 按分页、更新时间、竞价状态主动拉取车辆列表。
请求方式说明
| 场景 | 说明 |
|---|---|
| 国内主动推送 | 国内按批次把车辆列表数据推送给 UCC。该方式下字段为请求字段 / 推送字段。 |
| UCC 主动拉取 | UCC 按分页、更新时间、竞价状态等条件查询国内车辆列表。该方式下字段为返回字段。 |
UCC 主动拉取查询条件
| 字段 | 字段要求 |
|---|---|
page | 页码，从 1 开始。 |
pageSize | 每页数量，建议由双方技术约定最大值。 |
updatedAfter | 可选，按数据更新时间增量拉取，格式：yyyy-MM-dd HH:mm:ss。 |
auctionStatus | 可选，竞价状态：预展 / 拍卖中 / 成交 / 流拍 / 取消拍卖 / 撮合中。 |
字段说明
| 字段 | 字段要求 |
|---|---|
domesticVehicleId | 国内车辆 ID，必传。 |
auctionId | 竞价 ID，必传；同一车辆重新上拍视为新场次。 |
vin | VIN 码 / 车架号，建议必传，便于车辆唯一识别与海外展示。 |
brandId | 品牌 ID，必传。 |
seriesId | 车系 ID，必传。 |
modelId | 车型 ID，必传。 |
modelYear | 年款，例如 2021。 |
coverImageUrl | 车辆主图 URL。 |
cityName | 车辆所在地城市。 |
registerDate | 上牌时间，格式：yyyy-MM 或 yyyy-MM-dd。 |
mileage | 表显里程，单位：km。 |
energyType | 能源类型，需提供枚举值，便于海外站存储和英文翻译。建议枚举：gasoline 汽油 / diesel 柴油 / hybrid 混动 / ev 纯电 / other 其他。 |
biddingPrice | 起拍价，单位：CNY 元。 |
vehicleGrade | 车辆评分定级，例如 85A。 |
auctionEndTime | 竞价结束时间，格式：yyyy-MM-dd HH:mm:ss。 |
domesticAuctionStatus | 国内竞价状态：预展 / 拍卖中 / 成交 / 流拍 / 取消拍卖 / 撮合中。 |
updatedTime | 数据更新时间，格式：yyyy-MM-dd HH:mm:ss。 |
提供给 UCC 接口二：车辆详情接口
范围：竞价大厅的在拍车源，含报废车，不含有保留价拍卖、政企专场、顺序拍。
用途：提供车辆详情页所需的完整车辆信息。详情接口需包含车辆列表接口的全部字段。
PUSH / GET 车辆详情接口
/api/auction/vehicles/{domesticVehicleId}/{auctionId}可由国内推送详情数据给 UCC，也可由 UCC 根据国内车辆 ID + 竞价 ID 查询车辆详情。
字段说明
| 字段组 | 字段 | 是否必传 | 字段要求 |
|---|---|---|---|
| 唯一标识 | domesticVehicleId | 必传 | 国内车辆 ID。 |
| 唯一标识 | auctionId | 必传 | 竞价 ID；同一车辆重新上拍视为新竞价记录。 |
| 车型信息 | brandId | 必传 | 品牌 ID。 |
| 车型信息 | seriesId | 必传 | 车系 ID。 |
| 车型信息 | modelId | 必传 | 车型 ID。 |
| 车型信息 | modelYear | 必传 | 年款，例如 2021。 |
| 基础信息 | coverImageUrl | 必传 | 车辆主图 URL。 |
| 基础信息 | cityName | 必传 | 车辆所在地城市。 |
| 基础信息 | registerDate | 必传 | 上牌时间，格式：yyyy-MM 或 yyyy-MM-dd。 |
| 基础信息 | vin | 必传 | VIN 码 / 车架号。 |
| 基础信息 | manufactureDate | 必传 | 出厂日期，格式：yyyy-MM 或 yyyy-MM-dd。 |
| 基础信息 | vehicleProvinceName | 必传 | 车辆所在地 / 车辆存放地省市。 |
| 基础信息 | vehicleCityName | 必传 | 车辆所在地 / 车辆存放地城市。 |
| 基础信息 | compulsoryInsuranceExpireDate | 必传 | 交强险到期日，格式：yyyy-MM-dd。 |
| 基础信息 | annualInspectionExpireDate | 必传 | 年审有效期，格式：yyyy-MM。 |
| 基础信息 | mileage | 必传 | 表显里程，单位：km。 |
| 基础信息 | bodyColor | 必传 | 车身颜色。 |
| 基础信息 | gearbox | 必传 | 变速箱类型，需提供枚举值，便于海外站存储和英文翻译。建议枚举：mt 手动 / at 自动 / cvt CVT / dct 双离合 / amt AMT / other 其他。 |
| 能源信息 | energyType | 必传 | 能源类型，需提供枚举值，便于海外站存储和英文翻译。建议枚举：gasoline 汽油 / diesel 柴油 / hybrid 混动 / ev 纯电 / other 其他。 |
| 能源信息 | isNewEnergy | 必传 | 是否新能源，true / false。 |
| 图片信息 | imageList[] | 必传 | 车辆基础图列表；每张图片包含 url、sort、imageName。 |
| 手续材料 | drivingLicenseMainPageUrl | 必传 | 行驶证首页图片地址。 |
| 手续材料 | drivingLicenseSubPageUrl | 必传 | 行驶证副页图片地址。 |
| 手续材料 | registrationCertificatePage1To2Url | 必传 | 登记证 1-2 页图片地址。 |
| 手续材料 | registrationCertificatePage3To4Url | 必传 | 登记证 3-4 页图片地址。 |
| 检测报告 | vehicleGrade | 非必传 | 车辆评分定级，例如 85A；无评分时可为空。 |
| 检测报告 | englishInspectionReportUrl | 非必传 | 检测报告英文版地址，可为链接或 PDF 地址；没有检测报告时可为空。 |
| 检测报告 | hasEnglishReport | 必传 | 是否有英文报告；缺失不阻断同步，由海外运营审核处理。 |
| 费用信息 | feeTotalAmount | 必传 | 费用项合计金额，单位：CNY 元；包含手续费、平台使用费、综合服务费、评估费、违章罚款、其他费用等，不需要提供费用明细项。 |
| 竞价信息 | auctionType | 必传 | 竞价类型，默认：竞价大厅。 |
| 竞价信息 | biddingPrice | 必传 | 起拍价，单位：CNY 元。 |
| 竞价信息 | currentPrice | 必传 | 当前价，单位：CNY 元；仅作参考价。 |
| 竞价信息 | auctionEndTime | 必传 | 竞价结束时间，格式：yyyy-MM-dd HH:mm:ss。 |
| 竞价信息 | domesticAuctionStatus | 必传 | 国内竞价状态：预展 / 拍卖中 / 成交 / 流拍 / 取消拍卖 / 撮合中。 |
| 同步信息 | updatedTime | 必传 | 数据更新时间，格式：yyyy-MM-dd HH:mm:ss。 |
提供给 UCC 接口三：车辆状态通知
范围：竞价大厅的在拍车源，含报废车，不含有保留价拍卖、政企专场、顺序拍。
用途：同步国内车辆竞价状态变化，海外站根据状态更新前台展示和线索标记。
PUSH / GET 车辆状态通知
/api/auction/vehicles/status可采用国内主动通知 UCC，或 UCC 定时拉取状态变更列表。二选一即可。
状态字段
| 字段 | 字段要求 |
|---|---|
domesticVehicleId | 国内车辆 ID，必传。 |
auctionId | 竞价 ID，必传。 |
status | 国内竞价状态：预展 / 拍卖中 / 成交 / 流拍 / 取消拍卖 / 撮合中。 |
statusTime | 状态发生时间，格式：yyyy-MM-dd HH:mm:ss。 |
currentPrice | 可选，状态变化时的当前价，单位：CNY 元。 |
remark | 可选，状态说明。 |
海外功能点概要一：列表页
频道定位
建议命名：Sourcing Deals / Auction Sourcing。避免直接叫 Auction。
列表展示字段
| 字段 | 说明 |
|---|---|
| 标题 | 展示在主图前，用于快速识别车辆。 |
| 主图 | 车辆列表卡片展示图。 |
| 品牌 / 车系 / 车型 / 年款 | 基础展示信息。 |
| 车辆所在地 | 展示城市或地区。 |
| 里程 | 展示表显里程，单位 km。 |
| 能源类型 | 展示能源类型，海外站按枚举值做英文翻译。 |
| 起拍价 | 列表页仅展示起拍价，不展示当前价。 |
| 拍卖结束时间 | 展示拍卖结束时间；距离结束小于 24 小时时，展示倒计时。 |
| 车况等级 | 展示车辆评分定级，例如 85A。 |
| 是否有报告 | 展示是否有英文检测报告。 |
| CTA | 仅保留 Details / Contact Us。 |
筛选功能
| 筛选项 | 说明 |
|---|---|
| 品牌 / 车系 | 支持按品牌、车系筛选。 |
| 年款 | 支持按年款区间筛选。 |
| 起拍价 | 支持按起拍价区间筛选，单位 CNY 元。 |
| 车辆所在地 | 支持按城市或地区筛选。 |
| 里程范围 | 支持按里程区间筛选，单位 km。 |
| 车况等级 | 支持按车辆评分定级筛选，例如 85A。 |
排序功能
| 排序项 | 说明 |
|---|---|
| 竞价结束时间 | 按竞价结束时间先后排序。 |
| 里程数 | 支持从低到高、从高到低。 |
| 起拍价 | 支持从低到高、从高到低。 |
分页功能
| 功能 | 说明 |
|---|---|
| 分页展示 | 支持分页加载车辆列表。 |
| 每页数量 | 每页展示数量由海外站前端和后端约定。 |
| 筛选 / 排序联动 | 筛选或排序条件变化后，列表回到第一页重新查询。 |
海外功能点概要二：详情页
详情页展示内容
| 模块 | 展示内容 |
|---|---|
| 车辆基础信息 | 标题、主图 / 图片组、品牌、车系、车型、年款、VIN 码、出厂日期、车辆所在地 / 车辆存放地省市、上牌时间、表显里程、车身颜色、交强险到期日、年审有效期。 |
| 车辆参数 | 能源类型、变速箱类型、车辆评分定级、是否新能源。 |
| 价格信息 | 起拍价、费用项合计金额；不展示当前价。 |
| 拍卖信息 | 拍卖类型、拍卖结束时间；距离结束小于 24 小时时展示倒计时。 |
| 检测报告 | 是否有英文检测报告；有报告时展示检测报告英文版地址入口。 |
| 手续材料 | 行驶证首页、行驶证副页、登记证 1-2、登记证 3-4。 |
| 补充说明 | 过户说明、车辆补充描述等。 |
| 页面操作 | 保留 Inquiry / Share / Favorite / Contact Us，对应询盘、分享、收藏、联系我们。 |
详情页提示
The displayed auction price is for reference only. Final cost may include service fee, export handling fee, logistics, customs and other charges.
新能源 / 带电池车辆需提示：目的国进口与电池运输可能有限制，请先咨询。
海外功能点概要三：后台管理
模块名称
海外后台新增：竞价车源管理。
列表 Tab
待审核 / 已上架 / 已拒绝 / 信息不完整 / 同步失败 / 已成交 / 已流拍 / 已下架
列表字段
- 图片、车辆名称、品牌/车系/车型、当前价、剩余时间、国内状态、海外状态。
- 车况等级、是否新能源、可出口性标记、英文报告状态、同步时间、关联线索数。
操作
| 操作 | 说明 |
|---|---|
| 上架 / 下架 | 控制海外前台展示 |
| 拒绝展示 | 进入 rejected，不展示 |
| 重新审核 | 用于补充信息后再次进入待审核 |
| 编辑海外标题与摘要 | 不回写国内 |
| 查看检测报告 | 支持英文报告链接 / PDF |
| 查看失败原因 | 展示 mapping_failed、字段异常等原因 |
| 查看国内拍卖链接 | 便于运营核对 |
| 查看关联线索 | 进入销售跟进 |
海外功能点概要四：询盘线索
原则：线索是独立对象，不依赖车辆是否仍在竞拍。
| 字段 | 说明 |
|---|---|
leadId | 线索 ID |
contactName / phone / email / whatsapp | 联系方式 |
destinationCountry | 目的国 |
budget | 预算 |
usage | 用途 |
demandDescription | 需求描述 |
sourceVehicleId + auctionId | 来源车辆复合键 |
sourceVehicleSnapshot | 线索创建时车辆信息 |
vehicleStatusAtLeadTime | 线索创建时车辆状态 |
leadStatus | 新建 / 已联系 / 已确认代采意向 / 转同类找车 / 已成交 / 关闭 |
ownerSalesId | 归属销售 |
followUpRecords[] | 跟进记录 |
线索状态联动
- 来源车
sold：线索不关闭，可转同类找车。 - 来源车
unsold：线索转同类找车需求；如为撮合失败 / 超时，可作为重点线索继续跟进。 - 来源车
cancelled：标记车辆已取消，销售继续确认客户真实需求。