...
Без склонения месяц выводится:
{code}
{{ op_date|date:"E" }}
{code}
Для вычисления предыдущего месяца нужно в начало шаблона добавить загрузку математических фильтров
{code}
{% load mathfilters %}
{code}
Далее редактировать строку с датой
{code}
{% with month=op_date.month|sub:1 %}
Счет на оплату № {{ number }} от {{ op_date|date:"d.m.y" }}
за
{% if month == 1 %}
январь
{% elif month == 2 %}
февраль
{% elif month == 5 %}
май
{% endif %}
{% endwith %}
{code}
h3. Вывод списка услуг c их стоимостью вместо фактического потребления услуг
В случае, если Вам требуется вывести только набор услуг абонента попавший в счет и их стоимость по тарифу замените стандартную таблицу набора услуг, отражающую фактическое потребление за период счета согласно [настройкам|CarbonBilling:Счет на предоплату], приведённой ниже.
{code}<table border="1" style="font-size: 8pt" cellpadding="2">
<tr style="text-align: center; font-weight: bold">
<td width="260">Товары (работы, услуги)</td>
</tr>
<table border="1" style="font-size: 8pt" cellpadding="2">
<tr style="text-align: center; font-weight: bold">
<td width="260">Товары (работы, услуги)</td>
<td width="70">Стоимость</td>
</tr>
{% regroup services by name as uslugi_list %}
{% for service in uslugi_list %}
<tr>
<td width="260">Абонентская плата за услугу: {{ service.grouper }}</td>
{% regroup service.list by usluga as uslugas %}
{% for grouper in uslugas %}
<td width="260" align="right">{{ grouper.grouper.summa|floatformat:2 }}</td>
{% endfor %}
</tr>
{% endfor %}
</table>
</table>{code}
h3. Математические операции.
{code}
{% load mathfilters %}
{{ service.price|mul:0.8|floatformat:2 }} {# Умножение стоимости услуги на 0.8 с округлением до 2 знаков #}
{{ service.price|div:5 }} {# Деление #}
{{ service.price|add:5 }} {# Сложение #}
{{ service.price|addf:5 }} {# Сложение дробных чисел #}
{{ service.price|sub:5 }} {# Вычитание #}
{code}
h3. Циклы
{code}
{% with op_summa|div:1.2 as test %}
{{test}}
{% endwith %}
{code}
h3. Добавление QR code.
QR-коды формируются согласно [ГОСТ|http://roskazna.ru/dokumenty/dokumenty/vzaimodeystvie-s-bankovskoy-sistemoy/1157315/]
{code}
{% load pytils_numeral %}
{% load mathfilters %}
{% load qr_code %}
<!DOCTYPE html>
<html>
<body>
<div class="container">
<div><img width=200 height=200 src="{{MEDIA_URL}}{% generate_qrcode inst operator_attrs.2 operator_attrs.6 operator_attrs.7 operator_attrs.8 op_summa|mul:100 'Назначение платежа' operator_attrs.4 abonent_attrs.3 abonent_attrs.1002 abonent_attrs.1001 abonent_attrs.1003 operator_attrs.12 %}" alt="альтернативный текст"></div>
</div>
</body>
</html>
{code}
В шаблон передаются следующие параметры
h5. Оператора связи
operator_attrs.2 - Наименование
operator_attrs.6 - Счет
operator_attrs.7 - Банк
operator_attrs.8 - БИК
op_summa - сумма, по ГОСТ она должна быть в копейках, поэтому в документе подключен модуль mathfilters и сумма умножена на 100
Назначение платежа - указать текст без ковычек
operator_attrs.4 - ИНН
operator_attrs.12 - корреспондентский счет (в биллинге к/с)
h5. Абонента
abonent_attrs.3 - Адрес
abonent_attrs.1002 - Имя
abonent_attrs.1001 - Фамилия
abonent_attrs.1003 - Отчество
h3. Несколько учетных записей.
В случае если в одном счете указанно несколько абонентов есть возможность отобразить все данные из всех учетных записей этих абонентов.
Пример - отображение телефонных номеров
{code}
{% for user in users %} {{ user.phone.phone }} {% endfor %}
{code}
h3. Разные договора в агентских счетах
Если Вы предоставляете услуги телефонии по [агентской схеме|CarbonBilling:Взаиморасчеты между операторами] и абонент подписывает с каждым оператором отедьные договора с разными номерами, можно выводить соответствующий номер в финансовых документах.
Допустим, у Вас есть несколько партнёров: Вымпелком, ТТК, МТС.
# Заполните у операторов [реквизит|CarbonBilling:Реквизиты] "Наименование
# Создайте в справочники "Реквизиты" три реквизита с типом _текст_:
#* "Номер договора с оператором Вымпелком"
#* "Номер договора с оператором ТТК"
#* "Номер договора с оператором МТС"
# Предположим, что реквизиты получили ID (номера) 1001, 1002 и 1003 соответственно. Добавьте в шаблон следующую конструкцию:
{code}{% if agent_operator_attr.2 == "Вымпелком" %}
{{ abonent_attrs.1001 }}
{% elif agent_operator_attr.2 == "ТТК" %}
{{ abonent_attrs.1002 }}
{% elif agent_operator_attr.2 == "МТС" %}
{{ abonent_attrs.1003 }}
{% endif %}{code}
{info}В условиях имена операторов долдны быть написаны так же как они указаны в их реквизитах{info}
# Добавьте абонентам соответствующие реквизиты.
h2. Шаблоны .docx
При создании и редактировании шаблона возможно использование переменных печати в формате *Jinja2*. В большинстве случаев всё аналогично шаблонам HTML.
Различия:
# Значение по умолчанию. Если в HTML шаблоне была конструкция вида {code}{{ sms|default_if_none:"---" }}{code}, то в DOCX следует использовать {code}{{ sms|default("---", true) }}{code}
# Форматирование даты. Используется фильтр *dateformat*. Если в HTML шаблоне была конструкция вида {code}{{ create_date|date:"d.m.y" }}{code}, то в DOCX следует использовать {code}{{ create_date|dateformat("%Y.%m.%d") }}{code}
# Вывод текущего времени. Используется метод *now()*, который выводит время в формате, для отображения в нужном формате можно использовать фильтр, например: {code}{{ now() | dateformat('%d.%m.%Y') }}{code}
# Форматирование валюты. Используется фильтр *rubles*. Для принудительной печати копеек в целых суммах следует использовать {code}{{ account.balance|rubles(True) }}{code}
# Реквизиты абонентов выводятся следующим образом. Вывести значение реквизита "Комментарий":
{code} {{ abonent_attrs['33'] }} {code}
Для того, что бы вывести список всех доступных реквизитов воспользуйтесь конструкцией:
{code}
{% for attr in abonent_attrs %}
{{ abonent_attrs_names[attr] }}: {{ abonent_attrs[attr] }}
{% endfor %}
{code}
Реквизит ФИО состоит из трех частей (фамилия, имя, отчество), каждую из которых можно вывести по-отдельности:
{code}
{{ abonent_attrs['24']['0'] }} - фамилия
{{ abonent_attrs['24']['1'] }} - имя
{{ abonent_attrs['24']['2'] }} - отчество
{code}
Для корректного вывода данного реквизита необходимо использовать конструкцию:
{code}
{% if abonent_attrs %}
{{ abonent_attrs['24']['0'] }} {{ abonent_attrs['24']['1'] }} {{ abonent_attrs['24']['2'] }}
{% endif %}
{code}
# При проверке шаблона с чем-то вроде {{users.0.something}} используется специальный абонент, у которого количество users равно нулю. Для того, чтобы шаблон проходил проверку, необходимо оборачивать элементы шаблона в if:
{code}
{% if users.0 %} {{users.0.something}} {% endif %}
{code}
# Для суммирования сумм всех услуг абонента используется данная конструкция:
{code}
{{ services | sum(attribute='summ')}}
{code}
# Для суммирования сумм всех услуг абонента с округлением до 2 знака после запятой используется следующая конструкция:
{code}
{{ "%.2f"|format(services | sum(attribute='summ'))}}
{code}
# Для вывода месяца, в который был выставлен счет используется следующий шаблон:
{code}
{% if op_date | dateformat('%-m') == '1' %}Январь{% elif op_date | dateformat('%-m') == '2' %}Февраль{% elif op_date | dateformat('%-m') == '3' %}Март{% elif op_date | dateformat('%-m') == '4' %}Апрель{% elif op_date | dateformat('%-m') == '5' %}Май{% elif op_date | dateformat('%-m') == '6' %}Июнь{% elif op_date | dateformat('%-m') == '7' %}Июль{% elif op_date | dateformat('%-m') == '8' %}Август{% elif op_date | dateformat('%-m') == '9' %}Сентябрь{% elif op_date | dateformat('%-m')== '10' %}Октябрь{% elif op_date | dateformat('%-m') == '11' %}Ноябрь{% elif op_date | dateformat('%-m') == '12' %}Декабрь{% else %}---
{% endif %}
{code}
# Для применения математической операции необходимо предварительно перевести значение исходных данных в тип данных *int* (если число целое без дробной части) или *float* (если число с дробной частью)
Пример умножения цены step_price(которая равна 1.5) на 1.2. В выводе будет число 1.8
{code}
{{ voip_log. step_price*1.2 | float}}
{code}
# При необходимости печати разных документов для физических и юридических лиц шаблоны печати помещаются в один файл .docx следующим образом:
{code}
{% if abonent.company %}
<Вставляем шаблон печати договора юридического лица>
{% else %}
<Вставляем шаблон печати договора физического лица>
{% endif %}
{code}
h3. Примеры шаблонов
* [Карточка абонента|^abonent_card3.docx]
* [Счет|^bill_guPQBlr.docx]
* [Договор|^contract_dogovor.docx]
* [Заявка HelpDesk/CRM|^helpdesk.docx]
* [Акт+распечатка звонков|^akt_and_voip.docx]
