=head1 NAME

eBay::API::XML::Call::GetOrders::GetOrdersRequestType

=head1 DESCRIPTION

Retrieves all of the orders for which the user is a participant (as
either buyer or seller) that meet the criteria specified in the request.
<br>
<br>An order is a combination of two or more transactions.
<br>
<br>There are two mutually exclusive sets of filtering input arguments
that can be used to query for orders. The first set is based on specific
order IDs (one or more order IDs are passed in the call). The second set
is a combination of date range, order role, and order status. If one set
of filtering arguments is used, the arguments for the other set should not
be specified in the same call. If a given call to GetOrders includes both
criteria sets, the query based on order IDs is used, and the criteria for
date range/order status/order role is ignored.
This call can also be used to retrieve unshipped Half.com orders (i.e.,
orders that the seller has received but has not yet processed).



=head1 SYNOPSIS


=cut

=head1 Methods


=cut

=head2 setCreateTimeFrom()

The starting date of the date range for the orders to retrieve.
Also applicable to Half.com.

  RequiredInput: Conditionally
#    Argument: 'xs:dateTime'


=cut

=head2 getCreateTimeFrom()

#    Returns: 'xs:dateTime'


=cut

=head2 setCreateTimeTo()

The ending date of the date range for the orders to retrieve.
Also applicable to Half.com.

  RequiredInput: Conditionally
#    Argument: 'xs:dateTime'


=cut

=head2 getCreateTimeTo()

#    Returns: 'xs:dateTime'


=cut

=head2 setListingType()

To retrieve Half.com orders, specify Half. To retrieve eBay
orders, don't specify this field at all.
(This field can't be used as a listing type filter on eBay.com.
If not provided or if any value other than Half is specified,
this field has no useful effect and the call retrieves
eBay orders of all types.
Also, you can't retrieve both eBay and Half.com orders
in the same response.)

  RequiredInput: Conditionally
  OnlyTheseValues: Half
#    Argument: 'ns:ListingTypeCodeType'


=cut

=head2 getListingType()

#    Returns: 'ns:ListingTypeCodeType'


=cut

=head2 setOrderIDArray()

A set of orders to retrieve.
Does not retrieve Express orders, even when the explicit Express OrderID found on the eBay Express site is included in the request.
Not applicable to Half.com.

  RequiredInput: Conditionally
#    Argument: 'ns:OrderIDArrayType'


=cut

=head2 getOrderIDArray()

#    Returns: 'ns:OrderIDArrayType'


=cut

=head2 setOrderRole()

Filters orders based on the role of the user making the
GetOrders request.
Not applicable to Half.com.

  RequiredInput: Conditionally
#    Argument: 'ns:TradingRoleCodeType'


=cut

=head2 getOrderRole()

#    Returns: 'ns:TradingRoleCodeType'


=cut

=head2 setOrderStatus()

Filters the returned orders by order status (Active or Completed).
To retrieve orders with a status of Inactive or Cancelled, you must
specify the order IDs (OrderIDArray.OrderID). When you specify
OrderIDArray.OrderID, no other filters are used.
<br><br>
For Half.com, you can get some, but not all orders.
Orders on Half.com have different order status values from
eBay orders. When you set ListingType to Half, set OrderStatus
to Shipped. Otherwise, GetOrders may return incomplete information
or have indeterminate results.

  RequiredInput: Conditionally
  OnlyTheseValues: Active, Completed, Shipped
#    Argument: 'ns:OrderStatusCodeType'


=cut

=head2 getOrderStatus()

#    Returns: 'ns:OrderStatusCodeType'


=cut

=head2 setPagination()

Not applicable to eBay.com. Applicable to Half.com. If many orders are available,
you may need to call GetOrders multiple times to retrieve all the data.
Each result set is returned as a page of entries.
Use this Pagination information to indicate the maximum number of entries to
retrieve per page (i.e., per call), the page number to retrieve, and other data.

  RequiredInput: No
#    Argument: 'ns:PaginationType'


=cut

=head2 getPagination()

#    Returns: 'ns:PaginationType'


=cut

=head1 SEE ALSO

L<eBay::API>

=head1 JOIN US

Please visit http://developer.ebay.com for more eBay API information. 

Web:
L<http://developer.ebay.com>

Community Forums:
L<http://developer.ebay.com/community/forums/>

=cut

