Массовое управление данными филиалов

Для массовой загрузки и редактирования филиалов в Pinbox существует несколько способов:

  • Массовое редактирование (кроме адресной информации)
  • Загрузка данных из таблиц xls, xlsx, csv (разовая загрузка)
  • Загрузка данных из геосервисов
  • Динамическое обновление XML

Массовое редактирование в личном кабинете

Для копирования данных на все филиалы необходимо зайти в форму редактирования любого филиала, установить необходимое значение и нажать: Копировать. Данная функция показывается на всех типах данных, кроме адресной информации. Также она доступна только при выключенной опции: Блокировка редактирования. Для исключения некоторых филиалов из листа копирования, необходимо установить заранее блокировку редактирования, которая не даст внести правки при копировании.



Загрузка данных из таблиц

Данный способ используется как разовый способ для массовой загрузки данных при начале работы. Для этого необходимо подготовить данные в табличном виде (xls, xlsx, csv), согласно спецификации: СКАЧАТЬ. Далее таблицу необходимо отправить менеджеру, он проведет модерацию и загрузку. Обязательными являются лишь уникальные адресные данные, прочие данные можно отредактировать позднее. Координатные данные (широта и долгота), в случае их не указания, возьмутся автоматически из геосервисов.

Загрузка данных из геосервисов

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

XML для динамической загрузки и обновления данных

Данный способ позволит производить постоянную загрузку и редактирование данных, синхронизировав вашу базу данных с Pinbox. Для этого с вашей стороны необходимо организовать генерацию и обновление файла XML и его доступность на вашем сервере. Далее Pinbox в соответствие с настройками будет скачивать данный файл и согласно ему обновлять данные: создание филиалов, закрытие/открытие филиалов, изменение данных.

Пример XML

Скачать пример
<?xml version="1.0" encoding="UTF-8"?>
<company>
<card>
<id>23121</id>
<status>OPEN</status>
<name>Прагматика Купчино KIA, официальный дилер KIA</name>
<short_name>Прагматика Купчино KIA</short_name>
<name_en>Pragmatika Kupchino KIA, ofitsialnyy diler KIA</name_en>
<short_name_en>Pragmatika Kupchino KIA</short_name_en>
<address>Малая Балканская улица, 57</address>
<region>Санкт-Петербург</region>
<country>Россия</country>
<postalcode>192289</postalcode>
<office>1 этаж</office>
<latitude>59.829063</latitude>
<longitude>30.426765</longitude>
<phone>+7(812)2101766</phone>
<phoneAd>+7(812)2101721,+7(812)2101722</phoneAd>
<site>https://www.plt-kia.ru/</site>
<facebook>https://www.facebook.com/kiaspbru</facebook>
<vk>https://vk.com/kia_pragmatika</vk>
<ok></ok>
<twitter></twitter>
<wa></wa>
<instagram></instagram>
<youtube></youtube>
<viber></viber>
<telegram></telegram>
<email>call@plt.spb.ru</email>
<regularHours>
<monday>08:00-21:00</monday>
<tuesday>08:00-21:00</tuesday>
<wednesday>08:00-21:00</wednesday>
<thursday>08:00-21:00</thursday>
<friday>08:00-21:00</friday>
<saturday>08:00-21:00</saturday>
<sunday>08:00-21:00</sunday>
</regularHours>
<breaksHours>
<monday>12:00-13:00</monday>
<tuesday>12:00-13:00</tuesday>
<wednesday>12:00-13:00</wednesday>
<thursday>12:00-13:00</thursday>
<friday>12:00-13:00</friday>
<saturday>12:00-13:00</saturday>
<sunday>12:00-13:00</sunday>
</breaksHours>
<dateUpd>2021-01-01</dateUpd>
</card>
</company>

Описание XML

Важно! Xml файл служит не только источником загрузки информации, но и источником команд: удаление данных, закрытие филиала.

  • При периодическом обновлении XML, можно не прописывать все филиалы, а только те, что нуждаются в обновлении.
  • Пустые значения в тегах, будут означать удаление данных. Например, оставив пустым значение времени работы в воскресенье приведет к установке не рабочего времени в воскресенье.
  • Пропуск (не использование тегов) означает, что в Pinbox останутся ранее загруженные данные и обновление их не нужно.
  • Важными полями являются ID. По ID система определяет о каком филиале идет речь, одностороннее изменение ID филиала, ранее сохраненного в Pinbox, приведет к ошибке.
  • Тэг dateUpd служит для указания последнего обновления данных. По этой дате система определяет есть ли необходимость проверки полей на обновление. В случае если за указанную дату загрузка уже осуществлялась, то данные пропускаются.
Поле Формат Описание
<card>Контейнер, содержащий информацию о филиале
<id>23121</id>единственное обязательное поле,латинские символы и цифры, до 50 знаковУникальный номер (код) филиала, использующийся в вашей базе данных
<status>OPEN</status>OPEN или пустое значение: филиал открыт. CLOSE филиал закрыт и должен быть удален из геосервисовСтатус филиала
<name>Прагматика Купчино KIA, официальный дилер KIA</name>до 250 символов, не используются специальные символыНазвание филиала
<short_name>Прагматика Купчино KIA</short_name>до 250 символов, длина менее, чем основное названиеКороткое название филиала
<name_en>Pragmatika Kupchino KIA, ofitsialnyy diler KIA</name_en>до 250 символов, не используются специальные символыНазвание филиала на английском языке
<short_name_en>Pragmatika Kupchino KIA</short_name_en>до 250 символов, длина менее, чем основное название на английскомКороткое название филиала на английском языке
<address>Малая Балканская улица, 57</address>без указания региона и страны (указанных в соответствующих полях)Адрес филиала
<region>Санкт-Петербург</region>область или город по установленным стандартам РФРегион
<country>Россия</country>страна установленным стандартам РФСтрана
<postalcode>192289</postalcode>Индекс
<office>1 этаж</office>до 50 символовУточнение адреса: этаж, офис, примечание
<latitude>59.829063</latitude>Широта
<longitude>30.426765</longitude>Долгота
<phone>+7(812)2101766</phone>начинается с +7 или 8800Основной номер телефона
<phoneAd>+7(812)2101721,+7(812)2101722</phoneAd>номера через запятую, начинается с +7 или 8800Дополнительные номера телефонов
<site>https://www.plt-kia.ru/</site>включая протоколСайт компании
<facebook>https://www.facebook.com/kiaspbru</facebook>включая протоколСсылка на Facebook
<vk>https://vk.com/kia_pragmatika</vk>включая протоколСсылка на Вконтакт
<ok></ok>включая протоколСсылка на Одноклассники
<twitter></twitter>включая протоколСсылка на Твиттер
<wa>https://wa.me/79119307634</wa>включая протоколСсылка на WhatsApp
<instagram></instagram>включая протоколСсылка на Instagram
<youtube></youtube>включая протоколСсылка на YouTube
<viber>https://viber.click/79119307634</viber>включая протоколСсылка на Viber
<telegram></telegram>включая протоколСсылка на Telegram
<email>call@plt.spb.ru</email>Email для связи
<regularHours>Контейнер для указания времени работы
<monday>08:00-21:00</monday>формат: время начала - время завершения (00:00-00:00 круглосуточно, 12:00-05:00 завершение на следующий день, 07:00-05:00 с 7 до 5 утра)Время работы в понедельник
<tuesday>08:00-21:00</tuesday>формат: время начала - время завершения (00:00-00:00 круглосуточно, 12:00-05:00 завершение на следующий день, 07:00-05:00 с 7 до 5 утра)Время работы во вторник
<wednesday>08:00-21:00</wednesday>формат: время начала - время завершения (00:00-00:00 круглосуточно, 12:00-05:00 завершение на следующий день, 07:00-05:00 с 7 до 5 утра)Время работы в среду
<thursday>08:00-21:00</thursday>формат: время начала - время завершения (00:00-00:00 круглосуточно, 12:00-05:00 завершение на следующий день, 07:00-05:00 с 7 до 5 утра)Время работы в четверг
<friday>08:00-21:00</friday>формат: время начала - время завершения (00:00-00:00 круглосуточно, 12:00-05:00 завершение на следующий день, 07:00-05:00 с 7 до 5 утра)Время работы в пятницу
<saturday>08:00-21:00</saturday>формат: время начала - время завершения (00:00-00:00 круглосуточно, 12:00-05:00 завершение на следующий день, 07:00-05:00 с 7 до 5 утра)Время работы в субботу
<sunday>08:00-21:00</sunday>формат: время начала - время завершения (00:00-00:00 круглосуточно, 12:00-05:00 завершение на следующий день, 07:00-05:00 с 7 до 5 утра)Время работы в воскресенье
</regularHours>
<breaksHours>Контейнер для указания перерыва работы
<monday>12:00-13:00</monday>формат: время начала - время завершения, не должен противоречить основному времени работыПерерыв в понедельник
<tuesday>12:00-13:00</tuesday>формат: время начала - время завершения, не должен противоречить основному времени работыПерерыв во вторник
<wednesday>12:00-13:00</wednesday>формат: время начала - время завершения, не должен противоречить основному времени работыПерерыв в среду
<thursday>12:00-13:00</thursday>формат: время начала - время завершения, не должен противоречить основному времени работыПерерыв в четверг
<friday>12:00-13:00</friday>формат: время начала - время завершения, не должен противоречить основному времени работыПерерыв в пятницу
<saturday>12:00-13:00</saturday>формат: время начала - время завершения, не должен противоречить основному времени работыПерерыв в субботу
<sunday>12:00-13:00</sunday>формат: время начала - время завершения, не должен противоречить основному времени работыПерерыв в воскресенье
</breaksHours>
<dateUpd>2021-01-01</dateUpd>формат: Год-месяц-день (Y-m-d)Дата последнего обновления данных этого филиала
</card>