# 2026-03-20: Returns Service - calculated price properties for returns

## Overview

The `Return` object has been extended with new calculated price properties that provide a detailed net, gross, and tax breakdown derived from the order entry's `calculatedPrice.finalPrice`.

The following new properties have been introduced:

* **`calculatedUnitPrice`** on return items — unit price derived from the order entry's `calculatedPrice.finalPrice` divided by the order entry amount. Includes discounts and fees.
* **`calculatedPrice`** on return items — total calculated price for the returned quantity of the item, computed as `calculatedUnitPrice` multiplied by the returned quantity.
* **`calculatedPrice`** on the return level — aggregated calculated price across all returned items.

Each calculated price object contains `netValue`, `grossValue`, `taxValue`, `taxCode`, and `taxRate` fields.

## Updated endpoints

| Endpoint                                                                                                                                                     | Description                                                                                                            |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------- |
| [Retrieving a list of returns](https://developer.emporix.io/api-references/api-guides/orders/returns/api-reference/returns#get-return-tenant-returns)        | New properties `calculatedUnitPrice` and `calculatedPrice` on return items, and `calculatedPrice` on the return level. |
| [Retrieving a single return](https://developer.emporix.io/api-references/api-guides/orders/returns/api-reference/returns#get-return-tenant-returns-returnid) | New properties `calculatedUnitPrice` and `calculatedPrice` on return items, and `calculatedPrice` on the return level. |

## Known problems

There are no known problems.