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

Billin Invoices создаёт в испанском сервисе Billin (TS Facturas) счёт-фактуру из заказа OpenCart, если покупатель указал NIF, и упрощённый чек, если нет. Ключ НДС (IVA, IGIC или IPSI) ставится по каждой позиции, скидки и доставка сводятся к сумме заказа, PDF берётся из Billin. В Pro документ выписывается по статусу, а оплата записывается в Billin. На сайте Billin названа интеграция только с Shopify; для OpenCart коннектора не найдено. Для доступа к API нужен тариф Ilimitado.

Мок написан по документом OpenAPI на api.billin.net/docs-json.

Что делает бесплатная версия

Панель на странице заказа с кнопкой «Создать документ». Поле NIF на оформлении создаёт кнопка в настройках. Повторный клик не создаёт второго документа, сбой Billin ставит запись в очередь с повтором, а перед повтором модуль ищет в Billin документ с номером заказа в ссылке, поэтому ответ, потерявшийся после записи, не даёт дубля счёта-фактуры.

Что добавляет Pro

Документ по выбранному статусу заказа и запись оплаты в Billin по другому статусу (или сразу для заказов, оплаченных на оформлении). Повторный статус не создаёт второго документа.

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

1. Получите доступы Billin.
2. Введите их в модуле и нажмите «Проверить».
3. Проведите один тестовый заказ.
4. Включите автоматику (Pro), когда убедитесь.

Под капотом

• Секрет шифруется и не показывается в настройках.
• Токен Billin обновляется сам.
• Языки: English, español.

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

1. Расширения → Установка расширений: загрузите zip.
2. Расширения → Модули: установите и откройте модуль.
3. Настройки модуля: Client ID и Client Secret из раздела «Integraciones» в Billin; кнопка «Сохранить и проверить».
4. Попробуйте на одном тестовом заказе.

Нужен OpenCart 4.0.2 или новее. Имя архива не меняйте.