GET /reports/sales/date/{date}

Updated on
 
Return a list of SaleItems for a given date.  See saleItem element definition in WSDL/XSD
This resource requires connectid, nonce, date and signature for authentication. See Authentication documentation for REST and SOAP. Passing authentication information as query parameters for REST is supported.

Notes

  • If you would like to see which sales had their status changed on a certain date - i.e. were approved, confirmed or rejected - set datetype=modified_date.

Resource URL

XML:  https://api.zanox.com/xml/2011-03-01/reports/sales/date/{date}
JSON:  https://api.zanox.com/json/2011-03-01/reports/sales/date/{date}

Parameters

date
required

URL path parameter. Request sales for this date.

Value Type: Date in format YYYY-MM-DD
Example Value: 2013-01-31

datetype
optional

Request sales according to when they were tracked ("tracking_date"), when they were last modified in any way ("modified_date") or when the review state was changed ("review_state_changed_date"). Default is tracking_date.

Note that the above values only apply to REST requests. For SOAP requests, the possible values are clickDatetrackingDate, modifiedDate, and 
reviewStateChangedDate.

Value Type: String
Example Values 

program
optional

Limits results to those that are associated with a particular program.

Value Type: String
Example Values 

adspace
optional

Limits results to those that are associated with a particular Adspace.

Value Type: String
Example Values:  

items
optional

number of items in the result set [1..n]

Value Type: integer
Example Values 1 (default = 10; maximum = 50) 

page
optional

page position [0..n] 

Value Type: integer
Example Values 1 (default: 0)

state
optional

Limits results to sales having one of the following review states:

Value Type: String
Example Values "confirmed", "open", "approved", "rejected"

Example Request

REST authentication information must be included in request headers or added as query parameters

Get details of all sales on August 5th, 2012: https://api.zanox.com/xml/2011-03-01/reports/sales/date/2012-08-05

Example Response

<GetSalesResponse xmlns="http://api.zanox.com/namespace/2011-03-01/">
    <page>0</page>
    <items>1</items>
    <total>1</total>
    <saleItems>
        <saleItem id="19ac662c-c460-4f09-b001-abcdedg">
            <reviewState>confirmed</reviewState>
            <trackingDate>2012-08-05T18:27:09.373+02:00</trackingDate>
            <modifiedDate>2012-08-20T10:04:18.417+02:00</modifiedDate>
            <clickDate>2012-08-05T18:22:48.977+02:00</clickDate>
            <adspace id="12345">AdSpace name</adspace>
            <admedium id="654321">Affiliate link name</admedium>
            <program id="1234">Advertiser program</program>
            <clickId>17995036542191361</clickId>
            <clickInId>0</clickInId>
            <amount>10.00</amount>
            <commission>1.00</commission>
            <currency>EUR</currency>
            <gpps>
                <gpp id="zpar0">1227247</gpp>
                <gpp id="zpar1">ABCHDE</gpp>
                <gpp id="zpar2">102.01</gpp>
                <gpp id="zpar3">TopBannerA</gpp>
            </gpps>
            <reviewNote>confirmed</reviewNote>
            <trackingCategory id="98765">Tracking category name</trackingCategory>
        </saleItem>
    </saleItems>
</GetSalesResponse>

 

Resource Information

Rate Limited? No
Authentication Requires signature. See
REST Authentication
SOAP Authentication
Response Formats json, xml
HTTP Methods GET
Resource family Sales
Response Object saleItems
API Version 2011-03-01