package common.ecommerce.edayun.dto; import com.fasterxml.jackson.annotation.JsonInclude; import java.util.List; /** * 易达云报文结构:查询客户自有物流服务(承运商) * ({@code POST /webApi/carrier/v1/listCarrierByWarehouse})。 * *

一个文件对应一个接口。响应是「承运商 → 物流服务」两层: * {@code carrierId / carrierNameEn / carrierNameCn} + 下属 {@code ownLogisticList}。

*/ public final class EdayunCarrierDtos { private EdayunCarrierDtos() { } /** 查询请求。 */ @JsonInclude(JsonInclude.Include.NON_NULL) public static final class ListCarrierRequest { /** 仓库 id;不传则查所有服务商。 */ public Long warehouseId; /** 国家编码,如 {@code US}。 */ public String countryCode; } /** 查询响应。 */ @JsonInclude(JsonInclude.Include.NON_NULL) public static final class ListCarrierResponse { public Integer code; public String msg; public List data; public String traceId; } /** 一个承运商。 */ @JsonInclude(JsonInclude.Include.NON_NULL) public static final class Carrier { /** 承运商 id。 */ public String carrierId; /** 英文名,如 {@code FedEx}。 */ public String carrierNameEn; /** 中文名。 */ public String carrierNameCn; /** * 下属物流服务。 * *

文档写成对象,真机返回数组——按 List 收,避免解析失败。

*/ public List ownLogisticList; } /** 承运商下的一个物流服务。 */ @JsonInclude(JsonInclude.Include.NON_NULL) public static final class OwnLogistic { public String logisticId; public String logisticName; } }