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 — один архів з цієї сторінки. Без ключа він працює як безкоштовна версія.