Импорт расположений клиентов. Параметры и требования к файлу импорта
Пример файла импорта расположений клиентов:
Файл импорта расположений клиента
Требования к файлу импорта
Файл импорта должен содержать данные по расположениям клиента, которые должны быть загружены в систему.
Файл импорта - это набор данных, разделённых точкой с запятой: CSV (англ. Comma separated values). При правильно настроенном системном разделителе CSV-файл открывается и редактируется в Excel как обычная таблица, хотя на самом деле таблицей не является.
Название полей файла импорта
Чтобы создать новый файл или использовать готовый шаблон, при заполнении таблицы данных используйте заголовки столбцов из следующей таблицы Название полей файла импорта:
Название поля в Максоптре | Описание | Обязательность | Длина | Пример |
customerLocationName | Название расположения клиента. Название, как правило, выбирается с целью конкретизировать данное место и обычно включает в себя короткое название фирмы, а для филиалов какой-либо ориентир, например, станцию метро или район. Работа с клиентом ведется по этим локациям. Если не задавать, то имя будет скопировано из поля customerLocationAddress | Обязательное | 255 | ООО Мясной Пир (Север) |
customerLocationAddress | Адрес расположения клиента. Это адрес местоположения клиента, указанного выше. В данное поле не рекомендуется вносить такие сведения, как квартира, домофон, позвонить за час и т.д., так как такая информация приводит к искажениям при поиске адреса. | Обязательное | 255 | Россия, Санкт-Петербург, Разъезжая улица, 17 |
| w3wAddress | Максоптра поддерживает формат кодирования адреса по системе What3Words. Если вы хотите использовать эту интеграцию, свяжитесь с командой техподдержки Максоптры. После этого вы сможете указывать в качестве адреса расположения клиента код из трех слов. | Необязательное | 255 | помощь.стебель.ставка |
| customerLocationGlobalId | Уникальный номер клиентской локации. Этот номер может быть использован для работы с конкретной локацией, чтобы обновить параметры расположения клиента. См. также Идентификатор расположения клиента | Необязательное | 64 | 2807d00452364ba6a |
| latitude | Координата широты расположения клиента. Используется для определения местонахождения расположения клиента, если адрес расположения клиента указан неточно. | Необязательное | 20 | 55.755831 |
| longitude | Координата долготы расположения клиента. Используется для определения местонахождения расположения клиента, если адрес расположения клиента указан неточно. | Необязательное | 20 | 37.617673 |
| startTime | Время "С…" для каждого дня, когда расположение клиента доступно для доставки заказа. | |||
| endTime | Время "До..." для каждого дня, когда расположение клиента доступно для доставки заказа. | |||
| preferredDrivers | Один или несколько водителей, предпочтительных для доставки заказа в данное расположение клиента. | Необязательное | 255 | Константин Петров |
contactNumber | Основной контактный телефон. Телефон контактного лица для данного расположения клиента. Рекомендуется использовать международный формат номера: +, код страны, код города, номер клиента. Если у вас один контактный номер расположения клиента, используйте данное поле. Если необходимо импортировать два номера телефона, используйте поля primaryNumber и secondaryNumber. | Необязательное | 255 | +79370797225 |
| contactEmail | Электронная почта контактного лица данного расположения клиента. Ограничения: данное поле поддерживает только латинские буквы, числовые символы, дефис, нижнее подчёркивание, @ и точку. Возможно указать несколько адресов электронной почты для получения уведомлений, при этом адреса указываются через точку с запятой. | Необязательное | 64 | contact@company.ru |
clientName | Обычно это наименование компании для идентификации клиента среди остальных клиентов. | Необязательное | 255 | Мясной Пир |
additionalTimePerVisit | Дополнительное время (в минутах), затрачиваемое на подъезд к клиенту. | |||
| fixedOperationDuration | Фиксированное время работы у клиента для каждого заказа. Время, добавляемое к каждому заказу и учитываемое при доставке заказа. Время разгрузки = Фиксированное время работы у клиента для каждого заказа + Время разгрузки одной единицы груза у клиента. Такие же параметры определены для всего аккаунта. Если параметры указаны и для аккаунта, и для конкретного расположения клиента, значения, указанные в расположении клиента, являются приоритетными. | |||
dropDurationPerUnit | Время разгрузки одной единицы груза у клиента. | Необязательное | 10 | 15 |
| pickupDurationPerUnit | Время погрузки одной единицы груза у клиента. | |||
id | Идентификатор клиента во внешней системе. Примечание Данное поле соответствует полю customerLocationGlobalId в файле импорта заказов. Во избежание дублирования рекомендуется указывать идентификатор расположения клиента в файле импорта для точного распознавания системами геокодирования. Подробнее см. в разделе Параметры расположения клиента. | Необязательное | ||
webSite | Веб-сайт расположения клиента. | Необязательное | ||
| primaryNumber | Основной номер телефона контактного лица клиента. Рекомендуется использовать международный формат номера: +, код страны, код города, номер клиента. Если у вас один контактный номер расположения клиента, вы можете использовать поле contactNumber. | Необязательное | 255 | +79370797225 |
| secondaryNumber | Запасной контактный телефон. Рекомендуется использовать международный формат номера: +, код страны, код города, номер клиента. | Необязательное | 255 | +79370797225 |
| isVerified | Данное поле отвечает за отметку поля "Местонахождение проверено" на форме "Расположение клиента". Оно показывает, проверено или нет местонахождение расположения клиента. | Необязательное |
См. также
Создание и импорт расположений клиентов
Параметры расположения клиента