AdBookConnect Web Service
MethodGetOrderListByIDList
AdBookConnect Web Service > All Operations Resource Group : GetOrderListByIDList (Method)
Summary
Retrieves a collection of Order objects based on search criteria.
Request (IAdBookConnect_GetOrderListByIDList_InputMessage)

The request body is of type http://www.FatTail.com/api:GetOrderListByIDList.

Request Body Parameters

NameDescriptionData Type
Order search parameters.OrderSearchListParameters

Overview

Sequence
Sequence
AgencyIDList optional ArrayOflong Complex Type
Sequence
long 0..∞ xs:long
ClientIDList optional ArrayOflong Complex Type
Sequence
long 0..∞ xs:long
EndDate optional xs:dateTime
Limit optional xs:int
Sequence
DynamicPropertyID optional xs:long
Values optional ArrayOflong Complex Type
Sequence
long 0..∞ xs:long
Offset optional xs:int
OrderStatusIDList optional ArrayOflong Complex Type
Sequence
long 0..∞ xs:long
SortByCampaignName optional xs:boolean
StartDate optional xs:dateTime
200 Response (IAdBookConnect_GetOrderListByIDList_OutputMessage)

The response body is of type http://www.FatTail.com/api:GetOrderListByIDListResponse.

Response Body Parameters

NameDescriptionData Type
A collection of Orders that match the search criteria. PaginatedOrders

Overview

Sequence
Sequence
TotalOrderCount optional xs:int
Orders optional ArrayOfOrder Complex Type
Sequence
Sequence
AgencyCommission optional xs:int

Agency commission to use when calculating net and gross price and cost for orders that are billed to an agency.

Starting from version 36, please refer to Appendix D for additional details and changes regarding commission handling.

AgencyContactID optional xs:long
Agency contact ID for use when assigning an agency contact to an order.
AgencyID optional xs:long
Agency ID assigned to the order.
BillTo BillTo Simple Type
Indicates whether the client or agency will be billed for the order.
BillTypeName BillType Simple Type
Indicates if price/cost should be displayed as net or gross values.
BillingComments optional xs:string
This is a free form text field to save notes on an order.
BillingContactID optional xs:long
The contact ID for the client or agency who takes care of billing issues.
BillingModel BillingModel Simple Type
Default revenue calculation method for all drops on the order.
ClientContactID optional xs:long
System ID of the client contact associated with the order.
ClientID xs:long
ID of the client the order is created for.
CurrencyID xs:long
ID associated with a currency.
EstimateNumber optional xs:string
Publisher specified estimate number.
ExternalID optional xs:string
Third party system ID used to map external entities to AdBook orders.
InvoiceNumber optional xs:string
User defined value used for mapping to invoicing system.
MaterialsContactID optional xs:long
Contact ID for the materials contact at the client/agency assigned to an order.
OrderConfigurationID optional xs:long
System ID for the configuration used to define the fields and validation rules for the order.
OrderID optional xs:long
System ID of the order.
OrderName xs:string
Text descriptor for the order.
OrderRepList ArrayOfOrderRep Complex Type
Collection of OrderRep objects for the order.
Sequence
Sequence
RepContactId xs:long
System ID of the order rep.
RepSplit optional xs:double
Percentage of the order commission for the rep.
RepTypeId xs:long
System ID for the configured rep group.
OrderStatusID xs:long
System ID for the order status.
PONumber optional xs:string
User defined text field for PO identifier.
RateCardNameID optional xs:long
System ID of the configured rate card name being used as the default on an order.
ThirdPartyAdServerID optional xs:long
System ID for the default ThirdPartyAdServer to use for drops on the order.
OrderDynamicProperties optional ArrayOfDynamicPropertyValue Complex Type
Collection of values for custom fields configured at the order level for your organization.
Sequence
Sequence
DynamicPropertyID optional xs:long
AdBook system ID for the DynamicProperty.
Value optional xs:string
Value being assigned to the dynamic property.  The format of the value depends on the type specified in the DynamicProperty definition.
IONumber optional xs:string
User defined text for IO number.
OrderNotes optional xs:string
User notes associated with the order.
InternalOrderNotes optional xs:string
Notes that are not included on the PDF version of the order.
OrderManagerRepTypeIdList optional ArrayOflong Complex Type
Collection of RepTypeIDs when access to the order is restricted by campaign managers.
Sequence
long 0..∞ xs:long
StartDate optional xs:dateTime
The start date for the Order, based on the minimum start date of the Drops on the order.
EndDate optional xs:dateTime
The end date for the Order, based on the maximum start date of the Drops on the order.
ReadonlyProperties optional ArrayOfReadonlyPropertyValue Complex Type
Sequence
Sequence
PropertyName optional xs:string
Value optional xs:string
Fault Responses
FaultDescription
This fault returns a response body of type http://www.FatTail.com/api:IAdBookConnect_GetOrderListByIDList_DataAccessFaultFault_FaultMessage.  
See Also
All Operations Resource GroupAdBookConnect Web Service