Updated on
Delivers the PPL datasets of the stated program that correspond with the consigned
filter criteria, as well as the ID of the newly-created export history entry.


<GetPpl xmlns="">
    <pplfilter xmlns="">
        <period from="2004-12-01T00:00:00+02:00"
        <reviewstate negate="1">0</reviewstate>
        <categoryid negate="1">TestKat</categoryid>


Object Data type Description Mandatory?
<programid> int ID of the program whose
data will be retrieved
<pplfilter>   Filter criteria, which will be
applied during the export
<period>   Export period x
from datetime Most recent time stamp of the
to datetime Oldest time stamp of the dataset x
<reviewstate> datetime Review status of the dataset  
negate boolean
Criterion <reviewstate> should
• 0 = not be negated
• 1 = be negated
<categoryid> normalizedstring Order ID of the dataset  
negate boolean Criterion <orderid> should
• 0 = not be negated
• 1 = be negated



If the value of the "negate" attribute of the <reviewstate> or <categoryid> element is 1, all datasets that do not correspond with the condition will be exported.


If the lock wait time has not yet expired and the user wishes to carry out a new data export,
the request will be terminated with an error (refer to <locktime> element in GetUserPrograms).

Object Data type Description
<historyid> int History ID that was created for the export process


Otherwise, zanox ERP Web Services delivers the following data:

<GetPplResponse xmlns="">
        <ppl id="1a913cde-1b27-40cd-a9fe-99dfb7351882" trackingtype="4" cookie_id="0" xmlns="">
            <click timestamp="2004-06-18 12:20:58"/>
            <request timestamp="2004-06-18 12:16:28"/>
            <program id="10"/>
            <order id="1396525"/>
            <customer id="285796"/>
            <category id="Ihre-Kategorie"/>
            <session id="Sess01"/>
            <expiration date="2005-02-12 12:00:12"/>
            <affiliate code="829057C1355136413S66656">
                <commission currency="EUR">0.66</commission>
            <subaffiliate id="21">
                <commission currency="EUR">0.20</commission>
            <review state="0" date="2005-01-02 21:22:00">ReviewText</review>
            <commission fix="0.20"/>


Object Data type Description
id normalizedstring Unique ID of the PPL dataset (GUID)
trackingtype unsignedbyte Tracking type for which the dataset was tracked
timestamp datetime Time stamp of the click
timestamp datetime Time stamp of the request
id int ID of the program to which the dataset pertains
id normalizedstring Order ID
id normalizedstring Customer ID
id normalizedstring Category ID
id normalizedstring Session ID
date datetime Expiration date
code normalizedstring
Complete partner ID in xxxCxxxSxxx format
("Sxxx" is optional)
<commission> decimal Publisher commission
currency normalizedstring Currency of the publisher commission
<username> normalizedstring User's login name
<website> normalizedstring User's homepage
id normalizedstring Sub-affiliate ID
<commission> decimal Sub-affiliate commission
currency normalizedstring Currency of the sub-affiliate commission
<review> string Review text
state int
Review status
• 0 = open
• 1 = approved
• 2 = rejected
date datetime Review date
fix decimal Fixed commission in the program currency


Resource Information

Rate Limited? No
Requests per rate limit window N/A
Authentication Requires Authentication
Response Formats xml
Resource family ppldata
Response Object ppl
API Version


If the value for <historyid>  is '0', no data have been exported. For instance, this might happen because the filter has been set too restrictively).