
Finvalda Sales Sync для OpenCart — продажі, клієнти, залишки й ціни у Finvalda (Литва)
Finvalda для OpenCart 4.x, 3.x, 2.3 (Литва): замовлення як операції продажу безкоштовно, у Pro за статусом, клієнти, залишки, ціни. Ліцензія назавжди.
- Сумісність
- OpenCart 4.0.2.x–4.1.x, 3.0.x, 2.3.0.2 · мова інтерфейсу: English, Lietuvių
- Версія
-
v1.0.0 (OpenCart 4)
v1.0.0 (OpenCart 3.x)
v1.0.0 (OpenCart 2.3) - Ліцензія
- сайт + тестова копія, назавжди
- Тріал
- 7 днів, без картки, один на сайт
- Оновлено
- листопад 2026
Що є в Free,
а що дає Pro
Безкоштовна версія працює без обмеження в часі. Pro додає решту функцій з таблиці.
Головне про модуль
Що отримує продавець
На сторінці замовлення зʼявляється блок «Finvalda»: рядок покупця, документ, клієнт і тип операції, таблиця рядків з кодом, кількістю, сумою без ПДВ, знижкою й ПДВ, підсумок із ПДВ та кнопка «Send to Finvalda».
Що в адмінці
Extensions → Extensions → Modules → Finvalda Sales Sync: вкладки «Connection», «Sale operation», «Automation», «Stock and prices» і «Licence».

Тріал стартує, коли ви попросите
Свіжий інстал — безкоштовна версія, нічого не вмикається само. Кнопка «Спробувати Pro 7 днів» → e-mail → ключ одразу у вікні і листом.

Один ключ — сайт і тестова копія
Переносите сайт — відв’яжіть ліцензію на старому домені й активуйте на новому самі. Тестова копія (staging., dev.) працює з тим самим ключем і місця сайту не займає. Для студій — ключі на 5, 25 сайтів або без обмежень.
Технічні вимоги
OpenCart 4.0.2.x–4.1.x, 3.0.x або 2.3.0.2; розширення cURL; PHP 7.0 і новіші.
Веб-сервіс FVS із модулем FIN WEB SERVICE від Finvalda, користувач веб-сервісу й профіль бази. Модуль надає Finvalda на запит.
Сервер Finvalda часто стоїть в офісі компанії: він має бути доступний із хостингу магазину за адресою http чи https. Через http пароль іде незашифрованим, тому модуль попереджає; власний сертифікат сервера можна дозволити окремим прапорцем.
Код товару в Finvalda має дорівнювати моделі чи SKU товару в магазині. Нові коди, які створює Pro, складаються лише з великих літер A–Z і цифр, до 20 знаків; наявні коди з крапками відправляються без змін.
Бухгалтерські поля операції, клієнта й товару в Finvalda заповнює параметр імпорту, який налаштовує ваш партнер Finvalda; без нього Finvalda відмовляє з кодом помилки (наприклад, 2000 чи 1036), а модуль показує причину словами.
Суми йдуть у євро. Замовлення в іншій валюті відправляється, коли основна валюта магазину — EUR (сума в валюті замовлення й у євро).
Кілька компаній Finvalda в одному підключенні не підтримуються: значення ConnString залежать від вашої установки й вказуються одним профілем.
Фонова робота без серверного cron виконується після відкриття сторінок (потрібен PHP-FPM) і щогодини планувальником OpenCart 4; залишки й ціни за розкладом надійно йдуть через cron за адресою з вкладки «Automation» (раз на 5–15 хвилин).
«Finvalda» — торгова марка її власника; модуль не є офіційним продуктом Finvalda.
Історія версій
Перший випуск для OpenCart 4.x, 3.x і 2.3.
Разом з Finvalda Sales Sync купують


Знижки від суми та N+1 для OpenCart

Centas Invoicing для OpenCart — рахунки-фактури із замовлень, i.SAF і платежі (Литва)

Кинуті кошики для OpenCart 2.3, 3.x і 4.x
Повний опис модуля
Finvalda Sales Sync для OpenCart 4.x, 3.x і 2.3 передає замовлення магазину у литовську облікову систему Finvalda як операції продажу через її веб-сервіс FVS: кнопка на сторінці замовлення будує з нього одну операцію PardDok (або резервування PardRezDok) з рядками товарів і послуг, а підсумок має збігатися із сумою замовлення. Pro додатково підтягує залишки й ціни з Finvalda.
Що потрібно від Finvalda. Модуль FIN WEB SERVICE, який Finvalda надає на запит, адреса веб-сервісу FVS, користувач веб-сервісу та параметр імпорту для операцій із магазину: його налаштовує ваш адміністратор або партнер Finvalda. Сервіс має бути доступний із хостингу магазину.
Що отримує продавець
На сторінці замовлення зʼявляється блок «Finvalda»: рядок покупця, документ, клієнт і тип операції, таблиця рядків з кодом, кількістю, сумою без ПДВ, знижкою й ПДВ, підсумок із ПДВ та кнопка «Send to Finvalda». Товарні рядки мають код з моделі чи SKU товару, доставка й збори йдуть окремими рядками послуг, знижка купона записується сумами, а нестандартні замовлення, які не розкладаються на рядки (наприклад, подарунковий сертифікат), зупиняються з поясненням до відправки.
Після відправки в блоці видно журнальний запис, номер документа, клієнта й суму зі статусом «Sent». Замовлення йде у Finvalda один раз: для кожного замовлення є один запис, який займається до виклику, а втрачену відповідь повтор розпізнає як уже створену операцію й просто позначає її відправленою. Відмови Finvalda видно словами з її кодом і текстом, з кнопками «Retry» і «Remove» та нотаткою в історії замовлення.
Клієнта модуль знаходить за e-mail покупця або бере типовий код. У Pro за потреби створює відсутнього покупця (код OC і номер клієнта, для гостя OCG і номер замовлення) з адресою, телефоном, e-mail, кодом компанії та кодом платника ПДВ, а також товари, яких у Finvalda ще немає.
Що в адмінці
Extensions → Extensions → Modules → Finvalda Sales Sync: вкладки «Connection», «Sale operation», «Automation», «Stock and prices» і «Licence». На першій ви вказуєте адресу сервісу, користувача й пароль та натискаєте «Check the connection»: модуль повідомляє, чи прийняв сервіс користувача, чи адреса не належить стороннім сторінкам, чи сервіс не відповідає. Пароль зберігається зашифрованим і не показується; адреса з http:// супроводжується попередженням.
На вкладці «Sale operation» задаються тип операції (продаж PardDok чи резервування PardRezDok), параметр імпорту, код складу, серія, префікс документа (префікс і номер замовлення, до 20 знаків), поле з кодом товару, коди послуг для доставки й зборів, код ПДВ, спосіб вибору клієнта та код типового клієнта. Блок «New clients and products» належить Pro: поля коду компанії й коду платника ПДВ (кнопка «Create the fields» додає два необовʼязкові поля до форм акаунта й чекаута) та коди одиниці, податку й рахунку для нових товарів.
Pro-поля без ключа вимкнені й порожні з поясненням, збережені Pro-значення не показуються.
Pro відправляє замовлення, коли вони досягають обраних статусів: за замовчуванням не обрано жодного, відправка йде у фоні, ніколи під час чекаута. Масова відправка приймає номери замовлень і діапазони на кшталт 1001-1020, 1025, а «Retry all stopped» повторює зупинені. Якщо Pro вимкнеться, рядки в черзі за статусом зупиняться з причиною, а ручна відправка кнопкою працюватиме далі.
Залишки й ціни читаються з Finvalda кожні 15 хвилин порціями по 50 товарів за кодом, з курсором за id товару й бюджетом 20 секунд на прохід. Залишок пишеться в кількість товару (або кількість із резервами, за обраним складом), ціна береться зі стовпця sell_price1–sell_price6, за потреби ПДВ віднімається за вказаною ставкою. Товари, яких Finvalda не знає, не чіпаються, а порожня відповідь нічого не обнуляє. Журнал у меню Sales показує замовлення й рядки синхронізації, кнопка «Sync now» запускає прохід одразу.
Як це працює, крок за кроком
- Встановіть архів для вашої версії OpenCart і модуль у Extensions → Modules.
- Попросіть Finvalda модуль FIN WEB SERVICE та дані веб-сервісу, а в адміністратора — параметр імпорту для операцій із магазину.
- На вкладці «Connection» вкажіть адресу, користувача й пароль і натисніть «Check the connection».
- На вкладці «Sale operation» задайте параметр імпорту, склад, префікс, коди послуг доставки й типового клієнта.
- Переконайтеся, що модель або SKU товарів збігаються з кодами товарів у Finvalda.
- Відкрийте замовлення, перегляньте рядки й суму та натисніть «Send to Finvalda».
- Для Pro: ключ або пробний період на вкладці «Licence», далі статуси, залишки й ціни.
Що під капотом
- Веб-сервіс FVS (FvsServicePure, JSON чи XML-запис): InsertNewOperation для операцій продажу, GetKlientasEMail для пошуку клієнта за e-mail, GetDescriptions для перевірки кодів; залишки й ціни — з Products/CurrentStock. Пароль зберігається зашифрованим і не потрапляє в журнал.
- Рядки операції йдуть із сумою без ПДВ, ставкою й кодом; знижки — сумами, доставка й збори — рядками послуг; підсумок порівнюється із замовленням до виклику. Порожні поля запису не надсилаються.
- Одна операція на замовлення: унікальний запис і захоплення рядка до виклику; збої зв’язку, відповіді 5xx і код 2031 повторюються в фоні, а коди 1001, 1058, 1072 після повтору позначають замовлення відправленим.
- Таймаут виклику 8 секунд (з’єднання 5), кнопка не блокує адмінку довше.
- Інтерфейс англійською й литовською; текст операції — мовою замовлення.
Як встановити
- Extensions → Installer: завантажте архів для вашої версії, не перейменовуючи файл (OpenCart 4 — cc_finvalda.ocmod.zip, 3.x — cc_finvalda-oc3.ocmod.zip, 2.3 — cc_finvalda-oc23.ocmod.zip; для 2.3 вміст теки upload/ копіюється в корінь магазину).
- Для 3.x і 2.3: Extensions → Modifications → Refresh.
- Extensions → Modules → Finvalda Sales Sync: встановіть і відкрийте налаштування.
- На вкладці «Connection» вкажіть адресу, користувача й пароль і натисніть «Check the connection».
- Для Pro: введіть ключ або запустіть пробний період на вкладці «Licence».
Магазин на WooCommerce? Для нього є окремий плагін: Finvalda Sales Sync для WooCommerce.
Питання
про модуль
Не знайшли відповідь? Напишіть у Telegram — відповімо протягом робочого дня.
Це офіційний модуль Finvalda?
Ні, це незалежна інтеграція з Finvalda від CatCode. Finvalda — торгова марка її власника.
Що потрібно, щоб почати?
Модуль FIN WEB SERVICE від Finvalda (його надають на запит), адреса веб-сервісу FVS, користувач і параметр імпорту для операцій із магазину.
Чи дістанеться сервіс із мого хостингу?
Сервер Finvalda часто стоїть в офісі, тому адміністратор має відкрити його для інтернету. Кнопка «Check the connection» показує, чи сервіс відповідає, чи прийняв користувача.
Яким має бути код товару?
Модель або SKU товару в OpenCart дорівнює коду товару в Finvalda. Невідомий код модуль виявляє до відправки й показує, який саме.
Що, коли Finvalda не відповіла?
Збої зв’язку й відповіді 5xx повторюються в фоні. Якщо відповідь загубилась, повтор розпізнає вже створену операцію й позначить замовлення відправленим, дубля не буде.
Чи створюються клієнти й товари?
У Pro: відсутній клієнт і товар створюються в Finvalda, якщо ввімкнено. У безкоштовній версії клієнт береться за e-mail або типовий код.
У якій валюті суми?
У євро. Замовлення в іншій валюті відправляється, коли основна валюта магазину — EUR.
Скільки залишків і цін за раз?
Раз на 15 хвилин порціями по 50 товарів з курсором; наступний прохід продовжує там, де зупинився попередній.
Які версії OpenCart?
OpenCart 4.0.2.x–4.1.x, 3.0.x і 2.3.0.2: три окремі архіви в одному товарі.
Ліцензія назавжди?
Так, для OpenCart одна оплата і ліцензія назавжди, на два сайти.
Що буде після пробного періоду?
Pro вимкнеться, рядки в черзі за статусом зупиняться з причиною, а безкоштовна частина продовжить працювати.
Поки що жодного відгуку. Будьте першим.
Поки питань немає. Запитай — ми відповімо протягом 24 годин.
Не той варіант, що шукаєте?
Робимо кастомні модулі під WordPress, WooCommerce, OpenCart і Shopify. Розкажіть про задачу — підготуємо оцінку.
Замовити кастомний модуль
Купівля модуля
—




















