Order Report Model

h2. Understanding the Order Report Model

{color:#333333}In our terminology, an{color}{color:#333333} {color}{color:#333333}{*}orde{*}{color}{color:#333333}{*}r{*}{color} {color:#333333}{*}report{*}{color} {color:#333333}contains a list of all fulfillment state modifications on order items{color} {color:#333333}from time x to time y{color} {color:#333333}that belong to a specific partner. Thus, the fulfillment state change information from the order report together with the{color} {color:#333333}[fulfillment states and the state transitions explained for the order resources in our developer wiki|http://developer.spreadshirt.net/display/API/Order+Resources#OrderResources-FulfillmentStates]{color}{color:#333333}, can be used to trigger actions based on fulfillment state transitions on the partner-side, such as sending a shipping confirmation e-mail to the customer. An order report has right now the following characteristics:{color}
* {color:#333333}{*}Core Data:*{color} {color:#333333}Each order report has a state, i.e. ACTIVATED or DELETED, and a created and modified date.{color}
* {color:#333333}{*}Order Item Modifications:*{color} {color:#333333}Each order report contains a list of order item modifications. An order item modification denotes the modification of the fulfillment state of an order's order item. It therefore contains a link to the actual order and order item. It also contains the new fulfillment state, e.g. CREATED, ACCEPTED or SHIPPED, and a modified date.{color}
* {color:#333333}{*}Correlation:*{color} {color:#333333}In case the partner provided correlation information on order creation, the order item modifications will contain the same correlation information. They allow the partner to easily connect the fulfillment state modifications on the order items on the Spreadshirt platform with order items of his e-commerce or ERP system.{color}

h2. Retrieving Order Reports

The order reports generated for a partner, such as partner 1102730, can in general be received by conducting a HTTP GET call on the order reports resource [http://api.spreadshirt.net/api/v1/orderReports?query=+partnerId\:(1102730) \+state:(ACTIVATED)|http://api.spreadshirt.net/api/v1/orderReports?query=+partnerId:(1102730) \+state:(ACTIVATED)]. A single order report can be fetched, by conducting a HTTP GET call on an order report resource, such as [http://api.spreadshirt.net/api/v1/orderReports/123]. The [order report resources|http://developer.spreadshirt.net/display/API/Order+Resources#OrderResources-RetrieveOrderReportList] are described in detail in our developer wiki. A sample order report XML would look as follows:


{code}
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<orderReport xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns="http://api.spreadshirt.net"
id="123" href="http://api.spreadshirt.net/api/v1/orderReports/123">
<orderItemModifications>
<orderItemModification>
<order id="123" xlink:href="http://api.spreadshirt.net/api/v1/orders/123"/>
<orderItem id="456"/>
<correlation>
<partner>
<orderItemId>extshop-0000000001</orderItemId>
</partner>
</correlation>
<fulfillmentState>RECEIVED</fulfillmentState>
<modified>2011-08-03 08:14:00Z</modified> <!-- we use UTC as timezone -->
</orderItemModification>
<orderItemModification>
<order id="123" xlink:href="http://api.spreadshirt.net/api/v1/orders/123"/>
<orderItem id="456"/>
<correlation>
<partner>
<orderItemId>extshop-0000000001</orderItemId>
</partner>
</correlation>
<fulfillmentState>CREATED</fulfillmentState>
<modified>2011-08-03 08:15:00Z</modified> <!-- we use UTC as timezone -->
</orderItemModification>
<orderItemModification>
<order id="123" xlink:href="http://api.spreadshirt.net/api/v1/orders/123"/>
<orderItem id="456"/>
<correlation>
<partner>
<orderItemId>extshop-0000000001</orderItemId>
</partner>
</correlation>
<fulfillmentState>ACCEPTED</fulfillmentState>
<modified>2011-08-03 08:30:00Z</modified> <!-- we use UTC as timezone -->
</orderItemModification>
<orderItemModification>
<order id="123" xlink:href="http://api.spreadshirt.net/api/v1/orders/123"/>
<orderItem id="456"/>
<correlation>
<partner>
<orderItemId>extshop-0000000001</orderItemId>
</partner>
</correlation>
<fulfillmentState>IN_PROGRESS</fulfillmentState>
<modified>2011-08-03 12:00:00Z</modified> <!-- we use UTC as timezone -->
</orderItemModification>
<orderItemModification>
<order id="123" xlink:href="http://api.spreadshirt.net/api/v1/orders/123"/>
<orderItem id="456"/>
<correlation>
<partner>
<orderItemId>extshop-0000000001</orderItemId>
</partner>
</correlation>
<fulfillmentState>SHIPPED</fulfillmentState>
<modified>2011-08-03 17:00:00Z</modified> <!-- we use UTC as timezone -->
</orderItemModification>
</orderItemModifications>
<state>ACTIVATED</state>
<created>2011-08-20 20:00:00</created>
<modified>2011-08-20 20:00:00</modified>
</orderReport>
{code}