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

# Getting started

Overview of the basic steps needed to manage negotiations in Pactum.

### Accessing Suite

{% stepper %}
{% step %}
Ensure that you have an established account within the Pactum Suite. If not, please contact the business owner to request your login credentials.
{% endstep %}

{% step %}
When your credentials have been generated, you will receive an email from a Pactum representative containing your Username and Password for Suite access.
{% endstep %}

{% step %}
Navigate to `suite.pactum.com` to access the Suite platform, and enter your credentials.

(If your Pactum deployment is in EU, this and all other URLs should refer to the `suite.eu-pactum.com` domain instead.)
{% endstep %}
{% endstepper %}

<figure><img src="https://2769938103-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FM7KTpbu7nDWmneLhlf%2Fuploads%2Feua7mn5Us0AMcpugBKiR%2FScreenshot%202024-11-05%20at%2016.08.03.png?alt=media&amp;token=bda5d161-d3d5-4d64-8202-2125bb705564" alt="" width="375"><figcaption><p>Enter your credentials to login to Pactum Suite.</p></figcaption></figure>

### Creating and launching negotiations

To start a new negotiation with a supplier, you need to create a negotiation event. You can do so in Suite.

Start by clicking "New negotiation" in the list of negotiations in your workspace:

<figure><img src="https://lh7-qw.googleusercontent.com/docsz/AD_4nXcUZFPbW0dnLGy12vzmJXvkUVRPDeHl6192Wer0CNjqNx47Y-9lsq5tbCB42OfJU4FvZucycF1yiCoaFcTjggQNLnYxSRJi_sxByL3LSBNtcRLjyyh4Q-WZB91EeQ3eX-LQiFVmLA?key=99d9ktb_jkBwvD1dFwNpIY6o" alt=""><figcaption></figcaption></figure>

Then, fill in the text fields. Some of the fields are optional (as indicated in the form as such) and others are mandatory. The fields available will differ depending on the use case and configuration; for example, the mandatory fields for [Broken mention](broken://pages/6kO0AFEq5ydekr7tSQZR) are usually:

* **Description:** unique name for the negotiation event.
* **Deadline:** number of days supplier will have to complete the negotiation, once started.
* **Delivery address:** delivery location to be confirmed in negotiation.
* **Delivery date:** delivery date to be confirmed in negotiation.
* **Supplier company:** name of the supplier company.
* **Supplier email:** the primary contact email address of the supplier. When testing in the sandbox, you can enter your own email.
* **Locale:** language of negotiation and supplier emails (e.g. `en-US`).
* **Currency:** the currency from quote (e.g. `USD`).
* **Payment days:** existing or pre-agreed payment days for the supplier.

You also need to add at least one line item. For line items, the following fields are mandatory:

* **Item ID**: line item number.
* **Name:** name of the item as quoted.
* **Quantity:** quantity of the item quoted (number only).
* **Unit of measure:** standard of measurement used to quantify the item quoted (e.g. `kg`).
* **Price per unit**: the quoted price per unit of the item quoted.

Optionally, you can upload attachments and toggle whether they should be visible to the supplier. If there are multiple suppliers in the event, all suppliers will see the same attachments. Attachments are useful for additional information that cannot be included in the negotiation flow (additional specifications, detailed shipping info, etc.).

Finish by clicking the "Create negotiation" button; to start the negotiation you then need to click **Start** in the negotiation list:

<figure><img src="https://2769938103-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FM7KTpbu7nDWmneLhlf%2Fuploads%2FXAvUygKJxxyssPeg164L%2FScreenshot%202024-11-27%20at%2010.35.41.png?alt=media&amp;token=4e5209f5-1252-43f6-a346-9c6de178efbb" alt="" width="171"><figcaption></figcaption></figure>

When the negotiation event is created, it will automatically be assigned to the user who created it.

### Requisition list (Negotiation events) view

The Requisitions list shows all purchase requisitions in the Suite.

Access the list by clicking on Negotiation events at the top right of the page in Suite:

<figure><img src="https://2769938103-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FM7KTpbu7nDWmneLhlf%2Fuploads%2FQKEfllITdy11KcP0RYfY%2FScreenshot%202024-11-08%20at%2015.45.18.png?alt=media&amp;token=6d226862-4a8c-49d7-a594-95095fec00b9" alt="" width="375"><figcaption></figcaption></figure>

The header of the table shows column names as follows:

<figure><img src="https://lh7-qw.googleusercontent.com/docsz/AD_4nXfgvFTwc2U7b5if_KgpgdxnNDVtkkVyxC71z6OcKlzQmYVsSVOsEZWDSqn-Km29yb94JEagn8_PxBVqH-4vUb-4B4zDHVAfy19L4jnwkX57KELM69J0PY2T7tKcTed7xUUosiiwc-Xg15xrSebQMK_XtM7u?key=nhkwHaG3_CgESFpXoSQv0A" alt=""><figcaption><p>Requisition table header</p></figcaption></figure>

* PR number: a unique identifier for each requisition.
* Supplier company name
* Buyer email
* Deadline: for suppliers to complete the negotiation
  * Prior to start, this will show an interval such as “2 days”
  * After negotiation has started, this will show a specific date
* Original amount: based on the supplier's quote
* Savings: percentage and amount of improvement, including working capital improvement.
* Last modified
* Status: see description of the [negotiation lifecycle](https://docs.eu-pactum.com/procurement-product/negotiation-lifecycle.md#requisition-supplier-and-negotiation-lifecycle)
* Actions:
  * Start
  * Download
  * Withdraw
  * Restart (start again after withdrawing)

{% hint style="info" %}
Table headers can be clicked to sort requisitions, and the search field can be used to filter for PR numbers, supplier company, or buyer name.
{% endhint %}

Hovering over a row reveals checkboxes on the left. Upon ticking checkboxes, buttons for bulk actions appear. To select all negotiations in the workspace, click the checkbox aligned to the table header.

<figure><img src="https://lh7-qw.googleusercontent.com/docsz/AD_4nXcLhVKbw6ZS4Yoi5Uzf9qP7t57wFcZ1YvoDIy6Libg0crNDKbviN3JLrNu5tuoxWlw2HTlHq-4HmPawInGCsjmvbFvSUsMboeIcWiv7bEBGmybWDQYTxmj_4lkZTcqVsbI3dBUIMbFGp4qG2a4nOX1cKyQ?key=nhkwHaG3_CgESFpXoSQv0A" alt=""><figcaption><p>Bulk actions are available when negotiations are selected.</p></figcaption></figure>

The "Download results" action exports a CSV file in a format described in [Exporting results](https://docs.eu-pactum.com/procurement-product/exporting.md).

### Dashboard

The dashboard displays an aggregate summary and status of all negotiations.

<figure><img src="https://lh7-qw.googleusercontent.com/docsz/AD_4nXcZic1-bIwGlJXXM6fvos7qaEcuu4GVP9_r-Dc3sYfT1mr6NaWbjXZ5wj6hrCKqVsj54XUSzusEOMPt7KshiY5-3e90hktfWzX2nfRyhQF8af3ZzG1DJkfIhr5jV-Py-0FBGBYLZgjPVncG7GR1tSXo1YqU?key=nhkwHaG3_CgESFpXoSQv0A" alt=""><figcaption><p>Example values on the Suite dashboard</p></figcaption></figure>

* **Total savings** includes both negotiated discounts and working capital improvement from payment terms.
* **Successful spend** is total spend from successful negotiations.
* **Savings rate** is calculated as `Total savings / Successful spend`.
* **Successful PRs** are PRs where an agreement with savings was reached.
  * Note: this does not include completed negotiations with 0% savings.
* **Concluded PRs** are PRs where a negotiation has been [concluded](https://docs.eu-pactum.com/procurement-product/negotiation-lifecycle.md#requisition-supplier-and-negotiation-lifecycle).
* **Success rate** is calculated as `Successful PRs / Concluded PRs`.

You can filter and group the dashboard by using dashboard controls:

<figure><img src="https://lh7-qw.googleusercontent.com/docsz/AD_4nXcAqmtB2sVaJERFSRzjLoMANbfQdroihhDYfZw9Q_4h_7Tc03qR2hB7oQkoyyNFEPCTVl31GX2PJzk_TAnBgEMdm9rgc5ruzsf4d5mkv5Gof62q_80g_rTEfm59QYqgjYo3a_U088EJl7l7_SzeMbpPD1c?key=nhkwHaG3_CgESFpXoSQv0A" alt=""><figcaption><p>Dashboard conrols</p></figcaption></figure>

* **Workspaces**: can select which workspace data is reported.
* **Currency**: Sets currency for reporting (if multiple currencies are configured).
* **Grouping interval**: Dropdown menu to aggregate on a weekly, monthly, or quarterly basis.
* **Date range**: Limits the date range from which results will be included.

For more complex analysis you can [export the results](https://docs.eu-pactum.com/procurement-product/exporting.md) as a CSV table and use any tool to process it further.

Refer to [Dashboards](https://docs.eu-pactum.com/essentials/dashboards.md) for more information about terms and definitions used on the dashboard.

### Getting support

Please see [Support Portal](https://docs.eu-pactum.com/essentials/support-and-feedback.md).

<br>
