本指引适用于已有原承运商转单号,需要将箱唛资料发送给 Banri 并取得换单号的业务。
先通过原承运商取得转单号,再向 Banri 推送整票与每箱资料,最后将 Banri 返回的号码保存到运单“换单号”字段。
原转单号与换单号是两个不同字段。本功能不会用 Banri 换单号替换原转单号,也不会生成或替换原承运商 PDF 面单;不包含轨迹接口对接。
账号、密码按服务商提供的原文填写,保留字母、符号及前导零。
清关空港:羽田对应 haneda,成田对应 narita。它是当前 API 的共用配置;标准功能不会根据订仓号的4002、4006等前缀自动切换空港。不同空港需要分别配置并正确绑定,不能仅修改订仓号就认为空港会改变。
若看不到模板、换单功能或操作按钮,请管理员核对功能开放、账号权限及当前发货渠道的绑定。
【待补截图 1:Banri API 参数设置】
截取“Banri扫码换标”模板名称和参数设置区域;保留接口域名、账号、密码、物流公司、清关空港的字段名称,展示物流公司和空港的选择位置。接口域名和账号密码的值必须遮挡,密码即使显示为圆点也要遮挡。标注:①模板名称 ②物流公司 ③清关空港。
补图后,请用图片替换本提示框。
【待补截图 2:实际发货渠道绑定】
截取实际发货渠道的“转单API设置”区域,展示原承运商取号模板、Banri“换单API模板”和“获取转单号后自动获取换单号”开关的当前状态。标注:①保留原取号配置 ②Banri换单模板 ③自动取号开关。遮挡真实渠道名称等业务信息;不必为拍图改变当前配置。
补图后,请用图片替换本提示框。
【待补截图 3:整票资料填写位置】
截取运单中订仓号、原转单号、收件人识别码及实际发货渠道所在区域;字段不在同一屏可分为3A、3B。标注上述字段;私人地址示例应显示识别码填写“私人地址”,收件信息使用虚构数据或遮挡真实值。
补图后,请用图片替换本提示框。
例如重量2或2.0可以按整数处理,2.1不能直接通过;尺寸30.5也不符合整数要求。标准对接不会自动向上取整。若已配置额外的前置脚本,应另行确认它对原单件数据的修改,不能把脚本效果当作标准功能。
预计落地日期由系统按北京时间推送当天的次日填写,不代表服务商承诺的实际到达日期。
【待补截图 4:每件明细】
截取单件明细表,展示子转单号、子FBA单号、实重、长宽高及单位;建议用一票两件的测试数据,展示不同的子转单号。标注:①子转单号 ②子FBA单号 ③实重(公斤)④长宽高(厘米)。遮挡真实箱唛和单号,保留字段标题与整数示例。
补图后,请用图片替换本提示框。
推送后系统会查询 Banri 返回的号码;遇到错误应查看对应提示,不应仅凭资料推送成功就认为已取得换单号。
【待补截图 5:获取换单号操作入口】
截取运单页面中“获取换单号”所在的实际菜单或按钮;若需展开菜单,展示展开后的状态,并用箭头标出入口。保留上级菜单,方便客户找到;无需为截图提交真实业务任务。
补图后,请用图片替换本提示框。
完整成功:运单已保存 Banri 返回的换单号,且对应整票和各件资料正确。
已推送但未出号:Banri 已接收资料,但尚未返回最终号码;此时不是已经取号成功,也不能仅凭换单号为空认定推送失败。先查看处理状态,必要时请 Banri 核对该批次,不要立即重复创建。
查询时,系统会结合订仓号、原转单号及整套子转单号核对返回记录,不会随意取同一批次中的另一票号码。多条记录同时匹配时,需要先处理重复或关联异常。
【待补截图 6:成功结果与处理记录】
使用已成功的测试运单,截取“换单号”已有值及原转单号仍保留的结果;不同页签可分为6A、6B。另可附相应成功处理记录,保留状态和时间,遮挡真实单号及日志中的敏感内容。用一致的A/B标记区分原转单号与换单号,不要将“推送成功但尚未出号”作为取号成功截图。
补图后,请用图片替换本提示框。
以下号码全部为虚构示例,不可直接用于正式推送:
订仓号:4002TEST0001
原转单号:TEST-MAIN-001
第1件子转单号:TEST-BOX-001;子FBA单号:TEST-FBA-001;实重10公斤;尺寸40×30×20厘米。
第2件子转单号:TEST-BOX-002;子FBA单号:TEST-FBA-002;实重12公斤;尺寸50×35×25厘米。
清关空港:在 API 中明确选择羽田,而不是依赖订仓号前缀自动判断。
Banri 返回有效号码后,系统保存到本票“换单号”。原转单号与子转单号不因标准取号流程被自动改成换单号。
找不到“获取换单号”:检查权限、功能开放,以及实际发货渠道是否绑定了 Banri 换单API。
提示订仓号不足四位:按双方约定补全真实订仓号,再核对前4位含义。
提示子转单号或子FBA单号为空:逐件补齐真实资料,不能只填写整票转单号。
提示重量或尺寸不是整数:核对每件单位及实际数据。不要仅为通过校验而随意截断、取整。
认证失败:核对域名与完整账号密码,确认是否误删字母、符号或前导零。
推送成功但换单号仍为空:先查看后台任务与 Banri 处理结果;确认是否等待出号,不要重复创建。
查询结果不匹配或重复:将订仓号、原转单号、各件子转单号及错误时间交给支持人员核查,先确认原任务是否已生成。
清关空港不正确:检查实际绑定的 Banri API;只改订仓号不会自动修改空港。