Merlion Commander. Интеграция с 1С:УT 11.5

Расширение позволяет работать с веб-сервисом Мерлион/MerlionCommander 1.3.0.5 прямо из 1С:УТ 11.5, Розница 2.3 

Логика работы  максимально приближена к работе веб-сервиса b2b. Вы сможете  создать и исправить заказ, зарезервировать товар прямо из 1С, посмотреть актуальные остатки и цены, импортировать штрих кода EAN13 товаров, загружать заказ c автоматическим созданием номенклатуры в 1С  и  корректности создания. Можно  выбирать характеристики по товарным группам и загружать товар с выбранными характеристиками, загружать изображения товара.  Не требуется установки дополнительного ПО для работы с веб-сервисом.  Кроссплатформенное решение для  ОС Windows и Linux. Весь код модулей открыт и доступен для просмотра и внесения изменений.

Работа с решением для пользователей 1С

Как подключиться к сервису?

Запросите доступ по адресу api@merlion.ru к тестовому разделу веб-сервиса Мерлион. После получения логина и пароля настройте сервис в «НСИ/Администрирование/Настройка интеграции/ Настройка сервиса Merlion».

Для каждого пользователя программы 1С нужно ввести полученный логин и пароль. Остальные настройки одинаковы для всех пользователей.

Как лучше организовать справочник «Номенклатура»?

Рекомендуем использовать структуру справочника Мерлион. Это очень удобная структура. В настройке сервиса за это отвечают два параметра –«Корневой каталог» и «Использовать структуру каталогов веб-сервиса». В таком случае в корневом каталоге будет полностью сформирована структура, идентичная товарному каталогу Мерлиона. В случае, если Мерлион не является Вашим основным поставщиком или Вы используете свою собственную структуру каталогов, то снимите галочку «Использовать структуру каталогов веб-сервиса». В таком случае все новые товары с веб-сервиса будут попадать в этот каталог. Совершенно не обязательно производить полностью синхронизацию – нужные каталоги будут появляться автоматически по мере поступления товаров.

Как происходит сопоставление товаров в 1С и веб-сервисе?

Сопоставление товара производится по штрих-коду EAN13, парт-номеру производителя. Код товара Мерлиона записывается в регистр штрихкодов и/или в дополнительный реквизит справочника «Номенклатура».  Код Мерлиона, как штрихкод нужен для того, так как часто встречается ситуация, когда у товара есть один и тоже штрихкод EAN13, но в Мерлионе это товары с разными номерами.

Как заказывать товар?

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

Как загружать учтенные документы?

На закладке «Учтенные документы» в списке «Заказы Мерлиона». Введите номер заказа и нажмите кнопку «Заполнить».

Следующая операция – «Сопоставление». В случае если, товары найдены в справочнике, то товар переносится в таблицу. В загрузке использован удобный механизм визуального сравнения товаров из веб-сервиса и номенклатуры. Это сделано для исключения ошибок, когда есть неточности, как в веб-сервисе, так и в 1С по штрих-кодам и артикулам производителям. Например, из веб-сервиса могут импортированы товары с разными кодами, но с одним артикулом производителя. Различие этих товаров лишь в цвете. Такая ситуация может быть разрешена только вручную. Для создание новых товаров требуется нажать кнопку «Создать номенклатуру». Для создания документа «Заказ поставщику» и «Поступление товаров услуг» требуется нажать кнопку «Создать заказ» и  «Создать накладную».

Работа с решением для программистов 1С.

MC_API

Это основной модуль библиотеки доступа к функциям API. В ней описаны большинство функций, причем наименование, входные параметры, значения по умолчанию описаны также, как в документации для API, что позволит легко ориентироваться в библиотеке. Единственным отличием является передача в функцию значения WSПрокси для доступа к веб-сервису. Например, для того, что бы обратится к функции getCatalog(cat_id) производится вызов функции getCatalog(B2B, cat_id="ALL") с установкой значений по умолчанию и передачей параметра B2B. После выполнения функции результат преобразуется в массив структур и ему устанавливается имя, соответствующее имени типов данных в пакете https://api.merlion.com/dl/mlservice3. На наш взгляд это облегчит понимание, что именно получилось в результате работы функции. В нашем случае выходные данные будут иметь имя ArrayOfCatalogResult. Выходные данные записываются в структуру, где дополнительно присутствует код ошибки и описание ошибки. Это позволяет отслеживать ошибки на стадии выполнения и прекращать выполнение обработки.

Технические требования

Протестировано на платформе 1С:Предприятие 8.3.20.1613, типовых конфигурациях:

• 1С:УТ 11.5.7.288
• 1С:Розница 2.3.4.33 
• API Merlion 3.0 редакция веб-сервиса 3.0 от 18.08.2021

Код открыт.

НАЧАЛО РАБОТЫ:

1. Загрузить расширение НСИ/Администрирование/Печатные Формы, отчеты и обработки/Расширения и установить режим "Небезопасный".
2. Загрузить дополнительные обработки в НСИ/Администрирование/Печатные Формы, отчеты и обработки/Дополнительные обработки.
3. Настроить работу сервиса в  НСИ/Администрирование/Настройки Интеграции/Настройка сервиса Merlion. Ввести код клиента, логин и пароль. Нажать кнопку "Тестировать и записать". В случае правильности учетных данных будет получено сообщение об успешном подключении.
4. Выполнить настройки согласно инструкции.

КАК ИСПОЛЬЗОВАТЬ:

1. В качестве готового решения для менеджера по закупкам, бухгалтера.  В поставке реализованы - размещение и изменение заказа, резервирование товара, загрузка заказа из веб-сервиса c автоматическим созданием номенклатуры, создание документа "Заказ поставщику" и "Поступление Товаров", работа с характеристиками товаров.
2. В качестве библиотеки функций. В случае, если бизнес-логика работы Вашего торгового предприятия отличается от предложенной, то можно  написать самостоятельно или адаптировать расширение и дополнительные обработки. Все дополнительные обработки созданы с применением БСП. Наименование функций, параметров указаны в полном соответствии с документацией на API MERLION, что упростит Вам разработку самостоятельных решений.

Быстрый старт

1. Получить специальный логин и пароль от тестовой части веб-сервиса Мерлион. Запрос отправить на api@merlion.ru
2. Загрузить расширение из файла MerlionCommander.cfe в раздел «Печатные Формы, отчеты, Обработки» в подраздел «Расширения» по кнопке «Добавить из файла». Снять «галочку» безопасный режим.  При получении новой версии воспользуйтесь кнопкой «Обновить из файла» и выберите файл расширения.

В случае ошибки проверьте режим совместимости расширения и основной конфигурации.  Режим совместимости в конфигурации и расширения должен совпадать и сейчас значение установлено «8.3.12».

3. Выполните первоначальные настройки сервиса в «НСИ и администрирование /Настройка интеграции/Настройка сервиса Мерлион. Обязательно установите галочку «Тестовый режим работы» при первоначальном тестировании сервиса. Обратите внимание, что переход в «боевой»сервис производится только после создания заказов в тестовом сервисе.

4. Включите использование дополнительного реквизита для хранения кода товара Мерлиона.Добавьте дополнительный реквизит в карточке любой номенклатуры, вызвав «Еще/Изменить состав дополнительных реквизитов» и создав реквизит с любым удобным для Вас именем, например «Код Мерлиона», но обязательно  с типом данных «Строка» и  реквизитом  «Имя», равным «КодМерлиона»в разделе «Для разработчиков».

5. Можно приступать к заказам в Мерлион, используя «Закупки/Заказы Мерлиона».

6. Импорт номенклатуры. Необязательная операция.При работе с заказами номенклатура создается автоматически.

7. Импорт структуры товарного каталога Мерлиона. Необязательная операция. При работе с заказами структура создается автоматически. Требуется исключительно для того, чтобы создать структуру каталогов и  в последствии перенести в нее свои товары

История изменения версий

Остались вопросы?

Для получения дополнительной информации и помощи в настройке модуля под нужды вашего бизнеса — оставьте заявку

Подробнее