tracker

type AutoNumberResponse struct {
	ComCode   string `json:"comCode"`   // Courier company code
	NoCount   int    `json:"noCount"`   // Match count
	NoPre     string `json:"noPre"`     // Number prefix
	StartTime string `json:"startTime"` // Start time
}

type CourierInfo struct {
	Code string // kuaidi100 API code
	Name string // Chinese name
}

type DeliveryTimeData struct {
	ArriveTime      string `json:"arriveTime"`      // Estimated arrival time
	SortingName     string `json:"sortingName"`     // Sorting center name
	PickupTime      string `json:"pickupTime"`      // Estimated pickup time
	Hour            string `json:"hour"`            // Estimated hours
	Day             string `json:"day"`             // Estimated days
	ExpectTime      string `json:"expectTime"`      // Expected delivery time range
	SecondDayArrive bool   `json:"secondDayArrive"` // Whether arrives next day
}

type DeliveryTimeParam struct {
	Kuaidicom string `json:"kuaidicom"`         // Courier company code
	From      string `json:"from"`              // Origin address (must include 3+ levels, e.g., 广东深圳市南山区)
	To        string `json:"to"`                // Destination address (must include 3+ levels)
	OrderTime string `json:"orderTime"`         // Order time, format: yyyy-MM-dd HH:mm:ss
	ExpType   string `json:"expType,omitempty"` // Product type (e.g., 特惠送, 标快)
}

type DeliveryTimeResponse struct {
	Result     bool              `json:"result"`     // Whether successful
	ReturnCode string            `json:"returnCode"` // Return code
	Message    string            `json:"message"`    // Error message if any
	Data       *DeliveryTimeData `json:"data,omitempty"`
}

type Kuaidi100Config struct {
	Key      string // Authorization key (授权key)
	Customer string // Customer ID (查询公司编号)
	Secret   string // Secret for delivery time API (授权secret)
}

type Kuaidi100Tracker struct {
	// contains filtered or unexported fields
}

type QueryParam struct {
	Com      string `json:"com"`             // Courier company code (e.g., "yuantong", "shunfeng")
	Num      string `json:"num"`             // Tracking number
	Phone    string `json:"phone,omitempty"` // Phone number (required for some couriers like SF)
	From     string `json:"from,omitempty"`  // Origin city
	To       string `json:"to,omitempty"`    // Destination city
	Resultv2 string `json:"resultv2"`        // Enable district parsing (1=enabled)
	Show     string `json:"show"`            // Response format: 0=json, 1=xml, 2=html, 3=text
	Order    string `json:"order"`           // Sort order: desc (newest first), asc (oldest first)
}

type TrackingData struct {
	Context    string `json:"context"`    // Event description
	Time       string `json:"time"`       // Event time (formatted)
	Ftime      string `json:"ftime"`      // Event time (formatted, alternative)
	Status     string `json:"status"`     // Status at this point
	AreaCode   string `json:"areaCode"`   // Area code
	AreaName   string `json:"areaName"`   // Area name
	AreaCenter string `json:"areaCenter"` // Area center coordinates
	Location   string `json:"location"`   // Location description
}

type TrackingResponse struct {
	Message   string         `json:"message"`   // Error message if any
	State     string         `json:"state"`     // Tracking state code
	Status    string         `json:"status"`    // Status code (200=success)
	Condition string         `json:"condition"` // Current condition
	IsCheck   string         `json:"ischeck"`   // Whether delivered (1=yes)
	Com       string         `json:"com"`       // Courier company code
	Nu        string         `json:"nu"`        // Tracking number
	Data      []TrackingData `json:"data"`      // Tracking events
}