Docs
Модуль работы с платёжными документами.
Возможности
- Выписка счётов из пользовательского интерфейса
- Выписка счётов из интерфейса для администраторов
- Выписка счетов-фактур
- Автоматическая выписка счёта, кассового чека при занесении денег на аккаунт пользователя
- Формирование общего файла счетов для печати и рассылки всем пользователям.
- Формирование актов оказания услуг за определённый период.
- автоматическое формирование актов оказания услуг для всех компаний системы.
- Выписка налоговых накладных
- Формирование договора и его печать
- Возможность формировать несколько типов договоров в зависимости от предоставляемых услуг.
- Создание документов в PDF формате (нужен модуль PDF::API2)
Установка
abills/libexec/config.pl
@MODULES = (
'Docs'
);
Настройка
| $conf{DOCS_ACCOUNT_EXPIRE_PERIOD}=10; | Время действительности счета. По умолчанию 30 дней |
|---|---|
| $conf{MONEY_UNIT_NAMES}=['грн','коп']; | Название денежной еденицы большая меньшая часть |
| $conf{DOCS_PDF_PRINT}=1; | Вывод печатных документов в формате PDF. Шаблоны документов помещать в папку шаблонов $conf{TPL_DIR}. Функция работает только при наличии установленого Perl модуля PDF::API2 (http://search.cpan.org/~areibens/PDF-API2-0.71.001/) |
| $conf{DOCS_VAT_INCLUDE}=20; | Процентов включенного налога |
| $conf{DOCS_ORDERS}=['Услуги связи', 'Тех. поддержка']; | Виды товаров для счёта |
| $conf{DOCS_LANGUAGE}='russian'; | Язык печатных документов. По умолчанию равен $conf{default_language} |
| $conf{DOCS_CONTRACT_TYPES}=':Д:физические лица:contract_1; :В:выделенка для юр. лиц (Ethernet, ADSL):contract_2; :ВО:оптика для организаций:contract_3;'; | Задния списка типов договоров для работы с клиентами. Формат: ПРЕФИКС_ДОГОВОРА:CУФИКС_ДОГОВОРА:НАЗВАНИЕ_ДОГОВОРА:ШАБЛОН Для шаблона contract_1 система будет искать файл /usr/abills/Abills/templates/Docs_docs_contract_1.tpl или его альтернативный pdf шаблон. Если не заполнено поле Номер договора и дата система автоматически подставляет следующий нужный номер в эти поля. |
| $conf{DOCS_PAYMENT_METHODS}='' | Описание типов платежей для бухгалтерских документов. При указании данной переменной типы оплат берутся и ней а не из системных типов оплат. Если нет типа указанного в данной переменной используется тип с номером 0. По этому рекомендовано всегда иметь описание оплаты с типом 0. Формат $conf{DOCS_PAYMENT_METHODS}='номер:тип; номер:тип;'; Пример 0:оплата с расчётного счёта; 1:Наличка; 2:Поступление с терминалов |
Шаблоны
docs_account.tpl
Счёт (КВИТАНЦИЯ) для оплаты физическим лицами
Заходите в нужном клиенте в / Клиенты/ Логины/ Информация/ в Оплаты
| ACCT_ID | Номер счёта |
|---|---|
| FIO | Фио |
| ADDRESS_FULL | Адрес |
| CONTRACT_ID | контракт |
| CONTRACT_DATE | дата контракта |
| A_FIO | ФИО администратора |
| TOTAL_SUM | Общая сума |
| TOTAL_SUM_WITHOUT_VAT | общая сума без налога |
| CUSTOMER | Пользователь |
| AMOUNT_FOR_PAY | Сума для оплаты |
| DEPOSIT | Депозит абонента на момент выписки счета |
| DEBT | Задолженость |
| PAYMENT_ID | Номер в журнале платежей. Появляется после оплате по указанному счету |
| MONTH | Поточный Месяц |
| DATE | Поточная Дата |
| TIME | Поточное Время |
Табличная часть
| ORDER_NUM_1 | Номер услуги/товара в табличной части |
|---|---|
| ORDER_NAME_1 | Наименование услуги/товара в табличной части |
| ORDER_COUNT_1 | Количество услуги/товара в табличной части |
| ORDER_PRICE_1 | Цена услуги/товара в табличной части |
| ORDER_SUM_1 | Сума услуги/товара в табличной части |
| ORDER_PRICE_WITHOUT_VAT_1 | Цена товара без налога (НДС) |
| ORDER_VAT_1 | Сума налога за товар (НДС) |
| ORDER_SUM_WITHOUT_VAT_1 | Общая сума товаров без налога (НДС) Количество * суму товара без налога |
| MONTH | Поточный Месяц |
| DATE | Поточная Дата |
| TIME | Поточное Время |
docs_account_company.tpl
Счёт (КВИТАНЦИЯ) для оплаты юридическими лицами
Заходите в нужном клиенте в / Клиенты/ Логины/ Информация/ в Оплаты, данный документ выписывается пользователям пренадлежащим определённой компании
docs_act.tpl
Форма акта оказания услуг
Заходите в нужном клиенте в / Клиенты/ Компании/ Документы/ Акты
docs_invoice.tpl
Форма счёта фактуры (чека), выставляется абоненту после внесения суммы на счёт
Заходите в нужном клиенте в / Клиенты/ Логины/ Информация/ в Оплаты Ставите галочку «Счет-Фактура»
docs_tax_invoice.tpl
Налоговая накладная
Заходите в нужном клиенте в / Клиенты/ Компании/ Документы/ Налоговая накладная
docs_contract.tpl
Форма договора
Заходите в нужном клиенте в / Клиенты/ Логины/ Информация/ в Информации о пользователе есть поле «Номер контракта» и кнопка «печать»
переменные шаблона
| UID | UID |
|---|---|
| LOGIN | Логин |
| FIO | ФИО |
| DEPOSIT | Депозит |
| CREDIT | Сума кредита |
| CREDIT_DATE | Дата кредита |
| COMPANY_ID | Номер компании |
| COMPANY_NAME | Название компании |
| GID | Номер группы |
| PHONE | Телефон |
| PASPORT_NUM | Номер паспорта |
| PASPORT_DATE | Дата выдачи паспорта |
| PASPORT_GRANT | Паспорт выдан |
| CONTRACT_ID | Номер контракта |
| CONTRACT_DATE | Дата контракта |
| CONTRACT_PREFIX | Префикс контракта |
| ADDRESS_FULL | Полный адрес, Улица, дом/квартира |
| ADDRESS_COUNTRY | Страна |
| CITY | Город |
| ADDRESS_DISTRICT | Регион |
| ADDRESS_STREET | Улица |
| ADDRESS_FLAT | Квартира |
| _информационные_поля | Объявление дополнительных информационных полей |
docs_contract_company.tpl
Форма договора для корпоративных клиентов
Заходите в Компании выбираете / Клиенты/ Компании/ в Информации о пользователе есть поле «Номер контракта» и кнопка «печать»
Также можно формировать индивидуально документы для каждого типа оплат (docs_account.tpl, docs_account_company.tpl, docs_invoice.tpl).
Формат таких шаблонов в каталоге abills/Abills/templates:
[название модуля]_[название шаблон]_[тип оплаты].tpl Docs_docs_account_1.tpl
Данная функция доступна только для документов в формате PDF
Например Если Вам нужно для оплат наличными выдавать кассовый чек, а для оплат банком от юридических лиц акт оказания услуг
формируем два дополнительных шаблона:
1. Будет выдаваться по умолчанию для всех платежей
abills/Abills/templates/Docs_docs_account.tpl # признак индивидуального шаблона abills/Abills/templates/Docs_docs_account.pdf # сам шаблон abills/Abills/templates/Docs_docs_account.dsc # файл описание переменных
2 Будет выписываться для оплат с типом банк
abills/Abills/templates/Docs_docs_account_1.tpl # признак индивидуального шаблона abills/Abills/templates/Docs_docs_account.pdf # abills/Abills/templates/Docs_docs_account.dsc #
Список типов пополнения можно расширять по вашему желанию, переменная для расширения этого списка указана в расширенной документации
Привязка документов к определённым группам
Для групп имеющих флаг Собственные Бух. документы можно создавать индивидуальные шаблоны документов.
шаблоны создаются в папке abills/Abills/templates/ по принципу индивидуальных шаблонов и в конце названия файла через нижнее подчеркивание указывается название группы
Пример:
для группы 99
abills/Abills/templates/Docs_docs_account_99.tpl # признак индивидуального шаблона abills/Abills/templates/Docs_docs_account_99.pdf # сам шаблон abills/Abills/templates/Docs_docs_account_99.dsc # файл описание переменных
