Examples of com.ebay.sdk.call.ReviseItemCall

com.ebay.sdk.call.ReviseItemCall
Wrapper class of the ReviseItem call of eBay SOAP API.

Title: SOAP API wrapper library.

Description: Contains wrapper classes for eBay SOAP APIs.

Copyright: Copyright (c) 2009

Company: eBay Inc.

Input property: ItemToBeRevised - Child elements hold the values for properties that are changing. The Item.ItemID property must always be set to the ID of the item listing being changed. Set values in the Item object only for those properties that are changing. Use DeletedField to remove a property.

Applicable to Half.com.
Input property: DeletedField - Specifies the name of a field to delete from a listing. See the eBay Trading API guide for rules on deleting values when revising items. Also see the relevant field descriptions to determine when to use DeletedField (and potential consequences). The request can contain zero, one, or many instances of DeletedField (one for each field to be deleted).

You cannot delete required fields from a listing.

Some fields are optional when you first list an item (e.g., SecondaryCategory), but once they are set they cannot be deleted when you revise an item. Some optional fields cannot be deleted from auction listings if the item has bids and/or ends within 12 hours. Some optional fields cannot be deleted if other fields depend on them.

Some data (such as Variation nodes within Variations) can't be deleted by using DeletedFields. See the relevant field descriptions for how to delete such data. See the eBay Features Guide for rules on removing values when revising items. Also see the relevant field descriptions for details on when to use DeletedField (and potential consequences).

DeletedField accepts the following path names, which delete the corresponding nodes:

Item.ApplicationData
Item.AttributeSetArray
Item.BuyItNowPrice
Item.ConditionID
Item.ExtendedSellerContactDetails
Item.ClassifiedAdContactByEmailEnabled
Item.ItemSpecifics
Item.ListingCheckoutRedirectPreference.ProStoresStoreName
Item.ListingCheckoutRedirectPreference.SellerThirdPartyUsername
Item.ListingDesigner.LayoutID
Item.ListingDesigner.ThemeID
Item.ListingDetails.MinimumBestOfferMessage
Item.ListingDetails.MinimumBestOfferPrice
Item.ListingEnhancement[Value]
Item.PayPalEmailAddress
Item.PictureDetails.GalleryURL
Item.PictureDetails.PictureURL
Item.PostalCode
Item.ProductListingDetails
Item.SellerContactDetails
Item.SellerContactDetails.CompanyName
Item.SellerContactDetails.County
Item.SellerContactDetails.InternationalStreet
Item.SellerContactDetails.Phone2AreaOrCityCode
Item.SellerContactDetails.Phone2CountryCode
Item.SellerContactDetails.Phone2CountryPrefix
Item.SellerContactDetails.Phone2LocalNumber
Item.SellerContactDetails.PhoneAreaOrCityCode
Item.SellerContactDetails.PhoneCountryCode
Item.SellerContactDetails.PhoneCountryPrefix
Item.SellerContactDetails.PhoneLocalNumber
Item.SellerContactDetails.Street
Item.SellerContactDetails.Street2
Item.ShippingDetails.PaymentInstructions
Item.SKU (unless InventoryTrackingMethod is SKU)
Item.SubTitle

These values are case-sensitive. Use values that match the case of the schema element names (Item.PictureDetails.GalleryURL) or make the initial letter of each field name lowercase (item.pictureDetails.galleryURL). However, do not change the case of letters in the middle of a field name. For example, item.picturedetails.galleryUrl is not allowed.

To delete a listing enhancement like BoldTitle, specify the value you are deleting in square brackets ("[ ]"); for example, Item.ListingEnhancement[BoldTitle].
Input property: VerifyOnly - When the VerifyOnly boolean tag value is supplied as 'true', the response will include the calculated listing price change if there is an increase in the BIN/Start price, but does not persist the values in DB. This call is similar to VerifyAddItem in revise mode.
Output property: ReturnedItemID - Item ID that uniquely identifies the item listing that was revised. Provided for confirmation purposes. The value returned should be the same as the item ID specified in the ItemID property of the Item object specified as input for the call. Also applicable to Half.com.
Output property: ReturnedStartTime - Starting date and time for the revised listing. Also returned for Half.com (for Half.com, the start time is always the time the item was originally listed).
Output property: ReturnedEndTime - Date and time when the new listing ends. This is the starting time plus the listing duration. Also returned for Half.com, but for Half.com the actual end time is GTC (not the end time returned in the response).
Output property: ListingFees - Child elements contain the estimated listing fees for the revised item listing. The fees do not include the Final Value Fee (FVF), which cannot be determined until an item is sold. Revising an item does not itself incur a fee. However, certain item properties are fee-based and result in the return of fees in the call's response. Not applicable to Half.com.
Output property: ReturnedCategoryID - ID of the primary category in which the item was listed. Only returned if you set Item.CategoryMappingAllowed to true in the request and the ID passed in Item.PrimaryCategory was mapped to a new ID by eBay. If the primary category has not changed or it has expired with no replacement, CategoryID does not return a value. Not applicable to Half.com.
Output property: ReturnedCategory2ID - ID of the secondary category in which the item was listed. Only returned if you set Item.CategoryMappingAllowed to true in the request and the ID passed in Item.SecondaryCategory was mapped to a new ID by eBay. If the secondary category has not changed or it has expired with no replacement, Category2ID does not return a value. Not applicable to Half.com.
Output property: ReturnedVerifyOnly - Supporting VerifyOnly for ReviseItem call as part of project 24083 (API - Critical enhancements). When the VerifyOnly boolean tag value is supplied as 'true', the response will include the calculated listing price change if there is an increase in the BIN/Start price, but does not persist the values in DB. This call is simialr to VerifyAddItem in revise mode.
Output property: ReturnedDiscountReason - The nature of the discount, if a discount applied.
Output property: ReturnedProductSuggestions - Provides a list of products recommended by eBay which match the item information provided by the seller. Not applicable to Half.com.
Output property: ReturnedListingRecommendations - Container consisting of one or more Recommendation containers. Each Recommendation container provides a message to the seller on how a listing can be improved or brought up to standard in reqards to: optimizing the listing category; recommendation to provide a condition description for a used item; Top-Rated Plus listing requirements; recommendation to offer GSP for International buyers; required and recommended Item Specifics for the category and/or product; picture requirements; and/or a recommendation to use a product code to list the item, such as a UPC, an EAN, or an ISBN.

This container is only returned if the IncludeRecommendations flag was included and set to 'true' in the ReviseItem request, and if at least one listing recommendation exists for the listing about to be revised. If one or more listing recommendations are returned, it will be at the seller's discretion about whether to revise the item again based on eBay's listing recommendation(s). @author Ron Murphy @version 1.0


        try {
            ApiContext apiContext = EbayStoreHelper.getApiContext(productStoreId, locale, delegator);
            String sandboxEPSURL = "https://api.sandbox.ebay.com/ws/api.dll";
            apiContext.setEpsServerUrl(sandboxEPSURL);
            ReviseItemCall api = new ReviseItemCall(apiContext);


            // Set item type.
            ItemType itemToBeRevised = new ItemType();
            itemToBeRevised.setItemID(itemID);


            if (UtilValidate.isNotEmpty(title)) {
                itemToBeRevised.setTitle(title);
            }


            if (UtilValidate.isNotEmpty(description)) {
                itemToBeRevised.setDescription(description);
            }


            // Set startPrice value.
            AmountType startPrice = new AmountType();
            if (UtilValidate.isNotEmpty(price)) {
                startPrice.setValue(Double.parseDouble(price));
                startPrice.setCurrencyID(CurrencyCodeType.valueOf(currencyId));
                itemToBeRevised.setStartPrice(startPrice);
            }


            // Check upload image file.
            if (UtilValidate.isNotEmpty(imageFileName)) {


                // Upload image to ofbiz path /runtime/tmp .
                ByteBuffer byteWrap = (ByteBuffer) context.get("imageData");
                File file = new File(System.getProperty("ofbiz.home"), "runtime" + File.separator + "tmp" + File.separator + imageFileName);
                FileChannel wChannel = new FileOutputStream(file, false).getChannel();
                wChannel.write(byteWrap);
                wChannel.close();


                // Set path file picture to api and set picture details.
                String [] pictureFiles = {System.getProperty("ofbiz.home") + File.separator + "runtime" + File.separator + "tmp" + File.separator + imageFileName};
                PictureDetailsType pictureDetails = new PictureDetailsType();
                pictureDetails.setGalleryType(GalleryTypeCodeType.GALLERY);
                pictureDetails.setPhotoDisplay(PhotoDisplayCodeType.NONE);
                pictureDetails.setPictureSource(PictureSourceCodeType.EPS);
                itemToBeRevised.setPictureDetails(pictureDetails);


                api.setItemToBeRevised(itemToBeRevised);
                api.uploadPictures(pictureFiles, pictureDetails);
            } else {
                api.setItemToBeRevised(itemToBeRevised);
            }
        } catch (Exception e) {
            return ServiceUtil.returnError(e.getMessage());
        }
        return ServiceUtil.returnSuccess(UtilProperties.getMessage(resource, "EbayStoreUpdateItemSuccessfully", locale));

View Full Code Here


        try {
            ApiContext apiContext = EbayStoreHelper.getApiContext(productStoreId, locale, delegator);
            String sandboxEPSURL = "https://api.sandbox.ebay.com/ws/api.dll";
            apiContext.setEpsServerUrl(sandboxEPSURL);
            ReviseItemCall api = new ReviseItemCall(apiContext);


            // Set item type.
            ItemType itemToBeRevised = new ItemType();
            itemToBeRevised.setItemID(itemID);


            if (UtilValidate.isNotEmpty(title)) {
                itemToBeRevised.setTitle(title);
            }


            if (UtilValidate.isNotEmpty(description)) {
                itemToBeRevised.setDescription(description);
            }


            // Set startPrice value.
            AmountType startPrice = new AmountType();
            if (UtilValidate.isNotEmpty(price)) {
                startPrice.setValue(Double.parseDouble(price));
                startPrice.setCurrencyID(CurrencyCodeType.valueOf(currencyId));
                itemToBeRevised.setStartPrice(startPrice);
            }


            // Check upload image file.
            if (UtilValidate.isNotEmpty(imageFileName)) {


                // Upload image to ofbiz path /runtime/tmp .
                ByteBuffer byteWrap = (ByteBuffer) context.get("imageData");
                File file = new File(System.getProperty("ofbiz.home"), "runtime" + File.separator + "tmp" + File.separator + imageFileName);
                FileChannel wChannel = new FileOutputStream(file, false).getChannel();
                wChannel.write(byteWrap);
                wChannel.close();


                // Set path file picture to api and set picture details.
                String [] pictureFiles = {System.getProperty("ofbiz.home") + File.separator + "runtime" + File.separator + "tmp" + File.separator + imageFileName};
                PictureDetailsType pictureDetails = new PictureDetailsType();
                pictureDetails.setGalleryType(GalleryTypeCodeType.GALLERY);
                pictureDetails.setPhotoDisplay(PhotoDisplayCodeType.NONE);
                pictureDetails.setPictureSource(PictureSourceCodeType.EPS);
                itemToBeRevised.setPictureDetails(pictureDetails);


                api.setItemToBeRevised(itemToBeRevised);
                api.uploadPictures(pictureFiles, pictureDetails);
            } else {
                api.setItemToBeRevised(itemToBeRevised);
            }
        } catch (Exception e) {
            return ServiceUtil.returnError(e.getMessage());
        }
        return ServiceUtil.returnSuccess(UtilProperties.getMessage(resource, "EbayStoreUpdateItemSuccessfully", locale));

View Full Code Here

TOP

Related Classes of com.ebay.sdk.call.ReviseItemCall

org.ofbiz.ebaystore.EbayStore

java.lang.String

java.util.Calendar

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.