Сегодня 18:13
Для того, чтобы начать пользоваться сервисом, необходимо войти или зарегистрироваться

Вход

Звонок специалисту
+7 812 309-7026
доб.: 39-90
пн–пт: 8:30–17:00 по Москве

Загрузка остатков через email

Загрузка остатков через email

Дистрибьюторы могут загружать остатки продукции, отправляя на электронную почту КЭАЗ табличный документ. Для этого следует выслать на адрес api@keaz.ru файл с любым названием обязательно в формате csv.

Чтобы система приняла документ, дистрибьютор должен выполнить ряд требований:

Склады - в теме письма пишется warehouses, в теле письма только API ключ. К самому сообщению нужно прикрепить csv-файл.

Файл должен содержать три столбца:
| Адрес | Контакты | Код склада |

Код склада - уникальный идентификатор, отображенный в файле остатков в столбце код склада https://keaz.ru/office/keaz-warehouse-example.xls. Он нужен для того, чтобы определить какой продукт к какому конкретно складу дистрибьютора относится. Указывается любой буквенно-цифровой набор (шифр). Напр.: D4R7WE.

Остатки - в теме письма пишется remains, в теле письма API ключ, прикрепленные файлы с остатками должны быть в формате csv с любыми именами, но в каждом файле должны быть остатки только по 1 складу. Остатки по складу сбрасываются при начале импорта из файла.

После обработки сообщения на email отправителя уходит письмо с отчетом об обработке файлов.

Сам файл должен содержать три столбца:
| Код склада | Артикул | Остаток |

Пример файла доступен по ссылке https://keaz.ru/office/keaz-warehouse-remains-example.xls

API ключ можно скопировать с сайта КЭАЗ, перейдя в раздел «Информация о компании».

API ключ можно обновить, нажав на соответствующую кнопку. Чтобы протестировать функционал следует выставить галочку «Режим разработки». Окончив тестирование, галочку необходимо снять.

Технические детали

Формат писем

Тема сообщения: Название метода (например warehouse)

Тело сообщения: API ключ

Вложения: Файлы в формате csv

Получение API ключа

API ключ выдается на контрагента, право на просмотр и получение ключа имеет пользователь с правами "Администратор дистрибьютора" и "Загрузка остатков"

Отправка отчета об обработке

Отчет формируется на каждое письмо, отправка происходит в том случае если пользовательские данные для авторизации прошли проверку, иначе сайт "молчит"

Обновление складов контрагента

Тема сообщения: warehouses

Логика работы

Проверка валидности пользователя и API ключа в теле сообщения, отправителем может быть только подключенный к контрагенту пользователь с ролью "Загрузка остатков". Для включения данной обратитесь к Вашему менеджеру в Управлении обслуживания покупателей КЭАЗ.

Проверка типа фала, разрешены только csv:

  • text/comma-separated-values,
  • text/csv,
  • application/csv,
  • application/excel,
  • application/vnd.ms-excel,
  • application/vnd.msexcel,
  • text/anytext,
  • application/octet-stream

Проверка количества и именования столбцов.

Обработка строк, если склад с кодом из строки найден, то происходит обновление, иначе добавление. Если после обработки файла остались склады которые есть в базе данных, но их нет в файле, то происходит удаление "лишних" складов из бд.

Обновление остатков на складах контрагентов

Тема письма: remains

Логика работы

Получение списка разрешенной к загрузке продукции.

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

Проверка типа фала, разрешены только csv.

  • text/comma-separated-values,
  • text/csv,
  • application/csv,
  • application/excel,
  • application/vnd.ms-excel,
  • application/vnd.msexcel,
  • text/anytext,
  • application/octet-stream

Проверка количества и именования столбцов.

Разбор строк. Если это первая итерация, то происходит очистка остатков на складах. Добавление продукции происходит только из разрешенных к показу на сайте категорий.