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> |