# Order History Tracker

### Overview

This tracker systematically records and tracks details of redemption transactions for a custom catalog. Use this tracker to get detailed insights about each order, such as the date of purchase, product descriptions, quantity, and any other relevant information for the catalog. The purpose of tracker is to provide a centralized and organized repository of all purchasing activities, enabling admins to monitor redemption trends, track inventory levels, and generate reports for auditing purposes. This tracker proves particularly valuable for inventory management, budgeting, and overall operational efficiency, as it offers a historical perspective on redemption activities and assists in making informed decisions related to future custom rewards provisions. 

Click the 3-dot menu within the Module view for any catalog to create or connect a **New Order History Tracker**.

***

### Creating a New Order History Tracker

Within the New Order History Tracker setup wizard, fill in the name, team, and description for the tracker.

<figure><img src="/files/HnYhd1vDwvPwe9jj6Ymc" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
We recommend adding this tracker to the same workspace as it's parent tracker.
{% endhint %}

Once satisfied, click **Create**.&#x20;

You will then be redirected to the **Connect Order History Tracker** menu, which will auto-fill your newly created tracker information. Click **Save**.

***

### **Order History Tracker**

After creation, this tracker will automatically begin to populate with all redemption orders placed upon time of the tracker creation for the selected Data Source.

<figure><img src="/files/FrRykZ8tcAmSNb7UNg5I" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="danger" %} <mark style="color:red;">The tracker will</mark> <mark style="color:red;"></mark><mark style="color:red;">**not**</mark> <mark style="color:red;"></mark><mark style="color:red;">log any redemption activity from before it was created. If you wish to include data from previous redemptions, you will need to import the entries from the</mark> <mark style="color:red;"></mark><mark style="color:red;">**Order & User History**</mark> <mark style="color:red;"></mark><mark style="color:red;">export download.</mark>
{% endhint %}

If created from the Admin Portal, this tracker will have the following columns auto-generated: ID, Order ID, Order Date, Value in Points, Item Name, Item Color, Item Size, Data Source, Shipping Address, Submitted By, Submitted By ID, and On Behalf Of.

***

### Recommended Workflow

#### Item has Shipped - Inform Workflow

This workflow serves to inform the redeeming user that their redemption item has been shipped and is on the way.

For this workflow, we will add the column **Status** to our tracker with the dropdown options **Awaiting fulfillment** and **Shipped**.&#x20;

<figure><img src="/files/6lFws0wunyd87JNgIiaG" alt="" width="563"><figcaption></figcaption></figure>

Our workflow will trigger when an entry is changed in the **Status** column from **Awaiting fulfillment** to **Shipped**. When this condition is met, a message will be sent to the redemption request submitter. We have also created a custom action message informing the submitter that their item has been shipped to keep an eye out for updates.

***

#### Item needs to be shipped - Inform Workflow

This workflow serves to inform the responsible user that a new item has been redeemed and is in need of fulfillment.

For this workflow, we will add the column **Status** to our tracker with the dropdown options **Awaiting fulfillment** and **Shipped**.&#x20;

<figure><img src="/files/Q2veyEWFB5e2hRyeCn16" alt="" width="563"><figcaption></figcaption></figure>

Our workflow will activate whenever a new entry is added. Once this condition is satisfied, a notification will be dispatched to the designated user responsible for handling redemption requests. Additionally, we've implemented a custom action message to alert the selected user about an item awaiting fulfillment.

***

{% hint style="info" %}
For more information on creating trackers and workflows, click [here](https://guides.mangoapps.com/user-guide/trackers).
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guides.mangoapps.com/admin-guide/module-settings/recognition/data-sources/add-data-source/order-history-tracker.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.