Для отображения выпадающего меню посылочных автоматов мы рекомендуем использовать в корзине вашего интернет-магазина и всегда поддерживать в актуальном состоянии разработанный Smartpost HTML-виджет, который доступен по адресу: https://itella.ee/widget/. При выборе способа доставки Smartpost можно использовать и выводить клиенту выпадающее меню посылочных автоматов, где клиент выбирает автомат, в котором он желает получить посылку. Этот HTML-виджет является простейшим вариантом отображения списка посылочных автоматов. Все прочие варианты, которые описаны ниже, разумно использовать по мере необходимости и в соответствии с вашим видением и особыми пожеланиями.

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

• https://itella.ee/places/places.html — для просмотра в браузере.
• https://itella.ee/places/places.xml — для интерфейса веб-приложений, которые обрабатывают xml.
• https://Itella.ee/places/places.csv — для интерфейса веб-приложений, которые обрабатывают csv.
• https://itella.ee/places/places.js — для использования прямо из JavaScript на HTML-странице веб-приложения для выбора способов доставки (link или ajax), добавляется прямо на страницу.
• https://itella.ee/places/places.php — для добавления в приложение PHP.

Сведения содержат следующую информацию:

• place_id — идентификатор посылочного автомата со стороны Smartpost. При использовании автоматического обмена данными необходимо отправлять эту информацию вместе с заказом.
• name — название местонахождения посылочного автомата в свободной форме, максимальная длина 70 символов. Выводится пользователю во всплывающем меню в корзине.
• city — в каком городе находится посылочный автомат, максимальная длина 25 символов.
• address — адрес в дополнение к городу с улицей и номером дома (100 символов).
• opened — режим работы данного посылочного автомата в свободной форме (максимальная длина 75 символов).
• group_id — ID уезда, к которому относится данный посылочный автомат.
• group_name — комбинированное название уезда/города.
• group_sort — назначает установленные Smartpost приоритеты группам (уездам), которые следует показывать в выпадающем меню раньше других. Группы с наибольшим значением следует показывать в начале.
• created_date — дата добавления посылочного автомата в систему Smartpost.
• updated_date — дата обновления значения данного посылочного автомата в системе.
• description — описание посылочного автомата в данном месте расположения. Например: «Расположен в Selver у стены напротив стойки информации».
• active — содержит значения 1 или 0. 1 означает, что данный посылочный автомат следует выводить в списке выпадающего меню в корзине, а 0 означает, что не следует выводить его в списке корзины. Если какой-либо посылочный автомат выходит из строя или в случае несчастного случая в торговом центре (пример: Mustika Prisma, где произошел пожар), то данное значение меняется на 0, и этот посылочный автомат больше не отображается в выпадающем меню в корзине.
• inactive_reason — если теперь у поля active значение 0, то в данном поле inactive_reason появляется также текстовое описание, почему посылочный автомат нельзя выводить покупателям для получения в нем посылок. Одним словом, в списке посылочных автоматов в корзине будут отображаться только те посылочные автоматы, у которых в поле active значение > 0, то есть 1.

Список посылочных автоматов и их принадлежности к уездам по данным ссылкам приведен уже в той последовательности и категоризирован так, как он должен выводиться пользователю в выпадающем меню корзины. Прежде всего выводится категория «Таллинн/Харьюмаа», к которой относятся все обозначенные там посылочные автоматы, далее «Хийумаа», «Ида-Вирумаа» и т. д.
Разумеется, вы можете выбрать последовательность, которую будете отображать. В данном случае такая последовательность назначена в качестве рекомендации Smartpost.

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

1. для этого вы можете, например, синхронизировать данный список посылочных автоматов в своей базе данных следующим образом.
   Периодический процесс синхронизации (например, Cron) выводит список посылочных автоматов и по полю created_date проверяет, не появились ли новые посылочные автоматы. Если это так, он добавляет их в вашу базу данных.
   Он проверяет по полю updated_date, изменились ли данные какого-либо посылочного автомата, и если это так, обновляет имеющуюся информацию об автомате в вашей базе данных.
2. Добавляете разработанный Smartpost виджет Javascript в код HTML-страницы со своими способами доставки, после чего выбор посылочных автоматов выводится автоматически в виде выпадающего меню, и выбор сохраняется в hidden input в html. Для добавления данного способа посетите страницу сайта: https://itella.ee/widget/, при появлении вопросов свяжитесь с нами по электронной почте: info@smartpost.ee. — Самое простое решение для добавления списка посылочных автоматов в выбор способов доставки.
3. Прямо в корзине добавляете файл js:
   https://itella.ee/places/places.js и используете включенную переменную places_info для отображения выпадающего меню посылочных автоматов.
4. В веб-приложении на сервере добавляете файл https://itella.ee/places/places.php или https://itella.ee/places/places.xml или https://Itella.ee/places/places.csv (в зависимости от технологии веб-приложения) и парсите его на странице выбора способов доставки для выпадающего меню HTML.