Transaction counts and returns¶

Customer Transaction Count is calculated as a distinct count of Transaction IDs. Standard transaction item sub-types are “Shipped” and “Returned”. Additional sub-types such as “Demand” or “Canceled” must be added only if there are clear use cases for these sub-types. Ideally “Shipped” and “Returned” lines of the same purchase must have the same Transaction ID. If so, all the transaction lines linked to the same Transaction ID are counted under the same transaction. Otherwise, they create different transactions and increase the transaction count separately.

Base scenario - a customer makes a purchase on January 1, 2023, and spends $125¶

The following conditions apply to the base scenario:

1. Customer makes a transaction on January 1, 2023 and purchases two products, T-Shirt and Short.
2. The product number for T-Shirt is AF93 and the product number for Short is AC04.
3. Customer purchases 2 T-Shirts (AF93) for $100 and 1 Short (AC04) for $25.
4. Customer spends $125 in total.

Scenario #1 with full return¶

In this scenario, the customer returns all products that were added into the original transactions on January 5, 2023. Client order system links all returns to the original transaction.

Scenario #2 with partial return¶

In this scenario, the customer returns 1 T-Shirt (ABC) and 1 Short on January 5, 2023, and keeps 1 T-Shirt. Client order system links all returns to the original transaction.

Scenario #3 with partial return¶

In this scenario, the customer returns 1 T-Shirt (ABC) and 1 Short January 5, 2023, and keeps 1 T-Shirt. Client order system creates a separate transaction for returns.

Scenario #4 with product and order discounts, and a product return¶

In this scenario, all products are shipped on Day 1, one product has a discount of $10, the whole order has a $5 discount, and one product is returned on Day2.

The transaction feed does not need to be updated, since neither the customer nor the date of the initial transaction changed. However, the transaction item needs to reflect those changes. Note that those changes will be represented incrementally and only the new/updated lines will be shown. You can provide either the increment as shown in each case or provide a full history every time, but you should follow the same conventions.

The transaction-level discount will be spread evenly between the two items in the transaction in this example, but you can spread discounts based on the relative price of each item, or other means.

Feed: TransactionItem

Day 1

Day 2

Transactions including “Demand” and “Cancel” Transaction Item data sub-types¶

As a reminder, standard Transaction Item sub-types are “Shipped” and “Returned”. Additional sub-types like “Demand” or “Canceled” should be added only if there are clear use cases for these sub-types.

Storing “Demand” and “Cancel” transaction sub-types may introduce the risk of double-counting data from “Demand” and “Shipped” lines. The best way to avoid double-counting is to consider “Shipped” and “Returned” for the summary measures.

Scenario #5 with partial order cancelation¶

In this scenario, an order is placed on Day 0, one product is canceled on Day 1, and one product is shipped on Day 2.

The transaction feed does not need to be updated, since neither the customer nor the date of the initial transaction changed. However, the transaction item needs to reflect those changes. Note that those changes will be represented incrementally and only the new/updated lines will be shown. You can provide either the increment as shown in each case, or provide a full history every time, but you should follow the same conventions.

Feed: TransactionItem

Day 0

Day 1

Day 2