¶ 跨境堡货运保险对接操作指南
跨境堡对接用于把易抵达运单带到跨境堡完成投保，并把审核结果回传到运单中。当前支持 传统货运 和 跨境大货 两类投保。
本功能涉及保险账号和接口密钥。首次开通、修改密钥或调整字段映射时，请由管理员或实施人员操作；普通操作员不需要接触密钥。
¶ 一、使用前准备
开始前请确认：
- 当前账号为员工账号，并且有查看和操作运单的权限。
- 跨境堡已为机构开通账号。
- 管理员已经完成“跨境堡设置”。
- 运单已填写客户单号、申报价值、申报币种、重量、件数、收发件国家和地址等投保所需信息。
- 当前运单属于快递、小包或专线等支持显示“投保”页签的业务类型。
¶ 二、管理员：完成跨境堡设置
¶ 1. 打开设置入口
- 在主界面右上角打开 菜单。
- 点击 系统参数。
- 打开 其他 页签。
- 在“对接”区域点击 跨境堡设置。
¶ 2. 填写连接信息和字段映射
配置窗口分为两类内容：
- 基础连接信息：客户注册域名、投保链接域名，以及跨境堡分配或注册后回传的账号信息。
- 字段映射：运输方式、航次、提单号、目的地、起运日期、货物类别、货物描述、包装类型、加成比例、派送方式、被保险人信息等。
注意事项：
- 账号 ID、密钥和域名必须使用跨境堡正式提供的内容，不要照抄截图或示例。
- 标有“支持公式”的字段，应由实施人员按本机构运单字段设置。
- 起运日期应能转换为日期；加成比例应为数字。
- “快递公司”仅在跨境大货场景需要时填写。
- 保存前检查所有必填项。密钥不要通过群聊、截图或文档明文传播。
¶ 三、操作员：发起投保
¶ 1. 选择运单
- 进入快递、小包或专线运单列表。
- 勾选需要投保的运单。
- 点击 获取转单号 右侧的展开按钮。
- 在更多操作中点击 投保。
如果页面只有“推送投保”而没有“投保”，请不要混用。两者是不同功能，请联系管理员确认跨境堡功能入口和账号权限。
¶ 2. 首次使用时完成注册
如果机构尚未完成跨境堡注册，系统会打开跨境堡注册页面。
- 按跨境堡页面提示完成注册。
- 注册成功后，跨境堡会把机构账号信息回传到易抵达。
- 返回易抵达，重新选择运单并点击 投保。
如果每次都重复进入注册页，请联系管理员检查注册是否成功回传，以及账号信息是否已写入“跨境堡设置”。
¶ 3. 选择投保产品
已注册的机构会看到“选择投保产品”窗口：
- 传统货运：适用于传统货运保险。
- 跨境大货：适用于跨境大货保险。
选择产品并确认后，系统会打开跨境堡投保页面。请在跨境堡页面核对并补充信息，再按页面提示提交审核。
系统会根据运单和管理员设置生成投保信息。提交前仍需人工核对投保人、货物、运输方式、金额和日期，避免错误投保。
¶ 四、查看审核结果、保单和理赔入口
- 在运单列表双击目标运单，打开运单详情。
- 点击 投保 页签。
- 查看投保金额、货值、实际重量和审核状态。
- 需要查看保单时，点击 获取保单详情链接API。
- 需要进入理赔页面时，点击 获取理赔详情链接API。
审核结果由跨境堡回传，可能不会立即显示。页面字段为空时，请稍后刷新；长时间未回传再联系管理员排查。
¶ 五、如何确认操作成功
满足以下条件即可认为本次投保流程已正常完成：
- 能正常打开跨境堡投保页面。
- 在跨境堡页面提交后，可以看到相应的受理或审核状态。
- 返回易抵达运单详情，“投保”页签出现投保金额、货值、实际重量或审核状态。
- 有保单数据后，可以打开保单详情；有理赔数据后，可以打开理赔详情。
¶ 六、常见问题
¶ 看不到“投保”入口
确认使用员工账号，并检查业务类型、角色权限和跨境堡配置。不要把另一套“推送投保”功能当作跨境堡投保。
¶ 提示“请检查必填参数是否缺失”
通常是跨境堡域名或基础连接信息未填写完整。请管理员返回“跨境堡设置”检查。
¶ 点击确认后没有打开跨境堡页面
先检查浏览器是否拦截了新窗口；仍无法打开时，请管理员检查投保链接域名和接口返回信息。
¶ 投保页签一直没有审核结果
跨境堡审核完成后才会回传结果。先刷新运单详情；超过正常审核时间仍为空，再由管理员核对投保单号和回传情况。
¶ 保单或理赔按钮无法打开
通常表示跨境堡尚未生成对应数据，或当前运单还未通过相应审核。先确认审核状态，再重试。
¶ 七、安全提示
- 不要在聊天、截图或文档中发送账号密码、密钥或完整接口报文。
- 截图用于排查时，应遮住客户单号、姓名、电话、地址、金额和账号信息。
- 测试时使用演示运单，不要用真实客户资料反复提交投保。
相关入口：其他承运商 / 代理接口