> For the complete documentation index, see [llms.txt](https://docs.fulfillmenttools.com/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fulfillmenttools.com/documentation/getting-started/facilities/facility-discounts.md).

# Facility discounts

Facility discounts determine the value by which the [sales price](/documentation/by-pillar/global-inventory-hub/articles/article-attributes.md#category-sales-price) of the facility's listings is reduced for a specific group. It's configured on the facility that supplies the listing to other facilities. 

The amount of the discount can be defined as a relative or absolute value. Discounts can be defined for a facility, a [group of facilities](/documentation/getting-started/facilities/facility-groups.md) or a group of articles ([category](/documentation/by-pillar/global-inventory-hub/categories.md)).

The scope of application can be extended or reduced with the help of `AND` and `NOT` operators. 

The contexts set in the discount (for example, facility groups) are matched with the corresponding context of the [listing attributes](/documentation/by-pillar/global-inventory-hub/articles/article-attributes.md#category-sales-price). If all contexts are matching, the discount is applied to the [sales price](/documentation/by-pillar/global-inventory-hub/articles/article-attributes.md#category-sales-price) of the item. 

The priority defines the order in which the discounts should be applied.Facility discounts can be viewed, created, and edited via the REST API: [REST API documentation – Facility discounts](https://fulfillmenttools.github.io/fulfillmenttools-api-reference-ui/#get-/api/facilities/-facilityRef-/discounts).

#### **Example** <a href="#example" id="example"></a>

**Discounts supplier facility "CGN-02"**

| Discount | Scope of application                   | Priority |
| -------- | -------------------------------------- | -------- |
| 10%      | Facility "CGN-01" \| Facility "DUS-01" | 10       |
| 10%      | Article category "school books"        | 50       |
| 50€      | Facility group "NRW"                   | 100      |

Facility discounts determine the value by which the [sales price](/documentation/by-pillar/global-inventory-hub/articles/article-attributes.md#category-sales-price) of the facility's listings is reduced for a specific group. Discounts can be defined for a facility, a [group of facilities](/documentation/getting-started/facilities/facility-groups.md) or a group of articles ([category](/documentation/by-pillar/global-inventory-hub/categories.md)). The scope of application can be extended or reduced with the help of `AND`, `OR`, `NOT` operators. The contexts set in the discount (for example, facility groups) are matched with the corresponding context of the [article attributes](/documentation/by-pillar/global-inventory-hub/articles/article-attributes.md#category-sales-price). If all contexts were matching, the discount would be applied to the sales price of the item.

## Create facility discounts

To add a discount to an existing facility, perform the following `POST` request with a JSON body similar to the example provided. This example applies a discount of 5 EUR to articles that do NOT belong to the category `pet food` and that belong to either the `CGN` or `DUS` facility groups.

```http
POST https://ocff-{projectId}.api.fulfillmenttools.com/api/facilities/{facilityRef}/discounts
```

```json
{
  "context": [
    {
      "operator": "NOT",
      "type": "CATEGORY",
      "values": [
        "pet food"
      ]
    },
    {
      "operator": "AND",
      "type": "FACILITY_GROUP",
      "values": [
        "CGN",
        "DUS"
      ]
    }
  ],
  "discount": {
    "type": "ABSOLUTE",
    "value": 500,
    "currency": "EUR",
    "decimalPlaces": 2
  },
  "priority": 20,
  "type": "SALES_PRICE"
}

```


---

# 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 dynamically by asking a question.

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

```
GET https://docs.fulfillmenttools.com/documentation/getting-started/facilities/facility-discounts.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.