Prices and facility discounts

You can define different types of prices in fulfillmenttools. A shop price can be defined in the attributes of the listing or the order. A sales price can be defined in the listing attributes of the selling facility's listing. And the purchase price is the result of a sales price to another facility.

Let's say we have a product called a Nerd Herd t-shirt. If a consumer buys it online from our website, they'll see the shop price. If our Nerd Herd Clothing Los Angeles store buys it from the supplier, they'll see the purchase price based on the sales price from the supplier.

For the above to take effect, we'd need the following on our t-shirt listing, plus a facility discount set and a facility connection between our supplier and our LA store.

{
    "listings": [
        {
            "tenantArticleId": "TSHIRT-W-2468",
            "title": "T-shirt",
            "decimalPlaces": 2,
            "attributes": [
                {
                    "category": "salesPrice",
                    "value": "3000",
                    "key": "valuePerUnit",
                    "type": "NUMBER"
                },
                {
                    "category": "salesPrice",
                    "value": "EUR",
                    "key": "currency",
                    "type": "CURRENCY"
                },
                {
                    "category": "shop",
                    "value": "3500",
                    "key": "valuePerUnit",
                    "type": "NUMBER"
                },
                {
                    "category": "shop",
                    "value": "EUR",
                    "key": "currency",
                    "type": "CURRENCY"
                }
            ]
        }
    ]
}

Shop price

The price at which items are sold to consumers is called the shop price. It can be stored at the listing level within the attributes or sent in the order's article attributes. Typically, only managed facilities will have a shop price configured.

The shop price is displayed in the Backoffice facility inventory detail view in the Article details section.

Sales price

The sales price is the amount at which items are sold to other facilities in the network and is always stored by the facility selling the articles. The sales price can be stored at the listing level in the listing attributes. It can be configured for all facility types, although primarily supplier facilities will configure a sales price.

The sales price is displayed in the Sales price section of the Backoffice facility inventory detail view and is visible in the selling facility's view. You can also add a sales price in Backoffice for the selling facility.

Facility discounts

Facility discounts determine the value by which the 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, or a category (group of articles).

The scope of application can be extended or narrowed using the AND, OR, and NOT operators.

The contexts set in the discount (for example, facility groups) are matched with the corresponding context of the listing attributes. If all contexts match, the discount is applied to the item's sales price.

The priority defines the order in which the discounts should be applied.

Facility discounts can be viewed, created, and edited via the Facility discounts API.

Example

Let's say we have a supplier facility called Nerd Herd Distribution, and it has 3 different facility discounts set.

If the Nerd Herd Clothing Los Angeles store (which is also part of the US West Coast facility group) purchases a t-shirt from Nerd Herd Distribution, it will receive a 10% discount. This is because the facility discount takes priority over both the category and facility group discounts.

If the Nerd Herd Clothing New York store purchases a t-shirt from our Nerd Herd supplier, it'll receive a 15% discount. This is because the category discount is the only discount that applies to that store.

Create facility discount

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 euros to articles that don't belong to the shoes or trousers categories and that belong to a facility group (YOUR_FACILTY_GROUP_ID).

Purchase price

The purchase price is the amount at which items are acquired from other facilities within the network. It isn't stored specifically in fulfillmenttools but depends on the facility from which an article is sourced.

The Purchase price section appears within the Backoffice facility inventory detail view of the purchasing facility. Only prices pertinent to the purchasing facility are displayed.

Discounted purchase price

Discounts can be applied to the purchase price of an article and are defined by the selling facility in the sales price. The selling facility can decide to set a discount for specific:

• Purchasing facilities

• Purchasing facility groups

• Article categories

This is done as part of the facility discounts.