You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

172 lines
6.6 KiB

package common.ecommerce.yqn.adapter;
import common.ecommerce.yqn.dto.YqnTrackingDtos;
import common.ecommerce.warehouse.model.TrackEvent;
import common.ecommerce.warehouse.model.TrackingInfo;
import java.time.Instant;
import java.time.LocalDateTime;
import java.time.ZoneId;
import java.time.ZoneOffset;
import java.time.format.DateTimeFormatter;
import java.time.format.DateTimeParseException;
import java.util.ArrayList;
import java.util.List;
/**
* 运去哪物流轨迹映射(API 189)。
*
* <p>状态值一律保持运去哪原话,不做归一:承运商的节点状态词汇差异大,
* 「派送失败 / 退回中」这类区分归一会丢信息。</p>
*/
public final class YqnTrackingMapper {
/** 仓方给的节点时间没带时区,按目的地习惯优先解析;解析不出再看其它格式。 */
private static final DateTimeFormatter[] DATETIME_FORMATS = {
DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"),
DateTimeFormatter.ISO_LOCAL_DATE_TIME,
};
private YqnTrackingMapper() {
}
/** 响应 → 运单级轨迹。 */
public static TrackingInfo toTrackingInfo(YqnTrackingDtos.ShipmentTrack track, String requestedTrackingNo,
ZoneId zone) {
String trackingNo = hasText(track.trackingCode) ? track.trackingCode.trim() : requestedTrackingNo;
YqnTrackingDtos.ShipmentTrack.CarrierDetail carrierDetail = track.carrierDetail;
TrackingInfo.Builder builder = TrackingInfo.builder()
.trackingNumber(trackingNo)
.carrier(track.carrier)
.carrierService(carrierDetail == null ? null : carrierDetail.service)
.status(track.status)
.statusDetail(track.statusDetail)
.estimatedDeliveryAt(parseTime(track.estDeliveryDate, zone))
.signedBy(track.signedBy)
feat(yqn): 批量补齐「仓方有、模型没有」的字段 按「仓方给了就加,并标注来源字段」补齐四类: 1. 创建入库计划(API 97)请求侧 11 个字段,之前完全没下发: lineCode / shipmentId / referenceId / attachInfoItems / transportType / deliveryType / goodsSize / tmsNos / carrier / socFlag / palletFlag。 其中 attachInfoItems 意味着之前入库单无法随单传附件(面单/装箱单/BOL)。 tmsNos 运去哪是逗号分割的字符串,出参用 List 承接。 2. 查询入库计划(API 101)响应侧 10 个字段: lineName / shipmentId / referenceId / shipmentNo / goodsType / actualShipDate / cartonTotalWeight / cartonTotalVolume / 四种柜型数量与柜号。 柜型新增 InboundOrder.ContainerInfo(GP20/GP40/HQ40/HQ45 + 数量 + 柜号 + 仓方原值),只对给了值的柜型产对象。 3. 商品(API 115)11 个字段: expirationControl / expirationDate / packedQty / packedLength/Width/Height/ Weight / isInsuranceFlag / isInsuranceRate / snMgmtMode / lotControl。 顺带修海关币种:之前把申报额无脑贴成 USD,非美元会被静默算错; 现在非 USD 直接拒绝,由调用方换算。 4. 物流轨迹(API 189): parcel 实重实尺(oz/inch 统一换算成 g/cm 后落模型,宿主不用各仓换算) + carrierDetail 的承诺送达日期 / 始发地 / 目的地。 另把 WarehouseReturn.Attachment 合并为通用 WarehouseAttachment, 与出库/入库附件统一。 新增 YqnExtraFieldsTest(9 个)。全量 486 个测试通过。 Co-Authored-By: Claude <noreply@anthropic.com>
1 week ago
.publicUrl(track.publicUrl)
.guaranteedDeliveryDate(carrierDetail == null ? null
: carrierDetail.guaranteedDeliveryDate)
.originLocation(carrierDetail == null ? null : carrierDetail.originLocation)
.destinationLocation(carrierDetail == null ? null : carrierDetail.destinationLocation);
addParcel(builder, track.parcel);
List<YqnTrackingDtos.ShipmentTrack.TrackDetail> details = track.trackingDetails;
if (details != null) {
for (YqnTrackingDtos.ShipmentTrack.TrackDetail detail : details) {
builder.event(toTrackEvent(detail, trackingNo, track.carrier, zone));
}
}
return builder.build();
}
feat(yqn): 批量补齐「仓方有、模型没有」的字段 按「仓方给了就加,并标注来源字段」补齐四类: 1. 创建入库计划(API 97)请求侧 11 个字段,之前完全没下发: lineCode / shipmentId / referenceId / attachInfoItems / transportType / deliveryType / goodsSize / tmsNos / carrier / socFlag / palletFlag。 其中 attachInfoItems 意味着之前入库单无法随单传附件(面单/装箱单/BOL)。 tmsNos 运去哪是逗号分割的字符串,出参用 List 承接。 2. 查询入库计划(API 101)响应侧 10 个字段: lineName / shipmentId / referenceId / shipmentNo / goodsType / actualShipDate / cartonTotalWeight / cartonTotalVolume / 四种柜型数量与柜号。 柜型新增 InboundOrder.ContainerInfo(GP20/GP40/HQ40/HQ45 + 数量 + 柜号 + 仓方原值),只对给了值的柜型产对象。 3. 商品(API 115)11 个字段: expirationControl / expirationDate / packedQty / packedLength/Width/Height/ Weight / isInsuranceFlag / isInsuranceRate / snMgmtMode / lotControl。 顺带修海关币种:之前把申报额无脑贴成 USD,非美元会被静默算错; 现在非 USD 直接拒绝,由调用方换算。 4. 物流轨迹(API 189): parcel 实重实尺(oz/inch 统一换算成 g/cm 后落模型,宿主不用各仓换算) + carrierDetail 的承诺送达日期 / 始发地 / 目的地。 另把 WarehouseReturn.Attachment 合并为通用 WarehouseAttachment, 与出库/入库附件统一。 新增 YqnExtraFieldsTest(9 个)。全量 486 个测试通过。 Co-Authored-By: Claude <noreply@anthropic.com>
1 week ago
/**
* 包裹实重实尺:运去哪固定给 oz / inch,统一换算成 g / cm 后再落模型,
* 避免宿主拿到不同仓的包裹尺寸还要各自换算。
*/
private static void addParcel(TrackingInfo.Builder builder,
YqnTrackingDtos.ShipmentTrack.Parcel parcel) {
if (parcel == null) {
return;
}
builder.parcelWeightGrams(ouncesToGrams(parcel.weight))
.parcelLengthCm(inchesToCm(parcel.length))
.parcelWidthCm(inchesToCm(parcel.width))
.parcelHeightCm(inchesToCm(parcel.height));
}
private static Double ouncesToGrams(Double ounces) {
return ounces == null ? null : ounces * 28.349523125;
}
private static Double inchesToCm(Double inches) {
return inches == null ? null : inches * 2.54;
}
/** 只取节点明细。 */
public static List<TrackEvent> toTrackEvents(YqnTrackingDtos.ShipmentTrack track, String requestedTrackingNo,
ZoneId zone) {
return toTrackingInfo(track, requestedTrackingNo, zone).events();
}
private static TrackEvent toTrackEvent(YqnTrackingDtos.ShipmentTrack.TrackDetail detail, String trackingNo,
String carrier, ZoneId zone) {
return TrackEvent.builder()
.trackingNumber(trackingNo)
.carrier(carrier)
.status(detail.status)
.description(hasText(detail.message) ? detail.message : detail.statusDetail)
.location(locationOf(detail.trackingLocation))
.occurredAt(parseTime(detail.datetime, zone))
.build();
}
/** 位置拼成一行,如 {@code New York, NY, US, 10001};全空返回 null。 */
private static String locationOf(YqnTrackingDtos.ShipmentTrack.TrackingLocation loc) {
if (loc == null) {
return null;
}
List<String> parts = new ArrayList<String>(4);
addIfText(parts, loc.city);
addIfText(parts, loc.state);
addIfText(parts, loc.country);
addIfText(parts, loc.zip);
return parts.isEmpty() ? null : join(parts);
}
private static void addIfText(List<String> parts, String v) {
if (hasText(v)) {
parts.add(v.trim());
}
}
private static String join(List<String> parts) {
StringBuilder sb = new StringBuilder();
for (int i = 0; i < parts.size(); i++) {
if (i > 0) {
sb.append(", ");
}
sb.append(parts.get(i));
}
return sb.toString();
}
/**
* 解析仓方时间;失败返回 null,不因时间格式阻断轨迹展示。
*
* <p>文档未给出 {@code datetime} 的格式,因此按「带时区 ISO → 常见本地格式」依次尝试;
* 都不带时区时按调用方给的 {@code zone} 解释。</p>
*/
static Instant parseTime(String value, ZoneId zone) {
if (!hasText(value)) {
return null;
}
String v = value.trim();
try {
return Instant.parse(v);
} catch (DateTimeParseException ignored) {
// 试本地格式
}
try {
return java.time.OffsetDateTime.parse(v).toInstant();
} catch (DateTimeParseException ignored) {
// 试本地格式
}
for (DateTimeFormatter fmt : DATETIME_FORMATS) {
try {
return LocalDateTime.parse(v, fmt).atZone(zone == null ? ZoneOffset.UTC : zone).toInstant();
} catch (DateTimeParseException ignored) {
// 下一个格式
}
}
try {
return java.time.LocalDate.parse(v).atStartOfDay(zone == null ? ZoneOffset.UTC : zone).toInstant();
} catch (DateTimeParseException ignored) {
return null;
}
}
private static boolean hasText(String v) {
return v != null && !v.trim().isEmpty();
}
}