Инструкция по работе с модулем «Обмен данными СберМегаМаркет и 1С»
Оглавление
Инструкция по работе с модулем «Обмен данными СберМегаМаркет и 1С». 1
Инструкция для версии 6.2.77. 3
1. Параметры подключения. 3
2. Настройки обмена заказами. 5
«Основные настройки». 6
«Отмены со стороны СММ». 7
«Доставка». 8
«Бонусы». 8
«Настройки схем работы». 8
3. Добавить соответствия товаров СММ... 9
Стандартное. 10
Excel 11
4. Параметры выгрузки YML. 11
Список параметров: 12
Пример расположения файлов используя iis: 12
Пример для Apache: 12
Обновление YML. 12
5. Дополнительные настройки. 13
Цветовая гамма списка заказов: 14
Отмечать в рабочем месте СММ, отменённые скомплектованные заказы.. 15
Список маркетплейсов. 16
Доп. настройки маркировочного листа. 16
Дополнительная аналитика бонусной программы.. 16
Склад. 16
Данные клиента. 17
Настройки для реестра. 17
6. Настройки выгрузки остатков по api 17
7. Рабочий интерфейс «Обработка заказов». 18
8. Склад. 23
9. Финансы.. 23
10. Автоматизация сборки и комплектации. 25
Печать подборочного листа. 26
11. Настройки для работы схемы «Закажи и Забери». 31
11.1. «Пункты выдачи заказов». 31
11.2. «Json файлы». 33
11.3. Рабочее место «Обработки заказов» Закажи и Забери. 34
11.4. Интеграционное тестирование. 37
Идеальный заказ. 37
Частичный выкуп. 39
Отказ от исполнения заказа на этапе комплектации. 39
Полный отказ покупателя на выдаче. 40
12. Доставка силами мерчанта. 40
Комплектация. 41
Выдача. 41
Отменить. 41
Отказ от всего заказа. 41
Отменить(СР)/ срок резерва истек. 41
Частичный выкуп. 41
Инструкция для версии 6.2.77.
После установки расширения на панели разделов появится раздел «СберМегаМаркет» (далее СММ).
Сначала необходимо заполнить настройки.
1. Параметры подключения
Сначала необходимо заполнить «Параметры подключения».
Код менчарта (id личного кабинета) и Token (авторизационный токен), можно получить в настройках на сайте СММ.
URL для запросов на данный период времени (06102021) такой: «https://partner.sbermegamarket.ru/api/market/v1/orderService/».
Так же необходимо добавить магазин. Его можно назвать как угодно, но многие называют так, как именно называется магазин на СММ.
Префикс обмена необходим, если у Вас нумерация заказов идет на латинице. Если нет, то заполнять нет необходимости. Если префикс обмена заполнен, то соответствие заказов в базе и в личном кабинете менчарта (далее ЛКМ) будет такое: Номер = Номер, а префикс в ЛКМ будет «ПрефиксОбмена» +2 цифры года. А в 1С будет всё как обычно. ВАЖНО!!! На СММ нет периодичности 1 год, как в 1с, уникальность номера должна быть не зависимо от года. Если префикс обмена не используется, то обязательно в начале года необходимо поменять префикс базы данных. Пример: в прошлом году заказ XX-01, и в этом году XX-01. Необходимо, чтобы заказ в этом году уже был XY-01. Обязательно латиницей.
Пример:
1С:
ЛКМ:
2. Настройки обмена заказами
Вторым шагом необходимо указать с какими реквизитами будет создаваться заказ покупателя.
Есть 4 вкладки:
«Основные настройки».
1. "Использовать" - если галка не поставлена, то любые post запросы с сервера гудс будут игнорироваться;
2. "Дата начала обмена" - с какого периода будет система будет отвечать на Post запросы goods;
3. "Организация" - Какая организация, будет подставлена в документе "Заказ покупателя";
4. "Склад" - Какой склад, будет подставлен в документе "Заказ покупателя";
5. "Соглашение" - Какое соглашение, будет подставлено в документе "Заказ покупателя". Если соглашения не используются – ставим соответствующую галку и заполняем поля ниже.
6. Автоматическое подтверждение заказа при наличии остатка.
7. Автоматически отправлять одно место комплектации – эту галку можно установить, если каждый заказ отгружается одним грузовым местом. Если галка установлена, то после подтверждения заказ автоматически переводится в статус «Комплектация» и отправляет информацию о количестве мест в СММ.
8. Создавать реализацию после отгрузки – если галка установлена, то по кнопке «Отгрузить» из рабочего места создается документ «Реализация товаров и услуг»
9. Создавать реализацию сразу, если доступен остаток – если галка установлена, то после подтверждения заказа сразу создается реализация
10. Использовать МЛ (маркировочный лист) после сохранения
11. Использовать характеристики – если используются в базе характеристики, то необходимо включить эту опцию
«Отмены со стороны СММ»
«Доставка»
«Бонусы»
«Настройки схем работы»
Эта настройка влияет на отображение панели в РМ «Обработка заказов». Стандартная схема API это «Витрина + доставка».
3. Добавить соответствия товаров СММ
Есть 2 вкладки: «Стандартное» и «Excel»
Стандартное
1. «Только создать дополнительные реквизиты» - создаёт в базе дополнительные реквизиты «IDGoods» и «SearchGoods», если в настройках не указана галочка «Использовать характеристики». Если она указана, то создает дополнительные реквизиты «IDGoodsCH» и «SearchGoodsCH».
2. «Создать и заполнить дополнительный реквизит» - проходит по всем номенклатурам/характеристикам и проставляет указанное значение.
Запросом получает весь список номенклатуры и присваивает дополнительному реквизиту "SearchGoods" значение, указанное в поле поиска. Доступны 2 значения "Артикул" или "Код".
Для чего это нужно: если уже используется маркетплейс, и Вы использовали артикул или код для сопоставления товаров, то дальнейший обмен автоматически присвоит дополнительному реквизиту "IDGoods" конкретное уникальное значение с сайта СММ.
При получении первого заказа с маркетплейса система ищет сначала по IDGoods, а если не находит, то по "SearchGoods"(код товара продавца).
Excel
Необходимо указать колонки, в которых содержатся данные: поле поиска номенклатуры в базе (Колонка поиска артикул/код) и колонки, которые необходимо загрузить. Если есть только SearchGoods, код поставщика, то можно заполнить только его или заполнить сразу goods id.
Нажимаем «Загрузить из excel», заполняется табличная часть внизу, там можете проверить ещё раз все ли корректно загрузилось из excel. Есть всё хорошо, то нажимаете «Заполнить», система проходит каждую карточку и записывает данные.
4. Параметры выгрузки YML
В выгрузке YML есть возможность выгружать несколько файлов, когда есть необходимость выгружать для нескольких магазинов на площадке, например. Идентификация записи по 2ум параметрам магазин и расположение файла.
Список параметров:
1. Магазин - обязателен
2. Активность
3. Организация - обязателен
4. Группы номенклатуры для выгрузки
5. Вид цены - обязателен
6. Остаток по складам - обязателен
7. Только с остатком
8. Расположение файла выгрузки - обязателен
9. Локальная папка с картинками
10. Адрес картинок в глобальной сети
11. Поле для выгрузки offerId - если не заполнен, то выгрузка по коду
12. Отгрузка после – если не заполнен, то отгрузка после 16
13. Тип фильтра (для брендов/производителей)
14. Фильтр брендов
15. Коэффициент остатков – данная настройка нужна в основном для РИБ, чтобы весь остаток делить на 2 магазина. Если 1 база эту настройку не нужно заполнять.
16. Цена от
17. Цена до
18. Количество от
19. Количество до
20. Список исключений из дополнительных фильтров
Пример расположения файлов используя iis:
Пример для Apache:
Обновление YML
Для того, чтобы файл YML постоянно обновлялся, необходимо внешнюю обработку добавить во внешние печатные формы и обработки и там настроить расписание.
Внешнюю обработку можно скачать бесплатно, там же где и публикация, так же она присутствует в расширении, где её нужно сохранить и добавить во внешние:
Если все верно указано, то по прямой ссылке, если нет перенаправление портов (Если есть, то необходимо указать порт, порт можно узнать у ИТ специалиста Вашей компании), Вы получите готовые yml:
Данную ссылку необходимо указать на сайте СММ в разделе магазины:
5. Дополнительные настройки
Вкладки:
Цветовая гамма списка заказов:
Включить подсветку в списке заказов – функциональная опция, которая в типовом списке заказов подсвечивает заказы в определённом статусе
Отмечать в рабочем месте СММ, отменённые скомплектованные заказы
Отмечает в списке заказов красным цветом, заказы, которые отменились, когда были на комплектации.
Список маркетплейсов
Только для ордерной схемы, чтобы настраивать там отборы, в рабочем месте отгрузки.
Доп. настройки маркировочного листа
Настройка для того, чтобы если не получаете маркировку по api, то тут указывается шаблон для печати своей.
Дополнительная аналитика бонусной программы
Создаёт дополнительный заказ на сумму бонусов с данными реквизитами.
Склад
Работа с виртуальным складом:
Если были остатки на виртуальном складе и произошли продажи по той номенклатуре, которой не было, это выведется в печатную форму, что необходимо закупить.
Автоматизация сборки и отгрузки
Об этом ниже пункт.
Данные клиента
Добавляет в дополнительные сведения данные о клиенте ФИО и адрес.
Настройки для реестра
Параметры, которые будут выводится в реестре отгрузки.
6. Настройки выгрузки остатков по api
Указываем параметры и выгружаем. Только необходимо сообщить поддержке СММ, что Вы начали работать по данной схеме.
Чтобы остатки по api отправлялись самостоятельно, необходимо добавить дополнительную обработку в дополнительные печатные формы и обработки и настроить регламент. Обработка так же содержится в поставке, если нет возможности её сохранить из конфигуратора, то можете так же скачать из публикации и добавить её.
7. Рабочий интерфейс «Обработка заказов»
В обработке заказов присутствуют отборы: Статус, Магазин и Период.
Заказы, которые поступают из СММ, отображаются в данном рабочем месте. Тут мы можем подтвердить, скомплектовать (если нужно больше 1 места), если отправляем только одно место, то для этого создана кнопка «Одно место». Можно подобрать несколько грузовых мест, нужно нажать на «Комплектацию».
Если используется сканер в форме, то он обнулит колонку "Количество на грузовое место" и каждое сканирование будет добавляться единица товара в нужной строке. Т.е. если заказали 6 штук, то необходимо будет просканировать товар 6 раз. Если сканируется товар, которого нет в заказе будет уведомление, что товар не найдет. Так же добавлена защита, что нельзя отправить информацию в СММ отправки больше количества товара, чем в заказе.
После чего отгружаем. Можно отправлять группой.
Все статусы можно контролировать в ЛКМ:
При каждом нажатии на кнопку, если всё корректно, внизу появляется оповещение:
Кнопки:
«Печать РО»
- печать реестра отгрузки
«Папка с рукой»
- получает маркировочный лист по api и выводит его на печать в 1С
«Дискетка»
- сохраняет полученный по api маркировочный лист в папку, которую укажете, после чего можно его открыть. Если указана настройка в настройках заказа «Открывать МЛ после сохранения», то файл сразу открывается в браузере, где его можно распечатать.
«Таблица с крестиком»
- разукомплектовывает отмененные заказы.
«Принтер»»
- печатает маркировку по данным из базы, необходимо сначала нарисовать макет. Так же его можно выгрузить из конфигурации,
используя обработку
там присутствуют примеры 100/150, 100/100 и 90/140.
8. Склад
На данный момент присутствуют 2 кнопки, ячейки выдачи, для автоматизации сборки и отгрузки и печать товаров для закупки, которая выводит на печать товары для закупки. Это те товары, которые ушли в минус по виртуальному складу. Т.е. в выгрузке yml указали виртуальный склад, а списание произошло по основному, так как заказ на основной склад.
9. Финансы
Для того, чтобы сформировать финансовый отчет, необходимо загрузить excel с финансами, который предоставляет СММ. И на основании данных, которые загрузились в базу, можно создать автоматически поступление безналичных денежных средств.
Загружаемые данные хранятся в регистре сведений «Goods финансовый отчет», т.е. финансовый отчет можно формировать за любой период.
10. Автоматизация сборки и комплектации
После включения функциональной опции работы со «Сборкой и комплектацией», в дополнительных настройках, появляется рабочее место «Сборка и комплектация» в РМ «Обработки заказов».
Перед началом работы с данной опцией необходимо заполнить справочник «Ячейки выдачи» (в разделе «Склад»).
В ячейках указывается наименование ячейки, штрихкод и активность.
Также необходимо создать дополнительный реквизит в номенклатуре, который может использоваться как информация о ячейке хранения товара на складе. Для этого переходим в настройки, вкладка «Склад» и нажимаем кнопку «Создать необходимые дополнительные реквизиты сборки и отгрузки».
Печать подборочного листа.
Сборщик печатает «Лист подбора». Те заказы, которые отмечены, получают статус «На сборке» и им присваивается ячейка выдачи заказа. Если ячеек не хватает, то выйдет сообщение, что нужно отменить меньшее количество заказов, чтобы им присвоить ячейки.
Ячейка хранения указывается в номенклатуре. Это дополнительный реквизит, и он никак не пересекается с типовым функционалом ячеистого хранения.
Сборщик идет на склад и собирает в тележку все позиции. После сборщик подходит к рабочему месту и нажимает на кнопку «Разложить заказы по ячейкам». Открывается форма «РМ Сборщика». В форму попадают только те заказы, которые в статусе «На сборке» и у которых есть присвоенная ячейка выдачи.
Сборщик сканирует каждую номенклатуру и кладет на полку для выдачи. После каждого сканирования позиции, необходимо отсканировать ячейку (штрихкоды на ячейки соответственно должны быть распечатаны). Так же можно указать руками количество. Как только, какой-то заказ закончен, то появляется уведомление внизу и строка подсвечивается зелёным.
Информация не для пользователя! На скрытой вкладке можно указать «Не сканировать ячейку»:
При каждом сканировании или изменении руками количества наверху появляется оповещение о действии:
Можно раскладывать все заказы, либо, как только первый появился на комплектацию, сразу его отправить. Данная строка удаляется из списка и у заказа меняется статус на «На полке».
После комплектовщик нажимает на кнопку «Комплектация готовых заказов».
И у него открывается форма «Сборки и отгрузки», в шапке отображается первый заказ, у которого статус «На полке». Для того, чтобы начать сканировать номенклатуру нужно отсканировать ячейку. Комплектовщик сканирует либо может указать руками количество в коробке.
В форме можно указать количество грузовых мест, если из данной формы необходимо отправить информацию в СММ. На первой кнопке «Отправить информацию в СММ(скомплектован), распечатать маркировку и отправить на паллет». Кнопка отправляет количество грузовых мест в СММ со статусом «Комплектация» и сразу открывает форму печати этикетки и присваивает данному заказу статус «Упакован». После комплектовщик клеит маркировку на коробку(и), и кладет на паллет, чтобы потом передать его сотруднику СММ.
Весь бизнес- процесс пройден.
11. Настройки для работы схемы «Закажи и Забери»
API стандартной схемы и схемы «закажи и забери» отличаются, для «закажи и забери» кроме основных настроек, необходимо ещё заполнить пункты выдачи и json файлы объектов и остатков.
11.1. «Пункты выдачи заказов»
Все настройки выполнены согласно требованиям СММ. Дополнительная информация по ссылке:
https://conf.goods.ru/api-click-and-collect/3-opisanie-api-zakayoi-i-zaberi/5-opisanie-fida-s-ob-ektami
Все настройки обязательны для заполнения, подробности по ссылке, которую указывал выше.
Есть кнопка «Заполнить стандартно», которая добавляет режимы работы и выходные автоматом.
11.2. «Json файлы»
Выгрузка идет на ftp-сервер, к которому потом подключается СММ и оттуда скачивает данные файлы. Настройки ftp для объектов и для цен, остатков можно выбрать разные.
11.3. Рабочее место «Обработки заказов» Закажи и Забери
При включении в настройках обмена заказами режима работы «Закажи и Забери» (C&С), в РМ обработки заказов появляется:
Если включен только 1 режим, то РМ выглядит так:
1. Группа «Комплектация».
1.1.«Комплектация» - сообщаем в СММ, что скомплектовали заказ.
1.2.«Частичная» - открывается форма частичной комплектации, картинка ниже. Мы подтверждаем готовность части заказа к выдаче покупателю в магазине и передает эту информацию в СММ и сообщает о невозможности скомплектовать оставшуюся часть заказа.
2. Группа «Отменить»
2.1. «Отменить» - отменяем заказ по нашей причине, нет остатка или ещё что-то.
2.2. «Частичная» - отменяем некоторые позиции, которых не оказалось на складе по какой-то причине.
3. «Отменить (СР)» – отменяем заказ, так как срок резерва кончился, и покупатель не явился за ним.
4. Группа «Выдача»
4.1. «Выдача» - закрываем заказ в СММ с данным статусом
4.2.«Частичная» - покупатель отказался от каких-то товаров, когда пришёл.
4.3.«Полный отказ» - покупатель полностью отказался от товара.
Ниже пример, когда забрал 1 позицию из заказанных 2ух. В одном ставим отменён статус, в другом отгружен. Так же для документа заказ клиента указываем причину отмены. Так как в заказе клиента эта строка делится на 2, где одна отменена, а вторая остается. Нажимаем кнопку «Изменить заказ и отправить информацию в СММ».
Как выглядит сам заказ в 1с:
В рабочем месте появляются колонки, которые заполняется автоматически по данным из СММ:
1. Дата истечения срока резерва
2. Номер доставки СММ
3. Пункт выдачи
Дополнительная информация в списке заказов
11.4. Интеграционное тестирование
Идеальный заказ
Клиент заказал товар
в ЛКМ мерчанта он отобразился:
После по api передался в нашу систему 1С.
Если товара хватает, и мы его скомплектовали, нажимаем на кнопку «Комплектация» и информация отправляемся в СММ. Внизу появляется уведомление, что запрос успешно отправлен.
В ЛКМ присвоился номер заказа и поменялось состояние:
Как пришел покупатель и никаких вопросов у него нет, то нажимаем выдача заказа:
статус у заказа в 1с поменялся на
В ЛКМ на «отгружен продавцом»
С программной лояльности:
Частичный выкуп
Поступил заказ, всё как выше описано, скомплектовали, но покупатель пришел и захотел взять 1 позицию вместо 2ух.
Нажимаем на кнопку «Частичный выкуп»:
Открывается форма, где мы указываем, что забирает покупатель, а от чего отказывается.
И нажимаем на «Изменить заказ и отправить информацию в СММ»
В 1С:
В ЛКМ:
Отказ от исполнения заказа на этапе комплектации
Кнопка «отменить» и статус меняется на отменить.
В ЛКМ:
Полный отказ покупателя на выдаче
12. Доставка силами мерчанта
Для работы с данной схемой, необходимо указать схему в настройках.
После этого в РМ Обработки заказов появится рабочее поле «Доставка силами мерчанта».
Комплектация
Мы сообщаем СММ, что у нас заказ скомплектован и мы готовы доставлять.
Выдача
Мы сообщаем СММ, что мы выдали заказ
Отменить
Отменяем со своей стороны, так как товара нет или другая причина
Отказ от всего заказа
Мы сообщаем СММ, что клиент отказался от заказа
Отменить(СР)/ срок резерва истек
Мы сообщаем СММ, что срок резерва истек.
Частичный выкуп
Частичный выкуп – клиент забрал не весь заказ. Ниже пример, когда забрал 1 позицию из заказанных 2ух. В одном ставим отменён статус, в другом отгружен. Так же для документа заказ клиента указываем причину отмены. Так как в заказе клиента эта строка делится на 2, где одна отменена, а вторая остается. Нажимаем кнопку «Изменить заказ и отправить информацию в СММ».