Escolar Documentos
Profissional Documentos
Cultura Documentos
API Reference
May 2008
AdSoftware
14074 Trade Center Drive
Suite 252
Fishers, Indiana 46038
T 317.313.5200
info@adsoftware.com
www.adsoftware.com
Contents
Introduction ....................................................................................................................... 4
Definitions.......................................................................................................................... 5
API Support ....................................................................................................................... 6
API Structure ..................................................................................................................... 7
XML prototype ............................................................................................................ 8
Tags Description ........................................................................................................ 8
API Signatures................................................................................................................. 10
Successful response ................................................................................................ 10
Un-successful/Failed response ................................................................................ 10
Contracts Module.......................................................................................................... 11
Create Contract(s) .................................................................................................... 11
Update Contract(s) ................................................................................................... 13
Delete Contract(s) .................................................................................................... 15
Duplicate Contract(s)................................................................................................ 15
Add Contract Folder(s) ............................................................................................. 16
Update Contract IO(s) .............................................................................................. 16
Delete Contract IO(s) ............................................................................................... 16
Add Campaign(s) ..................................................................................................... 18
Update Campaign(s) ................................................................................................ 19
Delete Campaign(s) ................................................................................................. 20
Duplicate Campaign(s) ............................................................................................. 20
Add Line Item(s) ....................................................................................................... 21
Update Line Item(s) .................................................................................................. 23
Delete Line Item(s) ................................................................................................... 25
Duplicate Line Item(s) .............................................................................................. 26
Add Contract Note(s)................................................................................................ 26
Update Contract Note(s) .......................................................................................... 27
Delete Contract Note(s)............................................................................................ 27
Add Contract Document(s) ....................................................................................... 28
Update Contract Document(s).................................................................................. 28
Delete Contract Document(s) ................................................................................... 29
Add Contact(s) ......................................................................................................... 30
Update Contact(s) .................................................................................................... 32
Delete Contact(s) ..................................................................................................... 34
Add Contract Contact(s) ........................................................................................... 34
Update Contract Contact(s)...................................................................................... 35
Delete Contract Contact(s) ....................................................................................... 35
Get Contract Billing Detail(s) .................................................................................... 36
Document Library Module ............................................................................................ 37
Create Folder(s) ....................................................................................................... 37
Update Folder(s) ...................................................................................................... 38
Get Folder Location .................................................................................................. 38
Create Document(s) ................................................................................................. 39
Update Document(s) ................................................................................................ 40
Delete Document(s) ................................................................................................. 40
Download Document(s) ............................................................................................ 41
Download Documents From Folder ......................................................................... 41
Get Document Location............................................................................................ 42
Update Contract Folder(s) ........................................................................................ 42
Delete Contract Folder(s) ......................................................................................... 43
Page 2
Add Contract IO(s) ................................................................................................... 43
Reporting Module ......................................................................................................... 45
Create Report Folder(s) ........................................................................................... 45
Update Report Folder(s)........................................................................................... 45
Delete Report Folder(s) ............................................................................................ 46
Download Report Document(s) ................................................................................ 46
Administration Module .................................................................................................. 47
Add User Group(s) ................................................................................................... 47
Update User Group(s) .............................................................................................. 48
Delete User Group(s) ............................................................................................... 49
Add User(s) .............................................................................................................. 49
Update User(s) ......................................................................................................... 51
Delete User(s) .......................................................................................................... 53
Duplicate User(s) ...................................................................................................... 53
Error Codes ..................................................................................................................... 54
Folder Module Messages ......................................................................................... 54
Document Module Messages ................................................................................... 54
Authorization Messages ........................................................................................... 55
API Module validation Message ............................................................................... 57
Contract Module Messages...................................................................................... 58
Contract Campaign Module Messages .................................................................... 59
Contract Line Item Module Messages...................................................................... 60
Contract IO Module Messages ................................................................................. 60
Contract Note Module Messages ............................................................................. 61
Contract Document Module Messages .................................................................... 61
Contact Module Messages ....................................................................................... 62
Contract Contact Module Messages ........................................................................ 62
User Group Module Messages................................................................................. 63
User Module Messages............................................................................................ 63
Notes ........................................................................................................................ 63
Page 3
Introduction
Ad Software ADS delivers the next-generation of Ad Performance Management (APM) solutions
and represents the most comprehensive on-demand application available to the online advertising
community. The foundation of ADS is based on unmatched ad server integration and end-to-end
support of key operational and strategic processes such as proposal/contract and inventory
management, reporting and analysis, planning and forecast automation and open data exchange
based on the Ad Software API.
The Ad Software ADS suite is defined by separate unique solutions called Ad Management, Ad
Intelligence, Ad Planning and Ad Tracking. Each can be leveraged individually with the ADS Core
Services as fully featured enterprise-class solutions or combined to provide the most complete, fully
integrated application for online publishers, agencies, advertisers and networks.
Page 4
Definitions
Terms Definition
Add Add an item to Ad Software. All fields required in the UI that are available via
the API are required in your AdsXML.
Edit Change an item detail in AdSoftware. Only the data points you pass in your
AdXML are updated. Other data points are not modified. Primary key is
required for performing operation via the API in your AdsXML.
Duplicate Duplicate and item to Ad Software. Primary key required to duplicate the data
in the database via the API in your AdsXML.
Delete Delete an item from Ad software. Primary key or composite key is required to
perform delete operation via the API in your AdsXML.
List Returns a List of items in Ad Software. Only the most important details are
returned. Certain search criteria may be added to the request to narrow the
results returned.
Download Download an item from Ad Software. This will fetch document detail from the
database. Document detail will be base64 encoded. So please decode it
before generating the physical document.
Location Get the location of an item in Ad software. This function will return possible
storage path of the item based on item name supplied. Certain search criteria
may be added to the request to narrow the results returned.
Page 5
API Support
Category Add Edit Duplicate Delete List Download Location
Folders X X X
Documents X X X X X
Contracts X X X X
Contract Folders X X X
Contract IOs X X X
Contract Campaign X X X X
Contract Notes X X X
Contract Documents X X X
Contract Contacts X X X
Contract Billing X
Contacts X X X
Users X X X X
User Groups X X X
Report Folders X X X
Reports X
Page 6
API Structure
The following is a typical PHP code to consume the Contract Management API for creating a folder
using Web Service (PHP based client application to consume the Ad Software Contract
Management API library). This is a sample code for demonstration and will give an idea about how
exactly to call the web service in PHP in order to make use of the API developed.
<?php
$client = new SoapClient($API_PATH."adxapi/?wsdl",
array('exceptions' => 0,'trace' =>1));
/**
* Call the server functions...
* following is perform specified operation in the xml
**/
$RequestXML = <AdsXML>
<Request type='Contract'>
<Contract action = 'create'>
<Data>
<FolderId></FolderId>
<ContractName></ContractName>
<UserId></UserId>
<AdServerId></AdServerId>
<AccountId></AccountId>
<AdvertiserHold></AdvertiserHold>
<AgencyId></AgencyId>
<AgencyHold></AgencyHold>
<IndustrySegmentId></IndustrySegmentId>
<AdManagerId></AdManagerId>
<TeamId></TeamId>
<Version></Version>
<TypeId></TypeId>
<CategoryId></CategoryId>
<LeadSourceId></LeadSourceId>
<StageId></StageId>
<NextStepId></NextStepId>
<ClientPO></ClientPO>
<StartDate></StartDate>
<EndDate></EndDate>
<IONumber></IONumber>
<MediaId></MediaId>
<Status></Status>
<GrossAmount></GrossAmount>
<ContractDiscount></ContractDiscount>
<ContractDiscountPercent></ContractDiscountPercent>
<AgencyDiscount></AgencyDiscount>
<AgencyDiscountPercent></AgencyDiscountPercent>
<ProbabilityId></ProbabilityId>
<TermsId></TermsId>
<Notes></Notes>
</Data>
</Contract>
</Request>
</AdsXML>";
// Call the function to send xml request and receive xml response
$response = $client->DocXMLRequest("admin","admin",$RequestXML);
?>
The above is a simple 3 line code to create a folder through API calls. In the first step, we create
the web service client by making a SoapClient call. Then we form an input XML for creating a new
contract (all the tags are explained below). And lastly, we make a call to the web service by passing
username, password and the Input XMl. The web service will process the request and based on the
Page 7
result it will return an XML response back to the client (success or failure with respective error
codes).
The above process will remain same for consuming all the web services listed below. Just the
$RequestXML will vary according to the service call being made. Every valid and standard input
XML for each web service is listed below starting with describing the basic input XML request
structure.
XML prototype
Here is an Input XML prototype for Contract Management API Call:
<AdsXML>
<Request type='Contract'>
<Contract action = 'create'>
<Data>
…
…
…
</Data>
</Contract>
</Request>
</AdsXML>
Tags Description
Node Attribute Description
AdsXml NA Required node to decide start of a valid xml. If this node edist in the
input xml then only xmal will be consider as a valid xmal and
operations defined in the xml will be performed
Request Type Defines the name of the module of Ad software on which operations
will be performed.
Contract Action Defines which operation will be performed on module dala for
example: create, update, delete, download, list, location
(Type of
Request)
Data Main node of the Api. Tages inside the data node will be considered
as a input parameters for specified operation. If you want to perform
multiple create, update, delete, download, list, location then repeat
the data node.
The “type” attribute in the Request node can hold only one of two value: ”Contract”. Based on the
“type” value, the service api treats the call.
The Web Service API call is standard for all the Contract management functionality supported by
API. The API call handler function serves the call based on the input XML inside <Data> tag
Page 8
passed to the called function. Before any call is served, the input is validated for basic error
handling and then passed to the respective request handling methods to serve the request.
Based on the Input, the Server API will process the call and then will return the success or failed
response. The Successful or Failed response from the server will look like below:
Page 9
API Signatures
Successful response
This message will be returned whenever transaction is completed successfully that means data are
inserted/update or deleted properly in the database.
<AdsXML>
<Response>
<Message>name1 Message</ Message >
<Message>name2 Message </ Message >
</Response>
</AdsXML>
Un-successful/Failed response
This message will be returned whenever transaction Failed.
<AdsXML>
<Response>
<Exception errorCode = "err_code">document_name1 Error Message</Exception>
<Exception errorCode = "err_code">document_name1 Error Message</Exception>
</Response>
</AdsXML>
Page 10
Contracts Module
Create Contract(s)
This is the sample xml format to send input to the API for inserting contract in the database. For
inserting multiple records in the database please repeat data node in the input XML.
<AdsXML>
<Request type='Contract'>
<Contract action = 'add'>
<Data>
<FolderId></FolderId>
<ContractName></ContractName>
<UserId></UserId>
<AdServerId></AdServerId>
<AccountId></AccountId>
<AdvertiserHold></AdvertiserHold>
<AgencyId></AgencyId>
<AgencyHold></AgencyHold>
<IndustrySegmentId></IndustrySegmentId>
<AdManagerId></AdManagerId>
<TeamId></TeamId>
<Version></Version>
<TypeId></TypeId>
<CategoryId></CategoryId>
<LeadSourceId></LeadSourceId>
<StageId></StageId>
<NextStepId></NextStepId>
<ClientPO></ClientPO>
<StartDate></StartDate>
<EndDate></EndDate>
<IONumber></IONumber>
<MediaId></MediaId>
<Status></Status>
<GrossAmount></GrossAmount>
<ContractDiscount></ContractDiscount>
<ContractDiscountPercent></ContractDiscountPercent>
<AgencyDiscount></AgencyDiscount>
<AgencyDiscountPercent></AgencyDiscountPercent>
<ProbabilityId></ProbabilityId>
<TermsId></TermsId>
<Notes></Notes>
</Data>
</Contract>
</Request>
</AdsXML>
Field Description
Tag Description
FolderId Id of the folder. This is the foraign key stores the reference of the
folder
AccountId Id of the advertiser account (Foreign key for this table referencing
Advertiser).
Page 11
Tag Description
AgencyId Hold the Id of the agency (Foreign key for this table referencing
Agency).
IndustrySegmentId Holds the value of Id of the Industry segment(Foreign key for this
table referencing Industry segments)
AdManagerId Id of the Ad soft manager for this contract(Foreign key for this table
referencing users)
TeamId Id of the team (Foreign Key for this table referencing Teams)
TypeId Holds the id of the type of contract (Foreign key for this table
referencing contract types)
CategoryId Id of the category of contract (Foreign key for this table referencing
category)
ContractDiscountPercent Holds the value of discount on the contract in the percentage format
AgencyDiscountPercent Holds the value of discount on the contract given by agency in the
percentage format
Page 12
Tag Description
Update Contract(s)
This is the sample xml format to send input to the API for Updating contract detail in the database.
For updating multiple records in the database please repeat data node in the input XML.
<AdsXML>
<Request type='Contract'>
<Contract action = 'update'>
<Data>
<ContractId></ContractId>
<FolderId></FolderId>
<ContractName></ContractName>
<UserId></UserId>
<AdServerId></AdServerId>
<AccountId></AccountId>
<AdvertiserHold></AdvertiserHold>
<AgencyId></AgencyId>
<AgencyHold></AgencyHold>
<IndustrySegmentId></IndustrySegmentId>
<AdManagerId></AdManagerId>
<TeamId></TeamId>
<Version></Version>
<TypeId></TypeId>
<CategoryId></CategoryId>
<LeadSourceId></LeadSourceId>
<StageId></StageId>
<NextStepId></NextStepId>
<ClientPO></ClientPO>
<StartDate></StartDate>
<EndDate></EndDate>
<IONumber></IONumber>
<MediaId></MediaId>
<Status></Status>
<GrossAmount></GrossAmount>
<ContractDiscount></ContractDiscount>
<ContractDiscountPercent></ContractDiscountPercent>
<AgencyDiscount></AgencyDiscount>
<AgencyDiscountPercent></AgencyDiscountPercent>
<ProbabilityId></ProbabilityId>
<TermsId></TermsId>
<Notes></Notes>
</Data>
</Contract>
</Request>
</AdsXML>
Field Description
Tag Description
FolderId Id of the folder. This is the foraign key stores the reference of the
folder
AccountId Id of the advertiser account (Foreign key for this table referencing
Page 13
Tag Description
Advertiser).
AgencyId Hold the Id of the agency (Foreign key for this table referencing
Agency).
IndustrySegmentId Holds the value of Id of the Industry segment(Foreign key for this
table referencing Industry segments)
AdManagerId Id of the Ad soft manager for this contract(Foreign key for this table
referencing users)
TeamId Id of the team (Foreign Key for this table referencing Teams)
TypeId Holds the id of the type of contract (Foreign key for this table
referencing contract types)
CategoryId Id of the category of contract (Foreign key for this table referencing
category)
ContractDiscountPercent Holds the value of discount on the contract in the percentage format
AgencyDiscountPercent Holds the value of discount on the contract given by agency in the
percentage format
Page 14
Tag Description
Delete Contract(s)
This is the sample xml format to send input to the API for Deleting contract detail from the
database. To delete multiple records from the database please repeat data node in the input XML.
<AdsXML>
<Request type='Contract'>
<Contract action = 'delete'>
<Data>
<ContractId></ContractId>
</Data>
</Contract>
</Request>
</AdsXML>
Field Description
Tag Description
Duplicate Contract(s)
This is the sample xml format to send input to the API for Duplicating contract detail in the
database. To duplicate multiple records in the database please repeat data node in the input XML.
<AdsXML>
<Request type='Contract'>
<Contract action = 'duplicate'>
<Data>
<ContractId></ContractId>
</Data>
</Contract>
</Request>
</AdsXML>
Field Description
Tag Description
Page 15
Add Contract Folder(s)
This is the sample xml format to send input to the API for creating contract folder in the database.
To create multiple records in the database please repeat data node in the input XML.
<AdsXML>
<Request type='ContractFolder'>
<ContractFolder action = 'create'>
<Data>
<FolderName> </FolderName>
< Description ></Description>
</Data>
</ContractFolder>
</Request>
</AdsXML>
Field Description
Tag Description
<AdsXML>
<Request type='ContractIO'>
<ContractIO action = ‘update’>
<Data>
<ContractIOId></ContractIOId>
<ContractIOName></ContractIOName>
<Description></Description>
</Data>
</ContractIO>
</Request>
</AdsXML>
Field Description
Tag Description
<AdsXML>
<Request type='ContractIO'>
<ContractIO action = ‘delete’>
<Data>
<ContractIOId></ContractIOId>
</Data>
Page 16
</ContractIO>
</Request>
</AdsXML>
Field Description
Tag Description
Page 17
Add Campaign(s)
This is the sample xml format to send input to the API for creating campaign(s) in the database. To
create multiple records in the database please repeat data node in the input XML.
<AdsXML>
<Request type=’Campaign'>
<Campaign action = ‘create’>
<Data>
<ContractId></ContractId>
<ContractIOId></ContractIOId>
<ContractCampaignName></ContractCampaignName>
<StartDate></StartDate>
<EndDate></EndDate>
<GrossValue></GrossValue>
<AgencyDiscountPercent></AgencyDiscountPercent>
<AgencyDiscount></AgencyDiscount>
<ContractDiscountPercent></ContractDiscountPercent>
<ContractDiscount></ContractDiscount>
<OtherDiscount></OtherDiscount>
<NetValue></NetValue>
<Status></Status>
</Data>
</Campaign>
</Request>
</AdsXML>
Field Description
Tag Description
Page 18
Update Campaign(s)
This is the sample xml format to send input to the API for updating campaigns in the database. To
update multiple records in the database please repeat data node in the input XML.
<AdsXML>
<Request type=’Campaign’>
<Campaign action = ‘update’>
<Data>
<CampaignId></CampaignId>
<ContractId></ContractId>
<ContractIOId></ContractIOId>
<ContractCampaignName></ContractCampaignName>
<StartDate></StartDate>
<EndDate></EndDate>
<GrossValue></GrossValue>
<AgencyDiscountPercent></AgencyDiscountPercent>
<AgencyDiscount></AgencyDiscount>
<ContractDiscountPercent></ContractDiscountPercent>
<ContractDiscount></ContractDiscount>
<OtherDiscount></OtherDiscount>
<NetValue></NetValue>
<Status></Status>
</Data>
</Campaign>
</Request>
</AdsXML>
Field Description
Tag Description
Page 19
Delete Campaign(s)
This is the sample xml format to send input to the API for deleting campaigns from the database.
To delete multiple records from the database please repeat data node in the input XML.
<AdsXML>
<Request type='Campaign'>
<Campaign action = ‘delete’>
<Data>
<CampaignId></CampaignId>
</Data>
</Campaign>
</Request>
</AdsXML>
Field Description
Tag Description
CampaignId Id of the campaign which you want to delete, Primary key of the table.
Duplicate Campaign(s)
This is the sample xml format to send input to the API for duplicating campaigns in the database.
To duplicate multiple records from the database please repeat data node in the input XML.
<AdsXML>
<Request type='Campaign'>
<Campaign action = ‘duplicate’>
<Data>
<CampaignId></CampaignId>
</Data>
</Campaign>
</Request>
</AdsXML>
Field Description
Tag Description
CampaignId Id of the campaign which you want to duplicate, Primary key of the table.
Page 20
Add Line Item(s)
This is the sample xml format to send input to the API for creating line item(s) in the database. To
create multiple records in the database please repeat data node in the input XML.
<AdsXML>
<Request type=’LineItem'>
<LineItem action = ‘create’>
<Data>
<ContractId></ContractId>
<ContractLineItemName></ContractLineItemName>
<ContractCampaignId></ContractCampaignId>
<ContractIOId></ContractIOId>
<BuyTypeId></BuyTypeId>
<ProductId></ProductId>
<StartDate></StartDate>
<EndDate></EndDate>
<ModelId></ModelId>
<Quantity></Quantity>
<Clicks></Clicks>
<GrossUnit></GrossUnit>
<GrossValue ></GrossValue>
<AgencyDiscountPercent></AgencyDiscountPercent>
<AgencyDiscount></AgencyDiscount>
<ContractDiscountPercent></ContractDiscountPercent>
<ContractDiscount></ContractDiscount>
<OtherDiscount></OtherDiscount>
<NetValue></NetValue>
<Status></Status>
<AdServerId></AdServerId>
<LineItemBillOnId></LineItemBillOnId>
<LineItemTypeId></LineItemTypeId>
<LineItemAdTypeId></LineItemAdTypeId>
<Tags></Tags> /** Add comma separated tags **/
<Keywords></Keywords> /** Add Comma separated traffic keyword ids**/
<ExcludedPageIds></ExcludedPageIds> > /** Add Comma separated traffic
page ids**/
<PageIds></PageIds>/** Add Comma separated traffic page ids**/
<PageGroupIds></PageGroupIds> /**Add Comma separated traffic page group
ids**/
<SiteIds></SiteIds> /**Add Comma separated traffic site ids**/
<SectionIds></SectionIds> /**Add Comma separated traffic section ids**/
</Data>
</Campaign>
</Request>
</AdsXML>
Field Description
Tag Description
BuyTypeId Id of the buy type (Foreign key of the table referencing buy type)
Page 21
Tag Description
ModelId Holds the id of cost model. (Foreign key for the table, holds the
reference of cost models)
AgencyDiscountPercent Holds the value of discount offered by agency in percentage for a line
item
AgencyDiscount Holds the value of discount offered by agency for a line item
ContractDiscountPercent Holds the value of discount offered because of the contract of a line
item in percentage
ContractDiscount Holds the value of discount offered because of the contract of a line
item
AdServerId Holds the value of Id of the adserver( Foregin key for this table
referencing adservers)
Tags Holds the value of tags for line items, add comma separated
tags(string) for the line item
Keywords Holds the value of keywords for line item, add comma separated
keyword ids(Integer) for the line item
ExcludedPageIds Holds the value of excluded page ids for line item, add comma
separated traffic page ids(Integer) for the line item
PageIds Holds the value of page ids for line item, add comma separated traffic
page ids(Integer) for the line item
Page 22
Tag Description
PageGroupIds Holds the value of page group ids for line item, add comma separated
traffic page group ids (Integer) for the line item
SiteIds Holds the value of site ids for line item, add comma separated traffic
site ids (Integer) for the line item
SectionIds Holds the value of section ids for line item, add comma separated
traffic section ids(integer) for line item
<AdsXML>
<Request type=’LineItem’>
<LineItem action = ‘update’>
<Data>
<LineItemId></LineItemId>
<ContractId></ContractId>
<ContractLineItemName></ContractLineItemName>
<ContractCampaignId></ContractCampaignId>
<ContractIOId></ContractIOId>
<BuyTypeId></BuyTypeId>
<ProductId></ProductId>
<StartDate></StartDate>
<EndDate></EndDate>
<ModelId></ModelId>
<Quantity></Quantity>
<Clicks></Clicks>
<GrossUnit></GrossUnit>
<GrossValue></GrossValue>
<AgencyDiscountPercent></AgencyDiscountPercent>
<AgencyDiscount></AgencyDiscount>
<ContractDiscountPercent></ContractDiscountPercent>
<ContractDiscount></ContractDiscount>
<OtherDiscount></OtherDiscount>
<NetValue></NetValue>
<Created></Created>
<Modified></Modified>
<CreatedBy></CreatedBy>
<Status></Status>
<AdServerId></AdServerId>
<LineItemBillOnId></LineItemBillOnId>
<LineItemTypeId></LineItemTypeId>
<LineItemAdTypeId></LineItemAdTypeId>
<Tags></Tags> /** Add comma separated tags **/
<Keywords></Keywords> /** Add Comma separated traffic keyword ids**/
<ExcludedPageIds></ExcludedPageIds> > /** Add Comma separated traffic
page ids**/
<PageIds></PageIds>/** Add Comma separated traffic page ids**/
<PageGroupIds></PageGroupIds> /**Add Comma separated traffic page group
ids**/
<SiteIds></SiteIds> /**Add Comma separated traffic site ids**/
<SectionIds></SectionIds> /**Add Comma separated traffic section ids**/
</Data>
</LineItem>
</Request>
</AdsXML>
Page 23
Field Description
Tag Description
LineItemId Id of the line item which you want to change(Primary key for the table)
BuyTypeId Id of the buy type (Foreign key of the table referencing buy type)
ModelId Holds the id of cost model. (Foreign key for the table, holds the
reference of cost models)
AgencyDiscountPercent Holds the value of discount offered by agency in percentage for a line
item
AgencyDiscount Holds the value of discount offered by agency for a line item
ContractDiscountPercent Holds the value of discount offered because of the contract of a line
item in percentage
ContractDiscount Holds the value of discount offered because of the contract of a line
item
AdServerId Holds the value of Id of the adserver( Foreign key for this table
referencing adservers)
Page 24
Tag Description
Tags Holds the value of tags for line items, add comma separated
tags(string) for the line item
Keywords Holds the value of keywords for line item, add comma separated
keyword ids(Integer) for the line item
ExcludedPageIds Holds the value of excluded page ids for line item, add comma
separated traffic page ids(Integer) for the line item
PageIds Holds the value of page ids for line item, add comma separated traffic
page ids(Integer) for the line item
PageGroupIds Holds the value of page group ids for line item, add comma separated
traffic page group ids (Integer) for the line item
SiteIds Holds the value of site ids for line item, add comma separated traffic
site ids (Integer) for the line item
SectionIds Holds the value of section ids for line item, add comma separated
traffic section ids(integer) for line item
<AdsXML>
<Request type='LineItem'>
<LineItem action = ‘delete’>
<Data>
<LineItemId></LineItemId>
</Data>
</LineItem>
</Request>
</AdsXML>
Field Description
Tag Description
LineItemId Id of the line item which you want to delete (Primary key for the table)
Page 25
Duplicate Line Item(s)
This is the sample xml format to send input to the API for duplicating line items in the database. To
duplicate multiple records from the database please repeat data node in the input XML.
<AdsXML>
<Request type='LineItem'>
<LineItem action = ‘duplicate’>
<Data>
<LineItemId></LineItemId>
</Data>
</LineItem>
</Request>
</AdsXML>
Field Description
Tag Description
LineItemId Id of the line item which you want to duplicate (Primary key for the table)
<AdsXML>
<Request type='ContractNotes'>
<ContractNotes action = 'create'>
<Data>
<ContractId>43</ContractId>
<NoteName>Test Note</NoteName>
<NoteTypeId>1</NoteTypeId>
<Description>This is my first note for testing</Description>
</Data>
</ContractNotes>
</Request>
</AdsXML>
Field Description
Tag Description
ContractId Holds the value of Id of the contract ( Foreign key for this table, referencing
contracts)
Page 26
Update Contract Note(s)
This is the sample xml format to send input to the API for updating contract notes in the database.
To update multiple records from the database please repeat data node in the input XML.
<AdsXML>
<Request type='ContractNotes'>
<ContractNotes action = 'update'>
<Data>
<NoteId>1</NoteId>
<NoteName>Test Note</NoteName>
<NoteTypeId>1</NoteTypeId>
<Description>This is my first note for testing</Description>
</Data>
</ContractNotes>
</Request>
</AdsXML>
Field Description
Tag Description
NoteId Holds the value of Id of the note which you want to change (Primary key of
the table)
ContractId Holds the value of Id of the contract ( Foreign key for this table, referencing
contracts)
<AdsXML>
<Request type='ContractNotes'>
<ContractNotes action = 'delete'>
<Data>
<NoteId>1</NoteId>
</Data>
</ContractNotes>
</Request>
</AdsXML>
Field Description
Tag Description
NoteId Holds the value of Id of the note which you want to delete (Primary key of the
table)
Page 27
Add Contract Document(s)
This is the sample xml format to send input to the API for adding contract documents in the
database. To add multiple records from the database please repeat data node in the input XML.
<AdsXML>
<Request type='ContractDocument'>
<ContractDocument action = 'create'>
<Data>
<ContractId>43</ContractId>
<DocumentName>New Document</DocumentName>
<Description>test</Description>
<FileName>test.doc</FileName>
<FileBlob>Sample Data</FilePath>
<ContractArea>Contacts</ContractArea>
<ItemId>12</ItemId>
</Data>
</ContractDocument>
</Request>
</AdsXML>
Field Description
Tag Description
ContractId Holds the value of id of the contract (Foreign key for this table referencing
contracts)
ContractArea Holds the value of the contract area for which we want to upload the
document. Options are Flights, Contacts, Billing Period, Tasks, Attachments,
Creatives.
<AdsXML>
<Request type='ContractDocument'>
<ContractDocument action = 'update'>
<Data>
<ContractId>43</ContractId>
<DocumentId>3</DocumentId>
<DocumentName>Testghgh</DocumentName>
<Description>test</Description>
<FileName>test.doc</FileName>
<FileBlob>Sample Data</FileBlob>
<ContractArea>Contacts</ContractArea>
<ItemId>12</ItemId>
</Data>
</ContractDocument>
</Request>
</AdsXML>
Page 28
Field Description
Tag Description
DocumentId Holds the value of id of the document (Foreign key for this table referencing
documents)
ContractId Holds the value of id of the contract (Foreign key for this table referencing
contracts)
ContractArea Holds the value of the contract area for which we want to upload the
document. Options are Flights, Contacts, Billing Period, Tasks, Attachments,
Creatives.
<AdsXML>
<Request type='ContractDocument'>
<ContractDocument action = 'delete'>
<Data>
<ContractId>43</ContractId>
<DocumentId>3</DocumentId>
</Data>
</ContractDocument>
</Request>
</AdsXML>
Field Description
Tag Description
DocumentId Holds the value of id of the document (Foreign key for this table referencing
documents)
ContractId Holds the value of id of the contract (Foreign key for this table referencing
contracts)
Page 29
Add Contact(s)
This is the sample xml format to send input to the API for adding contacts in the database. To add
multiple records from the database please repeat data node in the input XML.
<AdsXML>
<Request type='Contact'>
<Contact action = 'create'>
<Data>
<ReportsTo></ReportsTo>
<ContactTypeId>1</ContactTypeId>
<OrganizationId>1</OrganizationId>
<ContactFirstName>Hemita</ContactFirstName>
<ContactLastName>Thakkar</ContactLastName>
<ContactTitle>PHP</ContactTitle>
<Email>hemita@gmail.com</Email>
<Phone></Phone>
<Fax></Fax>
<Mobile></Mobile>
<Address1></Address1>
<Address2></Address2>
<City></City>
<StateId></StateId>
<ZipCode></ZipCode>
<CountryId></CountryId>
<BillingContact></BillingContact>
<BillingEmail></BillingEmail>
<BillingPhone></BillingPhone>
<BillingFax></BillingFax>
<BillingAddress1></BillingAddress1>
<BillingAddress2></BillingAddress2>
<BillingCity></BillingCity>
<BillingStateId></BillingStateId>
<BillingZipCode></BillingZipCode>
<BillingCountryId></BillingCountryId>
<Notes></Notes>
</Data>
</Contact>
</Request>
</AdsXML>
Field Description
Tag Description
ReportsTo Holds the value of reporting person id (Foreign key will be ContactId – self
referencing)
ContactTypeId Holds the value of id of the contact type(Foreign key for this table referencing
contact types)
OrganizationId Holds the value of id of the organization(Foreign key for this table referencing
organizations)
Page 30
Tag Description
Address1 Holds the value of the first address line of the contact
Address2 Holds the value of the second address line of the contact
BillingFax Holds the value of the fax number of the contact for billing
BillingAddress1 Holds the value of the first address line of the contact for billing address
BillingAddress2 Holds the value of the second address line of the contact for billing address
BillingCity Holds the value of the name of the city of contact for billing address
BillingStateId Holds the value of id of the state of contact for billing address
BillingZipCode Holds the value of zip code of the contact for billing address
BillingCountryId Holds the value of id of the country of contact for billing address
Page 31
Update Contact(s)
This is the sample xml format to send input to the API for updating contacts in the database. To
update multiple records from the database please repeat data node in the input XML.
<AdsXML>
<Request type='Contact'>
<Contact action = 'update'>
<Data>
<ContactId>1</ContactId>
<ReportsTo></ReportsTo>
<ContactTypeId>1</ContactTypeId>
<OrganizationId>1</OrganizationId>
<ContactFirstName>Hemita1</ContactFirstName>
<ContactLastName>Thakkar</ContactLastName>
<ContactTitle>PHP</ContactTitle>
<Email>hemita@gmail.com</Email>
<Phone></Phone>
<Fax></Fax>
<Mobile></Mobile>
<Address1></Address1>
<Address2></Address2>
<City></City>
<StateId></StateId>
<ZipCode></ZipCode>
<CountryId></CountryId>
<BillingContact></BillingContact>
<BillingEmail></BillingEmail>
<BillingPhone></BillingPhone>
<BillingFax></BillingFax>
<BillingAddress1></BillingAddress1>
<BillingAddress2></BillingAddress2>
<BillingCity></BillingCity>
<BillingStateId></BillingStateId>
<BillingZipCode></BillingZipCode>
<BillingCountryId></BillingCountryId>
<Notes>My test for add contact</Notes>
</Data>
</Contact>
</Request>
</AdsXML>
Field Description
Tag Description
ContactId Holds the value of id of the contact which you want to change (Primary key
for this table)
ReportsTo Holds the value of reporting person id (Foreign key will be ContactId – self
referencing)
ContactTypeId Holds the value of id of the contact type(Foreign key for this table referencing
contact types)
OrganizationId Holds the value of id of the organization(Foreign key for this table referencing
organizations)
Page 32
Tag Description
Address1 Holds the value of the first address line of the contact
Address2 Holds the value of the second address line of the contact
BillingFax Holds the value of the fax number of the contact for billing
BillingAddress1 Holds the value of the first address line of the contact for billing address
BillingAddress2 Holds the value of the second address line of the contact for billing address
BillingCity Holds the value of the name of the city of contact for billing address
BillingStateId Holds the value of id of the state of contact for billing address
BillingZipCode Holds the value of zip code of the contact for billing address
BillingCountryId Holds the value of id of the country of contact for billing address
Page 33
Delete Contact(s)
This is the sample xml format to send input to the API for deleting contacts in the database. To
delete multiple records from the database please repeat data node in the input XML.
<AdsXML>
<Request type='Contact'>
<Contact action = 'delete'>
<Data>
<ContactId>1</ContactId>
</Data>
</Contact>
</Request>
</AdsXML>
Field Description
Tag Description
ContactId Holds the value of id of the contact which you want to delete (Primary key for
this table)
<AdsXML>
<Request type='ContractContact'>
<ContractContact action = 'create'>
<Data>
<ContractId>43</ContractId>
<ContactId>3</ContactId>
<Commission>34.50</Commission>
<PrimaryAE>1</PrimaryAE>
<GetCommission>1</GetCommission>
</Data>
</ContractContact>
</Request>
</AdsXML>
Field Description
Tag Description
ContractId Holds the value of id of the contract (Foreign key for this table erferencing
contracts)
ContactId Holds the value of id of the contact (Foreign key for this table erferencing
contacts)
GetCommission Boolean flag to hold the value of wheter the user will get commission or not.
Page 34
Update Contract Contact(s)
This is the sample xml format to send input to the API for updating contract contacts in the
database. To update multiple records from the database please repeat data node in the input XML.
<AdsXML>
<Request type='ContractContact'>
<ContractContact action = 'update'>
<Data>
<ContractContactId>2</ContractContactId>
<Commission>50</Commission>
<PrimaryAE>1</PrimaryAE>
<GetCommission>1</GetCommission>
</Data>
</ContractContact>
</Request>
</AdsXML>
Field Description
Tag Description
ContractContactId Holds the value of id of Contract Contact which you want to change (Primary
key of the table)
GetCommission Boolean flag to hold the value of wheter the user will get commission or not.
<AdsXML>
<Request type='ContractContact'>
<ContractContact action = 'delete'>
<Data>
<ContractContactId>2</ContractContactId>
</Data>
</ContractContact>
</Request>
</AdsXML>
Field Description
Tag Description
ContractContactId Holds the value of id of Contract Contact which you want to delete (Primary
key of the table)
Page 35
Get Contract Billing Detail(s)
This is the sample xml format to send input to the API for generating contract billing report. To get
contract billing detail for multiple contract from the database please repeat data node in the input
XML.
<AdsXML>
<Request type='ContractBilling'>
<ContractBilling action = 'get'>
<Data>
<ContractId>3</ContractId>
</Data>
</ContractBilling>
</Request>
</AdsXML>
Field Description
Tag Description
ContractId Hold the value of id of the contract (Foreign key for this table referencing
contracts)
Page 36
Document Library Module
Create Folder(s)
This is the sample xml format to send input to the API for inserting folders in the database. For
inserting multiple records in the database please repeat data node in the input XML.
<AdsXML>
<Request type='Folder'>
<Folder action = 'create'>
<Data>
<ParentId>3</ParentId>
<FolderName>hemita</FolderName>
<Description></Description>
</Data>
<Data>
<ParentId>3</ParentId>
<FolderName>V2Soln</FolderName>
<Description></Description>
</Data>
</Folder>
</Request>
</AdsXML>
Field Description
Tag Description
Parentid Id of the parent folder. Id of the folder inside which you want to create new
folder. If you don’t pass the parent id then folder will be created under root
folder.
Page 37
Update Folder(s)
This is the sample xml format to send input to the API for updating folder detail in the database. For
updating multiple records in the database please repeat data node in the input XML.
<AdsXML>
<Request type='Folder'>
<Folder action = 'update'>
<Data>
<FolderId>13</FolderId>
<FolderName>V2Solution</FolderName>
<Description></Description>
</Data>
</Folder>
</Request>
</AdsXML>
Field Description
Tag Description
FolderId Id of the folder for which you want to change the detail (Primary key of the
table)
<AdsXML>
<Request type='Folder'>
<Folder action = 'location'>
<Data>
<FolderName></FolderName>
<Date></Date>
</Data>
</Folder>
</Request>
</AdsXML>
Field Description
Tag Description
Page 38
Create Document(s)
This is the sample xml format to send input to the API for inserting document in the database. For
inserting multiple records in the database please repeat data node in the input XML.
<AdsXML>
<Request type='Document'>
<Document action = 'create'>
<Data>
<DocumentName>Testfffff</DocumentName>
<Description>test</Description>
<FileName>test.doc</FileName>
<FileBlob>Sample document contents</FileBlob>
<FolderId></FolderId>
</Data>
<Data>
<DocumentName>Test2</DocumentName>
<Description></Description>
<FileName></FileName>
<FileBlob></FileBlob>
<FolderId></FolderId>
</Data>
</Document>
</Request>
</AdsXML>
Field Description
Tag Description
FolderId Id of the folder under which you want to store the document.
Page 39
Update Document(s)
This is the sample xml format to send input to the API for updating document in the database. For
updating multiple records in the database please repeat data node in the input XML.
<AdsXML>
<Request type='Document'>
<Document action = 'update'>
<Data>
<DocumentId>9</DocumentId>
<DocumentName>Test3489</DocumentName>
<FileName>test.doc</FileName>
<FilePath>sample data</FilePath>
<Description>Test</Description>
</Data>
</Document>
</Request>
</AdsXML>
Field Description
Tag Description
Delete Document(s)
This is the sample xml format to send input to the API for deleting document from the database. For
deleting multiple records from the database please repeat data node in the input XML.
<AdsXML>
<Request type='Document'>
<Document action = 'delete'>
<Data>
<DocumentId>9</DocumentId>
</Data>
</Document>
</Request>
</AdsXML>
Field Description
Tag Description
Page 40
Download Document(s)
This is the sample xml format to send input to the API for downloading document from the
database. For downloading multiple records from the database please repeat data node in the input
XML.
<AdsXML>
<Request type='Document'>
<Document action = 'download'>
<Data>
<DocumentId>9</DocumentId>
</Data>
</Document>
</Request>
</AdsXML>
Field Description
Tag Description
<AdsXML>
<Request type='Document'>
<Document action = 'download_from_folder'>
<Data>
<FolderId>2</FolderId>
</Data>
</Document>
</Request>
</AdsXML>
Field Description
Tag Description
FolderId Id of the folder. From which you want to download all the douments
Page 41
Get Document Location
This is the sample xml to send input to the API for getting location of the document based on
document name and creation or updating date
<AdsXML>
<Request type='Document'>
<Document action = 'location'>
<Data>
<DocumentName></DocumentName>
<Date></Date>
</Data>
</Document>
</Request>
</AdsXML>
Field Description
Tag Description
<AdsXML>
<Request type='ContractFolder'>
<ContractFolder action = 'update'>
<Data>
<FolderId></FolderId>
<FolderName></FolderName>
<Description></Description>
</Data>
</ContractFolder>
</Request>
</AdsXML>
Field Description
Tag Description
Page 42
Delete Contract Folder(s)
This is the sample xml format to send input to the API for deleting contract Folder from the
database. To delete multiple records from the database please repeat data node in the input XML.
<AdsXML>
<Request type='ContractIO'>
<ContractIO action = ‘update’>
<Data>
<FolderId></FolderId>
</Data>
</ContractIO>
</Request>
</AdsXML>
Field Description
Tag Description
<AdsXML>
<Request type='ContractIO'>
<ContractIO action = ‘create’>
<Data>
<ContractId></ContractId>
<ContractIOName></ContractIOName>
<Description></Description>
</Data>
</ContractIO>
</Request>
</AdsXML>
Field Description
Tag Description
Page 43
Page 44
Reporting Module
Create Report Folder(s)
This is the sample xml format to send input to the API for adding report folder in the database. To
add multiple records from the database please repeat data node in the input XML.
<AdsXML>
<Request type='ReportFolder'>
<ReportFolder action = 'create'>
<Data>
<FolderName>hemita1</FolderName>
<Description></Description>
<ParentId>2</ParentId>
</Data>
</ReportFolder>
</Request>
</AdsXML>
Field Description
Tag Description
Parentid Id of the parent folder. Id of the folder inside which you want to create new
folder. If you don’t pass the parent id then folder will be created under root
folder.
<AdsXML>
<Request type='ReportFolder'>
<ReportFolder action = ‘update’>
<Data>
<FolderId>1</FolderId>
<FolderName>hemita1</FolderName>
<Description></Description>
</Data>
</ReportFolder>
</Request>
</AdsXML>
Field Description
Tag Description
FolderId Id of the folder which you want to change. (Primary key of the table)
Page 45
Delete Report Folder(s)
This is the sample xml format to send input to the API for deleting document folder from the
database. To delete multiple records from the database please repeat data node in the input XML.
<AdsXML>
<Request type='ReportFolder'>
<ReportFolder action = 'delete'>
<Data>
<FolderId>227</FolderId>
</Data>
</ReportFolder>
</Request>
</AdsXML>
Field Description
Tag Description
FolderId Id of the folder which you want to delete. (Primary key of the table)
<AdsXML>
<Request type='Reports'>
<Reports action = 'download'>
<Data>
<ReportId>1</ReportId>
</Data>
</Reports>
</Request>
</AdsXML>
Field Description
Tag Description
Page 46
Administration Module
Add User Group(s)
This is the sample xml format to send input to the API for adding user groups in the database. To
add multiple records from the database please repeat data node in the input XML.
<AdsXML>
<Request type='UserGroup'>
<UserGroup action = 'create'>
<Data>
<UserGroupName>Test Group 15</UserGroupName>
<UserGroupType>C</UserGroupType>
<Description>Description Description Description</Description>
<Status>Y</Status>
<Members>
<MemberId>1</MemberId>
<MemberId>2</MemberId>
<MemberId>3</MemberId>
</Members>
</Data>
<Data>
<UserGroupName>Test Group 16</UserGroupName>
<UserGroupType>S</UserGroupType>
<Description>Description 2 Description 2 Description 2</Description>
<Status>N</Status>
<Members>
<MemberId>4</MemberId>
<MemberId>5</MemberId>
<MemberId>6</MemberId>
</Members>
</Data>
</UserGroup>
</Request>
</AdsXML>
Field Description
Tag Description
MemberId Holds the id of the members of the group (Foreign key for this table
referencing users)
Page 47
Update User Group(s)
This is the sample xml format to send input to the API for updating user groups in the database. To
update multiple records from the database please repeat data node in the input XML.
<AdsXML>
<Request type='UserGroup'>
<UserGroup action = 'update'>
<Data>
<UserGroupId>3</UserGroupId>
<UserGroupName>Test Group 1-3</UserGroupName>
<UserGroupType>C</UserGroupType>
<Description>Description Description Description</Description>
<Status>Y</Status>
<Members>
<MemberId>111</MemberId>
<MemberId>222</MemberId>
<MemberId>333</MemberId>
</Members>
</Data>
<Data>
<UserGroupId>4</UserGroupId>
<UserGroupName>Test Group 1-4</UserGroupName>
<UserGroupType>S</UserGroupType>
<Description>Description 2 Description 2 Description 2</Description>
<Status>N</Status>
<Members>
<MemberId>444</MemberId>
<MemberId>555</MemberId>
<MemberId>666</MemberId>
</Members>
</Data>
</UserGroup>
</Request>
</AdsXML>
Field Description
Tag Description
UserGroupId Holds the value of id of the user group which you want to change (Primary
key for this table)
MemberId Holds the id of the members of the group (Foreign key for this table
referencing users)
Page 48
Delete User Group(s)
This is the sample xml format to send input to the API for deleting user groups in the database. To
delete multiple records from the database please repeat data node in the input XML.
<AdsXML>
<Request type='UserGroup'>
<UserGroup action = 'delete'>
<Data>
<UserGroupId>17</UserGroupId>
</Data>
<Data>
<UserGroupId>18</UserGroupId>
</Data>
</UserGroup>
</Request>
</AdsXML>
Field Description
Tag Description
UserGroupId Holds the value of id of the user group which you want to delete (Primary key
for this table)
Add User(s)
This is the sample xml format to send input to the API for adding users in the database. To add
multiple records from the database please repeat data node in the input XML.
<AdsXML>
<Request type='Users'>
<Users action = 'create'>
<Data>
<FirstName>Hemita</FirstName>
<LastName>Thakkar</LastName>
<LoginUserName>Hemita</LoginUserName>
<LoginPassword>test</LoginPassword>
<Title>erouit</Title>
<Email>test@test.com</Email>
<OrganizationId>1</OrganizationId>
<GroupId>1</GroupId>
<Phone>14957347</Phone>
<Fax>4095609586</Fax>
<Mobile>685068906</Mobile>
<Address1>jsghklf</Address1>
<Address2>fkldgjk</Address2>
<City>fjkgh</City>
<StateId>1</StateId>
<ZipCode>12345</ZipCode>
<CountryId></CountryId>
<Notes></Notes>
<TimeZone></TimeZone>
<TimeZoneIndex></TimeZoneIndex>
<Status></Status>
<UserRole></UserRole>
<TotalStorageId></TotalStorageId>
<UsedStorage></UsedStorage>
<EmailFormatId></EmailFormatId>
<FaildAttempts></FaildAttempts>
<LoginDate></LoginDate>
<LastFaildAttempts></LastFaildAttempts>
<LastLogin></LastLogin>
<PasswordPolicyId></PasswordPolicyId>
<SessionPolicyId></SessionPolicyId>
</Data>
</Users>
</Request>
</AdsXML>
Page 49
Field Description
Tag Description
OrganizationId Holds the value of id of organization (Foreign key for this table referencing
organizations)
GroupId Holds the value of id of group of the user (Foreign key for this table
referencing user groups)
Page 50
Tag Description
Update User(s)
This is the sample xml format to send input to the API for updating users in the database. To
update multiple records from the database please repeat data node in the input XML.
<AdsXML>
<Request type='Users'>
<Users action = 'update'>
<Data>
<UserId>1</UserId>
<FirstName>Hemita</FirstName>
<LastName>Thakkar</LastName>
<Title>SPA</Title>
<Email>hemita@test.com</Email>
<OrganizationId>1</OrganizationId>
<GroupId>1</GroupId>
<Phone>14957347</Phone>
<Fax>4095609586</Fax>
<Mobile>685068906</Mobile>
<Address1>jsghklf</Address1>
<Address2>fkldgjk</Address2>
<City>fjkgh</City>
<StateId>1</StateId>
<ZipCode>12345</ZipCode>
<CountryId>1</CountryId>
<Notes>Test</Notes>
<TimeZone>1</TimeZone>
<TimeZoneIndex>1</TimeZoneIndex>
<Status>1</Status>
<UserRole>U</UserRole>
<TotalStorageId>1233</TotalStorageId>
<UsedStorage>23</UsedStorage>
<EmailFormatId>Text</EmailFormatId>
<FaildAttempts></FaildAttempts>
<LoginDate></LoginDate>
<LastFaildAttempts></LastFaildAttempts>
<LastLogin></LastLogin>
<PasswordPolicyId></PasswordPolicyId>
<SessionPolicyId></SessionPolicyId>
</Data>
</Users>
</Request>
</AdsXML>
Field Description
Tag Description
UserId Holds the value of id of the user , which you want to change (Primary key of
the table)
Page 51
Tag Description
OrganizationId Holds the value of id of organization (Foreign key for this table referencing
organizations)
GroupId Holds the value of id of group of the user (Foreign key for this table
referencing user groups)
FaildAttempts Holds the value of failed attempts for login. Maximum value is 5
LastFaildAttempts Holds the value of last failed attempt for login by user.
Page 52
Tag Description
Delete User(s)
This is the sample xml format to send input to the API for deleting users from the database. To
delete multiple records from the database please repeat data node in the input XML.
<AdsXML>
<Request type='Users'>
<Users action = 'delete'>
<Data>
<UserId>1</UserId>
</Data>
</Users>
</Request>
</AdsXML>
Field Description
Tag Description
UserId Holds the value of id of the user , which you want to delete (Primary key of
the table)
Duplicate User(s)
This is the sample xml format to send input to the API for duplicating users detail in the database.
To duplicate multiple records in the database please repeat data node in the input XML.
<AdsXML>
<Request type='Users'>
<Users action = 'duplicate'>
<Data>
<UserId>1</UserId>
</Data>
</Users>
</Request>
</AdsXML>
Field Description
Tag Description
UserId Holds the value of id of the user , which you want to duplicate (Primary key of
the table)
Page 53
Error Codes
Following are the error codes integrated with ADX API.
Page 54
Authorization Messages
Error Code Message
401 You are not authorized to view folder location. Please register with the site
first.
402 You are not authorized to create folder. Please register with the site first.
403 You are not authorized to update folder. Please register with the site first.
411 You are not authorized to view document location. Please register with the site
first.
412 You are not authorized to create document. Please register with the site first.
413 You are not authorized to update document. Please register with the site first.
414 You are not authorized to download document. Please register with the site
first.
415 You are not authorized to download document. Please register with the site
first.
416 You are not authorized to create contract. Please register with the site first.
417 You are not authorized to update contract. Please register with the site first.
418 You are not authorized to delete contract. Please register with the site first.
419 You are not authorized to duplicate contract. Please register with the site first.
420 You are not authorized to create contract campaign. Please register with the
site first.
421 You are not authorized to update contract campaign. Please register with the
site first.
422 You are not authorized to delete contract campaign. Please register with the
site first.
423 You are not authorized to duplicate contract campaign. Please register with
the site first.
424 You are not authorized to create contract line item. Please register with the
site first.
425 You are not authorized to update contract line item. Please register with the
site first.
426 You are not authorized to delete contract line item. Please register with the site
first.
Page 55
Error Code Message
427 You are not authorized to duplicate contract line item. Please register with the
site first.
428 You are not authorized to create a contract. Please register with the site first.
429 You are not authorized to update a contract. Please register with the site first.
430 You are not authorized to delete a contract. Please register with the site first.
431 You are not authorized to create contract notes. Please register with the site
first.
432 You are not authorized to update contract notes. Please register with the site
first.
433 You are not authorized to delete contract notes. Please register with the site
first.
434 You are not authorized to create contract documents. Please register with the
site first.
435 You are not authorized to update contract documents. Please register with the
site first.
436 You are not authorized to delete contract documents. Please register with the
site first.
437 You are not authorized to create contacts. Please register with the site first.
438 You are not authorized to update contacts. Please register with the site first.
439 You are not authorized to delete contacts. Please register with the site first.
440 You are not authorized to create contract contacts. Please register with the
site first.
441 You are not authorized to update contract contacts. Please register with the
site first.
442 You are not authorized to delete contract contacts. Please register with the site
first.
443 You are not authorized to View contract Billing detail. Please register with the
site first.
444 You are not authorized to create user group. Please register with the site first.
445 You are not authorized to update user group. Please register with the site first.
446 You are not authorized to delete user group. Please register with the site first.
Page 56
Error Code Message
447 You are not authorized to create user. Please register with the site first.
448 You are not authorized to update user. Please register with the site first.
449 You are not authorized to delete user. Please register with the site first.
450 You are not authorized to duplicate user. Please register with the site first.
451 You are not authorized to delete report folders. Please register with the site
first.
452 You are not authorized to download reports. Please register with the site first.
Page 57
Contract Module Messages
Error Code Message
Page 58
Error Code Message
703 Contract Campaign Name length exceeded the maximum possible length
707 Agency Discount Percent length exceeded the maximum possible length
709 Contract Discount Percent length exceeded the maximum possible length
Page 59
Contract Line Item Module Messages
Error Code Message
Page 60
Error Code Message
1002 Contract note Name length exceeded the maximum possible length
1104 Contract Document Name length exceeded the maximum possible length
Page 61
Contact Module Messages
Error Code Message
Page 62
User Group Module Messages
Error Code Message
Notes
1. The package shared contains the “samples” folder(path: “adxapi/ws/samples”). In that
folder, we have created sample test scripts for all the web service listed above. Please
have a look at them.
2. Add multiple Data nodes for adding multiple rows in the table
4. Repeat action attribute if you want to perform multiple operations on the same table.
Page 63