这页给使用易抵达系统的用户看。平台、ERP、承运商或代理接口出问题时,不要先猜原因,先确认问题发生在哪一步,再看日志和报文。
| 现象 |
先看哪里 |
| 授权失败、密钥无效、店铺绑定不上 |
对应平台或 ERP 的授权文档、授权返回报错 |
| 抓不到订单、订单漏抓、订单状态不对 |
抓单接口列表、最近抓取状态、抓单日志、抓单报文 |
| 打单失败、没有转单号、没有面单 |
运单日志、转单报文、发货渠道绑定的打单接口 |
| 发货后没有回传平台或 ERP |
运单回传日志、回传报文、转单号和承运商映射 |
| 轨迹没有更新或没有回传 |
轨迹接口配置、轨迹抓取日志、轨迹报文 |
| 查价失败或费用不对 |
运费 API、查价报文、报价、分区、重量和附加费配置 |
报文就是易抵达和外部系统接口交互时的原始请求和返回内容。对接问题通常要靠报文判断是哪一方的问题:
- 易抵达有没有真正向平台、ERP、承运商或代理发起请求。
- 请求里的店铺、订单号、运单号、渠道、重量、地址、申报、服务代码等参数是否正确。
- 对方返回的是成功、空数据、权限错误、参数错误、限流,还是承运商业务规则拒绝。
- 页面弹窗只是一句摘要,报文里的错误码和返回字段才是排查依据。
报文可能包含收件人、电话、地址、申报、Token 或平台返回的敏感信息。反馈问题时只发给易抵达客服或技术人员,不要发到公开群里。
| 场景 |
常见入口 |
| 抓单、订单回传 |
抓单接口详情、接口日志;员工账号可在接口详情里看“报文”页签 |
| 打单、获取转单号、获取面单 |
运单日志、失败弹窗里的“下载报文”、运单相关页面的转单报文 |
| 轨迹抓取 |
运单详情、轨迹日志;有权限的人员可抓取轨迹报文 |
| 查价、打包、库存、仓库接口 |
对应接口日志或由客服/技术人员按接口记录查看请求和返回报文 |
如果页面提示“没有找到报文”,通常表示这次操作没有生成可下载报文,或请求还没有走到外部接口。此时需要同时提供运单日志、操作时间和操作页面,让易抵达判断是配置问题、前置校验拦截,还是接口记录没有生成。
先确认当前对接对象是哪一类:
- 店铺平台订单抓取:进入 电商对接,选择对应平台文档。
- ERP 或 WMS 对接:进入 ERP 对接,选择对应 ERP 文档。
- 承运商、代理、查价、轨迹、打单接口:进入 承运商与代理接口。
常见检查项:
- API ID、Token、密钥、店铺编号、客户编号是否复制完整。
- 平台后台是否已经授权给其他系统。
- 授权账号是否有订单、发货、库存、物流回传等权限。
- 易抵达接口配置里选择的客户、仓库、收货渠道是否正确。
- 如果平台要求白名单 IP,确认已经把易抵达提供的 IP 加入白名单。
- 如果授权后仍然失败,看授权或抓单报文里对方返回的是权限不足、Token 过期、签名错误,还是店铺状态异常。
相关文档:
先在抓单接口列表看最近抓取状态和时间,再打开接口日志或报文查看平台返回内容。重点检查:
- 平台订单是否处于可抓取状态,例如待发货、待处理、配送准备等。
- 抓单时间范围是否覆盖了这批订单。
- 店铺、客户、仓库或收货渠道是否选错。
- 同一个店铺是否配置了多个抓单接口,导致重复或互相影响。
- 报文里平台返回的是空列表,还是权限不足、参数错误、接口限流。
- 如果报文里有订单但易抵达没有生成运单,再看订单是否已存在、是否被过滤、客户或渠道映射是否缺失。
入口:
打单失败优先看运单日志和转单报文,不要只看页面弹窗。重点检查:
- 运单是否已经绑定正确的发货渠道。
- 发货渠道是否绑定了正确的打单接口。
- 收件人地址、邮编、电话、国家、申报信息、重量、尺寸是否完整。
- 承运商或代理是否要求特殊服务、危险品、电池、无纸化等参数。
- 如果是异步取号,确认是否需要等待或手动抓取转单号。
- 如果失败弹窗提供“下载报文”,先下载并保留请求报文和返回报文。
- 返回报文里如果写着未返回转单号、未返回 label、服务代码不支持、地址校验失败,按承运商返回内容处理。
相关文档:
回传失败时先确认运单已经有转单号,并且承运商名称可以被平台识别。重点检查:
- 运单是否已经成功打单并生成转单号。
- 运单承运商是否为空,或与平台官方承运商名称不一致。
- 是否需要维护承运商映射,例如平台要求固定承运商名称。
- 抓单接口授权是否仍然有效。
- 运单回传日志和回传报文里平台返回的错误内容是什么。
- 如果报文显示平台已接收,但页面状态未更新,记录平台订单号、运单号和回传时间再反馈。
相关文档:
轨迹或查价异常时,先确认这不是打单问题。已经有转单号但轨迹不更新,查轨迹接口和轨迹报文;打单前费用查不出,查运费 API、报价和查价报文。
重点检查:
- 转单号、承运商和轨迹来源是否完整。
- 承运商官网或代理接口是否已经有轨迹。
- 轨迹报文里返回的是无轨迹、单号不存在、接口异常,还是对方接口超时。
- 查价报文里的国家、邮编、重量、尺寸、渠道代码是否和报价规则一致。
- 查价成功但费用不对时,再检查分区、附加费、燃油费和客户报价版本。
相关入口:
为了更快定位,请提供:
- 机构名称或客户名称。
- 具体平台、ERP、承运商或代理名称。
- 问题发生的页面和接口名称。
- 一票可复现的运单号或平台订单号。
- 运单日志、接口日志或平台返回报错截图。
- 请求报文和返回报文,能下载文件就发文件,不能下载就截图关键错误码和返回内容。
- 你希望系统得到的结果,例如应抓到订单、应返回转单号、应回传平台。
只给一张弹窗截图通常不够,因为弹窗经常只显示摘要,不能判断请求参数和对方完整返回。