E-Invoice (IRN) и E-Way Bill через ClearTax для WooCommerce

CatCode E-Invoice with ClearTax for WooCommerce отправляет заказы WooCommerce в E-Invoicing API ClearTax (Clear) через ваш собственный API-клиент и сохраняет на заказе то, что вернул портал: IRN, номер и дату подтверждения и подписанный QR-код. Для интернет-магазинов в Индии, которые обязаны передавать B2B-счета на Invoice Registration Portal. Интерфейс модуля на английском.

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

В блоке «E-invoice (ClearTax)» на экране заказа есть кнопка «Check»: модуль проверяет GSTIN покупателя, штат и PIN-код, HSN или SAC каждой строки, номер документа и суммы, а затем запускает проверку ClearTax без регистрации. Кнопка «Generate IRN» отправляет заказ; IRN, номер и дата подтверждения и подписанный QR-код сохраняются на заказе. QR-код виден на экране заказа, в письмах о заказе и на странице заказа в кабинете покупателя. Можно скачать PDF, который печатает ClearTax, обновить статус и привязать уже существующий IRN: после запроса без ответа достаточно вставить IRN, и модуль прочитает документ из ClearTax. Тип поставки (B2B, SEZ, условный экспорт, экспорт) определяется из заказа и меняется вручную; для заказов в другой валюте указывается курс. Среды Sandbox и Production переключаются в настройках, секрет клиента хранится зашифрованным, а токен доступа используется повторно до истечения срока.

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

IRN в фоне, когда заказ становится Processing или Completed: сбой никогда не блокирует заказ, причина попадает в заметки и журнал. Массовое действие в списке заказов и колонка «E-invoice». Отмена IRN с указанием причины. E-way bill по IRN или для заказов без IRN: перевозчик, транспортное средство, обновление Part B, отмена и PDF e-way bill. Кредит-нота на возврат: возврат заказа с IRN регистрируется как кредит-нота со ссылкой на счёт, вручную или автоматически. Динамический UPI QR-код ClearTax для заказов B2C. Журнал: каждый запрос с результатом и, для кодов ошибок, которые документирует ClearTax, подсказкой, что делать.

Что стоит знать заранее

• Нужен собственный аккаунт ClearTax с продуктом E-Invoicing. API-клиент и его секрет принадлежат вам, а e-invoice регистрируются по вашему GSTIN.
• IRN — налоговая запись. Портал позволяет отменить её только в течение 24 часов, поэтому перед первой регистрацией пользуйтесь кнопкой «Check» и начните с Sandbox.
• IRN получают заказы покупателей с GSTIN (B2B), поставки в SEZ, условный экспорт и экспорт. Заказы покупателей без GSTIN (B2C) портал не регистрирует, модуль отказывает в IRN для них (в Pro для них есть динамический QR-код оплаты).
• Если запрос завершился без ответа, документ мог дойти до портала, тогда повторная попытка отклоняется как дубликат: скопируйте IRN из ClearTax и привяжите его кнопкой на заказе.
• ClearTax отзывает прежний токен каждый раз, когда выдаёт новый, и выдаёт не больше 288 токенов в сутки. Создайте для сайта отдельный API-клиент, чтобы другая система (например, ERP) не сбрасывала токен модуля.
• Sandbox принимает как продавца только тестовые GSTIN ClearTax, например 29AAFCD5862R000; они перечислены в документации ClearTax.
• Модуль не рассчитывает GST: он передаёт то, что начислил заказ. Ставки настраиваются в WooCommerce.
• Без CatCode GST Invoice номер документа складывается из префикса и номера заказа, а дата равна дню отправки; это не сплошная серия счетов.
• Интерфейс модуля только на английском.

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

1. В аккаунте Clear откройте Settings → Integrations → API Clients, создайте API-клиент с продуктом E-Invoicing и скопируйте секрет клиента.
2. В WooCommerce → E-Invoice (ClearTax) выберите среду, вставьте секрет, нажмите «Check connection», заполните данные продавца и сохраните.
3. Откройте заказ покупателя с GSTIN, нажмите «Check», затем «Generate IRN».
4. IRN, номер подтверждения и QR-код появятся в блоке заказа, в письмах и в кабинете покупателя.

Под капотом

• Секрет клиента хранится зашифрованным и никогда не выводится обратно на страницу.
• Токен доступа используется повторно, пока не истечёт срок его действия.
• Перед отправкой документ сверяется локально: GSTIN, штат, PIN-код, HSN или SAC, номер, суммы, а затем ClearTax выполняет собственную проверку без регистрации.
• Как зарегистрированный документ сохраняется только то, что подтвердил ClearTax.
• Совместим с HPOS, блочным и классическим чекаутом; язык интерфейса: English.

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

1. Плагины → Добавить новый → Загрузить плагин: выберите zip и активируйте.
2. WooCommerce → E-Invoice (ClearTax): выберите среду и вставьте секрет клиента.
3. Нажмите «Check connection» и заполните GSTIN и данные продавца.
4. Сначала прогоните несколько заказов в Sandbox с тестовым GSTIN.

Модуля пока нет на wordpress.org: бесплатная версия и Pro — один архив с этой страницы. Без ключа он работает как бесплатная версия.