Developers Program
HomeSupportKnowledge Base1473

Trading API: Item.StartTime may be a little different from Item.ScheduledTime specified in the request

Find the answer to your question

Please enter a search keyword.
Advanced Search

Published: September 16 2009, 5:48:00 PMยทUpdated: August 11 2022, 3:50:43 AM

Products

Question

Item.StartTime may be a little different from Item.ScheduledTime in the request

Answer


Summary

Listings scheduled for a given time may show start times of within a few seconds different of their scheduled listing time. See the AddItem request and response xmls below for example.

The best practice for persist listing time of a scheduled eBay item is to record the StartTime and EndTime returned in AddItem or RelistItem api response not the ScheduleTime in your local repository.

<?xml version="1.0" encoding="utf-8"?>
<AddItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
<Version>1267</Version>
<ErrorLanguage>en_US</ErrorLanguage>
<WarningLevel>High</WarningLevel>
<Item>
<Country>US</Country>
<Currency>USD</Currency>
<Description>TEST - DO NOT BID</Description>
<ScheduleTime>2022-08-11T12:09:02.768Z</ScheduleTime>
<DispatchTimeMax>3</DispatchTimeMax>
<ListingDuration>Days_7</ListingDuration>
<Location>San Jose, CA</Location>
<PaymentMethods>PaymentSeeDescription</PaymentMethods>
<PaymentMethods>PayPal</PaymentMethods>
<PayPalEmailAddress>test@gmail.com</PayPalEmailAddress>
<PrimaryCategory>
<CategoryID>2312</CategoryID>
</PrimaryCategory>
<Quantity>1</Quantity>
<StartPrice>1</StartPrice>
<BuyItNowPrice>10</BuyItNowPrice>
<Title>TEST - DO NOT BID</Title>
<ShippingDetails>
<ShippingType>Flat</ShippingType>
<InsuranceDetails>
<InsuranceOption>Optional</InsuranceOption>
<InsuranceFee>3.5</InsuranceFee>
</InsuranceDetails>
<InternationalInsuranceDetails>
<InsuranceOption>Required</InsuranceOption>
<InsuranceFee>5.5</InsuranceFee>
</InternationalInsuranceDetails>
<ShippingServiceOptions>
<ShippingServicePriority>1</ShippingServicePriority>
<ShippingService>UPS2ndDay</ShippingService>
<ShippingServiceCost>5</ShippingServiceCost>
<ShippingServiceAdditionalCost>1</ShippingServiceAdditionalCost>
<ShippingSurcharge>1</ShippingSurcharge>
</ShippingServiceOptions>
<InternationalShippingServiceOption>
<ShippingServicePriority>1</ShippingServicePriority>
<ShippingService>USPSPriorityMailInternational</ShippingService>
<ShippingServiceCost>15</ShippingServiceCost>
<ShippingServiceAdditionalCost>11</ShippingServiceAdditionalCost>
<ShipToLocation>Worldwide</ShipToLocation>
</InternationalShippingServiceOption>
</ShippingDetails>
<ReturnPolicy>
<ReturnsAcceptedOption>ReturnsAccepted</ReturnsAcceptedOption>
<RefundOption>MoneyBack</RefundOption>
<ReturnsWithinOption>Days_30</ReturnsWithinOption>
<Description>Text description of return policy details</Description>
<ShippingCostPaidByOption>Buyer</ShippingCostPaidByOption>
</ReturnPolicy>
</Item>
<RequesterCredentials>
<eBayAuthToken>YOUR TOKEN</<eBayAuthToken>>
</RequesterCredentials>
</AddItemRequest>

<?xml version="1.0" encoding="utf-8"?>
<AddItemResponse xmlns="urn:ebay:apis:eBLBaseComponents">
<Timestamp>2022-08-11T10:13:56.654Z</Timestamp>
<Ack>Warning</Ack>
<Version>1267</Version>
<Build>E1267_UNI_API5_19110890_R1</Build>
<ItemID>250001204274</ItemID>
<StartTime>2022-08-11T12:09:10.000Z</StartTime>
<EndTime>2022-08-16T12:09:10.000Z</EndTime>
<Fees>
......

</Fees>
</AddItemResponse>

<?xml version="1.0" encoding="utf-8"?>
<AddItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
<Version>1267</Version>
<ErrorLanguage>en_US</ErrorLanguage>
<WarningLevel>High</WarningLevel>
<Item>
<Country>US</Country>
<Currency>USD</Currency>
<Description>TEST - DO NOT BID</Description>
<ScheduleTime>2022-08-11T12:09:02.768Z</ScheduleTime>
<DispatchTimeMax>3</DispatchTimeMax>
<ListingDuration>Days_7</ListingDuration>
<Location>San Jose, CA</Location>
<PaymentMethods>PaymentSeeDescription</PaymentMethods>
<PaymentMethods>PayPal</PaymentMethods>
<PayPalEmailAddress>test@gmail.com</PayPalEmailAddress>
<PrimaryCategory>
<CategoryID>2312</CategoryID>
</PrimaryCategory>
<Quantity>1</Quantity>
<StartPrice>1</StartPrice>
<BuyItNowPrice>10</BuyItNowPrice>
<Title>TEST - DO NOT BID</Title>
<ShippingDetails>
<ShippingType>Flat</ShippingType>
<InsuranceDetails>
<InsuranceOption>Optional</InsuranceOption>
<InsuranceFee>3.5</InsuranceFee>
</InsuranceDetails>
<InternationalInsuranceDetails>
<InsuranceOption>Required</InsuranceOption>
<InsuranceFee>5.5</InsuranceFee>
</InternationalInsuranceDetails>
<ShippingServiceOptions>
<ShippingServicePriority>1</ShippingServicePriority>
<ShippingService>UPS2ndDay</ShippingService>
<ShippingServiceCost>5</ShippingServiceCost>
<ShippingServiceAdditionalCost>1</ShippingServiceAdditionalCost>
<ShippingSurcharge>1</ShippingSurcharge>
</ShippingServiceOptions>
<InternationalShippingServiceOption>
<ShippingServicePriority>1</ShippingServicePriority>
<ShippingService>USPSPriorityMailInternational</ShippingService>
<ShippingServiceCost>15</ShippingServiceCost>
<ShippingServiceAdditionalCost>11</ShippingServiceAdditionalCost>
<ShipToLocation>Worldwide</ShipToLocation>
</InternationalShippingServiceOption>
</ShippingDetails>
<ReturnPolicy>
<ReturnsAcceptedOption>ReturnsAccepted</ReturnsAcceptedOption>
<RefundOption>MoneyBack</RefundOption>
<ReturnsWithinOption>Days_30</ReturnsWithinOption>
<Description>Text description of return policy details</Description>
<ShippingCostPaidByOption>Buyer</ShippingCostPaidByOption>
</ReturnPolicy>
</Item>
<RequesterCredentials>
<eBayAuthToken>YOUR TOKEN</<eBayAuthToken>>
</RequesterCredentials>
</AddItemRequest>
How well did this answer your question?

Print

Email this page