orderApi.php 5.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187
  1. <?php
  2. /**
  3. * User: admin
  4. * Date Time: 2021/3/25 22:34
  5. */
  6. namespace common\components\dada\api;
  7. use common\components\dada\config\urlConfig;
  8. class orderApi extends baseApi
  9. {
  10. public function __construct()
  11. {
  12. parent::__construct('','');
  13. }
  14. /**
  15. * @param $params
  16. * 新增订单 新增配送单接口
  17. */
  18. public function addOrder($params)
  19. {
  20. $this->setUrl(urlConfig::ORDER_ADD_URL);
  21. $this->setBusinessParams($params);
  22. }
  23. /**
  24. * @param $params
  25. * 重新发布订单 在调用新增订单后,订单被取消、过期或者投递异常的情况下,调用此接口,可以在达达平台重新发布订单 接口调用URL地址:/api/order/reAddOrder。
  26. */
  27. public function reAddOrder($params)
  28. {
  29. $this->setUrl(urlConfig::ORDER_RE_ADD_URL);
  30. $this->setBusinessParams($params);
  31. }
  32. /**
  33. * @param $params
  34. * 订单预发布
  35. * 1、查询订单运费接口,接口URL地址:/api/order/queryDeliverFee。
  36. */
  37. public function queryDeliverFee($params)
  38. {
  39. $this->setUrl(urlConfig::ORDER_DELIVER_FEE);
  40. $this->setBusinessParams($params);
  41. }
  42. /**
  43. * @param $params
  44. * 订单预发布
  45. * 2、查询运费后发单接口,接口URL地址:/api/order/addAfterQuery。
  46. */
  47. public function addAfterQuery($params)
  48. {
  49. $this->setUrl(urlConfig::ORDER_AFTER_QUERY);
  50. $this->setBusinessParams($params);
  51. }
  52. /**
  53. * @param $params
  54. * 增加小费
  55. * 可以对待接单状态的订单增加小费。需要注意:订单的小费,以最新一次加小费动作的金额为准,故下一次增加小费额必须大于上一次小费额。
  56. * 接口调用URL地址:/api/order/addTip。
  57. */
  58. public function addTip($params)
  59. {
  60. $this->setUrl(urlConfig::ORDER_ADD_TIP);
  61. $this->setBusinessParams($params);
  62. }
  63. /**
  64. * @param $params
  65. * 订单详情查询
  66. * 查询订单的相关信息以及骑手的相关信息,具体信息参见参数说明。
  67. * 接口调用请求说明,URL地址:/api/order/status/query。
  68. */
  69. public function queryOrderStatus($params)
  70. {
  71. $this->setUrl('/api/order/status/query');
  72. $this->setBusinessParams($params);
  73. }
  74. /**
  75. * @param $params
  76. * 在订单待接单或待取货情况下,调用此接口可取消订单。注意:接单后1-15分钟内取消订单,运费退回。同时扣除2元作为给配送员的违约金
  77. * 接口调用请求说明,URL地址:/api/order/formalCancel
  78. */
  79. public function formalCancel($params)
  80. {
  81. $this->setUrl('/api/order/formalCancel');
  82. $this->setBusinessParams($params);
  83. }
  84. /**
  85. * @param $params
  86. * 获取取消原因
  87. * 调用取消订单接口时,需要传递取消原因ID,通过此接口获取订单取消理由列表
  88. * 接口调用请求说明,URL地址:/api/order/cancel/reasons。
  89. */
  90. public function reasonsCancel($params)
  91. {
  92. $this->setUrl('/api/order/cancel/reasons');
  93. $this->setBusinessParams($params);
  94. }
  95. /**
  96. * @param $params
  97. * 追加订单
  98. * 商户调用该接口将已发布的订单追加给指定的配送员,接口URL地址:/api/order/appoint/exist
  99. * 1. 追加的订单必须是该门店发出的处于待接单状态的订单
  100. * 2. 只能从符合条件的配送员列表选取配送员进行追加,参考查询追加配送员
  101. */
  102. public function existAppoint($params)
  103. {
  104. $this->setUrl('/api/order/appoint/exist');
  105. $this->setBusinessParams($params);
  106. }
  107. /**
  108. * @param $params
  109. * 取消追加订单
  110. * 商户调用该接口取消已发布的追加订单,接口URL地址:/api/order/appoint/cancel
  111. * 被取消的追加订单,状态变为待接单,其他配送员可见
  112. */
  113. public function cancelAppoint($params)
  114. {
  115. $this->setUrl('/api/order/appoint/cancel');
  116. $this->setBusinessParams($params);
  117. }
  118. /**
  119. * @param $params
  120. * 查询追加配送员
  121. * 商户调用该接口查询可追加订单的配送员列表,接口URL地址:/api/order/appoint/list/transporter
  122. * 可追加的配送员需符合以下条件:
  123. 1. 配送员在1小时内接过此商户的订单,且订单未完成
  124. 2. 配送员在当前商户接单数小于系统限定的指定商户接单总数
  125. 3. 配送员在达达平台的接单数量未达上限
  126. */
  127. public function transporterAppointList($params)
  128. {
  129. $this->setUrl('/api/order/appoint/list/transporter');
  130. $this->setBusinessParams($params);
  131. }
  132. /**
  133. * @param $params
  134. * 商家投诉达达
  135. * 达达配送员接单后,商家如果对达达服务不满意,均可以使用该接口对达达进行投诉。
  136. * 接口调用请求说明,URL地址:/api/complaint/dada
  137. */
  138. public function dadaComplaint($params)
  139. {
  140. $this->setUrl('/api/complaint/dada');
  141. $this->setBusinessParams($params);
  142. }
  143. /**
  144. * @param $params
  145. * 获取商家投诉达达原因
  146. * 商家投诉达达,需要传递投诉原因ID,通过此接口获取投诉原因列表
  147. * 接口调用请求说明,URL地址:/api/complaint/reasons。
  148. */
  149. public function reasonsComplaint($params)
  150. {
  151. $this->setUrl('/api/complaint/reasons');
  152. $this->setBusinessParams($params);
  153. }
  154. /**
  155. * @param $params
  156. * 妥投异常之物品返回完成
  157. * 订单妥投异常后,订单状态变为9,骑士将物品进行返还,如果商家确认收到物品后,可以使用该 接口进行确认,订单状态变成10,同时订单终结。
  158. * 接口调用请求说明,URL地址:/api/order/confirm/goods。
  159. */
  160. public function goodsConfirm($params)
  161. {
  162. $this->setUrl('/api/order/confirm/goods');
  163. $this->setBusinessParams($params);
  164. }
  165. }