Oxygen Pelatologio для OpenCart — квитанції, рахунки й myDATA із замовлень

Oxygen Pelatologio Invoices для OpenCart 4.x, 3.x і 2.3 формує документ із замовлення в грецькому сервісі Oxygen Pelatologio (pelatologio.gr) через його API: роздрібну квитанцію, рахунок-фактуру, кредит-ноту. Документ створюється в Oxygen у вашій серії нумерації з покупцем, рядками й ставками ПДВ, а передачу в myDATA виконує Oxygen за налаштуваннями вашого акаунта.

Що потрібно від вас. Акаунт Oxygen Pelatologio і ключ API з його кабінету. Типи документів, класифікацію доходів myDATA і серії нумерації ви налаштовуєте разом зі своїм бухгалтером: модуль підставляє те, що ви обрали.

Що бачить покупець

На касі OpenCart покупець залишає звичайні дані. Модуль додає необовʼязкове поле ΑΦΜ: хто його вказав, отримує рахунок на компанію (у Pro), решта — роздрібну квитанцію як фізична особа. Покупця в Oxygen модуль знаходить за e-mail або створює, щоб не плодити дублі.

Що отримує адмін

Розширення → Модулі → Oxygen Pelatologio: вкладки «Connection», «Document», «Buyer», «Automation», «Products», «Pro». У «Connection» ви вставляєте ключ API з кабінету Oxygen (він зберігається зашифрованим і назад у форму не повертається), за потреби вмикаєте перемикач sandbox і натискаєте «Save and check the connection»: модуль читає з акаунта ставки ПДВ, способи оплати, серії нумерації й склади. На вкладці «Document» ви обираєте тип документа, серію, спосіб оплати за замовчуванням і класифікацію доходів myDATA.

На сторінці замовлення зʼявляється панель «Oxygen Pelatologio»: покупець, попередній перегляд рядків із цінами без ПДВ і ставкою, сума й тип документа. Після видачі — номер документа, MARK із myDATA, стан і кнопки: PDF, лист покупцю з PDF і кредит-нота. У розділі «Продажі» є список усіх документів зі станами «In progress», «Stopped» і «Issued». Зупинений документ можна повторити після виправлення причини, наприклад ΑΦΜ.

Двічі документ не виходить: після втраченої відповіді Oxygen модуль знаходить уже створений документ і не створює другий. Помилки мережі, 5xx і 429 модуль повторює сам. Сума документа дорівнює сумі замовлення до цента, для інших валют документ іде в євро. Якщо замовлення неможливо розкласти на рядки (подарунковий сертифікат, фіксований збір, бали), документ не створюється, а модуль пояснює причину.

У Pro документ видається сам за статусами замовлення, без затримки сторінки покупця. Для компаній модуль видає рахунок-фактуру: греків і покупців з ЄС і з-за його меж він розрізняє за ΑΦΜ, шукає ΑΦΜ в реєстрі (назва, ΔΟΥ, адреса, діяльність підтягуються в контакт) і у VIES. Невалідний ΑΦΜ зупиняє документ із зрозумілим текстом, а виправлення ΑΦΜ у замовленні дає повторити. Кредит-нота — кнопкою або за статусом, для квитанції й для рахунку; кредит-нота стосується всього замовлення.

Також у Pro: серії нумерації й спосіб оплати для кожного платіжного розширення, привʼязка рядків до товарів Oxygen за SKU або моделлю зі складом, створення відсутніх товарів, оновлення e-mail і телефону контакту, відмітка оплати для онлайн-платежів і для післяплати за статусом, лист покупцю з PDF мовою замовлення.

Як це працює, крок за кроком

1. Встановлюєте архів для своєї версії OpenCart і вмикаєте модуль.
2. У кабінеті Oxygen Pelatologio створюєте ключ API.
3. На вкладці «Connection» вставляєте ключ і натискаєте «Save and check the connection».
4. На вкладці «Document» обираєте тип документа, серію й спосіб оплати, на вкладці «Buyer» створюєте поле ΑΦΜ.
5. На сторінці замовлення переглядаєте рядки й натискаєте «Issue the document».
6. У Pro документи, оплати, кредит-ноти й листи йдуть самі за статусами.

Що під капотом

• Oxygen Pelatologio API v1; ключ зашифрований.
• Роздрібна квитанція йде як документ типу rp або rs, рахунок — типу для греків, ЄС і не-ЄС; передачу в myDATA виконує Oxygen.
• Дата документа завжди сьогоднішня за Афінами; документ заднім числом модуль не видає.
• Видані документи в myDATA не видаляються, а кредитуються.
• Кредит-нота через модуль — на все замовлення; часткові повернення модуль не робить.
• Створений через модуль відсутній товар зʼявляється в Oxygen з нульовим залишком.
• Власні таблиці документів; при видаленні модуля вони лишаються.
• Події OpenCart без правок ядра.
• Інтерфейс англійською й грецькою.

Як встановити

1. Розширення → Встановлення: завантажте архів для своєї версії без перейменування файлу (OpenCart 4 — cc_oxygen.ocmod.zip, 3.x — cc_oxygen-oc3.ocmod.zip). Для 2.3 розпакуйте cc_oxygen-oc23.ocmod.zip і завантажте вміст теки upload у корінь магазину.
2. Для 3.x і 2.3: Розширення → Модифікатори → Оновити.
3. Розширення → Модулі → Oxygen Pelatologio: встановіть і відкрийте.
4. Вставте ключ API, натисніть «Save and check the connection», оберіть тип документа й серію.
5. Для Pro: вставте ключ ліцензії або запустіть пробний період на вкладці «Pro».