Наша система “Chiphunt” выдвигает определенные технические требования к формату и заполнению прайс -листов, которые партнер загружает на сайт в личном кабинете в формате CSV и txt. В данной инструкции будут подробно описаны требования по формированию, оформлению и загрузке прайс-листов на портал.

     1. Структура и заполнение прайс-листа.

Создание и редактирование прайс-листа в формате CSV может происходить в следущих программах:
- MS Excel;
- Open Office;
- 1C (выгрузка);
- Текстовые редакторы (в т.ч. простой системный блокнот);
- Другие программы, поддерживающие формат CSV.

В данной справке мы рассмотрим формирование прайс-листа в программе Excel (2007-2010) .
     Относительно Exсel мы будем говорить о столбцах, в текстовом редакторе же, данные в строке должны быть разделены табуляцией. Стоит особенно подчеркнуть, что наша система принимает в качестве разделителя только табуляцию и точку с запятой (;). Запятые и другие варианты разделения системой приняты к обработке не будут или будут отображаться на сайте не корректно. Предпочтительнее для корректного отображения информации выбирать разделитель – табуляция.
     Ниже представлен рисунок с заполненными графами и с добавлением шапки с подписями столбцов исключительно для ознакомления. В настоящем прайс-листе шапки не в коем случае не должно быть!

     Итак в первом столбце должен содержаться партномер компонента. Заполнение всех полей достаточно важно для большей результативности поиска по вашему складу (прайс-листу), но можно сказать что парт номер является основным столбцом, подлежащим к заполнению. По партномеру и производится поиск компонента на сайте.  Так же если есть ошибка в партномере, соответственно данный компонент найден не будет, так что данный столбец стоит заполнять с наибольшей внимательностью.
     Следующий столбец «Производитель» - в нем содержится наименование производителя компонента.
     Столбец «Описание» - краткое описание электронного компонента. Оно служит для того чтобы в результатах поиска клиент мог понять что за электронный компонент был найден. Часто описание совпадает с названием номенклатурной группы. К примеру «Модули подачи электропитания переменного тока INLET FUSED», либо возможно такое описание конкретного компонента «Блок питания для DIN-рейки PWR SUPPLY PCON 2060-24».
     Столбец «Ссылка на документацию в формате PDF» - ссылка на документацию электронного компонента в формате PDF.
     Столбец «Ссылка на позицию в каталоге на сайте компании или на изображение» - при создании или редактировании прайс листа вы можете поместить в данный столбец как ссылку на данный элемент (партномер) в каталоге на сайте компании, так и ссылку на изображение. Если вы вставили в данное поле ссылку на изображение, то при нажатии на пратномер в результатах поиска изображение будет открыто отдельно в новой вкладке. Если в данном поле будет находится ссылка на позицию в каталоге на сайте компании, то клиент сможет перейти и посмотреть подробное описание запрашиваемого элемента на вашем сайте. В основном компании размещают в данном столбце ссылку на позицию в каталоге на сайте, особенно часто это встречается когда поставщики при подключении склада исползуют скрипт (т.е. сервер, а не прайс-лист). 
     Столбец «Сток» – информация о количестве компонентов на складе и сроке доставки компонентов клиенту.  В данном столбце приводится объем остатка компонентов на складе, например «3000 шт.», и сроки доставки компонентов клиенту, в случае оформления заказа при нехватке имеющихся на складе объемов, например «2-3 недели».  При указании количества товара на складе, кроме цифры необходимо пояснить в чем измеряется количество товара, обычно это штуки «шт.». Таким образом, в данном столбце могут быть представлены данные в следующем виде: «3000 шт., 1-2 недели»; «2 недели»; «3000 шт.»; «2-3 недели» и другие схожие вариации.
     Далее идут 3 столбца «Розница», «Мелкий опт» и «Опт», которые должны содержать цену компонента соответственно для розницы, мелкого и крупного опта. Поле должно содержать только положительное число, к примеру «300».
     Следующий столбец «Наличие» (instock) – поле информирует клиента о наличии компонента на складе. Допускается содержание в поле только двух значений – «1» и «0». 1 – компонент в наличии; 0 –компонент отсутствует на складе.
     И последний столбец «Валюта» - определяет валюту в которой были указаны цены. В данном поле допускаются значения: «RUB», «USD», «EUR» заглавными буквами без кавычек. Заполнение этого столбца обязательно для корректного отображения цен в результатах поиска и правильного информирования клиентов в итоге.

     Чем больше полей заполнено тем выше будет ваш склад в результатах поиска. Но заполнение абсолютно всех полей, при недостатке у вас информации, не обязательно. Система все равно обработает данный прайс лист и представит результаты в поиске.

В итоге прайс-лист должен выглядеть примерно таким образом:

     Как мы видим, у первого компонента заполнены данные о ценах на розницу, мелкий и крупный опт, в то время как у других компонентов эти поля пусты. 
     Границы столбцов не обязательны, это не влияет на распознавание прайс-листа. Следует обратить внимание на экспорт прайс-листа из программы Excel в формат CSV и txt.
Шапка, которая была в примере заполнения прайс-листа, приведенного выше, здесь отсутствует! Как и в любом прайс-листе!

      Для сохранения документа в формате txt необходимо перейти в "Файл" - "Сохранить как" и в поле "Тим файла" выбрать "Текстовые файлы (с разделителями табуляции) (.txt)".

      Чтобы сохранить документ в формате CSV (в программе Excel) следует нажать на раздел «Файл» на верхней панели и нажать кнопку «Сохранить как». В появившемся окне необходимо нажать на раскрывающееся меню «Тип файла» в нижней части окошка и выбрать формат CSV (MS-DOS).

В текстовом виде файл CSV с прайс-листом может выглядеть следующим образом (разделитель - табуляция):

Либо таким образом (разделитель – точка с запятой):

На рисунках выше представлены только фрагменты текстовых файлов в качестве примера.

    

     2. Загрузка прайс-листа на сайт «ChipHunt.ru»

     В разделе управление складами для каждого склада своей компании вы можете загрузить прайс-лит, содержащий нужное количество партномеров, не превышающее 100 000. Если количество партномеров превысило 100 000, которое входит в любой тариф онлайн склада, то цена за каждые 1000 партномеровсвыше лимита будет зависит от выбранного тарифа. Сумма за превышение будет выводиться при загрузке прайса, эта сумма будет включаться в стоимость текущего тарифа (основная стоимость тарифа + превышение). Другими словами стоимость превышения будет списываться каждый месяц, так же, как и стоимость размещения самого онлайн-склада (основной тариф).

При загрузке более 500 000 позиций необходимо обратиться к администрации сайта.

     Для того чтобы загрузить прайс-лист, необходимо нажать на переключатель «Использовать загруженный прайс-лист», после чего появится панель загрузки прайс листа. Затем нужно выбрать кодировку, тип разделителя,  нажать на кнопку обзор или находящееся слева от нее пустое поле, выбрать файл формата CSV или xtx с вашим прайс-листом и нажать кнопку «Сохранить».

    Формат Excel для загрузки:

     - CSV (MS-DOS) Относительно нашего примера с выгрузкой прайс-листа из программы Excel в формате CSV (MS-DOS) необходимо на странице склада при загрузке прайс-листа выбрать кодировку «CP866» и разделитель точку с запятой «;». При таких настройках прайс-лист формата CSV (MS-DOS) должен отображаться корректно на сайте.

     - TXT. При загрузке прайс-листа txt формата чаще всего используется кодировка CP1251 (windows-1251) с разделителем "Табуляция"

     После загрузки прайс-листа и сохранения данных появится диалоговое окно, оповещающее о том, что прайс-лист был загружен и склад успешно изменен. Но для того, чтобы в поиске появлялся ваш склад с парномерами из прайс-листа нужно дождаться, пока файл обработается. В течении 3 минут загрузка и обработка файла должна закончиться.

     Также, по окончанию загрузки файла, онлайн склад выключается (если был включен), то есть приобретает статус «Отключен». Чтобы ваш склад отображался в поиске необходимо включить онлайн-склад нажатием на переключатель «Вкл./Выкл.».
     Для того, чтобы проверить загружен ли прайс- лист нужно выйти из этого раздела и зайти снова. Обновлять с помощью F5 не рекомендуется, т. к. некоторые браузеры могут повторно загрузить прайс-лист. Если загрузка продолжается более 15 минут нужно написать письмо на имя администрации сайта с описанием проблемы.

Важно! Кодировку и разделитель нужно указывать до загрузки прайс-листа. После загрузки изменить кодировку будет возможно только в случае повторной загрузки прайс-листа, тоже самое происходит и с разделителем.

     Для того, чтобы в результатах поиска информация о партномере отображалась корректно, необходимо в нужном порядке описать  все поля для каждого из них в документе формата CSV или txt.

Таким образом чтобы включить склад, работающий по прайс-листу, необходимо:

  1.  Зайти в раздел «Управление складами», создать или выбрать необходимый склад;
  2. Если мы создаем склад, необходимо ввести название склада и нажать кнопку "Сохранить";
  3. Включить опцию «Использовать загруженный прайс-лист»;
  4. На странице редактирования склада выбрать в разделе необходимо выбрать кодировку и разделитель – табуляция, либо точка с запятой.
  5. Нажать на кнопку «Обзор» или на само поле загрузки прайс-листа, в открывшемся окне  выбрать CSV или txt-файл и нажать «Открыть» и нажать кнопку «Сохранить», уже на странице редактирования склада.
  6. После закрытия появившегося диалогового окна, содержащего информацию с названием прайс-листа и надпись загружен, а так же надпись «Склад изменен успешно», необходимо подождать 3 минуты до завершения загрузки и обработки прайс-листа.
    После окончания обработки необходимо заново нажать на страницу склада в левом навигационном меню. Дождавшись завершения обработки, мы увидим что надпись «Обработка файла» исчезла, и появилось новое окно повторной загрузки прайс-листа. Ниже представлена информация о количестве строк (партномеров) в прайс-листе, либо ошибки, по причине которых не удалась загрузка прайс-листа или не отображается n-ное количество строк в прайс листе. В том же месте будет показана стоимость основного тарифа и стоимость тарифа с учетом превышения (свыше 100 000 строк).  
  7. Если склад новый, то перед включением его необходимо оплатить. Для этого необходимо перейти в раздел "Мой счет" - "Оплата услуг", выбрать соответствующий склад, поставить галочку напротив него и нажать "Сохранить".  
  8. На странице склада проверяем что включено использование загруженного прайс-листа и в верхней части окна включаем сам склад, затем нажимаем «Сохранить».

     
     
  9. (Желательно) Прокрутить окно вниз и ввести один из парт номеров из вашего прайс-листа в поле «Запрос», расположенное под надписью «Тестирование скрипта», и нажать «Тестировать». Затем необходимо проверить правильность отображения информации из вашего прайс-листа в таблице, выдаваемой ниже. Таким образом будет выглядеть информация в результатах поискового запроса.

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

     После загрузки и обработки прайс-листа имеется возможность протестировать работу поиска на той же странице редактирования склада. Для этого необходимо прокрутить страницу вниз до секции «Тестирование скрипта» и ввести в поле «Запрос» какой-либо партномер из вашего прайс-листа. После нажатия кнопки «Тестировать» ниже будет выдана таблица, аналогичная выдаваемому результату поискового запроса при поиске по сайту. Здесь вы можете проверить наполненность полей и правильность отображения информации из вашего прайс-листа.

Результаты тестирования должны иметь примерно такой вид:

 

Результат поиска в нашем примере будет выглядеть следующим образом: