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

Дистрибьюторы могут загружать остатки продукции, отправляя на электронную почту КЭАЗ табличный документ. Для этого следует выслать на адрес 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 ключ можно скопировать с сайта КЭАЗ, перейдя в раздел «Информация о компании».

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

Формат писем

Тема сообщения: Название метода (например 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

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

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