Чёрный ноябрь: −35% на все модули до 30 ноября Чёрный ноябрь: −35% до 30 ноября Выбрать модуль

Связаться
OpenCart

Holded для OpenCart — счета-фактуры из заказов, кредит-ноты, NIF/CIF и склад (Испания)

Holded для OpenCart 4.x, 3.x, 2.3 (Испания): счета со страницы заказа бесплатно, в Pro — по статусу, кредит-ноты, оплаты, склад, журнал. Лицензия навсегда.

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
Или все 509 Pro-модулей в All Access — 3 244 грн / год ≈ 66 €

Что есть во Free,
а что даёт Pro

Бесплатная версия работает без ограничения по времени. Pro добавляет остальные функции из таблицы.

Функция Free Pro
Подключение Holded ключом API с проверкой прав, ключ зашифрован ✔ ✔
Соответствие ставок НДС налогам Holded, автоподстановка единственного налога со ставкой ✔ ✔
Счёт со страницы заказа вручную: контакт по e-mail, строки, скидка в %, доставка, адрес доставки ✔ ✔
Сумма Holded читается обратно и сверяется с заказом, PDF и строка в истории заказа ✔ ✔
Язык документа, SKU или модель как код строки, внутренняя заметка ✔ ✔
Потерянный ответ: поиск документа в Holded перед повтором, без второго счёта ✔ ✔
Интерфейс на английском и испанском ✔ ✔
Счёт автоматически по статусу заказа — ✔
Утверждение в Holded и серии нумерации для счетов и кредит-нот — ✔
NIF/CIF покупателя из поля чекаута или из заказа, контакт по NIF — ✔
Кредит-нота на весь счёт кнопкой или по статусу — ✔
Оплата на банковский счёт Holded по способу оплаты — ✔
E-mail из Holded покупателю автоматически и кнопкой — ✔
Склад по SKU со складом Holded: изменения в обе стороны, без перезаписи — ✔
Отдельный ключ Holded для каждого магазина OpenCart — ✔
Журнал, массовое выписывание, повтор всех остановленных, итоги по месяцам — ✔

Как это выглядит

Блок Holded в заказе
Блок «Holded» на странице заказа: контакт, строки с налогами Holded, итог и кнопка создания счёта.
Настройки счёта Holded
Вкладка «Invoice»: соответствие ставок НДС налогам Holded, язык документа, код товара, утверждение и серии (Pro).
Автоматизация Holded
Вкладка «Automation» (Pro): статусы для счёта и кредит-ноты, e-mail из Holded, оплаты на банковские счета.

Главное о модуле

Что получает продавец

На странице заказа появляется блок «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 не затрагиваются.
  • Магазины с отдельным ключом: налоги сопоставляются только по проценту, берётся серия по умолчанию, платежи и склад ведутся только для основного аккаунта.
  • Кредит-нота выписывается только на весь счёт, частичных возвратов нет.

История версий

v1.0.0 Текущая ноябрь 2026

Первый выпуск для OpenCart 4.x, 3.x и 2.3.

Вместе с Holded покупают

All Access Нужно больше? Все модули (509) одной лицензией, новые добавляются сами. 3 244 грн≈ 66 € Подробнее →

Полное описание модуля

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

Как это работает, шаг за шагом

  1. Установите архив для вашей версии OpenCart и установите модуль в Extensions → Modules.
  2. В Holded откройте Configuración → Desarrolladores → Credenciales, нажмите «Agregar API Token», выберите «Por áreas», дайте права из списка на вкладке «Connection» и скопируйте токен (его показывают один раз).
  3. На вкладке «Connection» вставьте ключ и нажмите «Save and test the connection».
  4. На вкладке «Invoice» проверьте соответствие ставок НДС налогам Holded, язык документа и код товара.
  5. Откройте заказ, проверьте строки и сумму и нажмите «Create the invoice in Holded».
  6. Для 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.
  • Интерфейс на английском и испанском, документ — на языке заказа.

Как установить

  1. 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/ копируется в корень магазина).
  2. Для 3.x и 2.3: Extensions → Modifications → Refresh.
  3. Extensions → Modules → Holded Invoices: установите и откройте настройки.
  4. На вкладке «Connection» вставьте ключ API и нажмите «Save and test the connection».
  5. Для Pro: введите ключ или запустите пробный период на вкладке «Licence».

Вопросы
о модуле

Не нашли ответ? Напишите в Telegram — ответим в течение рабочего дня.

@catcode_support Настройка, совместимость, активация
Это официальный модуль 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 отключится, счета в очереди по статусу остановятся с причиной, а бесплатная часть продолжит работать.

Не тот вариант, что искали?

Делаем кастомные модули под WordPress, WooCommerce, OpenCart и Shopify. Расскажите о задаче — подготовим оценку.

Заказать кастомный модуль