S-Docs works great with the quote, orders and other standard object. Not all organizations have these salesforce features enabled, so they are not configured with S-Docs out-of-the-box. This document will show how to configure S-Docs with the salesforce Quote object, but the same instructions are used with other standard objects that are not included in the S-Docs package.

With S-Docs for Salesforce, you have much more power in generating quotes and documents to look exactly as you want them. You can include many more related objects, filter and group your line items, format tables, include multiple logos, insert product images, insert a terms and conditions section and then email your generated quote as an MS Word, PDF or MS Excel file.

Since Quotes functionality within Salesforce is not enabled by default, not every org has enabled this feature. To avoid errors and confusion, by default S-Docs does not have quotes configured with the base install package. To take advantage of S-Docs with quotes you will need to complete 3 configuration steps.

  1. Add “Quote” as an available picklist value for S-Docs Templates
  2. Create a lookup field named “Quote__c” (note the two underscores) on the SDoc Relationship object.
  3. Create an S-Docs button and place it on your quote page layout.

Detailed instructions are provided below. Once you have completed these, you can create your quote template. We’ve provided a sample template in the appendix of this document that you can copy/paste into your template source.

STEP 1: Add "Quote" to "Related to type" field on the "SDoc Template" object:

  1. Click on setup link (found on at top-right corner of your salesforce homepage)  step1-sdocs
  2. Click App Setup➤Create➤Object step 1-sdocs-1
  3. Click on the "SDoc Template" link (not the edit link) step1-sdocs-2
  4. Click on the "Related to Type" link ( found under "custom fields and relationships" section). Don't click on edit or replace links. step 1-sdocs-3
  5. Scroll down to "Picklist Values" section and click on the new button step 1-sdocs-4
  6. Add "Quote" as a picklist value, then click Savequote6

STEP 1b: Confirm you can create a Quote template:

You should now be able to create a template and choose "Quote" from the picklist in the "Related to type" field. Make sure that "Available for use" and "Initially Visible" checkboxes are checked.

STEP 2: Add "Quote" lookup field:

This step allows you to associate the S-Doc with the Quote object, so that users can see a related list of all S-Docs created related to a quote.

  1. Click Setup ➤ App Setup➤ Create ➤Objects
  2. Select SDOC_Relationship
  3. Under Custom Fields and Relationships click "New Button", you will enter the new field wizard:

Step 1 of 6 - Pick "Lookup Relationship" click next
Step 2 of 6 - Select "Quote" from picklist values, then click next
Step 3 of 6 - Field label and field name should be "Quote", click next
Step 4 of 6 - Checkbox should be visible for all users
Step 5 of 6 - Checkbox should add the field for the layout
Step 6 of 6 - accept default, click "Save" button

STEP 3: Create a button to place it on your Quote page:

Just like using S-Docs with other objects, you need to place an S-Docs button on the detail record layout in order for the user to initiate creating a document.

  1. Go to Setup➤App Setup➤Customize➤Quotes➤Buttons and Links step3.1
  2. Click "New" Button step-3.2
  3. Type the button Label (e.g. "S-Docs")
  4. Display Type: choose Detail Page Button
  5. Choose a Behavior (we recommend 'Display in existing Window with Sidebar')
  6. Content Source: Choose URL
  7. Use the following URL without quotes (note that double underscores are used) /apex/SDOC__SDCreate1?id={!Quote.Id}&Object=Quote
  8. *Optional* You can have users save clicks by enabling the “One-Click” feature. Enabling this will bypass the document creation wizard. An administrator simply needs to change the button definition to include a list of preselected S-Docs template IDs that will be automatically generated. Placing this button will let users create the all the documents encoded in the button without any additional interaction. The button syntax uses a parameter called “doclist”, which is followed by one or more template IDs to be auto-generated. Here is an example of the button syntax: (replace the highlighted values with your own template Ids):
    /apex/SDOC__SDCreate1?id={!Quote.Id}&Object=Quote&doclist=a02G0000005CiDO,a02G0000005CeCS

    For more information on the one-click and zero-click features click here.step-3.8

  9. Click "Save"

Step 2b: Place button on your page layout

  1. Go to the page layout: Setup➤App Setup➤Customize➤Quotes➤Page Layouts
  2. Click the Edit button (and repeat for each page you would like to add the button to)
  3. Click  "Buttons" from the top left toolbar menu to highlight and view buttons available
  4. Click and drag the button you just created into the lower Quote Detail section
  5. As you are dragging the button you will see a green checkbox (indicating ok to drop) once you drag the button to the right of the existing buttons in an area marked "Custom Buttons"
  6. Once you have added the button, save the page layout and repeat steps 2-6 for any other layouts where you would like to add the button.

If you already have a quote template created, you can now open a quote record, click on the S-Docs button, create your S-Docs quote and it will automatically be associated to the quote record. The next section helps you create your quote template if you haven’t done so.