Загрузка и запуск обработки файла с деталями. Один логин = один набор данных (файл с деталями). Использовать несколько разных наборов одновременно нельзя – поиск возможен только по последнему загруженному набору.
Выполняется только, если нет не завершенных ранее загрузок, производимых в настоящий момент.
Загружаемый файл необходимо подготовить по следующим правилам:
Файл может иметь формат txt или CSV, или же быть заархивирован в zip-файл в текстовом формате.
Файл может предоставляться в 2 форматах:
кодировка utf-8, разделитель – запятая, пример источника – LibreOffice;
кодировка utf-16 (BOM), разделитель – табуляция, пример источника – Microsoft Excel с выбранным "Текст Юникод".
Первая строка файла должна содержать заголовок определяющий колонки:
brand – бренд (обязательно);
oem – артикул (обязательно);
original_brand – бренд оригинальной детали (опционально);
original_oem – артикул оригинальной детали (опционально);
одно или несколько наименований из: name_en_US, name_ru_RU, name_de_DE;
vendor_code – код от производителя (опционально);
tags (опционально). Тегом является непрерывная буквенно-цифровая последовательность, начинающаяся с буквы; по сути это некий "ярлычок", за которым может прятаться раздел, узел, назначение или маркетинговая особенность, например, "акция". Пробелы недопустимы – они являются разделителями для тегов. Тегом может являться любая полезная для детали информация.
Если в теле строки (например, в имени) содержится запятая, то для формата CSV должно использоваться квотирование кавычками.
Поле tags должно содержать теги, являющиеся непрерывными буквенно-цифровыми последовательностями, разделенными внутри ячейки пробелами.
Поле vendor_code используется для возможности передачи пользовательских идентификаторов при обработке файла, которые будут возвращаться в поиске в составе поля vendorCodes. Поиск по этим кодам не осуществляется
Поля original_brand и original_oem содержат информацию об оригинальной детали, заменой которой является данная деталь. Будут обработаны только при наличии у пользователя разрешения USE_OFFER_CROSSES (проверить его наличие можно, сделав запрос GET /us2/public/currentUser). С разрешением USE_OFFER_CROSSES кроссы строятся только из полей original_brand и original_oem, иначе – из данных Laximo.DOC. Что бы передать несколько кроссов на оригинальный артикул необходимо добавить несколько строчек в портфолио на каждую строчку свой кросс на оригинал
Клиент может выгрузить из своего бэк-офиса в файл весь свой ассортимент и потом загрузить файл в систему Laximo.Search для последующего полнотекстового поиска с применимостью к автомобилю. Файл может представлять не только одного производителя, но и номенклатурную базу товаров по магазину.
В процессе обработки файл проходит через несколько статусов: queued -> processing -> success с возможной отменой (aborted) и ошибкой (failed).
Параметры запроса
Параметр
Тип
Обязательность
Значение
delimiter
string
-
Разделитель колонок в CSV-файле, указывается символ: , (запятая) или ; (точка с запятой). Если не указывается, применяется стандартный разделитель: для txt-файла – табулятор, для CSV-файла – запятая
charsetName
string
-
Кодировка файла. Поддерживаются UTF-8, UTF-16. Если не указывается, кодировка определяется заголовком файла. Если не определено, по умолчанию – UTF-8