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.

73 lines
2.3 KiB

package common.ecommerce.edayun.dto;
import com.fasterxml.jackson.annotation.JsonInclude;
import java.util.List;
/**
* 易达云报文结构:查询订单的物流轨迹
* ({@code POST /webApi/track/getTrackInfoList})。
*
* <p><b>请求体就是一个字符串数组</b>:{@code ["1Z111","1Z222"]},没有包装对象。
* 文档把字段名留空了,示例写成 {@code [{"": ["aa","bb"]}]} 是错的——
* 真机实测只有纯数组能通。</p>
*/
public final class EdayunTrackDtos {
private EdayunTrackDtos() {
}
/** 查询响应。 */
@JsonInclude(JsonInclude.Include.NON_NULL)
public static final class GetTrackResponse {
public Integer code;
public String msg;
public List<Track> data;
public String traceId;
}
/** 一个跟踪号的轨迹。 */
@JsonInclude(JsonInclude.Include.NON_NULL)
public static final class Track {
public Long trackId;
public String trackingNo;
/** 轨迹状态;码表未给。 */
public Integer status;
/** 承运商,如 {@code fedex}。 */
public String carrierName;
/** 始发国。 */
public String startCountryName;
/** 目的国。 */
public String endCountryName;
/** 收件人。 */
public String receiver;
/** 轨迹明细节点。 */
public List<TrackDetail> trackDetaillVoList;
/** 上网时间;<b>字符串</b>,如 {@code 2025-08-19 08:17:00}。 */
public String onlineTime;
/** 妥投时间;字符串,同上。 */
public String deliveredTime;
/** 时区偏移,如 {@code GMT-04:00}——解释上面两个时间要用它。 */
public String timeZone;
}
/** 一个轨迹节点。 */
@JsonInclude(JsonInclude.Include.NON_NULL)
public static final class TrackDetail {
public String trackingNo;
/** 节点状态;码表未给。 */
public Integer status;
/** 节点描述,如「上网」。 */
public String recentDescribe;
/** 节点时间(毫秒)。 */
public Long recentDescribeTime;
/** 创建时间(毫秒)。 */
public Long createTime;
/** 事件状态原值。 */
public String eventStatus;
}
}