1С Битрикс

Логотип

Описание

1C Битрикс

Профессиональная система управления интернет-проектами. В спектр возможностей «1С-Битрикс» включены все этапы работы с веб-сайтами — от создания до поддержки и успешного развития..

На сайте CMS

Маркетплейс 1C-Bitrix

«1С-Битрикс» - профессиональная система управления веб-проектами, В спектр возможностей «1С-Битрикс» включены все этапы работы с веб-сайтами для создания до поддержки и успешного развития:

корпоративных сайтов

интернет-магазинов

информационных порталов

сайтов сообществ

социальных сетей и других веб-проектов

Введение

Инструкция для установки модуля Версии 3.2.0.

Совместимость версии модуля и версии CMS Вы можете посмотреть здесь.

Инструкции по установке модуля на старые версии CMS:

При переходе с версии 3.1.3 на версию 3.2.0 дополнительные настройки не нужны.

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

В административной части интернет магазина:

Переходим в MarketPlace
Выбираем "Каталог решений"
В поиск вводим название системы "IntellectMoney" и нажимаем "Enter" ("Ввод")
Выбираем пункт "Установить"
В открывшемся окне загрузки отмечаем "Система IntellectMoney"
Нажимаем "Загрузить"
Читаем лицензионное соглашение и принимаем, нажав на кнопку "Применить"
После процесса загрузки, устанавливаем решение, кликнув кнопку "Установить"

Процесс установки закончен

Настройка модуля

Настройка модуля в административной части интернет магазина:

Переходим в раздел "Магазин"
Выбираем раздел "Платёжные системы"
В строке "Система IntellectMoney" раскрываем меню
В раскрывшемся меню выбираем "Изменить"
1. Описание - описание платёжной системы, которое будет показано при оформлении заказа - можно не заполнять
2. Логотип - логотип платёжной системы, который будет показан при оформлении заказа - можно не изменять
3. Кодировка - кодировка сайта - обязательно заполнить, если у Вас подключена онлайн касса
1. Номер магазина в системе IntellectMoney - указать номер магазина из личного кабинета IntellectMoney - заполнить обязательно
2. Секретный ключ - должен соответствовать придуманному Вами секретному ключу из личного кабинета IntellectMoney - заполнить обязательно
3. Адрес при успешной оплате - куда перенаправить пользователя после успешной оплаты, только для моментальных способов оплаты - можно не заполнять
4. Доступные способы оплаты - ограничивает количество способов оплаты на платёжной странице - можно не заполнять
5. Язык интерфейса в системе IntellectMoney - язык, на котором будет отображаться страница оплаты, по умолчанию - Русский язык - можно не заполнять
6. Тестовый режим - отвечает за выставление счетов в тестовой валюте (TST), убедитесь что магазин в ЛК IntellectMoney настроен на прием тестовой валюты, пржде чем переходить к тестированию - можно не изменять
Все параметры заполняются по необходимости:
1. Режим холдирования - включает режим холдирования денежных средств:
  1. Холдировать счёт - включает режим холдирования
  2. Не холдировать счёт - отключает режим холдирования
  3. Задано в личном кабинете - не передаёт параметры холдирования, все значения забираются из ЛК IntellectMoney
2. Срок жизни счёта - Указывает:
  1. "Не холдировать счёт" - срок жизни СКО, максимальное значение 4319 часов
  2. "Холдировать счёт" - срок жизни СКО и срок холдирования, максимальное значение 119 часов (по умолчанию 72 часа)
3. Срок холдирования денежных средств - Срок холдирования денежных средств на счёте покупателя, максимальное значение 119 часов (по умолчанию 72 часа)
Все поля обязательны к заполнению, если подключена онлайн касса
1. ИНН - индивидуальный номер налогоплательщика - должен соответствовать указанному в ЛК IntellectMoney
2. Ставка НДС для товаров - укажите процентную ставку для товаров
3. Ставка НДС для доставки - укажите процентную ставку для доставки
4. Группа устройств - название группы устройств, которыми будут пробиты чеки онлайн кассы, по умолчанию Main
1. Код заказа - "Оплата" - "Номер оплаты", будет передавать номер оплаты, как номер платежа в Вашей системе (пример 32/1) - заполнить обязательно
2. Email - откуда брать email покупателя, заполнить на Ваше усмотрение - можно не заполнять
  Если не заполнить пункты c-g не будет производится смена статусов заказа
3. Счёт создан - статус заказа, после создания СКО (счета к оплате) - заполнить обязательно
4. Счёт оплачен - статус заказа, после оплаты СКО (счета к оплате) - заполнить обязательно
5. Счёт захолдирован - статус заказа, после того как денежные средства захолдированы - заполнить обязательно
6. Счёт частично оплачен - статус заказа, после частичной оплаты СКО (счета к оплате) - заполнить обязательно
7. Счёт отменён - статус заказа, после отмены СКО (счета к оплате) - заполнить обязательно
Нажимаем сохранить

Дополнительно

В личном кабинете на сайте IntellectMoney в настройках магазина в поле ResultURL укажите http://xxx.ru/bitrix/tools/im.payment/result.php где xxx.ru -адрес сайта

Unable to render {include} The included page could not be found.

Настройка почтовых уведомлений

Перейдите в настройки магазина. Как это сделать описано в статье "Настройки магазина".
Выберите вкладку "Рассылки" и отметьте галками те письма, которые хотели бы получать.

Возможно включить рассылку следующих писем:

Письмо для клиента о создании СКО. Если отметить, то при создании СКО магазину будет направлено письмо с уведомлением на eMail указанный им при выставлении СКО
Письмо для магазина о создании СКО. Если отметить, то при создании СКО магазину будет отправлено соответствующее уведомление на eMail указанный при регистрации магазина
Письмо для магазина о полной оплате СКО. Если отметить, то после полной оплаты счета к оплате магазину будет направлено письмо с соответствующим уведомлением
Письмо об ошибке при отправке запроса для магазина. Если отметить, то магазин будет уведомлен письмом об ошибке при отправке запроса от системы IntellectMoney магазину
Письмо для неклиента о создании СКО. Если отметить, то при создании СКО покупателю будет направлено письмо с уведомлением на eMail указанный им при выставлении СКО
Письмо для магазина о холде средств на СКО. Если отметить, то при оплате холдированного СКО магазину будет отправлено письмо с соответствующим уведомлением
Письмо об ошибке при создании СКО для магазина. Если отметить, то при ошибке в момент выставления СКО, магазину будет отправлено письмо с ошибкой
Письмо для магазина о возврате по СКО. При возврате по СКО магазину будет отправлено письмо
Письмо для клиента о возврате по СКО. При возврате СКО будет отправлено письмо на email, указанный при выставлении СКО
Письмо для магазина о фродовой операции. При подозрении о возникновении фродовой операции магазину будет отправлено письмо с описанием
Письмо для магазина о сдаче в кошелек плательщика. Письмо будет отправлено магазину в том случае, если при оплате СКО деньги попали в сдачу (например оплатили больше, чем сумма СКО)
Письмо для магазина при отмене клиентом подписки. Если отметить, то магазин будет уведомлен при отмене клиентом подписки
Письмо для клиента при отмене подписки. Если отметить, то клиенту будет отправлено письмо при отмене подписки

Версия	Дата изменения	Описание	Установка
3.2.0	09.10.2018	Решение использует ядро D7 подходит для версий Bitrix начиная 17.0.9	установить
3.1.1	07.11.2017	Незначительные изменения решения подходит для версий Bitrix начиная 17.0.9
3.1.0	27.10.2017	Значительное изменение решения для версии Bitrix начиная 17.0.9
3.0.2	20.06.2016	Исправлено округление цен при скидках
3.0.1	09.06.2016	Значительные изменения модуля для новой версии Bitrix 16.0.11 и выше с установленной версией модуля Интернет-магазин (sale) 16.0.11 и выше
2.2.1	26.05.2015	Внесены изменения с учетом новых версий bitrix
2.0.1	26.01.2015	Добавили описание установки для мультисайтовых версий
1.0.2	18.01.2012	Исправили обработку статусов заказов
1.0.1	18.01.2012	Внесли исправления

Модуль оплаты обладает всем необходимым функционалом для формирования СКО (счета к оплате) по оформленному клиентом заказу.

Модуль оплаты переводит клиента на страницу, где осуществляется оплата СКО (счета к оплате).

Модуль оплаты также позволяет

Error rendering macro 'excerpt-include'

No link could be created for 'Самостоятельная интеграция'.

#001. Модуль для 54 ФЗ для 1С bitrix (черновик)

Описание проблемы: необходим модуль для 1С bitrix, который соответствует для 54 ФЗ. Прошу прислать инструкцию + файлы модуля.

Возможные причины

Способы решения

У нас есть предварительная доработка модуля: payment.php Необходимо этим файлом заменить файл модуля расположенный по адресу: корневая папка сайта\bitrix\php_interface\include\sale_payment\im.payment\ Также в нем необходимо указать ИНН, и если требуется убрать преобразование кодировок.

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

#002. Ключ "IM.ESHOP_ID" не найден в массиве GLOBALS[SALE_CORRESPONDENCE] и значение по умолчанию не определено. Идентификатор заказа: "1748", идентификатор платежной системы: "4" (CAllSalePaySystemAction::GetParamValue)

Описание проблемы: Ключ "IM.ESHOP_ID" не найден в массиве GLOBALS[SALE_CORRESPONDENCE] и значение по умолчанию не определено. Идентификатор заказа: "17XX", идентификатор платежной системы: "4" (CAllSalePaySystemAction::GetParamValue)

Возможные причины	Способ исправить
Во время обработки уведомления возникла ошибка по данному заказу.
Не найден номер магазина.
Изменились данные заказа.
Счёт был выставлен из личного кабинета IntellectMoney, в в системе (CMS) магазина не был создан.

#003. Отображается только один способ оплаты

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

Возможные причины

Способ исправить

В админке модуля указан только один способ оплаты.

Проверьте способы оплаты, указанные в модуле.

Чтобы отображались все подключенные Вами способы, необходимо в админке оставить поле "доступные способы оплаты" пустым.

Данные настройки производятся в в админке Битрикс по следующему пути: Магазин/Настройки/ Платежные системы/ Система IntellectMoney.

#004. Вопросы по модулю

Чтобы перейти к настройкам модуля, необходимо в административной части интернет-магазина перейти в раздел Настройки->Магазин->Платёжные системы, где Вы увидите наш модуль. Кликнув "Изменить", Вы сможете настроить модуль.

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

Для доработки логики работы производите изменения в файле tools\result.php

Доработка полей формы отправки производится в файле \install\payment\payment.php

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

#005. Как подключить модуль для битрикс?

-Здравствуйте! Как подключить модуль для битрикс? http://marketplace.1c-bitrix.ru/solutions/im.payment/ Будет ли работать на 1С-Битрикс: Управление сайтом 17.0.15?

-В админке магазина выбираете Marketplace->Каталог решений. В поиске набираете Intellectmoney и нажмите кнопку установить. Модуль работает на версии 17.0.15

#006. Изменение заказа с изменением суммы

Посмотреть состояние счета можно по инструкции "Частые вопросы" > "Как посмотреть оплачен ли счет?".

Изменяем сумму заказа до создания счета в системе IntellectMoney.

Просто измените сумму оплаты.

Изменяем сумму заказа до оплаты счета в IntellectMoney

Добавьте оплату согласно инструкции "Частые вопросы" > "#008. Как добавить оплату?".
Вернитесь на страницу редактирования заказа, в раздел оплаты, и удалите предыдущую оплату.
Переходим в личный кабинет IntellectMoney и отменяем счёт на ту сумму, оплату по которой Вы удалили на шаге 3. Ссылка на отмену счёта.
У пользователя в личном кабинете Вашего магазина, появится кнопка "оплатить" на нужную сумму.

Изменяем частично оплаченный заказ в системе IntellectMoney

Уменьшаем сумму заказа в системе IntellectMoney согласно инструкции Уменьшение суммы СКО так, чтобы сумма к оплате совпала с уже оплаченной.
Выполняем действия из блока "Изменяем сумму заказа до создания счета в IntellectMoney".

Изменяем сумму заказа после оплаты счета в IntellectMoney

Добавьте оплату согласно инструкции "Частые вопросы" > "#008. Как добавить оплату?".
У пользователя в личном кабинете Вашего магазина, появится кнопка "оплатить" на нужную сумму.

#007. Как посмотреть оплачен ли счет?

Открываем админ-страницу модуля, заходим в раздел "Магазин" > "Заказы", нажимаем на номер нужного заказа, как на примере.

Находим блок "Оплата", нажимаем "Развернуть".

В поле "Статус платежной системы" видим "Код статуса".

Если код статуса:

3 - счет создан, но не оплачен;
4 - счет отменен;
5 - счет оплачен;
6 - счет захолдирован;
7 - счет частично оплачен;
8 - оплата возвращена;
Если пусто - счет в системе IntellectMoney ещё не создан.

#008. Как добавить оплату?

Данные для формирования чека в онлайн кассе. Представляет собой JSON - строку. Для корректного отображения названия товара в чеке, параметр text передавать в кодировке UTF-8.Корректно сформировать JSON-строку из массива данных можно функцией языка программирования PHP json_encode. Проверить правильность составления JSON-строки можно воспользовавшись функцией языка программирования PHP json_decode.

Важно: Документы генерируются фискальным накопителем(ФН), данный факт накладывает на кодировку передаваемых строк, обмен сообщениями по http с кассой осуществляется в кодировке UTF-8, но при записи в ФН строки передаются в кодировке CP866, которая поддерживает меньший набор символов чем UTF-8, например: в CP866 отсутствуют символы «» и в ФН они не будут переданы - вместо строки "Сок «Груша»" в документе будет "Сок Груша". Экранирование символов возможно через обратный слэш "\" или функцией addslashes в PHP.

Структура JSON - строки

{
"inn":"7704019762",
"group":"Main",
"content":
	{
		"type":1,
		"customerContact":"foo@example.com", 
		"positions":[
			{
				"quantity":2.000,
				"price":12.45,
				"tax":6,
				"text":"Булка"
			},
			{
				"quantity":1.000,
				"price":5.10,
				"tax":4,
				"text":"Спички",
				"paymentSubjectType": 1,
				"paymentMethodType": 4
			},
			{
				"quantity":1.000,
				"price":53.70,
				"tax":4,
				"text":"Кефир",
				"supplierINN": 3808027390
			}
		],
	}
}

Название	Элемент	Описание
Валидация суммы	skipAmountCheck	Отключить встроенную проверку соответствия сумм позиций чека сумме счета. По умолчанию, если параметр не передан - 0 Может принимать значения 0 или 1
Ваш номер ИНН.	inn	Индивидуальный Номер Налогоплательщика, полученный в Федеральной налоговой службе
Название группы.	group	По умолчанию "Main". Для того что бы выставить в другую группу, нужно создать новую группу в Orange Data. Если передать группу, которой не существует, Orange Data вернет ошибку.
Содержимое документа	content	Наполнение данного поля смотрите в Таблице content.

Таблица content

Название	Элемент	Описание
Тип документа	type	Нужно передать число, согласно действию: Приход Возврат прихода Расход Возврат расхода
Данные покупателя	customerContact	Телефон или Email - покупателя Формат телефона: +ХХХХХХХХХХ
Признак агента	agentType	Необязательное поле. Передается в том случае, если отчет о регистрации и (или) текущий отчет о перерегистрации содержит реквизит «признак агента» (тег 1057), имеющий значение, идентичное значению реквизита «признак агента» (тег 1057) кассового чека. Для типов агентов необходимо передавать следующие значения: банковский платежный агент - agentType = 1 банковский платежный субагент - agentType = 2 платежный агент - agentType = 4 платежный субагент - agentType = 8 поверенный - agentType = 16 комиссионер - agentType = 32 иной агент - agentType = 64 В случае, если продавец имеет несколько признаков агента, например и банковский платежный субагент (agentType = 2), и проверенный (agentType = 16), и иной агент (agentType = 64), тогда значение параметра agentType должно складываться из значений agentType каждого из признаков агента, т.е. для перечисленных в данном примере типов параметр agentType = 2 + 16 + 64 = 82 Может принимать значение от 1 до 127
Список позиций в чеке	positions	Список товаров, за которые производится оплата. Максимальное количество товаров — 170 единиц. Наполнение данного поля смотрите в таблице positions.
Параметры закрытия чека	checkClose	Параметр является обязательным, при использовании API

Таблица positions

Название

Обязательное

Описание

quantity

Да

Количество товара.

Десятичное число с точностью до 3 символов после точки.

price

Да

Цена товара с учётом всех скидок и наценок.

Десятичное число с точностью до двух знаков после точки.

tax

Да

Ставка НДС. Нужно передать число от 1 до 6:

ReceiptVatRateEnum	Числовое представление	Описание
Vat20	1	Ставка НДС 20%
Vat10	2	Ставка НДС 10%
Vat120	3	Ставка НДС расч. 20/120
Vat110	4	Ставка НДС расч. 10/110
Vat0	5	Ставка НДС 0%
None	6	НДС не облагается

text

Да

Описание позиции в чеке (товара).

Строка до 128 байтов.

paymentSubjectType

Нет

Предмет расчета. Нужно передать число от 1 до 13:

ReceiptPaymentSubjectTypeEnum	Числовое представление	Описание
Product	1	Товар
Excisable	2	Подакцизный товар
Job	3	Работа
Service	4	Услуга
GamblingBet	5	Ставка азартной игры
GamblingGain	6	Выигрыш азартной игры
LotteryTicket	7	Лотерейный билет
LotteryWinnings	8	Выигрыш лотереи
Rid	9	Предоставление РИД
Payment	10	Платёж
AgentComission	11	Агентское вознаграждение
Composite	12	Составной предмет расчета
Other	13	Иной предмет расчета

paymentMethodType

Нет

Способ расчета. Нужно передать число от 1 до 7 (Если передано null,
то в предмет расчета будет передано значение 4 - Полный расчет.):

ReceiptPaymentMethodTypeEnum	Числовое представление	Описание
Prepay	1	Предоплата 100%
PartialPrepay	2	Частичная предоплата
Advance	3	Аванс
Full	4	Полный расчёт
PartialAndCredit	5	Частичный расчёт и кредит
CreditTransfer	6	Передача в кредит
CreditPayment	7	Оплата кредита

supplierINN

Нет

ИНН поставщика для позиции из чека

таблица checkClose

Название

Обязательное

Описание

payments

Да

Список платежей, структура представлена в "таблица payments"

taxationSystem

Да

Система налогообложения.

Число от 0 до 5

ReceiptTaxationSystemEnum	Числовое представление	Описание
Common	0	Общая
Simplified	1	Упрощенная доход, УСН доход
SimplifiedMinusOutlay	2	Упрощенная доход минус расход, УСН доход - расход
UnifiedImputedIncome	3	Единый налог на вмененный доход
UnifiedAgricultural	4	Единый сельскохозяйственный налог
Patent	5	Патентная система налогообложения

таблица payments

Название

Обязательное

Описание

type

Да

Тип оплаты.

Число от 1 до 16.

1 – сумма по чеку наличными, 1031

2 – сумма по чеку безналичными, 1081

14 – сумма по чеку предоплатой (зачетом аванса и (или) предыдущих платежей), 1215

15 – сумма по чеку постоплатой (в кредит), 1216

16 – сумма по чеку (БСО) встречным предоставлением, 1217

amount

Да

Сумма оплаты.

Десятичное число с точностью до 2 символов после точки.

Пример кода для вставки в форму

<input type="hidden" value='{"inn":"7704019762","group":"Main","content":{"type":1,"positions":
[{"quantity":2.000,"price":12.45,"tax":6,"text":"Булка"},
{"quantity":1.000,"price":5.10,"tax":4,"text":"Спички","paymentSubjectType": 1,"paymentMethodType": 4,"supplierINN": 3808027390}],
"customerContact":"foo@example.com"}}' name="merchantReceipt">

Пример формирования merchantReceipt на языке PHP

$inputPositions = array(
	array("quantity"=>"1", "price"=>"10", "tax"=>"6", "text"=>"Товар номер 1", "paymentSubjectType" => 1, "paymentMethodType" => 4),
	array("quantity"=>"1", "price"=>"11", "tax"=>"6", "text"=>"Товар номер 2", "supplierINN" => 3808027390),
	array("quantity"=>"1", "price"=>"12", "tax"=>"6", "text"=>"Товар номер 3")
);
function createMerchantReceipt($inputPositions){
        $inn = "Ваш ИИН";
        $customerContact = "test@test.ru";//Почта плательщика

        $positions = array();
        foreach($inputPositions as $position){
            $positions[] = array(
                'quantity' => $position['quantity'],
                'price' => $position['price'],
                'tax' => $position['tax'],
                'text' => $position['text'],
				'paymentSubjectType' => $position['paymentSubjectType'],
				'paymentMethodType' => $position['paymentMethodType'],
				'supplierINN' => $position['supplierINN']
            );
        }

        $merchantReceipt = array(
            "inn" => $inn,
            "group" => "Main",
            "content" => array(
                "type" => "1",
                "positions" => $positions,
                "customerContact" => $customerContact
            )
        );

        return json_encode($merchantReceipt);
}

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

Вопрос

Ответ

В чеке выводится нечитаемое назначение платежа

Параметр merchantReceipt следует передавать в кодировке UTF-8

Недопустимый формат параметра CustomerContact

Параметр CustomerContact - это телефон или Email - покупателя

Формат телефона: +ХХХХХХХХХХ

Например: +79104444444

Находим блок "Оплата", нажимаем "Добавить оплату".

Заполняем поля:

Способ оплаты - "Система IntellectMoney";
Сумма к оплате - нужная сумма;
Остальные поля не нужно заполнять.

Сохраняем данные.

Техническая поддержка осуществляется пн.-пт. с 9:00 до 18:00 по почте ts@intellectmoney.ru

Page tree

1С Битрикс

1C Битрикс

Введение

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

Настройка модуля

Дополнительно

Настройка почтовых уведомлений

Модуль оплаты также позволяет

Изменяем сумму заказа до создания счета в системе IntellectMoney.

Изменяем сумму заказа до оплаты счета в IntellectMoney

Изменяем частично оплаченный заказ в системе IntellectMoney

Изменяем сумму заказа после оплаты счета в IntellectMoney