# Configuring stock in your free trial

{% hint style="success" %}

## Prerequisites

* Access to a free trial tenant (email with credentials) 
* Read our [](https://docs.fulfillmenttools.com/documentation/using-our-free-trial/free-trial-information "mention"), [setting-up-postman-for-your-free-trial](https://docs.fulfillmenttools.com/documentation/using-our-free-trial/free-trial-information/setting-up-postman-for-your-free-trial "mention"), [facilities-in-your-free-trial](https://docs.fulfillmenttools.com/documentation/using-our-free-trial/free-trial-information/facilities-in-your-free-trial "mention"), and [listings-in-your-free-trial](https://docs.fulfillmenttools.com/documentation/using-our-free-trial/free-trial-information/listings-in-your-free-trial "mention") articles
* Access to Postman (you can use an HTTP tool of your choice, but for this article, we'll focus on working with Postman)
  {% endhint %}

## What's stock?

Stock is the total amount of goods or the amount of a particular type of goods available in a store or warehouse.

## Why does it matter for my free trial?

For this tutorial, we're assuming we're a shop with products to sell and a consumer[^1] wants to order those products. For that, we need to let the system know how many products (listings) we have to sell in our shop (facility).

Let's add a stock to the listings we created for our facility.

## Add stock to listing

{% stepper %}
{% step %}
**Open the stocks endpoint**

In Postman, find the `POST Create Stock` endpoint and click to open. You'll see the body is prefilled with some data. For example:

```json
{
    "facilityRef": "PUT-IN-YOUR-FACILITY-ID",
    "tenantFacilityId": "PUT-IN-YOUR-TENANT-FACILITY-ID",
    "tenantArticleId": "PUT-IN-YOUR-TENANT-ARTICLE-ID",
    "value": 100,
    "properties": {
        "batchNo": "9890"
    },
    "receiptDate": "2024-11-23T11:18:14.214Z",
    "traitConfig": [{
        "trait": "ACCESSIBLE",
        "enabled": false
    }, {
        "trait": "PICKABLE",
        "enabled": false
    }]
}
```

{% hint style="info" %}
We're only using the required fields in this example, and not all the available option. See [our stocks article](https://docs.fulfillmenttools.com/documentation/by-pillar/global-inventory-hub/stock) for more details and the API specification.
{% endhint %}
{% endstep %}

{% step %}
**Get the facility ID**

Copy the `id` that was created from our [facilities-in-your-free-trial](https://docs.fulfillmenttools.com/documentation/using-our-free-trial/free-trial-information/facilities-in-your-free-trial "mention") article and paste into the request body where it says `PUT-IN-YOUR-FACILITY-ID`
{% endstep %}

{% step %}
**Get the article ID**

Copy the `tenantArticleId` from one of the listings we created in [listings-in-your-free-trial](https://docs.fulfillmenttools.com/documentation/using-our-free-trial/free-trial-information/listings-in-your-free-trial "mention") and paste into the request body where it says `PUT-IN-YOUR-TENANT-ARTICLE-ID`
{% endstep %}

{% step %}
**Delete tenant facility line**

As we didn't use a `tenantFacilityId` when we set up our facility, we need to remove this line from the request.

```json
    "tenantFacilityId": "PUT-IN-YOUR-TENANT-FACILITY-ID",
```

{% endstep %}

{% step %}
**Edit data**

You can edit the body in any other way you wish, or leave it as it is.
{% endstep %}

{% step %}
**Send the request**

Click **Send**. 

{% hint style="info" %}
Ensure you've refreshed your `authToken` if it's been more than 60 minutes since your last refresh.
{% endhint %}

You should get a `201 Created` response. You'll notice some extra fields that are part of the response and have been automatically created.
{% endstep %}
{% endstepper %}

The stock will also be visible in Backoffice for other team members to use, but we'll go through that later in this section. 

In the next article, we'll take you through orders. What they are, how to set them up, and how to edit them.

[^1]: The end user is making the purchase, whether online or offline.