LogisticSFService.php 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327
  1. <?php
  2. namespace App\Services;
  3. use App\Exceptions\WarningException;
  4. use App\OrderPackage;
  5. use Exception;
  6. use Illuminate\Http\Client\Response;
  7. use Illuminate\Support\Carbon;
  8. use Illuminate\Support\Facades\Http;
  9. class LogisticSFService
  10. {
  11. /**
  12. * 顺丰字段与数据库字段的映射关心
  13. * @var string[]
  14. */
  15. protected $protected_switch = [
  16. 'logistic_number' => 'mailno',
  17. 'transfer_status' => 'remark',
  18. 'received_at' => 'accept_time',
  19. ];
  20. /**
  21. * 获取顺丰快递揽收数据
  22. * @param array $logisticNums [logisticNums]快递单号数组
  23. * @return array 快递揽收信息数组
  24. * @throws Exception 未知的丰桥opCode
  25. */
  26. public function get(array $logisticNums): array
  27. {
  28. // 将$logisticNums以10个位单位进行分割,返回二维数组
  29. $logisticNums_size_10 = array_chunk($logisticNums, config('api_logistic.SF.max_size', 10));
  30. // 遍历二维数组批量查询顺丰接口
  31. //将查询到的结果整合到一起,更新order_packages.received_at
  32. $result = [];
  33. foreach ($logisticNums_size_10 as $numbers) {
  34. $numbersStr = implode(',', $numbers);
  35. $result_10 = $this->getResultFromSF(config('api_logistic.SF.head'), $numbersStr, config('api_logistic.SF.check_word'), config('api_logistic.SF.url'));
  36. $result = array_merge($result, $result_10);
  37. }
  38. return $result;
  39. }
  40. /**
  41. * @param string $head 客户号
  42. * @param string $numbers 快递单号字符串,多个以','分隔
  43. * @param string $checkWord 客户秘钥
  44. * @param string $url 顺丰接口地址
  45. * @return array
  46. * @throws Exception 未知的丰桥opCode
  47. */
  48. public function getResultFromSF(string $head, string $numbers, string $checkWord, string $url): array
  49. {
  50. $responseBody = get_object_vars(simplexml_load_string($this->sendHttpToSF($head, $numbers, $checkWord, $url))->Body)['RouteResponse'];
  51. $result = [];
  52. if (is_array($responseBody)) {//SF返回多个单号的查询结果
  53. $result = $this->transformSFMoreToArr($responseBody, $result);
  54. } else {
  55. $result[] = $this->transformSFOneToArr(get_object_vars($responseBody), []);
  56. }
  57. return $result;
  58. }
  59. /**
  60. * 构建顺丰xml请求体
  61. * @param string $head
  62. * @param string $number
  63. * @return string
  64. */
  65. private function buildXmlStr(string $head, string $number): string
  66. {
  67. return <<<xml
  68. <?xml version="1.0" encoding="utf-8" ?>
  69. <Request service='RouteService' lang='zh-CN'>
  70. <Head>$head</Head>
  71. <Body>
  72. <RouteRequest
  73. tracking_number="{$number}" tracking_type='1' method_type='1'
  74. />
  75. </Body>
  76. </Request>
  77. xml;
  78. }
  79. /**
  80. * 将单个单号的顺丰数据转换为数组
  81. * @param array $routeResponse
  82. * @param array $data
  83. * @return array
  84. * @throws Exception
  85. */
  86. public function transformSFOneToArr(array $routeResponse, array $data): array
  87. {
  88. $data['logistic_number'] = $routeResponse['@attributes'][$this->protected_switch['logistic_number']];
  89. try {
  90. $lastRoute = get_object_vars($routeResponse['Route'][count($routeResponse['Route']) - 1])['@attributes'];//获取最新的路由信息
  91. $data = $this->switchOpCodeToStatus($lastRoute, $data);
  92. $data['transfer_status'] = $this->transformRoutes($routeResponse['Route']);
  93. $data = $this->setExceptionType($data, $lastRoute);
  94. } catch (Exception $e) {
  95. throw new WarningException("单号没有查询到快递路由信息','LogisticSFService->transformSFOneToArr->{$data['logistic_number']}");
  96. } finally {
  97. return $data;
  98. }
  99. }
  100. /**
  101. * 转换快递路由信息
  102. * @param array $routs 快递路由
  103. * @return array
  104. */
  105. public function transformRoutes(array $routs): array
  106. {
  107. $result = [];
  108. foreach ($routs as $route) {
  109. $route = get_object_vars($route)['@attributes'];
  110. $data['accept_time'] = $route['accept_time'];
  111. $data['accept_address'] = $route['accept_address'];
  112. $data['remark'] = $route['remark'];
  113. $result[] = $data;
  114. }
  115. return $result;
  116. }
  117. /**
  118. * 将最新路由信息转换为数组
  119. * @param array $lastRoute
  120. * @param array $data
  121. * @return array
  122. * @throws Exception
  123. */
  124. public function switchOpCodeToStatus(array $lastRoute, array $data): array
  125. {
  126. try {
  127. switch ($lastRoute['opcode']) {
  128. case 123:
  129. case 130:
  130. case 3036:
  131. case 31:
  132. case 30:
  133. case 36:
  134. $data['status'] = '在途';
  135. break;
  136. case 70:
  137. case 33:
  138. $data['status'] = '派送异常';
  139. $data['exception'] = '是';
  140. break;
  141. case 204:
  142. case 44:
  143. $data['status'] = '派送中';
  144. break;
  145. case 50:
  146. $data['status'] = '已揽收';
  147. break;
  148. case 607:
  149. case 8000:
  150. case 80:
  151. $data['status'] = '已收件';
  152. $data['received_at'] = $lastRoute[$this->protected_switch['received_at']];
  153. break;
  154. case 648:
  155. case 99:
  156. $data['status'] = '返回中';
  157. break;
  158. default:
  159. throw new WarningException("未知的丰桥状态码: {$lastRoute['opcode']}->{json_encode($lastRoute)}");
  160. }
  161. } catch (WarningException $e) {
  162. $data['status'] = '其他异常';
  163. } finally {
  164. return $data;
  165. }
  166. }
  167. /**
  168. * @param string $head
  169. * @param string $numbers
  170. * @param string $checkWord
  171. * @param string $url
  172. * @return Response
  173. * @throws Exception
  174. */
  175. public function sendHttpToSF(string $head, string $numbers, string $checkWord, string $url): Response
  176. {
  177. $xml = $this->buildXmlStr($head, $numbers);
  178. $checkingJson = $xml . $checkWord;
  179. $verifyCode = base64_encode(md5($checkingJson, true));
  180. try {
  181. $response = Http::withHeaders(['Content-Type' => 'text/xml'])->get($url, ['xml' => $xml, 'verifyCode' => $verifyCode]);
  182. } catch (Exception $e) {
  183. throw new WarningException("HTTP请求顺丰接口异常->{$e->getMessage()}");
  184. }
  185. return $response;
  186. }
  187. /**
  188. * 将多个顺丰的单号转换为数组
  189. * @param array $responseBody
  190. * @param array $result
  191. * @return array
  192. * @throws Exception
  193. */
  194. public function transformSFMoreToArr(array $responseBody, array $result): array
  195. {
  196. foreach ($responseBody as $routeResponse) {
  197. $result[] = $this->transformSFOneToArr(get_object_vars($routeResponse), []);
  198. }
  199. return $result;
  200. }
  201. /**
  202. * @param array $data
  203. * @param $lastRoute
  204. * @return array
  205. */
  206. private function setExceptionType(array $data, $lastRoute): array
  207. {
  208. $logistic_number = $data['logistic_number'];
  209. /** @var OrderPackage $orderPackage */
  210. $orderPackage = OrderPackage::query()->with('order')->where('logistic_number', $logistic_number)->first();
  211. $delivered_duration = now()->diffInHours(Carbon::parse($orderPackage['send_at']));
  212. $last_routed_duration = now()->diffInHours(Carbon::parse($lastRoute['accept_time']));
  213. $VALID_HOURS = 4;
  214. $SHORT_RESPONSE_HOURS = 24;
  215. $LONG_RESPONSE_HOURS = (function ($province) {
  216. switch ($province) {
  217. case '浙江省':
  218. case '江苏省':
  219. case '上海':
  220. case '安徽省':
  221. return 72;
  222. case '北京':
  223. case '天津':
  224. case '江西省':
  225. case '湖北省':
  226. case '湖南省':
  227. case '广东省':
  228. case '福建省':
  229. case '山东省':
  230. case '河北省':
  231. case '河南省':
  232. case '山西省':
  233. case '四川省':
  234. case '陕西省':
  235. case '重庆':
  236. case '广西壮族自治区':
  237. case '贵州省':
  238. case '云南省':
  239. case '海南省':
  240. case '吉林省':
  241. case '黑龙江省':
  242. case '辽宁省':
  243. return 120;
  244. case '青海省':
  245. case '宁夏回族自治区':
  246. case '甘肃省':
  247. case '内蒙古自治区':
  248. case '新疆维吾尔自治区':
  249. case '西藏自治区':
  250. return 168;
  251. default:
  252. break;
  253. }
  254. })($orderPackage->order->province);
  255. $SENDING_RESPONSE_HOURS = 48;
  256. $IS_ROUTED = 1; //0000 0001
  257. $IS_IN_VALID_TIME = 2; //0000 0010
  258. $IS_WEIGHED = 4; //0000 0100
  259. $IS_RECEIVED = 8; //0000 1000
  260. $IS_SENDING = 16; //0001 0000
  261. $IS_SHORT_NO_RESPONSE = 32; //0010 0000
  262. $IS_LONG_NO_RESPONSE = 64; //0010 0000
  263. $IS_SENDING_NO_RESPONSE = 128; //0010 0000
  264. $conclusion = (function () use (
  265. $data, $delivered_duration, $last_routed_duration,
  266. $VALID_HOURS, $IS_ROUTED, $IS_IN_VALID_TIME, $IS_WEIGHED, $IS_RECEIVED, $IS_SENDING, $IS_SHORT_NO_RESPONSE, $IS_LONG_NO_RESPONSE, $IS_SENDING_NO_RESPONSE,
  267. $SHORT_RESPONSE_HOURS, $LONG_RESPONSE_HOURS, $SENDING_RESPONSE_HOURS,
  268. $orderPackage
  269. ) {
  270. $conclusion = 0;
  271. $conclusion |= !empty($data['transfer_status']) ? $IS_ROUTED : 0;
  272. $conclusion |= ($delivered_duration > $VALID_HOURS) ? $IS_IN_VALID_TIME : 0;
  273. $conclusion |= ($orderPackage->weighed_at) ? $IS_WEIGHED : 0;
  274. $conclusion |= ($data['status'] == '已收件') ? $IS_RECEIVED : 0;
  275. $conclusion |= ($data['status'] == '派送中') ? $IS_SENDING : 0;//
  276. $conclusion |= ($last_routed_duration > $SHORT_RESPONSE_HOURS && $last_routed_duration < $LONG_RESPONSE_HOURS) ? $IS_SHORT_NO_RESPONSE : 0;
  277. $conclusion |= ($last_routed_duration > $LONG_RESPONSE_HOURS) ? $IS_LONG_NO_RESPONSE : 0;
  278. $conclusion |= ($last_routed_duration > $SENDING_RESPONSE_HOURS && $data['status'] == '派送中') ? $IS_SENDING_NO_RESPONSE : 0;
  279. return $conclusion;
  280. })();
  281. switch ($conclusion) {
  282. case $IS_IN_VALID_TIME:
  283. $data['exception_type'] = '疑似库内丢件';
  284. break;
  285. case $IS_IN_VALID_TIME | $IS_WEIGHED:
  286. $data['exception_type'] = '揽件异常';
  287. break;
  288. case $IS_ROUTED | $IS_SHORT_NO_RESPONSE:
  289. $data['exception_type'] = '中转异常';
  290. break;
  291. case $IS_ROUTED | $IS_LONG_NO_RESPONSE:
  292. $data['exception_type'] = '疑似丢件';
  293. break;
  294. default:
  295. break;
  296. }
  297. switch ($conclusion) {
  298. case $IS_IN_VALID_TIME:
  299. case $IS_IN_VALID_TIME | $IS_WEIGHED:
  300. case $IS_ROUTED | $IS_SHORT_NO_RESPONSE:
  301. case $IS_LONG_NO_RESPONSE:
  302. $data['exception'] = '是';
  303. break;
  304. default:
  305. break;
  306. }
  307. return $data;
  308. }
  309. }