Page Comparison

Некоторые

Товары - это позиции, входящие в состав заказа, требующие отдельного описания и учета. В Максоптре некоторые заказы могут быть составными, то есть состоять из нескольких позиций, которые необходимо передать заказчику (клиенту). Каждая  Каждая отдельная позиция заказа называется товаром. Например, заказ состоит из следующих товаров: 1 стол, 2 стула, 1 кресло. Все три товара объединены одним идентификационным номером заказа.

Также, товары отражены в мобильном приложении водителей (см. Работа с товарами. (Android) и Работа с товарами (iOS)), где водители могут конролировать доставку отдельных товаров при работе с заказами.

Вкладка "Товары" на форме заказа

Если заказ большой, состоит из нескольких позиций, каждая отдельная позиция со штрих-кодом может быть указана в поле "Товары" на на вкладке Товары на форме заказа:

Image Removed

Рисунок 1. Поле "Товары" на форме заказа

У каждой позиции товара в заказе есть три параметра - название, штрих-код и статус. Чтобы добавить товары в заказ, нажмите кнопку "Изменить" рядом с полем "Товары":

Image Removed

Рисунок 2. Окно "Товары" 

В открывшемся окне нажмите кнопку "Создать" и заполните поля "Название" и "Штрих-код". Image Added

На данной вкладке товары представлены в виде таблицы, состоящей из нескольких колонок с необходимыми для работы параметрами:

Image Added

...

Image Removed

Рисунок 3. Создание товаров в заказе

...

...

...

...

...

Отдельные позиции (товары) заказа могут быть импортированы в Максоптру из csv-файла и через REST API. 

Чтобы узнать, как внести штрих-коды позиций заказов в систему при импорте заказов из csv-файла (название поле: “orderItems”), перейдите по ссылке. 

Чтобы узнать, как внести штрих-коды позиций заказов в систему через Maxoptra REST API, перейдите по ссылке. 

...

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

Можно по необходимости добавлять или скрывать колонки с помощью кнопки Image Added, расположенной в правом верхнем углу экрана. Откроется диалог Видимость колонок, где можно включать/отключать нужные параметры, а также устанавливать порядок следования колонок путем перетаскивания строк.

Image Added

Можно также настроить отображение товаров в путевом листе и в подтверждении доставки.

Создание товаров

Новые товары можно создать тремя способами: вручную, импортировать из csv-файла, по API.

Создание товаров вручную

Нажмите на кнопку Создать в нижней части вкладки Товары. Откроется форма Новый товар, куда необходимо ввести информацию. Ни один из параметров в форме Товары не является обязательной.

Image Added

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

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

Image Added

Система создаст клон товара, который вы впоследствии сможете отредактировать. 

Чтобы удалить товар, выделите его и нажмите кнопку Удалить.

Image Added

После внесения всех изменений, нажмите Сохранить.

Импорт товаров через CSV-файл

Информация о товарах, передаваемых через csv-файл, должна прописываться в колонке orderItems. Чтобы правильно записать товары в файл импорта, придерживайтесь следующего формата:

• Имя товара заключается в квадратные скобки - […],
• Прочая информация о товаре разделяется вертикальными чертами - |,
• Каждый товар отделяется от другого точкой с запятой - ;.

Формат записи следующий:  [Имя]штрих-код|идентификатор|цена за единицу|планируемое количество|описание

Пример записи:  [Черная коробка]509361766273097|ЧК4561321|320|12|Осторожно! Не кантовать; 

Если вам нужно указать лишь несколько параметров, то в этом случае нужно оставить вертикальные черты без указания данных. Например, если нам нужно указать только имя и количество, формат записи будет такой: [Пакет 1]|||20| . Можно не писать вертикальные черты, идущие после последней указанной величины, если дальше больше ничего не будет указано: [Пакет 1]|||20. Имя тоже можно не указывать: [ ]1234678||||осторожно!.

Image Added

Примечание Данный формат записи товаров действует и в файлах экспорта.

Также см. Импoрт заказов. Параметры и требования к файлу импорта.

Изменения в API

В методе save информация о товарах прописывается в разделе orderItems API запроса. Раздел orderItems метода save состоит из следующих полей:

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

                         2. Ни одно из полей не является обязательным.

<?xml version="1.0" encoding="UTF-8"?>
<apiRequest> 
<sessionID>ccb48882378547909e3a26e75488e35c</sessionID>
   <orders>
      <order>
         <orderReference>Order123</orderReference>       
         <areaOfControl>BeestonZone</areaOfControl>       
         <date>08/05/2019</date>
         <client>
            <name>Customer1</name>          
            <contactPerson>Gary Davis</contactPerson>
            <contactNumber>100000001</contactNumber>          
            <contactEmail>jerry@gmail.com</contactEmail>
         </client>
         <location>
            <name>ACOMBPETS-YO26 4LT</name>
            <address>3 REGENT BUILDINGS,ACOMB,YORK, YO26 4LT</address>         
            <latitude>53.9663582</latitude>         
            <longitude>-1.1221</longitude>          
            <isVerified>true</isVerified>
         </location>
         <dropWindows>
            <dropWindow>             
               <start>08/05/2019 8:00</start>
               <end>08/05/2019 17:00</end>
            </dropWindow>
         </dropWindows>       
         <priority>2</priority>       
         <durationDrop>00:15</durationDrop>       
         <capacity>100</capacity>       
         <volume>200</volume>       
         <collection>true</collection>       
         <additionalInstructions>some additional instructions</additionalInstructions>        
         <stopSequence>any</stopSequence>
         <orderItems>
           <orderItem>   
             <name>Package1</name>  
             <barcode>666666686454666</barcode>
             <externalId>test_1</externalId> 
             <costPerUnit>50</costPerUnit>  
             <quantity>10</quantity>  
             <description>Leave in front of the door</description>
           </orderItem>
           <orderItem>
             <name>Package2</name>  
             <barcode>666666686454777</barcode>  
             <externalId>test_2</externalId>  
             <costPerUnit>30</costPerUnit>
             <quantity>20</quantity>
             <description>Fragile</description>
           </orderItem>
         </orderItems>         
      </order>
   </orders>
</apiRequest>

Информация о товарах также передается в ответах методов API для сбора статистики: getOrderStatuses, getConsignment, getScheduleByAOCOnDate, getScheduleByVehicleOnDate, getScheduleByVehicleRun. 

getOrderStatuses 

Раздел orderItems метода getOrderStatuses включает следующие поля:

Примечание Информация в полях failReason, status и comment предоставляется водителями с мобильного приложения. 

<?xml version="1.0" encoding="UTF-8"?>
<apiResponse version="2.0">
   <orderStatusResponse>
      <orders>
         <order referenceNumber="1070773" status="FAILED" fullNotes="Incorrect address" />        
            <orderItem name="test1" barcode="CEARKF0000003001" status="NOT_CHECKED" costPerUnit="1" totalCost="10" quantity="10" actualQuantity="0" />
            <orderItem name="test2" barcode="CEARKF0000003002" status="NOT_CHECKED" costPerUnit="1" totalCost="10" quantity="10" actualQuantity="0" />        
         </order>
         <order referenceNumber="1071088" status="CLOSED" />
            <orderItem name="test3" barcode="CEARKF0000003003" status="CHECKED" costPerUnit="1" totalCost="10" quantity="10" actualQuantity="10"/>           
            <orderItem name="test4" barcode="CEARKF0000003004" status="CHECKED" costPerUnit="2" totalCost="20" quantity="10" actualQuantity="20"/>
      </orders>
  </orderStatusResponse>
</apiResponse>

getConsignment

Раздел orderItems метода getConsignment включает следующие поля:

Примечание Информация в полях failReason, status и comment предоставляется водителями с мобильного приложения.

<?xml version='1.0' encoding='UTF-8' standalone='yes'?>
<apiResponse version="1.0">
<consignmentResponse>
 <consignments>
   <consignment consignmentReference="4366700843117298688">
     <orders>
       <order referenceNumber="mID5205913" linkType="PND" status="NEW">
<orderItem name="test1" barcode="1008105964500552" status="NOT_CHECKED" costPerUnit="0" totalCost="0" quantity="0" actualQuantity="0" />
<orderItem name="test2" barcode="2521250862053500" status="NOT_CHECKED" costPerUnit="0" totalCost="0" quantity="0" actualQuantity="0" />
       </order>
       <order referenceNumber="mID5205917" linkType="PND" status="NEW">
<orderItem name="test3" barcode="54654532583386658" status="NOT_CHECKED" costPerUnit="0" totalCost="0" quantity="0" actualQuantity="0" />
<orderItem name="test4" barcode="54561646465455" status="NOT_CHECKED" costPerUnit="0" totalCost="0" quantity="0" actualQuantity="0" />
<orderItem name="eqw" barcode="eqweqw" status="NOT_CHECKED" costPerUnit="0" quantity="0" />
       </order>
     </orders>    </consignment>  </consignments>
</consignmentResponse>
</apiResponse>

getSchedulesByAOCOnDate, getScheduleByVehicleOnDate и getScheduleByVehicleRun

Эти три метода могут быть объединены в одну группу, поскольку их ответы имеют одинаковую структуру. Раздел orderItems вответах данных трех методов включает следующие поля:

Примечание Информация в полях failReason, status и comment предоставляется водителями с мобильного приложения.

<?xml version='1.0' encoding='UTF-8' standalone='yes'?>


<apiResponse version="1.0">


<scheduleResponse>


<units timeZone="Greenwich Mean Time" timeZoneOffset="GMT+0:00" currency="GBP" distanceUnits="MILE" speedUnits="MILES_PER_HOUR" durationUnits="MINUTE" weightUnits="Kg" volumeUnits="m3"/>


<vehicles>

<vehicle id="30281" name="!cup" driverName="!cup" driverPhone="+201904251904" driverExternalID="!cup" externalID="!cup" costByDistance="1" vehicleActivationCost="0" costPerOrder="0"
maxWeight="1" maxVolume="1" aocId="190">  
<run runDay="20/05/2019" runNumber="1" planDistance="100.38" factDistance="" planDuration="454" factDuration="10" runStartTime="20/05/2019 01:00" runEndTime="20/05/2019
08:34" runLoadingEndTime="20/05/2019 01:10" availabilityStartTime="20/05/2019 01:00" availabilityEndTime="20/05/2019 22:59" planWeight="0" planVolume="0" weightUtilization="0"
volumeUtilization="0" cost="100.38">
     
<location locationType="PICKUP" name="ChippenhamZone" address="ChippenhamZone" latitude="51.391494" longitude="-2.070923" planArrivalTime="20/05/2019 01:00" planDepartureTime="20/05/2019 01:10" factArrivalTime="" factDepartureTime=""planMileage="0" mileage="0" factMileage="" factDuration="" planDrivingTime="0" factDrivingTime="" planStopDuration="10" factStopDuration="" estimatedArrivalTime="" estimatedDepartureTime=""/>
    
<location number="1" locationType="DROP" name="Primrose Hill 28, Bath, England, BA1 2, GB" address="Primrose Hill 28, Bath, England, BA1 2, GB" latitude="51.395717" longitude="-2.376594" planArrivalTime="20/05/2019 01:58" planDepartureTime="20/05/2019 02:11" factArrivalTime="" factDepartureTime="" planMileage="17.5" mileage="17.5" factMileage=""
factDuration="" planDrivingTime="48" factDrivingTime="" planStopDuration="13" factStopDuration="" estimatedArrivalTime="" estimatedDepartureTime=""/>
     
<location number="2" locationType="DROP" name="!cup" address="Sanham Green Farm Cottages 1, Sanham Green, RG17 0RS, United Kingdom" latitude="51.399206" longitude="-1.516113"
planArrivalTime="20/05/2019 02:14" planDepartureTime="20/05/2019 03:57" factArrivalTime="" factDepartureTime="" planMileage="29.1" mileage="29.1" factMileage="" factDuration="" planDrivingTime="64" factDrivingTime="" planStopDuration="103" factStopDuration="" estimatedArrivalTime="" estimatedDepartureTime="" isVerified="false"/>
     
<location number="3"  locationType="DROP" name="Chilswell Lane, Oxford, England, OX1 5, GB" address="Chilswell Lane, Oxford, England, OX1 5, GB" latitude="51.726228" longitude="-1.286245" planArrivalTime="20/05/2019 04:45" planDepartureTime="20/05/2019 04:58" factArrivalTime="" factDepartureTime="" planMileage="50.1" mileage="50.1" factMileage=""
factDuration="" planDrivingTime="215" factDrivingTime="" planStopDuration="13" factStopDuration="" estimatedArrivalTime="" estimatedDepartureTime="">


<order  orderReference="mID5662073" orderId="5662073" status="ALLOCATED" task="DROP" duration="0" weight="0" volume="0">

<orderItem name="test" barcode="123456" status="NOT_CHECKED" costPerUnit="0" totalCost="0" quantity="0" actualQuantity="0"/>

<aggregatedItemsStatus actualDelivery="0" scheduledDelivery="1" completionStatus="NOT_DELIVERED" />   </order>     


</location>  

</run>


</vehicle>


</vehicles>


</scheduleResponse>


</apiResponse>

Отслеживание выдачи товаров

Anchor
Отслеживание выдачи товаров Отслеживание выдачи товаров

Для того, чтобы просмотреть товары на экране План-Факт, нажмите на иконку Image Added напротив запланированного заказа.

Image Added

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

Image Added

Статусы выдачи товаров

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

• Выполнен – товар был успешно доставлен;
• Не выполнен – товар не был доставлен;
• Добавлен исполнителем – к заказу добавлен новый товар;
• Частично – не все товары были доставлены и вручены покупателю.

Товары и их состояния выполнения можно увидеть в форме заказа, в путевом листе, в форме подтверждения доставки и в отчете о доставке товара. Также статусы товаров доступны в упомянутых методах API (см. выше).

Статусы выполнения заказов 

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

В зависимости от статуса товаров, заказ может принимать одно из трех конечных состояний:

• Не выполнен - ни один товар в составе заказ не был доставлен;
• Выполнен - все товары в составе заказа были успешно доставлены;
• Частично - товары в составе заказа были доставлены частично.

Их можно увидеть в отдельной колонке на экране План-Факт под названием Состояние выполненного заказа. 

Image Added

Для удобства поиска заказов по их статусу завершения в верхней части экрана План-Факт был добавлен дополнительный фильтр Состояние выполненного заказа.

Image Added

Примечание Данные возможности доступны лишь в том случае, если на вашем аккаунте подключена функциональность товаров. Для подключения этой функциональности, обратитесь в службу технической поддержки Максоптры.

Отмена получения товаров

Во время выполнения заказа некоторые товары могут быть не доставлены клиенту по той или иной причине. Эти причины представлены в новой вкладке Причины отмены товара на экране Настройки (доступна под ролью Администратора аккаунта).

Image Added

Подробнее см. в разделе Причины отмены товара.

Отчет о доставке товара

Информация о товарах и их статусах выполнения доступна для просмотра и анализа в Отчете о доставке товара.

Работа с товарами в мобильном приложении

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

Более подробное описани работы с товарами на мобильном приложении см. в разделах: 

Выполнение заказа. Сбор подписи. Фактическая стоимость. Работа с товарами (iOS)

Выполнение заказа. Сбор подписи. Работа с товарами. (Android)

...

См. также

Импoрт заказов. Параметры и требования к файлу импорта.

save

getOrderStatuses

getConsignment

Шаблон подтверждения доставки 

Шаблоны путевого листа

Причины отмены товара

Отчет о доставке товара

Выполнение заказа. Сбор подписи. Фактическая стоимость. Работа с товарами (iOS)

Выполнение заказа. Сбор подписи. Работа с товарами. (Android)