Skip to main content
Skip table of contents

Framework agreements


Framework agreements come in handy when buying/selling a complex deal. A definition of such agreements can be as follows:

An arrangement between one or several buyers and one or several suppliers.
This defines the terms that will govern the contract which is applicable for a defined period of time.

These agreements usually tend to define a various number aspects such as prices, amounts, delivery specifics, quality…

In Opencell, the framework agreement (Contract) are used to overload targeted prices of charges, for a specific level of the hierarchy which can be either the Seller, the Customer, Customer Account or Billing account (all levels of the Opencell hierrarchy except for the User Account), and a given duration.

Though it does not yet manage all aspects of a more traditional framework agreement, we have chosen to only reflect the part that is the most relevant based on our speciality → Prices

Let’s now see how contracts are created and managed in Opencell.

Contracts → Where to find them


Contracts are created and managed directly in the Customer Care app.

When you arrive on the framework agreement page list view, then you will see all contracts that have been created in your environment. As all list views, a few features are available to allow you to quickly search for specific contracts, such as:

  • Search bar on Description field

  • :filter: Filter button for the following fields

  • :plus: New button to create a new Contract

  • :Download: Download button → This will download the view in .CSV format

  • And the Last viewed button

Creating a framework agreement


To create a contract, you will have to hit the :plus: button that you can find on the upper right corner of the page we have seen above. Once done, you will arrive on the following page:

Generic section

This is the Generic part of your contract, where you will define global key information such as:

  • Code* → Contract internal code

  • Description → Contract internal description

  • Start date* → The contract’s first day of application

  • End date* → The contract’s last day of application (end date can be updated even if contract is already active

  • Contract account level* → To which level of the hierarchy will this contract be attached

  • Attached entity* → Once hierarchy level chosen, which entity will it be attached to

  • Contract date* → The contract’s signature date (which is usually different from the start date

When all mandatory fields are filled, hit the SAVE button.

Discount lines section

You then see the updated page as below:

The contract has been properly saved as we now have its STATUS and the creation date. A few buttons are also available now that the contract has been created.

First, did you notice that two new options appeared in the Generic section:

  • Renewable

  • Duration in months

This option allows you to define if a contract can be renewed, and for how many months. Note that these two options are in read only once you have activated your Contract.

A new section has appeared, and this is where you will be able to manage the contract lines. Now what must be clear before going any further is that a framework agreement will override the prices for targeted charges, so that means the more charges you will have in your Contract, the more lines you will have to create and manage.

Contract line creation


Let’s start with the first tab of the second section, which is Contract line. There you will create and then see all lines related to the contract. So let’s jump right to it!

This is the page you arrive on after hitting the 'CREATE' button on the contract line tab.You may have noticed that this looks like what we have seen earlier on the Contracts management, whoch means we will have other sections/pages after this first step.

  • Code*

  • Description

  • Offer → Chose if you want your contract line to be dependent of the offer, and then to the targeted charge linked to this offer.

  • Product → Chose if you want your contract line to be dependent of the product, and then to the targeted charge linked to this offer. You can also combine Offer + Product to target even more a charge.

  • Charge* → Define the actual charge that will be impacted by this contract line.

  • Contract line type → Opencell now has 4 different line types. We will give examples for each of them.

    • Global price

    • Global discount ( % )

    • Custom contract price

    • Custom contract discount ( % )

  • Other fields after depend on the contract line type that is chosen above. This will be explained below.

For a Contract line, the Charge is always mandatory as it is the object that represents the pricing. However, using the Product and/or the Offer fields can allow you to add granularity to the contract line application.

Since the layout of the page changes based on the Contract lien type, we will now go into more details for the four of them.

Global price


When selecting this type, you will then be able to define the numerical price that you will apply for your charge, as below:

This can be done for any charge type, even those who have a price matrix! So in our example, whenever the customer Wayne (check generic section) will have the OC offer, with product P02, then the price of the CH Implem charge will be of 10 000€.

It is possible to add any discount types when user creates either the quote, or the order s-he will be able to add the discounts, as usual 😉

When done, save and go back to create other lines or activate your Contract.

Global discount ( % )


This type defines the percentage discount that will be applied to the all the targeted charge’s prices.

image-20250220-141615.png

This again means that this can be used for price versions with and without grids.

When done, save and go back to create other lines or activate your Contract.

You will notice additional options:

  • Generate separate discount line
    By default, the contracted unit price is the result of the discount application.
    But sometimes, you’ll want to see the discount as a separate rated item, especially if you want to apply different article mapping and/or accounting accounts to the discount and the charge.

  • Apply on overridden price
    If unset, prices manually entered on quotes will not benefit from the discount.

Custom contract price


The custom prices for contract lines are a new way to define the charge’s tariffs. The logic is slightly different from what we have seen so far. These types will allow you to build more complex FrAg lines, based on price grids. So both Custom types will either allow you to duplicate a Price version that is a grid (Matrix=True), or to create a new one from scratch. You will then be able to create a whole new matrix for your targeted charge.

As you can see above, after selecting the Custom contract type, the system then gives you two options:

  • Select a price version to duplicate → Only matrix Price versions are visible here

    Pop-up with eligible PVs appears

You have selected one available PV, and hit the ‘DUPLICATE’ button

Targeted PV has been duplicated to for you to modify

You access the newly created PV, and start modifying it

As for regular charge creation, you will be able to add Business attributes to your grid, but not new Custom attributes.

As the type selected here is Custom contract price, you define the numerical price for targeted lines. If some lines of the grid to not interest you, or are not impacted by the FrAg, then you can simply delete the lines. Same logic stands for lines that do not exist perhaps in the regular Price Version, you can create new combinations.

Once you are all done with your Price version, you can save and Publish it.

Custom contract discount ( % )


This type works exactly as the Custom contract price, and the difference is that prices are defined via a percentage (and not a numerical value).

Custom discount contract line also features the same discount specific options as the global discount contract line (generate separate discount line, apply on overridden price)

In our example, we have followed the same steps as for Custom contract prices

This is the new price version created from Custom contract discount ( % )

From here, you will not have a price per line, but the percentage (positive or negative) that you want to apply to each line.

It is possible here to create new combination, delete lines, and add business attributes to the grid.

Let’s not forget that for Custom types, you can create from scratch you own grid, as below:

In our example here, you are able to add the Custom attributes that were initially linked to the charge via the product. You also can add business attributes!

Billing Rules tab


This is a great option when you have complex model between Billing accounts (BA) of the Opencell hierarchy.

  • Criteria EL → Define criterion to target rated transactions that you wan to move from one BA to another

  • Invoiced billing account EL → Define the BA that will receive the rated transactions

This feature is pretty advanced and is hidden by default.
You can activate it on the feature management page.

Where to find Contracts?


As e have seen at the beginning of this page, you can apply a contract to almost any level of the hierarchy. However, since the complete hierarchy is not visible through the portal, how to know if contracts can impact Billing Accounts (BA)? We have added a new filter on the Customer 360 view which allows you to see all Contracts that can have an impact on the BA (Customer on the portal).

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.