PROBLEMS.md 3.7 KB
TMS接口常见问题
通过创建订单接口创建的订单登陆系统以后没有查看到
通过创建订单接口创建的订单登陆系统以后没有查看到创建订单接口必须使用主账号获取token以后再用主账号调用才能看到， 如果是用的子账号调用接口，将无法查看到相应的信息。正常调用成功以后只能通过主账号查看订单信息，如果希望子账号也能查看到订单信息，在使用主账号调用接口的时候需要传递一个 【organizationPath (string): 组织机构：可不填】参数，指定你希望哪个子账号对应的组织机构可以看到。
对应的组织机构需要调用获取组织机构列表接口，调用成功后返回的【path】参数即对应组织机构的参数值， 根据返回结果，把organizationPath的值设置为path中的值，比如0-11，这样，对应的组织机构就可以看到。
注意，直接用子账号调用创建订单接口是无法看到订单信息的！
更新受理单接口中的组织机构
更新受理单中的CustomerOrderEntity中有个可选参数：organizationPath，当用到组织机构时需要传递此参数，调用接口时传递的参数值为获取组织机构列表接口中的path的值 （即organizationPath=path），path的值不会因为修改组织机构名字而改变，所以需要先调用获取组织机构列表接口获取path，或者使用浏览器的开发者工具(一般按F12打开)在系统中查看，步骤如图。组织机构名字（name）是在【公司管理-组织机构管理】中手动设置的。
车次订阅接口与订单订阅接口
相同点：两者均为订阅成功后即开始推送，无需指定车次号(订单号)，订阅的是状态，不是某一个订单，任何变化到你订阅的状态的车次(订单)都会推送至订阅时指定的回调地址。例如：订阅的状态是40000(指派车次)，那当你系统中有车次被指派发布的时候该车次就会进行推送
不同点：一个车次中可以包含多个订单，两者的状态是不同的，车次状态的改变未必会导致订单状态改变，只有当车次状态变化时才会回调车次报文，订单接口同理。所以需要根据需求决定使用哪一个接口，或者两个结合使用。
注：回调地址的返回结果需要为json格式，如果成功要在返回信息中包含"code": 200，系统会根据这个值来判断消息是否投递成功，否则会重新进行投递
以下为两者状态的详细信息
