Дистрибьюторы могут загружать остатки продукции, отправляя на электронную почту КЭАЗ табличный документ. Для этого следует выслать на адрес api@keaz.ru файл с любым названием обязательно в формате csv.
Чтобы система приняла документ, дистрибьютор должен выполнить ряд требований:
Склады - в теме письма пишется warehouses, в теле письма только API ключ. К самому сообщению нужно прикрепить csv-файл.
Файл должен содержать три столбца:
| Адрес | Контакты | Код склада |
Код склада - уникальный идентификатор, отображенный в файле остатков в столбце код склада https://keaz.ru/office/keaz-warehouse-example.csv. Он нужен для того, чтобы определить какой продукт к какому конкретно складу дистрибьютора относится. Указывается любой буквенно-цифровой набор (шифр). Напр.: D4R7WE.
Остатки - в теме письма пишется remains, в теле письма API ключ, прикрепленные файлы с остатками должны быть в формате csv с любыми именами, но в каждом файле должны быть остатки только по 1 складу. Остатки по складу сбрасываются при начале импорта из файла.
После обработки сообщения на email отправителя уходит письмо с отчетом об обработке файлов.
Сам файл должен содержать три столбца:
| Код склада | Артикул | Остаток |
Пример файла доступен по ссылке https://keaz.ru/office/keaz-warehouse-remains-example.csv
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
Проверка количества и именования столбцов.
Разбор строк. Если это первая итерация, то происходит очистка остатков на складах. Добавление продукции происходит только из разрешенных к показу на сайте категорий.
