=head1 eBay::API::XML::Call::SetPromotionalSaleListings::SetPromotionalSaleListingsRequestType

eBay::API::XML::Call::SetPromotionalSaleListings::SetPromotionalSaleListingsRequestType

=head1 DESCRIPTION

Used to change which item listings are affected by a promotional sale.
Item listings affected by a promotional sale have a reduced price 
and/or free shipping and are displayed as items on sale.
Use the Action field to specify addition of listings to, or deletion
of listings from, a promotional sale.
This call is part of the Promotional Price Display feature, 
which enables sellers to apply discounts across many listings.
Promotional sales apply to single and multi-quantity Store Inventory format, 
regular fixed-price format, auction, and auction/BIN formats. 
Auction and auction/BIN format listings can be added free shipping sales only.



=head1 SYNOPSIS


=cut

=head1 Subroutines:


=cut

=head2 setAction()

You must specify either Add or Delete.
This field determines whether you are adding listings to,
or deleting listings from,
the promotional sale you specify in the PromotionalSaleID field.
If you specify Delete, you must specify
PromotionalSaleItemIDArray. Delete is applicable only in 
cases where you specify PromotionalSaleItemIDArray.
Auction or auction/BIN format listings cannot be added to or deleted 
from a promotional sale if the item has bids.

  RequiredInput: Yes
  OnlyTheseValues: Add, Delete
#    Argument: 'ns:ModifyActionCodeType'


=cut

=head2 getAction()

#    Returns: 'ns:ModifyActionCodeType'


=cut

=head2 setAllAuctionItems()

Adds to the promotional sale all the seller's item listings 
that are auction items. Auction and auction/BIN format listings
can be added to free shipping sales only. 
Requires that you specify Add in the Action field.

  RequiredInput: No
#    Argument: 'xs:boolean'


=cut

=head2 isAllAuctionItems()

#    Returns: 'xs:boolean'


=cut

=head2 setAllFixedPriceItems()

Adds to the promotional sale all the seller's item listings 
that are fixed price items.
Requires that you specify Add in the Action field.

  RequiredInput: No
#    Argument: 'xs:boolean'


=cut

=head2 isAllFixedPriceItems()

#    Returns: 'xs:boolean'


=cut

=head2 setAllStoreInventoryItems()

Adds to the promotional sale all the seller's item listings 
that are store inventory items.
Requires that you specify Add in the Action field.

  RequiredInput: No
#    Argument: 'xs:boolean'


=cut

=head2 isAllStoreInventoryItems()

#    Returns: 'xs:boolean'


=cut

=head2 setCategoryID()

Adds to the promotional sale all the seller's item listings with
the CategoryID specified in this field. 
Requires that you specify Add in the Action field.

  RequiredInput: No
#    Argument: 'xs:long'


=cut

=head2 getCategoryID()

#    Returns: 'xs:long'


=cut

=head2 setPromotionalSaleID()

The ID of the promotional sale that you want to add listings to or
delete listings from.

  RequiredInput: Yes
#    Argument: 'xs:long'


=cut

=head2 getPromotionalSaleID()

#    Returns: 'xs:long'


=cut

=head2 setPromotionalSaleItemIDArray()

The IDs of the item listings to be affected
by the action you specify in the Action field.

  RequiredInput: Conditionally
#    Argument: 'ns:ItemIDArrayType'


=cut

=head2 getPromotionalSaleItemIDArray()

#    Returns: 'ns:ItemIDArrayType'


=cut

=head2 setStoreCategoryID()

Adds to the promotional sale all the seller's item listings with
the StoreCategoryID specified in this field.
Requires that you specify Add in the Action field.

  RequiredInput: No
#    Argument: 'xs:long'


=cut

=head2 getStoreCategoryID()

#    Returns: 'xs:long'


=cut

