1

Часто задаваемые вопросы:

+Какие ограничения имеет тестовая версия разработки?

  1. Тестовый период составляет 14 дней.
  2. Максимальное количество получаемого товара из API дистрибьютора за 1 запрос составляет не более 10 позиций.
  3. При загрузке заказа поставщику из B2B в 1С, загружается не более 10 товарных позиций.

+Что необходимо для запуска обработки?

  1. Нужно иметь доступ к API Merlion, для этого Вам необходимо написать письмо с соответствующим запросом в техподдержку, по адресу api@merlion.ru. Либо связаться с техподдержкой любым другим способом.
  2. Необходим регистрационный ключ для запуска обработки - он становится доступным в личном кабинете на вкладке «Мои заказы» после заказа услуги. Обратите внимание, что ключ будет находится в статусе неактивен до завершения оплаты. После оплаты, ключ будет активирован. Срок окончания активации указывается в таблице заказов. Один ключ может быть использован только для одного IP одновременно. Если у Вас изменился IP - необходимо его обновить в личном кабинете на странице заказов.

+На какой срок предоставляется техподдержка?
Техподдержка предоставляется сроком на 6 месяцев, с возможностью продления.

+Какие минимальные требования по программному обеспечению?
Программный модуль полностью поддерживается платформой 1С 8.3.12 и выше.

Обязательным требованием является работа конфигурации в режиме совместимости «Не использовать» или в режиме не ниже «Совместимость 8.3.12»!

+Работает ли программный модуль на 1С под Linux?
На 1С, работающей под ОС Linux, разработка не тестировалась. Это не исключает ее совместимость при работе в данном формате. Однако, настоятельно рекомендуем, перед приобретением программного решения, сформировать заказ на тестовую разработку и проверить ее работу на своем сервере под своей версией конфигурации 1С.

+С какими режимами работы 1С совместима разработка?
Программный модуль не совместим с режимом запуска через вебклиент. Так же не поддерживаются технологии 1cfresh, scloud и прочие облачные сервисы 1С.

+У меня нетиповая конфигурация (или конфигурация старого релиза). Будет ли работать модуль в моей базе?
Стабильная и корректная работа модуля гарантируется только на типовой конфигурации 1С актуального релиза. Если для ведения учета используется нетиповая конфигурация 1С, либо конфигурация старого релиза, которую по разным причинам обновить невозможно, рекомендуем поступить следующим образом:

  1. Сформировать заказ на бесплатную демо-версию разработки (потребуется регистрация).
  2. Скачать файл разработки из личного кабинета и проверить ее работу на своей конфигурации 1С.
  3. Если проблем в работе не обнаружено - можно приобретать полную версию разработки.

+Можно ли после приобретения разработки, со временем, получить версию для другой конфигурации? (например, сейчас мы используем УТ 11, но планируем перейти на УНФ 1.6)
Для модуля интеграции существует три линейки:

  • УТ 10.3, КА 1.1, УПП 1.3
  • УТ 11, КА 2.х, ERP 2.0
  • УНФ 1.6

Приобретая модуль, например для УТ 11, Вы можете без проблем его использовать для конфигураций версий КА 2.x и ERP 2.x. Однако, при необходимости использования интеграции в конфигурациях других версий, Вам потребуется другой отдельный программный модуль.

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

+Можете сказать хотя бы примерно, какая скорость загрузки данных?
Полный каталог MERLION с ценами и остатками (~80 000 товаров) загружается из API в форму обработки 1C ~30 минут. Дальнейший импорт данных из формы обработки в базу 1С напрямую зависит от производительности вашего сервера и учетной системы 1С в частности.

+Есть ли какие-то ограничения на частоту запроса данных?
Со стороны API Merlion, для того чтобы снизить вероятность перегрузки сервера, введены следующие ограничения:

  • получение каталога товаров: 1 запрос/сек
  • получение данных по товарам: 3 запроса/сек
  • получение характеристик по товару: 3 запроса/сек
  • получение изображений по товару: 3 запроса/сек
  • получение данных по доступным датам отгрузки и дополнительным справочникам: 1 запрос/мин

+На тестовом сервере Merlion загружается не более 10 картинок. Это связано с ограничениями со стороны API Merlion?
Ответ техподдержки API Merlion:

На тесте вывод характеристик и фото искусственно ограничен – выводим TOP 10 (первые 10 строк), для тестирования и отладки запросов этого достаточно.

+Есть ли возможность настройки регламентного задания для обмена данными по расписанию?
Да. В расширении конфигурации Автоматизация работы с дистрибьюторами (ядро) (которое является обязательным при использовании модуля интеграции) есть встроенный функционал для настройки регламентных задач по загрузке складских остатков и цен дистрибьютора.

+Перед загрузкой номенклатуры, устанавливаем флаг «только доступные» – но все равно грузится вся номенклатура. Почему?
Флаг «только доступные» влияет на соответствующий параметр «only_avail» в запросе к API (см. выдержку из описания API). Результаты выдачи данных при этом никак не обрабатываются и отображаются в том виде, в котором вернуло API дистрибьютора.

+Не подскажете почему может быть ошибка? (...Поле объекта не обнаружено (НомерПоДаннымПоставщика))
Данная ошибка может появляться в конфигурациях линейки УТ 10.3, КА 1.1, УПП 1.3, при попытке выгрузить заказ поставщику. Связана она с отсутствием данного реквизита в конфигурации, в документе «Заказ поставщику». Однако, не во всех версиях конфигураций данный реквизит отсутствует, дело в том, что на протяжении времени разработчики его то добавляли, то удаляли из типовой поставки конфигурации. Поэтому, если при выгрузке заказа поставщику, у Вас появилась подобная ошибка, Вы можете либо самостоятельно, через конфигуратор, добавить реквизит «НомерПоДаннымПоставщика» (тип «строка», длина от 50 символов) в документ «Заказ поставщику». Либо обратиться за помощью к разработчику программного модуля. Эта процедура займет не более 10 мин и проводится бесплатно.

+При выгрузке заказа в B2B-кабинет, выдается сообщение: «Не удалось зарезервировать товар: Планшет Asus ZenPad Z300CNL-6A043A Atom Z3560. Код команды: 141 408 372». В чем может быть причина?
Данное предупреждение появляется, когда API поставщика возвращает ошибку резервирования. Обычно (но не всегда) в данной ситуации API возвращает так же расшифровку ошибки. Однако, если из сообщения непонятна причина, тогда необходимо обращаться в техподдержку MERLION с просьбой разобраться в ситуации, сообщив при этом "код команды".

+Каким образом происходит сопоставление номенклатуры MERLION с номенклатурой 1С?
Вариантов сопоставлений несколько:

  1. Артикул MERLION - артикул номенклатуры 1C
  2. Артикул MERLION - код номенклатуры 1C
  3. Артикул MERLION - артикул номенклатуры поставщика 1C
  4. Артикул MERLION - идентификатор номенклатуры поставщика 1C
  5. Партномер MERLION - артикул номенклатуры 1C

Если ни по одному из вариантов сопоставления номенклатура не найдена, можно сопоставить товар вручную.

+Какие поля обновляются в карточке номенклатуры при установке флага «обновить номенклатуру» на вкладке «Номенклатура»?
Для разных типов конфигураций список обновляемых реквизитов отличается:

  • Для конфигураций УТ 10.3, КА 1.1, УПП 1.3 это поля: «Наименование, Полное наименование, Родитель (каталог номенклатуры 1С), Вес, Объем»
  • Для конфигураций УТ 11, КА 2.x, ERP 2.x это поля: «Наименование, Полное наименование, Родитель (каталог номенклатуры 1С), Вес, Объем, Вид номенклатуры(если заполнено), Производитель, Марка, Ставка НДС»
  • Для конфигурации УНФ 1.6 это поля: «Наименование, Полное наименование, Родитель (каталог номенклатуры 1С), Категория номенклатуры(если заполнено)»

Поля «Код» и «Артикул» не изменяются!

+При загрузке номенклатуры, появляется ошибка «Значение поля «Рабочее наименование» не уникально»
Ошибка не связана непосредственно с работой модуля интеграции. Говорит она о том, что Вы пытаетесь загрузить позицию, в которой «Рабочее наименование» совпадает с уже существующим элементом в базе 1С. Данная проверка связана с включенной настройкой «Контроль уникальности рабочего наименования» в Вашей конфигурации. Отключите ее и ошибка пропадет. Либо в списке номенклатуры нужно найти совпадающее наименование товара и изменить его, либо исключить из загрузки.

+Как выгрузить заказ поставщику из 1С в B2B MERLION?
Для выгрузки заказа поставщику в B2B дистрибьютора необходимо:

Сформировать заказ поставщику в 1С на контрагента, который указан в качестве «контрагента» в обработке на вкладке «Настройки». В заказ должен быть добавлен только тот товар, который был импортирован от поставщика, в противном случае, обработка его не выгрузит через API.

  1. Провести заказ поставщику.
  2. В обработке на вкладке «Заказы» выбрать временной интервал, за который необходимо отобрать заказы. Либо не указывать даты - тогда в форму выгрузятся все заказы по данному поставщику.
  3. Отметить заказы для выгрузки и отправить в B2B дистрибьютора.

При передачи заказа в B2B поставщика, используются следующие параметры (вкладка «Доп.справочники»):

  • дата отгрузки (обязательный);
  • метод отгрузки (обязательный);
  • тип упаковки;
  • доставка;
  • агент по доставке;
  • контрагент (из списка на вкладке "Доп.справочники"!);
  • представитель.

+Какие параметры передаются в заказ поставщику 1С, при его создании на основании заказа из B2B?
При создании/обновлении заказа поставщику в 1С, из формы модуля интеграции передаются следующие параметры:

  • Контрагент (вкладка Настройки)
  • Организация (вкладка Номенклатура => Настройки по умолчанию)
  • Склад (вкладка Номенклатура => Настройки по умолчанию)
  • Ставка НДС (вкладка Номенклатура => Настройки по умолчанию (только для УТ 11, КА 2.x, ERP 2.x))
  • Каталог номенклатуры 1С и Вид номенклатуры 1С для каждой товарной позиции в выбранном заказе: обязательные поля при создании новой номенклатуры в справочнике 1С.
  • Артикул поставщика
  • Количество товара в заказе
  • Цена

Отсутствующая в базе номенклатура создается автоматически.

Остальные поля в заказе поставщику заполняются по умолчанию, на основании настроек учетной системы.

Внимание! Разработчик не гарантирует, что все второстепенные поля в заказе поставщику будут заполняться корректно. Пользователю, в любом случае, будет необходимо проверить корректность заполнения документа перед его проведением.

+Как получить программный модуль?
Для этого необходимо:

  1. Зарегистрироваться на сайте.
  2. Оформить заказ услуги, указав при этом: сервис(наименование услуг), версию Вашей конфигурации 1С, тип услуги (покупка/аренда), IP (его можно позже изменить).
  3. Оплатить услугу посредством платежной системы.
  4. После этого, в личном кабинете в таблице заказов появится ссылка на разработку.

2

Инструкция по первому запуску:

1. Проверить режим совместимости конфигурации. Если установлен режим ниже «Совместимость 8.3.12», тогда установить режим совместимости «Не использовать» или «Совместимость 8.3.12».

В случае необходимости внесения изменений в конфигурацию, крайне рекомендуется предварительно сделать копию базы данных! За неправильное самостоятельное обновление конфигурации силами клиента, разработчик ответственности не несет!

2. Обработка запускается в режиме 1С:Предприятия, через «Файл-Открыть» Перед началом работы с данными дистрибьютора, необходимо ввести настройки подключения к API (данные предоставляются техподдержкой MERLION).

На вкладке «Настройки» должны быть заполнены следующие поля:

  • Сервер: https://api.merlion.com/rl/mlservice3?wsdl
  • Пользователь: *Ваш логин в API MERLION* (например: BRT12345|API). Обратите внимание, что в конце логина должно быть обязательно добавлено «|API»
  • Пароль: *Ваш пароль в API MERLION*
  • Контрагент: *Контрагент «Мерлион», который должен быть заведен предварительно в справочнике Контрагенты
  • Ключ: ключ, полученный в личном кабинете.

После ввода настроек можно приступать к работе.

Несколько советов:

  1. После открытия обработки и перед началом работы с товарами и заказами, ВСЕГДА нужно предварительно указывать текущую «Дату отгрузки» (вкладка «Доп.справочники»). По этому параметру система MERLION отбирает остатки и цены на указанную дату.
  2. Не пытайтесь загружать сразу очень много позиций товара. В API существует ограничение на «количество запросов в секунду», поэтому большой объем данных может грузиться очень продолжительное время.