src/Oms.Application/Dtos/Orders/PickupOrderDtos.cs

@@ -388,6 +388,9 @@ public class PickupOpenApiPushFeeResult
 
 public class PickupOpenApiPushFeeInput
 {
+    /// <summary>
+    /// 承运运单号，对应库字段 CarrierWaybillNo。
+    /// </summary>
     public string? WaybillNumber { get; set; }
 
     public decimal ActualWeight { get; set; }

src/Oms.Application/Services/Orders/PickupOrderFeePushService.cs

@@ -70,10 +70,10 @@ public class PickupOrderFeePushService : IScopedDependency
             throw new BusinessException("请求体不能为空");
         }
 
-        var pickupNo = (input.WaybillNumber ?? string.Empty).Trim();
+        var carrierWaybillNo = (input.WaybillNumber ?? string.Empty).Trim();
-        if (string.IsNullOrWhiteSpace(pickupNo))
+        if (string.IsNullOrWhiteSpace(carrierWaybillNo))
         {
-            throw new BusinessException("waybillNumber 不能为空");
+            throw new BusinessException("waybillNumber（承运运单号 CarrierWaybillNo）不能为空");
         }
 
         if (input.ActualWeight <= 0)
@@ -87,8 +87,8 @@ public class PickupOrderFeePushService : IScopedDependency
             throw new BusinessException("goodsSizeList 不能为空");
         }
 
-        var pickup = await _pickupOrderRepository.GetByPickupNoAsync(pickupNo)
+        var pickup = await _pickupOrderRepository.GetByCarrierWaybillNoAsync(carrierWaybillNo)
-            ?? throw new BusinessException("揽收单不存在");
+            ?? throw new BusinessException($"揽收单不存在：承运运单号 {carrierWaybillNo}");
 
         await EnsureAppKeyAsync(key, pickup);
 

src/Oms.Domain/OrdersAggregate/Repositories/IPickupOrderRepository.cs

@@ -7,6 +7,8 @@ public interface IPickupOrderRepository : IRepository<PickupOrder>
 {
     Task<PickupOrder?> GetByPickupNoAsync(string pickupNo, CancellationToken cancellationToken = default);
 
+    Task<PickupOrder?> GetByCarrierWaybillNoAsync(string carrierWaybillNo, CancellationToken cancellationToken = default);
+
     Task<PickupOrder?> GetOwnedAsync(int id, int customerId, CancellationToken cancellationToken = default);
 
     Task<PickupWorkplaceCountRow> GetWorkplaceCountsAsync(

src/Oms.SqlSugarCore/Orders/PickupOrderRepository.cs

@@ -14,6 +14,12 @@ public class PickupOrderRepository : OmsSqlSugarRepository<PickupOrder>, IPickup
         return FirstOrDefaultAsync(x => x.PickupNo == no, cancellationToken);
     }
 
+    public Task<PickupOrder?> GetByCarrierWaybillNoAsync(string carrierWaybillNo, CancellationToken cancellationToken = default)
+    {
+        var no = carrierWaybillNo.Trim();
+        return FirstOrDefaultAsync(x => x.CarrierWaybillNo == no, cancellationToken);
+    }
+
     public Task<PickupOrder?> GetOwnedAsync(int id, int customerId, CancellationToken cancellationToken = default)
     {
         return FirstOrDefaultAsync(x => x.Id == id && x.CustomerId == customerId, cancellationToken);