# Price Books

From the Price books tab, you can upload your price books data to Fairmarkit. From the admin area, you can create your price books as well as create pricebook items directly in the UI. (You can also create pricebooks and pricebook items via API which can be found [here](https://developers.fairmarkit.com/reference/create_price_book_services_self_service_api_v4_price_books__post).

{% hint style="info" %}
**Access**: To access these settings, you will need to be assigned to the Admin role for your organization and have Price books enabled.
{% endhint %}

<figure><img src="/files/4FSB4p3T37vpxGvfTp3B" alt=""><figcaption></figcaption></figure>

### Creating a new pricebook <a href="#howdoiformatmydata" id="howdoiformatmydata"></a>

{% stepper %}
{% step %}
Click **Create price book in the top right**.
{% endstep %}

{% step %}
Define the price book header information.

The required field of any pricebook are **title**, **supplier** (selection from uploaded suppliers), **type** (goods or services catalog), and **effective date from and to**.

<figure><img src="/files/WgEcAGSLqY2doIm6c7Tb" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
We allow customers to fully define their own schema of the attributes of a pricebook they would like to have in Fairmarkit. You can add any type of data point and Fairmarkit's Technical Architects can help you define any elements into your custom schema.

{% hint style="info" %}
**Required Fields:** Description, currency, Unit of Measure and Unit Price are required fields in the schema.
{% endhint %}

{% hint style="info" %}
**Important Note:** While you can have a different schema per pricebook, best practices would be to align on one schema for items and one for services to simplify management, especially if integrating via API.
{% endhint %}
{% endstep %}

{% step %}
Custom tags are used to filter when the pricebook and the items within should be shown. you can use standard attributes such as country, but also custom attributes you define in intake such as plant, business\_unit, etc. for filtering. To add multiple attributes to a single tag (i.e. multiple countries for a single pricebook) just click the + button to add multiple (as shown in the GIF below).

<figure><img src="/files/eXBQLy1yvlNIyk8qAsGI" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### Add items to price book <a href="#uploaddata" id="uploaddata"></a>

{% stepper %}
{% step %}
Once the pricebook is created, you can navigate inside of it to see all items inside of it (will be blank to start).

<figure><img src="/files/1c1R17oDAYEqrd9MC1PI" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
You can then add items manually by clicking Create Item in the top right. This will show the required fields and any other fields you defined in your schema.

<figure><img src="/files/EavF8Uy4p6pxMbICEcQr" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
You also have the option to upload the content via a csv. The csv that gets downloaded is in the format that needs to be reuploaded (taking your custom fields into account)

<div><figure><img src="/files/46fr5GCmlMgXmLZIZloQ" alt=""><figcaption></figcaption></figure> <figure><img src="/files/hSK7qGaz4lT0q84R0WVq" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

### Deactivate or delete a price book <a href="#deleteapricebook" id="deleteapricebook"></a>

* Any pricebook can be either deactived so it is no longer shown or deleted in the platform. Items can also be deleted.
* In order to change the schema of a pricebook, all items must be deleted out of the pricebook before it can be changed.


---

# Agent Instructions: 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:

```
GET https://docs.fairmarkit.com/buyers/administration/price-books.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
