Before getting started with the Oneflow integration, make sure to pay attention to the following:

Special notes:
Only users with admin rights can perform the initial setup of the SuperOffice integration.
You need to log in to Oneflow and SuperOffice with the same email.
The user that sets up the integration should have admin rights in both Oneflow and SuperOffice.

Enable the SuperOffice integration in Oneflow

As the first step, you will need to enable the SuperOffice integration in Marketplace in Oneflow.

1. Log on to Oneflow as an administrator, go to Marketplace > Click on SuperOffice and then on Enable.
   
   
2. Click on the SuperOffice link to go to the settings page, then click Authenticate to SuperOffice.
   
3. You will be redirected to SuperOffice. Log in to the account for which you want to set up the integration.
   

   Note:
   You can set up the integration only for a single SuperOffice account.

4. When you log in, you will be redirected back to the SuperOffice page in Oneflow.
   Once you log in to your SuperOffice account, the Oneflow web panel should now be visible in the Oneflow Contract tab at the bottom of the Sale screen.  

   Note:
   If the web panel is not displayed, you need to call the following URL: https://online.superoffice.com/CustXXXX/default.aspx?flush. 
   		
   In the URL, replace CustXXXX with your actual customer ID. You can see the customer ID in the SuperOffice page URL.
   		
   

5. Inside the web panel, you might have to log in to the same account again that you are currently logged in with.
   If you accidentally choose the wrong account in the web panel, the page will let you choose again.

Create a contract template in Oneflow

Create templates in Oneflow that you would like to use in SuperOffice.

1. Go to Templates > Create template. 
   
2. Create the template content to match your requirements. Click on the Data fields icon in the side panel. From the Template groups dropdown, select Superoffice.
   

   Note:

   To attach PDFs to contracts, make sure to add a PDF documents section to the template. To attach other file types to contracts, make sure to add an Attachments section to the template.

3. Click on the Publish button to activate the template.
   

Notes:
As a Oneflow administrator, register the users with the same email address they use in the associated SuperOffice account.
By default, the Oneflow panel will be visible for all user groups. If you want to hide it from specific user groups, please modify the configuration (Settings and maintenance - Lists - GUI Web panel - Oneflow Contract).
If you want to remove the integration, you can disable it in Oneflow and remove the web panel from SuperOffice (Settings and maintenance - Lists - GUI Web panel - Oneflow Contract).

Now it's time to create contracts! Proceed to the Create a contract in SuperOffice chapter to learn how.

Stage Mapping

This feature automatically sets the Sale's stage in SuperOffice based on the status of your Oneflow contract.

When stage mapping is enabled, and the Oneflow contract is signed, the corresponding Sale’s stage will be set to Closed and Won. Conversely, when a Oneflow contract is declined, the corresponding Sale’s stage will be set to Closed and Lost.

To enable stage mapping:

1. Log in to SuperOffice as an administrator.
2. Open a Sale or create a new one.
3. Click on the Oneflow Contract tab.
4. Click on Oneflow Settings.
5. Enable the Stage Mapping toggle.