SalesPlatform vtiger crm 620 Использование Шаблонов PDF
Материал из SalesPlatform Wiki
Краткий обзор
Шаблоны PDF системы SalesPlatform vtiger CRM являются гибким механизмом настройки печатных форм для Счетов, Предложений и Заказов на продажу.
Страница редактирования шаблона
Страница редактирования шаблона PDF содержит область свойств и область редактирования.
В области свойств необходимо указать следующие обязательные параметры шаблона:
- Название шаблона - произвольная строка, которая будет обозначать созданный шаблон.
- Модуль - выбор из выпадающего списка модуля, к которому относится шаблон.
- Размер заголовка - высота в пикселях заголовка шаблона. Заголовок шаблона задается блоком {header}.
- Размер нижнего колонтитула - высота в пикселях нижнего колонтитула шаблона. Нижний колонтитул шаблона задается блоком {footer}.
- Ориентация страницы - выбор из выпадающего списка типа ориентации (Книжная или Альбомная).
В области редактирования вводится тело шаблона. Тело шаблона представляет собой разметку HTML, разделенную на блоки. Каждый блок ограничен двумя специальными тэгами - открывающим и закрывающим:
{название_блока}
...
{/название_блока}
Блоки шаблонов Счетов, Предложений, Заказов на продажу и Заказов на Закупку
Типичный шаблон Счета, Предложени, Заказа на продажу или Заказа на Закупку состоит из блоков header, table_head, table_row, summary, ending, footer:
{header}
...
{/header}
{table_head}
...
{/table_head}
{table_row}
...
{/table_row}
{summary}
...
{/summary}
{ending}
...
{/ending}
{footer}
...
{/footer}
Блок header
Это необязательный блок, который размещается вверху первой страницы печатного документа и, как правило, используется для выдачи стандартной шапки документа.
Блок table_head
Это обязательный блок, который выводится один раз перед таблицей товаров (услуг) печатного документа. Используется для задания шапки таблицы.
Блок table_row
Это обязательный блок, который выводится для каждого товара (услуги) печатного документа.
Блок summary
Это обязательный блок, который выводится один раз непосредственно после таблицы товаров (услуг). Используется для вывода суммарной стоимости и налогов.
Блок ending
Это необязательный блок, который размещается один раз в конце печатного документа и, как правило, используется для выдачи подписей и других завершающих элементов.
Это необязательный блок, который выводится внизу каждой страницы документа.
Блоки шаблонов Заявок и Сделок
Типичный шаблон Заявки или Сделки состоит из блоков header, content:
{header}
...
{/header}
{content}
...
{/content}
Блок header
Это необязательный блок, который размещается вверху первой страницы печатного документа и, как правило, используется для выдачи стандартной шапки документа.
Блок content
Это обязательный блок, который содержит основное тело формируемого документа PDF.
Подставляемые переменные
Шаблоны PDF позволяют вставлять в печатные документы переменные, которые при выдаче заменяются данными из соответствующей записи CRM. Подставляемые переменные имеют вид:
{$название_переменной}
Для каждого модуля есть свой набор общих переменных, которые включают все поля выводимой на печать записи CRM, а также все поля связанных записей (например, Контрагентов и Контактов). Кроме того, в блоках table_row и summary доступны специальные переменные, которые рассчитываются на основе списка товаров (услуг).
Данные собственной организации, доступные во всех модулях
| Название переменной | Значение |
|---|---|
| orgAddress | Адрес |
| orgCity | Город |
| orgState | Область |
| orgCountry | Страна |
| orgCode | Индекс |
| orgBillingAddress | Полный юр. адрес организации |
| orgPhone | Тел. |
| orgFax | Факс |
| orgWebsite | Вебсайт |
| orgInn | ИНН |
| orgKpp | КПП |
| orgBankAccount | Расч. счет |
| orgBankName | Банк |
| orgBankId | БИК |
| orgCorrAccount | Корр. счет |
| orgDirector | Руководитель |
| orgBookkeeper | Гл. бухгалтер |
| orgEntrepreneur | Инд. предприниматель |
| orgEntrepreneurreg | Св-во о регистрации ИП |
| orgLogo | Логотип организации |
| orgLogoPath | Путь к логотипу организации |
| orgName | Название организации |
Переменные модуля Счета
| Название переменной | Значение |
|---|---|
| invoice_subject | Тема |
| invoice_customerno | Номер Клиента |
| invoice_invoicedate | Дата |
| invoice_duedate | Дата Оплаты |
| invoice_vtiger_purchaseorder | Заказ на Закупку |
| invoice_txtAdjustment | Исправление |
| invoice_salescommission | Комиссия |
| invoice_exciseduty | Акциз |
| invoice_hdnSubTotal | Итого |
| invoice_hdnGrandTotal | Всего |
| invoice_hdnTaxType | Тип Налога |
| invoice_hdnDiscountPercent | Процент Скидки |
| invoice_hdnDiscountAmount | Сумма Скидки |
| invoice_hdnS_H_Amount | Сумма доставки |
| invoice_invoicestatus | Состояние |
| invoice_createdtime | Создано |
| invoice_modifiedtime | Изменено |
| invoice_conversion_rate | Курс |
| invoice_bill_street | Юридический адрес |
| invoice_ship_street | Фактический адрес |
| invoice_bill_city | Ю/А Город |
| invoice_ship_city | Ф/А Город |
| invoice_bill_state | Ю/А Область |
| invoice_ship_state | Ф/А Область |
| invoice_bill_code | Ю/А Индекс |
| invoice_ship_code | Ф/А Индекс |
| invoice_bill_country | Ю/А Страна |
| invoice_ship_country | Ф/А Страна |
| invoice_bill_pobox | Ю/А а/я |
| invoice_ship_pobox | Ф/А а/я |
| invoice_description | Описание |
| invoice_terms_conditions | Сроки и Условия |
| invoice_no | Счет № |
Переменные модуля Предложения
| Название переменной | Значение |
|---|---|
| quote_no | Предложение № |
| quote_subject | Тема |
| quote_quotestage | Стадия |
| quote_validtill | Действительно до |
| quote_carrier | Перевозчик |
| quote_hdnSubTotal | Итого |
| quote_shipping | Доставка |
| quote_txtAdjustment | Корректировка |
| quote_hdnGrandTotal | Итого |
| quote_hdnTaxType | Тип Налога |
| quote_hdnDiscountPercent | Процент Скидки |
| quote_hdnDiscountAmount | Сумма Скидки |
| quote_hdnS_H_Amount | Сумма доставки |
| quote_createdtime | Создано |
| quote_modifiedtime | Изменено |
| quote_conversion_rate | Курс |
| quote_bill_street | Юридический адрес |
| quote_ship_street | Фактический адрес |
| quote_bill_city | Ю/А Город |
| quote_ship_city | Ф/А Город |
| quote_bill_state | Ю/А Область |
| quote_ship_state | Ф/А Область |
| quote_bill_code | Ю/А Индекс |
| quote_ship_code | Ф/А Индекс |
| quote_bill_country | Ю/А Страна |
| quote_ship_country | Ф/А Страна |
| quote_bill_pobox | Ю/А а/я |
| quote_ship_pobox | Ф/А а/я |
| quote_description | Описание |
| quote_terms_conditions | Сроки и Условия |
Переменные модуля Заказы
| Название переменной | Значение |
|---|---|
| salesorder_no | Заказ на Продажу № |
| salesorder_subject | Наименование |
| salesorder_customerno | Клиент № |
| salesorder_vtiger_purchaseorder | Заказ на Закупку |
| salesorder_duedate | Срок оплаты |
| salesorder_carrier | Доставка |
| salesorder_pending | В ожидании |
| salesorder_sostatus | Статус |
| salesorder_txtAdjustment | Согласование |
| salesorder_salescommission | Комиссионные |
| salesorder_exciseduty | Акцизный сбор |
| salesorder_hdnGrandTotal | Всего |
| salesorder_hdnSubTotal | Итого |
| salesorder_hdnTaxType | Тип Налога |
| salesorder_hdnDiscountPercent | Процент Скидки |
| salesorder_hdnDiscountAmount | Сумма Скидки |
| salesorder_hdnS_H_Amount | Сумма доставки |
| salesorder_createdtime | Создан |
| salesorder_modifiedtime | Изменен |
| salesorder_conversion_rate | Курс |
| salesorder_bill_street | Юридический адрес |
| salesorder_ship_street | Фактический адрес |
| salesorder_bill_city | Ю/А Город |
| salesorder_ship_city | Ф/А Город |
| salesorder_bill_state | Ю/А Область |
| salesorder_ship_state | Ф/А Область |
| salesorder_bill_code | Ю/А Индекс |
| salesorder_ship_code | Ф/А Индекс |
| salesorder_bill_country | Ю/А Страна |
| salesorder_ship_country | Ф/А Страна |
| salesorder_bill_pobox | Ю/А а/я |
| salesorder_ship_pobox | Ф/А а/я |
| salesorder_description | Описание |
| salesorder_terms_conditions | Сроки и Условия |
| salesorder_enable_recurring | Включить Периодичность |
| salesorder_recurring_frequency | Периодичность |
| salesorder_start_period | Начало |
| salesorder_end_period | Конец |
| salesorder_payment_duration | Продолжительность Оплаты |
| salesorder_invoicestatus | Статус Счета |
Переменные модуля Закупки
| Название переменной | Значение |
|---|---|
| purchaseorder_no | Заказ на Закупку № |
| purchaseorder_subject | Наименование |
| purchaseorder_tracking_no | Отслеживаемый Номер |
| purchaseorder_requisition_no | Заказ № |
| purchaseorder_duedate | Срок оплаты |
| purchaseorder_carrier | Доставка |
| purchaseorder_postatus | Статус |
| purchaseorder_txtAdjustment | Согласование |
| purchaseorder_salescommission | Комиссия |
| purchaseorder_exciseduty | Акциз |
| purchaseorder_hdnGrandTotal | Всего |
| purchaseorder_hdnSubTotal | Итого |
| purchaseorder_hdnTaxType | Тип Налога |
| purchaseorder_hdnDiscountPercent | Процент Скидки |
| purchaseorder_hdnDiscountAmount | Сумма Скидки |
| purchaseorder_hdnS_H_Amount | Сумма доставки |
| purchaseorder_createdtime | Создан |
| purchaseorder_modifiedtime | Изменен |
| purchaseorder_conversion_rate | Курс |
| purchaseorder_bill_street | Юридический адрес |
| purchaseorder_ship_street | Фактический адрес |
| purchaseorder_bill_city | Ю/А Город |
| purchaseorder_ship_city | Ф/А Город |
| purchaseorder_bill_state | Ю/А Область |
| purchaseorder_ship_state | Ф/А Область |
| purchaseorder_bill_code | Ю/А Индекс |
| purchaseorder_ship_code | Ф/А Индекс |
| purchaseorder_bill_country | Ю/А Страна |
| purchaseorder_ship_country | Ф/А Страна |
| purchaseorder_bill_pobox | Ю/А а/я |
| purchaseorder_ship_pobox | Ф/А а/я |
| purchaseorder_description | Описание |
| purchaseorder_terms_conditions | Сроки и Условия |
Переменные модуля Контрагенты
| Название переменной | Значение |
|---|---|
| account_accountname | Контрагент |
| account_account_no | Контрагент № |
| account_phone | Тел. |
| account_website | Веб сайт |
| account_fax | Факс |
| account_tickersymbol | Краткое Название |
| account_otherphone | Доп.тел. |
| account_email1 | Адрес Email |
| account_employees | Кол-во сотрудников |
| account_email2 | Доп.Email |
| account_ownership | Форма |
| account_rating | Рейтинг |
| account_industry | Отрасль |
| account_siccode | Код по классификатору |
| account_accounttype | Тип |
| account_annual_revenue | Годовой доход |
| account_emailoptout | Не отправлять эл.почту |
| account_notify_owner | Уведомлять ответственного |
| account_createdtime | Создано |
| account_modifiedtime | Изменено |
| account_inn | ИНН |
| account_kpp | КПП |
| account_bill_street | Юридический адрес |
| account_ship_street | Фактический адрес |
| account_bill_city | Ю\А Город |
| account_ship_city | Ф/А Город |
| account_bill_state | Ю/А Область |
| account_ship_state | Ф/А Область |
| account_bill_code | Ю/А Индекс |
| account_ship_code | Ф/А Индекс |
| account_bill_country | Ю/А Страна |
| account_ship_country | Ф/А Страна |
| account_bill_pobox | Ю/А а/я |
| account_ship_pobox | Ф/А а/я |
| account_description | Описание |
Переменные модуля Контакты
| Название переменной | Значение |
|---|---|
| contact_salutationtype | Обращение |
| contact_firstname | Имя |
| contact_contact_no | Контакт № |
| contact_phone | Рабочий тел. |
| contact_lastname | Фамилия |
| contact_mobile | Мобильный тел. |
| contact_homephone | Домашний тел. |
| contact_leadsource | Источник |
| contact_otherphone | Другой тел. |
| contact_title | Должность |
| contact_fax | Факс |
| contact_department | Отдел |
| contact_birthday | День рождения |
| contact_email | Адрес E-mail |
| contact_assistant | Ассистент |
| contact_yahooid | Yahoo Id |
| contact_assistantphone | Тел.ассистента |
| contact_donotcall | Не звонить |
| contact_emailoptout | Не отпралять Email |
| contact_reference | Рекомендации |
| contact_notify_owner | Уведомлять ответственного |
| contact_createdtime | Создано |
| contact_modifiedtime | Изменено |
| contact_portal | Пользователь портала |
| contact_support_start_date | Дата начала обслуживания |
| contact_support_end_date | Дата окончания обслуживания |
| contact_mailingstreet | Улица |
| contact_otherstreet | Доп.адрес: улица |
| contact_mailingcity | Город |
| contact_othercity | Доп.адрес: город |
| contact_mailingstate | Область |
| contact_otherstate | Доп.адрес: область |
| contact_mailingzip | Индекс |
| contact_otherzip | Доп.адрес: индекс |
| contact_mailingcountry | Страна |
| contact_othercountry | Доп.адрес: страна |
| contact_mailingpobox | Абонентский Ящик |
| contact_otherpobox | Другой а/я |
| contact_description | Описание |
Переменные модуля Поставщики
| Название переменной | Значение |
|---|---|
| vendor_vendorname | Название Поставщика |
| vendor_email | |
| vendor_glacct | Счет в Главной Книге |
| vendor_vendor_no | Поставщик № |
| vendor_phone | Тел. |
| vendor_website | Веб сайт |
| vendor_category | Категория |
| vendor_createdtime | Время Создания |
| vendor_modifiedtime | Время Изменения |
| vendor_street | Улица |
| vendor_city | Город |
| vendor_state | Область |
| vendor_postalcode | Индекс |
| vendor_country | Страна |
| vendor_pobox | А/я |
| vendor_description | Описание |
Переменные модуля Сделки
| Название переменной | Значение |
|---|---|
| potential_potentialname | Название Сделки |
| potential_owner | Ответственный |
| potential_opportunity_type | Тип |
| potential_leadsource | Источник |
| potential_no | Сделка № |
| potential_amount | Сумма |
| potential_closingdate | Ожидаемая Дата Закрытия |
| potential_nextstep | Дальнейшие Действия |
| potential_sales_stage | Стадия |
| potential_probability | Вероятность |
| potential_createdtime | Создано |
| potential_modifiedtime | Изменено |
| potential_description | Описание |
Переменные модуля Заявки
| Название переменной | Значение |
|---|---|
| helpdesk_ticket_title | Название |
| helpdesk_owner | Ответственный |
| helpdesk_ticketpriorities | Приоритет |
| helpdesk_ticketseverities | Важность |
| helpdesk_days | Дней |
| helpdesk_ticket_no | Заявка № |
| helpdesk_ticketstatus | Состояние |
| helpdesk_hours | Часов |
| helpdesk_ticketcategories | Категория |
| helpdesk_createdtime | Создано |
| helpdesk_modifiedtime | Изменено |
| helpdesk_solution | Решение |
| helpdesk_description | Описание |
Переменные модуля Товары
| Название переменной | Значение |
|---|---|
| product_productname | Товар |
| product_discontinued | Активен |
| product_sales_start_date | Дата начала продаж |
| product_sales_end_date | Дата окончания продаж |
| product_productcategory | Категория Товара |
| product_vendor_part_no | Код Поставщика |
| product_productsheet | Характеристики |
| product_customs_id | Номер ГТД |
| product_product_no | Товар № |
| product_productcode | Код товара |
| product_manufacturer | Производитель |
| product_start_date | Начало Сопровождения |
| product_expiry_date | Окончание Сопровождения |
| product_website | Веб-сайт |
| product_mfr_part_no | Код Производителя |
| product_serial_no | Серийный Номер |
| product_glacct | Счёт в гл.книге |
| product_manuf_country | Страна происхождения |
| product_manuf_country_code | Код страны |
| product_createdtime | Создан |
| product_modifiedtime | Изменен |
| product_unit_price | Цена за Единицу |
| product_taxclass | Класс Налога |
| product_commissionrate | Комиссия |
| product_usageunit | Единица Измерения |
| product_qtyinstock | Кол-во на Складе |
| product_unit_code | Код единицы измерения |
| product_qty_per_unit | Кол-во/Ед. |
| product_reorderlevel | Пороговый остаток для дозаказа |
| product_qtyindemand | Минимальный Заказ |
| product_description | Описание |
Специальные переменные блока table_row
| Название переменной | Значение |
|---|---|
| productNumber | Номер позиции товара (услуги) по порядку |
| productName | Наименование товара (услуги) |
| productCode | Код товара |
| productQuantity | Количество товара |
| productQuantityInt | Количество товара без знаков после запятой |
| productUnits | Единицы измерения |
| productUnitsCode | Код единицы измерения |
| productPrice | Цена |
| productPriceWithTax | Цена с налогом |
| productDiscount | Скидка |
| productNetTotal | Стоимость без налогов и скидок |
| productTax | Налог |
| productTaxPercent | % налога |
| productTotal | Стоимость |
| productDescription | Описание товара (услуги) |
| productComment | Комментарий |
| manufCountry | Страна происхождения |
| manufCountryCode | Код страны происхождения |
| customsId | Номер ГТД |
| productImage | Изображение товара |
| productImagePath | Путь к изображению товара (для использования в теге IMG) |
Специальные переменные блока summary
| Название переменной | Значение |
|---|---|
| summaryNetTotal | Сумма без налогов и скидок |
| summaryDiscount | Скидка |
| summaryTax | Сумма налогов |
| summaryTaxLiteral | Сумма налогов прописью |
| summaryTaxPercent | Суммарный % налогов |
| summaryShipping | Стоимость доставки |
| summaryShippingTax | Налог на доставку |
| summaryShippingTaxPercent | % налога на доставку |
| summaryAdjustment | Корректировка |
| summaryGrandTotal | Всего |
| summaryGrandTotalLiteral | Всего прописью |
Некоторые тонкости
Стандартный формат вывода даты - длинный, например, 15 Августа 2011 г. Однако, добавив к названию любой переменной даты суффикс _short, получим дату в коротком формате (например, 15.08.11).
Текстовые значения некоторых переменных по-умолчанию выводятся на английском языке (например, стандартные списки). Получить перевод этих значений можно, добавив к названию переменной суффикс _translated.
