База знаний
Техническая поддержка ТЦ "Пятая среда" > Техническая поддержка ТЦ "Пятая среда" > База знаний

Задать вопрос:


Названия полей файла импорта

Решение

Названия полей файла импорта

 

Названия поля в VeeRoute

Описание

Пример

Длина поля (симв.)

Обязательно?

orderReference

Уникальный идентификатор или номер заказа в системе. Это может быть номер из 1С или любой другой. Если номер не задавать, то система назначит произвольный. При задании уже существующего идентификатора система будет пытаться обновить параметры такого заказа (если такой заказ не распределен на машину, иначе будет создан новый заказ с дубликатом номера заказа)

T0000129082

64

в общем случае -нет.

да -  когда требуется обнолвлять существующие незапланированные заказы в течение дня

date

Дата доставки или сбора заказа. Формат даты -  дд.мм.гггг, т.е. год обозначается четырьмя цифрами

01.01.2015

 

нет, но требуется в случаях, когда при выборе  файла не указывается дата

distributionCentreName

Область, контролируемая диспетчером. Здесь для конкретного заказа указывается название склада, находящегося в ведении диспетчера. Для аккаунтов с единственным Распределительным Центром (РЦ) это поле заполнять необязательно

Центральное депо

255

нет – для одного РЦ, да – для нескольких РЦ

distributionCentreAddress

Адрес местонахождения РЦ (склада), откуда машина начинает и где заканчивает свой рейс.

(формат: «Город, улица, дом» либо «Улица, дом, город»)

Ново-Садовая улица 349, Самара, городской округ Самара, Россия

255

нет

clientName

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

ООО Мясной Пир

255

нет

contactPerson

Контактное лицо у данного заказа. Здесь обычно указывается имя человека для контакта

Иванов И.И.

255

нет

contactNumber

Телефон контактного лица заказчика (рекомендуется использовать международный формат: +, код страны, код города, номер абонента – все пишется слитно)

+78482345678

255

нет

contactEmail

Email контактного лица. Ограничения: поле поддерживает только латиницу, цифры,  дефис, нижнее подчеркивание, @ и точку. Формат записи – почта@домен.зона . Зона до 4 знаков (ru, com, mobi и т.д.)

contact@company.ru

64

нет

customerLocationName

Название расположения клиента. Название, как правило, выбирается с целью конкретизировать данное место и обычно включает в себя короткое название фирмы, а для филиалов какой-либо ориентир, например, станцию метро или район. Работа с клиентом ведется по этим локациям. Если не задавать, то имя будет скопировано из поляcustomerLocationAddress

ООО Мясной Пир (Север)

255

нет, но обязательно для создания клиентской локации

customerLocationAddress

Адрес расположения клиента. Это адрес местоположения клиента, указанного выше.

В данное поле не рекомендуется вносить такие сведения, как квартира, домофон, позвонить за час и т.д., так как такая информация приводит к искажениям при поиске адреса. Для дополнительной информации следует использовать полеadditionalInstructions

Россия, Санкт-Петербург, Разъезжая улица, 17

255

да

customerLocationGlobalId

Уникальный номер клиентской локации. Этот номер может быть использован для работы с конкретной локацией, чтобы обновить параметры расположения клиента.

2807d00452364ba6a

64

нет

task

Разновидность заказа: сбор или доставка. Если поле не заполнено, то считается, что данный заказ требуется доставить. Простановка слова «доставка» означает то же самое. Если проставить «сбор», то такой заказ предполагается к вывозу

сбор

 

нет

dropDuration

Продолжительность разгрузки либо погрузки товара в минутах. Параметр определяет ожидаемое время работы на точке. Если не задавать, то время будет выбрано из умолчания аккаунта. Допускается только целое ненулевоезначение

10

 

нет

capacity

Один из двух возможных параметров заказа - масса заказа (в кг), либо любая другая величина (человек, коробок, поддонов, штук). Дробные значение следует вводить через запятую

24,7

 

нет

volume

Второй параметр заказа - объем заказа (м3). Дробные значение следует вводить через запятую

2,5

 

нет

cost

Стоимость заказа, которую должен оплатить клиент за заказ, его доставку и т.п. (в рублях). Пробелы в сумме не допускаются. Дробные значения следует вводить через запятую.

3200

255

нет

orderItems

Обозначение позиции товара в заказе, обычно соответствует штрихкоду. Для одинаковых товаров может принимать одинаковое значение. Формат: любые символы кроме апострофа и кавычек (‘ и ”). Несколько значений указываются через точку с запятой. Формат записи

[Название товара]код 1;

[Название товара 2]код 2

[Hennesy OX 1958 Партия 1 коробка 2 из 2]1008105964500552;

[Кракен для Илоны коробка 1 из 1]2521250862053500

 

нет

additionalinstructions

Любые дополнительные сведения о заказе или клиенте (сведения об оплате картой, примечания по доставке прайс-листов, коды домофона, просьба позвонить за час и т.п.)

Москва, Конюшковский Малый пер., д. 2; Офисное здание MOD Design. Можно не заходить внутрь, позвонить мне, я выйду на улицу и заберу заказ. Можно зайти внутрь, подняться на второй этаж, на стене большая надпись SuperJob, у стены желтая скамейка. Позвонить уже оттуда

255

нет

type

Тип транспортного средства. Тип служит для каких-либо ограничений по перевозке, т.е. закрепления выбранных машин за определенными заказами или клиентами. Например, «Большая» машина будет выбираться для габаритных заказов. Тип задается в настройках

Большая

Рекомендуется не использовать с версии 3.9.4.12. Используйте поле vehicleRequirements

255

нет

attributes

Атрибут заказа, привязанный к заранее определенному типу. Например, для машины типа «Большая» могут быть два атрибута – «своя» и «наемная», для разграничения перевозки

Примечание. Это поле упразднено с версии 3.9.4.12, но остается совместимым для более ранних версий файла импорта. Значение из поля attributes будет транслироваться в поле type

Наемная

Рекомендуется не использовать с версии 3.9.4.12. Используйте поле vehicleRequirements

255

нет

vehicleRequirements

Доступно с версии 3.9.4.12

Требования к транспортному средству. Заменяет типы и атрибуты и совместимо с ними. С помощью требований можно закреплять водителя за точкой доставки, но этого нельзя сделать через файл импорта заказов. Допускается перечислять несколько требований через запятую

Своя машина, Средняя

255

нет

orderTimeFrom1

 

Начало первого окна работы у клиента. Окно определяет допустимые временные рамки для доставки или вывоза заказа.

Данный параметр определяет время, раньше которого заказ выполнить нельзя, а начиная с данного времени – можно.

Всего в системе через файл импорта может быть задано не более двух окон на один день.

Примечание. Здесь и далее формат времени чч:мм

Требует указывать дату (полеdate)

Допускается не указывать ведущий ноль, например вместо 02:00 писать 2:00

02:00

 

нет

orderTimeTo1

 

Конец первого окна работы у клиента (чч:мм). Параметр определяет крайний срок, до которого должна быть завершена работа по данному заказу

Требует указывать дату (полеdate)

06:45

 

нет

orderTimeFrom2

 

Начало второго окна работы у клиента (чч:мм). Параметр определяет дополнительное время, с которого можно начать выполнять работу по разгрузке или загрузке заказа

Требует указывать дату (полеdate)

10:30

 

нет

orderTimeTo2

 

Конец второго окна работы у клиента (чч:мм). Определяет крайний срок окончания работ в рамках дополнительного временного окна

Требует указывать дату (полеdate)

14:00

 

нет

orderDateFrom

 

Начальная дата, когда клиент доступен для приема машины. Формат даты:дд.мм.гггг. Начиная с этого дня можно выполнять работы у клиента. Данный параметр применяется совместно сorderDateTo

Предполагает использование поля OrderTimeFrom1

Примечание: при использовании данного поля поле dateне используется.

19.10.2014

 

нет

orderDateTo

 

Конечная дата, когда клиент еще доступен для приема машины. Означает крайний день, когда можно выполнять работу у клиента

Предполагает использование поля OrderTimeTo1

Примечание: при использовании данного поля поле dateне используется.

22.10.2014

 

нет

dropWindowStart

Обозначает время левой границы временного окна. Данный параметр не требует указания даты. Вместе с параметром dropWindowEndони определяют временное окно доставки/сбора. Может использоваться как совместно с dropWindowEnd, так и самостоятельно. В таком случае правая граница будет взята из системного умолчания

Примечание: При использовании этого поля нельзя использовать полеOrderTimeFrom1

09:30

 

нет

dropWindowEnd

Обозначает время правой границы временного окна. Не требует указания даты. Может использоваться как совместно с dropWindowStartтак и отдельно. В таком случае левая граница будет взята из системного умолчания

18:00

 

нет

Priority

Приоритет заказа, обозначается цифрами либо оставляется пустым.

1 – низкий, обозначается

2 – средний, обозначается

3 – высокий, обозначается

Пустое поле – низкий приоритет  

1

 

нет

latitude

Координата «широта» в диапазоне от -90 до 90 в виде десятичного числа. Дробные значение следует вводить через точку. Применяется для уточнения месторасположения клиента в случаях, когда адрес определяет место лишь приблизительно

Не используйте 0 в качестве координаты

55.755831

20

нет

longitude

Координата «долгота» в диапазоне от -180 до 180 в виде десятичного числа. Дробные значение следует вводить через точку

Не используйте 0 в качестве координаты

37.617673

20

нет

schedulingZoneName

Название территории планирования. В системе можно рисовать на карте регионы в виде многоугольников и накладывать их на заказы, равно как размещать заказы в рамках заранее созданных регионов. Регионы могут пересекаться, поэтому на этапе импорта заказ следует привязать к правильному региону. При рисовании границ территорий пользователь задает их название. В данном поле файла импорта следует указывать именно эти названия. Если название не указывать, а заказу будут соответствовать несколько территорий, то заказу будет присвоена территория, которая в системе была создана самой первой

Юго-запад

255

нет

is_return_packages

Возврат тары (true=да, false=нет). По умолчаниюfalse, если не указывать, тоfalse

false

 

нет

return_packages_comments

Комментарий к возврату тары, еслиis_return_packages=true

 

 

нет

stopSequence

порядок заказа в рейсе, значения:

·         Первый - первый в рейсе

·         Последний - последний в рейсе

·         Любой (или пусто) - любой в рейсе

Если не указано, то равно Любой.

Если указать Первый /Последний нескольким заказам, то такие заказы перераспределятся между собой в голове или хвосте рейса соответственно.

Первый

 

нет

sequenceInRun

Порядковый номер заказа в рейсе для расписания, созданного заранее вне VeeRoute. Каждый заказ должен иметь уникальный последовательный номер, начиная с 1

1

 

если задано, то для этого заказа обязательны к заполнению поля «allocationDate» и «vehicleName»

runNumber

Номер рейса для импорта готового расписания (3.9.4.14)

1

 

если задано, то для этого заказа обязательны к заполнению поля «allocationDate» и «vehicleName»

vehicleName

Название машины

к610кн23

 

зависит от sequenceInRun, runNumber

allocationDate

Дата рейса в готовом расписании.

Дата доставки или сбора заказа. Формат даты - дд.мм.гггг, т.е. год обозначается четырьмя цифрами

20.04.2015

 

зависит от sequenceInRun, runNumber

 

 

 
Была ли эта статья полезной? да / нет
Детали статьи
ID статьи: 139
Категория: Файл импорта VeeRoute
Дата добавления: 2015-09-17 17:07:58
Просмотры: 264
Рейтинг (Голоса): Рейтинг статьи 3.0/5.0 (2)

 
« Назад

 
Powered by Help Desk Software HESK - brought to you by Help Desk Software SysAid