LogisticSFService.php 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336
  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. if (!array_key_exists('exception', $data)) {//当顺丰返回异常时,不需要再根据时间判断是否异常,直接用顺丰的异常就好
  94. $data = $this->setExceptionType($data, $lastRoute['accept_time']);
  95. }
  96. } catch (Exception $e) {
  97. throw new WarningException("单号没有查询到快递路由信息','LogisticSFService->transformSFOneToArr->{$data['logistic_number']}");
  98. } finally {
  99. return $data;
  100. }
  101. }
  102. /**
  103. * 转换快递路由信息
  104. * @param array $routs 快递路由
  105. * @return array
  106. */
  107. public function transformRoutes(array $routs): array
  108. {
  109. $result = [];
  110. foreach ($routs as $route) {
  111. $route = get_object_vars($route)['@attributes'];
  112. $data['accept_time'] = $route['accept_time'];
  113. $data['accept_address'] = $route['accept_address'];
  114. $data['remark'] = $route['remark'];
  115. $result[] = $data;
  116. }
  117. return $result;
  118. }
  119. /**
  120. * 将最新路由信息转换为数组
  121. * @param array $lastRoute
  122. * @param array $data
  123. * @return array
  124. * @throws Exception
  125. */
  126. public function switchOpCodeToStatus(array $lastRoute, array $data): array
  127. {
  128. try {
  129. switch ($lastRoute['opcode']) {
  130. case 123:
  131. case 130:
  132. case 3036:
  133. case 31:
  134. case 30:
  135. case 36:
  136. $data['status'] = '在途';
  137. break;
  138. case 70:
  139. case 33:
  140. $data['status'] = '派送异常';
  141. $data['exception_type'] = '派件异常';
  142. $data['exception'] = '是';
  143. break;
  144. case 204:
  145. case 44:
  146. $data['status'] = '派送中';
  147. break;
  148. case 50:
  149. $data['status'] = '已揽收';
  150. break;
  151. case 607:
  152. case 8000:
  153. case 80:
  154. $data['status'] = '已收件';
  155. $data['received_at'] = $lastRoute[$this->protected_switch['received_at']];
  156. break;
  157. case 648:
  158. case 99:
  159. $data['status'] = '返回中';
  160. break;
  161. default:
  162. throw new WarningException("未知的丰桥状态码: {$lastRoute['opcode']}->{json_encode($lastRoute)}");
  163. }
  164. } catch (WarningException $e) {
  165. $data['status'] = '其他异常';
  166. } finally {
  167. return $data;
  168. }
  169. }
  170. /**
  171. * @param string $head
  172. * @param string $numbers
  173. * @param string $checkWord
  174. * @param string $url
  175. * @return Response
  176. * @throws Exception
  177. */
  178. public function sendHttpToSF(string $head, string $numbers, string $checkWord, string $url): Response
  179. {
  180. $xml = $this->buildXmlStr($head, $numbers);
  181. $checkingJson = $xml . $checkWord;
  182. $verifyCode = base64_encode(md5($checkingJson, true));
  183. try {
  184. $response = Http::withHeaders(['Content-Type' => 'text/xml'])->get($url, ['xml' => $xml, 'verifyCode' => $verifyCode]);
  185. } catch (Exception $e) {
  186. throw new WarningException("HTTP请求顺丰接口异常->{$e->getMessage()}");
  187. }
  188. return $response;
  189. }
  190. /**
  191. * 将多个顺丰的单号转换为数组
  192. * @param array $responseBody
  193. * @param array $result
  194. * @return array
  195. * @throws Exception
  196. */
  197. public function transformSFMoreToArr(array $responseBody, array $result): array
  198. {
  199. foreach ($responseBody as $routeResponse) {
  200. $result[] = $this->transformSFOneToArr(get_object_vars($routeResponse), []);
  201. }
  202. return $result;
  203. }
  204. /**
  205. * @param array $data
  206. * @param $lastRouteDate
  207. * @return array
  208. */
  209. private function setExceptionType(array $data, $lastRouteDate = null): array
  210. {
  211. $logistic_number = $data['logistic_number'];
  212. /** @var OrderPackage $orderPackage */
  213. $orderPackage = OrderPackage::query()->with('order')->where('logistic_number', $logistic_number)->first();
  214. $delivered_duration = now()->diffInHours(Carbon::parse($orderPackage['sent_at']));
  215. $last_routed_duration = now()->diffInHours(Carbon::parse($lastRouteDate));
  216. $VALID_HOURS = 4;
  217. $SHORT_RESPONSE_HOURS = 24;
  218. $LONG_RESPONSE_HOURS = (function ($province) {
  219. switch ($province) {
  220. case '浙江省':
  221. case '江苏省':
  222. case '上海':
  223. case '安徽省':
  224. return 72;
  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. case '吉林省':
  244. case '黑龙江省':
  245. case '辽宁省':
  246. return 120;
  247. case '青海省':
  248. case '宁夏回族自治区':
  249. case '甘肃省':
  250. case '内蒙古自治区':
  251. case '新疆维吾尔自治区':
  252. case '西藏自治区':
  253. return 168;
  254. default:
  255. break;
  256. }
  257. })($orderPackage->order->province);
  258. $SENDING_RESPONSE_HOURS = 48;
  259. $IS_ROUTED = 1; //0000 0001 有路由信息
  260. $IS_IN_VALID_TIME = 2; //0000 0010 大于4小时
  261. $IS_WEIGHED = 4; //0000 0100 称重过
  262. $IS_RECEIVED = 8; //0000 1000 已经收货
  263. $IS_SENDING = 16; //0001 0000 正在派送
  264. $IS_SHORT_NO_RESPONSE = 32; //0010 0000 中转异常
  265. $IS_LONG_NO_RESPONSE = 64; //0010 0000 疑似丢件
  266. $IS_SENDING_NO_RESPONSE = 128; //0010 0000 派送异常
  267. $conclusion = (function () use (
  268. $data, $delivered_duration, $last_routed_duration,
  269. $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,
  270. $SHORT_RESPONSE_HOURS, $LONG_RESPONSE_HOURS, $SENDING_RESPONSE_HOURS,
  271. $orderPackage
  272. ) {
  273. $conclusion = 0;
  274. $conclusion |= !empty($data['transfer_status']) ? $IS_ROUTED : 0;
  275. $conclusion |= ($delivered_duration > $VALID_HOURS) ? $IS_IN_VALID_TIME : 0;
  276. $conclusion |= ($orderPackage->weighed_at) ? $IS_WEIGHED : 0;
  277. $conclusion |= ($data['status'] == '已收件') ? $IS_RECEIVED : 0;
  278. $conclusion |= ($data['status'] == '派送中') ? $IS_SENDING : 0;//
  279. $conclusion |= ($last_routed_duration > $SHORT_RESPONSE_HOURS && $last_routed_duration < $LONG_RESPONSE_HOURS) ? $IS_SHORT_NO_RESPONSE : 0;
  280. $conclusion |= ($last_routed_duration > $LONG_RESPONSE_HOURS) ? $IS_LONG_NO_RESPONSE : 0;
  281. $conclusion |= ($last_routed_duration > $SENDING_RESPONSE_HOURS && $data['status'] == '派送中') ? $IS_SENDING_NO_RESPONSE : 0;
  282. return $conclusion;
  283. })();
  284. switch ($conclusion) {
  285. case $IS_IN_VALID_TIME:
  286. $data['exception_type'] = '疑似库内丢件';
  287. break;
  288. case $IS_IN_VALID_TIME | $IS_WEIGHED:
  289. $data['exception_type'] = '揽件异常';
  290. break;
  291. case $IS_ROUTED | $IS_IN_VALID_TIME | $IS_SHORT_NO_RESPONSE:
  292. case $IS_ROUTED | $IS_IN_VALID_TIME | $IS_SHORT_NO_RESPONSE | $IS_WEIGHED:
  293. $data['exception_type'] = '中转异常';
  294. break;
  295. case $IS_ROUTED | $IS_IN_VALID_TIME | $IS_LONG_NO_RESPONSE:
  296. case $IS_ROUTED | $IS_IN_VALID_TIME | $IS_LONG_NO_RESPONSE | $IS_WEIGHED:
  297. $data['exception_type'] = '疑似丢件';
  298. break;
  299. default:
  300. break;
  301. }
  302. if($conclusion
  303. ==($conclusion | $IS_ROUTED | $IS_IN_VALID_TIME | $IS_SENDING | $IS_SENDING_NO_RESPONSE)){
  304. $data['exception_type'] = '派件异常';
  305. }
  306. switch ($conclusion) {
  307. case $IS_IN_VALID_TIME:
  308. case $IS_IN_VALID_TIME | $IS_WEIGHED:
  309. case $IS_ROUTED | $IS_SHORT_NO_RESPONSE:
  310. case $IS_LONG_NO_RESPONSE:
  311. $data['exception'] = '是';
  312. break;
  313. default:
  314. break;
  315. }
  316. return $data;
  317. }
  318. }