系统

[公共接口] 通途ERP平台对接指引文档(2017.06.14更新)

温馨提示:对接通途平台前提条件,确认K5系统已经购买了订单系统、客户API接口。(当前测试中,需要参与测试的客户,请联系我司更新K5系统版本)


第一步、物流商申请入驻通途平台

        物流公司申请入驻该平台,请先联系通途方面进行接入的前期沟通,如账户建立、Token申请、包括后续在通途平台设置渠道信息等事项均需与通途平台的工作人员进行沟通。

联系人:田先生     电话:135 1029 2481      QQ:1913967582

如需我司协助,请添加QQ:3001335228之后,建立讨论组。


提醒:在和通途对接人员沟通设置渠道的时候,请务必认真!!!否者渠道信息或者追踪号回传可能会出现异常。(通途需要的渠道代码必须与K5系统的渠道编码要一致!)

即:如果平邮渠道被物流商设置为无跟踪号,如果渠道设置为无跟踪号的话,即便K5系统返回了跟踪号,ERP也是不会保存的。这样就会影响客户在通途或者K5系统查询订单的效率。


第二步、K5系统设置通途(此处填写的Token是由通途平台提供

        物流公司在通途平台获取到Token后设置到K5系统中;

设置步骤:快件系统-订单管理-快件订单-通途接口-通途API设置(如下图)


    打开之后,将通途平台提供的Token填入,保存即可(如下图)



第三步、通途用户设置通途ERP(该部分由物流公司指引通途用户进行操作,下面需要填写的Token由客户在K5客户系统自主申请或物流商在内部系统开出

通途用户登陆通途ERP后,打开基础设置-仓储流中物流设置菜单,如下图

②通过新建或页面中快捷下拉选择物流商均可,选择好之后启用,如下图

③选择启用后的物流商,设置Token,保存完成通途ERP设置,如下图(PS,客户可以在物流商这里选择发货路线。):



重点内容:K5系统通途订单处理机制


①关于订单自动下载,自动预报,自动回传单号

  • K5系统自动定时任务到通途ERP上获取新订单,如果有新的订单就会下载到系统,进行自动预报,自动回传单号到通途ERP;

  • 下载、预报、回传频率为即时处理,订单多的时候可能需要稍微等待,请勿刷新;

  • 如下载好的订单因信息不符和渠道规则、预报代理无法通过代理数据验证等原因导致无法预报、无法获取到单号,K5系统会将导致预报失败的错误信息返回到通途平台,卖家根据错误提示处理之后,重新交运即可后,在下一次启动自动任务时自动继续预报、回传单号;


  • 在系统右上角的个人中心-系统提醒里会显示订单下载、预报、回传的异常、错误等消息提示;



  • 快件系统-订单管理-快件订单-通途接口-查看下载进度






②关于订单手动下载,手动预报,手动回传单号

系统也允许在需要的情况下、在非定时任务时进行人工手动下载订单,手动预报,回传单号;

  • 下载订单:在快件系统-订单管理-快件订单-通途接口-下载通途订单

  • 预报订单:在快件系统-订单管理-快件订单-根据状态选择需要预报的订单进行预报

  • 回传单号:在快件系统-订单管理-快件订单-选择需要回传单号的已预报订单-通途接口-回传单号

  • 出现错误或异常,同样可以在个人中心-系统提醒里面可以查看。

  • 快件系统-订单管理-快件订单-通途接口-查看下载进度里面查看订单下载进度、预报进度、回传进度。


③关于接口其他设置问题

  • 总重量问题:系统默认以通途订单的重量为准,即物品重量*数量;如通途订单无法计算出总量,则以K5系统订单默认值设置的默认总量为准。

  • 手动下载到同一订单多次:系统默认允许客户订单好重复,如过需要控制,可以设置进行控制,这样就不会下载到多次;  

    设置路径:系统管理-系统设置-业务设置-订单设置-订单是否控制客户订单号重复,将参数改成设置成1即可。


  • 目的地为空的时候,系统将不会回传信息到通途平台,通途平台上的订单则显示获取单号失败或回传超时之类的提示。

  • 关于回写,有单号才回传:

    通途系统订单状态:A 已在物流公司系统下单,C 已在物流公司系统交运/提审/预报,E 物流公司系统处理失败

    如果标签生成失败只回传单号,不修改回传标识(修改通途订单状态为:A)

    标签,单号都回传,修改回传标识(修改通途订单状态为:C)

    生成标签失败后待物流公司修改正确后会重新回传至通途(修改通途订单状态为:C)

  • 如调用代理接口打印标签,需在代理接口设置-打印类型设置中将需要回传平台的标签格式设为默认(平台只接收热敏纸张,所以一般只设置热敏格式为默认)

  • 服务商单号为空的时候后,系统回传系统订单号。

  • 如是快递渠道,需要回传转单号,进行如下操作:

    1、渠道设置单号生成方式:以订单号为准转单号回传(ERP平台订单)

    2、系统自动完成订单预报并回传订单号和内部标签

    3、物流商完成入仓或出仓操作,在运单管理进行单票或批量设置转单号(系统查件自动抓取到转单号)的那一刻,系统自动将转单号回传到平台


  • 后续如有更新请关注本文档,有其他疑问可联系专属客服进行提交,亦或有新的对接规则或需求也可以添加QQ:3001335228进行沟通。


#1楼
发帖时间:2016-6-3   |   查看数:0   |   回复数:0
游客组