
Holded для OpenCart — счета-фактуры из заказов, кредит-ноты, NIF/CIF и склад (Испания)
Holded для OpenCart 4.x, 3.x, 2.3 (Испания): счета со страницы заказа бесплатно, в Pro — по статусу, кредит-ноты, оплаты, склад, журнал. Лицензия навсегда.
- Совместимость
- OpenCart 4.0.2.x–4.1.x, 3.0.x, 2.3.0.2 · язык интерфейса: English, Español
- Версия
-
v1.0.0 (OpenCart 4)
v1.0.0 (OpenCart 3.x)
v1.0.0 (OpenCart 2.3) - Лицензия
- сайт + тестовая копия, навсегда
- Триал
- 7 дней, без карты, один на сайт
- Обновлено
- ноябрь 2026
Что есть во Free,
а что даёт Pro
Бесплатная версия работает без ограничения по времени. Pro добавляет остальные функции из таблицы.
Главное о модуле
Что получает продавец
На странице заказа появляется блок «Holded»: контакт (по e-mail покупателя, найденный или созданный), таблица строк с кодом товара, количеством, ценой без налога, скидкой и налогом Holded и итог заказа.
Что в админке
Extensions → Extensions → Modules → Holded Invoices: семь вкладок «Connection», «Invoice», «Buyer», «Automation», «Stock», «Stores» и «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; адрес магазина по https.
Аккаунт Holded и ключ API с правами из списка выше.
Утверждённый в Holded счёт окончателен. Утверждение выключено по умолчанию: документы остаются черновиками, и вы проверяете их в Holded. Как Holded передаёт утверждённый счёт в VeriFactu, настраивается в Holded: модуль этого не меняет, а серию, отмеченную в Holded как исключённая из VeriFactu, показывает рядом с выбором серии.
Holded считает вызовы API за месяц на аккаунт: счёт стоит 2–4 вызова, каждый шаг Pro (утверждение, чтение, e-mail, платёж, движение склада по строке) ещё один. Списки налогов, серий и складов хранятся час, чтобы экономить вызовы; остаток вызовов модуль читает из заголовка ответа Holded.
Если в магазине ещё работает другой коннектор Holded, документы по тем же заказам могут задвоиться.
Склад: остаток, изменение которого не подтвердилось ответом Holded, повторно не отправляется (строка называет SKU для проверки); в первый раз, когда товар сопоставлен, количество в OpenCart становится количеством из Holded; товары с вариантами в Holded не затрагиваются.
Магазины с отдельным ключом: налоги сопоставляются только по проценту, берётся серия по умолчанию, платежи и склад ведутся только для основного аккаунта.
Кредит-нота выписывается только на весь счёт, частичных возвратов нет.
История версий
Первый выпуск для OpenCart 4.x, 3.x и 2.3.
Вместе с Holded покупают


Скидки от суммы и N+1 для OpenCart

Billin Invoices для OpenCart — счета и чеки Billin (TS Facturas) из заказов

Брошенные корзины для OpenCart 2.3, 3.x и 4.x
Полное описание модуля
Holded Invoices для OpenCart 4.x, 3.x и 2.3 создаёт счета-фактуры в испанском сервисе Holded прямо из заказов магазина: кнопка на странице заказа находит или создаёт покупателя как контакт Holded, передаёт строки заказа с вашими ставками IVA, читает обратно сумму документа, сверяет её с заказом и даёт PDF.
Что нужно от Holded. Аккаунт Holded и ключ API, созданный в Configuración → Desarrolladores → Credenciales («Agregar API Token», права «Por áreas»). Права для Free: Ventas → Facturas (Full), Ventas → Configuración de facturación (Leer), Contabilidad → Impuestos (Leer), Contactos → Contactos (Full); для Pro ещё Contabilidad → Bancos (Leer), Inventario → Productos (Full) и Inventario → Almacenes (Leer). Сам Holded оплачивается по вашему тарифу: модуль не добавляет плату за документы.
Что получает продавец
На странице заказа появляется блок «Holded»: контакт (по e-mail покупателя, найденный или созданный), таблица строк с кодом товара, количеством, ценой без налога, скидкой и налогом Holded и итог заказа. Кнопка «Create the invoice in Holded» создаёт документ; дальше в блоке видны тип, номер, сумма, статус и кнопки PDF и E-mail (Pro).
Holded создаёт документ черновиком, а номер серии (например F260086) появляется после утверждения. В Free черновик вы проверяете и утверждаете в Holded; в Pro можно включить утверждение сразу после создания или нажимать «Approve» в заказе. Купон идёт скидкой строки, доставка — отдельной строкой. Модуль читает сумму обратно из Holded и сверяет с заказом: если они разные, в заметке видны обе суммы.
Что в админке
Extensions → Extensions → Modules → Holded Invoices: семь вкладок «Connection», «Invoice», «Buyer», «Automation», «Stock», «Stores» и «Licence». На первой вы вставляете ключ API и нажимаете «Save and test the connection»: модуль проверяет каждое право, которое читает, называет недостающие и показывает, сколько ставок НДС сопоставлено с налогами Holded. Ключ хранится зашифрованным.
На вкладке «Invoice» каждая ставка НДС магазина (0, 21, 10 %…) сопоставляется с налогом продаж Holded: «Automatic» берёт единственный активный налог с такой ставкой, а если их нет или несколько, счёт останавливается и называет ставку, которую нужно выбрать. Там же язык документа (язык заказа, а когда его нет в Holded — испанский), код товара (SKU или модель) и внутренняя заметка, которую видит только ваша команда в Holded. На вкладке «Buyer» описано, как покупатель становится контактом Holded.
Вкладки «Automation», «Stock» и «Stores» — для Pro. Без ключа они открываются с пояснением и отключёнными полями, сохранённые Pro-значения не показываются.
Pro создаёт счета сам: когда заказ достигает одного из выбранных вами статусов (например «Processing»). Кредит-нота на весь счёт создаётся кнопкой или по статусу возврата («Refunded»): номер счёта записывается в её описании, так она ссылается на счёт. Платёж регистрируется на банковский счёт Holded своего способа оплаты: сразу для оплаченного онлайн заказа или по выбранному статусу для наложенного платежа или перевода. Holded может сам отправить утверждённый документ покупателю по шаблону письма вашего аккаунта. NIF/CIF берётся из поля покупателя на чекауте или вводится в заказе, а контакт ищется по нему.
Склад: товары сопоставляются по SKU или модели, а Holded и OpenCart получают изменения друг друга, а не перезаписывают остаток. Продажа уменьшает остаток на выбранном складе Holded, кредит-нота возвращает его, а то, что изменилось в Holded, добавляется к количеству в OpenCart. У магазинов OpenCart может быть отдельный ключ Holded. Журнал «Holded invoices» в меню Sales показывает каждый документ со статусом, фильтры, итоги по месяцам, «Queue invoices» для массового выписывания по номерам заказов и «Retry all stopped».
Как это работает, шаг за шагом
- Установите архив для вашей версии OpenCart и установите модуль в Extensions → Modules.
- В Holded откройте Configuración → Desarrolladores → Credenciales, нажмите «Agregar API Token», выберите «Por áreas», дайте права из списка на вкладке «Connection» и скопируйте токен (его показывают один раз).
- На вкладке «Connection» вставьте ключ и нажмите «Save and test the connection».
- На вкладке «Invoice» проверьте соответствие ставок НДС налогам Holded, язык документа и код товара.
- Откройте заказ, проверьте строки и сумму и нажмите «Create the invoice in Holded».
- Для Pro: ключ или пробный период на вкладке «Licence», дальше «Automation», «Stock» и «Stores».
Что под капотом
- Holded API v2 (api.holded.com): ключ в заголовке Authorization, JSON; контакты, налоги, серии нумерации, счета, кредит-ноты, утверждение, платежи, отправка e-mail, PDF, банковские счета, склады и товары. Ключ хранится зашифрованным.
- Строки, скидки, купон, доставка и налоги передаются отдельно, а итог Holded читается обратно и сверяется с заказом. Суммы Holded, которые приходят испанскими десятичными (28,05), модуль читает правильно. Налог из сопоставления должен быть активным налогом продаж аккаунта: Holded принимает неизвестный налог без ошибки и считает 0 %, поэтому модуль не создаёт такой счёт и называет ставку.
- Фоновая работа (повтор после временных сбоев, счета по статусу, массовые действия, склад) идёт из планировщика OpenCart 4 каждый час и из открытий страниц; серверный cron по адресу с вкладки «Automation» ускоряет её.
- Вызов, на который Holded не ответил, не создаёт дубля: перед повтором модуль ищет документ в Holded по описанию «OpenCart order #N» в окне дат. Таймаут вызова 8 секунд (PDF — 20), ошибки полей ответа 422 показываются словами, а ответ 429 ждёт время из Retry-After.
- Интерфейс на английском и испанском, документ — на языке заказа.
Как установить
- Extensions → Installer: загрузите архив для вашей версии, не переименовывая файл (OpenCart 4 — cc_holded.ocmod.zip, 3.x — cc_holded-oc3.ocmod.zip, 2.3 — cc_holded-oc23.ocmod.zip; для 2.3 содержимое папки upload/ копируется в корень магазина).
- Для 3.x и 2.3: Extensions → Modifications → Refresh.
- Extensions → Modules → Holded Invoices: установите и откройте настройки.
- На вкладке «Connection» вставьте ключ API и нажмите «Save and test the connection».
- Для Pro: введите ключ или запустите пробный период на вкладке «Licence».
Вопросы
о модуле
Не нашли ответ? Напишите в Telegram — ответим в течение рабочего дня.
Это официальный модуль Holded?
Нет, это независимая интеграция с Holded от CatCode. Holded — торговая марка её владельца.
Что нужно, чтобы начать?
Аккаунт Holded и ключ API с правами из списка на вкладке «Connection».
Почему счёт без номера?
Holded создаёт документ черновиком, а номер серии появляется после утверждения. В Free вы утверждаете счёт в Holded, в Pro — кнопкой «Approve» в заказе или автоматически, если включили утверждение.
Можно ли удалить выписанный документ?
Черновик можно изменить в Holded. Утверждённый счёт окончателен: его исправляет кредит-нота (Pro: кнопка в заказе или статус возврата).
Как кредит-нота связана со счётом?
Модуль записывает номер счёта в описании кредит-ноты. Кредит-нота выписывается на весь счёт, частичных возвратов нет.
Что, если ставке НДС не соответствует ни один налог Holded?
Счёт не создаётся, а сообщение называет ставку, для которой нужно выбрать налог на вкладке «Invoice».
Что, если Holded не ответил?
Модуль ставит строку на повтор и перед ним ищет документ в Holded по описанию заказа, так что второго счёта не будет.
Можно ли выписывать счета массово?
Да, в Pro: «Queue invoices» принимает номера заказов и диапазоны (до 500), «Retry all stopped» повторяет остановленные.
Какие версии OpenCart?
OpenCart 4.0.2.x–4.1.x, 3.0.x и 2.3.0.2: три отдельных архива в одном товаре.
Лицензия навсегда?
Да, для OpenCart одна оплата и лицензия навсегда, на два сайта.
Что будет после пробного периода?
Pro отключится, счета в очереди по статусу остановятся с причиной, а бесплатная часть продолжит работать.
Пока нет ни одного отзыва. Будьте первым.
Пока вопросов нет. Спроси — мы ответим в течение 24 часов.
Не тот вариант, что искали?
Делаем кастомные модули под WordPress, WooCommerce, OpenCart и Shopify. Расскажите о задаче — подготовим оценку.
Заказать кастомный модуль
Покупка модуля
—
Оплата списывается в гривне, ваш банк пересчитает её в вашу валюту. Цена в евро ориентировочная.




















