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

Филиал на карте — практически полный аналог сайта организации, полноценный канал продаж и «лицо» вашей компании. Необходимо следить за актуальностью данных, вовремя обновлять информацию и следить за тем, чтобы клиенты могли узнать всё необходимое. Для массовой загрузки и редактирования филиалов в Pinbox существует несколько способов.

Данный способ позволит производить постоянную загрузку и редактирование данных, синхронизировав вашу базу данных с 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>