tradera

type APIError struct {
	// Code is the error code from the API.
	Code string

	// Message is the error message from the API.
	Message string

	// Details contains additional error details if available.
	Details string
}

type AuctionBiddingInfo struct {
	ID                  int32
	ShortDescription    string
	SellerID            int32
	EndDate             time.Time
	ThumbnailLink       string
	ReservePriceReached bool
	HasBuyItNowOption   bool
	BuyItNowPrice       int32
	IsEnded             bool
	NextBid             int32
	MaxBid              int32
	MaxBidderID         int32
	TotalBids           int32
	MaxAutoBid          int32
}

type AuthenticationHeader struct {
	XMLName xml.Name `xml:"tra:AuthenticationHeader"`
	AppID   int      `xml:"tra:AppId"`
	AppKey  string   `xml:"tra:AppKey"`
}

type AuthorizationHeader struct {
	XMLName xml.Name `xml:"tra:AuthorizationHeader"`
	UserID  int      `xml:"tra:UserId"`
	Token   string   `xml:"tra:Token"`
}

type BuyResult struct {
	NextBid int32
	Status  string
}

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

type BuyerTransaction struct {
	ID                      int32
	Date                    time.Time
	Amount                  int32
	LastUpdatedDate         time.Time
	IsMarkedAsPaid          bool
	IsMarkedAsPaidConfirmed bool
	IsMarkedAsShipped       bool
	IsFeedbackLeftBySeller  bool
	IsFeedbackLeftByBuyer   bool
	ItemID                  int32
	ItemTitle               string
	SellerID                int32
	SellerAlias             string
}

type Category struct {
	ID       int32
	Name     string
	Children []*Category
}

type CategoryCountRequest struct {
	CategoryID             int32
	SearchWords            string
	Alias                  string
	CountyID               int32
	SearchInDescription    bool
	ItemCondition          string
	ZipCode                string
	OnlyItemsWithThumbnail bool
	OnlyAuctionsWithBuyNow bool
	Mode                   string
	PriceMinimum           *int32
	PriceMaximum           *int32
	BidsMinimum            *int32
	BidsMaximum            *int32
	ItemStatus             string
	ItemType               string
	SellerType             string
}

type CategoryCountResult struct {
	Categories []*SearchCategory
	Errors     []*SearchError
}

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

type Config struct {
	// AppID is your Tradera application ID (required)
	AppID int

	// AppKey is your Tradera application key/GUID (required)
	AppKey string

	// UserID is the user ID for authenticated operations (optional)
	// Required for Restricted, Order, and Buyer services
	UserID int

	// Token is the authorization token for authenticated operations (optional)
	// Required for Restricted, Order, and Buyer services
	// Obtain via PublicClient.FetchToken()
	Token string

	// RateLimit is the maximum number of requests per second (0 = disabled)
	RateLimit float64

	// RetryEnabled enables automatic retry with exponential backoff
	RetryEnabled bool

	// MaxRetries is the maximum number of retry attempts (default: 3)
	MaxRetries int

	// RetryBaseDelay is the base delay for exponential backoff (default: 1s)
	RetryBaseDelay time.Duration

	// CacheTTL enables caching with the specified TTL (0 = disabled)
	// Useful for caching relatively static data like categories
	CacheTTL time.Duration

	// Timeout is the default timeout for API requests (default: 30s)
	Timeout time.Duration
}

type DetailedSellerRating struct {
	ItemAsDescribedCount           *int32
	ItemAsDescribedAverage         *float64
	CommResponsivenessCount        *int32
	CommResponsivenessAverage      *float64
	ShippingTimeCount              *int32
	ShippingTimeAverage            *float64
	ShippingHandlingChargesCount   *int32
	ShippingHandlingChargesAverage *float64
}

type IdDescriptionPair struct {
	ID          int32
	Description string
	Value       string
}

type ImageLink struct {
	URL    string
	Format string
}

type Item struct {
	ID                int32
	ShortDescription  string
	LongDescription   string
	StartDate         time.Time
	EndDate           time.Time
	CategoryID        int32
	OpeningBid        int32
	ReservePrice      *int32
	BuyItNowPrice     *int32
	NextBid           int32
	MaxBid            int32
	TotalBids         int32
	ItemType          string
	StartQuantity     int32
	RemainingQuantity int32
	VAT               *int32
	PaymentCondition  string
	ShippingCondition string
	AcceptsPickup     bool
	Bold              bool
	Thumbnail         bool
	Highlight         bool
	FeaturedItem      bool
	ItemLink          string
	ThumbnailLink     string
	Restarts          int32
	Duration          int32
	Seller            *User
	MaxBidder         *User
	Buyers            []*User
	ImageLinks        []string
	ShippingOptions   []*ItemShipping
}

type ItemRestarts struct {
	LastRestartedItemID int32
	AncestorItemID      int32
	RestartedItems      []*RestartedItem
}

type ItemShipping struct {
	ShippingOptionID   *int32
	Cost               int32
	ShippingWeight     *float64
	ShippingProductID  *int32
	ShippingProviderID *int32
}

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

type MemorylistItem struct {
	ID                int32
	Title             string
	EndDate           time.Time
	CurrentPrice      int32
	BuyItNowPrice     *int32
	ThumbnailLink     string
	IsEnded           bool
	TotalBids         int32
	RemainingQuantity int32
}

type NetworkError struct {
	Op  string // Operation that failed
	Err error  // Underlying error
}

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

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

type RestartedItem struct {
	RestartedItemID   int32
	RestartedAsItemID int32
	RestartedDate     string
}

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

type SOAPFault struct {
	FaultCode   string
	FaultString string
	Detail      string
}

type SOAPHeaders struct {
	Authentication AuthenticationHeader
	Authorization  *AuthorizationHeader // nil if not using user auth
}

type SearchAdvancedRequest struct {
	SearchWords            string
	CategoryID             int32
	SearchInDescription    bool
	Mode                   string // "AllWords" or "AnyWords"
	PriceMinimum           *int32
	PriceMaximum           *int32
	BidsMinimum            *int32
	BidsMaximum            *int32
	ZipCode                string
	CountyID               int32
	Alias                  string
	OrderBy                string
	ItemStatus             string // "Active" or "Ended"
	ItemType               string // "All", "Auction", "FixedPrice"
	OnlyAuctionsWithBuyNow bool
	OnlyItemsWithThumbnail bool
	ItemsPerPage           int32
	PageNumber             int32
	ItemCondition          string // "All", "OnlyNew", "OnlySecondHand"
	SellerType             string // "All", "OnlyPrivate", "OnlyBusiness"
	Brands                 []string
}

type SearchCategory struct {
	ID                                   int32
	Name                                 string
	NoOfItemsInCategory                  int32
	NoOfItemsInCategoryIncludingChildren int32
	ChildCategories                      []*SearchCategory
}

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

type SearchError struct {
	Code    string
	Message string
}

type SearchItem struct {
	ID               int32
	ShortDescription string
	LongDescription  string
	BuyItNowPrice    *int32
	SellerID         int32
	SellerAlias      string
	MaxBid           *int32
	ThumbnailLink    string
	SellerDsrAverage float64
	EndDate          soap.XSDDateTime
	NextBid          *int32
	HasBids          bool
	IsEnded          bool
	ItemType         string
	ItemURL          string
	CategoryID       int32
	BidCount         int32
	ImageLinks       []ImageLink
}

type SearchRequest struct {
	Query      string
	CategoryID int32
	PageNumber int32
	OrderBy    string
}

type SearchResult struct {
	TotalNumberOfItems int32
	TotalNumberOfPages int32
	Items              []*SearchItem
	Errors             []*SearchError
}

type SellerInfo struct {
	TotalRating             int32
	PositiveFeedbackPercent *int32
	PersonalMessage         string
	IsCompany               bool
	HasShop                 bool
	DetailedRating          *DetailedSellerRating
}

type SellerOrder struct {
	ID             int32
	BuyerID        int32
	BuyerAlias     string
	TotalAmount    int32
	ShippingAmount int32
	Status         string
	CreatedDate    string
	IsPaid         bool
	IsShipped      bool
}

type SellerTransaction struct {
	ID                      int32
	Date                    string
	Amount                  int32
	LastUpdatedDate         string
	IsMarkedAsPaidConfirmed bool
	IsMarkedAsShipped       bool
	IsShippingBooked        bool
	BuyerID                 int32
	BuyerAlias              string
	ItemID                  int32
	ItemTitle               string
}

type ShopSettings struct {
	CompanyInformation     string
	PurchaseTerms          string
	ShowGalleryMode        *bool
	ShowAuctionView        *bool
	BannerColor            string
	IsTemporaryClosed      *bool
	TemporaryClosedMessage string
	ContactInformation     string
	LogoImageUrl           string
	MaxActiveItems         int32
	MaxInventoryItems      int32
}

type User struct {
	ID                int32
	Alias             string
	FirstName         string
	LastName          string
	Email             string
	TotalRating       int32
	PhoneNumber       string
	MobilePhoneNumber string
	Address           string
	ZipCode           string
	City              string
	CountryName       string
}

type UserInfo struct {
	ID               int32
	Alias            string
	FirstName        string
	LastName         string
	Email            string
	PhoneNumber      string
	Address          string
	ZipCode          string
	City             string
	CountryName      string
	PersonalNumber   string
	CurrencyCode     string
	LanguageCodeIso2 string
}