Пропустить и перейти к основному содержимому
Элементы не найдены.
Логотип Dropbox Sign
Почему именно Dropbox Sign
Развернутый или свернутый графический элемент «Аккордеон»

Что вы можете сделать

Подписать документы онлайн
Создание электронных подписей
Выберите или создайте шаблоны
Заполнить и подписать документы PDF
Подготовить онлайн-контракты
Управление документами
Подробнее о функциях
Значок «Стрелка вправо»

Примеры использования

Продажи и развитие бизнеса
Отдел кадров
Стартапы
Финансовые технологии
Недвижимость
Услуги по запросу
Продукты
Развернутый или свернутый графический элемент «Аккордеон»
значок Dropbox
Sign
Легко и удобно отправляйте и подписывайте документы
значок Dropbox
Sign API
Интегрируйте электронные подписи в свой рабочий процесс
Значок Dropbox Fax
Fax
Отправляйте факсы без использования факсимильного аппарата.
Значок интеграций Dropbox
Интеграция
Мы всегда там, где вам это необходимо
Материалы
Развернутый или свернутый графический элемент «Аккордеон»
Блог
Организация процессов и новости о продукции
Истории наших клиентов
Реальные истории с реальными результатами
Справочный центр
Подробные руководства по нашим продуктам
Библиотека ресурсов
Отчеты, видеоролики и информационные документы
Разработчикам
Тарифы
Развернутый или свернутый графический элемент «Аккордеон»
Тарифы Dropbox Sign
Выберите подходящий для вас тарифный план
Тарифы Dropbox Sign API
Реальные истории с реальными результатами
Отдел продаж
Зарегистрироваться
Обратиться в отдел продаж
Войти
Развернутый или свернутый графический элемент «Аккордеон»
Dropbox Sign
Dropbox Forms
Dropbox Fax
Бесплатный ознакомительный период
Блог
/
Разработчикам

Создание динамически формируемых коммерческих предложений при помощи Dropbox Sign

by 
Ravgeet Dhillon
January 12, 2023
9
мин. на чтение
Создание динамически формируемых коммерческих предложений при помощи редакционной иллюстрации в Dropbox Sign
значок подсказки

Обновленный внешний вид, тот же великолепный продукт! HelloSign теперь называется Dropbox Sign

значок «закрыть»

Creating and sending price quotes is a necessary part of business, but it can also be a laborious process, especially if the sales team sends out multiple quotes daily. You can make things easier on yourself and your sales team by automating your sales quote generation. An excellent way to do that is by using the Dropbox Sign API.


Dropbox Sign allows you to create and send bulk templates, as well as generate dynamic documents such as sales quotes. In this tutorial, you’ll create a command line utility for generating sales quote documents using the Dropbox Sign API. You’ll pass input data as command line arguments, creating emailed sales quote documents that customers can sign digitally.


What Is Dropbox Sign?

Dropbox Sign is an eSignature solution that offers one of the fastest ways to send and receive legally valid electronic signatures. Individuals and companies can use it to quickly and securely complete online employment contracts, insurance documents, and other paperwork, while developers can use the API to create custom workflows. Dropbox Sign integrates with Salesforce, Slack, and Dropbox, among other apps.


Using Dropbox Sign, you can create a template that can be used to create new signature requests as needed. If you decide to update the template, you can change the UI without making any changes to your code. Dropbox Sign has a dedicated developer support team that can assist you with any questions you encounter while building your integration.


Prerequisites

Here is what you’ll need for this tutorial:

  • Node.js (this tutorial uses Node v14.18.2)
  • A Dropbox Sign account

‍

How to prepare to create dynamic sales quotes with Dropbox Sign

‍

Creating the template

First, create a sales quote template. This tutorial uses Google Docs, but use any tool you’re comfortable with. You can also copy this sales quote template, modify it according to your needs, and download it as a PDF.


Setting up Dropbox Sign

Next, set up your template in Dropbox Sign and get your Dropbox Sign API key.


Adding a template in Dropbox Sign

Log in to your Dropbox Sign account. On the Dropbox Sign homepage, click Create a Template.

‍

Upload the PDF of your template and click Next.


Add a Signer role and give it a Role title of `Client`. Click Next.

‍

From the Standard fields, drag and drop a Textbox and add it in front of the Quote ID. From the right sidebar, set Assigned to to `Sender`.

‍

Set the Merge field to `quote_id` so that you can refer to this field when using the API.

‍

Add the other fields and set their corresponding Assigned to and Merge field names as shown below:


For the textbox under the Prepared By field, set the Assigned to to `Me (now)` and set its value to any name—in this case “John Doe”. The value provided here will remain on the document as is, and will be shown on any signature requests created using this template. This value is non-editable via the API, but can be changed by editing the template via the UI. Please note that editing this value will not update the value shown on signature requests created with this template prior to the change being made.


Your Dropbox Sign template should look like the example below. The pink fields are merge fields, and you can set their values using the API. The blue fields must be filled in by the customer.

‍

Review your template, then give it a Template title and an optional Message.

‍

Your template is now created. You’ll get a template ID in the confirmation dialog box, which you’ll need for your Node.js application.

‍

Getting a Dropbox Sign API key

To connect with the Dropbox Sign API, you need an API key. Go to Settings and select the API tab.

‍

Click the Create key button to create your API key.

‍

Setting up a Node app

Next, you’ll set up your Node application. Open your terminal and navigate to a path of your choice. Run the following command to create a project directory (`dynamic-sales-quote`):

mkdir dynamic-sales-quote

‍

You’ll need to install the following npm packages for this application:

  • hellosign-sdk allows you to work with Dropbox Sign APIs programmatically.
  • dotenv allows you to read environment variables from the .env file.
  • minimist allows you to parse arguments passed via the command line to Node.js.
  • uuid allows you to create universally unique IDs.

To install these packages, run the following command in your terminal:

npm i hellosign-sdk dotenv minimist uuid

‍

Next create a `.env` file at the root of your project and add the following environment variables:


HELLOSIGN_API_KEY=<YOUR_HELLOSIGN_API_KEY>
HELLOSIGN_TEMPLATE_ID=<YOUR_HELLOSIGN_TEMPLATE_ID>

‍

Replace `<YOUR_HELLOSIGN_API_KEY>` and `<YOUR_HELLOSIGN_TEMPLATE_ID>` with the appropriate values.

‍

Creating dynamic sales quotes using the Dropbox Sign API

In your project’s root directory, create a `src` directory. In that directory, create an `index.js` file. In the `index.js` file, add the following code:



// 1
require('dotenv').config();
const hellosign = require('hellosign-sdk')({ key: process.env.HELLOSIGN_API_KEY });
const argv = require('minimist');
const { v1: uuidv1 } = require('uuid');


This will import the required npm packages `dotenv`, `hellosign`, `argv`, and `uuid`.

Next, add the following code to the `index.js` file:

‍

...

// 1
let { title, subject, message, name, company, email, price } = argv(process.argv.slice(2));

// 2
title = title ?? 'Web Development Project';
subject = subject ?? 'Freelance Sales Quote';
message = message ?? 'Please sign this sales quote to get started with me.';
name = name ?? 'Alice Wonder';
company = company ?? 'Foobar Inc.';
email = email ?? 'abc@example.com';
price = price ?? 500;


In the above code:


  1. You destructure the command line arguments.
  2. You use the null coalescing operator (`??`) to provide a default value for each of the variables in case they are undefined.

Add the following code to the `index.js` file:

‍



...

// 1
const options = {
  // 2
  test_mode: process.env.NODE_ENV !== 'production' ? 1 : 0,
  // 3
  template_id: process.env.HELLOSIGN_TEMPLATE_ID,
  title: title,
  subject: subject,
  message: message,
  // 4
  custom_fields: [
    {
      name: 'quote_id',
      value: uuidv1(),
    },
    {
      name: 'customer_name',
      value: name,
    },
    {
      name: 'customer_company',
      value: company,
    },
    {
      name: 'price',
      value: price,
    },
    {
      name: 'total',
      value: price,
    },
  ],
  // 5
  signers: [
    {
      email_address: email,
      name: name,
      role: 'Client',
    },
  ],
};

‍

In the above code:

  1. You specify the options for making a signature request using the Dropbox Sign SDK.
  2. You specify the `test_mode` value based on whether the application is running in production.
  3. You specify the `template_id` by reading its value from the environment variables (`process.env.HELLOSIGN_TEMPLATE_ID`).
  4. You specify the values for each of the merge fields (`custom_fields`) that you defined in the template. The `custom_fields` specified in your request will be used to map values of custom fields to the merge fields on your document with identical names.
  5. You specify the signers with the Client role to whom you want to send the signature request.

Finally, add the following code in the `index.js` file:



...

// 1
async function index() {
  try {
    // 2
    await hellosign.signatureRequest.sendWithTemplate(options);
  } catch (err) {
    console.error(err);
    return;
  }
}

index();

‍

In the above code:

  1. You define the main function (`index`) of the application.
  2. You create a templated signature request (`signatureRequest.sendWithTemplate`) using the Dropbox Sign SDK (`hellosign`) and pass the options to it.

Your code is complete and ready to be tested.

Testing the App

To test your Node.js application, run the following command in your terminal and pass the arguments according to your needs:

‍

node src/index.js --email=john@example.com --price=1000

‍

You should see a signature request in the signer’s email account:


Open the email and click REVIEW & SIGN.


You’ll see a dynamically generated sales quote and two fields to complete: Name and Signature under the Service Receiver column.


After filling in the required details, click Submit. Your document is now signed.


Conclusion

As you’ve seen in this tutorial, the Dropbox Sign API and Node.js can help you automatically generate sales quote documents for your sales team. By creating a command line utility, you can pass input data as command line arguments. You can use this utility with your CI/CD service or automation tools, or even link up with Google Sheets to send your company’s signature request to multiple customers at once. You should be able to complete the tutorial in under ten minutes.

‍

Dropbox Sign has a lot to offer your company, from its multiple features to its exceptional developer support. You can start building custom document generation workflows by testing the Dropbox Sign API for free.

Будьте в курсе всего

Готово. Проверьте входящую почту.

Thank you!
Thank you for subscribing!

Lorem ipsum

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse varius enim in eros elementum tristique. Duis cursus, mi quis viverra ornare, eros dolor interdum nulla, ut commodo diam libero vitae erat. Aenean faucibus nibh et justo cursus id rutrum lorem imperdiet. Nunc ut sem vitae risus tristique posuere.

Lorem ipsum
Значок «Стрелка вправо»
значок «закрыть»

Up next:

Изображение крупным планом рукописной подписи, представляющее современные решения для цифровой подписи.
Разработчикам
15
мин. на чтение

Интеграция Dropbox Sign с Ruby on Rails: пошаговое руководство

Изображение крупным планом рукописной подписи, представляющее современные решения для цифровой подписи.
Разработчикам
15
мин. на чтение

Dropbox Sign vs. SignNow for developers

Электронная книга

5 big business benefits of eSignatures in sales

Продукты
Dropbox SignDropbox Sign APIDropbox FaxИнтеграция
Почему именно Dropbox Sign
Электронные подписиПодписать документыЗаполнение и подписание PDFКонтракты в электронной формеСоздание электронных подписейРедактор подписиПодписать документы Word
Поддержка
Справочный центрОтдел продажОбратитесь в службу поддержкиУправление файлами cookieНачало работы с Dropbox SignНачало работы с Dropbox Sign API
Материалы
БлогИстории наших клиентовРесурсный центрРуководство по соблюдению законовЦентр управления безопасностью
Партнеры
Стратегические партнерыПоиск партнеров
Компания
ВакансииУсловияПолитика конфиденциальности
значок Facebookзначок Youtube

Принимаемые способы оплаты

Логотип MastercardЛоготип VisaЛоготип American ExpressЛоготип Discover
Значок соответствия требованиям CPAЗначок, соответствующий требованиям закона HIPAAЗначок Sky High Enterprise ReadyЗначок, сертифицированный по стандарту ISO 9001

Электронные подписи Dropbox Sign являются юридически обязывающими в США, Европейском Союзе, Великобритании и во многих странах мира.
Более подробную информацию вы найдете в наших Условиях и Политике конфиденциальности