Электронные счета ClearTax / LHDN

CityScreen Deals отправляет счета на проверку электронного счёта через ClearTax, который передаёт их налоговой службе Малайзии LHDN через платформу MyInvois. В интерфейсе эта интеграция называется «Интеграция с ClearTax», а получатель — государственная система MyInvois.

Это односторонняя исходящая отправка с опросом статуса. Deals отправляет данные счёта в ClearTax, а затем опрашивает результаты валидации: по запросу кнопкой Проверить статус или автоматически в фоне.

Эта интеграция специфична для тенанта. Если она не включена для вашей организации, в интерфейсе её может не быть.

Настройка

Прежде чем отправлять счета, нужно выполнить два шага.

1. Введите учётные данные

  1. Откройте Настройки → Настройки синхронизации → Интеграция с ClearTax.

  2. Введите базовый URL ClearTax и токен доступа.

  3. Включите интеграцию и сохраните.

2. Инициализируйте соответствие типа документа

  1. В том же разделе интеграции с ClearTax нажмите Инициализировать.

  2. Этот одноразовый вызов создаёт и подписывает тип документа, который Deals использует для экспорта электронных счетов.

Действие «Инициализировать» можно выполнить только один раз. Если инициализация уже выполнена, повторное нажатие возвращает ошибку (HTTP 409 Conflict). Это ожидаемо — значит, инициализация уже сделана.

Само соответствие — какой внутренний тип документа представляет счёт для экспорта — настраивается один раз при установке и обычно потом не меняется.

Отправка счёта

  1. Откройте Настройки → ClearTax.

  2. Выберите документ, который нужно отправить.

  3. Нажмите Отправить инвойс.

Deals отправляет документ в ClearTax, который передаёт его в LHDN на валидацию. Успешная отправка добавляет в журнал синхронизации запись об успехе. Чтобы отправить отклонённый счёт повторно, исправьте документ в обычном порядке редактирования документов, затем выберите его здесь и снова нажмите Отправить инвойс.

Бизнес-процессы тоже могут запускать отправку автоматически в рамках рабочего процесса — в этом случае ручные действия не нужны.

Проверка статуса валидации

После отправки счёт проходит валидацию в LHDN. Чтобы опросить текущий статус:

  1. На странице Настройки → ClearTax выберите отправленный документ.

  2. Нажмите Проверить статус.

Кнопка Проверить статус также обновляет статус, показанный в журнале синхронизации.

Когда провайдер возвращает статус VALID, Deals скачивает изображение государственного QR-кода, сохраняет его как вложенный файл документа и записывает время валидации, UUID и длинный ID.

Автоматический опрос статуса

Deals также повторно проверяет в фоне статус валидации ранее отправленных счетов. Это работает независимо от ручных действий: нажимать Проверить статус для каждого документа не нужно.

Документы, которые уже получили конечный статус (валидный, отменённый или неудачный), повторно не проверяются.

Журнал синхронизации

Каждая попытка отправки и проверки статуса записывается в таблицу журнала на странице Настройки → ClearTax.

Каждая запись журнала показывает:

  • Название или идентификатор документа.

  • Статус отправки (Успешно, Ошибка, HTTP-ошибка или Информация).

  • Статус валидации в ClearTax/LHDN.

  • Сообщение об ошибке, если оно есть.

  • Дату и время попытки.

Журнал можно фильтровать по документу и по статусу. Журнал ClearTax хранит полную историю всех попыток.

Что делать при сбоях

Для каждой ситуации ниже сказано, что делать.

Счёт получает статус «Valid» без QR-кода

Провайдер может вернуть статус VALID раньше, чем будет готово изображение QR-кода.

Что делать

Откройте документ на странице ClearTax и снова нажмите Проверить статус. Если QR-код уже доступен у провайдера, Deals скачает его и прикрепит.

Если после успешной проверки статуса QR-кода по-прежнему нет, обратитесь к администратору CityScreen: возможно, провайдер не сформировал QR-код для этого счёта.

Расхождение сумм не проходит валидацию

Счёт может не пройти валидацию в ClearTax/LHDN, потому что итоги по его внутренним строкам не сходятся с общей суммой. Провайдер отклоняет отправку и возвращает ошибку валидации.

Что делать

Прочитайте сообщение об ошибке в журнале синхронизации: в нём указано, какие суммы не совпадают. Исправьте суммы счёта в исходном документе и отправьте его повторно.

Отмена

Можно ли отменить счёт после отправки, зависит от его текущего статуса в жизненном цикле отправки. Эта возможность доступна, когда отмена допустима, а счета в статусах «Submitted», «Validated», «Reviewed» и «Shipped» через интеграцию с ClearTax отменить нельзя.

Права

Для настройки интеграции с ClearTax, отправки документов и проверки статуса нужно право Настройки организации с доступом на редактирование. Это то же право, которое регулирует остальные настройки уровня организации.

Для просмотра журнала синхронизации нужен доступ на чтение к этому же праву.

См. Роли и права.