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».