Модуль Invoice Payment для OkayCMS

Модуль додає оплату за рахунком для юридичних осіб: збирає ЄДРПОУ та назву компанії під час оформлення замовлення, зберігає ці дані в замовленні та дозволяє друкувати рахунок на оплату і видаткову накладну.

Можливості

• Додаткові поля в кошику для способу оплати Invoice Payment:
  • ЄДРПОУ;
  • Назва компанії.
• Автозаповнення назви компанії за ЄДРПОУ через зовнішній API (з можливістю ручного редагування).
• Валідація полів ЄДРПОУ та назви компанії при оформленні замовлення.
• Збереження реквізитів покупця в окремій таблиці модуля для кожного замовлення.
• Відображення реквізитів у:
  • деталях замовлення на фронтенді;
  • картці замовлення в адмін-панелі.
• Кнопки друку документів у картці замовлення:
  • рахунок на оплату;
  • видаткова накладна.
• Налаштовувана "шапка" документа в адмінці (реквізити постачальника, банк, адреса, підпис тощо).
• Формування друкованого документа українською мовою з:
  • товарами замовлення;
  • сумою прописом;
  • блоком підписів.

Вимоги

• OkayCMS v4.5.2

Встановлення

Варіант 1: Скачування з GitHub

1. Скачайте останню версію модуля з останнього релізу на GitHub.
2. Розпакуйте архів на сервері в каталог: {OkayCMS_root}/Okay/Modules/

Варіант 2: Встановлення через Git

1. Виконайте команду в директорії {OkayCMS_root}/Okay/Modules/Sviat:

   git clone https://github.com/devSviat/InvoicePayment-OkayCMS.git InvoicePayment

Результат встановлення

Шлях до модуля має бути таким:

{OkayCMS_root}/Okay/Modules/Sviat/InvoicePayment/

Після встановлення перейдіть в адмін-панель → Модулі → Знайдіть "Invoice Payment" → Натисніть "Встановити".

Налаштування

1. Перейдіть в адмін-панель → Модулі → Invoice Payment.
2. У налаштуваннях модуля Sviat/InvoicePayment заповніть реквізити для шапки документа:
   • Тип та назва постачальника;
   • Рахунок IBAN;
   • Назва банку;
   • Адреса постачальника;
   • Код отримувача;
   • Податкова інформація;
   • Місце складання;
   • ПІБ підписанта.
3. Натисніть "Зберегти".
4. Після цього додайте або відредагуйте спосіб оплати в адмін-панелі (Налаштування → Оплата) та оберіть Тип модуля: Sviat/InvoicePayment.

Використання

Для клієнта (фронтенд)

1. Клієнт обирає спосіб оплати Invoice Payment при оформленні замовлення.
2. У формі з'являються обов'язкові поля ЄДРПОУ та назви компанії.
3. Після введення ЄДРПОУ (та втрати фокусу полем) модуль намагається підтягнути назву компанії автоматично.
4. Після оформлення замовлення дані компанії зберігаються і відображаються на сторінці замовлення.
5. Якщо дані компанії заповнені, клієнту доступна кнопка перегляду рахунку.

Для менеджера (адмін-панель)

1. У картці замовлення з оплатою Invoice Payment відображаються ЄДРПОУ та назва компанії.
2. Менеджер може редагувати ці поля у замовленні.
3. У блоці оплати доступні кнопки:
   • "Друк рахунку";
   • "Друк видаткової накладної".

Важливо

• Поля ЄДРПОУ та назви компанії є обов'язковими лише коли обрано спосіб оплати Invoice Payment.
• Якщо для замовлення не заповнені реквізити компанії, друк документа недоступний.
• Автозаповнення назви компанії залежить від доступності зовнішнього сервісу отримання даних за ЄДРПОУ.

Ліцензія

Модуль розповсюджується за вільною ліцензією MIT