XML для динамической загрузки и обновления данных
Филиал на карте — практически полный аналог сайта организации, полноценный канал продаж и «лицо» вашей компании. Необходимо следить за актуальностью данных, вовремя обновлять информацию и следить за тем, чтобы клиенты могли узнать всё необходимое. Для массовой загрузки и редактирования филиалов в Pinbox существует несколько способов.
Данный способ позволит производить постоянную загрузку и редактирование данных, синхронизировав вашу базу данных с Pinbox. Для этого с вашей стороны необходимо организовать генерацию и обновление файла XML и его доступность на вашем сервере. Далее Pinbox в соответствие с настройками будет скачивать данный файл и согласно ему обновлять данные: создание филиалов, закрытие/открытие филиалов, изменение данных.
Пример XML
Скачать примерОписание 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> |