ReviseItem

Note: Any eBay listing can be revised up to 250 times in one calendar day using ReviseFixedPriceItem and ReviseItem calls. If this revision threshold is reached, the seller will be blocked from using these calls on the listing until the next calendar day.

Note: An active listing that was created with the new Inventory model (using the Inventory API or Merchant Integration Platform) cannot be revised using the ReviseFixedPriceItem, ReviseItem, or ReviseInventoryStatus calls. Instead, the seller will need to use the Inventory API or MIP.

Use this call to change the properties of a currently active listing. This call is analogous to the Revise Your Item (RYI) page on the eBay site. Inputs are the revised item's ID and the properties that the seller wants to change. To revise an item, you must be the user who listed the original item. In addition, the item being revised must be a currently active listing. You cannot revise listings that have ended.

ReviseItem does not support revisions of multiple-variation listings, so the ReviseFixedPriceItem call must be used instead to modify a multiple-variation listing instead of using ReviseItem. See Multi-quantity Fixed Price listings with variations for details on this type of listing.

Usage Details

When calling ReviseItem, supply the ItemID of the active listing and an Item object containing the changes you want to make. You can also supply a list of the item fields that you want to delete from the listing using the DeletedField container. See the DeletedField documentation below for more information.

If there are bids on the item or if the listing is within 12 hours of its end time, certain restrictions are placed on the item properties you can change. For information regarding the rules for revising a listing see, Restrictions on revising listings.

Different fields have different rules for how to unset or remove their values. See Revising a Listing for a detailed description of the item revision process. In addition, steps for revising shipping details are unique.

When revising the shipping in a listing, you must include all ShippingDetails fields that were originally provided. To find out the shipping fields included in the current listing, call GetItem and look through the Item.ShippingDetails fields in the response. For the steps to revise shipping details, see Specifying Shipping Types and Costs.

Note that a listing must have at least one valid payment method. If you specify an invalid payment method when you revise a listing, eBay revises the item and returns a warning saying the invalid payment method was ignored.

If you are revising a US eBay Motors vehicle listing, only use ReviseItem if the vehicle was listed via the eBay API, but not if the vehicle was listed through the US eBay Motors Web site.

When revising items that were listed with Item Specifics or Pre-filled Item Information, make sure you use the same meta-data information as the original listing. If the meta-data for the item has changed since the item was originally listed, you cannot use the new meta-data when revising a listing.

As with all listing calls, the site you specify in the request URL (for SOAP) or the X-EBAY-API-SITEID HTTP header (for XML) should match the original listing's Item.Site value. In particular, this is a best practice when you submit new and revised listings.

Note to Sell Feed API users: When you use this call with the Sell Feed API, you must wrap the file to be uploaded within BulkDataExchangeRequest tags, which will also be returned in the response. This container is not shown in the standard Input/Output sections for this call. See XML data files overview in the LMS Feed API Guide for additional information.

Working with the Response

The call returns the item ID (for confirmation purposes) and the estimated fees for the revised item. See Fees Resulting from Listing an Item for fee details.

When you list an item, you're charged an Insertion Fee that is based on the starting price (or reserve price) and category of your item. If you relist your item for a lower starting price, the insertion fee is not credited. The insertion fee charged is based on the highest starting price for any of the item's insertions.

After calling ReviseItem, inspect the ItemID property to verify that the correct listing was revised. Also, inspect the child elements of the Fees container to review the estimated listing fees associated with the item revision.

Revising an item does not in itself incur eBay fees, so the values in the Fees container are often 0 in value. However, should the seller make changes to the original listing properties such that a fee-based option is used in the revised listing (where it was not used in the original listing), then the associated fees are reflected.

Testing ReviseItem

You can test ReviseItem in the Sandbox. To test the call, you must have an active item for which the test user is the one that originally listed the item. If such an item listing does not already exist, create one using AddItem.

After revising an item, use a data retrieval call like GetSellerList or GetItem to retrieve the data for the revised item. Verify that the listing has all of the desired values and ensure that the changes are those intended.

Related Information

See Revise a listing.

See also the reference documentation for these calls:

• ReviseFixedPriceItem - Enables a seller to revise a fixed-price listing on a specified eBay site.
• ReviseInventoryStatus - Enables a seller to change the price and/or quantity of one or more fixed-price listings (single-variation or multiple-variation).

Input

See also Samples.

The box below lists all fields that could be included in the call request. To learn more about an individual field or its type, click its name in the box (or scroll down to find it in the table below the box).

See also the Deprecated Objects link above. Fields presented in this color are deprecated, and fields presented in this color are (or soon will be) non-operational.

The XML prototype does not include requester credentials. This is a documentation limitation only (see Standard Requester Credentials for Making Calls).

<?xml version="1.0" encoding="utf-8"?>
<ReviseItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Call-specific Input Fields -->
  <DeletedField> string </DeletedField>
  <!-- ... more DeletedField values allowed here ... -->
  <Item> ItemType
    <ApplicationData> string </ApplicationData>
    <AutoPay> boolean </AutoPay>
    <BestOfferDetails> BestOfferDetailsType
      <BestOfferEnabled> boolean </BestOfferEnabled>
    </BestOfferDetails>
    <BuyerResponsibleForShipping> boolean </BuyerResponsibleForShipping>
    <BuyItNowPrice currencyID="CurrencyCodeType"> AmountType (double) </BuyItNowPrice>
    <CategoryMappingAllowed> boolean </CategoryMappingAllowed>
    <CeilingPrice currencyID="CurrencyCodeType"> AmountType (double) </CeilingPrice>
    <Charity> CharityType
      <CharityID> string </CharityID>
      <DonationPercent> float </DonationPercent>
    </Charity>
    <ConditionDescription> string </ConditionDescription>
    <ConditionDescriptors> ConditionDescriptorsType
      <ConditionDescriptor> ConditionDescriptorType
        <AdditionalInfo> string </AdditionalInfo>
        <Name> string </Name>
        <Value> string </Value>
        <!-- ... more Value values allowed here ... -->
      </ConditionDescriptor>
      <!-- ... more ConditionDescriptor nodes allowed here ... -->
    </ConditionDescriptors>
    <ConditionID> int </ConditionID>
    <Country> CountryCodeType </Country>
    <CrossBorderTrade> string </CrossBorderTrade>
    <!-- ... more CrossBorderTrade values allowed here ... -->
    <CustomPolicies> CustomPoliciesType
      <ProductCompliancePolicyID> long </ProductCompliancePolicyID>
      <!-- ... more ProductCompliancePolicyID values allowed here ... -->
      <RegionalProductCompliancePolicies> CountryPoliciesArrayType
        <CountryPolicies> CountryPoliciesType
          <Country> CountryCodeType </Country>
          <PolicyID> long </PolicyID>
          <!-- ... more PolicyID values allowed here ... -->
        </CountryPolicies>
        <!-- ... more CountryPolicies nodes allowed here ... -->
      </RegionalProductCompliancePolicies>
      <RegionalTakeBackPolicies> CountryPoliciesArrayType
        <CountryPolicies> CountryPoliciesType
          <Country> CountryCodeType </Country>
          <PolicyID> long </PolicyID>
          <!-- ... more PolicyID values allowed here ... -->
        </CountryPolicies>
        <!-- ... more CountryPolicies nodes allowed here ... -->
      </RegionalTakeBackPolicies>
      <TakeBackPolicyID> long </TakeBackPolicyID>
    </CustomPolicies>
    <Description> string </Description>
    <DescriptionReviseMode> DescriptionReviseModeCodeType </DescriptionReviseMode>
    <DigitalGoodInfo> DigitalGoodInfoType
      <DigitalDelivery> boolean </DigitalDelivery>
    </DigitalGoodInfo>
    <DisableBuyerRequirements> boolean </DisableBuyerRequirements>
    <DiscountPriceInfo> DiscountPriceInfoType
      <MadeForOutletComparisonPrice currencyID="CurrencyCodeType"> AmountType (double) </MadeForOutletComparisonPrice>
      <MinimumAdvertisedPrice currencyID="CurrencyCodeType"> AmountType (double) </MinimumAdvertisedPrice>
      <MinimumAdvertisedPriceExposure> MinimumAdvertisedPriceExposureCodeType </MinimumAdvertisedPriceExposure>
      <OriginalRetailPrice currencyID="CurrencyCodeType"> AmountType (double) </OriginalRetailPrice>
      <SoldOffeBay> boolean </SoldOffeBay>
      <SoldOneBay> boolean </SoldOneBay>
    </DiscountPriceInfo>
    <DispatchTimeMax> int </DispatchTimeMax>
    <eBayPlus> boolean </eBayPlus>
    <ExtendedProducerResponsibility> ExtendedProducerResponsibilityType
      <EcoParticipationFee currencyID="CurrencyCodeType"> AmountType (double) </EcoParticipationFee>
    </ExtendedProducerResponsibility>
    <ExtendedSellerContactDetails> ExtendedContactDetailsType
      <ClassifiedAdContactByEmailEnabled> boolean </ClassifiedAdContactByEmailEnabled>
      <ContactHoursDetails> ContactHoursDetailsType
        <Hours1AnyTime> boolean </Hours1AnyTime>
        <Hours1Days> DaysCodeType </Hours1Days>
        <Hours1From> time </Hours1From>
        <Hours1To> time </Hours1To>
        <Hours2AnyTime> boolean </Hours2AnyTime>
        <Hours2Days> DaysCodeType </Hours2Days>
        <Hours2From> time </Hours2From>
        <Hours2To> time </Hours2To>
        <TimeZoneID> string </TimeZoneID>
      </ContactHoursDetails>
    </ExtendedSellerContactDetails>
    <FloorPrice currencyID="CurrencyCodeType"> AmountType (double) </FloorPrice>
    <ItemCompatibilityList> ItemCompatibilityListType
      <Compatibility> ItemCompatibilityType
        <CompatibilityNotes> string </CompatibilityNotes>
        <Delete> boolean </Delete>
        <NameValueList> NameValueListType
          <Name> string </Name>
          <Value> string </Value>
          <!-- ... more Value values allowed here ... -->
        </NameValueList>
        <!-- ... more NameValueList nodes allowed here ... -->
      </Compatibility>
      <!-- ... more Compatibility nodes allowed here ... -->
      <ReplaceAll> boolean </ReplaceAll>
    </ItemCompatibilityList>
    <ItemID> ItemIDType (string) </ItemID>
    <ItemSpecifics> NameValueListArrayType
      <NameValueList> NameValueListType
        <Name> string </Name>
        <Value> string </Value>
        <!-- ... more Value values allowed here ... -->
      </NameValueList>
      <!-- ... more NameValueList nodes allowed here ... -->
    </ItemSpecifics>
    <ListingDetails> ListingDetailsType
      <BestOfferAutoAcceptPrice currencyID="CurrencyCodeType"> AmountType (double) </BestOfferAutoAcceptPrice>
      <MinimumBestOfferPrice currencyID="CurrencyCodeType"> AmountType (double) </MinimumBestOfferPrice>
    </ListingDetails>
    <ListingDuration> token </ListingDuration>
    <ListingEnhancement> ListingEnhancementsCodeType </ListingEnhancement>
    <!-- ... more ListingEnhancement values allowed here ... -->
    <ListingSubtype2> ListingSubtypeCodeType </ListingSubtype2>
    <Location> string </Location>
    <LotSize> int </LotSize>
    <PaymentDetails> PaymentDetailsType
      <DaysToFullPayment> int </DaysToFullPayment>
      <DepositAmount currencyID="CurrencyCodeType"> AmountType (double) </DepositAmount>
      <DepositType> DepositTypeCodeType </DepositType>
      <HoursToDeposit> int </HoursToDeposit>
    </PaymentDetails>
    <PaymentMethods> BuyerPaymentMethodCodeType </PaymentMethods>
    <!-- ... more PaymentMethods values allowed here ... -->
    <PayPalEmailAddress> string </PayPalEmailAddress>
    <PickupInStoreDetails> PickupInStoreDetailsType
      <EligibleForPickupInStore> boolean </EligibleForPickupInStore>
    </PickupInStoreDetails>
    <PictureDetails> PictureDetailsType
      <GalleryType> GalleryTypeCodeType </GalleryType>
      <PictureURL> anyURI </PictureURL>
      <!-- ... more PictureURL values allowed here ... -->
    </PictureDetails>
    <PostalCode> string </PostalCode>
    <PrimaryCategory> CategoryType
      <CategoryID> string </CategoryID>
    </PrimaryCategory>
    <PrivateListing> boolean </PrivateListing>
    <ProductListingDetails> ProductListingDetailsType
      <BrandMPN> BrandMPNType
        <Brand> string </Brand>
        <MPN> string </MPN>
      </BrandMPN>
      <EAN> string </EAN>
      <IncludeeBayProductDetails> boolean </IncludeeBayProductDetails>
      <IncludeStockPhotoURL> boolean </IncludeStockPhotoURL>
      <ISBN> string </ISBN>
      <ProductReferenceID> string </ProductReferenceID>
      <ReturnSearchResultOnDuplicates> boolean </ReturnSearchResultOnDuplicates>
      <UPC> string </UPC>
      <UseFirstProduct> boolean </UseFirstProduct>
      <UseStockPhotoURLAsGallery> boolean </UseStockPhotoURLAsGallery>
    </ProductListingDetails>
    <Quantity> int </Quantity>
    <QuantityRestrictionPerBuyer> QuantityRestrictionPerBuyerInfoType
      <MaximumQuantity> int </MaximumQuantity>
    </QuantityRestrictionPerBuyer>
    <Regulatory> RegulatoryType
      <Documents> DocumentsType
        <Document> DocumentType
          <DocumentID> string </DocumentID>
        </Document>
        <!-- ... more Document nodes allowed here ... -->
      </Documents>
      <EnergyEfficiencyLabel> EnergyEfficiencyType
        <ImageDescription> string </ImageDescription>
        <ImageURL> anyURI </ImageURL>
        <ProductInformationsheet> anyURI </ProductInformationsheet>
      </EnergyEfficiencyLabel>
      <Hazmat> HazmatType
        <Component> string </Component>
        <Pictograms> PictogramsType
          <Pictogram> string </Pictogram>
          <!-- ... more Pictogram values allowed here ... -->
        </Pictograms>
        <SignalWord> string </SignalWord>
        <Statements> StatementsType
          <Statement> string </Statement>
          <!-- ... more Statement values allowed here ... -->
        </Statements>
      </Hazmat>
      <Manufacturer> ManufacturerType
        <CityName> string </CityName>
        <CompanyName> string </CompanyName>
        <Country> CountryCodeType </Country>
        <Email> string </Email>
        <Phone> string </Phone>
        <PostalCode> string </PostalCode>
        <StateOrProvince> string </StateOrProvince>
        <Street1> string </Street1>
        <Street2> string </Street2>
      </Manufacturer>
      <ProductSafety> ProductSafetyType
        <Component> string </Component>
        <Pictograms> PictogramsType
          <Pictogram> string </Pictogram>
          <!-- ... more Pictogram values allowed here ... -->
        </Pictograms>
        <Statements> StatementsType
          <Statement> string </Statement>
          <!-- ... more Statement values allowed here ... -->
        </Statements>
      </ProductSafety>
      <RepairScore> double </RepairScore>
      <ResponsiblePersons> ResponsiblePersonsType
        <ResponsiblePerson> ResponsiblePersonType
          <CityName> string </CityName>
          <CompanyName> string </CompanyName>
          <Country> CountryCodeType </Country>
          <Email> string </Email>
          <Phone> string </Phone>
          <PostalCode> string </PostalCode>
          <StateOrProvince> string </StateOrProvince>
          <Street1> string </Street1>
          <Street2> string </Street2>
          <Types> ResponsiblePersonCodeTypes
            <Type> ResponsiblePersonCodeType </Type>
            <!-- ... more Type values allowed here ... -->
          </Types>
        </ResponsiblePerson>
        <!-- ... more ResponsiblePerson nodes allowed here ... -->
      </ResponsiblePersons>
    </Regulatory>
    <ReservePrice currencyID="CurrencyCodeType"> AmountType (double) </ReservePrice>
    <ReturnPolicy> ReturnPolicyType
      <Description> string </Description>
      <InternationalRefundOption> token </InternationalRefundOption>
      <InternationalReturnsAcceptedOption> token </InternationalReturnsAcceptedOption>
      <InternationalReturnsWithinOption> token </InternationalReturnsWithinOption>
      <InternationalShippingCostPaidByOption> token </InternationalShippingCostPaidByOption>
      <RefundOption> token </RefundOption>
      <ReturnsAcceptedOption> token </ReturnsAcceptedOption>
      <ReturnsWithinOption> token </ReturnsWithinOption>
      <ShippingCostPaidByOption> token </ShippingCostPaidByOption>
    </ReturnPolicy>
    <ScheduleTime> dateTime </ScheduleTime>
    <SecondaryCategory> CategoryType
      <CategoryID> string </CategoryID>
    </SecondaryCategory>
    <Seller> UserType </Seller>
    <SellerContactDetails> AddressType
      <CompanyName> string </CompanyName>
      <County> string </County>
      <PhoneAreaOrCityCode> string </PhoneAreaOrCityCode>
      <PhoneCountryCode> CountryCodeType </PhoneCountryCode>
      <PhoneLocalNumber> string </PhoneLocalNumber>
      <Street> string </Street>
      <Street2> string </Street2>
    </SellerContactDetails>
    <SellerProfiles> SellerProfilesType
      <SellerPaymentProfile> SellerPaymentProfileType
        <PaymentProfileID> long </PaymentProfileID>
        <PaymentProfileName> string </PaymentProfileName>
      </SellerPaymentProfile>
      <SellerReturnProfile> SellerReturnProfileType
        <ReturnProfileID> long </ReturnProfileID>
        <ReturnProfileName> string </ReturnProfileName>
      </SellerReturnProfile>
      <SellerShippingProfile> SellerShippingProfileType
        <ShippingProfileID> long </ShippingProfileID>
        <ShippingProfileName> string </ShippingProfileName>
      </SellerShippingProfile>
    </SellerProfiles>
    <SellerProvidedTitle> string </SellerProvidedTitle>
    <ShippingDetails> ShippingDetailsType
      <CalculatedShippingRate> CalculatedShippingRateType
        <InternationalPackagingHandlingCosts currencyID="CurrencyCodeType"> AmountType (double) </InternationalPackagingHandlingCosts>
        <PackagingHandlingCosts currencyID="CurrencyCodeType"> AmountType (double) </PackagingHandlingCosts>
      </CalculatedShippingRate>
      <ExcludeShipToLocation> string </ExcludeShipToLocation>
      <!-- ... more ExcludeShipToLocation values allowed here ... -->
      <GlobalShipping> boolean </GlobalShipping>
      <InternationalPromotionalShippingDiscount> boolean </InternationalPromotionalShippingDiscount>
      <InternationalShippingDiscountProfileID> string </InternationalShippingDiscountProfileID>
      <InternationalShippingServiceOption> InternationalShippingServiceOptionsType
        <ShippingService> token </ShippingService>
        <ShippingServiceAdditionalCost currencyID="CurrencyCodeType"> AmountType (double) </ShippingServiceAdditionalCost>
        <ShippingServiceCost currencyID="CurrencyCodeType"> AmountType (double) </ShippingServiceCost>
        <ShippingServicePriority> int </ShippingServicePriority>
        <ShipToLocation> string </ShipToLocation>
        <!-- ... more ShipToLocation values allowed here ... -->
      </InternationalShippingServiceOption>
      <!-- ... more InternationalShippingServiceOption nodes allowed here ... -->
      <PromotionalShippingDiscount> boolean </PromotionalShippingDiscount>
      <RateTableDetails> RateTableDetailsType
        <DomesticRateTable> string </DomesticRateTable>
        <DomesticRateTableId> string </DomesticRateTableId>
        <InternationalRateTable> string </InternationalRateTable>
        <InternationalRateTableId> string </InternationalRateTableId>
      </RateTableDetails>
      <SalesTax> SalesTaxType
        <SalesTaxPercent> float </SalesTaxPercent>
        <SalesTaxState> string </SalesTaxState>
        <ShippingIncludedInTax> boolean </ShippingIncludedInTax>
      </SalesTax>
      <ShippingDiscountProfileID> string </ShippingDiscountProfileID>
      <ShippingServiceOptions> ShippingServiceOptionsType
        <FreeShipping> boolean </FreeShipping>
        <ShippingService> token </ShippingService>
        <ShippingServiceAdditionalCost currencyID="CurrencyCodeType"> AmountType (double) </ShippingServiceAdditionalCost>
        <ShippingServiceCost currencyID="CurrencyCodeType"> AmountType (double) </ShippingServiceCost>
        <ShippingServicePriority> int </ShippingServicePriority>
      </ShippingServiceOptions>
      <!-- ... more ShippingServiceOptions nodes allowed here ... -->
      <ShippingType> ShippingTypeCodeType </ShippingType>
    </ShippingDetails>
    <ShippingPackageDetails> ShipPackageDetailsType
      <MeasurementUnit> MeasurementSystemCodeType </MeasurementUnit>
      <PackageDepth> MeasureType (decimal) </PackageDepth>
      <PackageLength> MeasureType (decimal) </PackageLength>
      <PackageWidth> MeasureType (decimal) </PackageWidth>
      <ShippingIrregular> boolean </ShippingIrregular>
      <ShippingPackage> ShippingPackageCodeType </ShippingPackage>
      <WeightMajor> MeasureType (decimal) </WeightMajor>
      <WeightMinor> MeasureType (decimal) </WeightMinor>
    </ShippingPackageDetails>
    <ShippingServiceCostOverrideList> ShippingServiceCostOverrideListType
      <ShippingServiceCostOverride> ShippingServiceCostOverrideType
        <ShippingServiceAdditionalCost currencyID="CurrencyCodeType"> AmountType (double) </ShippingServiceAdditionalCost>
        <ShippingServiceCost currencyID="CurrencyCodeType"> AmountType (double) </ShippingServiceCost>
        <ShippingServicePriority> int </ShippingServicePriority>
        <ShippingServiceType> ShippingServiceType </ShippingServiceType>
      </ShippingServiceCostOverride>
      <!-- ... more ShippingServiceCostOverride nodes allowed here ... -->
    </ShippingServiceCostOverrideList>
    <ShipToLocations> string </ShipToLocations>
    <!-- ... more ShipToLocations values allowed here ... -->
    <SKU> SKUType (string) </SKU>
    <StartPrice currencyID="CurrencyCodeType"> AmountType (double) </StartPrice>
    <Storefront> StorefrontType
      <StoreCategory2ID> long </StoreCategory2ID>
      <StoreCategory2Name> string </StoreCategory2Name>
      <StoreCategoryID> long </StoreCategoryID>
      <StoreCategoryName> string </StoreCategoryName>
    </Storefront>
    <SubTitle> string </SubTitle>
    <TaxCategory> string </TaxCategory>
    <Title> string </Title>
    <UseTaxTable> boolean </UseTaxTable>
    <VATDetails> VATDetailsType
      <BusinessSeller> boolean </BusinessSeller>
      <RestrictedToBusiness> boolean </RestrictedToBusiness>
      <VATPercent> float </VATPercent>
    </VATDetails>
    <VideoDetails> VideoDetailsType
      <VideoID> string </VideoID>
      <!-- ... more VideoID values allowed here ... -->
    </VideoDetails>
    <VIN> string </VIN>
    <VRM> string </VRM>
  </Item>
  <VerifyOnly> boolean </VerifyOnly>
  <!-- Standard Input Fields -->
  <ErrorHandling> ErrorHandlingCodeType </ErrorHandling>
  <ErrorLanguage> string </ErrorLanguage>
  <InvocationID> UUIDType (string) </InvocationID>
  <MessageID> string </MessageID>
  <Version> string </Version>
  <WarningLevel> WarningLevelCodeType </WarningLevel>
</ReviseItemRequest>

 Item.ListingDetails.BestOfferAutoAcceptPrice 

 Item.ListingDetails.BestOfferAutoAcceptPrice 

 Item.ListingDetails.MinimumBestOfferPrice 

 Item.ListingDetails.MinimumBestOfferPrice