Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Anchor
testingOnlineCachbox
testingOnlineCachbox
 Порядок действий для тестирования онлайн-кассы на тестовой валюте

  1. Переводим магазин в режим тестирования подробнее об этом смотрите в разделе: Тестирование на тестовой валюте

Онлайн кассы в системе IntellectMoney

Описание

С 1 февраля 2017 года контрольно-кассовая техника должна будет не только печатать чеки, но и отправлять их электронные версии оператору фискальных данных. Для этого вместо ЭКЛЗ надо поставить фискальный накопитель, подключить ККТ к интернету и заключить договор с оператором фискальных данных.

Заявка на подключение онлайн кассы

Заявка на подключение онлайн кассы при создании магазина

При создании нового (первого) магазина в системе IntellectMoney, Вы можете оставить заявку на подключение онлайн кассы.

Image Removed

Заявка на подключение онлайн кассы после создания магазина

Оставить заявку на подключение онлайн кассы для существующего магазина можно на вкладке "Оналйн касса" кликнув по кнопке "Подать заявку".

Image Removed

Управление онлайн кассой из личного кабинета IntellectMoney

Каждая заявка на подключение онлайн кассы обрабатывается Вашим персональным менеджером. Этот процесс может занять некоторое время. Пока менеджер проводит работу на вкладке "Онлайн касса", Вы увидите такое сообщение:

Image Removed

 Когда все подготовительные работы будут завершены, Вы сможете самостоятельно управлять подключенной онлайн кассой.

Image Removed

ПолеОписаниеСтавка НДСУкажите по какой ставке НДС Вы работаетеСостояние кассы

"Выключена" - онлайн касса выключена, параметр merchantReceipt передавать не обязательно

"Включена с автогенерацией" - онлайн касса включена, чек создается системой IntellectMoney, в чеке будет только одна позиция, в качестве описания берем текст из serviceName.

"Включена" - онлайн касса включена, чек создается из параметра merchantReceipt, переданного в форме выставления счёта или через метод createInvoice. Параметр merchantReceipt обязательный и проходит проверку на правильность формирования

Тестирование онлайн кассы

Процессы тестирования:

  1. Переводим счёт из "Рублевый счет" в "Тестовый счет" на вкладке "Общие" в настройках магазина.
  2. Проверяем форму выставления счёта:
    1. В параметре recipientCurrency передается значение "TST"
    2. Параметр merchantReceipt передаётся согласно протоколу (можно не передавать если онлайн-касса включена с автогенерацией)
  3. Выставляем счёт и оплачиваем его тестовой валютой (TST).
  4. Переходим Заходим в личный кабинет на в раздел Список счетов на вкладку "Список чеков" и  и находим созданный чек:

Неверно передан MerchantReceipt

Expand
titleНеверно передан MerchantReceipt

После включения онлайн кассы в настройках магазина, интернет-магазин должен формировать и передавать на страницу оплаты дополнительный параметр merchantRecepit.
Данный параметр проходит проверку (валидацию) на корректность составления перед тем как Счёт К Оплате будет создан. Если параметр не передан или создан не верно, то будет выведено сообщение об ошибке. Требования к merchantReceipt находятся в документации.

Наиболее распространенные ошибки и способы решения:

Порядок действий для тестирования онлайн-кассы на рублевой валюте

Порядок действий для тестирования онлайн-кассы на рублевой валюте не отличается от тестирования на тестовой валюте, единственное различие будет в параметре  recipientCurrency, который передается со значением RUB, и магазин настроен на прием Рублевой валюты.

Чек лист тестирования

  1. Выставление и оплата счета
  2. Выставление и оплата счета для заказов, в которых применены купоны
  3. Выставление и оплата счета для заказов, в которых применены скидки
  4. Выставление и оплата счета для заказов, в которых применены купоны и скидки
  5. Выставление и оплата счета для заказов, в которых есть доставка
  6. Выставление и оплата счета для заказов, в которых применены купоны и доставка
  7. Выставление и оплата счета для заказов, в которых применены скидки и доставка
  8. Выставление и оплата счета для заказов, в которых применены купоны, скидки и доставка
  9. Выставление и оплата счета для заказов, где в описании товаров есть одинарные кавычки
  10. Выставление и оплата счета для заказов, где в описании товаров есть двойные кавычки


Anchor
errorMerchantReceipt
errorMerchantReceipt

Частые вопросы

ВопросПричинаОтвет
Неверно передан параметр merchantReceipt

Сумма позиция

ExpandtitleСумма позиций

не совпадает с суммой платежа

Image Removed

Сумма позиций в чеке не совпадает с суммой платежа.

Image Added

Чаще всего причина в том, что не учитывается доставка или скидки предоставляемые интернет магазином

.

Доставка должна быть отдельной позицией в чеке, с соответствующей ставкой налога. Если на странице сайта есть скидки - их тоже надо учитывать при формировании чека.
Expand
titlecustomerContact не передан или имеет не верный формат

Image Removed

customerContact - Телефон
Пример формирования merchantReceipt на языке php приведен здесь

Параметр merchantReceipt имеет неверное поле customerContact (телефон или электронная почта (email) покупателя

. Строка

)

Image Added

Проверьте правильность параметра: строка от 1 до 64 символов, формат ((8|0|\+\d{1,2})[\- ]?)?(\(?\d{3}\)?[\- ]?)?[\d\- ]{4,20}) для телефона или ^([_\-\.0-9a-zA-Z+]+@([_0-9a-zA-Z-\.]+)\.([a-zA-Z]{2,7}))$ для email
. Expandtitle

Название

позиции

позиций превышает длину

Image Removed

Image Added


Проверьте длину параметра text -
Наименование
наименования предмета расчета. Строка до 128 байтов. Внимание, при преобразовании символов из кодировки windows - 1251 в кодировку UTF - 8 буквы, набранные кириллицей, могут занимать два байта и более

Вы не передаете обязательный параметр merchantReceipt, из-за чего возникает данная ошибка

Image Added

Произведите необходимые доработки по формированию данного параметра. Ссылка на документацию по формированию merchantReceipt

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

К примеру, в приведенном на рисунке ниже не все фигурные скобки закрыты, нет квадратных скобок, и пустой параметр customerContact.

Image Added

Проверьте правильность формирования данного параметра
Когда происходит отправка данных для формирования чека?-Данные для формирования чека отправляются в онлайн кассу в момент зачисления денег на счет магазина. Например, при холдированном счете, пока счет захолдирован, данные в онлайн кассу не отправляются. В момент когда магазин зачисляет себе средства, данные отправляются в онлайн кассу. При уменьшении суммы СКО или частичном расхолдировании необходимо заново отправить данные для чека, чтобы сумма заказа не отличалась от суммы чека
Expandtitle
Отражение скидки в чеке для налоговой
Описание проблемыНеобходимо
: иногда покупателям предоставляется скидка не на отдельные товары, а на заказ, как правильно отразить такую скидку в чеке для налоговой
.
?-

В чеке необходимо

указывать цену товара с учетом скидок и наценок.
В случае, если Вы

хотите указывать

применяете скидку не на отдельные товары, а на заказ, то необходимо уменьшить базовую цену всех товаров которые Вы передаете в чеке на величину скидки.

Также

,

Вы можете уточнить данный вопрос в налоговой

.

Не приходят электронные чеки клиентам
(дорабатывается) Expand
-
titleНе приходят электронные чеки клиентам
По данному вопросу Вы можете также обратиться в ОФД
. Expand
Каковы обязательные
titleОбязательные
параметры для формирования чеков?-

Описание проблемы: касса арендована

касса

, заключен договор с ОФД, какие параметры необходимо передавать для

корректной работы.Возможные причиныСпособ решенияЕсли вы арендовали кассу у ОранджДата и заключили договор с ОФД, то вам необходимо только передавать merchantReceipt и когда вы будете передавать этот параметр сообщить менеджеру, что вам необходимо активировать онлайн кассу.Текущего merchantReceipt хватает для генерации чека. В будущем в связи с расширением протокола взаимодействия с онлайн кассой будет расширен и merchantReceipt

формирования чека?

Для формирования чека необходимо передавать параметр merchantReceipt. В нем должна быть вся необходимая информация для формирования чека. Подробнее о правилах формирования merchantReceipt вы можете прочитать в этой статье.

На сайте используется холдирование платежей, соответственно, сумма может измениться в процессе проверки заказа менеджером. При изменении суммы происходит частичный возврат денег пользователю. Как и когда в данном случае отправлять информацию для чека?
Тоже самое касается возврата платежа. Нужно ли при возврате снова отправлять данные merchantReceipt?
-При запросе платежа, Вы отправляете необходимы данные для формирования чека. После того как мы получаем информацию об оплате или, в случае для холдированных платежей, о зачислении на счет магазина, система IntellectMoney отправляет информацию по чеку в онлайн кассу
Был сформирован параметр merchantReceipt, как данный параметр влияет на выставление СКО? Как его протестировать?Подключили онлайн-кассу, но еще не активировали ее. Есть сомнения в корректности параметра. merchantReceipt. Нет возможности тестированияК сожалению, тестовой среды у нас нет. Передача параметра merchantReceipt, без активации кассы, не влияет на выставление счёта к оплате. После того как Вы активируете онлайн кассу в личном кабинете IntellectMoney, передача параметра merchantReceipt станет обязательна, для упрощения интеграции, наша система проверяет данный параметр и, в случае не соответствия, будет отображаться ошибка с описанием не соответствий
В ОФД не появляются чекиНе передается параметр merchantReceipt
Expand
titleВ ОФД не появляются чеки

Описание проблемы: создали и оплатили счет, чеков в офд нет.

Возможные причиныСпособы исправитьНе передается параметр merchantReceipt.
Произведите необходимые доработки для формирования merchantReceipt. Для формирования чеков Вам необходимо передавать данный параметр. Ссылка на документацию по формированию merchantReceipt.
Неправильно сформирован merchantReceipt
.
Если данный параметр не правильно сформирован, то при попытке выставить счёт, на экране будет отображена информация о не соответствии. Вам следует проверить правильность его формирования и исправить ошибки. Ссылка на документацию по формированию merchantReceipt
.
При отправке данных для чека Вы передали значение Tax =0, что не соответствует необходимому
.
Вам необходимо либо указать в настройках товара ставку НДС либо фиксировано прописать ее в коде модуля
.
Счет еще не оплачен
.
На вкладке "Список чеков" чеки появляются после того как счет оплачен. Если счет не был оплачен, то чека не будет
.
Не активирована онлайн касса
.
Когда у Вас всё будет готово, нужно будет перейти в личный кабинет IntellectMoney, в настройки магазина на вкладку "Онлайн касса" и кликнуть кнопку "Подключить". После того как наши менеджеры проверят Вашу готовность и всё будет готово, у Вас появится возможность самостоятельно включать и выключать онлайн-кассу, на той же странице где и подавали заявку
.
expand


Content by Label

titleВзаимодействие онлайн-кассы при холдировании и отмене/возврате средств

showLabelsfalse
titleСвязные страницы
cqllabel = "online-kassa"

Описание проблемы: на сайте используется холдирование платежей. Соответственно, сумма может измениться в процессе проверки заказа менеджером. При изменении суммы происходит частичный возврат денег пользователю. Как и когда в данном случае отправлять информацию для чека ?
Тоже самое касается возврата платежа. Нужно ли при возврате снова отправлять данные merchantReceipt ?

Возможные причиныСпособ исправитьПри запросе платежа, Вы отправляете необходимы данные для формирования чека. После того как мы получаем информацию об оплате или, в случае для холдированных платежей, о зачислении на счет магазина, система IntellectMoney отправляеb информацию по чеку в онлайн кассу. 

toc