Тег — различия между версиями
(→Теги для сотовых телефонов и GSM-шлюзов) |
(→Общие теги) |
||
(не показано 37 промежуточных версий 2 участников) | |||
Строка 1: | Строка 1: | ||
− | '''Тег''' — особая текстовая конструкция внутри большого выражения, которая автоматически заменяется на переменное значение (взятое, например, из | + | '''Тег''' — особая текстовая конструкция внутри большого выражения, которая автоматически заменяется на переменное значение (взятое, например, из базы данных Такси-Мастер, из [[Карточка заказа|карточки заказа]] и т. д.). |
Теги предназначены для того, чтобы в тексте сообщения заменять себя на значение, которое в большинстве случаев берется из программы [[Такси-Мастер]]. | Теги предназначены для того, чтобы в тексте сообщения заменять себя на значение, которое в большинстве случаев берется из программы [[Такси-Мастер]]. | ||
− | Теги вставляются в [[шаблоны СМС-сообщений]]. | + | Теги вставляются в [[шаблоны СМС-сообщений]] и шаблоны E-mail. |
+ | |||
+ | Открыть справочник тегов можно практически из любого окна, где можно использовать теги, например, из окна нового шаблона E-mail, из окна нового шаблона СМС, из окна новой группы экипажей на вкладке уведомлений. Доступные теги зависят от окна, из которого открыт справочник тегов. | ||
Тегов в шаблоне может быть как угодно много, они могут встречаться как угодно часто, но их написание должно точно соответствовать правилам: | Тегов в шаблоне может быть как угодно много, они могут встречаться как угодно часто, но их написание должно точно соответствовать правилам: | ||
Строка 8: | Строка 10: | ||
# Тег является регистрозависимым, то есть {{code|%Тег%}} и {{code|%тег%}} — это разные теги. | # Тег является регистрозависимым, то есть {{code|%Тег%}} и {{code|%тег%}} — это разные теги. | ||
− | == Общие теги == | + | == Теги для СМС и E-mail == |
− | + | === Теги заказа === | |
+ | # {{code|%Order.Id%}} - уникальный индитификатор заказа. | ||
+ | # {{code|%Order.Phone%}} - номер телефона заказчика. | ||
+ | # {{code|%Order.PhoneToDial%}} - номер телефона на отзвон. | ||
+ | # {{code|%Order.SourceAddress%}} - адрес подачи. | ||
+ | # {{code|%Order.DestinationAddress%}} - адрес назначения. | ||
+ | # {{code|%Order.SourceZone%}} - район подачи. | ||
+ | # {{code|%Order.DestinationZone%}} - район назначения. | ||
+ | # {{code|%Order.StopAddresses%}} - адреса остановок. | ||
+ | # {{code|%Order.InputTime%}} - время поступления заказа. | ||
+ | # {{code|%Order.MinBeforeArrive%}} - время до подачи в минутах. | ||
+ | # {{code|%Order.SourceTime%}} - время подачи. Автоматически будет добавляться дата в том случае, если дата подачи в заказе не совпадает с текущей датой. | ||
+ | # {{code|%Order.FinishTime%}} - время завершения. | ||
+ | # {{code|%Order.TaximeterDistance%}} - расстояние по таксометру, км. | ||
+ | # {{code|%Order.TaximeterDuration%}} - общее время пути. | ||
+ | # {{code|%Order.TotalCost%}} - итоговая сумма за заказ. | ||
+ | # {{code|%Order.Cost%}} - сумма за заказ без скидки. | ||
+ | # {{code|%Order.CashSum%}} - сумма наличными. | ||
+ | # {{code|%Order.CashlessSum%}} - сумма безнал. | ||
+ | # {{code|%Order.BonusSum%}} - сумма бонусы. | ||
+ | # {{code|%Order.BankCardSum%}} - сумма банк. карта. | ||
+ | # {{code|%Order.CashAndBankCardSum%}} - сумма наличные + банковская карта. | ||
+ | # {{code|%Order.DiscountSum%}} - сумма скидки. | ||
+ | # {{code|%Order.PayType%}} - тип расчета: наличный и безналичный. | ||
+ | # {{code|%Order.Customer%}} - заказчик из карточки заказа. | ||
+ | # {{code|%Order.PrizePhoneCnt%}} - количество заказов до призового. Текст тега задается в {{путь|Файл - Настройки - Заказы - Призовые заказы}}. | ||
+ | # {{code|%Order.Comment%}} - примечание к заказу. | ||
+ | # {{code|%Order.CreatorTaxiName%}} - название службы-создателя. | ||
+ | # {{code|%Order.CreatorTaxiPhone%}} - телефон службы-создателя. | ||
+ | # {{code|%Order.PerformerTaxiName%}} - название службы-исполнителя. | ||
+ | # {{code|%Order.PerformerTaxiPhone%}} - телефон службы-исполнителя. | ||
+ | # {{code|%Order.Tariff%}} - название тарифа. | ||
+ | # {{code|%Order.Attribute[ID]%}} - значение атрибута заказа. | ||
+ | # {{code|%Order.BankCardInfo%}} - информация о банковской карте. | ||
+ | # {{code|%Order.FiscalReceiptUrl%}} - ссылка на фискальный чек. | ||
+ | |||
+ | === Теги автомобиля === | ||
+ | # {{code|%Car.Number%}} - гос.номер автомобиля. | ||
+ | # {{code|%Car.Color%}} - цвет автомобиля. | ||
+ | # {{code|%Car.Mark%}} - марка автомобиля. | ||
+ | # {{code|%Car.Model%}} - модель автомобиля. | ||
+ | # {{code|%Car.ShortName%}} - короткое название автомобиля. | ||
+ | # {{code|%Car.Attribute[ID]%}} - значение атрибута автомобиля. | ||
+ | # {{code|%Car.Permit%}} - номер разрешения автомобиля. | ||
+ | # {{code|%Car.License%}} - номер лицензии автомобиля. | ||
+ | |||
+ | === Теги экипажа === | ||
+ | # {{code|%Crew.Group%}} - название группы экипажа водителя. | ||
+ | # {{code|%Crew.Code%}} - позывной экипажа. | ||
+ | # {{code|%Crew.Attribute[ID]%}} - значение атрибута экипажа. | ||
+ | |||
+ | === Теги водителя === | ||
+ | # {{code|%Driver.Name%}} - ФИО водителя. | ||
+ | # {{code|%Driver.Phone%}} - основной телефон водителя. | ||
+ | # {{code|%Driver.Balance%}} - текущий баланс счета водителя. | ||
+ | # {{code|%Driver.Attribute[ID]%}} - значение атрибута водителя. | ||
+ | # {{code|%Driver.Inn%}} - ИНН водителя. | ||
+ | # {{code|%Driver.InsuranceNumber%}} - СНИЛС водителя. | ||
+ | # {{code|%Driver.Address%}} - адрес проживания водителя. | ||
+ | # {{code|%Driver.City%}} - город проживания водителя. | ||
+ | # {{code|%Driver.Certificate%}} - номер разрешения на перевозку. | ||
+ | # {{code|%Driver.TemporaryBlockReason%}} - причина временной блокировки водителя. | ||
+ | # {{code|%Driver.LockReason%}} - причина постоянной блокировки водителя. | ||
+ | # {{code|%Driver.DismissReason%}} - причина увольнения водителя. | ||
+ | |||
+ | === Теги клиента === | ||
+ | # {{code|%Client.Id%}} - ИД клиента. | ||
+ | # {{code|%Client.Name%}} - имя клиента. | ||
+ | # {{code|%Client.Number%}} - номер договора клиента. | ||
+ | # {{code|%Client.Balance%}} - баланс клиента. | ||
+ | # {{code|%Client.BonusBalance%}} - бонусный баланс клиента. | ||
+ | # {{code|%Client.TermAccount%}} - терминальный аккаунт клиента. | ||
+ | # {{code|%Client.APILogin%}} - логин API клиента. | ||
+ | # {{code|%Client.APIPassword%}} - пароль API клиента. | ||
+ | # {{code|%Client.ReferralCode%}} - реферальный код клиента. | ||
+ | # {{code|%Client.Attribute[ID]%}} - значение атрибута клиента. | ||
+ | |||
+ | === Теги партнера === | ||
+ | # {{code|%Partner.Name%}} - имя партнера. | ||
+ | # {{code|%Partner.Phone%}} - номер телефона партнера. | ||
+ | # {{code|%Partner.Inn%}} - ИНН партнера. | ||
+ | # {{code|%Partner.Address%}} - адрес партнера. | ||
+ | # {{code|%Partner.Balance%}} - баланс партнера. | ||
+ | |||
+ | === Общие теги === | ||
+ | # {{code|%DateTime%}} - текущая дата и время. | ||
+ | # {{code|%Date%}} - текущая дата. | ||
+ | # {{code|%Time%}} - текущее время. | ||
+ | # {{code|%Advertisement%}} - рекламный текст. Рекламные тексты задаются в {{путь|Файл - Настройки - СМС}}. | ||
+ | # {{code|%GlobalAttribute[ID]%}} - значение глобального атрибута. | ||
+ | # {{code|%auth_code%}} - одноразовый код для аутентификации. | ||
− | == | + | == Устаревшие СМС теги == |
− | + | В справочнике тегов можно включить отображение устаревших тегов, включив опцию "Отображать старые теги". | |
+ | Список полей из [[КЗ|карточки заказа]]: | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
# {{code|%Phone%}} — номер телефона заказчика. | # {{code|%Phone%}} — номер телефона заказчика. | ||
− | # | + | #: Например, шаблон {{code|Заказчик (%Phone%)...}}, если номер клиента - {{code|7159561}}, преобразует текст СМС так: {{code|Заказчик (7159561)...}}. |
# {{code|%CPhone%}} — номер [[Телефон на отзвон|телефона на отзвон]]. | # {{code|%CPhone%}} — номер [[Телефон на отзвон|телефона на отзвон]]. | ||
# {{code|%Src%}} — [[адрес подачи]]. | # {{code|%Src%}} — [[адрес подачи]]. | ||
− | |||
# {{code|%Dest%}} — [[адрес назначения]]. | # {{code|%Dest%}} — [[адрес назначения]]. | ||
− | # {{code|% | + | # {{code|%Amount%}} — сумма за заказ (поле {{field|Сумма}} в [[Карточка заказа|карточке заказа]]). |
− | + | #: Например, шаблон {{code|%Src% - %Dest%, %Amount%}} позволит вставлять в текст сообщения адрес подачи, адрес назначения и сумму за заказ и разделить их тире и запятой. | |
− | # | + | # {{code|%Disc%}} — результирующая скидка в рублях. |
− | # {{code|%Disc%}} — скидка в | + | #: Например, шаблон {{code|Скидка: %Disc% р}} при скидке 5% и стоимости заказа 100 рублей преобразуется в сообщение {{code|Скидка: 5 р}}. |
− | # | ||
− | |||
# {{code|%ITime%}} — время поступления заказа. | # {{code|%ITime%}} — время поступления заказа. | ||
− | # {{code|%PTime%}} — время, | + | # {{code|%PTime%}} — время подачи, то есть время, в которое нужно начать выполнение заказа. Полезно для оповещения водителей о предварительных заказах. |
− | # {{code|%Cou%}} — | + | # {{code|%Cou%}} — |
− | # {{code|%CarType%}} — | + | # {{code|%CarType%}} — тип автомобиля (наименование). |
# {{code|%CarCallID%}} — позывной автомобиля. | # {{code|%CarCallID%}} — позывной автомобиля. | ||
# {{code|%CarGosNum%}} — госномер автомобиля. Этот тег удобен для отправки заказчикам в шаблоне вида {{code|...госномер %CarGosNum%...}}. | # {{code|%CarGosNum%}} — госномер автомобиля. Этот тег удобен для отправки заказчикам в шаблоне вида {{code|...госномер %CarGosNum%...}}. | ||
+ | #: Например, в шаблоне {{code|Машина подана: номер %CarGosNum%, цвет %CarColor%}} содержится информация о госномере и о цвете автомобиля. | ||
# {{code|%CarColor%}} — цвет автомобиля. | # {{code|%CarColor%}} — цвет автомобиля. | ||
− | # | + | # {{code|%CarMark%}} — марка автомобиля. |
− | # | + | # {{code|%Min%}} — время до подачи, которое водитель указал в [[TMDriver]], когда принимал [[заказ]]. |
+ | # {{code|%Client%}} — имя клиента (берется из карточки заказа). | ||
+ | # {{code|%ClientCaption%}} — имя заказчика из карточки [[Справочник «Физические лица»|физического]] или [[Справочник «Юридические лица»|юридического]] лица. | ||
# {{code|%CarArrive%}} — фактическое время подачи машины, указанное в часах и минутах. В отличие от {{code|%Min%}}, абсолютное время {{серым|(«Машина будет в 12:45»)}} является более надежным, чем относительное {{серым|(«Машина будет через 5 минут»)}}, поскольку из-за задержки отправки сообщения не теряет актуальность. | # {{code|%CarArrive%}} — фактическое время подачи машины, указанное в часах и минутах. В отличие от {{code|%Min%}}, абсолютное время {{серым|(«Машина будет в 12:45»)}} является более надежным, чем относительное {{серым|(«Машина будет через 5 минут»)}}, поскольку из-за задержки отправки сообщения не теряет актуальность. | ||
− | # {{code|% | + | # {{code|%Description%}} — примечание к заказу. Будьте осторожны: объемы данных в этом поле могут быть велики с точки зрения номинального объема СМС. |
− | # {{code|% | + | # {{code|%orderid%}} — уникальный идентификатор заказа (его номер). |
− | # {{code|% | + | # {{code|%PrizePhoneCnt%}} — количество заказов до призового (текст задается в [[Параметры модуля СМС#Формат тегов|параметрах]]). |
− | # {{code|% | + | # {{code|%TaximeterDistance%}} — расстояние по таксометру в километрах. |
+ | # {{code|%TaximeterDuration%}} — общее время в пути. | ||
− | + | Список полей из карточки водителя: | |
− | |||
− | # | + | # {{code|%DrvAmount%}} — текущий счет водителя. Тег удобен для оповещения водителей о состоянии их счетов при выходе на смену. |
− | # | + | # {{code|%DriverCellPhone%}} — сотовый телефон водителя. |
− | # | + | # {{code|%DriverHomePhone%}} — домашний телефон водителя. |
− | # | + | # {{code|%DriverName%}} — полное имя водителя (ФИО). |
− | |||
− | + | Список дополнительных данных: | |
− | + | # {{code|%DateTime%}} — текущие дата и время. | |
− | + | # {{code|%Date%}} — текущая дата. Формат даты задается в параметрах. | |
− | + | # {{code|%Time%}} — текущее время. Формат времени задается в параметрах. | |
− | |||
− | # {{code|% | ||
− | # {{code|% | ||
− | # {{code|% | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | == Ссылки == | |
+ | * [[СМС-сервер]] | ||
+ | * [[SMPP]] | ||
[[Категория:Модуль СМС]] | [[Категория:Модуль СМС]] | ||
[[Категория:AUO]] | [[Категория:AUO]] |
Текущая версия на 10:42, 14 ноября 2024
Тег — особая текстовая конструкция внутри большого выражения, которая автоматически заменяется на переменное значение (взятое, например, из базы данных Такси-Мастер, из карточки заказа и т. д.). Теги предназначены для того, чтобы в тексте сообщения заменять себя на значение, которое в большинстве случаев берется из программы Такси-Мастер. Теги вставляются в шаблоны СМС-сообщений и шаблоны E-mail.
Открыть справочник тегов можно практически из любого окна, где можно использовать теги, например, из окна нового шаблона E-mail, из окна нового шаблона СМС, из окна новой группы экипажей на вкладке уведомлений. Доступные теги зависят от окна, из которого открыт справочник тегов.
Тегов в шаблоне может быть как угодно много, они могут встречаться как угодно часто, но их написание должно точно соответствовать правилам:
- Тег заключается в знаки %: %ПримерТега% .
- Тег является регистрозависимым, то есть %Тег% и %тег% — это разные теги.
Содержание
Теги для СМС и E-mail
Теги заказа
- %Order.Id% - уникальный индитификатор заказа.
- %Order.Phone% - номер телефона заказчика.
- %Order.PhoneToDial% - номер телефона на отзвон.
- %Order.SourceAddress% - адрес подачи.
- %Order.DestinationAddress% - адрес назначения.
- %Order.SourceZone% - район подачи.
- %Order.DestinationZone% - район назначения.
- %Order.StopAddresses% - адреса остановок.
- %Order.InputTime% - время поступления заказа.
- %Order.MinBeforeArrive% - время до подачи в минутах.
- %Order.SourceTime% - время подачи. Автоматически будет добавляться дата в том случае, если дата подачи в заказе не совпадает с текущей датой.
- %Order.FinishTime% - время завершения.
- %Order.TaximeterDistance% - расстояние по таксометру, км.
- %Order.TaximeterDuration% - общее время пути.
- %Order.TotalCost% - итоговая сумма за заказ.
- %Order.Cost% - сумма за заказ без скидки.
- %Order.CashSum% - сумма наличными.
- %Order.CashlessSum% - сумма безнал.
- %Order.BonusSum% - сумма бонусы.
- %Order.BankCardSum% - сумма банк. карта.
- %Order.CashAndBankCardSum% - сумма наличные + банковская карта.
- %Order.DiscountSum% - сумма скидки.
- %Order.PayType% - тип расчета: наличный и безналичный.
- %Order.Customer% - заказчик из карточки заказа.
- %Order.PrizePhoneCnt% - количество заказов до призового. Текст тега задается в Файл - Настройки - Заказы - Призовые заказы .
- %Order.Comment% - примечание к заказу.
- %Order.CreatorTaxiName% - название службы-создателя.
- %Order.CreatorTaxiPhone% - телефон службы-создателя.
- %Order.PerformerTaxiName% - название службы-исполнителя.
- %Order.PerformerTaxiPhone% - телефон службы-исполнителя.
- %Order.Tariff% - название тарифа.
- %Order.Attribute[ID]% - значение атрибута заказа.
- %Order.BankCardInfo% - информация о банковской карте.
- %Order.FiscalReceiptUrl% - ссылка на фискальный чек.
Теги автомобиля
- %Car.Number% - гос.номер автомобиля.
- %Car.Color% - цвет автомобиля.
- %Car.Mark% - марка автомобиля.
- %Car.Model% - модель автомобиля.
- %Car.ShortName% - короткое название автомобиля.
- %Car.Attribute[ID]% - значение атрибута автомобиля.
- %Car.Permit% - номер разрешения автомобиля.
- %Car.License% - номер лицензии автомобиля.
Теги экипажа
- %Crew.Group% - название группы экипажа водителя.
- %Crew.Code% - позывной экипажа.
- %Crew.Attribute[ID]% - значение атрибута экипажа.
Теги водителя
- %Driver.Name% - ФИО водителя.
- %Driver.Phone% - основной телефон водителя.
- %Driver.Balance% - текущий баланс счета водителя.
- %Driver.Attribute[ID]% - значение атрибута водителя.
- %Driver.Inn% - ИНН водителя.
- %Driver.InsuranceNumber% - СНИЛС водителя.
- %Driver.Address% - адрес проживания водителя.
- %Driver.City% - город проживания водителя.
- %Driver.Certificate% - номер разрешения на перевозку.
- %Driver.TemporaryBlockReason% - причина временной блокировки водителя.
- %Driver.LockReason% - причина постоянной блокировки водителя.
- %Driver.DismissReason% - причина увольнения водителя.
Теги клиента
- %Client.Id% - ИД клиента.
- %Client.Name% - имя клиента.
- %Client.Number% - номер договора клиента.
- %Client.Balance% - баланс клиента.
- %Client.BonusBalance% - бонусный баланс клиента.
- %Client.TermAccount% - терминальный аккаунт клиента.
- %Client.APILogin% - логин API клиента.
- %Client.APIPassword% - пароль API клиента.
- %Client.ReferralCode% - реферальный код клиента.
- %Client.Attribute[ID]% - значение атрибута клиента.
Теги партнера
- %Partner.Name% - имя партнера.
- %Partner.Phone% - номер телефона партнера.
- %Partner.Inn% - ИНН партнера.
- %Partner.Address% - адрес партнера.
- %Partner.Balance% - баланс партнера.
Общие теги
- %DateTime% - текущая дата и время.
- %Date% - текущая дата.
- %Time% - текущее время.
- %Advertisement% - рекламный текст. Рекламные тексты задаются в Файл - Настройки - СМС .
- %GlobalAttribute[ID]% - значение глобального атрибута.
- %auth_code% - одноразовый код для аутентификации.
Устаревшие СМС теги
В справочнике тегов можно включить отображение устаревших тегов, включив опцию "Отображать старые теги". Список полей из карточки заказа:
-
- Например, шаблон Заказчик (%Phone%)... , если номер клиента - 7159561 , преобразует текст СМС так: Заказчик (7159561)... .
%Phone% — номер телефона заказчика.
- телефона на отзвон. %CPhone% — номер
- адрес подачи. %Src% —
- адрес назначения. %Dest% —
- Сумма в карточке заказа).
- Например, шаблон %Src% - %Dest%, %Amount% позволит вставлять в текст сообщения адрес подачи, адрес назначения и сумму за заказ и разделить их тире и запятой.
%Amount% — сумма за заказ (поле -
- Например, шаблон Скидка: %Disc% р при скидке 5% и стоимости заказа 100 рублей преобразуется в сообщение Скидка: 5 р .
%Disc% — результирующая скидка в рублях.
- %ITime% — время поступления заказа.
- %PTime% — время подачи, то есть время, в которое нужно начать выполнение заказа. Полезно для оповещения водителей о предварительных заказах.
- %Cou% —
- %CarType% — тип автомобиля (наименование).
- %CarCallID% — позывной автомобиля.
-
- Например, в шаблоне Машина подана: номер %CarGosNum%, цвет %CarColor% содержится информация о госномере и о цвете автомобиля.
%CarGosNum% — госномер автомобиля. Этот тег удобен для отправки заказчикам в шаблоне вида ...госномер %CarGosNum%... .
- %CarColor% — цвет автомобиля.
- %CarMark% — марка автомобиля.
- TMDriver, когда принимал заказ. %Min% — время до подачи, которое водитель указал в
- %Client% — имя клиента (берется из карточки заказа).
- физического или юридического лица. %ClientCaption% — имя заказчика из карточки
- («Машина будет в 12:45») является более надежным, чем относительное («Машина будет через 5 минут»), поскольку из-за задержки отправки сообщения не теряет актуальность. %CarArrive% — фактическое время подачи машины, указанное в часах и минутах. В отличие от %Min% , абсолютное время
- %Description% — примечание к заказу. Будьте осторожны: объемы данных в этом поле могут быть велики с точки зрения номинального объема СМС.
- %orderid% — уникальный идентификатор заказа (его номер).
- параметрах). %PrizePhoneCnt% — количество заказов до призового (текст задается в
- %TaximeterDistance% — расстояние по таксометру в километрах.
- %TaximeterDuration% — общее время в пути.
Список полей из карточки водителя:
- %DrvAmount% — текущий счет водителя. Тег удобен для оповещения водителей о состоянии их счетов при выходе на смену.
- %DriverCellPhone% — сотовый телефон водителя.
- %DriverHomePhone% — домашний телефон водителя.
- %DriverName% — полное имя водителя (ФИО).
Список дополнительных данных:
- %DateTime% — текущие дата и время.
- %Date% — текущая дата. Формат даты задается в параметрах.
- %Time% — текущее время. Формат времени задается в параметрах.