Тег — различия между версиями

Текущая версия на 10:42, 14 ноября 2024

Тег — особая текстовая конструкция внутри большого выражения, которая автоматически заменяется на переменное значение (взятое, например, из базы данных Такси-Мастер, из карточки заказа и т. д.). Теги предназначены для того, чтобы в тексте сообщения заменять себя на значение, которое в большинстве случаев берется из программы Такси-Мастер. Теги вставляются в шаблоны СМС-сообщений и шаблоны E-mail.

Открыть справочник тегов можно практически из любого окна, где можно использовать теги, например, из окна нового шаблона E-mail, из окна нового шаблона СМС, из окна новой группы экипажей на вкладке уведомлений. Доступные теги зависят от окна, из которого открыт справочник тегов.

Тегов в шаблоне может быть как угодно много, они могут встречаться как угодно часто, но их написание должно точно соответствовать правилам:

1. Тег заключается в знаки %: «%ПримерТега%».
2. Тег является регистрозависимым, то есть «%Тег%» и «%тег%» — это разные теги.

Теги для СМС и E-mail

Теги заказа

1. «%Order.Id%» - уникальный индитификатор заказа.
2. «%Order.Phone%» - номер телефона заказчика.
3. «%Order.PhoneToDial%» - номер телефона на отзвон.
4. «%Order.SourceAddress%» - адрес подачи.
5. «%Order.DestinationAddress%» - адрес назначения.
6. «%Order.SourceZone%» - район подачи.
7. «%Order.DestinationZone%» - район назначения.
8. «%Order.StopAddresses%» - адреса остановок.
9. «%Order.InputTime%» - время поступления заказа.
10. «%Order.MinBeforeArrive%» - время до подачи в минутах.
11. «%Order.SourceTime%» - время подачи. Автоматически будет добавляться дата в том случае, если дата подачи в заказе не совпадает с текущей датой.
12. «%Order.FinishTime%» - время завершения.
13. «%Order.TaximeterDistance%» - расстояние по таксометру, км.
14. «%Order.TaximeterDuration%» - общее время пути.
15. «%Order.TotalCost%» - итоговая сумма за заказ.
16. «%Order.Cost%» - сумма за заказ без скидки.
17. «%Order.CashSum%» - сумма наличными.
18. «%Order.CashlessSum%» - сумма безнал.
19. «%Order.BonusSum%» - сумма бонусы.
20. «%Order.BankCardSum%» - сумма банк. карта.
21. «%Order.CashAndBankCardSum%» - сумма наличные + банковская карта.
22. «%Order.DiscountSum%» - сумма скидки.
23. «%Order.PayType%» - тип расчета: наличный и безналичный.
24. «%Order.Customer%» - заказчик из карточки заказа.
25. «%Order.PrizePhoneCnt%» - количество заказов до призового. Текст тега задается в «Файл - Настройки - Заказы - Призовые заказы».
26. «%Order.Comment%» - примечание к заказу.
27. «%Order.CreatorTaxiName%» - название службы-создателя.
28. «%Order.CreatorTaxiPhone%» - телефон службы-создателя.
29. «%Order.PerformerTaxiName%» - название службы-исполнителя.
30. «%Order.PerformerTaxiPhone%» - телефон службы-исполнителя.
31. «%Order.Tariff%» - название тарифа.
32. «%Order.Attribute[ID]%» - значение атрибута заказа.
33. «%Order.BankCardInfo%» - информация о банковской карте.
34. «%Order.FiscalReceiptUrl%» - ссылка на фискальный чек.

Теги автомобиля

1. «%Car.Number%» - гос.номер автомобиля.
2. «%Car.Color%» - цвет автомобиля.
3. «%Car.Mark%» - марка автомобиля.
4. «%Car.Model%» - модель автомобиля.
5. «%Car.ShortName%» - короткое название автомобиля.
6. «%Car.Attribute[ID]%» - значение атрибута автомобиля.
7. «%Car.Permit%» - номер разрешения автомобиля.
8. «%Car.License%» - номер лицензии автомобиля.

Теги экипажа

1. «%Crew.Group%» - название группы экипажа водителя.
2. «%Crew.Code%» - позывной экипажа.
3. «%Crew.Attribute[ID]%» - значение атрибута экипажа.

Теги водителя

1. «%Driver.Name%» - ФИО водителя.
2. «%Driver.Phone%» - основной телефон водителя.
3. «%Driver.Balance%» - текущий баланс счета водителя.
4. «%Driver.Attribute[ID]%» - значение атрибута водителя.
5. «%Driver.Inn%» - ИНН водителя.
6. «%Driver.InsuranceNumber%» - СНИЛС водителя.
7. «%Driver.Address%» - адрес проживания водителя.
8. «%Driver.City%» - город проживания водителя.
9. «%Driver.Certificate%» - номер разрешения на перевозку.
10. «%Driver.TemporaryBlockReason%» - причина временной блокировки водителя.
11. «%Driver.LockReason%» - причина постоянной блокировки водителя.
12. «%Driver.DismissReason%» - причина увольнения водителя.

Теги клиента

1. «%Client.Id%» - ИД клиента.
2. «%Client.Name%» - имя клиента.
3. «%Client.Number%» - номер договора клиента.
4. «%Client.Balance%» - баланс клиента.
5. «%Client.BonusBalance%» - бонусный баланс клиента.
6. «%Client.TermAccount%» - терминальный аккаунт клиента.
7. «%Client.APILogin%» - логин API клиента.
8. «%Client.APIPassword%» - пароль API клиента.
9. «%Client.ReferralCode%» - реферальный код клиента.
10. «%Client.Attribute[ID]%» - значение атрибута клиента.

Теги партнера

1. «%Partner.Name%» - имя партнера.
2. «%Partner.Phone%» - номер телефона партнера.
3. «%Partner.Inn%» - ИНН партнера.
4. «%Partner.Address%» - адрес партнера.
5. «%Partner.Balance%» - баланс партнера.

Общие теги

1. «%DateTime%» - текущая дата и время.
2. «%Date%» - текущая дата.
3. «%Time%» - текущее время.
4. «%Advertisement%» - рекламный текст. Рекламные тексты задаются в «Файл - Настройки - СМС».
5. «%GlobalAttribute[ID]%» - значение глобального атрибута.
6. «%auth_code%» - одноразовый код для аутентификации.

Устаревшие СМС теги

В справочнике тегов можно включить отображение устаревших тегов, включив опцию "Отображать старые теги". Список полей из карточки заказа:

1. «%Phone%» — номер телефона заказчика.

   Например, шаблон «Заказчик (%Phone%)...», если номер клиента - «7159561», преобразует текст СМС так: «Заказчик (7159561)...».

2. «%CPhone%» — номер телефона на отзвон.
3. «%Src%» — адрес подачи.
4. «%Dest%» — адрес назначения.
5. «%Amount%» — сумма за заказ (поле «Сумма» в карточке заказа).

   Например, шаблон «%Src% - %Dest%, %Amount%» позволит вставлять в текст сообщения адрес подачи, адрес назначения и сумму за заказ и разделить их тире и запятой.

6. «%Disc%» — результирующая скидка в рублях.

   Например, шаблон «Скидка: %Disc% р» при скидке 5% и стоимости заказа 100 рублей преобразуется в сообщение «Скидка: 5 р».

7. «%ITime%» — время поступления заказа.
8. «%PTime%» — время подачи, то есть время, в которое нужно начать выполнение заказа. Полезно для оповещения водителей о предварительных заказах.
9. «%Cou%» —
10. «%CarType%» — тип автомобиля (наименование).
11. «%CarCallID%» — позывной автомобиля.
12. «%CarGosNum%» — госномер автомобиля. Этот тег удобен для отправки заказчикам в шаблоне вида «...госномер %CarGosNum%...».

    Например, в шаблоне «Машина подана: номер %CarGosNum%, цвет %CarColor%» содержится информация о госномере и о цвете автомобиля.

13. «%CarColor%» — цвет автомобиля.
14. «%CarMark%» — марка автомобиля.
15. «%Min%» — время до подачи, которое водитель указал в TMDriver, когда принимал заказ.
16. «%Client%» — имя клиента (берется из карточки заказа).
17. «%ClientCaption%» — имя заказчика из карточки физического или юридического лица.
18. «%CarArrive%» — фактическое время подачи машины, указанное в часах и минутах. В отличие от «%Min%», абсолютное время («Машина будет в 12:45») является более надежным, чем относительное («Машина будет через 5 минут»), поскольку из-за задержки отправки сообщения не теряет актуальность.
19. «%Description%» — примечание к заказу. Будьте осторожны: объемы данных в этом поле могут быть велики с точки зрения номинального объема СМС.
20. «%orderid%» — уникальный идентификатор заказа (его номер).
21. «%PrizePhoneCnt%» — количество заказов до призового (текст задается в параметрах).
22. «%TaximeterDistance%» — расстояние по таксометру в километрах.
23. «%TaximeterDuration%» — общее время в пути.

Список полей из карточки водителя:

1. «%DrvAmount%» — текущий счет водителя. Тег удобен для оповещения водителей о состоянии их счетов при выходе на смену.
2. «%DriverCellPhone%» — сотовый телефон водителя.
3. «%DriverHomePhone%» — домашний телефон водителя.
4. «%DriverName%» — полное имя водителя (ФИО).

Список дополнительных данных:

1. «%DateTime%» — текущие дата и время.
2. «%Date%» — текущая дата. Формат даты задается в параметрах.
3. «%Time%» — текущее время. Формат времени задается в параметрах.

Ссылки

• СМС-сервер
• SMPP