| | | 1 | | using OzonDomains.Models; |
| | | 2 | | using Services.ApiServices.OzonApi; |
| | | 3 | | using Services.ApiServices.OzonApi.Filters; |
| | | 4 | | using Services.LabelServices; |
| | | 5 | | using Services.ParserServices; |
| | | 6 | | using Services.ParserServices.HelpDictEnum; |
| | | 7 | | |
| | | 8 | | namespace Services.LabelServices; |
| | | 9 | | |
| | | 10 | | public interface IOrdersOzonShipService |
| | | 11 | | { |
| | | 12 | | /// <summary> |
| | | 13 | | /// Устанавливает Client-Id/Api-Key Ozon для последующих вызовов этого сервиса. Обязательно |
| | | 14 | | /// вызывать перед <see cref="ProcessOrderStatusAsync"/>/<see cref="RecordFailedShipmentAsync"/> — |
| | | 15 | | /// у сервиса свой собственный (DI, transient) <c>OzonJsonDataBuilder</c>, не связанный с |
| | | 16 | | /// экземпляром вызывающего кода, поэтому его клиент нужно выставлять явно здесь же. |
| | | 17 | | /// </summary> |
| | | 18 | | void SetClient(string clientId, string apiKey); |
| | | 19 | | |
| | | 20 | | Task<string> ProcessOrderStatusAsync( |
| | | 21 | | Order order, |
| | | 22 | | string? splitOption, |
| | | 23 | | string? ozonPostingOverride = null, |
| | | 24 | | int? forcedPackageCount = null); |
| | | 25 | | |
| | | 26 | | /// <summary> |
| | | 27 | | /// То же, что <see cref="ProcessOrderStatusAsync"/>, но со статусом Ozon, уже полученным |
| | | 28 | | /// вызывающим кодом (например батч-запросом на всю пачку заказов) — экономит по одному |
| | | 29 | | /// последовательному запросу статуса на заказ. |
| | | 30 | | /// </summary> |
| | | 31 | | Task<string> ProcessOrderStatusWithKnownStatusAsync( |
| | | 32 | | Order order, |
| | | 33 | | string? splitOption, |
| | | 34 | | string orderStatus, |
| | | 35 | | string? ozonPostingOverride = null, |
| | | 36 | | int? forcedPackageCount = null); |
| | | 37 | | |
| | | 38 | | Task RecordFailedShipmentAsync( |
| | | 39 | | Order order, |
| | | 40 | | Exception ex, |
| | | 41 | | IList<string> failedShipments, |
| | | 42 | | CancellationToken cancellationToken = default); |
| | | 43 | | } |
| | | 44 | | |
| | | 45 | | /// <summary> |
| | | 46 | | /// Отгрузка FBS-постингов Ozon и обновление статуса (логика бывшего ProcessAndUpdateOrderStatus). |
| | | 47 | | /// </summary> |
| | | 48 | | public sealed class OrdersOzonShipService : IOrdersOzonShipService |
| | | 49 | | { |
| | | 50 | | private readonly OzonJsonDataBuilder _jsonDataBuilder; |
| | | 51 | | private OzonApiDataManager _ozonApiDataManager; |
| | | 52 | | |
| | 4 | 53 | | public OrdersOzonShipService(OzonJsonDataBuilder jsonDataBuilder, OzonApiDataManager ozonApiDataManager) |
| | | 54 | | { |
| | 4 | 55 | | _jsonDataBuilder = jsonDataBuilder; |
| | 4 | 56 | | _ozonApiDataManager = ozonApiDataManager; |
| | 4 | 57 | | } |
| | | 58 | | |
| | | 59 | | public void SetClient(string clientId, string apiKey) |
| | | 60 | | { |
| | 0 | 61 | | _jsonDataBuilder.SetClient(clientId, apiKey); |
| | 0 | 62 | | _ozonApiDataManager = _ozonApiDataManager.SetClient(clientId, apiKey); |
| | 0 | 63 | | } |
| | | 64 | | |
| | | 65 | | public async Task<string> ProcessOrderStatusAsync( |
| | | 66 | | Order order, |
| | | 67 | | string? splitOption, |
| | | 68 | | string? ozonPostingOverride = null, |
| | | 69 | | int? forcedPackageCount = null) |
| | | 70 | | { |
| | 0 | 71 | | var ozonPostingNumber = ozonPostingOverride |
| | 0 | 72 | | ?? OzonPostingNumberHelper.GetOzonApiPostingNumber(order.ShipmentNumber); |
| | | 73 | | |
| | 0 | 74 | | string orderStatus = await _jsonDataBuilder.GetProductSatatus(ozonPostingNumber); |
| | | 75 | | |
| | 0 | 76 | | return await ProcessOrderStatusWithKnownStatusAsync( |
| | 0 | 77 | | order, splitOption, orderStatus, ozonPostingOverride, forcedPackageCount); |
| | 0 | 78 | | } |
| | | 79 | | |
| | | 80 | | public async Task<string> ProcessOrderStatusWithKnownStatusAsync( |
| | | 81 | | Order order, |
| | | 82 | | string? splitOption, |
| | | 83 | | string orderStatus, |
| | | 84 | | string? ozonPostingOverride = null, |
| | | 85 | | int? forcedPackageCount = null) |
| | | 86 | | { |
| | 4 | 87 | | var ozonPostingNumber = ozonPostingOverride |
| | 4 | 88 | | ?? OzonPostingNumberHelper.GetOzonApiPostingNumber(order.ShipmentNumber); |
| | | 89 | | |
| | 4 | 90 | | if (orderStatus != "awaiting_deliver" && |
| | 4 | 91 | | !string.IsNullOrEmpty(order.ShipmentNumber) |
| | 4 | 92 | | && order.ProductInfo != null |
| | 4 | 93 | | && !string.IsNullOrEmpty(order.ProductInfo.OzonProductId) |
| | 4 | 94 | | && order.Quantity.HasValue |
| | 4 | 95 | | && order.Quantity.Value > 0) |
| | | 96 | | { |
| | 3 | 97 | | if (orderStatus == "not_accepted") |
| | | 98 | | { |
| | 0 | 99 | | var toAwaitingDeliver = await _jsonDataBuilder.SetAwaitingDelivery([ozonPostingNumber]); |
| | 0 | 100 | | return toAwaitingDeliver.Result |
| | 0 | 101 | | ? "Спорный заказ передан к отгрузке." |
| | 0 | 102 | | : "Не удалось передать спорный заказ к отгркзке."; |
| | | 103 | | } |
| | | 104 | | |
| | | 105 | | // Проверяем ДО ветки "past shipping": cancelled/delivered блокируют печать/отгрузку, |
| | | 106 | | // но cancelled не входит в IsOzonStatusPastShipping (delivering/driver_pickup/sent_by_seller/delivered) — |
| | | 107 | | // без этой проверки код лез бы дальше пытаться отгрузить уже отменённый на Ozon заказ |
| | | 108 | | // и получал в ответ невнятную ошибку от Ozon вместо понятного статуса. |
| | 3 | 109 | | if (OzonLabelStatusHelper.IsOzonStatusLabelGenerationBlocked(orderStatus)) |
| | | 110 | | { |
| | 2 | 111 | | var blockedStatusName = OzonLabelStatusHelper.GetOzonStatusDisplayName(orderStatus); |
| | 2 | 112 | | return |
| | 2 | 113 | | $"Статус Ozon: {blockedStatusName} — печать этикетки и отгрузка через Ozon API недоступны."; |
| | | 114 | | } |
| | | 115 | | |
| | 1 | 116 | | if (OzonLabelStatusHelper.IsOzonStatusPastShipping(orderStatus)) |
| | | 117 | | { |
| | 1 | 118 | | var statusName = OzonLabelStatusHelper.GetOzonStatusDisplayName(orderStatus); |
| | 1 | 119 | | return $"Статус Ozon: {statusName} — повторная отгрузка не требуется."; |
| | | 120 | | } |
| | | 121 | | |
| | 0 | 122 | | var packages = await BuildShipPackagesAsync(order, splitOption, ozonPostingNumber, forcedPackageCount); |
| | | 123 | | |
| | 0 | 124 | | await _jsonDataBuilder.ShipFbsPosting(ozonPostingNumber, packages, withAdditionalData: true); |
| | | 125 | | |
| | 0 | 126 | | string newStatus = await WaitForShipSubStatusAsync(ozonPostingNumber); |
| | 0 | 127 | | if (newStatus == "ship_failed") |
| | | 128 | | { |
| | 0 | 129 | | await _jsonDataBuilder.ShipFbsPosting(ozonPostingNumber, packages, withAdditionalData: true); |
| | 0 | 130 | | newStatus = await WaitForShipSubStatusAsync(ozonPostingNumber); |
| | | 131 | | } |
| | | 132 | | |
| | 0 | 133 | | string msg = OzonStatus.GetSubStatus(newStatus) + '.'; |
| | 0 | 134 | | if (newStatus == "posting_registered") |
| | | 135 | | { |
| | 0 | 136 | | msg += |
| | 0 | 137 | | " Мы регистрируем ваше отправление в сервисе доставки партнера Озон, это может занять до 30 минут. " |
| | 0 | 138 | | "Как только регистрация закончится, вы увидите трек-номер и сможете передать отправление в отгрузку" |
| | | 139 | | } |
| | | 140 | | |
| | 0 | 141 | | return msg; |
| | | 142 | | } |
| | | 143 | | |
| | 1 | 144 | | return "Статус заказа не требует обновления"; |
| | 4 | 145 | | } |
| | | 146 | | |
| | | 147 | | /// <summary> |
| | | 148 | | /// Отправление с несколькими разными товарами отгружается целиком: в packages должны быть |
| | | 149 | | /// все SKU отправления, иначе Ozon отвечает HAS_INCORRECT_PRODUCT_QUANTITY. Отправление |
| | | 150 | | /// с одним SKU — прежняя логика (количество из Ozon, разбиение по коробкам по splitOption). |
| | | 151 | | /// </summary> |
| | | 152 | | private async Task<List<FbsShipPackage>> BuildShipPackagesAsync( |
| | | 153 | | Order order, |
| | | 154 | | string? splitOption, |
| | | 155 | | string ozonPostingNumber, |
| | | 156 | | int? forcedPackageCount) |
| | | 157 | | { |
| | 0 | 158 | | var postingProducts = await _ozonApiDataManager.GetPostingShipProductsAsync(ozonPostingNumber); |
| | 0 | 159 | | if (postingProducts.Count > 1) |
| | | 160 | | { |
| | 0 | 161 | | var packagePerUnit = forcedPackageCount is > 0 || !string.IsNullOrEmpty(splitOption); |
| | 0 | 162 | | return OzonFbsShipPackageBuilder.Build(postingProducts, packagePerUnit); |
| | | 163 | | } |
| | | 164 | | |
| | 0 | 165 | | string realProductId = await _jsonDataBuilder.GetProductId(ozonPostingNumber); |
| | 0 | 166 | | if (!long.TryParse(realProductId, out var realProductIdValue) || realProductIdValue <= 0) |
| | | 167 | | { |
| | 0 | 168 | | throw new InvalidOperationException( |
| | 0 | 169 | | $"Не удалось определить product_id для отправления {ozonPostingNumber}."); |
| | | 170 | | } |
| | | 171 | | |
| | 0 | 172 | | var effectiveSplitOption = splitOption; |
| | 0 | 173 | | var shipQuantity = order.Quantity.GetValueOrDefault(); |
| | 0 | 174 | | if (forcedPackageCount is > 0) |
| | | 175 | | { |
| | 0 | 176 | | effectiveSplitOption = null; |
| | 0 | 177 | | shipQuantity = forcedPackageCount.Value; |
| | | 178 | | } |
| | 0 | 179 | | else if (OzonPostingNumberHelper.IsSplitChildPosting(order.ShipmentNumber) && |
| | 0 | 180 | | OzonPostingNumberHelper.IsStudioLocalSplitPosting(order.ShipmentNumber)) |
| | | 181 | | { |
| | 0 | 182 | | effectiveSplitOption = null; |
| | 0 | 183 | | shipQuantity = 1; |
| | | 184 | | } |
| | 0 | 185 | | else if (OzonPostingNumberHelper.IsSplitChildPosting(order.ShipmentNumber)) |
| | | 186 | | { |
| | 0 | 187 | | effectiveSplitOption = null; |
| | 0 | 188 | | shipQuantity = 1; |
| | | 189 | | } |
| | | 190 | | |
| | 0 | 191 | | var ozonShipQuantity = |
| | 0 | 192 | | await _ozonApiDataManager.GetPostingProductQuantityAsync(ozonPostingNumber, realProductIdValue); |
| | 0 | 193 | | if (ozonShipQuantity > 0 && shipQuantity != ozonShipQuantity) |
| | | 194 | | { |
| | 0 | 195 | | shipQuantity = ozonShipQuantity; |
| | | 196 | | } |
| | | 197 | | |
| | 0 | 198 | | List<FbsShipPackage> packages = new(); |
| | | 199 | | |
| | 0 | 200 | | if (forcedPackageCount is > 0 || (!string.IsNullOrEmpty(effectiveSplitOption) && shipQuantity > 1)) |
| | | 201 | | { |
| | 0 | 202 | | for (int i = 0; i < shipQuantity; i++) |
| | | 203 | | { |
| | 0 | 204 | | packages.Add(new FbsShipPackage |
| | 0 | 205 | | { |
| | 0 | 206 | | Products = new List<FbsShipProduct> |
| | 0 | 207 | | { |
| | 0 | 208 | | new() |
| | 0 | 209 | | { |
| | 0 | 210 | | ProductId = realProductIdValue, |
| | 0 | 211 | | Quantity = 1 |
| | 0 | 212 | | } |
| | 0 | 213 | | } |
| | 0 | 214 | | }); |
| | | 215 | | } |
| | | 216 | | } |
| | | 217 | | else |
| | | 218 | | { |
| | 0 | 219 | | packages.Add(new FbsShipPackage |
| | 0 | 220 | | { |
| | 0 | 221 | | Products = new List<FbsShipProduct> |
| | 0 | 222 | | { |
| | 0 | 223 | | new() |
| | 0 | 224 | | { |
| | 0 | 225 | | ProductId = realProductIdValue, |
| | 0 | 226 | | Quantity = shipQuantity |
| | 0 | 227 | | } |
| | 0 | 228 | | } |
| | 0 | 229 | | }); |
| | | 230 | | } |
| | | 231 | | |
| | 0 | 232 | | return packages; |
| | 0 | 233 | | } |
| | | 234 | | |
| | | 235 | | private const int ShipSubStatusPollAttempts = 8; |
| | 0 | 236 | | private static readonly TimeSpan ShipSubStatusPollDelay = TimeSpan.FromMilliseconds(250); |
| | | 237 | | |
| | | 238 | | /// <summary> |
| | | 239 | | /// Ozon применяет результат отгрузки не мгновенно: сразу после /v4/posting/fbs/ship подстатус |
| | | 240 | | /// какое-то время остаётся ship_pending (или ответ пустой). Вместо фиксированной паузы в 2 с |
| | | 241 | | /// опрашиваем подстатус короткими интервалами и выходим сразу, как только он определился. |
| | | 242 | | /// </summary> |
| | | 243 | | private async Task<string> WaitForShipSubStatusAsync(string ozonPostingNumber) |
| | | 244 | | { |
| | 0 | 245 | | var status = string.Empty; |
| | 0 | 246 | | for (var attempt = 0; attempt < ShipSubStatusPollAttempts; attempt++) |
| | | 247 | | { |
| | 0 | 248 | | if (attempt > 0) |
| | | 249 | | { |
| | 0 | 250 | | await Task.Delay(ShipSubStatusPollDelay); |
| | | 251 | | } |
| | | 252 | | |
| | 0 | 253 | | status = await _jsonDataBuilder.GetProductSubSatatus(ozonPostingNumber); |
| | 0 | 254 | | if (!string.IsNullOrEmpty(status) && status != "ship_pending") |
| | | 255 | | { |
| | 0 | 256 | | return status; |
| | | 257 | | } |
| | | 258 | | } |
| | | 259 | | |
| | 0 | 260 | | return status; |
| | 0 | 261 | | } |
| | | 262 | | |
| | | 263 | | public async Task RecordFailedShipmentAsync( |
| | | 264 | | Order order, |
| | | 265 | | Exception ex, |
| | | 266 | | IList<string> failedShipments, |
| | | 267 | | CancellationToken cancellationToken = default) |
| | | 268 | | { |
| | | 269 | | _ = cancellationToken; |
| | 0 | 270 | | string? ozonStatusName = null; |
| | 0 | 271 | | if (OzonLabelPrintErrorHelper.NeedsCurrentOzonStatus(ex.Message)) |
| | | 272 | | { |
| | | 273 | | try |
| | | 274 | | { |
| | 0 | 275 | | var currentStatus = await _jsonDataBuilder.GetProductSatatus( |
| | 0 | 276 | | OzonPostingNumberHelper.GetOzonApiPostingNumber(order.ShipmentNumber)); |
| | 0 | 277 | | ozonStatusName = OzonLabelStatusHelper.GetOzonStatusDisplayName(currentStatus); |
| | 0 | 278 | | } |
| | 0 | 279 | | catch |
| | | 280 | | { |
| | | 281 | | // статус для подсказки не критичен |
| | 0 | 282 | | } |
| | | 283 | | } |
| | | 284 | | |
| | 0 | 285 | | failedShipments.Add( |
| | 0 | 286 | | OzonLabelPrintErrorHelper.FormatShipmentError( |
| | 0 | 287 | | order.ShipmentNumber ?? string.Empty, |
| | 0 | 288 | | ex.Message, |
| | 0 | 289 | | ozonStatusName)); |
| | 0 | 290 | | } |
| | | 291 | | } |