> For the complete documentation index, see [llms.txt](https://docs.akinon.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.akinon.com/tutorials/seller-center/marketplace-owner/seller-penalty-system.md).

# Seller Penalty System

The seller penalty system charges a penalty to a seller when an order item is canceled or returned in Seller Center with a cancellation reason that has a penalty rule. The penalty is added to the seller's open reconciliation period as a penalty record and is included in the reconciliation's commission total in Omnitron.

This document explains when a penalty is created, how it is calculated, how it is reflected in reconciliation, how to define a penalty rule, and which scenarios can be set up with the current system.

Penalties work according to the following rules:

* **Trigger** – A penalty is created only when an order item is canceled or returned through Seller Center. The system processes returns as cancellations as well. Other events, such as delays, do not create penalties.
* **Rule** – A penalty rule is tied to a cancellation reason. The same reason applies the same rule to all sellers; there are no seller-specific rules.
* **Calculation** – A penalty is calculated either as a fixed amount or as a percentage of the item price.
* **Reporting** – Seller Center has no report or export for penalty records. In Omnitron, penalty records can be listed and exported as CSV/Excel.

{% hint style="info" %}
Only the marketplace administrator can define or change penalty rules. Sellers cannot change rules.

* **If you are going to define a penalty rule:** Read the entire document. Before entering a rule, pay special attention to the **When Is a Penalty Created?** and **What Happens Without an Open Reconciliation Period?** sections.
* **If you are answering a seller's question:** Read the **When Is a Penalty Created?**, **Where Do Sellers See Penalties?**, and **FAQ** sections.
  {% endhint %}

## <mark style="color:red;">**Key Concepts**</mark>

* **Cancellation Reason** – The reason selected when an item is canceled (e.g., "Insufficient stock"). Reasons are defined in Omnitron and automatically transferred to Seller Center.
* **Penalty Rule** – A setting added to a cancellation reason that means "if an item is canceled with this reason, deduct this amount."
* **Item** – A single unit of a product in an order. If an order contains 2 units of the same product, it has 2 separate items.
* **Reconciliation Period** – The accounting period in which a seller's sales, returns, and commissions within a specific date range are collected. When the period closes, its sales, return, commission, reward, and penalty totals are calculated.
* **Open Reconciliation Period** – The seller's current reconciliation period that has not yet closed.
* **Penalty Record** – A penalty-type reconciliation record added to the open reconciliation period. It increases the reconciliation's commission total by the penalty amount.

## <mark style="color:red;">**When Is a Penalty Created?**</mark>

A penalty is created when the cancellation reason used in a cancellation or return operation performed through Seller Center has a penalty rule. What determines the penalty is the reason used, not who initiated the operation.

The following table shows which reason is used in each operation and whether a penalty is created:

| Operation                                                                                                                      | Reason Used                                                                                                                                              | Is a Penalty Created?                                                    |
| ------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| The seller cancels an item in Seller Center                                                                                    | The reason the seller selects from the list. Selecting a reason is not mandatory; if no reason is selected, the default seller rejection reason is used. | Yes, if the reason used has a rule                                       |
| An item is canceled through OMS (e.g., out of stock)                                                                           | Always the default seller rejection reason                                                                                                               | Yes, if this reason has a rule                                           |
| An item is canceled through the seller integration (API)                                                                       | Always the default seller rejection reason                                                                                                               | Yes, if this reason has a rule                                           |
| The seller initiates a return in Seller Center or through the seller integration (including returns of undeliverable packages) | Always the default return reason                                                                                                                         | Yes, if this reason has a rule                                           |
| The seller approves a customer's cancellation request in Seller Center                                                         | The reason the customer selected. If multiple requests are approved together, the reason of the first request is applied to all of them.                 | Yes, if the reason used has a rule                                       |
| A customer cancellation takes place without going through Seller Center                                                        | —                                                                                                                                                        | No                                                                       |
| The order is not shipped on time (delay)                                                                                       | —                                                                                                                                                        | No. There is no mechanism that detects delays or cancels delayed orders. |

{% hint style="warning" %}
Enter penalty rules only for seller-caused reasons. If you enter a rule for customer reasons or for the default return reason, sellers are also penalized for customer-initiated operations.
{% endhint %}

### <mark style="color:red;">Cancellation Reason in OMS and Seller Integration Cancellations</mark>

A reason cannot be selected for cancellations made through OMS or the seller integration. The system uses the same reason for all of these cancellations: the **default seller rejection reason**. If you want to apply a penalty to OMS and seller integration cancellations, enter the rule for this reason; a rule entered for any other reason does not affect these cancellations.

**Example:** Suppose a fixed rule of 30 TRY is entered for the default seller rejection reason. OMS cancels 2 items in a package because they are out of stock:

| Item      | Reason Used                     | Penalty    |
| --------- | ------------------------------- | ---------- |
| Item 1    | Default seller rejection reason | 30 TRY     |
| Item 2    | Default seller rejection reason | 30 TRY     |
| **Total** |                                 | **60 TRY** |

{% hint style="info" %}
A rule entered for the default seller rejection reason applies to **all** cancellations made through OMS and the seller integration. It does not distinguish between stock-related and other cancellations.
{% endhint %}

## <mark style="color:red;">**How to Find the Default Seller Rejection Reason?**</mark>

{% stepper %}
{% step %}
Navigate to the **Settings > Dynamic Settings** page in Seller Center.
{% endstep %}

{% step %}
Check the value of the `OMNITRON_REJECTED_CANCELLATION_REASON_ID` setting. This value is the ID of the reason in Omnitron.
{% endstep %}

{% step %}
The cancellation reason with this ID in Omnitron is the default seller rejection reason.
{% endstep %}
{% endstepper %}

## <mark style="color:red;">**How to Define a Penalty Rule?**</mark>

{% stepper %}
{% step %}
Navigate to the **Settings > Order Rejection Deductions** page in Seller Center. All cancellation reasons are listed with the **Reason**, **Status**, and **Is Seller Reason?** columns.
{% endstep %}

{% step %}
Click the name of the reason you want to define a penalty for. The **Deduction Detail** page opens.
{% endstep %}

{% step %}
Select **Fixed** or **Percentage** as the **Calculation Type**.
{% endstep %}

{% step %}
Fill in the fields according to your selection (see **Fixed Calculation** and **Percentage Calculation** below) and click **Save**.

<img src="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2F0KVQGjyxtpjh0UluNY55%2FPasted%20image%202026-11-11%2007.52.25.png?alt=media&amp;token=f41e61a1-b4f1-40fd-ba25-e75e63b9015a" alt="" height="251" width="624">
{% endstep %}
{% endstepper %}

### <mark style="color:red;">Fixed Calculation</mark>

* **Amount** – The amount (TRY) to be deducted for each canceled item, e.g., 50. Enter the amount as a whole number.

**Penalty = Entered amount.** The item price does not matter.

<img src="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2F6PIUxKpr8NK2VOGEejJq%2FPasted%20image%202026-11-11%2007.52.38.png?alt=media&amp;token=e9b4deec-b1a7-43a5-b5eb-878a9728cac5" alt="" height="387" width="624">

### <mark style="color:red;">Percentage Calculation</mark>

* **Reference** – The amount on which the penalty is calculated.
  * **Amount** – The item's sales price before the discount is deducted.
  * **Discounted Amount** – The sales price minus the discount allocated to the item.
* **Multiplier** – The ratio equivalent of the percentage. It must be between 0.01 and 1.00 and contain at most two decimal places. Seller Center does not accept values greater than 1.00.

**Penalty = Reference amount × Multiplier**

Multiplier values for commonly used rates:

| Desired Penalty Rate | Value to Enter in the Multiplier Field | Penalty for an 800 TRY Item |
| -------------------- | -------------------------------------- | --------------------------- |
| 1%                   | 0.01                                   | 8 TRY                       |
| 5%                   | 0.05                                   | 40 TRY                      |
| 10%                  | 0.10                                   | 80 TRY                      |
| 25%                  | 0.25                                   | 200 TRY                     |
| 100%                 | 1.00                                   | 800 TRY                     |

{% hint style="danger" %}
The multiplier is entered as a ratio, not as a percentage: for 5%, enter 0.05, not 5. If you accidentally enter 0.5, the penalty becomes 50%, and an 800 TRY item is charged a 400 TRY penalty instead of 40 TRY.
{% endhint %}

{% hint style="info" %}
The calculation is based on the item's price in the order; VAT is not added on top of it. Options that calculate with VAT added are disabled.
{% endhint %}

<img src="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2FF604M5MjgQ3l8sce916V%2FPasted%20image%202026-11-11%2007.53.00.png?alt=media&amp;token=4d394dee-f128-4cec-8da6-83b5a1b17c14" alt="" height="453" width="624">

### <mark style="color:red;">Changing or Removing a Rule</mark>

* When a rule is changed, only subsequent cancellations are calculated according to the new rule. Previously created penalties do not change.
* A reason's rule cannot be removed on the Seller Center page; the rule can be removed in Omnitron.
* Entering 0 as the **Amount** does not remove the rule: penalty checks (e.g., the open reconciliation period check) are still performed for cancellations with that reason. See **What Happens Without an Open Reconciliation Period?**

## <mark style="color:red;">**Flow from Cancellation to Reconciliation**</mark>

Regardless of the channel used, a cancellation goes through the following steps:

{% stepper %}
{% step %}
The seller cancels one or more items through Seller Center, OMS, or the seller integration.
{% endstep %}

{% step %}
The system checks whether any of the reasons used in the cancellation has a penalty rule. If there is no rule, the cancellation proceeds normally, and no penalty is created.
{% endstep %}

{% step %}
If there is a rule, the system looks for the seller's **open reconciliation period**. If there is no open reconciliation period, the cancellation stops completely. See **What Happens Without an Open Reconciliation Period?**
{% endstep %}

{% step %}
The cancellation is sent to Omnitron. If Omnitron does not accept the cancellation, no penalty is created. If Omnitron cannot accept the cancellation at that moment (e.g., if the order has another pending cancellation), the cancellation is queued and retried; the penalty is created when the cancellation is accepted.
{% endstep %}

{% step %}
If the cancellation is accepted, the penalty is calculated **separately for each canceled item** and written to the open reconciliation period as a penalty record. If the seller has more than one open reconciliation period, the penalty is written to the most recently opened period.
{% endstep %}

{% step %}
Records are transferred to Omnitron by an automatic job that runs approximately every 8 minutes.
{% endstep %}

{% step %}
In Omnitron, the penalty is added to the reconciliation as a line with a sales amount of 0 and a commission amount equal to the penalty. When the reconciliation period closes, the reconciliation's **Total Commission** increases by the penalty amount; the same amount is also added to the **Total Penalty** field.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Total Penalty** includes not only cancellation penalties but also other reconciliation records, such as service fees. For this reason, for a seller with service fees, Total Penalty is greater than the sum of cancellation penalties.
{% endhint %}

## <mark style="color:red;">**What Happens Without an Open Reconciliation Period?**</mark>

Omnitron opens a seller's reconciliation period when one of the seller's shipped or delivered items enters reconciliation, and it closes periods that have expired. As a result, some sellers may have no open reconciliation period. For example, a new seller whose items have not yet entered reconciliation has no open reconciliation period.

If a cancellation is requested with a reason that has a penalty rule and the seller has no open reconciliation period:

* The cancellation does not take place at all and is not sent to Omnitron. The item remains uncanceled.
* The seller sees the message "Could not process the request now, please try again." in Seller Center. OMS and the seller integration receive the same error.
* Retrying does not succeed until the seller's reconciliation period is opened.
* Only cancellations with rule-bound reasons are affected. Cancellations with reasons that have no rule are not affected.

### <mark style="color:red;">When the Order Has a Pending Cancellation</mark>

If a cancellation was previously initiated on the order and has not yet been finalized, the new cancellation is not sent immediately but is queued. The seller sees the operation as successful, and the item's status changes to cancellation pending in Seller Center. The queued cancellation is retried when the cancellation record of the same order is updated in Omnitron, and the open reconciliation period check is performed at that moment. If there is no open reconciliation period, the cancellation is not sent to Omnitron; after 9 failed attempts, the queued cancellation is closed.

{% hint style="danger" %}
If a rule is entered for the default seller rejection reason, all stock cancellations made through OMS for a seller with no open reconciliation period are blocked; these items remain with the seller and cannot be canceled. Before entering a penalty rule for a reason, make sure that every seller who may use that reason has an open reconciliation period.
{% endhint %}

## <mark style="color:red;">**Where Do Sellers See Penalties?**</mark>

Sellers see penalties on the reconciliation pages in Seller Center:

* **Reconciliation Detail (Finance > Reconciliations > relevant reconciliation)** – Each penalty is listed as a separate line. In this line, **Sales Price** is shown as 0 and **Commission Amount** as the penalty amount; the order number, invoice number, SKU, and product name columns are empty.
* **Reconciliation Summary** – The penalty is included in the **Sales Commission (TL)** total. This total is calculated when the reconciliation period closes (or is approved); it is not updated while the period is open. Seller Center does not display a separate "total penalty" field.
* **Description** – The description of a penalty record is fixed ("Penalty for cancellation."). This description is not displayed in Seller Center.

{% hint style="info" %}
A penalty line looks the same as service fee lines (sales price 0, commission filled, order information empty). Sellers cannot distinguish penalties from these lines.
{% endhint %}

## <mark style="color:red;">**Calculation Examples**</mark>

All examples use the same order:

| Item      | Sales Price | Discount Allocated to Item | Discounted Amount |
| --------- | ----------- | -------------------------- | ----------------- |
| Product A | 1,000 TRY   | 200 TRY                    | 800 TRY           |
| Product B | 400 TRY     | 0 TRY                      | 400 TRY           |
| Product C | 250 TRY     | 0 TRY                      | 250 TRY           |

The seller cancels **Product A** and **Product B** with the reason "Insufficient stock". Product C is shipped.

### <mark style="color:red;">Example 1: Fixed Penalty</mark>

Rule: "Insufficient stock" → Calculation Type **Fixed**, Amount **50**

| Item      | Calculation  | Penalty     |
| --------- | ------------ | ----------- |
| Product A | Fixed amount | 50 TRY      |
| Product B | Fixed amount | 50 TRY      |
| Product C | Not canceled | —           |
| **Total** |              | **100 TRY** |

Two separate penalty records are created in the open reconciliation period: 50 TRY for Product A and 50 TRY for Product B. The price difference between the items does not change the result.

### <mark style="color:red;">Example 2: Percentage Penalty, Reference Discounted Amount</mark>

Rule: "Insufficient stock" → Calculation Type **Percentage**, Reference **Discounted Amount**, Multiplier **0.05** (5%)

| Item      | Calculation                       | Penalty    |
| --------- | --------------------------------- | ---------- |
| Product A | (1,000 − 200) × 0.05 = 800 × 0.05 | 40 TRY     |
| Product B | (400 − 0) × 0.05 = 400 × 0.05     | 20 TRY     |
| **Total** |                                   | **60 TRY** |

### <mark style="color:red;">Example 3: Percentage Penalty, Reference Amount</mark>

Rule: "Insufficient stock" → Calculation Type **Percentage**, Reference **Amount**, Multiplier **0.05** (5%)

| Item      | Calculation                               | Penalty    |
| --------- | ----------------------------------------- | ---------- |
| Product A | 1,000 × 0.05 (discount is not considered) | 50 TRY     |
| Product B | 400 × 0.05                                | 20 TRY     |
| **Total** |                                           | **70 TRY** |

The difference from Example 2: With **Reference > Amount**, the 200 TRY discount on Product A is not taken into account, so the penalty is 50 TRY instead of 40 TRY. For Product B, which has no discount, both references give the same result.

### <mark style="color:red;">Example 4: Effect on Reconciliation Totals</mark>

Suppose the seller's open reconciliation period is as follows (a simplified example with no returns or other reconciliation records): total sales of 10,000 TRY, sales commission of 15%.

| Reconciliation Total | Without Penalty | With the 100 TRY Penalty from Example 1                |
| -------------------- | --------------- | ------------------------------------------------------ |
| Total Sales          | 10,000 TRY      | 10,000 TRY (the sales amount of a penalty record is 0) |
| Total Commission     | 1,500 TRY       | 1,600 TRY (1,500 sales commission + 100 penalty)       |
| Total Penalty        | 0 TRY           | 100 TRY (the penalty share within Total Commission)    |

After the reconciliation period closes, the **Sales Commission (TL)** field in the Seller Center reconciliation summary shows 1,600 TRY. The Total Penalty field is not displayed in Seller Center.

## <mark style="color:red;">**How to Penalize Stock-Related Cancellations?**</mark>

With the current system, there are two ways to apply penalties to stock-related cancellations.

### <mark style="color:red;">Option A: Enter a Rule for the Default Seller Rejection Reason</mark>

All cancellations made through OMS and the seller integration are penalized. See **When Is a Penalty Created?**

{% hint style="info" %}
With this option, stock-related cancellations cannot be distinguished from other cancellations; all of them receive the same penalty.
{% endhint %}

### <mark style="color:red;">Option B: Define a Separate "Insufficient Stock" Reason</mark>

{% stepper %}
{% step %}
Create a new cancellation reason in Omnitron (e.g., "Insufficient stock"). The reason is automatically transferred to Seller Center within a few minutes.
{% endstep %}

{% step %}
Navigate to the **Settings > Order Rejection Deductions** page in Seller Center and make sure the **Is Seller Reason?** option is enabled for this reason.
{% endstep %}

{% step %}
Navigate to the **Settings > Dynamic Settings** page in Seller Center and add the reason's Omnitron ID to the `OMNITRON_ALLOWED_CANCELLATION_REASON_IDS` setting. This setting determines which reasons sellers can select when canceling; a reason that is not in this list cannot be used by sellers.
{% endstep %}

{% step %}
Enter a penalty rule for the reason. See **How to Define a Penalty Rule?**
{% endstep %}

{% step %}
Inform sellers to select this reason for stock-related cancellations.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
This option works only for cancellations **made in Seller Center** and depends on the seller selecting the correct reason. If the seller selects a different reason, that reason's rule (or nothing, if it has no rule) is applied.
{% endhint %}

## <mark style="color:red;">**Limitations of the Current System**</mark>

The following are not available or are limited in the current system:

| Topic                                                         | Current Status                                                                         |
| ------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| Delay penalty                                                 | Not available                                                                          |
| Seller-specific rule                                          | Not available; rules are defined per cancellation reason and are the same for everyone |
| Product- or category-specific rule                            | Not available                                                                          |
| Reason selection in OMS and seller integration cancellations  | Not available; the default seller rejection reason is always used                      |
| Rule-bound cancellation without an open reconciliation period | Not possible                                                                           |
| Deleting/editing penalties in Seller Center                   | Not available; penalty records can be edited and deleted in Omnitron                   |
| Removing a rule in Seller Center                              | Not available; the rule can be removed in Omnitron                                     |

## <mark style="color:red;">**FAQ**</mark>

<details>

<summary>Should the penalty mechanism be set up in Omnitron, or managed on the billing/reconciliation (current account) side?</summary>

In the current structure, the penalty rule is defined in Seller Center, and the penalty is calculated in Seller Center. The calculated penalty is recorded in the reconciliation in Omnitron: it is added to the reconciliation's Total Commission and also shown separately in the Total Penalty field. Omnitron does not calculate the seller's payout separately. See **Example 4: Effect on Reconciliation Totals**.

</details>

<details>

<summary>Can a seller-based penalty rule be defined in Omnitron?</summary>

No, there are no seller-based rules. Rules are defined per cancellation reason and apply equally to all sellers. The trigger is the cancellation reason; the amount is defined as fixed or percentage. See **How to Define a Penalty Rule?**

</details>

<details>

<summary>Can penalty triggers (delay duration, cancellation reason, stock-related cancellation) be detected automatically?</summary>

* **Cancellation reason:** Yes. The reason used in cancellations made through Seller Center is detected automatically.
* **Stock-related cancellation:** Partially. In Seller Center, it is detected if sellers select a separate "stock" reason. See **How to Penalize Stock-Related Cancellations?** Since a reason cannot be selected in OMS and seller integration cancellations, stock cancellations cannot be distinguished from other cancellations.
* **Delay duration:** No. There is no mechanism that detects delays or cancels delayed orders.

</details>

<details>

<summary>Can the penalty be automatically deducted from the seller's payout?</summary>

The penalty is automatically written to the open reconciliation period and automatically added to the reconciliation's Total Commission. When the seller's payout is calculated from the reconciliation totals, the penalty is deducted from that amount. See **Example 4: Effect on Reconciliation Totals**.

</details>

<details>

<summary>Can penalty records be reported or exported?</summary>

Seller Center has no report or export for penalty records. In Omnitron, penalty records (reconciliation records) can be listed by filtering by type (penalty/reward), order number, and reconciliation; all records matching the filter can be exported as a single Excel (XLS) file.

</details>

<details>

<summary>A seller receives the error "Could not process the request now, please try again." when canceling. Why?</summary>

If the reason used has a penalty rule, the seller may not have an open reconciliation period. In this case, cancellations with that reason cannot be made until the reconciliation period is opened. See **What Happens Without an Open Reconciliation Period?**

</details>

<details>

<summary>A seller who approved a customer's cancellation request was penalized. Why?</summary>

When a seller approves a customer's cancellation request in Seller Center, the reason selected by the customer is used. If this reason has a penalty rule, the seller is penalized. Enter penalty rules only for seller-caused reasons. See **When Is a Penalty Created?**

</details>

<details>

<summary>I changed a rule. Are previously created penalties updated?</summary>

No. Only subsequent cancellations are calculated according to the new rule.

</details>

<details>

<summary>Can I enter 0 as the Amount to remove a reason's rule?</summary>

This does not remove the rule: penalty checks (e.g., the open reconciliation period check) are still performed for cancellations with that reason. A reason's rule cannot be removed on the Seller Center page; the rule can be removed in Omnitron.

</details>

<details>

<summary>Can I revert an incorrectly created penalty?</summary>

Seller Center has no page for deleting or editing penalty records. Penalty records can be edited and deleted in Omnitron.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.akinon.com/tutorials/seller-center/marketplace-owner/seller-penalty-system.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
