Меасофт - Вклад участника [ru]

Возврат

2022-06-02T12:52:14Z

Olga:

Механизм оформления возвратов используется для фиксации недоставленного товара, возврата товара после доставки покупателю или возврата заказа, а также для частичного возврата.

= Оформление частичного возврата =
[[Файл:Возврат.png|none|600px]]

Если покупатель забирает не все доставленные товары, то оформляется частичный возврат.

Если возвратный товар проходит по складу, то он автоматически становится на приход с типом «Возврат от покупателя». Запись об этом можно увидеть в карточке корреспонденции по кнопке '''Функции''' > '''История изменений'''.

Возврат товара на склад не оформляется в следующих случаях:
* возврат оформляется как брак;
* возврат оформляется после указания даты и времени вручения;
* в карточке номенклатуры не установлен [[Модуль складского учета#Карточка товара|флажок '''Возврат на склад''']].

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

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

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

Чтобы оформить возврат вручную:
# Откройте [[Карточка корреспонденции#Вложения|карточку отправления]] с возвращаемым товаром и на вкладке '''Вложения''' в контекстном меню товара выберите '''Возврат'''.
# В открывшемся окне выберите укажите следующие данные:
#* количество возвращаемых единиц товара;
#* причину возврата — список причин хранится в справочнике '''Справочники''' > '''Статусы''' > '''28 Причины частичных отказов'''.
#* местонахождение возврата — используется ручного оформления возврат, находящегося на руках у курьера или в филиале агента-партнера. Возможные значения: '''Текущий филиал''', '''Курьер''', '''Агент'''. Если оформить возврат с местоположением '''Агент''', то строка товара на вкладке '''Вложения''' отобразится синим шрифтом. Такой возврат нельзя подтвердить и добавить в [[АПК|акт возврата корреспонденции]]. Все неподтвержденные возвраты можно просмотреть с помощью отчета в главном пункте меню '''Отчеты''' > '''Корреспонденция''' > '''Неподтвержденные возвраты'''.

Если ведется учет товара по серийным номерам, введите серийный номер при оформлении возврата. Количество возвращаемого товара отобразится в поле «Возврат» соответствующей строки.

Курьер может оформить возврат через мобильное приложение. Строка такого возврата в карточке корреспонденции отображается зеленым шрифтом.

Возвраты, оформленные курьером, требуют подтверждения менеджера. Во время приема работы от курьера откроется новое окно для оформления возврата. После подтверждения возврата менеджер сможет поставить статус корреспонденции «Доставлено», а текст в поле с товаром окрасится в красный цвет.

Только подтвержденные возвраты попадают в акты возврата корреспонденции.

Цвет строк возвратных вложений в карточке корреспонденции:
* зеленый — возврат не подтвержден и находится на руках у курьера;
* красный — возврат подтвержден. Если возврат оформляет оператор в программе, то он по умолчанию уже подтвержден;
* фиолетовый — возврат был оформлен после того, как в корреспонденции проставили информацию о доставке (дату и время вручения).

Но в любом случае, зеленые возвраты лучше не ставить вручную, особенно если у курьера нормально работает приложение.

= Возврат на склад=

Если отправление было не доставлено в другом филиале, оно должно быть отправлено назад в филиал-создатель манифестом. Там его повторно принимают через форму приема (F10) или доску приема, после этого заказ отображается на вкладке '''Склад''' красным цветом. Его можно будет расформировать. Без приема в первоначальном филиале заказ на вкладке '''Склад''' отображаться не будет. Это поведение можно изменить переменной '''Справочники''' > '''Переменные''' > '''Склад''' > '''Упрощенный возврат корреспонденции на склад'''. Если она включена, для возвратной корреспонденции не нужно формировать манифест, при приеме в филиале-создателе автоматически проставляется статус '''Принято на склад'''.

Возврат

2022-06-01T15:05:35Z

Olga:

Механизм оформления возвратов используется для фиксации недоставленного товара, возврата товара после доставки покупателю или возврата заказа, а также для частичного возврата.

= Оформление частичного возврата =
[[Файл:Возврат.png|none|600px]]

Если покупатель забирает не все доставленные товары, то оформляется частичный возврат.

Если возвратный товар проходит по складу, то он автоматически становится на приход с типом «Возврат от покупателя». Запись об этом можно увидеть в карточке корреспонденции по кнопке '''Функции''' > '''История изменений'''.

Возврат товара на склад не оформляется в следующих случаях:
* возврат оформляется как брак;
* возврат оформляется после указания даты и времени вручения;
* в карточке номенклатуры не установлен [[Модуль складского учета#Карточка товара|флажок '''Возврат на склад''']].

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

Чтобы оформить возврат:
# Откройте [[Карточка корреспонденции#Вложения|карточку отправления]] с возвращаемым товаром и на вкладке '''Вложения''' в контекстном меню товара выберите '''Возврат'''.
# В открывшемся окне выберите укажите следующие данные:
#* количество возвращаемых единиц товара;
#* причину возврата — список причин хранится в справочнике '''Справочники''' > '''Статусы''' > '''28 Причины частичных отказов'''.
#* местонахождение возврата — используется ручного оформления возврат, находящегося на руках у курьера или в филиале агента-партнера. Возможные значения: '''Текущий филиал''', '''Курьер''', '''Агент'''. Если оформить возврат с местоположением '''Агент''', то строка товара на вкладке '''Вложения''' отобразится синим шрифтом. Такой возврат нельзя подтвердить и добавить в [[АПК|акт возврата корреспонденции]]. Все неподтвержденные возвраты можно просмотреть с помощью отчета в главном пункте меню '''Отчеты''' > '''Корреспонденция''' > '''Неподтвержденные возвраты'''.

Если ведется учет товара по серийным номерам, введите серийный номер при оформлении возврата. Количество возвращаемого товара отобразится в поле «Возврат» соответствующей строки.

Курьер может оформить возврат через мобильное приложение. Строка такого возврата в карточке корреспонденции отображается зеленым шрифтом.

Возвраты, оформленные курьером, требуют подтверждения менеджера. Во время приема работы от курьера откроется новое окно для оформления возврата. После подтверждения возврата менеджер сможет поставить статус корреспонденции «Доставлено», а текст в поле с товаром окрасится в красный цвет.

Только подтвержденные возвраты попадают в акты возврата корреспонденции.

Цвет строк возвратных вложений в карточке корреспонденции:
* зеленый — возврат не подтвержден и находится на руках у курьера;
* красный — возврат подтвержден. Если возврат оформляет оператор в программе, то он по умолчанию уже подтвержден;
* фиолетовый — возврат был оформлен после того, как в корреспонденции проставили информацию о доставке (дату и время вручения).

Но в любом случае, зеленые возвраты лучше не ставить вручную, особенно если у курьера нормально работает приложение.

API

2022-06-01T13:08:19Z

Olga: /* Описание элементов для оформления заказа */

<div style="font-size: 18px; color: #a92424; background-color: #ffdede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
'''Изменения для 54-ФЗ'''

Для передачи ставки НДС при оформлении заказа добавлен атрибут items > item > VATrate.

При использовании услуги кассового обслуживания необходимо в обязательном порядке передавать состав заказа со ставками НДС.

'''ВНИМАНИЕ'''

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

</div>

<div style="font-size: 24px; color: #2424a9; background-color: #deffde; border: 1px solid #ebccd1; padding: 3px 10px 10px; text-align: center">
'''English version is [[API Documentation|HERE!]]'''
</div>

Вы можете настроить интеграцию с MeaSoft средствами XML API по протоколу HTTP POST.

API предназначено для интеграции клиентов (интернет-магазинов и прочих компаний-заказчиков доставки) с [http://courierexe.ru/our_clients.htm курьерскими службами], работающими под управлением системы [https://curie.ru/ MeaSoft].

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

Если вы '''подрядчик''', вы можете забирать заказы, используя значение client=AGENT в запросе [[#Пример запроса статуса заказа|statusreq]], и передавать статусы заказов, используя метод [[#Изменение статуса агентом|setorderinfo]]. Также для интеграций с подрядчиками у нас есть специальная платформа, но добавлять подрядчиков в нее можно только на нашей стороне. Присылайте нам коммерческое предложение, описание вашего сервиса, и мы с радостью его рассмотрим.

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

Если у вас после прочтения документации остались вопросы, задайте их по почте [mailto:support@courierexe.ru support@courierexe.ru]. Обязательно представьтесь, напишите ваши контактные данные (телефон, скайп) и название компании, с которой вы хотите интегрироваться.

== Готовые интеграции ==
Для работы с популярными CMS и CRM-системами разработаны модули интеграции, перечисленные в таблице ниже.

'''Модули распространяются бесплатно, без гарантий со стороны разработчика''', и не являются средством полной автоматизации взаимодействия с курьерской службой. Модули — это помощь разработчикам интернет-магазинов в построении интеграции с курьерскими службами. '''Ответственность за корректность передачи данных лежит на интернет-магазине.'''

Сообщайте нам свои пожелания по работе наших модулей. Мы учтем их в новых версиях.

{| class="wikitable" align="center" style="width: 80%; margin: auto; background-color:#ffffff; border: 1px solid #999999;" cellpadding="10" cellspacing="0"
!style="width: 35%;"|Система управления контентом (CMS)
!style="width: 15%;"|Ссылка
!style="width: 35%;"|Примечание
|-
|[[Файл:bitrix.png|center|x44px]]
|style="text-align: center;" | [https://marketplace.1c-bitrix.ru/solutions/measoft.courier/ Установить] 
|Поддерживает версии 14.5 и выше. Подробнее см. [[1C-Битрикс|описание]].
|-
|[[Файл:prestashop.png|center|x60px]]
|style="text-align: center;"|[https://courierexe.ru/download/api/prestashop.zip Скачать]
|Поддерживает версии 1.5.2.0 и выше.
|-
|[[Файл:OpencartOCStore.png|center|x60px]]
|style="text-align: center;"|[https://courierexe.ru/download/api/opencart.zip Скачать для версии 1.5.5.1]<br>[https://courierexe.ru/download/api/measoft_oc2.ocmod.zip Скачать для версии 2.0]<br>[https://courierexe.ru/download/api/measoft_oc2.3.ocmod.zip Скачать для версии 2.3]<br>[https://courierexe.ru/download/api/measoft_ос3.ocmod.zip Скачать для версии 3.0]
|Поддерживает версии с 1.5.5.1.<br>Скачивайте модули для своей версии OpenCart.<br>Подробнее см. [[OpenCart|описание]].<br>[https://opencartforum.com/files/file/2906-avtomatizaciya-otpravki-i-otslezhivanie-dostavok-courierexe-dlya-opencart-15x/ Альтернативный модуль сторонних разработчиков]
|-
|[[Файл:webasyst-shopscript.png|center|x44px]]
|style="text-align: center;"|[https://www.webasyst.ru/store/plugin/shop/measoftcourier/ Установить модуль]<br>[https://www.webasyst.ru/store/plugin/shipping/measoftcourier/ Установить плагин]
|Модуль предназначен для отправки заявок в КС, а плагин для расчета стоимости доставки при оформлении заказа.
|-

|[[Файл:insales.png|center|x80px]]
|style="text-align: center;"|Настраивается в [[Личный кабинет клиента|ЛК пользователя]]
|[[InSales|Инструкция по настройке]]
|-
|[[Файл:Leadvertex.png|center|x44px]]
|style="text-align: center;"|[https://blog.leadvertex.ru/news/2110-integraciya-s-kurerkami-na-platforme-measoft Настраивается] в ЛК [https://Leadvertex.ru Leadvertex]
|[[LeadVertex|Инструкция по настройке]]<br>Модуль разработан и поддерживается компанией LeadVertex.
|-
|[[Файл:Retailcrm.png|center|x30px]]
|style="text-align: center;"|[https://www.retailcrm.ru/ RetailCRM]
|[[RetailCRM|Настраивается]] в ЛК пользователя в системе
|-
|[[Файл:1C.jpg|center|x44px]]
|style="text-align: center;"|-
|[https://infostart.ru/public/692790/ Альтернативный модуль сторонних разработчиков (1 версия)]

[https://infostart.ru/public/1531484/ Альтернативный модуль сторонних разработчиков (2 версия)]
|-
|[[Файл:Joomla2.jpg|center|x60px]]
|style="text-align: center;"|[https://courierexe.ru/download/api/com_measoft.zip Скачать]
|Работает только с компонентом Virtuemart.
|-
|[[Файл:Amocrm.png|center|x44px]]
|style="text-align: center;"|[https://www.amocrm.ru/extensions/courier2008 Установить]
|Подробнее см. [[amoCRM|описание]].
|-
|rowspan="2"|[[Файл:MoySclad.jpg|center|x30px]]
|style="height:50px; text-align: center;"|[https://home.courierexe.ru/moysklad/step1 Настроить интеграцию с MeaSoft]
|[[МойСклад|Инструкция]]
|-
|style="height:50px; text-align: center;"|[https://itmdev.ru/ms/shipping/ Скачать модуль сторонних разработчиков]
|Интеграция МойСклад с курьерскими службами от сторонних разработчиков
|-
|[[Файл:wordpress.jpg|center|x80px]]
|style="text-align: center;"|[https://courierexe.ru/download/api/wordpress.zip Скачать]
|[[Wordpress|Инструкция]]
|-
|[[Файл:Cscart.png|center|x60px]]
|style="text-align: center;"|[https://marketplace.cs-cart.com/measoft-en.html Установить]
|Поддерживает версии 4.10 и выше.<br>[[CS-Cart|Инструкция]]
|-
|style="height:100px; text-align: center;"|'''Webhook'''
|style="text-align: center;"|Читайте описание [[Webhook|на этой странице]]
|Передача информации о статусах и заказах в вашу систему
|-
|}

'''Обратите внимание!''' В модулях систем PrestaShop и Joomla для отправки заказа в курьерскую службу зайдите в карточку заказа. В карточке отображается специальная форма отправки заказа, а если заказ отправлен, она позволяет проверить его статус:[[Файл:Form.png|400 px|Форма отправки заказа|none]]

Для отображения списка пунктов выдачи есть [https://home.courierexe.ru/js/measoft_map.js JavaScript модуль]. Инструкция по использованию — внутри. Посмотреть пример работы можно [https://home.courierexe.ru/pvz_test.html здесь].

== Тестовый аккаунт ==
Для отладки зайдите в тестовый личный кабинет по адресу [https://home.courierexe.ru/8 https://home.courierexe.ru/8], логин: login пароль: pass.

На вкладке '''Интеграция''' > '''Отладка''' вы можете пробовать выполнять запросы к API для отладки, а также видеть историю отправленных запросов. Созданные заказы появятся в пункте основного меню '''Отслеживание'''.

Для упрощения интеграции можно скачать [https://courierexe.ru/download/api/php_sample.zip пример обращения к сервису на PHP].

== Рабочий аккаунт для подключения ==
Строка подключения выглядит следующим образом:

<source lang=xml>
<auth extra="8" login="login" pass="pass"></auth>
</source>

Описание параметров:
* '''extra''' — экстра-код, уникальный идентификатор компании, с которой вы интегрируетесь.
* '''login''' — логин клиента;
* '''pass''' — пароль клиента.

Запросите эти данные у курьерской службы, к которой вы подключаетесь. Курьерская служба передает временный пароль, его нужно сменить после первого входа в [[Личный кабинет клиента|ЛК клиента]].

== Авторизация курьерской службы ==
Если курьерской службе требуется подключение под своими учетным данными, используйте строку вида:

<source lang=xml>
<auth extra="8" login="login" pass="pass" clientcode="123"></auth>
</source>

Описание:
* '''extra''' — уникальный идентификатор компании;
* '''login''' — логин курьерской службы;
* '''pass''' — пароль курьерской службы;
* '''clientcode''' — внутренний код клиента (вкладка '''Клиенты''', столбец «Внутренний код»).

Вы можете узнать код экстра, логин и пароль курьерской службы в офисном приложении MeaSoft в справочнике '''Дополнительные возможности'''. Подробнее см. раздел «[[Личный кабинет курьерской службы#Подключение|Подключение]]».

== Общие понятия ==
На стороне курьерской службы имеется веб-сервис по адресу: https://home.courierexe.ru/api/. <rspoiler text="Еще есть порт 8443.">Некоторые маршрутизаторы, используемые провайдерами, РНК и прочее, в попытке глубокого анализа могут повреждать трафик на стандартный порт 443. Сделано по тикету 10964.</rspoiler> Обратите внимание на символ '''«/»''' (slash) в конце адреса.

Тестовые авторизационные данные: логин: login пароль: pass, параметр extra: 8. Обратите внимание, что тестовая площадка для всех одна. Не нужно передавать в нее заказы с конфиденциальными данными, их смогут увидеть другие участники.

Для использования интеграции в «боевом» режиме, запросите '''логин''', '''пароль''', и параметр '''extra''' у той компании, с которой интегрируетесь.

Вы можете отправлять тестовые запросы к нашему сервису и видеть историю отправленных запросов в личном кабинете на закладке '''Интеграция'''.

Клиент отправляет запросы к сервису методом HTTP POST, сервис обрабатывает запросы и возвращает результат выполнения. Все запросы и ответы передаются в формате XML.
Кодировка — UTF-8. Разделитель целой и дробной частей чисел — используется символ точки. Даты представляются в виде YYYY-MM-DD, время — HH:MM.

В силу [https://ru.wikipedia.org/wiki/XML#.D0.A0.D0.B5.D1.88.D0.B5.D0.BD.D0.B8.D0.B5_.D0.BF.D1.80.D0.BE.D0.B1.D0.BB.D0.B5.D0.BC.D1.8B_.D0.BD.D0.B5.D0.BE.D0.B4.D0.BD.D0.BE.D0.B7.D0.BD.D0.B0.D1.87.D0.BD.D0.BE.D1.81.D1.82.D0.B8_.D1.80.D0.B0.D0.B7.D0.BC.D0.B5.D1.82.D0.BA.D0.B8 особенностей языка XML], некоторые символы в тексте должны быть заменены: & на &amp; < на &lt; > на &gt; " на &quot;

Наше API принципиально работает только по HTTPS, так как передает конфиденциальные данные. В некоторых системах с этим возникают проблемы. Если ваша система не может полноценно работать с шифрованием, мы рекомендуем развернуть http-сервер у себя локально, установить [http://courierexe.ru/download/api/proxy.zip прокси на PHP]. <spoiler text="Как запустить">Для теста можете запустить его на сервере следующей командой: php -S <IP>:8080 proxy.php
где <IP> — это адрес вашего сервера, а 8080 порт, на котором будут приниматься запросы.
Тогда для обмена данными с нашим АПИ необходимо будет использовать адрес <IP>:8080</spoiler>
Доступность функций, описанных в этом разделе, зависит от [[Личный кабинет курьерской службы#Функции личного кабинета|тарифа вашего личного кабинета]].

== Ограничения ==
С целью защиты от нецелевого использования сервисов и DDoS-атак действуют следующие ограничения:
* 30 запросов tracking с одного IP-адреса за 1 минуту (используйте statusreq!);
* 150 запросов с одного IP-адреса/акаунта за 1 минуту;
* 1500 запросов с одного IP-адреса/акаунта за 20 минут;
* 3000 запросов с одного аккаунта за 1 час;
* 200 Мб скачанных текстовых данных за 3 часа.
* Превышение количества запросов статусов несуществующих заказов над существующими

В случае превышения IP-адрес или аккаунт блокируется на время до 3-х часов.

Чтобы не происходило блокировок:
* не нужно «бомбить» наше API запросами статусов, последовательно перебирая номера всех ваших заказов, особенно запросами «tracking», они предназначены не для этого (смотрите описание). Особенно ровно в 00 минут каждого часа;
* не нужно каждые 5 минут делать запросы «Покажите статусы всех заказов за последние 3 месяца»;
* для проверки статусов заказов лучше всего использовать запросы [[#Передача только изменившихся статусов|измененных статусов changes=ONLY_LAST]];
* при запросе измененных статусов ОБЯЗАТЕЛЬНО нужно подтверждать успешное получение запросом [[#Передача только изменившихся статусов|commitlaststatus]].
* вы должны знать номера заказов, которые вы отправили. Не нужно перебирать номера всех заказов или брутфорсом перебирать все возможные номера.

Мы абсолютно уверены, что данные ограничения на порядки превосходят необходимые объемы предоставления сервиса для решения любых задач. Если у вас возникают проблемы, вы не знаете, как уложиться в эти рамки — спросите у нас, мы обязательно поможем!

== Оформление заказа ==

=== Пример оформления заказа ===
<source lang=xml>
<?xml version="1.0" encoding="UTF-8"?>
<neworder newfolder="NO">
<auth extra="8" login="login" pass="pass"></auth>
<order orderno="111111">
<barcode>111111</barcode>
<sender>
<company>МВД</company>
<person>Иванов И.И.</person>
<phone>123-45-67</phone>
<town>Санкт-Петербург</town>
<address>Петровка 38 офис 35</address>
<date>2014-03-22</date>
<time_min>09:00</time_min>
<time_max>14:00</time_max>
</sender>
<receiver>
<company>МВД</company>
<person>Чип & Дейл</person>
<phone>123-45-67</phone>
<zipcode>125480</zipcode>
<town regioncode="78" country="RU">Санкт-Петербург</town>
<address>Петровка 38 офис 35</address>
<pvz>124</pvz>
<inn>1112223335</inn>
<date>2014-03-22</date>
<time_min>09:00</time_min>
<time_max>14:00</time_max>
<deliveryPIN>1234</deliveryPIN>
<coords lat="55.680327" lon="37.604456"></coords>
</receiver>
<return>NO</return>
<weight>5.1</weight>
<return_weight>5.1</return_weight>
<quantity>2</quantity>
<paytype>CASH</paytype>
<service>2</service>
<return_service>1</return_service>
<type>3</type>
<return_type>3</return_type>
<courier>22</courier>
<price>387.5</price>
<deliveryprice VATrate="20">150</deliveryprice>
<inshprice>387.5</inshprice>
<receiverpays>NO</receiverpays>
<discount>120</discount>
<enclosure>Детские игрушки</enclosure>
<instruction>Проверить при покупателе, подписать акт</instruction>
<department>Отдел</department>
<pickup>NO</pickup>
<acceptpartially>NO</acceptpartially>
<costcode>cc12345</costcode>
<respstore>4</respstore>
<items>
<item extcode="abc123" quantity="1" mass="0.2" retprice="37.5" VATrate="0" barcode="2345625213125" textArticle="1" article="1" volume="3" origincountry="AUT" GTD="321546654" excise="15.20" suppcompany="ООО "Рога и копыта"" suppphone="79161234567" suppINN="1112223334" governmentCode="11223311">Мяч</item>
<item extcode="abc124" quantity="2" mass="2" retprice="100" inshprice="100" VATrate="10" barcode="4645625213138" article="2" length="10" width="20" height="30" origincountry="004">Обруч</item>
<item extcode="abc125" quantity="3" mass="0.3" retprice="50" inshprice="50" barcode="2345625213126" itemcode="44123" article="3" type="1">Погремушка желтая</item>
</items>
<packages>
<package strbarcode="ORD0000001" mass="1" message="" quantity="3"></package>
<package strbarcode="ORD0000002" mass="2.5" message="" length="10" width="20" height="30"></package>
</packages>
<deliveryset above_price="100" return_price="1000" VATrate="10">
<below below_sum="500" price="500" />
<below below_sum="2000" price="300" />
</deliveryset>
<advprices>
<advprice>
<code>1</code>
<value>123</value>
</advprice>
<advprice>
<code>2</code>
<value>10.5</value>
</advprice>
<advprice>
<code>3</code>
<value>true</value>
</advprice>
</advprices>
<overall_volume>81</overall_volume>
<userid>user123</userid>
<groupid>customer</groupid>
</order>
</neworder>
</source>

=== Описание элементов для оформления заказа ===
'''Обязательные поля'''

Обязательными на уровне системы являются только 3 поля: receiver->company или receiver->person, receiver->address и receiver->phone. Так же в настройках системы сама курьерская служба может назначить какие-то дополнительные поля обязательными, тогда, если вы их не укажете, получите сообщение об ошибке.
<spoiler text="Пример минимально возможного заказа">
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<neworder>
<auth extra="8" login="login" pass="pass" />
<order>
<receiver>
<company>МВД</company>
<phone>(495)123-45-67</phone>
<address>Петровка, 38</address>
</receiver>
</order>
</neworder>
</source>
</spoiler>

'''Описание полей'''

* '''neworder''' — Корневой контейнер, обязательный элемент.

:* '''''newfolder''''' — Признак нового заказа YES/NO. Если стоит YES, то в системе курьерской службы для данной корреспонденции создастся новый заказ. Необязательный элемент.

* '''order''' — Контейнер для описания одного заказа, обязательный элемент. В одном контейнере '''neworder''' может быть много контейнеров '''order''' для создания нескольких заказов одним запросом.

:* '''''orderno''''' — Номер заказа. Если присваивается клиентом — указывается здесь. Если не присваивается — можно оставить пустым, система сгенерирует свой номер, и вернет его в ответе. Система проверяет наличие заказов с указанным номером в пределах текущего календарного года, и в случае их существования — заказ создан не будет, а в ответе вернется ошибка 17 «Such number exists». Если не указан штрихкод (поле barcode), и значение поля подходит для использования его в качестве штрихкода, данное значение будет скопировано в поле «Штрихкод». Это накладывает ограничения в частности, на длину указанного поля (25 знаков, чтобы работали стандартные печатные формы).

* '''barcode''' — Штрихкод заказа. Если клиент штрихкодирует свои отправления и штрихкод отличается от номера заказа, в этом поле указывается штрихкод. В случае наличия нескольких мест и раздельной их маркировки в этом поле допустимы маски в виде символов подчеркивания, говорящие о позициях штрихкода, переменных для разных мест в рамках одного заказа.<br>
''Например'': В заказе номер 123 имеется 20 товарных вложений, которые упакованы в 3 транспортных места. Клиент формирует 3 штрихкода на транспортные места: CLNT0012301, CLNT0012302, CLNT0012303, где CLNT — префикс клиента, 00123 — номер заказа, 01-03 — номер транспортного места в заказе. В поле barcode нужно указать CLNT00123__ (система поймет, что 2 последних символа могут быть любыми и будут отражать штрихкоды к одному заказу). Если вы не сами печатаете накладные с указанным штрихкодом, то указанный штрихкод не должен быть длиннее 25 знаков, иначе он не поместится на стандартных печатных формах.

* '''sender''' — Информация о отправителе заказа. Необязательный контейнер.
<source lang="xml">
<sender>
<company>Название компании отправителя</company>
<person>Контактное лицо отправителя</person>
<phone>Телефон, Email отправителя</phone>
<town>Город отправителя в формате "Москва город"</town>
<address>Адрес отправителя</address>
<date>Дата забора в формате "YYYY-MM-DD"</date>
<time_min>Желаемое время забора в формате "HH:MM"</time_min>
<time_max>Желаемое время забора в формате "HH:MM"</time_max>
</sender>
</source>

* '''receiver''' — Информация о получателе заказа. Обязательный контейнер.
<source lang="xml">
<receiver>
<company>Название компании получателя</company>
<person>Контактное лицо получателя</person>
<phone>Телефон, Email получателя</phone>
<town regioncode="Код региона">Город получателя в формате "Москва город"</town>
<address>Адрес получателя</address>
<inn>ИНН получателя</inn>
<pvz>Код пункта самовывоза по справочнику</pvz>
<date>Дата доставки в формате "YYYY-MM-DD"</date>
<time_min>Желаемое время доставки в формате "HH:MM"</time_min>
<time_max>Желаемое время доставки в формате "HH:MM"</time_max>
<deliveryPIN>Пин-код для подтверждения получателем</deliveryPIN>
<coords lat="55.680327" lon="37.604456"></coords>
</receiver>
</source>

* '''company''' — Компания-получатель.
* '''person''' — Контактное лицо. ''Должно быть заполнено хотя бы одно из полей — company или person!''
* '''phone''' — Телефон. Можно указывать несколько телефонов, E-mail в этом поле.
* '''town''' — Город.
* '''pvz''' — Код пункта самовывоза по справочнику. Кроме того, ПВЗ можно указать в строке '''''address''''' в виде:
:* код ПВЗ в нашей системе
:* код ПВЗ в системе подрядчика
:* наименование ПВЗ в виде строки "ПВЗ " + «Наименование ПВЗ»

Для тега города '''town''' можно указать код региона в атрибуте '''''regioncode''''' из [[#Справочник регионов|справочника регионов]]. Поиск будет производиться в указанном регионе.

Также можно указать страну получателя в атрибуте '''''country''''' в соответствии с [https://ru.wikipedia.org/wiki/ISO_3166-1 стандартом ISO_3166-1], например, «RU», «RUS» или «643» для России.

Кроме того, поиск города осуществляется с учетом почтового индекса, указанного в теге '''zipcode'''.

Поле '''Город''' контейнеров '''sender''' и '''receiver''' можно указать одним из следующих способов:
:* код населенного пункта из [[#Справочник городов|справочника городов]]
:* 13-ти значный код адресного классификатора КЛАДР
:* 36-ти значный код адресной системы <rspoiler text="ФИАС">Федеральная информационная адресная система — единый российский государственный адресный реестр</rspoiler> (AOID)
:* название города (не рекомендуется!)

* '''coords''' — Координаты получателя. Если не указаны, система будет геокодировать самостоятельно.

* '''paytype''' — Тип оплаты заказа получателем. Принимает значения:
:* CASH — Наличными при получении (по-умолчанию)
:* CARD — Картой при получении
:* NO — Без оплаты. Этот тип оплаты передается, если заказ уже оплачен и не требует инкассации. API добавит к товарам строку предоплаты в сумму заказа, чтобы общая сумма была 0, однако в кассовом чеке будут все товары с ценами, и оплата предоплатой, как того требует 54-ФЗ.
:* OTHER — Прочее (Предусмотрен для того, чтобы оплата поступала непосредственно в курьерскую службу посредством прочих типов оплаты — таких как: вебмани, яденьги, картой на сайте, прочие платежные системы и т. д.)
:* OPTION — На выбор получателя. Этот тип оплаты нельзя передавать с заказом. Он выставляется автоматически в зависимости от настройки клиента.

* '''zipcode''' — Почтовый индекс.
* '''weight''' — Общий вес заказа в килограммах.
* '''return_weight''' — Общий вес возврата заказа в килограммах.
* '''quantity''' — Количество мест.
* '''service''' — Режим доставки (тип услуги) передается код из справочника «[[#Справочник Видов срочности|Виды срочности]]».
* '''return_service''' — Режим возврата (тип услуги) передается код из справочника «Виды срочности».
* '''type''' — Тип корреспонденции (отправления) передается код из справочника «Типы корреспонденции».
* '''return_type''' — Тип возвратной корреспонденции (отправления) передается код из справочника «Типы корреспонденции».
* '''price''' — Сумма заказа. В случае наличия контейнера items значение этого параметра будет проигнорировано и рассчитано автоматически.
* '''deliveryprice''' — Сумма доставки. В случае наличия контейнера items в него будет добавлено вложение «Доставка».
:* '''''VATrate''''' — Ставка НДС — целое число процентов.
* '''return''' — Признак необходимости возврата.
* '''return_service''' — Режим возврата (тип услуги) передается код из справочника «Виды срочности».
* '''discount''' — Сумма скидки. Скидка «размазывается» по товарным вложениям, сумма НП уменьшается на сумму скидки. При этом вложение Скидка не создается. ВНИМАНИЕ, при использовании этого тега общая сумма может расходиться на копейки из-за округления! Старайтесь не использовать этот тег, а указывать цену товаров уже с учетом скидок.
* '''enclosure''' — Вложение.
* '''inshprice''' — Объявленная ценность. Если явно не указана сумма — автоматически считается как сумма по товарам.
* '''instruction''' — Поручение — Примечание.
* '''courier''' — Запланированный курьер. Согласно коду курьера в КС2008.
* '''receiverpays''' — Признак оплаты стоимости доставки — услуг службы доставки получателем, а не заказчиком YES/NO.
* '''department''' — Подразделение, в котором оформляется заказ.
* '''pickup''' — Признак оформления забора YES/NO. Если стоит YES, то весь заказ считается заданием на забор груза, а не на доставку! Применяется для вызова курьера к отправителю для забора других отправлений. ''Внимание!'' при добавлении в забор складских товаров, их тип '''''type''''' всегда должен быть установлен как [7] Забор товара, если будет указан другой тип, то он будет исправлен в момент добавления заказа на [7] Забор товара
* '''acceptpartially''' — Признак возможности частичного выкупа товаров отправления YES/NO.

* '''items''' — Контейнер для описания вложений. <rspoiler text="Необязательный контейнер">Если для поставщика товара в системе MeaSoft не указаны полное наименование компании и ИНН в карточке клиента, заполните параметры <code>suppcompany</code> и <code>suppINN</code> в этом контейнере. Отсутствие информации о поставщике приведет к [[Настройка модуля печати кассовых чеков#Ошибка фискализации (ошибка программирования реквизита 1226)|ошибке фискализации]].</rspoiler>. Атрибуты:
:* '''''item''''' — Название вложения.
:* '''''quantity''''' — Количество единиц товара.
:* '''''mass''''' — Масса единицы товара в килограммах.
:* '''''volume''''' — Объемный вес единицы товара в килограммах. При указании объемного веса значение подставляется вместо массы
:* '''''length''''' — Длина единицы товара (в сантиметрах).
:* '''''width''''' — Ширина единицы товара (в сантиметрах).
:* '''''height''''' — Высота единицы товара (в сантиметрах).
:* '''''retprice''''' — Цена единицы товара. Округляется до копеек. Должна быть с учетом всех скидок и наценок. Для вложений типов 1, 2, 3 не может быть отрицательной. 
:* '''''inshprice''''' — Объявленная ценность единицы товара. Округляется до копеек. Если не указана принимается равной '''''retprice'''''.
:* '''''VATrate''''' — Ставка НДС — целое число процентов. Если значение не указано, подставляется значение «20». Значение «0» означает ставку «Без НДС», ставка «0%» на данный момент не поддерживается.
:* '''''barcode''''' — Штрихкод вложения.
:* '''''article''''' — Артикул вложения. ''Внимание!'' Указание артикула используется только тогда, когда товар хранится на ответственном хранении в службе доставки, и необходима комплектация. В этом случае система пытается привязать товар к [[API#Справочник номенклатуры|справочнику номенклатуры]]. Если товар в справочнике не найден — система выдаст соответствующую ошибку. Если по артикулу найдено несколько товаров — система выберет один из них случайным образом, что может привести к ошибочной комплектации! Если товар НЕ на ответственном хранении — артикул указывать НЕ нужно. Позиция попадет в систему просто текстом.
:* '''''itemcode''''' — Внутренний код товара, может использоваться вместо артикула. ''Внимание!'' Указание кода товара используется только тогда, когда товар хранится на ответственном хранении в службе доставки, и необходима комплектация. В этом случае система пытается привязать товар к [[API#Справочник номенклатуры|справочнику номенклатуры]]. Если товар в справочнике не найден — система выдаст соответствующую ошибку. Если товар НЕ на ответственном хранении — код товара указывать НЕ нужно.
:* '''''type''''' — Тип вложения. Принимает значения:
:: 1 — Товар. По-умолчанию.
:: 2 — Доставка. Такое вложение добавится автоматически, если заполнить order->deliveryprice
:: 3 — Услуга
:: 4 — Предоплата. Указывается сумма. Поле quantity игнорируется, всегда «1». В заказе сумма будет отрицательной независимо от знака в запросе. Такое вложение добавится автоматически при указании order->paytype=NO.
:: 6 — Оплата кредитом. Указывается сумма. Поле quantity игнорируется, всегда «1». В заказе сумма будет отрицательной независимо от знака в запросе.
:: 7 — Забор товара. Если товар нужно у получателя забрать, возможно — вернуть деньги, или его стоимость вычтется из суммы других товаров. У такого товара в заказе будет отрицательное количество независимо от знака в запросе.
:* '''''extcode''''' — Внешний код строки. Используется для идентификации строк заказов при получении статусов. Необязательное поле.
:* '''''origincountry''''' — Код страны-производителя в соответствии со [https://ru.wikipedia.org/wiki/ISO_3166-1 стандартом ISO_3166-1], например, «RU», «RUS» или «643» для России.
:* '''''GTD''''' — Номер ГТД.
:* '''''excise''''' — Сумма акциза.
:* '''''suppcompany''''' — Наименование компании поставщика, если отличается от заказчика.
:* '''''suppphone''''' — Номер телефона компании поставщика, если отличается от заказчика.
:* '''''suppINN''''' — ИНН компании поставщика, если отличается от заказчика.
:* '''''governmentCode''''' — Код товарной номенклатуры. Используется для [[Маркировка|маркированных товаров («Честный знак»)]]. Нужно указывать все данные из нанесенного QR-кода кроме не читаемых символов (#29). Если код не известен — укажите знак вопроса «?», тогда курьер отсканирует код фактически передаваемого покупателю товара. Для некоторых процессов может использоваться значение «!» — в этом случае курьер сканирует серийный номер товара, но это не считается кодом маркировки. Если поле заполнено — поле quantity должно содержать только «1», иначе вернется ошибка.

* '''packages''' — Контейнер для описания мест. Необязательный контейнер. Атрибуты:
:* '''''package''''' — Название места.
:* '''''code''''' — Внутренний код строки.
:* '''''strbarcode''''' — Штрихкод места.
:* '''''mass''''' — Масса места в килограммах.
:* '''''message''''' — Строка сообщения.
:* '''''length''''' — Длина товарного места (в сантиметрах).
:* '''''width''''' — Ширина товарного места (в сантиметрах).
:* '''''height''''' — Высота товарного места (в сантиметрах).
:* '''''quantity''''' — Количество мест с данным набором параметров. Действует ограничение на общее количество мест в заказе. Общее количество мест в заказе не может быть больше 1000.

* '''deliveryset''' — настройка [[Дифференцированная стоимость доставки|дифференцированной стоимости доставки]]. Атрибуты:
:* '''''above_price''''' — стоимость в случае полного выкупа заказа (действует как «сумма от» последней границы, указанной в теге below_sum)
:* '''''return_price''''' — стоимость в случае возврата заказа
:* '''''VATrate''''' — Ставка НДС — целое число процентов.

* '''below''' — граница стоимости настроек
:* '''''below_sum''''' — граница стоимости выкупаемого заказа
:* '''''price''''' — стоимость выкупаемого заказа до соответствующей границы

* '''advprices''' — Контейнер для описания дополнительных услуг. Необязательный элемент. <span style="color: red;>Для обработки в API включите дополнительные услуги в настройках полей [[Личный кабинет курьерской службы#Настройка личного кабинета клиента|заказов и заборов]]</span>
:* '''''code''''' — код услуги.
:* '''''value''''' — значение услуги. Если тип услуги bool, то в значении передаем true.

* '''costcode''' — Кост-код сотрудника.
* '''respstore''' — Код ответственного филиала.

* '''overall_volume''' — Общий объем, м3. Виртуальное поле. Необязательное. Из этого поля рассчитывается длина/высота/ширина места. Расчет срабатывает только если в каждом месте есть нулевые значения длины или высоты или ширины.

* '''userid''' — Идентификатор пользователя, строковый или числовой тип. Виртуальное поле. Необязательное. Данное поле используется совместно с настройками «Цена доставки для получателя», определяя приоритет правила. Можно использовать в различных CMS/CRM системах, настраивая цены для определенного покупателя.

* '''groupid''' — Идентификатор группы пользователя, строковый или числовой тип. Виртуальное поле. Необязательное. Данное поле используется совместно с настройками «Цена доставки для получателя», определяя приоритет правила. Можно использовать в различных CMS/CRM системах, настраивая цены для определенной группы покупателей.

<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
'''Обратите внимание!'''
При передаче заказов, у которых плановая дата доставки/забора меньше ближайшей возможной, дата автоматически меняется на самую раннюю возможную. [[Личный кабинет курьерской службы#Как считается минимальная дата возможной доставки|Подробнее]]</div>

В случае необходимости указания, помимо товаров, дополнительных услуг (например, ДОСТАВКА, комплектация, подъем на этаж и т. д.) — их нужно указать в том же контейнере items как товары, без артикула.

=== Примеры ответов ===
При успешном выполнении запроса, создании заказа, возвращается сумма заказа в атрибуте orderprice, а также ошибка 0. При не успешном — номер ошибки и текст ее на английском языке в атрибуте errormsg, для некоторых ошибок выводится перевод на русский в атрибуте errormsgru.
В атрибут orderno помещается номер заказа, в атрибут barcode — штрихкод заказа.

'''Пример успешного ответа'''

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<neworder>
<createorder orderno="AB23541" barcode="67567#114" error="0" errormsg="Success" errormsgru="Успешно" orderprice="5000" />
<createorder orderno="AB23542" barcode="67567#115" error="0" errormsg="Success" errormsgru="Успешно" orderprice="6000" />
<createorder orderno="AB23543" barcode="67567#116" error="0" errormsg="Success" errormsgru="Успешно" orderprice="0" />
</neworder>
</source>

'''Пример ответа с ошибкой'''

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<neworder>
<createorder orderno="AB23541" barcode="67567#114" error="67" errormsg="Order barcode already exists in the database." errormsgru="Такой штрихкод заказа уже есть в базе." />
<createorder orderno="AB23542" barcode="67567#115" error="17" errormsg="Order number already exists in the database." errormsgru="Такой номер заказа уже есть в базе." />
<createorder orderno="AB23543" barcode="67567#116" error="67" errormsg="Order barcode already exists in the database." errormsgru="Такой штрихкод заказа уже есть в базе." />
</neworder>
</source>

'''Пример ответа при ошибке авторизации'''

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<request>
<error error="1" errormsg="authorization error"></error>
</request>
</source>

'''Пример ответа при ошибке синтаксиса'''

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<request>
<error>column:1 line:11 message:expected '>'</error>
</request>
</source>

=== Коды и описание ошибок ===
{|class=wikitable
!Код ошибки
!Английское описание
!Русское описание
|-
|0||Success||Успешно
|-
|1||Wrong XML||Некорректный файл XML.
|-
|2||Lat is empty||Укажите широту.
|-
|3||Specify a valid «Price» field value.||Укажите корректное значение поля «Сумма».
|-
|4||Specify a valid «Weight» field value.||Укажите корректное значение поля «Вес».
|-
|5||Recepient city/town not found.||Город назначения не найден.
|-
|6||Sender city/town not found.||Город отправления не найден.
|-
|7||Specify the «Recipient address» field value.||Укажите значение поля «Адрес получателя».
|-
|8||Specify the «Recipient phone» field value.||Укажите значение поля «Телефон получателя».
|-
|9||Specify the «Recipient name» field value.||Укажите значение поля «ФИО получателя».
|-
|10||Specify a valid «Quantity» field value.||Укажите корректное значение поля «Количество».
|-
|11||Specify a valid «Declared value» field value.||Укажите корректное значение поля «Объявленная ценность».
|-
|12||Supplier SKU ID not found.||Артикул не найден.
|-
|17||Order number already exists in the database.||Такой номер заказа уже есть в базе.
|-
|18||Order code already exists in the database.||Такой код заказа уже есть в базе.
|-
|19||The delivery date format is not valid. Specify a date in YYYY-MM-DD format.||Укажите значение поля «Дата доставки» в формате гггг-мм-дд.
|-
|20||Specify a valid «Delivery mode» field value.||Укажите корректное значение поля «Режим доставки».
|-
|21||Specify a valid «Return trip mode» field value.||Укажите корректное значение поля «Режим возврата».
|-
|22||Specify a valid «Delivery type» field value.||Укажите корректное значение поля «Тип доставки».
|-
|23||Specify a valid «Return shipment type» field value.||Укажите корректное значение поля «Тип возврата».
|-
|30||Specify the «Order number» field value.||Укажите значение поля «Номер заказа».
|-
|31||Specify the «Barcode» field value.||Укажите значение поля «Штрихкод».
|-
|32||Specify the «Sender company» field value.||Укажите значение поля «Компания-отправитель».
|-
|33||Specify the «Sender name» field value.||Укажите значение поля «ФИО отправителя».
|-
|34||Specify the «Sender phone» field value.||Укажите значение поля «Телефон отправителя».
|-
|35||Specify the «Sender city/town» field value.||Укажите значение поля «Город отправителя».
|-
|36||Specify the «Sender address» field value.||Укажите значение поля «Адрес отправителя».
|-
|37||Specify the «Pickup date» field value.||Укажите значение поля «Дата забора».
|-
|38||Specify the «Pickup time from» field value.||Укажите значение поля «Время забора с».
|-
|39||Specify the «Pickup time to» field value.||Укажите значение поля «Время забора до».
|-
|40||Specify the «Recipient company» field value.||Укажите значение поля «Компания-получатель».
|-
|41||Specify the «Recipient name» field value.||Укажите значение поля «ФИО получателя».
|-
|42||Specify the «Recipient phone» field value.||Укажите значение поля «Телефон получателя».
|-
|43||Specify the «Recipient city/town» field value.||Укажите значение поля «Город получателя».
|-
|44||Specify the «Recipient address» field value.||Укажите значение поля «Адрес получателя».
|-
|45||Specify the «Delivery date» field value.||Укажите значение поля «Дата доставки».
|-
|46||Specify the «Delivery time from» field value.||Укажите значение поля «Время доставки с».
|-
|47||Specify the «Delivery time to» field value.||Укажите значение поля «Время доставки до».
|-
|48||Specify the «Recipient postcode» field value.||Укажите значение поля «Индекс получателя».
|-
|49||Specify the «Weight» field value.||Укажите значение поля «Вес».
|-
|50||Specify the «Payment type» field value.||Укажите значение поля «Тип оплаты».
|-
|51||Specify the «Quantity» field value.||Укажите значение поля «Количество».
|-
|52||Specify the «Amount» field value.||Укажите значение поля «Сумма».
|-
|53||Specify the «Declared value» field value.||Укажите значение поля «Объявленная стоимость».
|-
|54||Specify the «Description» field value.||Укажите значение поля «Описание».
|-
|55||Specify the «Instruction» field value.||Укажите значение поля «Поручение».
|-
|56||Specify the «Delivery mode» field value.||Укажите значение поля «Режим доставки».
|-
|57||Specify the «Shipment type» field value.||Укажите значение поля «Тип отправления».
|-
|58||Specify whether return trip is required.||Укажите значение поля «Необходимость возврата».
|-
|59||Specify the «Return trip mode» field value.||Укажите значение поля «Режим возврата»
|-
|60||Specify the «Return shipment type» field value.||Укажите значение поля «Тип возврата».
|-
|61||Specify barcode.||Укажите штрихкод.
|-
|62||Specify item weight.||Укажите массу единицы товара.
|-
|63||Specify item quantity.||Укажите количество товара.
|-
|64||Specify item price.||Укажите цену единицы товара.
|-
|65||Specify item name.||Укажите название товара.
|-
|66||Wrong XLS file||Некорректный файл XLS.
|-
|67||Order barcode already exists in the database.||Такой штрихкод заказа уже есть в базе.
|-
|68||Select the «Payment by recipient» field value.||Укажите значение поля «Оплата получателем».
|-
|69||Specify department.||Укажите отдел.
|-
|70||Specify service partner code.||Укажите значение поля «Код подрядчика».
|-
|71||Date cannot be earlier than tomorrow.||Дата не может быть раньше чем завтра.
|-
|72||Date cannot be later than 15 days from now.||Дата не может быть позже чем через 15 дней.
|-
|73||Date cannot be earlier than today.||Дата не может быть раньше чем сегодня.
|-
|74||Date cannot be later than {0} days from now.||Дата не может быть позже, чем через {0} дней.
|-
|75||Specify a valid «Item weight» field value.||Укажите корректное значение поля «Масса единицы товара».
|-
|76||Specify a valid «Quantity» field value.||Укажите корректное значение поля «Количество товара».
|-
|77||Specify a valid «Item price» field value.||Укажите корректное значение поля «Цена единицы товара».
|-
|78||Specify a valid «Delivery time from» field value.||Укажите корректное значение поля «Время доставки с».
|-
|79||Specify a valid «Delivery time to» field value.||Укажите корректное значение поля «Время доставки до».
|-
|80||Specify a valid «Pickup time from» field value.||Укажите корректное значение поля «Время забора с».
|-
|81||Specify a valid «Pickup time to» field value.||Укажите корректное значение поля «Время забора до».
|-
|82||Specify a valid «Pickup point» field value.||Укажите корректное значение поля «ПВЗ».
|-
|83||Duplicate number in the registry.||Дублирование номера в реестре.
|-
|84||Duplicate barcode in the registry.||Дублирование штрихкода в реестре.
|-
|85||Specify a valid «Weight at return trip» field value.||Укажите корректное значение поля «Вес возврата».
|-
|86||Specify the «Weight at return trip» field value.||Укажите значение поля «Вес возврата».
|-
|87||Order weight exceeds the allowed maximum for the pickup point.||Вес превышает допустимое значение для этого ПВЗ.
|-
|88||Pickup date cannot be earlier than today.||Дата забора не может быть раньше чем сегодня.
|-
|89||Specify a later delivery date.||Укажите более позднюю дату доставки.
|-
|90||Inappropriate «Weight» or «Pay type» field value for the selected city or town. Please review and correct the values.||Значение поля «Масса» или «Тип оплаты» для выбранного города указано некорректно или отсутствует. Проверьте значения и исправьте.
|-
|91||{deliverytype} {deliverydate} is {holidaytype}. Select another date.||{deliverytype} {deliverydate} является {holidaytype}. Выберите другую дату.
|-
|92||{deliverytype} {deliverydate} is {holidaytype}. Select another date.||{deliverytype} {deliverydate} является {holidaytype}. Выберите другую дату.
|-
|93||Add items.||Добавьте товары.
|-
|95||The selected pickup point only allows paid orders.||Выбранный ПВЗ выдает только предоплаченные заказы.
|-
|96||Order barcode exceeds the allowed maximum (25) symbols.||Длина штрихкода заказа превышает максимально допустимую (25 символов).
|-
|97||The pickup date format is not valid. Specify a date in YYYY-MM-DD format.||Укажите значение поля «Дата забора» в формате гггг-мм-дд.
|-
|98||Specify the cost code.||Укажите значение поля «Кост-код».
|-
|99||The item is not in stock.||Товар отсутствует на складе.
|-
|100||Set the quantity of the item marked with Chestny ZNAK to one.||Укажите количество товара, маркированного кодом «Честный ЗНАК», равным единице.
|-
|101||Quantity of item Delivery cannot be greater than 1||Количество вложений типа «Доставка» не может быть более 1.
|-
|102||А database error occurred. Please try later again.||Ошибка базы данных. Попробуйте позже.
|-
|103||Order not found.||Заказ не найден.
|-
|104||Cannot edit order in the current status.||Невозможно изменить заказ в текущем статусе.
|-
|105||Discount cannot be greater than the order amount. Specify a smaller value.||Размер скидки не может превышать сумму заказа. Укажите меньшее значение скидки.
|-
|106||Specify the correct additional service code.||Укажите корректный код дополнительной услуги.
|-
|107||Specify the correct additional service name.||Укажите корректное значение поля [advprice][value].
|-
|108||Specify the «Additional services» field value.||Укажите значение поля «Дополнительные услуги».
|-
|110||Specify the correct TIN.||Укажите корректный ИНН.
|-
|111||Specify the correct IIN (KZ).||Укажите корректный ИИН (КЗ).
|-
|112||Specify the overall volume.||Укажите общий объем.
|-
|113||Cannot apply the delivery mode. Select another delivery mode.||Режим доставки не подходит для заказа. Выберите другой режим.
|-
|114||The pickup point does not support the selected delivery mode. Specify another pickup point.||ПВЗ не подходит для выбранного режима доставки. Укажите другой ПВЗ.
|-
|115||Specify a valid recipient phone number.||Укажите корректный телефон получателя.
|-
|116||Specify recipient PIN code.||Укажите пин-код получателя.
|-
|117||Order date cannot be earlier than {0}. Specify another date.||Дата заказа не может быть раньше {0}. Укажите другую дату.
|-
|118||Pickup date cannot be earlier than {0}. Specify another date.||Дата забора не может быть раньше {0}. Укажите другую дату.
|-
|119||Specify the correct item type.||Укажите корректный тип вложения.
|-
|120||The pickup point does not accept payment by card.||В выбранном ПВЗ оплата картой не принимается.
|-
|121||Invalid item code format||Неверный формат кода товарной номенклатуры
|-
|}

== Запрос статуса заказов ==

=== Пример запроса статуса заказа ===
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<statusreq>
<auth extra="8" login="login" pass="pass"></auth>
<client>CLIENT</client>
<orderno>1234</orderno>
<orderno2>5678</orderno2>
<ordercode>34234</ordercode>
<givencode>234534</givencode>
<datefrom>2016-07-21</datefrom>
<dateto>2016-07-21</dateto>
<target>Автозавод</target>
<done>ONLY_NOT_DONE</done>
<changes>ONLY_LAST</changes>
<conditions>
<namecontains/>
<namestarts/>
</conditions>
</statusreq>
</source>

=== Описание полей запроса статуса ===
'''statusreq''' — Корневой контейнер. Обязательный элемент.
* '''auth''' — Авторизация. Обязательный элемент.
* '''client''' — Признак клиента или агента. Необязательный элемент.
:* CLIENT — Признак клиента, значение по умолчанию
:* AGENT — Признак агента. В ответ отдается информация по заказам, переданным агенту на доставку
* '''orderno''' — Номер заказа. Необязательный элемент.
* '''ordercode''' — Внутренний код заказа. Необязательный элемент.
* '''orderno2''' — Номер заказа из срочных. Необязательный элемент.
* '''datefrom''' — Дата заказа «с». Необязательный элемент.
* '''dateto''' — Дата заказа «по». Необязательный элемент.
* '''target''' — Строка поиска. Позволяет указать текст, который содержится в названии компании или адресе получателя.
* '''done''' — Может принимать значения:
:* ONLY_DONE — Только доставленные (имеются в виду успешные статусы, например, '''Доставлен''' или '''Частично доставлен''')
:* ONLY_NOT_DONE — Только не доставленные (заказы, которые не являются доставленными, например, '''Не доставлен''' или '''Утерян''')
:* ONLY_NEW — Только новые
:* ONLY_DELIVERY — Только заказы в обработке — заказы, находящиеся в любом статусе, кроме конечных: Доставлено, Не доставлено, Отменён и т. д.
:* ''Пусто'' — все корреспонденции

* '''changes''' — может принимать значение только ONLY_LAST. Если указан этот параметр, все остальные игнорируются. Описание данного режима приведено здесь: [[#Передача только изменившихся статусов|Передача только изменившихся статусов]]

* '''conditions''' — Задает условия фильтрации по «orderno». Все вложенные элементы одновременно накладывают условие «И». Минимум 5 символов!
:* '''namecontains''' — Поиск по номеру заказа(шифр), который содержит «orderno».
:* '''namestarts''' — Поиск по номеру заказа(шифр), который начинается с «orderno».

<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
'''Обратите внимание!'''
# Периода запроса статусов (контейнеры '''datefrom''' и '''dateto''') ограничивается двумя месяцами — два месяца до даты '''«по»'''.
# Если не указаны обе даты — '''dateto''' принимается равной текущей дате.
# Если не указана дата '''dateto''' — она принимается равной '''datefrom''' плюс 2 месяца.
# Если не указана дата '''datefrom''' — она принимается равной '''dateto''' минус 2 месяца.
# Поиск по '''conditions''' работает только для «Номер заказа(шифр)» и только от 4 символов
</div>
<br>

=== Примеры ответов ===
'''Пример успешного ответа'''

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<statusreq count="23">
<order orderno="111111" awb="qwerty" orderno2="123123" ordercode="34534234" givencode="2345334">
<barcode>111111</barcode>
<sender>
<company>МВД</company>
<person>Иванов И.И.</person>
<phone>123-45-67</phone>
<contacts>
<phone>+74951234567</phone>
</contacts>
<town code="23432">Санкт-Петербург</town>
<address>Петровка 38 офис 35</address>
<date>2014-03-22</date>
<time_min>09:00</time_min>
<time_max>14:00</time_max>
</sender>
<receiver>
<company>МВД</company>
<person>Иванов И.И.</person>
<phone>123-45-67 - Иван (916)234.45.21 Петр,mvd@mail.ru</phone>
<contacts>
<phone>+74951234567</phone>
<phone>+79162344521</phone>
<email>mvd@mail.ru</email>
</contacts>
<inn>1112223335</inn>
<zipcode>125480</zipcode>
<town code="153361" regioncode="78" regionname="Санкт-Петербург город">Санкт-Петербург город</town>
<address>Петровка 38 офис 35</address>
<pvz>
<code>126</code>
<clientcode>QWERTY</clientcode>
</pvz>
<date>2014-03-22</date>
<time_min>09:00</time_min>
<time_max>14:00</time_max>
<coords lat="55.680327" lon="37.604456"></coords>
<deliveryPIN>1234</deliveryPIN>
</receiver>
<pickup>NO</pickup>
<weight>5.1</weight>
<return_weight>5.1</return_weight>
<quantity>2</quantity>
<paytype>CASH</paytype>
<service>2</service>
<return_service>2</service>
<type>3</type>
<return_type>3</return_type>
<waittime>12</waittime>
<price>387.5</price>
<print_check>YES</print_check>
<inshprice>387.5</inshprice>
<enclosure>Детские игрушки</enclosure>
<instruction>Проверить при покупателе, подписать акт</instruction>
<currcoords lat="55.680327" lon="37.604456" accuracy="50" RequestDateTime="2014-04-21 18:07:45"></currcoords>
<courier>
<code>26</code>
<name>Иванов Владимир Петрович</name>
<phone>+79161234567</phone>
</courier>
<deliveryprice total="158.6" delivery="100.00" return="58.6">
<advprice code="1" price="150">База</advprice>
<advprice code="2" price="0">% от объявленной стоимости</advprice>
<advprice code="3" price="8.6">Топливный сбор</advprice>
<advprice code="4" price="0">Округление</advprice>
</deliveryprice>
<receiverpays>NO</receiverpays>
<acceptpartially>NO</acceptpartially>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 17:22:00" createtimegmt="2016-06-03 16:14:44" message="" title="Доставлен">COMPLETE</status>
<statushistory>
<status eventstore="Офис в Москве" eventtime="2016-05-30 10:20:00" createtimegmt="2016-06-03 16:14:44" message="" title="Новый">NEW</status>
<status eventstore="Офис в Москве" eventtime="2016-06-01 17:38:00" createtimegmt="2016-06-03 16:14:44" message="филиал в Санкт-Петербурге" title="Планируется отправка">DEPARTURING</status>
<status eventstore="Офис в Москве" eventtime="2016-06-01 19:53:00" createtimegmt="2016-06-03 16:14:44" message="филиал в Санкт-Петербурге" title="Отправлено со склада">DEPARTURE</status>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 07:41:00" createtimegmt="2016-06-03 16:14:44" message="" title="Получен складом">ACCEPTED</status>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 09:17:00" createtimegmt="2016-06-03 16:14:44" message="" title="Выдан курьеру на доставку">DELIVERY</status>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 17:22:00" createtimegmt="2016-06-03 16:14:44" message="" title="Доставлен (предварительно)">COURIERDELIVERED</status>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 17:22:00" createtimegmt="2016-06-03 16:14:44" message="" title="Доставлен">COMPLETE</status>
</statushistory>
<customstatecode>2<customstatecode>
<clientstatecode></clientstatecode>
<costcode>cc12345</costcode>
<receipt fdNum="124555" fnSn="9289000100295555" kktNum="0001611984048555" inn="7722756555" fdValue="2899551555" summ="387.5" ofdUrl="gate.ofd.ru">https://ofd.ru/rec/7722756555/0001611984048555/9289000100295555/124555/2899551555</receipt>
<deliveredto>Иванова, секр.</deliveredto>
<delivereddate>2016-06-02</delivereddate>
<deliveredtime>17:22</deliveredtime>
<arrival>2016-05-02 23:21</arrival>
<outstrbarcode>EXT123456</outstrbarcode>
<partner>Офис на Ленина</partner>
<return_message>Доставлено в целости</return_message>
<department>Отдел</department>
<items>
<item code="34533" extcode="abc123" quantity="1" mass="0.2" retprice="37.5" VATrate="0" barcode="2345625213125" article="1" returns="0" origincountry="040" GTD="" excise="0.00" governmentCode="11223311" suppcompany="Поставщик" suppINN="1112223334" suppphone="79161234567">Мяч</item>
<item code="34456" extcode="abc124" quantity="2" mass="2" retprice="100" VATrate="10" barcode="4645625213138" article="2" returns="0" governmentCode="">Обруч</item>
<item code="34421" extcode="abc125" quantity="3" mass="0.3" retprice="50" VATrate="18" barcode="2345625213126" itemcode="44123" article="3" returns="0" governmentCode="">Погремушка желтая</item>
</items>
<packages>
<package code="33331" strbarcode="ORD0000001" mass="1" message="" got="YES"></package>
<package code="33332" strbarcode="ORD0000002" mass="2.5" message="" got="NO"></package>
</packages>
</order>
</statusreq>
</source>

'''Пример ответа если нет заказов'''

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<statusreq count="0">
</statusreq>
</source>

'''Пример ответа при ошибке авторизации'''

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<request>
<error error="1" errormsg="authorization error"></error>
</request>
</source>

'''Пример ответа при ошибке синтаксиса'''

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<request>
<error>column:1 line:11 message:expected '>'</error>
</request>
</source>

=== Описание полей ответа статусов ===
Все поля ответа соответствуют структуре order при создании заказа, с некоторыми добавлениями:

* Атрибуты контейнера '''order''':
:* '''''awb''''' — Номер накладной в системе курьерской службы.
:* '''''orderno2''''' — Номер накладной в подсистеме срочной доставки курьерской службы.
:* '''''ordercode''''' — внутренний код заказа в системе, применяется для некоторых внутренних операций.
:* '''''givencode''''' — внутренний код заказа в системе, применяется для некоторых внутренних операций.

* атрибут '''''code''''' контейнера '''item''' — внутренний код строки заказа в системе, применяется для некоторых внутренних операций.
:* '''''returns''''' — количество данного товара, от которого отказался получатель. Не нулевое только в случае частичного отказа.

* атрибут '''''got''''' контейнера '''package''' — признак принятого места YES / NO.
:* '''''returns''''' — количество данного товара, от которого отказался получатель. Не нулевое только в случае частичного отказа.

* '''''coords''''' в контейнере '''receiver''' — координаты получателя.
* '''''deliveryPIN''''' в контейнере '''receiver''' — Пин-код.
* '''pickup''' — признак оформления забора, возможные значения: '''YES''', '''NO'''. Если указано '''YES''', то весь заказ считается заданием на забор груза, а не на доставку.
* '''currcoords''' — текущие координаты заказа. Атрибуты:
:* '''''lat''''' — широта
:* '''''lon''''' — долгота
:* '''''accuracy''''' — точность в метрах
:* '''''RequestDateTime''''' — дата/время последнего обновления координат.

* '''courier''' — Данные курьера, которому выдан заказ. Если заказ не выдан, то выводятся данные запланированного курьера.
* '''waittime ''' — Время ожидания курьера.
* '''deliveryprice''' — Стоимость услуг в валюте расчетов с клиентом. Атрибуты:
:* '''''total''''' — общая стоимость услуг
:* '''''delivery''''' — стоимость доставки «Туда»
:* '''''return''''' — стоимость доставки «Обратно» (если order->return=YES)
Тэг '''deliveryprice''' включает список дополнительных услуг (только для тарифа «Премиум»):
:* '''''advprice''''' — наименование дополнительной услуги
:* '''''code''''' — код дополнительной услуги
:* '''''price''''' — стоимость дополнительной услуги

* '''status''' — статус доставки (список статусов см. ниже). Атрибуты (заполняются начиная с версии системы 2008.0.0.670):
:* '''''eventstore''''' — филиал, к которому относится текущий статус
:* '''''eventtime''''' — время события по часовому поясу места его наступления.
:* '''''createtimegmt''''' — время по GMT создания записи о смене статуса в БД. Используется для сортировки записей, чтобы соблюсти хронологическую последовательность. <spoiler text="Подробнее">Большинство событий фиксируются в полях eventtime и createtimegmt на основании одного действия, тогда они отличаются только сдвигом от GMT. Однако, если курьер доставил отправление 10.10.2010 в 20:00, по какой-то причине не внес это в мобильное приложение, на следующий день сдал накладную, и в 9 утра оператор внесла, что он доставил вчера в 20:00. Тогда в createtimegmt будет сегодня 6 утра (для Москвы), а в eventtime — вчера в 20:00. При этом оператор по каким-то причинам может внести время вручения раньше, чем какое-то предыдущее событие, т.о. нарушится последовательность времени в eventtime, но при сортировке по createtimegmt все-равно все будет правильно.</spoiler>
:* '''''message''''' — наименование филиала-получателя, при передаче между филиалами
:* '''''title''''' — русское наименование статуса

* '''statushistory''' — история статусов доставки. Содержит список контейнеров '''status'''. Заполняется только для тарифа «Премиум» начиная с версии системы 2008.0.0.670.
* '''customstatecode''' — код внутреннего статуса курьерской службы. Значения уточняйте в курьерской службе. Назначаются курьерской службой в разделе «Справочники» — «Статусы» — «15 Статусы корреспонденции». Справочник не передается через API клиенту по причине возможного наличия в нем внутренних технологических статусов курьерской службы.
* '''clientstatecode''' — код статуса клиента. Используется, если клиент предлагает свои коды статусов доставки/причин недоставки.
* '''deliveredto''' — данные из поля «Инфо. о доставке» (может быть информация о доставке, причина недоставки и т. п.).
* '''delivereddate''' — дата вручения.
* '''deliveredtime''' — время вручения. В случае недоставки может быть пустым.
* '''arrival''' — плановая дата прибытия в формате гггг-мм-дд чч: мм: сс
* '''outstrbarcode''' — код у подрядчика (код заказа во внешней системе). Используется в интеграциях с внешними системами.
* '''partner''' — текущий филиал/подрядчик.
* '''return_message''' — информация о возврате
* '''department''' — Подразделение, в котором оформляется заказ.

Контейнер '''status''' может принимать следующие значения:
: AWAITING_SYNC — Ожидает синхронизации. Данные заказа пока не появились в службе доставки.
: '''NEW''' — Успешно создан, передан в службу доставки.
: NEWPICKUP — Создан забор.
: PICKUP — Забран у отправителя.
: WMSASSEMBLED — Скомплектован на складе фулфилмента.
: WMSDISASSEMBLED — Разукомплектован на склад фулфилмента.
: '''ACCEPTED''' — Получен складом.
: CUSTOMSPROCESS — Производится таможенный контроль.
: CUSTOMSFINISHED — Таможенный контроль произведен.
: CONFIRM — Согласована доставка.
: UNCONFIRM — Не удалось согласовать доставку.
: DEPARTURING — Планируется отправка со склада на другой склад.
: DEPARTURE — Отправлено со склада на другой склад.
: INVENTORY — Инвентаризация. Убедились в наличии отправления на складе.
: PICKUPREADY — Готов к выдаче в ПВЗ.
: '''DELIVERY''' — Выдан курьеру на доставку.
: COURIERDELIVERED — Доставлен (предварительно, ождает подтверждения менеджером, чтобы перейти в статус COMPLETE).
: COURIERPARTIALLY — Частично доставлен (предварительно, ождает подтверждения менеджером, чтобы перейти в статус PARTIALLY).
: COURIERCANCELED — Отказ (предварительно, после этого ожидается COURIERRETURN).
: COURIERRETURN — Возвращено курьером. Курьер не смог доставить до получателя и вернул заказ обратно на склад. Это промежуточный статус, после которого менеджер выясняет, нужно ли повторно доставлять (статусы DATECHANGE/DELIVERY) или это окончательная недоставка (CANCELED).
: DATECHANGE — Перенос даты доставки.

: '''COMPLETE''' — Доставлен.
: '''PARTIALLY''' — Доставлен частично.
: '''CANCELED''' — Не доставлен (Возврат/Отмена). После этого статуса отправление должны вернуть заказчику, будут статусы RETURNING и RETURNED

: RETURNING — Планируется возврат заказчику (после CANCELED).
: RETURNED — Возвращен заказчику.
: LOST — Утрачен/утерян.

'''Примечание.''' В будущем возможно дополнение используемого набора статусов.

<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
'''Обратите внимание!'''

# Контейнер '''statushistory''' и '''deliveryprice''' заполняется для тарифов [[Личный кабинет курьерской службы#Функции личного кабинета|Премиум и Максимум]].
# Система никогда не гарантирует последовательность прохождения заказом набора статусов. То есть Вы можете получить статус «COMPLETE», а следующим запросом — «NEW» — такое может произойти, например, если оператор ошибочно отметил заказ выполненным, а затем исправил ошибку.
</div>
<br>

=== Передача только изменившихся статусов ===
В нашем API предусмотрено удобное средство получения статусов всех заказов, без необходимости «бомбить» сервер запросами статусов по каждому заказу. Работает это так: раз, например, в 10 минут, вы посылаете запрос «покажите все изменившиеся статусы». Пример запроса ниже. Система вам отдает ВСЕ заказы, статусы (или некоторые другие поля, см. ниже) которых изменились с момента последнего запроса. Вы разбираете полученный документ, по каждому заказу сохраняете его актуальный статус в своей системе, и если все хорошо, у вас все получилось, ваша система неожиданно не упала от наплыва информации, посылаете нам запрос подтверждения получения статусов (commitlaststatus). Мы у себя отмечаем, что эти статусы вами получены и их не надо передавать повторно. Таким образом, сколько бы заказов у вас ни было, статусы по ним всем почти в реальном времени вы можете получать всего двумя запросами.

Для получения только изменившихся статусов отправьте запрос:
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<statusreq>
<auth extra="8" login="login" pass="pass"></auth>
<changes>ONLY_LAST</changes>
<streamid>1234</streamid>
</statusreq>
</source>

Система выдает все заказы, в которых с момента последнего запроса в этом режиме изменилось хотя бы одно из полей:
orderno
status
delivereddate
deliveredtime
deliveredto
receiver->date
receiver->address
price

После успешной обработки ответа необходимо отметить полученные статусы успешно полученными, отправив запрос:
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<commitlaststatus>
<auth extra="8" login="login" pass="pass"></auth>
<client>CLIENT</client>
<streamid>1234</streamid>
</commitlaststatus>
</source>

'''Описание полей запроса'''

* '''auth''' — авторизация. Обязательный элемент.
* '''streamid''' — идентификатор потока. Если у вас несколько интеграций и каждая нуждается в получении статусов, вы можете передавать данный параметр и тем самым разделять получение и отметку об успешном получении статусов по заказам. Значение должно входить в промежуток от 100 до 10000, включительно. Необязательный элемент.
* '''client''' — признак клиента или агента. Необязательный элемент.
:* CLIENT — признак клиента, значение по умолчанию
:* AGENT — признак агента. В ответ отдается информация по заказам, переданным агенту на доставку

В случае успеха вы получите ответ:
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<commitlaststatus error="0">OK</commitlaststatus>
</source>

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

<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
# При этом способе передачи (<changes>ONLY_LAST</changes>) система просматривает заказы, оформленные за последние 3 месяца. Если заказ сделан ранее, изменение статуса по нему не попадет в результат выполнения запроса.
# Система всегда выдает текущий статус. Вы можете одним запросом получить статус «NEW», а следующим — «COMPLETE». Между запросами отправление могло пройти через несколько промежуточных статусов. Если нужна гарантия получения всех промежуточных статусов, нужно анализировать блок statushistory (может не заполняться вследствие ограничений версии или тарифа конкретной службы доставки).
# Система не гарантирует последовательность прохождения заказом набора статусов. Вы можете получить статус «COMPLETE», а следующим запросом «NEW» — такое может произойти, например, если оператор ошибочно отметил заказ выполненным, а затем исправил ошибку.
</div>
<br>

== Трекинг заказа по номеру ==
Запрос трекинга по номеру предназначен для выдачи минимальной обезличенной информации о конкретном заказе не авторизованному пользователю. Наша система имеет для этого интерфейс по адресу «home.courierexe.ru/{код экстра}/tracking». Вы можете либо сделать ссылку на такую страницу на своем сайте, либо разместить ее iframe’ом у себя, либо сделать свою и пользоваться нашим API. Этот интерфейс создан специально для выдачи информации живому пользователю сайта. Для получения статусов заказов в свою информационную систему нужно использовать запрос «statusreq», желательно с параметром changes=ONLY_LAST!

'''Пример запроса:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<tracking>
<extra>8</extra>
<orderno>1234</orderno>
</tracking>
</source>

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<tracking>
<order orderno="111111">
<barcode>111111</barcode>
<AWB>111111</AWB>
<sender>
<town code="1" country="RU">Москва город</town>
<date>2014-03-22</date>
<time_min>09:00</time_min>
<time_max>14:00</time_max>
</sender>
<receiver>
<town code="1" country="RU">Москва город</town>
<zipcode>125480</zipcode>
<date>2014-03-22</date>
<time_min>09:00</time_min>
<time_max>14:00</time_max>
</receiver>
<price>387.5</price>
<inshprice>387.5</inshprice>
<paytype>CASH</paytype>
<weight>5.1</weight>
<quantity>2</quantity>
<service>2</service>
<type>3</type>
<return>NO</return>
<return_service>2</return_service>
<return_date></return_date>
<return_time></return_time>
<return_message></return_message>
<waittime>12</waittime>
<enclosure>Детские игрушки</enclosure>
<instruction>Проверить при покупателе, подписать акт</instruction>
<deliveryprice total="158.6" delivery="100.00" return="58.6" />
<courier>
<code>26</code>
<name>Иванов Владимир Петрович</name>
<phone>+79161234567</phone>
</courier>
<currcoords lat="55.680327" lon="37.604456" accuracy="50" RequestDateTime="2014-04-21 18:07:45" />
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 17:22:00" createtimegmt="2016-06-03 16:14:44" message="" title="Доставлен">COMPLETE</status>
<statushistory>
<status eventstore="Офис в Москве" eventtime="2016-05-30 10:20:00" createtimegmt="2016-06-03 16:14:44" message="" title="Новый">NEW</status>
<status eventstore="Офис в Москве" eventtime="2016-06-01 17:38:00" createtimegmt="2016-06-03 16:14:44" message="филиал в Санкт-Петербурге" title="Планируется отправка">DEPARTURING</status>
<status eventstore="Офис в Москве" eventtime="2016-06-01 19:53:00" createtimegmt="2016-06-03 16:14:44" message="филиал в Санкт-Петербурге" title="Отправлено со склада">DEPARTURE</status>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 07:41:00" createtimegmt="2016-06-03 16:14:44" message="" title="Получен складом">ACCEPTED</status>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 09:17:00" createtimegmt="2016-06-03 16:14:44" message="" title="Выдан курьеру на доставку">DELIVERY</status>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 17:22:00" createtimegmt="2016-06-03 16:14:44" message="" title="Доставлен (предварительно)">COURIERDELIVERED</status>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 17:22:00" createtimegmt="2016-06-03 16:14:44" message="" title="Доставлен">COMPLETE</status>
</statushistory>
<deliveredto>Иванова, секр.</deliveredto>
<delivereddate>2016-06-02</delivereddate>
<deliveredtime>17:22</deliveredtime>
<outstrbarcode>EXT123456</outstrbarcode>
<items>
<item code="34533" extcode="abc123" quantity="1" mass="0.2" retprice="37.5" VATrate="0" barcode="2345625213125" article="1" returns="0" origincountry="040" GTD="" excise="0.00" governmentCode="11223311" suppcompany="Поставщик" suppINN="1112223334" suppphone="79161234567">Мяч</item>
<item code="34456" extcode="abc124" quantity="2" mass="2" retprice="100" VATrate="10" barcode="4645625213138" article="2" returns="0" governmentCode="">Обруч</item>
<item code="34421" extcode="abc125" quantity="3" mass="0.3" retprice="50" VATrate="18" barcode="2345625213126" article="3" returns="0" governmentCode="">Погремушка желтая</item>
</items>
</order>
</tracking>
</source>

'''Получение информации в формате 17 TRACK'''

'''Пример запроса:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<tracking17>
<extra>8</extra>
<orderno>1234</orderno>
</tracking17>
</source>

'''Пример ответа:'''
<pre>{
"number":"ExtNumber",
"oriNumber":"1234",
"oriCountry":"RU",
"destCountry":"RU",
"status":"Complete",
"events":[
{
"time":"2016-06-02 17:22:00",
"location":"RU",
"content":"Complete"
},
{
"time":"2016-06-02 17:22:00",
"location":"RU",
"content":"Courierdelivered"
},
{
"time":"2016-06-02 09:17:00",
"location":"RU",
"content":"Delivery"
},
{
"time":"2016-06-02 07:41:00",
"location":"RU",
"content":"Accepted"
},
{
"time":"2016-06-01 19:53:00",
"location":"RU",
"content":"Departure"
},
{
"time":"2016-06-01 17:38:00",
"location":"RU",
"content":"Departuring"
},
{
"time":"2016-05-30 10:20:00",
"location":"RU",
"content":"New"
}
]
}</pre>

Функция ищет последний заказ по номеру среди заказов всех клиентов. Выдает неперсонализированную информацию о текущем состоянии заказа.<br>
Описание контейнеров ответа аналогично описанию [[API#.D0.97.D0.B0.D0.BF.D1.80.D0.BE.D1.81 .D1.81.D1.82.D0.B0.D1.82.D1.83.D1.81.D0.B0 .D0.B7.D0.B0.D0.BA.D0.B0.D0.B7.D0.BE.D0.B2|Запроса статусов заказов]].

== Изменение заказа ==
Запрос предназначен для изменения заказов, по которым не было произведено изменений статуса корреспонденции, времени доставки — то есть заказов, которые ещё не в работе.

Изменять заказы могут курьерские службы с тарифами «Премиум» и «Максимум». Чтобы разрешить изменение заказов, в личном кабинете курьерской службы перейдите в '''Параметры''' > '''Расширенные''' и установите флажок '''Разрешить отмену и изменение заказов'''.

<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
'''Обратите внимание!'''
# Данные запроса изменения указываются '''полностью''', как если бы заказ создавался впервые.
# При отсутствии вложения в запросе изменения данное вложение '''не удаляется''' из заказа, но его количество становится равным 0.
# При одновременном изменении заказа в API и системе курьерской службы приоритет отдается данным системы курьерской службы. То есть изменения в API приняты не будут.
</div>

При редактировании заказа может быть отменен запланированный курьер. Это зависит от значения переменной '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Автоматически устанавливать заплан. курьера по району''':
* '''Нет''' — при редактировании заказа по АПИ курьер не изменяется;
* '''Район''' — если изменен адрес доставки, курьер сбрасывается;
* '''Район или дата план. доставки''' — если изменен адрес доставки или плановая дата вручения, курьер сбрасывается.

=== Описание полей запроса изменения ===
Все поля запроса соответствуют структуре order при создании заказа за исключением:
* вместо корневого тэга '''neworder''' указывается '''editorder''';
* тэг штрихкода '''barcode''' не указывается, поскольку присваивается при создании заказа;
* тэг курьера '''courier''' можно изменить только при включенной настройке '''Разрешить изменение курьера по АПИ''';
* для вложений '''item''' указывается внутренний код вложения в атрибуте '''code''', который можно получить при получении статуса заказа.

Значение '''orderno''' данным методом изменить нельзя.

=== Описание полей ответа изменения ===
Все поля ответа соответствуют ответу при создании заказа за исключением корневого тэга — вместо '''neworder''' возвращается '''editorder'''.

== Отмена заказа ==
Запрос предназначен для отмены заказов, по которым не было произведено изменений статуса доставки, статуса корреспонденции, времени доставки, то есть заказов, которые ещё не в работе.

Отменять заказы могут курьерские службы с тарифами «Премиум» и «Максимум». Чтобы разрешить отмену заказов, в личном кабинете курьерской службы перейдите в '''Параметры''' > '''Расширенные''' и установите флажок '''Разрешить отмену и изменение заказов'''.

При отмене заказа поле «Инфо о доставке» получает значение «Отменено заказчиком», поле «Дата доставки» — текущую дату, а «Вручил курьер» — системную запись «ОТМЕНА».

'''Пример запроса отмены заказа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<cancelorder>
<auth extra="8" login="login" pass="pass" />
<order orderno="" ordercode="123456" />
<order orderno="123aaa" ordercode="" />
</cancelorder>
</source>

'''Описание полей:'''

'''cancelorder''' — Корневой контейнер. Обязательный элемент.
* '''auth''' — Авторизация. Обязательный элемент.
* '''order''' — Контейнер отменяемого заказа. Обязательный элемент. Запрос может содержать более одного контейнера '''order'''. Атрибуты:
:* '''''orderno''''' — Шифр заказа.
:* '''''ordercode''''' — Внутренний код заказа.
Обратите внимание, что должен быть указан хотя бы один из атрибутов ''orderno'' или ''ordercode''!

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<cancelorder>
<order orderno="123test" ordercode="123456" error="0" errormsg="OK" errormsgru="Успешно" />
<order orderno="123aaa" ordercode="" error="52" errormsg="order not found" errormsgru="Заказ не найден" />
</cancelorder>
</source>

== Добавление вложений к накладной ==
'''Пример запроса:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<addattachments>
<auth extra="8" login="login" pass="pass" />
<orderno>1234567</orderno>
<attachments>
<item name="photo1.jpg">JVBERi0xLjMN1wb25lbnQgMQ
JUBQREYwMTIzNDU2Nzg5IDI NMyAwIG9iag08PA0vVHlwZSA
U3VidHlwZSAvSW1hZ2UNL1d pZHRoIDE4MDgNL0hlaWdodCA
ggNCAwIFINL0JpdHNQZXJDb 21wb25lbnQgMQ0vRGVjb2RlU
ENL0NvbHVtbnMgMTgwOA0+P g0vSW1hZ2VNYXNrIHRydWUNL
XhEZWNvZGUNPj4Nc3RyZWFt DQ</item>
<item name="photo2.jpg">VBERi0xLjMNAwIG9iag0HRoJ
JUBQREYwMTIzNDU2Nzg5IDI NMyAwIG9iag08PA0vVHlwZSA
vWE9iamVjdA0vU3VidHlwZS AvSW1hZ2UNL1dpZHRoIDEzNj
gNL0hlaWdodCAxMzMzDS9MZ W5ndGggNCAwIFINL0JpdHNQZ
XJDb21wb25lbnQgMQ0vRGVj b2RlUGFybXMgPDwNL0sgLTEN
L0NvbHVtbnMgMTM2OA0+Pg0 vSW</item>
</attachments>
</addattachments>
</source>

'''Описание полей:'''

'''addattachments''' — Корневой контейнер. Обязательный элемент.
* '''auth''' — Авторизация. Обязательный элемент.
* '''orderno''' — Номер заказа. Обязательный элемент. Может использоваться тэг <ordercode> с указанием внутреннего кода заказа.
* '''attachments''' — Обязательный элемент, в котором перечисляются передаваемые данные файлов.
** '''item''' — Бинарные данные (файл), закодированные в base64. Обязательный элемент.
*** '''name''' — Атрибут элемента '''item''', в котором передается имя файла. Обязательный элемент.

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<addattachments>
<attachments>
<item name="photo1.jpg" error="0" errormsg="OK" errormsgru="Успешно" />
<item name="photo2.jpg" error="0" errormsg="OK" errormsgru="Успешно" />
</attachments>
</addattachments>
</source>

== Получение вложений к накладной ==
'''Пример запроса:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<attachments>
<auth extra="8" login="login" pass="pass" />
<orderno>1234567</orderno>
</attachments>
</source>

'''Описание полей:'''

'''attachments''' — Корневой контейнер. Обязательный элемент.
* '''auth''' — Авторизация. Обязательный элемент.
* '''orderno''' — Номер/код заказа. Обязательный элемент.

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<attachments>
<item name="doc1.docx" size="35654">JVBERi0xLjMN
JUBQREYwMTIzNDU2Nzg5IDI NMyAwIG9iag08PA0vVHlwZSA
U3VidHlwZSAvSW1hZ2UNL1d pZHRoIDE4MDgNL0hlaWdodCA
ggNCAwIFINL0JpdHNQZXJDb 21wb25lbnQgMQ0vRGVjb2RlU
ENL0NvbHVtbnMgMTgwOA0+P g0vSW1hZ2VNYXNrIHRydWUNL
XhEZWNvZGUNPj4Nc3RyZWFt DQ</item>
<item name="photo2.jpg" size="74861">VBERi0xLjMN
JUBQREYwMTIzNDU2Nzg5IDI NMyAwIG9iag08PA0vVHlwZSA
vWE9iamVjdA0vU3VidHlwZS AvSW1hZ2UNL1dpZHRoIDEzNj
gNL0hlaWdodCAxMzMzDS9MZ W5ndGggNCAwIFINL0JpdHNQZ
XJDb21wb25lbnQgMQ0vRGVj b2RlUGFybXMgPDwNL0sgLTEN
L0NvbHVtbnMgMTM2OA0+Pg0 vSW</item>
</attachments>
</source>

В тегах item возвращаются бинарные данные (файлы), закодированные в base64.

== Изменение статуса агентом ==
Запрос изменения статуса заказа позволяет установить окончательный статус заказа — «Доставлен» или «Не доставлен (Возврат/Отмена)».

Кроме этого, устанавливается дата и время (при необходимости) изменения статуса, а также сообщение в поле ''Инфо о доставке''.

При необходимости к заказу можно прикрепить изображения.

'''Пример запроса изменения статуса:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<setorderinfo>
<auth extra="8" login="login" pass="pass" />
<order ordercode="123456">
<message>Получил Иванов</message>
<outstrbarcode>7654312</outstrbarcode>
</order>
<order ordercode="234567">
<status>PICKUPREADY</status>
<eventtime>2016-05-30 10:20:00</eventtime>
<message>Клиент отказался от покупки</message>
<paytype>CASH</paytype>
<items>
<item code="34533" quantity="1" reason="0" />
<item code="34456" quantity="0" reason="0" />
<item code="34421" quantity="2" reason="0" />
</items>
<image filename="filename1.jpg"> /9j/4AAQSkZJRgA
BAQAAAQABAAD/2wBDAA0JCg sKCA0LCgsODg0PEyAVExISEy
ccHhcgLikxMC4pLSwzOko+M zZGNywtQFdBRkxOUlNSMj5aY
VpQYEpRUk//2wBDAQ4ODhMR EyYVFSZPNS01T09PT09PT09P
T09PT09PT09PT09PT09PT09 PT09PT09PT09PT09PT09PT09
PT09PT0//wAARCAYACAADAS IA</image>
</order>
</setorderinfo>
</source>

'''Описание полей запроса статуса:'''

'''setorderinfo''' — Корневой контейнер. Обязательный элемент.
* '''auth''' — Авторизация. Обязательный элемент.
* '''order''' — Контейнер заказа. Обязательный элемент. Запрос может содержать более одного контейнера '''order'''. Атрибут '''''ordercode''''' — внутренний код заказа.
* '''status''' — Новый статус заказа. Доступны статусы из раздела [[#Описание полей ответа статусов]], кроме AWAITING_SYNC и NEW.
* '''eventtime''' — Дата и время изменения статуса. Обязательно при указании статуса.
* '''message''' — Текст сообщения ''Инфо о доставке''.
* '''outstrbarcode''' — код у подрядчика (код заказа во внешней системе). Используется в интеграциях с внешними системами.
* '''paytype''' — Тип оплаты заказа. Допустимые значения CASH/CARD.
* '''items''' — Контейнер для описания вложений '''item''' . Атрибуты:
:* '''''code''''' — Код вложения.
:* '''''quantity''''' — Количество доставленных единиц вложения.
:* '''''reason''''' — Причина недоставки, выбирается из соответствующего списка статусов.
* '''image''' — Контейнер прикрепляемого изображения. Содержит текст файла изображения, закодированный по стандарту ''base64''. Контейнер '''order''' может содержать более одного контейнера '''image'''. Атрибут:
:* '''''filename''''' — Имя файла.

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<setorderinfo>
<order ordercode="123456" error="0" errormsg="OK" errormsgru="Успешно" />
<order ordercode="234567" error="59" errormsg="value [date_put] is already set" errormsgru="Значение [Дата доставки] уже указано" />
</setorderinfo>
</source>

== Получение документов для печати ==
'''Пример запроса получения печатных форм:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<waybill>
<auth extra="8" login="login" pass="pass" />
<orders>
<order orderno="1234567" ordercode="33331" />
<order orderno="1234568" ordercode="33332" />
</orders>
<form>1</form>
</waybill>
</source>

'''Описание полей:'''

'''waybill''' — Корневой контейнер. Обязательный элемент
* '''auth''' — Авторизация. Обязательный элемент
* '''orders''' — Список заказов для получения печатных форм. Содержит тэги '''order''' с атрибутами:
:* '''''orderno''''' — шифр заказа
:* '''''ordercode''''' — внутренний код заказа. Указывать необходимо один из атрибутов для всех заказов. Приоритет имеет атрибут '''''ordercode'''''
* '''form''' — Формат накладной. Не обязательный элемент. Принимает значения:
:* 1 — Подробная накладная (по-умолчанию)
:* 2 — Наклейки Zebra
:* 3 — Наклейки на страницу формата А4
:* 4 — Акты приема-передачи

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<waybill>
<content>EODIcaI8KSBlwQ 4MnEOR7Px8U8EBAyGICBnwpw
IZhQgz0ZxuPs8EBM/GcbjzB AwhBl8hwQYIO00GmEwg1CeEG
mqYTChNU0wqf8l8nz4zgc+K fCno+zwU5GjOZmzXGcbEQYIM
4zkegRE40zWzONyoNNMIOIa cWnp6aDCGEGE9NQmoQd2mg00
79U4f3hPTwnfp6Sdrafeqpa JDpFw/1aYT077VNNNdO00G3q
mqqvp9p2E7T0/wiFemv8uG6 OM</content>
</waybill>
</source>

В тэге content возвращаются бинарные данные (файл pdf), закодированные в base64.

'''Обратите внимание''', что печатные формы для заборов не формируются.

== Справочник городов ==
'''Пример запроса справочника городов:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<townlist>
<auth extra="8" />
<codesearch>
<zipcode>110000</zipcode>
<kladrcode>0100000100800</kladrcode>
<fiascode>bd21979d-46f8-49d0-9105-e8d65172a983</fiascode>
<code>123</code>
</codesearch>
<conditions>
<city>Краснодарский край</city>
<namecontains>новгород</namecontains>
<namestarts>Моск</namestarts>
<name>Москва</name>
<fullname>Москва город</fullname>
<country>1</country>
</conditions>
<limit>
<limitfrom>30</limitfrom>
<limitcount>10</limitcount>
<countall>YES</countall>
</limit>
</townlist>
</source>

Внутри контейнера townlist все элементы могут как отсутствовать, так и комбинироваться. Поиск не чувствителен к регистру.

* '''auth''' — Авторизация, необязательный элемент. Используется в случае включенного и настроенного ограничения по населенным пунктам в конкретной курьерской службе.

* '''codesearch''' — Поиск по кодам. В случае использования — контейнеры conditions и limit игнорируются.
:* '''zipcode''' — Поиск по индексу. Обратите внимание на то, что один почтовый индекс может распространяться на несколько населенных пунктов. В этом случае система вернет несколько записей.
:* '''kladrcode''' — Поиск по 13-ти значному коду КЛАДР.
:* '''fiascode''' — Поиск по коду ФИАС (AOGUID).
:* '''code''' — Поиск по коду в системе.

* '''conditions''' — Задает условия поиска. Все вложенные элементы одновременно накладывают условие «И».
:* '''city''' — Поиск по всем населенным пунктам региона.
:* '''namecontains''' — Поиск населенных пунктов, название которых содержит указанный текст.
:* '''namestarts''' — Поиск населенных пунктов, название которых начинается с указанного текста.
:* '''name''' — Поиск населенных пунктов, название которых соответствует указанному тексту.
:* '''fullname''' — Поиск населенных пунктов, название вместе с типом населенного пункта которых соответствует указанному тексту.
:* '''country''' — Поиск только по стране с указанным внутренним кодом или текстовым кодом в соответствии [https://ru.wikipedia.org/wiki/ISO_3166-1 стандартом ISO_3166-1], например, «RU», «RUS» для России.

* '''limit''' — Ограничивает вывод результата.
:* '''limitfrom''' — Задает номер записи результата, начиная с которой выдавать ответ. По-умолчанию — 0.
:* '''limitcount'''- Задает количество записей результата, которые нужно вернуть. По-умолчанию — 10000.
:* '''countall''' — YES указывает на необходимость подсчета общего количества найденных совпадений. Это может замедлять выполнение запроса. Если отключено — в ответе не указываются totalcount и totalpages.

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<townlist count="3" page="1" totalcount="3" totalpages="1">
<town>
<code>26379</code>
<city>
<code>23</code>
<name>Краснодарский край</name>
</city>
<name>Сочи город</name>
<fiascode>79da737a-603b-4c19-9b54-9114c96fb912</fiascode>
<kladrcode>2300000700000</kladrcode>
<shortname /> (not yet supported)
<typename /> (not yet supported)
<coords lat="43.5855" lon="39.7231" />
</town>
<town>
<code>40331</code>
<city>
<code>32</code>
<name>Брянская область</name>
</city>
<name>Сочилов хутор</name>
<fiascode>c9c96c67-2cc9-4f10-afde-fd32417ea216</fiascode>
<kladrcode>3201900011100</kladrcode>
<shortname />
<typename />
<coords lat="52.6407" lon="33.1724" />
</town>
<town>
<code>114016</code>
<city>
<code>60</code>
<name>Псковская область</name>
</city>
<name>Сочихино деревня</name>
<fiascode>10df7588-19c1-49d1-a387-9de1cf3eb26f</fiascode>
<kladrcode>6001900015400</kladrcode>
<shortname />
<typename />
<coords lat="56.6003" lon="29.3542" />
</town>
</townlist>
</source>

В ответе города сортируются по популярности, важности (районные центры и т. д.), и только затем — по алфавиту.

== Справочник регионов ==
'''Пример запроса справочника:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<regionlist>
<codesearch>
<code>77</code>
</codesearch>
<conditions>
<namecontains>край</namecontains>
<namestarts>Моск</namestarts>
<fullname>Московская область</fullname>
<country>RU</country>
</conditions>
</regionlist>
</source>

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<regionlist count="2">
<city>
<code>80</code>
<country>
<code>1</code>
<name>Россия</name>
<id>643</id>
<ShortName1>RU</ShortName1>
<ShortName2>RUS</ShortName2>
</country>
<name>Агинский Бурятский автономный округ</name>
</city>
<city>
<code>1</code>
<country>
<code>1</code>
<name>Россия</name>
<id>643</id>
<ShortName1>RU</ShortName1>
<ShortName2>RUS</ShortName2>
</country>
<name>Адыгея республика</name>
</city>
</regionlist>
</source>

== Справочник улиц ==
'''Пример запроса справочника улиц:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<streetlist>
<conditions>
<town>Москва город</town> // ОБЯЗАТЕЛЬНОЕ ПОЛЕ!
<namecontains>Хохло</namecontains>
<namestarts>Академика Х</namestarts>
<name>Академика Хохлова</name>
<fullname>Академика Хохлова ул.</fullname>
</conditions>
<limit>
<limitfrom>30</limitfrom>
<limitcount>10</limitcount>
<countall>YES</countall>
</limit>
</streetlist>
</source>

* '''conditions''' — Задает условия поиска. Все вложенные элементы одновременно накладывают условие «И».
:* '''town''' — Обязательное поле. Название или код населенного пункта.
:* '''namecontains''' — Поиск улиц, название которых содержит указанный текст.
:* '''namestarts''' — Поиск улиц, название которых начинается с указанного текста.
:* '''name''' — Поиск улиц, название которых соответствует указанному тексту.
:* '''fullname''' — Поиск улиц, для которых название вместе с типом соответствует указанному тексту.

* '''limit''' — Ограничивает вывод результата.
:* '''limitfrom''' — Задает номер записи результата, начиная с которой выдавать ответ. По-умолчанию — 0.
:* '''limitcount'''- Задает количество записей результата, которые нужно вернуть. По-умолчанию — 10000.
:* '''countall''' — YES указывает на необходимость подсчета общего количества найденных совпадений. Это может замедлять выполнение запроса. Если отключено, в ответе не указываются totalcount и totalpages.

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<streetlist count="1" page="1" totalcount="3" totalpages="1">
<street>
<code>124</code>
<name>Академика Хохлова ул.</name>
<shortname>Академика Хохлова</shortname>
<typename>ул.</typename>
</street>
</streetlist>
</source>

В ответе улицы сортируются по алфавиту.

== Справочник номенклатуры ==
'''Пример запроса справочника номенклатуры:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<itemlist>
<auth extra="8" login="login" pass="pass"></auth>
<codesearch>
<code>123456</code>
<article>FD343</article>
<barcode>2345625213125</barcode>
</codesearch>
<conditions>
<namecontains>телевизор</namecontains>
<namestarts>sony</namestarts>
<name>Sony KDL-55W905 ЖК-телевизор</name>
<quantity>EXISTING_ONLY</quantity>
<store>2</store>
</conditions>
<except>
<code>123478</code>
</except>
<limit>
<limitfrom>30</limitfrom>
<limitcount>10</limitcount>
<countall>YES</countall>
</limit>
</itemlist>
</source>

Внутри контейнера itemlist все элементы могут как отсутствовать, так и комбинироваться. Поиск не чувствителен к регистру.
* '''codesearch''' — Поиск по кодам. В случае использования — контейнеры conditions и limit игнорируются.
:* '''code''' — Поиск по внутреннему коду системы.
:* '''article''' — Поиск по артикулу.
:* '''barcode''' — Поиск по штрихкоду.

* '''conditions''' — Задает условия поиска. Все вложенные элементы одновременно накладывают условие «И».
:* '''namecontains''' — Поиск товаров, название которых содержит указанный текст.
:* '''namestarts''' — Поиск товаров, название которых начинается с указанного текста.
:* '''name''' — Поиск товаров, название которых соответствует указанному тексту.
:* '''quantity''' — Наличие на складе. Принимает значения EXISTING_ONLY — Только в наличии, NOT_EXISTING_ONLY — Только не в наличии, ALL — Все. ''Это поле может быть недоступным в некоторых установках.''
:* '''store''' — Поиск товаров по определенному складу.

* '''except''' — Описание исключений для корректного определения количества зарезервированной номенклатуры.
:* '''code''' — Код заказа.

* '''limit''' — Ограничивает вывод результата.
:* '''limitfrom''' — Задает номер записи результата, начиная с которой выдавать ответ.
:* '''limitcount''' — Задает количество записей результата, которые нужно вернуть.

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<itemlist count="3" totalcount="3" page="1" totalpages="1">
<item>
<code>123456</code>
<article>FD343</article>
<barcode>2345625213125</barcode>
<name>Sony KDL-55W905 ЖК-телевизор</name>
<retprice>65000</retprice>
<purchprice>50000</purchprice>
<weight>5.1</weight>
<length>50</length>
<width>30</width>
<height>40</height>
<VATrate>20</VATrate>
<CountInPallet>30</CountInPallet>
<CountInBox>2</CountInBox>
<HasSerials>1</HasSerials>
<CountryOfOrigin>Малайзия</CountryOfOrigin> (not yet supported)
<Message>Хороший телевизор</Message>
<Message2>Снова хороший телевизор</Message2>
<quantity>12</quantity>
<reserved>3</reserved>
<item>
...
</itemlist>
</source>

'''Описание полей:'''
* '''code''' — Внутренний идентификатор, присвоенный системой.
* '''article''' — Артикул, назначенный клиентом (поставщиком).
* '''barcode''' — Штрихкод производителя.
* '''name''' — Наименование.
* '''retprice''' — Розничная цена по-умолчанию. При оформлении заказа цена используется та, которая указана в заказе.
* '''purchprice''' — Закупочная цена.
* '''weight''' — Масса в килограммах.
* '''length''' — Длина в сантиметрах.
* '''width''' — Ширина в сантиметрах.
* '''height''' — Высота в сантиметрах.
* '''VATrate''' — Ставка НДС, целое число процентов.
* '''CountInPallet''' — Количество штук в паллете.
* '''CountInBox''' — Количество штук в упаковке.
* '''HasSerials''' — Требует учета серийных номеров. Принимает значения 1 — да, 0 — нет.
* '''CountryOfOrigin''' — Наименование страны происхождения на русском языке.
* '''Message''' — Комментарий.
* '''Message2''' — Дополнительный комментарий.
* '''quantity''' — Количество на складе. Товары, уже собранные в заказы в этом количестве не присутствуют, считаются покинувшими товарный склад. ''Это поле может быть недоступным в некоторых установках.''
* '''reserved''' — Количество зарезервированного товара. Может превышать остаток на складе, если покупатели ждут следующей поставки. ''Это поле может быть недоступным в некоторых установках.''

== Движение номенклатуры ==
'''Пример запроса движения номенклатуры:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<itemmovements>
<auth extra="8" login="login" pass="pass"></auth>
<code>4259</code>
<datefrom>2020-10-01</datefrom>
<dateto>2020-10-02</dateto>
</itemmovements>
</source>

* '''code''' — внутренний код товара в справочнике номенклатуры.
* '''datefrom''' — дата начала периода.
* '''dateto''' — дата окончания периода.
Может быть указан или код, или период, или код и период одновременно.

'''Пример ответа движения номенклатуры:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<itemmovements count="16">
<itemmovement>
<code>151500</code>
<date>2017-05-26</date>
<retprice>0</retprice>
<quantity>1</quantity>
<delivered>0</delivered>
<item>
<code>4259</code>
<name>Настольная игра Дженга</name>
</item>
<status>
<code>5</code>
<name>Возврат от покупателя</name>
</status>
<store>
<code>1</code>
<name>офис в Москве</name>
</store>
<order>
<ordercode>3374830</ordercode>
<number>123660-0</number>
<date>2017-05-24</date>
<orderno>14123</orderno>
<barcode>0000000670</barcode>
<company>ТОВАР</company>
<address>Кравченко ул., 1</address>
<delivereddate>2017-05-29</delivereddate>
<deliveredtime>12:00:00</deliveredtime>
<deliveredto />
</order>
<document>
<code>21991</code>
<number>318</number>
<date>2017-05-26</date>
<message></message>
</document>
</itemmovements>
</itemlist>
</source>

''' Описание полей ответа '''
* '''code''' — внутренний код операции движения
* '''date''' — дата операции
* '''retprice''' — цена товара
* '''quantity''' — количество товара операции
* '''delivered''' — количество доставленного товара

* '''item''' — контейнер товара
:* '''code''' — внутренний код товара
:* '''name''' — наименование товара

* '''status''' — контейнер статуса операции
:* '''code''' — код статуса
:* '''name''' — наименование

* '''store''' — контейнер филиала, к которому относится операция
:* '''code''' — код филиала
:* '''name''' — наименование филиала

* '''order''' — контейнер корреспонденции
:* '''ordercode''' — внутренний код заказа
:* '''number''' — номер заказа
:* '''date''' — дата заказа
:* '''orderno''' — шифр
:* '''barcode''' — штрихкод
:* '''company''' — компания
:* '''address''' — адрес
:* '''delivereddate''' — дата вручения
:* '''deliveredtime''' — время вручения
:* '''deliveredto''' — данные о вручении, либо причина недоставки

* '''document''' — контейнер документа операции
:* '''code''' — внутренний код документа
:* '''number''' — номер документа
:* '''extnumber''' — внешний номер документа
:* '''date''' — дата документа
:* '''message''' — комментарий

== Получение справочника тарифов по городам ==
<br>
<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
'''Обратите внимание!'''
Если в запросе отсутствует параметр nofederal, то Москва будет обрабатываться иначе, чем остальные города. В ответе будут города Москвы и МО, с добавленной ценой за километраж
</div>
<br>

'''Пример запроса справочника тарифов по городам'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<tariffs>
<auth extra="8" login="login" pass="pass" />
<townfrom>Москва</townfrom>
<service>1</service>
<mainonly>1</mainonly>
<nofederal>1</nofederal>
</tariffs>
</source>

* '''auth''' — атрибут '''extra''' обязателен, по нему определяется курьерская служба.
* '''townfrom''' — город-отправитель. Если не передан, то городом будет «Москва».
* '''service''' — режим доставки. Обязательный элемент.
* '''mainonly''' — необязательный элемент. Если передан, то в ответе будут данные только по городам из справочника '''Межгород''' > '''Зоны'''.
* '''nofederal''' — необязательный элемент. Если передан, то в ответе город федерального значения Москва будет обрабатываться как обычный город.

'''Пример ответа справочника тарифов по городам'''
<source lang="json">
{
"townfrom": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
"service": 1,
"tariffs": [
{
"towntofias": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
"towntocode": 1,
"towntoname": "Москва город",
"distance": 0,
"pricedistance": 0,
"pricesnew": {
"before": [
{
"price": 100,
"every": 0,
"mass": 1
},
{
"price": 150,
"every": 0,
"mass": 5
}
],
"after": [
{
"price": 0,
"every": 1,
"mass": 38.01
},
{
"price": 15,
"every": 1,
"mass": 51.01
}
]
},
"deliveryPeriodMin": 1,
"deliveryPeriodMax": 2
}
]
}
</source>

''' Описание полей ответа '''
* '''townfrom''' — код ФИАС города-отправителя.
* '''service''' — режим доставки.
* '''tariffs''' — cписок тарифов по городу.
:* '''towntofias''' — код ФИАС города-получателя.
:* '''towntocode''' — внутренний код города-получателя.
:* '''towntoname''' — наименование города-получателя.
:* '''distance''' — дистанция в км до города от МКАД, если в запросе townfrom — Москва.
:* '''pricedistance''' — сумма за километраж до города от МКАД, если в запросе townfrom — Москва.
:* '''pricesnew''' — ваши настройки тарифов из справочника '''Межгород''' > '''Тарифы по зонам'''.
::* '''before/after''' — контейнеры ДО/ОТ.
:::* '''price''' — цена. Если ответ идет по «before», то в цену также плюсуется сумма pricedistance
:::* '''every''' — за каждые.
:::* '''mass''' — масса.
:* '''prices''' — устаревший элемент, не используется.
:* '''deliveryPeriodMin''' — минимальный срок доставки.
:* '''deliveryPeriodMax''' — максимальный срок доставки.

== Номенклатура приходной накладной ==
'''Пример запроса номенклатуры приходной накладной:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<itemdoc>
<auth extra="8" login="login" pass="pass"></auth>
<code>21991</code>
</itemdoc>
</source>

* '''code''' — внутренний код документа приходной накладной (см. предыдущий запрос).

'''Пример ответа движения номенклатуры:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<itemdoc>
<code>21991</code>
<number>318</number>
<date>2017-05-26</date>
<message></message>
<items>
<item code="4259" quantity="1" barcode="200300" article="123555">Настольная игра Дженга</item>
</items>
</itemdoc>
</source>

''' Описание полей ответа '''
* '''code''' — внутренний код приходной накладной
* '''number''' — номер документа
* '''date''' — дата документа
* '''message''' — комментарий

* '''item''' — контейнер товара
:* '''code''' — внутренний код товара
:* '''barcode''' — штрихкод товара
:* '''article''' — артикул товара
:* '''quantity''' — количество поступившего товара

== Справочник филиалов ==
'''Пример запроса списка филиалов:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<storelist>
<auth extra="8"></auth>
<json>YES</json>
<client_code>7890</client_code>
</storelist>
</source>

* '''auth''' — Атрибут '''extra''' — обязателен, по нему определяется курьерская служба
* '''json''' — Признак вывода ответа в виде JSON YES/NO
* '''client_code''' — Код клиента курьерской службы

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<storelist count="2">
<store>
<code>123</code>
<name>ABC</name>
</store>
<store>
<code>456</code>
<name>Филиал 2</name>
</store>
</storelist>
</source>

* '''code''' — Код филиала.
* '''name''' — Наименование филиала.

== Справочник пунктов самовывоза ==
Для отображения списка пунктов выдачи (ПВЗ) есть '''готовый JavaScript модуль''': https://home.courierexe.ru/js/measoft_map.js Инструкция по использованию — внутри. Посмотреть пример работы можно [https://home.courierexe.ru/pvz_test.html Здесь]

Уникальные запросы списка ПВЗ кешируются на стороне личного кабинета и хранятся до 7 часов утра по московскому времени следующего дня. Например, если уникальный запрос с массой 2 кг был отправлен сегодня в 10 часов, то завтра в 7 утра он сбросится. Если сегодня в 18 часов в этом же запросе вы укажете массу 2 кг, в ответе вернется тот же список ПВЗ. Если передадите массу 3 кг, список может быть другим.

'''Пример запроса пунктов самовывоза:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<pvzlist>
<auth extra="8" login="login" pass="pass"></auth>
<code>1234</code>
<client_code>7890</client_code>
<city>Свердловская область</city>
<town regioncode="66" country="RU">Нижний Тагил</town>
<parentcode>6</parentcode>
<acceptcash>YES</acceptcash>
<acceptcard>YES</acceptcard>
<acceptfitting>YES</acceptfitting>
<maxweight>30</maxweight>
<acceptindividuals>YES</acceptindividuals>
<lt>57.924737</lt>
<lg>59.940019</lg>
<rt>57.905682</rt>
<rg>59.984669</rg>
<json>YES</json>
<limit>
<limitfrom>30</limitfrom>
<limitcount>2</limitcount>
<countall>YES</countall>
</limit>
</pvzlist>
</source>

* '''auth''' — Атрибут '''extra''' — обязателен, по нему определяется курьерская служба, '''login''' и '''pass''' позволяют авторизоваться под клиентом: для отдельного клиента могут быть ограничения по доступности некоторых ПВЗ, и в этом случае они будут учтены.
* '''code''' — Внутренний код.
* '''client_code''' — Код клиента курьерской службы.
* '''city''' — Регион получателя. Можно указать код региона или полное наименование региона из [[#Справочник регионов|справочника регионов]].
* '''town''' — Город получателя.
Для тега города '''town''' можно указать код региона в атрибуте '''''regioncode''''' из [[#Справочник регионов|справочника регионов]]. Поиск будет производиться в указанном регионе.

Также можно указать страну получателя в атрибуте '''''country''''' в соответствии с [https://ru.wikipedia.org/wiki/ISO_3166-1 стандартом ISO_3166-1], например, «RU», «RUS» или «643» для России.

* '''parentcode''' — Фильтр по родительскому [[#Справочник филиалов|филиалу]]
* '''acceptcash''' — Фильтр по приему наличных YES/NO
* '''acceptcard''' — Фильтр по приему банковских карт YES/NO
* '''acceptfitting''' — Фильтр по наличию примерки YES/NO
* '''maxweight''' — Фильтр по максимальному весу, с которым работает ПВЗ
* '''acceptindividuals''' — Фильтр по доступности физическим лицам YES/NO
* '''lt''' — Широта левого верхнего угла
* '''lg''' — Долгота левого верхнего угла
* '''rt''' — Широта правого нижнего угла
* '''rg''' — Долгота правого нижнего угла
* '''json''' — Признак вывода ответа в виде JSON YES/NO
* '''limit''' — Ограничивает вывод результата.
:* '''limitfrom''' — Задает номер записи результата, начиная с которой выдавать ответ. По-умолчанию — 0.
:* '''limitcount'''- Задает количество записей результата, которые нужно вернуть. По-умолчанию — 100.
:* '''countall''' — YES указывает на необходимость подсчета общего количества найденных совпадений. Это может замедлять выполнение запроса. Если отключено — в ответе не указываeтся totalcount.

'''Пример ответа справочника пунктов самовывоза:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<pvzlist count="2" totalcount="40465">
<pvz>
<code>126</code>
<clientcode>3</clientcode>
<name>Нижний Тагил</name>
<parentcode>6</parentcode>
<parentname>Интеграция</parentname>
<town code="124267" regioncode="66" regionname="Свердловская область">Нижний Тагил город</town>
<address>622036, г. Нижний Тагил, ул. Циолковского, д. 17</address>
<phone>+73435417709, +73435254989</phone>
<comment>Новый пункт доставки</comment>
<worktime>Вс 10:00-16:00, Сб 10:00-16:00, Пн-Пт 10:00-20:00</worktime>
<traveldescription>Жилое 5-ти этажное здание, торцом к дороге, второе здание от перекрестка Пархоменко-Циолковского</traveldescription>
<maxweight>10</maxweight>
<acceptcash>YES</acceptcash>
<acceptcard>YES</acceptcard>
<acceptfitting>YES</acceptfitting>
<acceptindividuals>YES</acceptindividuals>
<latitude>57.93457</latitude>
<longitude>59.95131</longitude>
<uid>40606d00-9c51-11eb-b2c9-cfd6c1111392</uid>
</pvz>
<pvz>
<code>245</code>
<clientcode>NTG1</clientcode>
<name>На Красноармейской</name>
<parentcode>6</parentcode>
<parentname>Интеграция</parentname>
<town code="124267" regioncode="66" regionname="Свердловская область">Нижний Тагил город</town>
<address>КРАСНОАРМЕЙСКАЯ, д.79</address>
<phone>+7(3435)379-044</phone>
<comment>Возможность примерки отсутствует</comment>
<worktime>Вс 10:00-16:00, Сб 10:00-16:00, Пн-Пт 10:00-20:00</worktime>
<traveldescription>Напротив ТЦ Пирамида</traveldescription>
<maxweight>20</maxweight>
<acceptcash>YES</acceptcash>
<acceptcard>YES</acceptcard>
<acceptfitting>NO</acceptfitting>
<acceptindividuals>YES</acceptindividuals>
<latitude>57.93468</latitude>
<longitude>60.55476</longitude>
<uid>41116853-9c51-11eb-b2c9-cfd6c1451392</uid>
</pvz>
</pvzlist>
</source>

* '''code''' — Код ПВЗ в системе. Используется в запросе [[API#Оформление заказа|оформления заказов]]
* '''clientcode''' — Код ПВЗ используемый компанией-подрядчиком.
* '''name''' — Наименование ПВЗ.
* '''parentcode''' — Код родительского элемента.
* '''parentname''' — Наименование родительского элемента.
* '''town''' — Населенный пункт с кодом из [[#Справочник городов|справочника городов]], а также с кодом и наименованием региона.
* '''address''' — Адрес ПВЗ.
* '''phone''' — Телефоны ПВЗ.
* '''comment''' — Дополнительная информация.
* '''worktime''' — Режим работы ПВЗ.
* '''traveldescription''' — Описание местонахождения ПВЗ или пути к нему.
* '''maxweight''' — Максимальный вес, с которым работает ПВЗ.
* '''acceptcash''' — Признак приема наличных
* '''acceptcard''' — Признак приема банковских карт
* '''acceptfitting''' — Наличие примерки
* '''latitude''' — Широта
* '''longitude''' — Долгота
* '''uid''' — Уникальный идентификатор ПВЗ в системе Measoft
* '''count''' — Количество записей в ответе
* '''totalcount''' — Общее количество записей, отвечающее параметрам запроса

== Получение фискальных данных заказа ==
'''Пример запроса получения фискальных данных:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<receiptdata>
<auth extra="8" login="login" pass="pass" />
<orders>
<order orderno="123456" />
<order orderno="890111C" />
</orders>
</receiptdata>

</source>

'''Пример ответа получения фискальных данных:'''
<source lang="xml">

<?xml version="1.0" encoding="UTF-8"?>
<receipts count="1">
<receipt>
<orderno>123456</orderno>
<fdDatetime>2020-06-07 12:14:00</fdDatetime>
<fdValue>123</fdValue>
<fdNum>456</fdNum>
<fnSn>789</fnSn>
<kktNum>100</kktNum>
<inn>222</inn>
<ofdUrl>gate.ofd.ru</ofdUrl>
<fullUrl>https://check.ofd.ru/123</fullUrl>
<price>12345</price>
<lines count="1">
<line>
<item>1111764</item>
<name>Сапоги</name>
<qty>1</qty>
<price>1000</price>
<vatRate>20</vatRate>
<governmentCode>Z16513LK2</governmentCode>
<itemType>1</itemType>
</line>
</lines>
</receipt>
</receipts>
</source>

Параметры ответа:
* '''orderno''' — Номер заказа
* '''fdDatetime''' — Дата и время пробития фискального чека
* '''fdValue''' — ФПД (фискальный признак документа)
* '''fdNum''' — ФИСКАЛЬНЫЙ ДОКУМЕНТ (фискальный номер чека)
* '''fnSn''' — ФН (номер фискального накопителя)
* '''kktNum''' — РН (регистрационный номер кассы)
* '''inn''' — ИНН
* '''ofdUrl''' — URL адрес (доменное имя) ОФД
* '''price''' — Сумма чека
* '''fullUrl''' — URL чека для просмотра онлайн
* '''lines''' — Позиции чека
:* '''item''' — код товара
:* '''name''' — наименование товара
:* '''qty''' — количество товара
:* '''price''' — цена товара
:* '''governmentCode''' — считанная последовательность, которая в дальнейшем преобразуется по алгоритму тега 1162
:* '''vatRate''' — НДС товара
:* '''itemType''' — тип товара (товар, доставка и т. д.)

== Справочник Виды срочности ==
'''Пример запроса видов срочности:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<services>
<auth extra="8"/>
</services>
</source>

'''Пример ответа справочника видов срочности:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<services count="2">
<service>
<code>1</code>
<name>Эконом</name>
</service>
<service>
<code>2</code>
<name>Срочно</name>
</service>
</services>
</source>

== Справочник дополнительных услуг ==
'''Пример запроса дополнительных услуг:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<advprices>
<auth extra="8" login="login" pass="pass" />
<visible>NO</visible>
</advprices>
</source>

'''advprices''' — Корневой контейнер. Обязательный элемент.
* '''visible''' — Признак возврата '''только''' тех услуг, что доступны для отображения в ЛК YES/NO. Необязательный элемент. По-умолчанию NO

'''Пример ответа справочника дополнительных услуг:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<advprices>
<advprice>
<code>1</code>
<name>Этажей в доме</name>
<type>int</type>
</advprice>
<advprice>
<code>2</code>
<name>Коэффициент надбавки</name>
<type>float</type>
</advprice>
<advprice>
<code>3</code>
<name>Расписаться на упаковке</name>
<type>bool</type>
</advprice>
</advprices>
</source>

Параметры:
* '''code''' — внутренний код услуги
* '''name''' — наименование услуги. Если поле «название в ЛК» в настройках услуги не пусто, то возвращает значение поля «название в ЛК».
* '''hine''' — подсказка по доп услуге для пользователя
* '''type''' — тип услуги. Может иметь значения:
:* '''bool''' — для услуг вида «чекбокс», «Да»
:* '''float''' — для числа с плавающей точкой
:* '''int''' — для целого числа

== Расчет стоимости доставки ==
'''Пример запроса стоимости доставки:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<calculator>
<auth extra="8" login="login" pass="pass" />
<order>
<pricetype>CUSTOMER</pricetype>
<sender>
<town>Санкт-Петербург</town>
<address>Петровка 38 офис 35</address>
<coords lat="55.680327" lon="37.604456"></coords>
</sender>
<receiver>
<zipcode>125480</zipcode>
<town regioncode="78" country="RU">Санкт-Петербург</town>
<address>Петровка 38 офис 35</address>
<pvz>124</pvz>
<coords lat="55.680327" lon="37.604456"></coords>
</receiver>
<weight>5.1</weight>
<service>2</service>
<paytype>CASH</paytype>
<price>387.5</price>
<deliveryprice>150</deliveryprice>
<inshprice>387.5</inshprice>
<packages>
<package mass="1" quantity="5"></package>
<package mass="2.5" length="10" width="20" height="30"></package>
</packages>
<userid>user123</userid>
<groupid>customer</groupid>
</order>
</calculator>
</source>

Параметры:
Структура данных и заполнение полей аналогичны и совместимы с [[#Оформление заказа]].

Дополнительные поля:
* '''pricetype''' — тип требуемой цены. Возможные значения: «CUSTOMER» (по-умолчанию) — [[Личный кабинет клиента#Цена доставки для получателя|цена для конечного получателя]], «CLIENT» — цена курьерской службы для клиента.
* '''userid''' — Идентификатор пользователя, строковый или числовой тип. Виртуальное поле. Необязательное. Данное поле используется совместно с настройками «Цена доставки для получателя», определяя приоритет правила. Можно использовать в различных CMS/CRM системах, настраивая цены для определенного покупателя.
* '''groupid''' — Идентификатор группы пользователя, строковый или числовой тип. Виртуальное поле. Необязательное. Данное поле используется совместно с настройками «Цена доставки для получателя», определяя приоритет правила. Можно использовать в различных CMS/CRM системах, настраивая цены для определенной группы покупателей.

Суммы НП и ОЦ, а также тип оплаты CARD имеют значение при настроенных в тарифе на вкладке Прочее долях (в процентах) от данных сумм.

В авторизации можно опустить параметры login и pass, тогда расчет будет производиться по стандартному тарифу курьерской службы, без учета возможных отличий для конкретного клиента.<br>
Объемный вес будет учитываться только при условии указания всех габаритов: длины, ширины и высоты.<br>
В полях город-отправитель и город-получатель можно указывать название города (не рекомендуется!), либо код города из нашего справочника, либо 13-ти значный код КЛАДР, либо 36-ти значный код адресной системы ФИАС (AOID).

'''Пример ответа стоимости доставки:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<calculator>
<calc>
<townfrom code="1">Москва город</townfrom>
<townto code="56603">Иркутск город</townto>
<mass>3.7</mass>
<service name="Экспресс">1</service>
<zone>2</zone>
<price>1113</price>
<mindeliverydays>1</mindeliverydays>
<maxdeliverydays>3</maxdeliverydays>
<mindeliverydate>2020-05-13</mindeliverydate>
<deliveryprice>
<advprice code="1" price="1000">База</advprice>
<advprice code="4" price="100">Процент от суммы руб</advprice>
<advprice code="5" price="63">Процент от объявленной стоимости</advprice>
<advprice code="6" price="-50">Скидка при доставке</advprice>
</deliveryprice>
</calc>
</calculator>
</source>

Параметры:
* '''townfrom''' — Город-отправитель так, как система его распознала и привязала к справочнику. Атрибут '''code''' — код из справочника городов системы.
* '''townto''' — Город-получатель так, как система его распознала и привязала к справочнику. Атрибут '''code''' — код из справочника городов системы.
* '''mass''' — Масса в килограммах
* '''service''' — Режим доставки — число, указывающее на запись в справочнике видов срочности (см описание на этой странице).
* '''zone''' — номер тарифной зоны, по которой рассчиталась стоимость. В зависимости от зоны выбирается тарифная сетка. Так же к цене могут применяться повышающие или понижающие коэффициенты при доставке не из/в региональный центр.
* '''price''' — рассчитанная стоимость доставки в валюте прайс-листа курьерской службы. Рекомендуется к использованию в отличие от одноименного атрибута родительского контейнера.
* '''maxdeliverydays''' — максимальный срок доставки в рабочих днях.
* '''mindeliverydate''' — минимальная дата доставки в учетом выходных дней.
* '''deliveryprice''' — Данные по составляющим ценам доставки

'''''Обратите внимание:''''' В реальном ответе сервера в теге calc присутствует атрибут «price». Он оставлен для обратной совместимости, не используйте его. Пользуйтесь вложенным тегом price.

== Получение информации о клиенте ==
'''Пример запроса получения информации о клиенте:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<client>
<auth extra="8" login="login" pass="pass" />
</client>
</source>

'''client''' — Корневой контейнер. Обязательный элемент.
* '''auth''' — Авторизация. Обязательный элемент.

'''Пример ответа на запрос получения информации о клиенте:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<client>
<code>1082</code>
</client>
</source>

* '''code''' — Код клиента

== Список актов передачи денег ==
'''Пример запроса списка актов передачи денег:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<smalist>
<auth extra="8" login="login" pass="pass" />
<datefrom>2016-02-10</datefrom>
<dateto>2016-03-10</dateto>
</smalist>
</source>

'''smalist''' — Корневой контейнер. Обязательный элемент.
* '''auth''' — Авторизация. Обязательный элемент.
* '''datefrom''' — Дата «с». Необязательный элемент.
* '''dateto''' — Дата «по». Необязательный элемент.
Если интервал дат не указан, то возвращаются акты передачи денег за последний месяц.

'''Пример ответа на запрос списка актов передачи денег:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<smalist count="1">
<sma>
<code>6278</code>
<number>3992</number>
<actdate>2016-02-12</actdate>
<datepay></datepay>
<dateto>2016-02-12</dateto>
<promiseddatepay></promiseddatepay>
<price>637.00</price>
<pricecorr>113.00</pricecorr>
<rur>13430.00</rur>
<pricekur>570.00</pricekur>
<priceag>67.00</priceag>
<payno>42423</payno>
<paytype>1</paytype>
<paytypename>Безнал</paytypename>
<signedcopyreceived>NO</signedcopyreceived>
</sma>
</smalist>
</source>

* '''code''' — Код акта
* '''number''' — Номер акта в системе
* '''actdate''' — Дата акта
* '''datepay''' — Дата оплаты по акту
* '''dateto''' — Дата конечного периода для формирования АПД
* '''promiseddatepay''' — Плановая дата оплаты
* '''price''' — Стоимость услуг
* '''pricecorr''' — Сумма корректировки
* '''rur''' — Сумма заказа
* '''pricekur''' — Стоимость курьерской доставки
* '''priceag''' — Агентское вознаграждение
* '''payno''' — Номер платежного поручения
* '''paytype''' — Тип оплаты: 1 — безнал, 2 — наличными курьером, 3 — наличными в офисе, 4 — перевод на карту
* '''paytypename''' — Строковое представление типа оплаты
* '''signedcopyreceived''' — Признак факта возврата акта YES/NO

== Детализация актов передачи денег ==
'''Пример запроса детализации актов передачи денег:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<smadetail>
<auth extra="8" login="login" pass="pass" />
<code>6278</code>
</smadetail>
</source>

'''smadetail''' — Корневой контейнер. Обязательный элемент.
* '''auth''' — Авторизация. Обязательный элемент.
* '''code''' — Код акта передачи денег (см. запрос списка АПД). Обязательный элемент.

'''Пример ответа на запрос детализации актов передачи денег:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<smadetail count="2">
<specialsma>
<code>42494</code>
<ordercode>14424</ordercode>
<orderno>11111</orderno>
<orderdate>2018-01-01</orderdate>
<delivereddate>2018-10-01</delivereddate>
<company>Компания</company>
<price>314.00</price>
<rur>8800.00</rur>
<inshprice>314.00</inshprice>
<pricekur>270.00</pricekur>
<priceag>44.00</priceag>
<pricecalc>8486.00</pricecalc>
<paytype>2</paytype>
<paytypename>наличными курьером</paytypename>
<weight>0.400</weight>
<distance>0.0</distance>
<status>Доставлено</status>
</specialsma>
</smadetail>
</source>

* '''code''' — Код записи.
* '''ordercode''' — Код заказа.
* '''orderno''' — Шифр заказа.
* '''orderdate''' — Дата заказа.
* '''delivereddate''' — Дата доставки.
* '''company''' — Получатель.
* '''price''' — Стоимость услуг.
* '''rur''' — Сумма заказа.
* '''inshprice''' — Стоимость заказа.
* '''pricekur''' — Стоимость курьерской доставки.
* '''priceag''' — Агентское вознаграждение.
* '''pricecalc''' — Сумма для передачи агенту.
* '''paytype''' — Тип оплаты: 1 — безнал, 2 — наличными курьером, 3 — наличными в офисе, 4 — перевод на карту.
* '''paytypename''' — Строковое представление типа оплаты
* '''weight''' — Вес заказа.
* '''distance''' — Дистанция по заказу
* '''status''' — Статус заказа.

== Генерация коротких ссылок ==
В некоторых случаях, например, при использовании в СМС, может потребоваться использование коротких ссылок на ЛК.
Для этого, необходимо отправить запрос с полной ссылкой, в ответ на который придёт хэш-код для ссылки.

'''Пример запроса генерации коротких ссылок:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<shortlink>
<link short="0"> https://home.courierexe.ru/8/site/orders </link>
</shortlink>
</source>

'''shortlink''' — Корневой контейнер. Обязательный элемент.
* '''link''' — Полная ссылка, для которой необходимо получить код. Обязательный элемент. Если атрибут '''short''' равен 1, то ответ не будет содержать XML, а только хэш-код.

'''Пример ответа на запрос генерации коротких ссылок:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<shortlink>
<hash>35AF350C</hash>
</shortlink>
</source>

* '''hash''' — Хэш-код ссылки.

Далее, можно использовать ссылку на ЛК:

<nowiki>https://home.courierexe.ru/35AF350C или curie.ru/35AF350C</nowiki>

'''Примечание!''' Сервис коротких ссылок работает только для ресурсов компании MeaSoft.

== Проверка надежности покупателя ==
Проверка надежности работает только для тарифа «Максимум» личного кабинета.

<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<mcheck>
<auth extra="8" login="login" pass="pass" />
<phones>
<phone>89161147992</phone>
</phones>
</mcheck>
</source>

Ответ:

<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<mcheck>
<phones>
<phone rate="90">89161147992</phone>
</phones>
</mcheck>
</source>

Личный кабинет клиента

2022-06-01T09:10:35Z

Olga: /* Загрузка реестра Excel */

Личный кабинет предназначен для клиентов и партнеров курьерской службы, работающей в системе MeaSoft.

В личном кабинете вы можете:
* добавлять и редактировать заказы;
* отслеживать заказы;
* рассчитать стоимость и сроки доставки отправления;
* печатать документы по заказам;
* настроить стоимость и срок доставки в зависимости от условий доставки и суммы выкупа;
* просматривать информацию о взаиморасчетах с курьерской службой.
Некоторые из функций могут отсутствовать или называться иначе в зависимости от настроек и тарифа курьерской службы.
[[Личный кабинет курьерской службы#Подключение|Подключение и настройка]] личного кабинета клиента выполняются администратором курьерской службы.

== Главная страница ==
На главной странице личного кабинета отображается таблица со статистикой по заказам, отправленным в курьерскую службу.

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

Если в выбранной группе заказов нет (значение ячейки равно «0»), будут показаны все заказы соответствующей строки.

Подробнее см. раздел «[[Личный кабинет клиента#Отслеживание исходящих заказов|Отслеживание исходящих заказов]]».

Дополнительно можно настроить отображение балансов клиента курьерской службы:
* баланс счета клиента — отображает текущий [[Клиенты и партнеры#Финансы|баланс клиента]];
* наличные к выдаче — сумма денег, которые курьерская служба приняла от получателей и еще не передала клиенту;
* безналичные к выдаче — сумма, принятая по заказам при оплате картой, но еще не перечисленная клиенту.

Обновление балансов происходит минимум раз в сутки. Таблица отображается, если хотя бы одна сумма больше нуля.

Чтобы настроить отображение балансов клиента на главной странице, обратитесь в службу поддержки MeaSoft.

[[Файл:ЛК Главная.png|none|1100 px]]

== Новый заказ ==
Вы можете оформить новый заказ следующими способами:

* [[#Создание заказа вручную|создать заказ вручную]];
* [[#Заявка на забор|создать заявку на забор]];
* [[#Привезти ко мне|создать заявку «Привезти ко мне»]];
* [[#Загрузка реестра Excel|импортировать реестр Microsoft Excel]];
* создать заказ [[#Создание заказа копированием|копированием]].

Создать заказ невозможно в следующих случаях:
* при отрицательном балансе, если вы работаете по предоплате;
* при наличии просроченных счетов на оплату;
* закончился срок действия договора с курьерской службой.

Соответствующее предупреждение отображается в верхней части страницы личного кабинета.

Шифры и штрихкоды заказов должны быть уникальными в пределах календарного года. Указывайте неповторяющиеся номера.

Если номер заказа — необязательное поле, его можно не указывать. В этом случае он будет иметь формат NN#KK, где NN — порядковый номер, а КК — внутренний код клиента в системе.

Если в заказе оформлены товарные вложения, то в качестве суммы наложенного платежа передается сумма стоимости вложений. Введенное пользователем значение поля '''Сумма''' в этом случае игнорируется.

=== Создание заказа вручную ===
# Выберите пункт основного меню '''Оформить заказ'''.
# На вкладке '''Новый заказ''' заполните обязательные поля, отмеченные звездочкой (*), и при необходимости остальные.
# Добавьте [[#Добавление товара|товары]], [[#Добавление места|места]], [[#Добавление файла|файлы]].
# Нажмите на кнопку '''Отправить'''.

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

Чтобы оформить заявку на забор:
# Выберите пункт основного меню '''Оформить заказ''' и перейдите на вкладку '''Заявка на забор'''. Откроется окно «Оформление заявки на забор».
# Заполните форму заявки и нажмите на кнопку '''Отправить'''.

=== Привезти ко мне ===
Заявка используется, когда курьер забирает отправления у поставщика или покупателя и передает заказчику. Функциональность предназначена для доставки товара от поставщика или при замене товара у покупателя. Подробнее см. раздел «[[Забор и замена товара]]».

Чтобы оформить заявку на доставку от третьего лица:
# Выберите пункт основного меню '''Оформить заказ'''.
# Перейдите на вкладку '''Привезти ко мне''' заполните обязательные поля, отмеченные звездочкой (*), и при необходимости остальные. Если нужно добавить товар, см. раздел «[[#Добавление товара|Добавление товара]]».
# Нажмите на кнопку '''Отправить'''.

=== Загрузка реестра Excel ===
# Выберите пункт основного меню '''Оформить заказ''' и перейдите на вкладку '''Реестр Excel'''. Откроется окно «Загрузка реестра Excel».
# Скачайте шаблон реестра по ссылке.
# Убедитесь, что загружаемый реестр соответствует шаблону.
# Убедитесь, что каждый заказ имеет свой уникальный номер. Для заборов укажите номер 0 и поле '''Штрихкод''' должно быть пустым.
# Чтобы добавить товарное вложение, в документе Microsoft Excel заполните поля в разделе '''Груз'''.<br>Чтобы добавить несколько товарных вложений в один заказ, укажите одинаковый номер заказа для всех вложений или укажите номер заказа только для первого из них. Поля заказа при этом можно не заполнять.
# Чтобы добавить пункт выдачи заказа в реестре, используйте один из следующих способов:
#* в поле '''Адрес''' укажите код ПВЗ. Узнать код можно в разделе <ссылка на раздел ПВЗ>.
#* в поле '''Адрес''' укажите название пункта выдачи заказов c префиксом «ПВЗ». Например, если название «ПВЗ на Пушкинской», в документ нужно записать "ПВЗ ПВЗ «На Пушкинской». При этом обязательно заполните поле '''Город получателя''', поскольку в разных городах могут быть ПВЗ с одинаковыми названиями.
# Если в шаблоне Microsoft Excel доступны поля '''При выкупе''' и '''При отказе''', в реестре можно установить зависимость стоимости доставки от суммы выкупа заказа. Для этого заполните следующие поля:
#* '''При отказе''' — стоимость доставки при полном отказе от отправления;
#* '''Сумма''' — сумма выкупа, определяющая стоимость доставки;
#* '''Стоимость доставки при выкупе менее суммы''' — стоимость доставки, если заказ выкуплен на сумму, меньшую указанной в поле '''Сумма''';
#* '''Стоимость доставки при выкупе от суммы''' — стоимость доставки, если заказ выкуплен на сумму, большую указанной в поле '''Сумма'''.
# Сохраните измененный реестр.
# Нажмите на кнопку '''Выберите файл'''. В открывшемся диалоговом окне выберите загружаемый реестр и нажмите на кнопку '''Загрузить'''.
# Проверьте данные заказа и нажмите на кнопку '''Подтвердить'''. Кнопка становится доступна, когда корректно заполнены ячейки, подсвеченные красным.

=== Создание заказа копированием ===
Вы можете создать заказ копированием существующего. В таком случае потребуется указать только желаемую дату и время забора или доставки. Это позволяет ускорить оформление заказа.

Чтобы скопировать существующий заказ:
# В пункте основного меню '''Главная''' или '''Отслеживание''' найдите нужный заказ, откройте его карточку и нажмите на кнопку '''Скопировать'''. Откроется окно оформления заказа.
# Укажите желаемое время и дату доставки или забора, при необходимости измените другие данные и нажмите на кнопку '''Отправить'''.

=== Добавление товара ===
Товар можно добавить при создании заказов вручную или при оформлении заявки на забор.

Чтобы добавить товар, на странице «Новый заказ» в поле '''Товары''' нажмите на кнопку [[Файл:ЛК Добавить.png]]. Откроется окно «Добавление/редактирование товара»:

[[Файл:AddEdit.png|none|650px]]

Товары добавляются следующими способами:
* по артикулу, если заказ комплектуется на складе курьерской службы. Для этого в поле '''Артикул товара''' нажмите на кнопку '''Выбрать'''. Откроется окно «Выберите товар»:[[Файл:Select by article.png|none|700px]]
*: Чтобы отфильтровать товары по складу, выберите нужный склад в выпадающем списке и нажмите на кнопку '''Показать'''.
*: Чтобы отфильтровать товары по наличию, установите флажок '''Только доступные''' и нажмите на кнопку '''Показать'''.
*: Вы можете начать вводить артикул или название в строке поиска и выбрать товар из отфильтрованного списка.
*: Поля '''Название товара''', '''Масса единицы товара''', '''Цена единицы товара''' и '''Штрихкод''' заполнятся автоматически. В поле '''Название товара''' появляется отметка о наличии или отсутствии товара на складе.
*: Если товар участвует в обороте системы «Честный ЗНАК», заполните поле '''Код товарной номенклатуры'''. Один код соответствует одной единице товара. Если код неизвестен, укажите знак вопроса («?»), и курьер отсканирует код маркировки при вручении товара. Подробнее см. раздел [[Честный ЗНАК|«Честный ЗНАК»]].
* вручную, если заказ комплектуется на складе интернет-магазина. Для этого в окне «Добавление/редактирование товара» заполните поля, кроме поля '''Артикул'''.

Подробнее о типах вложений см. в разделе [[Карточка корреспонденции#Вложения|«Вложения»]].

Чтобы добавить товар в заказ, нажмите на кнопку '''Сохранить'''. Для отмены нажмите '''Закрыть'''.

'''Примечание'''. Значение «0» при выборе ставки НДС означает ставку '''Без НДС'''. Cтавка «0%» не поддерживается.

После добавления позиций в разделе '''Товары''' формируется список товаров:

[[Файл:ЛК Товары.png|none]]

Вы можете редактировать или удалять товары с помощью кнопок [[Файл:ЛК Редактировать.png]] и [[Файл:Delete.png]] соответственно. Добавлять, редактировать и удалять товары можно только до нажатия на кнопку '''Отправить'''.

=== Добавление файла ===
Чтобы прикрепить файл к заказу, в поле '''Прикрепленные файлы''' нажмите на кнопку [[Файл:ЛК Добавить.png]]. Выберите файл на компьютере и нажмите '''Открыть'''. Появится строка с наименованием файла.

Размер загружаемого файла не должен превышать 1 Мб.

Чтобы удалить загруженный файл, в строке с названием файла нажмите на кнопку [[Файл:Delete.png]].

Добавлять и удалять файлы можно только до нажатия на кнопку '''Отправить'''.

=== Добавление места ===
Чтобы добавить место в заказ, в поле '''Места''' нажмите на кнопку [[Файл:ЛК Добавить.png]]. Откроется окно «Добавление/редактирование мест»:

[[Файл:ЛК Места.png|none|700 px]]

# Заполните поля. Чтобы создать несколько мест с одинаковыми параметрами, укажите количество таких мест в поле '''Количество'''.
# Нажмите на кнопку '''Сохранить'''.

=== Настройка стоимости доставки ===
Вы можете настроить стоимость доставки в зависимости от итоговой суммы выкупа в заказе:
* для конкретного заказа — при оформлении заказа укажите условия в блоке полей '''Настройка стоимости доставки'''. Эта настройка имеет приоритет перед правилами тарификации клиентов;
* для заказов, отвечающих определенным вами условиям — настройте правила в пункте основного меню '''[[#Цена доставки для получателя|Цена доставки для получателя]]'''.

Чтобы настроить стоимость доставки конкретного заказа:

# При оформлении заказа в блоке полей '''Настройка стоимости доставки''' нажмите на кнопку '''Добавить условие'''.
# В поле '''Сумма выкупа менее''' укажите пороговую сумму выкупа, а в поле '''Стоимость доставки''' — соответствующую стоимость доставки.
# Чтобы добавить следующий диапазон стоимости, нажмите на кнопку '''Добавить условие''' и укажите сумму выкупа и стоимость доставки. Количество условий неограниченно.
# Заполните поле '''Стоимость при полном возврате'''.

[[Файл:ЛК Настройка стоимости.png|800 px|none]]

=== Проверка благонадежности получателей ===
При оформлении заказа [[#Создание заказа вручную|вручную]] вы можете увидеть оценку благонадежности покупателя. Она складывается из соотношения выкупленных и невыкупленных заказов при использовании услуг разных курьерских служб. Заказы с наложенным платежом имеют больший вес.

Оценка отображается в пункте основного меню '''Оформить заказ''' в поле '''Телефон получателя''' в виде цветного круга. Цветовая схема:

* зеленый — высокий рейтинг;
* желтый — нейтральный рейтинг;
* красный — низкий рейтинг.

При наведении указателя мыши на цветной круг отображается процент рейтинга. Нейтральным считается значение 40-60 %, значения ниже попадают в красную зону, выше — в зеленую.

'''Примечания'''.
* Рейтинг 50 % может быть реальным рейтингом покупателя или индикатором отсутствия данных.
* Рейтинг зависит от статуса заказа (доставлен/отменен), типа оплаты/предоплаты, количества попыток вручения курьером. При этом каждый из факторов имеет разный вес, поэтому отмененный заказ сильнее влияет на отрицательный рейтинг, чем такой же доставленный заказ — на положительный.

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

Чтобы отследить заказы, выберите пункт основного меню '''Отслеживание'''. Откроется страница «Отслеживание». Установите параметры поиска и нажмите на кнопку '''Вывести'''. Поддерживается интервал дат не более 60 дней.

'''Примечание'''. При поиске по номеру или названию интервал дат не учитывается.

В результате откроется таблица заказов, удовлетворяющих указанным критериям:

[[Файл:Отслеживаемые.png|none|1100px]]

Подсветка статуса трекинга заказов определяется в [[Учет_корреспонденции#Адреса|офисной системе]].

На этой странице вы можете:
* просмотреть информацию по заказу. Подробнее см. «[[#Просмотр информации о заказе|Просмотр информации о заказе]]»;
* редактировать заказ. Для этого в строке заказа слева нажмите на кнопку [[Файл:Pencil.png]]. Откроется окно «Изменение заказа».
* изменить условия поиска отслеживаемых заказов. Для этого в названии страницы '''Отслеживание''' нажмите на кнопку [[Файл:Arrow.png]]. Раскроется область выбора отслеживаемых заказов;
* распечатать накладные, ярлыки, акты приема-передачи заказов или ТМЦ для выбранных заказов. Подробнее см. раздел «[[Личный кабинет клиента#Печать документов|Печать документов]]»;
* сохранить информацию о заказах в документ Microsoft Excel. Для этого установите флажки слева от нужных заказов и нажмите на кнопку '''Экспорт Excel''' > '''Заказы''';
* сформировать отчет о кодах маркировки «Честный ЗНАК». Чтобы создать отчет, нажмите на кнопку '''Экспорт Excel''' > '''Коды «Честный ЗНАК»'''. Если нужен отчет только по некоторым заказам, предварительно отметьте их флажком. Возвраты в отчет не включаются;
* сформировать XML-файл, содержащий коды маркированных товаров, подлежащих выводу из системы «Честный ЗНАК». Чтобы создать файл, нажмите на кнопку '''Экспорт Excel''' > '''Вывод из оборота «Честный ЗНАК»'''. Подробнее см. раздел «[[Честный ЗНАК#Вывод проданных товаров из оборота|Честный ЗНАК]]»;
* отменить выбранные заказы. Для этого установите флажки слева от нужных заказов и нажмите на кнопку '''Отменить заказы'''.

=== Просмотр информации о заказе ===
Чтобы увидеть информацию по заказу, кликните в любом месте строки заказа. Откроется окно «Подробности заказа». В этом окне вы можете:
* подписаться на уведомления о статусе заказа в Telegram-канале или браузере. Для этого нажмите на кнопку [[Файл:Telegram.png|25 px]] или [[Файл:Browser push.png|25 px]] соответственно;
* просмотреть и распечатать накладные по заказу. Для этого нажмите на кнопку '''Накладные'''.

=== Печать документов ===
Чтобы распечатать документы, установите флажки слева от заказов и нажмите на соответствующую кнопку внизу страницы, затем в окне предпросмотра документа нажмите на кнопку '''Печать'''.

Если ни один заказ не отмечен, то сформируются документы для всех заказов, отображаемых в таблице.

Ярлыки (наклейки), доступные по умлочанию:
* '''[[Оборудование#Термопринтер|Zebra]]''' — для печати на термопринтере. Zebra предполагает печать ярлыков по одному на листе. Размер наклеек 58×40 мм.
* '''А4''' — для печати на листе формата А4. Ярлыки печатаются на одном или нескольких листах. Размер наклеек 62×30 мм.

Кроме того, форма наклейки может быть изменена посредством изменения настройки <mparam code="StickerForm"/>.

'''Примечание'''. Печатные формы наклеек 5 и 6 являются относительно старыми и не настраиваются в ЛК курьерской службы.

'''Примечание'''. Печатные формы для заборов не формируются.

<spoiler text="Как формируются штрихкоды">В личном кабинете формируется штрихкод стандарта Code128. При этом к штрихкоду накладной добавляются 3 символа, которые обозначают номер места в заказе.</spoiler>

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

Агент курьерской службы — это склад, ПВЗ, подрядчик или филиал курьерской службы. Для агента должны быть созданы карточки [[Клиенты и партнеры|клиента]] и [[Филиалы|филиала]] в офисной системе, а в передаваемом заказе филиал агента должен быть указан в поле '''Ответственный филиал'''. В карточке клиента установите [[Клиенты и партнеры#Прочее|логин и пароль]] для входа в личный кабинет и передайте их агенту.

Чтобы отследить входящие заказы, войдите в ЛК под учетной записью агента, выберите пункт основного меню '''Входящие''', установите параметры поиска и нажмите на кнопку '''Вывести'''. Откроется таблица заказов, удовлетворяющих указанным критериям:

[[Файл:ЛК Входящие таблица.png|none|1100 px]]

На этой странице вы можете:
* просмотреть информацию по заказу. Для этого кликните в любом месте строки заказа. Откроется окно «Подробности заказа». Подробнее см. раздел «[[Личный кабинет клиента#Действия с входящими заказами|Действия с входящими заказами]]»;
* изменить условия поиска отслеживаемых заказов. Для этого в названии страницы «Отслеживание» нажмите на кнопку [[Файл:Arrow.png]]. Раскроется область выбора отслеживаемых заказов;
* распечатать накладные и ярлыки для выбранных заказов. Подробнее см. раздел «[[Личный кабинет клиента#Печать документов|Печать документов]]»;
* сохранить информацию о заказах в документ Microsoft Excel. Для этого установите флажки слева от нужных заказов и нажмите на кнопку '''Экспорт в MS Excel'''.

=== Действия с входящими заказами ===
Чтобы начать работу с входящим заказом, на странице «Отслеживание» кликните в любом месте строки заказа. Откроется окно «Подробности заказа». В этом окне вы можете:
* просмотреть и распечатать накладные;
* изменить статус заказа;
* проставить дату и время доставки, добавить информацию о доставке;
* прикрепить файлы по заказу;
* просмотреть и скачать прикрепленные файлы, в том числе фотографии с <rspoiler text="курьерских устройств">[[Мобильное приложение курьера для Android]] и [[Мобильное приложение курьера для IPhone]]</rspoiler>;
* увидеть <rspoiler text="текущее положение курьера">Информация обновляется каждые 5 минут.</rspoiler>.

После внесения изменений нажмите на кнопку '''Сохранить''', затем '''Закрыть'''.

=== Приемка заказов ===
Агент курьерской службы может принять поступившие в филиал заказы.

Для этого в пункте основного меню '''Входящие''' на панели слева выберите '''Прием''' и последовательно отсканируйте штрихкоды принимаемых отправлений.

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

[[Файл:ЛК ПВЗ.png|1100 px|none]]

Информация в таблице доступна только для ознакомления.

Чтобы скрыть ПВЗ филиала, раскройте выпадающий список поля '''Любое подчинение''' и справа от названия компании нажмите на кнопку [[Файл:Отключить пвз.png]]. Все ПВЗ филиала будет отключены и скрыты во всех разделах и API-запросах.

Чтобы увидеть расположение ПВЗ на карте, нажмите кнопку '''На карте'''. Откроется окно следующего вида:

[[Файл:pvz026.png|none|600px]]

Чтобы выбрать ПВЗ при [[#Создание заказа вручную|оформлении заказа вручную]], укажите город получателя и в поле '''Вид доставки''' выберите ПВЗ из выпадающего списка. В нем отображаются ПВЗ для указанного города.

Подробнее см. раздел «[[Работа с пунктами самовывоза (ПВЗ)|Работа с пунктами самовывоза]]».

== Складской учет ==
С помощью пункта основного меню '''Склад''' вы можете:
* создать новую карточку номенклатуры — нажмите на кнопку '''Создать''';
* просмотреть движение номенклатуры — щелкните в строке соответствующего товара. Откроется окно «Движение номенклатуры». Вы можете просмотреть детали заказов, в составе которых есть этот товар, и распечатать накладные;
* распечатать наклейку — в строке товара слева нажмите на кнопку [[Файл:ЛК Печать.png]];
* экспортировать список товарных позиций в документ Microsoft Excel — нажмите на кнопку '''Экспорт в MS Excel'''.

[[Файл:ЛК Склад.png|1100 px|none]]

Склад представлен в виде таблицы с указанием количества остатков товаров и остатков с учетом [[Модуль складского учета#Резерв товаров на складе|резерва]]. Информация в таблице доступна только для ознакомления.

Вверху справа можно отфильтровать товары по доступности, артикулу, наименованию и филиалу.

Товары добавляются на склад курьерской службой после постановки товара на приход.

== Финансы ==
Раздел предназначен для просмотра [[Акты передачи денег и корреспонденции|актов передачи денег клиентам (АПД)]].

[[Файл:ЛК Финансы.png|1000 px|none]]

Чтобы просмотреть информацию, укажите период дат и нажмите на кнопку '''Вывести'''. Отобразится таблица с АПД.

Чтобы просмотреть список заказов, входящих в АПД, щелкните в строке акта. Откроется окно «Акт передачи денег». В этом окне вы можете:
* просмотреть подробности заказа — щелкните в строке заказа;
* выгрузить таблицу АПД в документ Microsoft Excel — нажмите на кнопку '''Выгрузить в Excel'''.

== Калькулятор ==
Предназначен для расчета стоимости и сроков доставки.

Чтобы рассчитать стоимость и срок доставки:
# В пункте основного меню '''Калькулятор''' заполните форму расчета: [[Файл:ЛК Калькулятор.png|1100 px|none]]
# Чтобы вывести расчет стоимости для вашей компании, установите флажок '''Тарифицировать как клиента'''. Чтобы рассчитать цену для конечного получателя, снимите флажок. В расчете будут учтены правила тарификации, заданные в разделе «[[#Цена доставки для получателя|Цена доставки для получателя]]».
# Нажмите на кнопку '''Рассчитать'''.

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

== Тикеты ==
Предназначен для связи со службой техподдержки.

По умолчанию открывается вкладка '''Получен ответ''' с тикетами, в которых есть новые сообщения.

Слева расположены еще две вкладки: '''Решаются''' и '''Закрытые''' с тикетами соответствующих статусов.

На всех вкладках отображаются две таблицы. В таблице слева — отобранные фильтром тикеты. В таблице справа — список сообщений выделенного тикета с указанием автора и времени создания. Чтобы посмотреть текст сообщения, щелкните по
соответствующей строке таблицы. Чтобы задать дополнительный вопрос или ответить на сообщение, введите текст в пустое поле и нажмите на кнопку '''Ответить'''.

Чтобы создать тикет, слева нажмите на кнопку '''Новый'''. В открывшемся окне введите тему и текст обращения и нажмите на кнопку '''Сохранить'''. Запрос появится в списке тикетов на вкладке '''Решаются''' со статусом '''Новый'''.

Чтобы прекратить работы по тикету, нажмите на кнопку '''Закрыть'''.

Чтобы искать тикеты по слову, фразе или номеру тикета, заполните поле '''Строка поиска''' или '''Номер тикета''' и нажмите на кнопку '''Фильтровать'''.

Чтобы вернуться к списку тикетов по умолчанию, нажмите на кнопку '''Сбросить'''.

== Настройки ==

=== Цена доставки для получателя ===
Функциональность предназначена для настройки стоимости и срока доставки в зависимости от условий доставки и суммы выкупа заказа. Правила работают следующим образом:
# Стоимость доставки определяется по тарифу курьерской службы.
# Если заказ попадает под действие правила, к стоимости доставки добавляется установленная наценка или скидка и срок доставки продлевается на указанное количество дней.<br>Чтобы попасть под действие правила, заказ должен соответствовать указанным критериям: стоимость доставки, регион или населенный пункт, имя покупателя или название группы покупателей.<br>Если заказ соответствует условиям нескольких правил, приоритет имеет правило для покупателя, затем для группы покупателей.
# Покупатель видит рассчитанную с учетом правил цену и оформляет заказ.
# Окончательная цена доставки зависит от переключателя '''Применять правила''':
#* если переключатель установлен в положение '''При расчете стоимости доставки''', покупатель платит за доставку сумму, рассчитанную при оформлении заказа или указанную вручную в заказе администратором магазина. Например, администратор сделал скидку за большой заказ и вручную изменил стоимость доставки в заказе;
#* если переключатель установлен в положение '''При расчете стоимости доставки и при передаче заказа в MeaSoft''', при передаче заказа в MeaSoft стоимость доставки рассчитывается заново с учетом настроек правила. Изменения цены продавцом при этом не учитываются.

;
Вы можете проверить работу правила при расчете стоимости и срока доставки в пункте основного меню '''[[#Калькулятор|Калькулятор]]'''со снятым флажком '''Применить цену для клиента'''. В результате меняется срок и цена доставки.

Правила формирования цены для получателя не влияют на стоимость услуг курьерской службы.

[[Файл:Тарификация клиентов.png|1220 px|none]]

Чтобы добавить новое правило:
# Нажмите на кнопку '''Добавить'''.
# Установите положение переключателя '''Применять правила'''.
# В блоке '''Настройка условий доставки''' выберите вид стоимости доставки, который учитывается правилом:
#* '''Стоимость доставки от''' — учитывается стоимость доставки с наценками и дополнительными услугами;
#* '''Базовая цена от''' — учитывается базовая стоимость доставки, без наценок.
# В текстовом поле укажите минимальное значение выбранного вида стоимости доставки, для которого действует правило.
# В блоке '''Регион или населенный пункт''' укажите населенные пункты или области, для которых действует правило.
# В блоке '''Покупатель''' укажите клиентов из вашей системы, для которых действует правило. Это поле работает только для API-запросов [[API#Оформление заказа|создания заказа]] и [[API#Расчет стоимости доставки|расчета стоимости доставки]].
# В блоке '''Группа покупателей''' укажите группы клиентов из вашей системы, для которых действует правило. Это поле работает только для API-запросов создания заказа и расчета стоимости доставки.
# В блоке '''Настройка стоимости и срока доставки''':
#* выберите, к базовой или полной стоимости доставки применяется условие;
#* задайте стоимость доставки в зависимости от суммы выкупа;
#* укажите количество дней, которое нужно прибавить к расчетному сроку доставки.
#: Чтобы добавить порог выкупа, нажмите на кнопку '''Добавить условие''' и введите условие расчета суммы.
#: Чтобы удалить строку условия, нажмите на кнопку [[Файл:Delete.png]].
# В блоке '''Округление''' настройте округление рассчитанной по правилу суммы доставки. Возможные значения:
#* '''Не округлять''';
#* '''Вверх'''. Например, при округлении до 100 120 руб. и 170 руб. округляются до 200 руб.;
#* '''Вниз'''. Например, при округлении до 100 120 руб. и 170 руб. округляются до 100 руб.;
#* '''Математически'''. Например, при округлении до 100:<br>120 руб. округляется до 100 руб.,<br>170 руб. округляется до 200 руб.
# Нажмите на кнопку '''Cохранить'''.

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

=== Интеграция ===
Пункт основного меню предназначен для управления подключением по [[API]].

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

Пункт меню '''Интеграция''' содержит следующие вкладки:
* '''Список интеграций''' — список модулей интеграции с популярными CMS-системами. Для настройки модуля понадобится указать [[Настройка личного кабинета#Подключение|код курьерской службы]], а также имя пользователя и пароль от личного кабинета;
* '''Настройки интеграции''' — списки всех доступных и ваших настроенных интеграций. Настройки интеграции для каждого модуля свои и описаны в [[API#Готовые интеграции|инструкциях по установке модулей]];
* ''' Отладка''' — на этой странице вы можете пробовать выполнять запросы к API для отладки, а также видеть историю запросов, отправленных с вашего аккаунта и с текущего IP-адреса.

[[Файл:Интеграция отладка.png|1000px|none]]

=== Изменение пароля ===
Чтобы изменить пароль от личного кабинета, в пункте основного меню '''Пароль''' введите старый пароль, новый пароль и подтвердите его повторным вводом.

=== Общие настройки ===
Раздел содержит настройки, которые действуют для всех заказов.

'''Текст поручения по умолчанию'''. Текст поручения, который будет добавляться в поле '''Поручение''' во всех новых заказах на доставку, создаваемых любым способом в ЛК и через API. Автотекст добавляется при сохранении заказа. Если при оформлении заказа пользователь сам заполнил поле '''Поручение''', автотекст добавляется перед текстом клиента.

== Информация ==
Содержит сообщения от курьерской службы.

Информационные сообщения бывают двух видов:

* обычные — отображаются в виде счетчика непрочитанных сообщений в названии пункта меню;
* срочные — при входе в ЛК отображается информационное окно. Чтобы закрыть его, нажмите кнопку '''Да, понятно'''. Так вы сообщите курьерской службе, что прочитали новость.

[[Файл:Срочная новость.png|none|600px]]

== Создание заказа с параметрами ==
Вы можете создать ссылку на заказ с предустановленными параметрами, которые будут переданы в соответствующие поля формы.

Например, при переходе по ссылке <code><nowiki>https://home.courierexe.ru/8/order/new?order[receiver][person]=Иванов&order[receiver][town]=Санкт-Петербург&order[sender][town]=Самарканд</nowiki></code> откроется форма создания заказа с заполненными полями:
* '''ФИО получателя''' — Иванов;
* '''Город отправителя''' — Самарканд;
* '''Город получателя''' — Санкт-Петербург.

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

Вид ссылки:
https://home.courierexe.ru/<экстра-код>/order/new?Параметр1=Значение1&Параметр2=Значение2

Максимальная длина ссылки не определена, ищите информацию для своего браузера. Если лимит превышен, не все передаваемые данные появятся в форме.

Соответствие полей формы и параметров запроса:
{|class=wikitable
!Поле формы заказа
!Параметр запроса в URL
|-
|Номер заказа||order[@attr][orderno]
|-
|Вложение||order[enclosure]
|-
|Штрихкод||order[barcode]
|-
|Компания-отправитель||order[sender][company]
|-
|Контактное лицо отправителя||order[sender][person]
|-
|Город отправителя||order[sender][town]
|-
|Адрес отправителя||order[sender][address]
|-
|Телефон отправителя||order[sender][phone]
|-
|Дата забора||order[sender][date]
|-
|Время забора с||order[sender][time_min]
|-
|Время забора до||order[sender][time_max]
|-
|ИНН получателя||order[receiver][inn]
|-
|Компания-получатель||order[receiver][company]
|-
|Контактное лицо получателя||order[receiver][person]
|-
|Телефон получателя||order[receiver][phone]
|-
|Город получателя||order[receiver][town]
|-
|Вид доставки||order[pvz]
|-
|Адрес получателя||order[receiver][address]
|-
|Индекс получателя||order[receiver][zipcode]
|-
|Режим доставки||order[service]
|-
|Вес||order[weight]
|-
|Сумма||order[price]
|-
|Дата доставки||order[receiver][date]
|-
|Время доставки с||order[receiver][time_min]
|-
|Время доставки до||order[receiver][time_max]
|-
|Объявленная ценность|| order[inshprice]
|-
|Поручение||order[instruction]
|-
|Тип оплаты||order[paytype]
|-
|Общий объем||order[overall_volume]
|-
|Количество мест||order[quantity]
|-
|Тип отправления||order[type]
|-
|Оплата получателем||order[ReceiverPays]
|-
|Прикрепленные файлы||order[attachments]
|-
|Отдел||order[otdel]
|-
|Интервал времени доставки||order[receiver][time_range]
|-
|Частичная доставка||order[acceptpartially]
|-
|Настройка стоимости доставки||order[deliveryset]
|-
|Вес возврата||order[return_weight]
|-
|Кост-код||order[costcode]
|-
|Код подрядчика||order[outstrbarcode]
|-
|Необходимость возврата||order[flag]
|-
|Режим возврата||order[modev]
|-
|Тип возврата||order[typev]
|-
|Пин-код||order[receiver][deliveryPIN]
|-
|colspan=2|'''Товары'''
|-
|Артикул товара||order[items][N][@attr][article] (обязательно наличие, может быть пусто)
|-
|Название товара||order[items][N][item]
|-
|Количество||order[items][N][@attr][quantity]
|-
|Масса единицы товара, кг||order[items][N][@attr][mass]
|-
|Цена единицы товара||order[items][N][@attr][retprice]
|-
|Ставка НДС||order[items][N][@attr][VATrate]
|-
|Штрихкод||order[items][N][@attr][barcode] (обязательно наличие, может быть пусто)
|-
|Длина, см||order[items][N][@attr][length]
|-
|Ширина, см||order[items][N][@attr][width]
|-
|Высота, см||order[items][N][@attr][height]
|-
|Код товарной номенклатуры||order[items][N][@attr][governmentCode]
|-
|Тип вложения (числовой код)||order[items][N][@attr][type]
|-
|colspan=2|'''Места'''
|-
|Название||order[packages][N][package] (обязательно наличие, может быть пусто)
|-
|Масса, кг||order[packages][N][@attr][mass]
|-
|Штрихкод||order[packages][N][@attr][strbarcode] (обязательно наличие, может быть пусто)
|-
|Длина, см||order[packages][N][@attr][length]
|-
|Ширина, см||order[packages][N][@attr][width]
|-
|Высота, см||order[packages][N][@attr][height]
|-
|}

== Работа с таблицами ==
Чтобы применить сортировку по тому или иному параметру, кликните на название соответствующей колонки.

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

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

API

2022-05-31T14:56:44Z

Olga:

<div style="font-size: 18px; color: #a92424; background-color: #ffdede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
'''Изменения для 54-ФЗ'''

Для передачи ставки НДС при оформлении заказа добавлен атрибут items > item > VATrate.

При использовании услуги кассового обслуживания необходимо в обязательном порядке передавать состав заказа со ставками НДС.

'''ВНИМАНИЕ'''

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

</div>

<div style="font-size: 24px; color: #2424a9; background-color: #deffde; border: 1px solid #ebccd1; padding: 3px 10px 10px; text-align: center">
'''English version is [[API Documentation|HERE!]]'''
</div>

Вы можете настроить интеграцию с MeaSoft средствами XML API по протоколу HTTP POST.

API предназначено для интеграции клиентов (интернет-магазинов и прочих компаний-заказчиков доставки) с [http://courierexe.ru/our_clients.htm курьерскими службами], работающими под управлением системы [https://curie.ru/ MeaSoft].

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

Если вы '''подрядчик''', вы можете забирать заказы, используя значение client=AGENT в запросе [[#Пример запроса статуса заказа|statusreq]], и передавать статусы заказов, используя метод [[#Изменение статуса агентом|setorderinfo]]. Также для интеграций с подрядчиками у нас есть специальная платформа, но добавлять подрядчиков в нее можно только на нашей стороне. Присылайте нам коммерческое предложение, описание вашего сервиса, и мы с радостью его рассмотрим.

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

Если у вас после прочтения документации остались вопросы, задайте их по почте [mailto:support@courierexe.ru support@courierexe.ru]. Обязательно представьтесь, напишите ваши контактные данные (телефон, скайп) и название компании, с которой вы хотите интегрироваться.

== Готовые интеграции ==
Для работы с популярными CMS и CRM-системами разработаны модули интеграции, перечисленные в таблице ниже.

'''Модули распространяются бесплатно, без гарантий со стороны разработчика''', и не являются средством полной автоматизации взаимодействия с курьерской службой. Модули — это помощь разработчикам интернет-магазинов в построении интеграции с курьерскими службами. '''Ответственность за корректность передачи данных лежит на интернет-магазине.'''

Сообщайте нам свои пожелания по работе наших модулей. Мы учтем их в новых версиях.

{| class="wikitable" align="center" style="width: 80%; margin: auto; background-color:#ffffff; border: 1px solid #999999;" cellpadding="10" cellspacing="0"
!style="width: 35%;"|Система управления контентом (CMS)
!style="width: 15%;"|Ссылка
!style="width: 35%;"|Примечание
|-
|[[Файл:bitrix.png|center|x44px]]
|style="text-align: center;" | [https://marketplace.1c-bitrix.ru/solutions/measoft.courier/ Установить] 
|Поддерживает версии 14.5 и выше. Подробнее см. [[1C-Битрикс|описание]].
|-
|[[Файл:prestashop.png|center|x60px]]
|style="text-align: center;"|[https://courierexe.ru/download/api/prestashop.zip Скачать]
|Поддерживает версии 1.5.2.0 и выше.
|-
|[[Файл:OpencartOCStore.png|center|x60px]]
|style="text-align: center;"|[https://courierexe.ru/download/api/opencart.zip Скачать для версии 1.5.5.1]<br>[https://courierexe.ru/download/api/measoft_oc2.ocmod.zip Скачать для версии 2.0]<br>[https://courierexe.ru/download/api/measoft_oc2.3.ocmod.zip Скачать для версии 2.3]<br>[https://courierexe.ru/download/api/measoft_ос3.ocmod.zip Скачать для версии 3.0]
|Поддерживает версии с 1.5.5.1.<br>Скачивайте модули для своей версии OpenCart.<br>Подробнее см. [[OpenCart|описание]].<br>[https://opencartforum.com/files/file/2906-avtomatizaciya-otpravki-i-otslezhivanie-dostavok-courierexe-dlya-opencart-15x/ Альтернативный модуль сторонних разработчиков]
|-
|[[Файл:webasyst-shopscript.png|center|x44px]]
|style="text-align: center;"|[https://www.webasyst.ru/store/plugin/shop/measoftcourier/ Установить модуль]<br>[https://www.webasyst.ru/store/plugin/shipping/measoftcourier/ Установить плагин]
|Модуль предназначен для отправки заявок в КС, а плагин для расчета стоимости доставки при оформлении заказа.
|-

|[[Файл:insales.png|center|x80px]]
|style="text-align: center;"|Настраивается в [[Личный кабинет клиента|ЛК пользователя]]
|[[InSales|Инструкция по настройке]]
|-
|[[Файл:Leadvertex.png|center|x44px]]
|style="text-align: center;"|[https://blog.leadvertex.ru/news/2110-integraciya-s-kurerkami-na-platforme-measoft Настраивается] в ЛК [https://Leadvertex.ru Leadvertex]
|[[LeadVertex|Инструкция по настройке]]<br>Модуль разработан и поддерживается компанией LeadVertex.
|-
|[[Файл:Retailcrm.png|center|x30px]]
|style="text-align: center;"|[https://www.retailcrm.ru/ RetailCRM]
|[[RetailCRM|Настраивается]] в ЛК пользователя в системе
|-
|[[Файл:1C.jpg|center|x44px]]
|style="text-align: center;"|-
|[https://infostart.ru/public/692790/ Альтернативный модуль сторонних разработчиков (1 версия)]

[https://infostart.ru/public/1531484/ Альтернативный модуль сторонних разработчиков (2 версия)]
|-
|[[Файл:Joomla2.jpg|center|x60px]]
|style="text-align: center;"|[https://courierexe.ru/download/api/com_measoft.zip Скачать]
|Работает только с компонентом Virtuemart.
|-
|[[Файл:Amocrm.png|center|x44px]]
|style="text-align: center;"|[https://www.amocrm.ru/extensions/courier2008 Установить]
|Подробнее см. [[amoCRM|описание]].
|-
|rowspan="2"|[[Файл:MoySclad.jpg|center|x30px]]
|style="height:50px; text-align: center;"|[https://home.courierexe.ru/moysklad/step1 Настроить интеграцию с MeaSoft]
|[[МойСклад|Инструкция]]
|-
|style="height:50px; text-align: center;"|[https://itmdev.ru/ms/shipping/ Скачать модуль сторонних разработчиков]
|Интеграция МойСклад с курьерскими службами от сторонних разработчиков
|-
|[[Файл:wordpress.jpg|center|x80px]]
|style="text-align: center;"|[https://courierexe.ru/download/api/wordpress.zip Скачать]
|[[Wordpress|Инструкция]]
|-
|[[Файл:Cscart.png|center|x60px]]
|style="text-align: center;"|[https://marketplace.cs-cart.com/measoft-en.html Установить]
|Поддерживает версии 4.10 и выше.<br>[[CS-Cart|Инструкция]]
|-
|style="height:100px; text-align: center;"|'''Webhook'''
|style="text-align: center;"|Читайте описание [[Webhook|на этой странице]]
|Передача информации о статусах и заказах в вашу систему
|-
|}

'''Обратите внимание!''' В модулях систем PrestaShop и Joomla для отправки заказа в курьерскую службу зайдите в карточку заказа. В карточке отображается специальная форма отправки заказа, а если заказ отправлен, она позволяет проверить его статус:[[Файл:Form.png|400 px|Форма отправки заказа|none]]

Для отображения списка пунктов выдачи есть [https://home.courierexe.ru/js/measoft_map.js JavaScript модуль]. Инструкция по использованию — внутри. Посмотреть пример работы можно [https://home.courierexe.ru/pvz_test.html здесь].

== Тестовый аккаунт ==
Для отладки зайдите в тестовый личный кабинет по адресу [https://home.courierexe.ru/8 https://home.courierexe.ru/8], логин: login пароль: pass.

На вкладке '''Интеграция''' > '''Отладка''' вы можете пробовать выполнять запросы к API для отладки, а также видеть историю отправленных запросов. Созданные заказы появятся в пункте основного меню '''Отслеживание'''.

Для упрощения интеграции можно скачать [https://courierexe.ru/download/api/php_sample.zip пример обращения к сервису на PHP].

== Рабочий аккаунт для подключения ==
Строка подключения выглядит следующим образом:

<source lang=xml>
<auth extra="8" login="login" pass="pass"></auth>
</source>

Описание параметров:
* '''extra''' — экстра-код, уникальный идентификатор компании, с которой вы интегрируетесь.
* '''login''' — логин клиента;
* '''pass''' — пароль клиента.

Запросите эти данные у курьерской службы, к которой вы подключаетесь. Курьерская служба передает временный пароль, его нужно сменить после первого входа в [[Личный кабинет клиента|ЛК клиента]].

== Авторизация курьерской службы ==
Если курьерской службе требуется подключение под своими учетным данными, используйте строку вида:

<source lang=xml>
<auth extra="8" login="login" pass="pass" clientcode="123"></auth>
</source>

Описание:
* '''extra''' — уникальный идентификатор компании;
* '''login''' — логин курьерской службы;
* '''pass''' — пароль курьерской службы;
* '''clientcode''' — внутренний код клиента (вкладка '''Клиенты''', столбец «Внутренний код»).

Вы можете узнать код экстра, логин и пароль курьерской службы в офисном приложении MeaSoft в справочнике '''Дополнительные возможности'''. Подробнее см. раздел «[[Личный кабинет курьерской службы#Подключение|Подключение]]».

== Общие понятия ==
На стороне курьерской службы имеется веб-сервис по адресу: https://home.courierexe.ru/api/. <rspoiler text="Еще есть порт 8443.">Некоторые маршрутизаторы, используемые провайдерами, РНК и прочее, в попытке глубокого анализа могут повреждать трафик на стандартный порт 443. Сделано по тикету 10964.</rspoiler> Обратите внимание на символ '''«/»''' (slash) в конце адреса.

Тестовые авторизационные данные: логин: login пароль: pass, параметр extra: 8. Обратите внимание, что тестовая площадка для всех одна. Не нужно передавать в нее заказы с конфиденциальными данными, их смогут увидеть другие участники.

Для использования интеграции в «боевом» режиме, запросите '''логин''', '''пароль''', и параметр '''extra''' у той компании, с которой интегрируетесь.

Вы можете отправлять тестовые запросы к нашему сервису и видеть историю отправленных запросов в личном кабинете на закладке '''Интеграция'''.

Клиент отправляет запросы к сервису методом HTTP POST, сервис обрабатывает запросы и возвращает результат выполнения. Все запросы и ответы передаются в формате XML.
Кодировка — UTF-8. Разделитель целой и дробной частей чисел — используется символ точки. Даты представляются в виде YYYY-MM-DD, время — HH:MM.

В силу [https://ru.wikipedia.org/wiki/XML#.D0.A0.D0.B5.D1.88.D0.B5.D0.BD.D0.B8.D0.B5_.D0.BF.D1.80.D0.BE.D0.B1.D0.BB.D0.B5.D0.BC.D1.8B_.D0.BD.D0.B5.D0.BE.D0.B4.D0.BD.D0.BE.D0.B7.D0.BD.D0.B0.D1.87.D0.BD.D0.BE.D1.81.D1.82.D0.B8_.D1.80.D0.B0.D0.B7.D0.BC.D0.B5.D1.82.D0.BA.D0.B8 особенностей языка XML], некоторые символы в тексте должны быть заменены: & на &amp; < на &lt; > на &gt; " на &quot;

Наше API принципиально работает только по HTTPS, так как передает конфиденциальные данные. В некоторых системах с этим возникают проблемы. Если ваша система не может полноценно работать с шифрованием, мы рекомендуем развернуть http-сервер у себя локально, установить [http://courierexe.ru/download/api/proxy.zip прокси на PHP]. <spoiler text="Как запустить">Для теста можете запустить его на сервере следующей командой: php -S <IP>:8080 proxy.php
где <IP> — это адрес вашего сервера, а 8080 порт, на котором будут приниматься запросы.
Тогда для обмена данными с нашим АПИ необходимо будет использовать адрес <IP>:8080</spoiler>
Доступность функций, описанных в этом разделе, зависит от [[Личный кабинет курьерской службы#Функции личного кабинета|тарифа вашего личного кабинета]].

== Ограничения ==
С целью защиты от нецелевого использования сервисов и DDoS-атак действуют следующие ограничения:
* 30 запросов tracking с одного IP-адреса за 1 минуту (используйте statusreq!);
* 150 запросов с одного IP-адреса/акаунта за 1 минуту;
* 1500 запросов с одного IP-адреса/акаунта за 20 минут;
* 3000 запросов с одного аккаунта за 1 час;
* 200 Мб скачанных текстовых данных за 3 часа.
* Превышение количества запросов статусов несуществующих заказов над существующими

В случае превышения IP-адрес или аккаунт блокируется на время до 3-х часов.

Чтобы не происходило блокировок:
* не нужно «бомбить» наше API запросами статусов, последовательно перебирая номера всех ваших заказов, особенно запросами «tracking», они предназначены не для этого (смотрите описание). Особенно ровно в 00 минут каждого часа;
* не нужно каждые 5 минут делать запросы «Покажите статусы всех заказов за последние 3 месяца»;
* для проверки статусов заказов лучше всего использовать запросы [[#Передача только изменившихся статусов|измененных статусов changes=ONLY_LAST]];
* при запросе измененных статусов ОБЯЗАТЕЛЬНО нужно подтверждать успешное получение запросом [[#Передача только изменившихся статусов|commitlaststatus]].
* вы должны знать номера заказов, которые вы отправили. Не нужно перебирать номера всех заказов или брутфорсом перебирать все возможные номера.

Мы абсолютно уверены, что данные ограничения на порядки превосходят необходимые объемы предоставления сервиса для решения любых задач. Если у вас возникают проблемы, вы не знаете, как уложиться в эти рамки — спросите у нас, мы обязательно поможем!

== Оформление заказа ==

=== Пример оформления заказа ===
<source lang=xml>
<?xml version="1.0" encoding="UTF-8"?>
<neworder newfolder="NO">
<auth extra="8" login="login" pass="pass"></auth>
<order orderno="111111">
<barcode>111111</barcode>
<sender>
<company>МВД</company>
<person>Иванов И.И.</person>
<phone>123-45-67</phone>
<town>Санкт-Петербург</town>
<address>Петровка 38 офис 35</address>
<date>2014-03-22</date>
<time_min>09:00</time_min>
<time_max>14:00</time_max>
</sender>
<receiver>
<company>МВД</company>
<person>Чип & Дейл</person>
<phone>123-45-67</phone>
<zipcode>125480</zipcode>
<town regioncode="78" country="RU">Санкт-Петербург</town>
<address>Петровка 38 офис 35</address>
<pvz>124</pvz>
<inn>1112223335</inn>
<date>2014-03-22</date>
<time_min>09:00</time_min>
<time_max>14:00</time_max>
<deliveryPIN>1234</deliveryPIN>
<coords lat="55.680327" lon="37.604456"></coords>
</receiver>
<return>NO</return>
<weight>5.1</weight>
<return_weight>5.1</return_weight>
<quantity>2</quantity>
<paytype>CASH</paytype>
<service>2</service>
<return_service>1</return_service>
<type>3</type>
<return_type>3</return_type>
<courier>22</courier>
<price>387.5</price>
<deliveryprice VATrate="20">150</deliveryprice>
<inshprice>387.5</inshprice>
<receiverpays>NO</receiverpays>
<discount>120</discount>
<enclosure>Детские игрушки</enclosure>
<instruction>Проверить при покупателе, подписать акт</instruction>
<department>Отдел</department>
<pickup>NO</pickup>
<acceptpartially>NO</acceptpartially>
<costcode>cc12345</costcode>
<respstore>4</respstore>
<items>
<item extcode="abc123" quantity="1" mass="0.2" retprice="37.5" VATrate="0" barcode="2345625213125" textArticle="1" article="1" volume="3" origincountry="AUT" GTD="321546654" excise="15.20" suppcompany="ООО "Рога и копыта"" suppphone="79161234567" suppINN="1112223334" governmentCode="11223311">Мяч</item>
<item extcode="abc124" quantity="2" mass="2" retprice="100" inshprice="100" VATrate="10" barcode="4645625213138" article="2" length="10" width="20" height="30" origincountry="004">Обруч</item>
<item extcode="abc125" quantity="3" mass="0.3" retprice="50" inshprice="50" barcode="2345625213126" itemcode="44123" article="3" type="1">Погремушка желтая</item>
</items>
<packages>
<package strbarcode="ORD0000001" mass="1" message="" quantity="3"></package>
<package strbarcode="ORD0000002" mass="2.5" message="" length="10" width="20" height="30"></package>
</packages>
<deliveryset above_price="100" return_price="1000" VATrate="10">
<below below_sum="500" price="500" />
<below below_sum="2000" price="300" />
</deliveryset>
<advprices>
<advprice>
<code>1</code>
<value>123</value>
</advprice>
<advprice>
<code>2</code>
<value>10.5</value>
</advprice>
<advprice>
<code>3</code>
<value>true</value>
</advprice>
</advprices>
<overall_volume>81</overall_volume>
<userid>user123</userid>
<groupid>customer</groupid>
</order>
</neworder>
</source>

=== Описание элементов для оформления заказа ===
'''Обязательные поля'''

Обязательными на уровне системы являются только 3 поля: receiver->company или receiver->person, receiver->address и receiver->phone. Так же в настройках системы сама курьерская служба может назначить какие-то дополнительные поля обязательными, тогда, если вы их не укажете, получите сообщение об ошибке.
<spoiler text="Пример минимально возможного заказа">
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<neworder>
<auth extra="8" login="login" pass="pass" />
<order>
<receiver>
<company>МВД</company>
<phone>(495)123-45-67</phone>
<address>Петровка, 38</address>
</receiver>
</order>
</neworder>
</source>
</spoiler>

'''Описание полей'''

* '''neworder''' — Корневой контейнер, обязательный элемент.

:* '''''newfolder''''' — Признак нового заказа YES/NO. Если стоит YES, то в системе курьерской службы для данной корреспонденции создастся новый заказ. Необязательный элемент.

* '''order''' — Контейнер для описания одного заказа, обязательный элемент. В одном контейнере '''neworder''' может быть много контейнеров '''order''' для создания нескольких заказов одним запросом.

:* '''''orderno''''' — Номер заказа. Если присваивается клиентом — указывается здесь. Если не присваивается — можно оставить пустым, система сгенерирует свой номер, и вернет его в ответе. Система проверяет наличие заказов с указанным номером в пределах текущего календарного года, и в случае их существования — заказ создан не будет, а в ответе вернется ошибка 17 «Such number exists». Если не указан штрихкод (поле barcode), и значение поля подходит для использования его в качестве штрихкода, данное значение будет скопировано в поле «Штрихкод». Это накладывает ограничения в частности, на длину указанного поля (25 знаков, чтобы работали стандартные печатные формы).

* '''barcode''' — Штрихкод заказа. Если клиент штрихкодирует свои отправления и штрихкод отличается от номера заказа, в этом поле указывается штрихкод. В случае наличия нескольких мест и раздельной их маркировки в этом поле допустимы маски в виде символов подчеркивания, говорящие о позициях штрихкода, переменных для разных мест в рамках одного заказа.<br>
''Например'': В заказе номер 123 имеется 20 товарных вложений, которые упакованы в 3 транспортных места. Клиент формирует 3 штрихкода на транспортные места: CLNT0012301, CLNT0012302, CLNT0012303, где CLNT — префикс клиента, 00123 — номер заказа, 01-03 — номер транспортного места в заказе. В поле barcode нужно указать CLNT00123__ (система поймет, что 2 последних символа могут быть любыми и будут отражать штрихкоды к одному заказу). Если вы не сами печатаете накладные с указанным штрихкодом, то указанный штрихкод не должен быть длиннее 25 знаков, иначе он не поместится на стандартных печатных формах.

* '''sender''' — Информация о отправителе заказа. Необязательный контейнер.
<source lang="xml">
<sender>
<company>Название компании отправителя</company>
<person>Контактное лицо отправителя</person>
<phone>Телефон, Email отправителя</phone>
<town>Город отправителя в формате "Москва город"</town>
<address>Адрес отправителя</address>
<date>Дата забора в формате "YYYY-MM-DD"</date>
<time_min>Желаемое время забора в формате "HH:MM"</time_min>
<time_max>Желаемое время забора в формате "HH:MM"</time_max>
</sender>
</source>

* '''receiver''' — Информация о получателе заказа. Обязательный контейнер.
<source lang="xml">
<receiver>
<company>Название компании получателя</company>
<person>Контактное лицо получателя</person>
<phone>Телефон, Email получателя</phone>
<town regioncode="Код региона">Город получателя в формате "Москва город"</town>
<address>Адрес получателя</address>
<inn>ИНН получателя</inn>
<pvz>Код пункта самовывоза по справочнику</pvz>
<date>Дата доставки в формате "YYYY-MM-DD"</date>
<time_min>Желаемое время доставки в формате "HH:MM"</time_min>
<time_max>Желаемое время доставки в формате "HH:MM"</time_max>
<deliveryPIN>Пин-код для подтверждения получателем</deliveryPIN>
<coords lat="55.680327" lon="37.604456"></coords>
</receiver>
</source>

* '''company''' — Компания-получатель.
* '''person''' — Контактное лицо. ''Должно быть заполнено хотя бы одно из полей — company или person!''
* '''phone''' — Телефон. Можно указывать несколько телефонов, E-mail в этом поле.
* '''town''' — Город.
* '''pvz''' — Код пункта самовывоза по справочнику. Кроме того, ПВЗ можно указать в строке '''''address''''' в виде:
:* код ПВЗ в нашей системе
:* код ПВЗ в системе подрядчика
:* наименование ПВЗ в виде строки "ПВЗ " + «Наименование ПВЗ»

Для тега города '''town''' можно указать код региона в атрибуте '''''regioncode''''' из [[#Справочник регионов|справочника регионов]]. Поиск будет производиться в указанном регионе.

Также можно указать страну получателя в атрибуте '''''country''''' в соответствии с [https://ru.wikipedia.org/wiki/ISO_3166-1 стандартом ISO_3166-1], например, «RU», «RUS» или «643» для России.

Кроме того, поиск города осуществляется с учетом почтового индекса, указанного в теге '''zipcode'''.

Поле '''Город''' контейнеров '''sender''' и '''receiver''' можно указать одним из следующих способов:
:* код населенного пункта из [[#Справочник городов|справочника городов]]
:* 13-ти значный код адресного классификатора КЛАДР
:* 36-ти значный код адресной системы <rspoiler text="ФИАС">Федеральная информационная адресная система — единый российский государственный адресный реестр</rspoiler> (AOID)
:* название города (не рекомендуется!)

* '''coords''' — Координаты получателя. Если не указаны, система будет геокодировать самостоятельно.

* '''paytype''' — Тип оплаты заказа получателем. Принимает значения:
:* CASH — Наличными при получении (по-умолчанию)
:* CARD — Картой при получении
:* NO — Без оплаты. Этот тип оплаты передается, если заказ уже оплачен и не требует инкассации. API добавит к товарам строку предоплаты в сумму заказа, чтобы общая сумма была 0, однако в кассовом чеке будут все товары с ценами, и оплата предоплатой, как того требует 54-ФЗ.
:* OTHER — Прочее (Предусмотрен для того, чтобы оплата поступала непосредственно в курьерскую службу посредством прочих типов оплаты — таких как: вебмани, яденьги, картой на сайте, прочие платежные системы и т. д.)
:* OPTION — На выбор получателя. Этот тип оплаты нельзя передавать с заказом. Он выставляется автоматически в зависимости от настройки клиента.

* '''zipcode''' — Почтовый индекс.
* '''weight''' — Общий вес заказа в килограммах.
* '''return_weight''' — Общий вес возврата заказа в килограммах.
* '''quantity''' — Количество мест.
* '''service''' — Режим доставки (тип услуги) передается код из справочника «[[#Справочник Видов срочности|Виды срочности]]».
* '''return_service''' — Режим возврата (тип услуги) передается код из справочника «Виды срочности».
* '''type''' — Тип корреспонденции (отправления) передается код из справочника «Типы корреспонденции».
* '''return_type''' — Тип возвратной корреспонденции (отправления) передается код из справочника «Типы корреспонденции».
* '''price''' — Сумма заказа. В случае наличия контейнера items значение этого параметра будет проигнорировано и рассчитано автоматически.
* '''deliveryprice''' — Сумма доставки. В случае наличия контейнера items в него будет добавлено вложение «Доставка».
:* '''''VATrate''''' — Ставка НДС — целое число процентов.
* '''return''' — Признак необходимости возврата.
* '''return_service''' — Режим возврата (тип услуги) передается код из справочника «Виды срочности».
* '''discount''' — Сумма скидки. Скидка «размазывается» по товарным вложениям, сумма НП уменьшается на сумму скидки. При этом вложение Скидка не создается. ВНИМАНИЕ, при использовании этого тега общая сумма может расходиться на копейки из-за округления! Старайтесь не использовать этот тег, а указывать цену товаров уже с учетом скидок.
* '''enclosure''' — Вложение.
* '''inshprice''' — Объявленная ценность. Если явно не указана сумма — автоматически считается как сумма по товарам.
* '''instruction''' — Поручение — Примечание.
* '''courier''' — Запланированный курьер. Согласно коду курьера в КС2008.
* '''receiverpays''' — Признак оплаты стоимости доставки — услуг службы доставки получателем, а не заказчиком YES/NO.
* '''department''' — Подразделение, в котором оформляется заказ.
* '''pickup''' — Признак оформления забора YES/NO. Если стоит YES, то весь заказ считается заданием на забор груза, а не на доставку! Применяется для вызова курьера к отправителю для забора других отправлений. ''Внимание!'' при добавлении в забор складских товаров, их тип '''''type''''' всегда должен быть установлен как [7] Забор товара, если будет указан другой тип, то он будет исправлен в момент добавления заказа на [7] Забор товара
* '''acceptpartially''' — Признак возможности частичного выкупа товаров отправления YES/NO.

* '''items''' — Контейнер для описания вложений. <rspoiler text="Необязательный контейнер">Если для поставщика товара в системе MeaSoft не указаны полное наименование компании и ИНН в карточке клиента, заполните параметры <code>suppcompany</code> и <code>suppINN</code> в этом контейнере. Отсутствие информации о поставщике приведет к [[Настройка модуля печати кассовых чеков#Ошибка фискализации (ошибка программирования реквизита 1226)|ошибке фискализации]].</rspoiler>. Атрибуты:
:* '''''item''''' — Название вложения.
:* '''''quantity''''' — Количество единиц товара.
:* '''''mass''''' — Масса единицы товара в килограммах.
:* '''''volume''''' — Объемный вес единицы товара в килограммах. При указании объемного веса значение подставляется вместо массы
:* '''''length''''' — Длина единицы товара (в сантиметрах).
:* '''''width''''' — Ширина единицы товара (в сантиметрах).
:* '''''height''''' — Высота единицы товара (в сантиметрах).
:* '''''retprice''''' — Цена единицы товара. Округляется до копеек. Должна быть с учетом всех скидок и наценок. Для вложений типов 1, 2, 3 не может быть отрицательной. 
:* '''''inshprice''''' — Объявленная ценность единицы товара. Округляется до копеек. Если не указана принимается равной '''''retprice'''''.
:* '''''VATrate''''' — Ставка НДС — целое число процентов. Если значение не указано, подставляется значение «20». Значение «0» означает ставку «Без НДС», ставка «0%» на данный момент не поддерживается.
:* '''''barcode''''' — Штрихкод вложения. [[Файл:Article.png|thumb|100px|right]]
:* '''''article''''' — Артикул вложения. ''Внимание!'' Указание артикула используется только тогда, когда товар хранится на ответственном хранении в службе доставки, и необходима комплектация. В этом случае система пытается привязать товар к [[API#Справочник номенклатуры|справочнику номенклатуры]]. Если товар в справочнике не найден — система выдаст соответствующую ошибку. Если по артикулу найдено несколько товаров — система выберет один из них случайным образом, что может привести к ошибочной комплектации! Если товар НЕ на ответственном хранении — артикул указывать НЕ нужно. Позиция попадет в систему просто текстом.
:* '''''itemcode''''' — Внутренний код товара, может использоваться вместо артикула. ''Внимание!'' Указание кода товара используется только тогда, когда товар хранится на ответственном хранении в службе доставки, и необходима комплектация. В этом случае система пытается привязать товар к [[API#Справочник номенклатуры|справочнику номенклатуры]]. Если товар в справочнике не найден — система выдаст соответствующую ошибку. Если товар НЕ на ответственном хранении — код товара указывать НЕ нужно.
:* '''''type''''' — Тип вложения. Принимает значения:
:: 1 — Товар. По-умолчанию.
:: 2 — Доставка. Такое вложение добавится автоматически, если заполнить order->deliveryprice
:: 3 — Услуга
:: 4 — Предоплата. Указывается сумма. Поле quantity игнорируется, всегда «1». В заказе сумма будет отрицательной независимо от знака в запросе. Такое вложение добавится автоматически при указании order->paytype=NO.
:: 6 — Оплата кредитом. Указывается сумма. Поле quantity игнорируется, всегда «1». В заказе сумма будет отрицательной независимо от знака в запросе.
:: 7 — Забор товара. Если товар нужно у получателя забрать, возможно — вернуть деньги, или его стоимость вычтется из суммы других товаров. У такого товара в заказе будет отрицательное количество независимо от знака в запросе.
:* '''''extcode''''' — Внешний код строки. Используется для идентификации строк заказов при получении статусов. Необязательное поле.
:* '''''origincountry''''' — Код страны-производителя в соответствии со [https://ru.wikipedia.org/wiki/ISO_3166-1 стандартом ISO_3166-1], например, «RU», «RUS» или «643» для России.
:* '''''GTD''''' — Номер ГТД.
:* '''''excise''''' — Сумма акциза.
:* '''''suppcompany''''' — Наименование компании поставщика, если отличается от заказчика.
:* '''''suppphone''''' — Номер телефона компании поставщика, если отличается от заказчика.
:* '''''suppINN''''' — ИНН компании поставщика, если отличается от заказчика.
:* '''''governmentCode''''' — Код товарной номенклатуры. Используется для [[Маркировка|маркированных товаров («Честный знак»)]]. Нужно указывать все данные из нанесенного QR-кода кроме не читаемых символов (#29). Если код не известен — укажите знак вопроса «?», тогда курьер отсканирует код фактически передаваемого покупателю товара. Для некоторых процессов может использоваться значение «!» — в этом случае курьер сканирует серийный номер товара, но это не считается кодом маркировки. Если поле заполнено — поле quantity должно содержать только «1», иначе вернется ошибка.

* '''packages''' — Контейнер для описания мест. Необязательный контейнер. Атрибуты:
:* '''''package''''' — Название места.
:* '''''code''''' — Внутренний код строки.
:* '''''strbarcode''''' — Штрихкод места.
:* '''''mass''''' — Масса места в килограммах.
:* '''''message''''' — Строка сообщения.
:* '''''length''''' — Длина товарного места (в сантиметрах).
:* '''''width''''' — Ширина товарного места (в сантиметрах).
:* '''''height''''' — Высота товарного места (в сантиметрах).
:* '''''quantity''''' — Количество мест с данным набором параметров. Действует ограничение на общее количество мест в заказе. Общее количество мест в заказе не может быть больше 1000.

* '''deliveryset''' — настройка [[Дифференцированная стоимость доставки|дифференцированной стоимости доставки]]. Атрибуты:
:* '''''above_price''''' — стоимость в случае полного выкупа заказа (действует как «сумма от» последней границы, указанной в теге below_sum)
:* '''''return_price''''' — стоимость в случае возврата заказа
:* '''''VATrate''''' — Ставка НДС — целое число процентов.

* '''below''' — граница стоимости настроек
:* '''''below_sum''''' — граница стоимости выкупаемого заказа
:* '''''price''''' — стоимость выкупаемого заказа до соответствующей границы

* '''advprices''' — Контейнер для описания дополнительных услуг. Необязательный элемент. <span style="color: red;>Для обработки в API включите дополнительные услуги в настройках полей [[Личный кабинет курьерской службы#Настройка личного кабинета клиента|заказов и заборов]]</span>
:* '''''code''''' — код услуги.
:* '''''value''''' — значение услуги. Если тип услуги bool, то в значении передаем true.

* '''costcode''' — Кост-код сотрудника.
* '''respstore''' — Код ответственного филиала.

* '''overall_volume''' — Общий объем, м3. Виртуальное поле. Необязательное. Из этого поля рассчитывается длина/высота/ширина места. Расчет срабатывает только если в каждом месте есть нулевые значения длины или высоты или ширины.

* '''userid''' — Идентификатор пользователя, строковый или числовой тип. Виртуальное поле. Необязательное. Данное поле используется совместно с настройками «Цена доставки для получателя», определяя приоритет правила. Можно использовать в различных CMS/CRM системах, настраивая цены для определенного покупателя.

* '''groupid''' — Идентификатор группы пользователя, строковый или числовой тип. Виртуальное поле. Необязательное. Данное поле используется совместно с настройками «Цена доставки для получателя», определяя приоритет правила. Можно использовать в различных CMS/CRM системах, настраивая цены для определенной группы покупателей.

<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
'''Обратите внимание!'''
При передаче заказов, у которых плановая дата доставки/забора меньше ближайшей возможной, дата автоматически меняется на самую раннюю возможную. [[Личный кабинет курьерской службы#Как считается минимальная дата возможной доставки|Подробнее]]</div>

В случае необходимости указания, помимо товаров, дополнительных услуг (например, ДОСТАВКА, комплектация, подъем на этаж и т. д.) — их нужно указать в том же контейнере items как товары, без артикула.

=== Примеры ответов ===
При успешном выполнении запроса, создании заказа, возвращается сумма заказа в атрибуте orderprice, а также ошибка 0. При не успешном — номер ошибки и текст ее на английском языке в атрибуте errormsg, для некоторых ошибок выводится перевод на русский в атрибуте errormsgru.
В атрибут orderno помещается номер заказа, в атрибут barcode — штрихкод заказа.

'''Пример успешного ответа'''

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<neworder>
<createorder orderno="AB23541" barcode="67567#114" error="0" errormsg="Success" errormsgru="Успешно" orderprice="5000" />
<createorder orderno="AB23542" barcode="67567#115" error="0" errormsg="Success" errormsgru="Успешно" orderprice="6000" />
<createorder orderno="AB23543" barcode="67567#116" error="0" errormsg="Success" errormsgru="Успешно" orderprice="0" />
</neworder>
</source>

'''Пример ответа с ошибкой'''

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<neworder>
<createorder orderno="AB23541" barcode="67567#114" error="67" errormsg="Order barcode already exists in the database." errormsgru="Такой штрихкод заказа уже есть в базе." />
<createorder orderno="AB23542" barcode="67567#115" error="17" errormsg="Order number already exists in the database." errormsgru="Такой номер заказа уже есть в базе." />
<createorder orderno="AB23543" barcode="67567#116" error="67" errormsg="Order barcode already exists in the database." errormsgru="Такой штрихкод заказа уже есть в базе." />
</neworder>
</source>

'''Пример ответа при ошибке авторизации'''

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<request>
<error error="1" errormsg="authorization error"></error>
</request>
</source>

'''Пример ответа при ошибке синтаксиса'''

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<request>
<error>column:1 line:11 message:expected '>'</error>
</request>
</source>

=== Коды и описание ошибок ===
{|class=wikitable
!Код ошибки
!Английское описание
!Русское описание
|-
|0||Success||Успешно
|-
|1||Wrong XML||Некорректный файл XML.
|-
|2||Lat is empty||Укажите широту.
|-
|3||Specify a valid «Price» field value.||Укажите корректное значение поля «Сумма».
|-
|4||Specify a valid «Weight» field value.||Укажите корректное значение поля «Вес».
|-
|5||Recepient city/town not found.||Город назначения не найден.
|-
|6||Sender city/town not found.||Город отправления не найден.
|-
|7||Specify the «Recipient address» field value.||Укажите значение поля «Адрес получателя».
|-
|8||Specify the «Recipient phone» field value.||Укажите значение поля «Телефон получателя».
|-
|9||Specify the «Recipient name» field value.||Укажите значение поля «ФИО получателя».
|-
|10||Specify a valid «Quantity» field value.||Укажите корректное значение поля «Количество».
|-
|11||Specify a valid «Declared value» field value.||Укажите корректное значение поля «Объявленная ценность».
|-
|12||Supplier SKU ID not found.||Артикул не найден.
|-
|17||Order number already exists in the database.||Такой номер заказа уже есть в базе.
|-
|18||Order code already exists in the database.||Такой код заказа уже есть в базе.
|-
|19||The delivery date format is not valid. Specify a date in YYYY-MM-DD format.||Укажите значение поля «Дата доставки» в формате гггг-мм-дд.
|-
|20||Specify a valid «Delivery mode» field value.||Укажите корректное значение поля «Режим доставки».
|-
|21||Specify a valid «Return trip mode» field value.||Укажите корректное значение поля «Режим возврата».
|-
|22||Specify a valid «Delivery type» field value.||Укажите корректное значение поля «Тип доставки».
|-
|23||Specify a valid «Return shipment type» field value.||Укажите корректное значение поля «Тип возврата».
|-
|30||Specify the «Order number» field value.||Укажите значение поля «Номер заказа».
|-
|31||Specify the «Barcode» field value.||Укажите значение поля «Штрихкод».
|-
|32||Specify the «Sender company» field value.||Укажите значение поля «Компания-отправитель».
|-
|33||Specify the «Sender name» field value.||Укажите значение поля «ФИО отправителя».
|-
|34||Specify the «Sender phone» field value.||Укажите значение поля «Телефон отправителя».
|-
|35||Specify the «Sender city/town» field value.||Укажите значение поля «Город отправителя».
|-
|36||Specify the «Sender address» field value.||Укажите значение поля «Адрес отправителя».
|-
|37||Specify the «Pickup date» field value.||Укажите значение поля «Дата забора».
|-
|38||Specify the «Pickup time from» field value.||Укажите значение поля «Время забора с».
|-
|39||Specify the «Pickup time to» field value.||Укажите значение поля «Время забора до».
|-
|40||Specify the «Recipient company» field value.||Укажите значение поля «Компания-получатель».
|-
|41||Specify the «Recipient name» field value.||Укажите значение поля «ФИО получателя».
|-
|42||Specify the «Recipient phone» field value.||Укажите значение поля «Телефон получателя».
|-
|43||Specify the «Recipient city/town» field value.||Укажите значение поля «Город получателя».
|-
|44||Specify the «Recipient address» field value.||Укажите значение поля «Адрес получателя».
|-
|45||Specify the «Delivery date» field value.||Укажите значение поля «Дата доставки».
|-
|46||Specify the «Delivery time from» field value.||Укажите значение поля «Время доставки с».
|-
|47||Specify the «Delivery time to» field value.||Укажите значение поля «Время доставки до».
|-
|48||Specify the «Recipient postcode» field value.||Укажите значение поля «Индекс получателя».
|-
|49||Specify the «Weight» field value.||Укажите значение поля «Вес».
|-
|50||Specify the «Payment type» field value.||Укажите значение поля «Тип оплаты».
|-
|51||Specify the «Quantity» field value.||Укажите значение поля «Количество».
|-
|52||Specify the «Amount» field value.||Укажите значение поля «Сумма».
|-
|53||Specify the «Declared value» field value.||Укажите значение поля «Объявленная стоимость».
|-
|54||Specify the «Description» field value.||Укажите значение поля «Описание».
|-
|55||Specify the «Instruction» field value.||Укажите значение поля «Поручение».
|-
|56||Specify the «Delivery mode» field value.||Укажите значение поля «Режим доставки».
|-
|57||Specify the «Shipment type» field value.||Укажите значение поля «Тип отправления».
|-
|58||Specify whether return trip is required.||Укажите значение поля «Необходимость возврата».
|-
|59||Specify the «Return trip mode» field value.||Укажите значение поля «Режим возврата»
|-
|60||Specify the «Return shipment type» field value.||Укажите значение поля «Тип возврата».
|-
|61||Specify barcode.||Укажите штрихкод.
|-
|62||Specify item weight.||Укажите массу единицы товара.
|-
|63||Specify item quantity.||Укажите количество товара.
|-
|64||Specify item price.||Укажите цену единицы товара.
|-
|65||Specify item name.||Укажите название товара.
|-
|66||Wrong XLS file||Некорректный файл XLS.
|-
|67||Order barcode already exists in the database.||Такой штрихкод заказа уже есть в базе.
|-
|68||Select the «Payment by recipient» field value.||Укажите значение поля «Оплата получателем».
|-
|69||Specify department.||Укажите отдел.
|-
|70||Specify service partner code.||Укажите значение поля «Код подрядчика».
|-
|71||Date cannot be earlier than tomorrow.||Дата не может быть раньше чем завтра.
|-
|72||Date cannot be later than 15 days from now.||Дата не может быть позже чем через 15 дней.
|-
|73||Date cannot be earlier than today.||Дата не может быть раньше чем сегодня.
|-
|74||Date cannot be later than {0} days from now.||Дата не может быть позже, чем через {0} дней.
|-
|75||Specify a valid «Item weight» field value.||Укажите корректное значение поля «Масса единицы товара».
|-
|76||Specify a valid «Quantity» field value.||Укажите корректное значение поля «Количество товара».
|-
|77||Specify a valid «Item price» field value.||Укажите корректное значение поля «Цена единицы товара».
|-
|78||Specify a valid «Delivery time from» field value.||Укажите корректное значение поля «Время доставки с».
|-
|79||Specify a valid «Delivery time to» field value.||Укажите корректное значение поля «Время доставки до».
|-
|80||Specify a valid «Pickup time from» field value.||Укажите корректное значение поля «Время забора с».
|-
|81||Specify a valid «Pickup time to» field value.||Укажите корректное значение поля «Время забора до».
|-
|82||Specify a valid «Pickup point» field value.||Укажите корректное значение поля «ПВЗ».
|-
|83||Duplicate number in the registry.||Дублирование номера в реестре.
|-
|84||Duplicate barcode in the registry.||Дублирование штрихкода в реестре.
|-
|85||Specify a valid «Weight at return trip» field value.||Укажите корректное значение поля «Вес возврата».
|-
|86||Specify the «Weight at return trip» field value.||Укажите значение поля «Вес возврата».
|-
|87||Order weight exceeds the allowed maximum for the pickup point.||Вес превышает допустимое значение для этого ПВЗ.
|-
|88||Pickup date cannot be earlier than today.||Дата забора не может быть раньше чем сегодня.
|-
|89||Specify a later delivery date.||Укажите более позднюю дату доставки.
|-
|90||Inappropriate «Weight» or «Pay type» field value for the selected city or town. Please review and correct the values.||Значение поля «Масса» или «Тип оплаты» для выбранного города указано некорректно или отсутствует. Проверьте значения и исправьте.
|-
|91||{deliverytype} {deliverydate} is {holidaytype}. Select another date.||{deliverytype} {deliverydate} является {holidaytype}. Выберите другую дату.
|-
|92||{deliverytype} {deliverydate} is {holidaytype}. Select another date.||{deliverytype} {deliverydate} является {holidaytype}. Выберите другую дату.
|-
|93||Add items.||Добавьте товары.
|-
|95||The selected pickup point only allows paid orders.||Выбранный ПВЗ выдает только предоплаченные заказы.
|-
|96||Order barcode exceeds the allowed maximum (25) symbols.||Длина штрихкода заказа превышает максимально допустимую (25 символов).
|-
|97||The pickup date format is not valid. Specify a date in YYYY-MM-DD format.||Укажите значение поля «Дата забора» в формате гггг-мм-дд.
|-
|98||Specify the cost code.||Укажите значение поля «Кост-код».
|-
|99||The item is not in stock.||Товар отсутствует на складе.
|-
|100||Set the quantity of the item marked with Chestny ZNAK to one.||Укажите количество товара, маркированного кодом «Честный ЗНАК», равным единице.
|-
|101||Quantity of item Delivery cannot be greater than 1||Количество вложений типа «Доставка» не может быть более 1.
|-
|102||А database error occurred. Please try later again.||Ошибка базы данных. Попробуйте позже.
|-
|103||Order not found.||Заказ не найден.
|-
|104||Cannot edit order in the current status.||Невозможно изменить заказ в текущем статусе.
|-
|105||Discount cannot be greater than the order amount. Specify a smaller value.||Размер скидки не может превышать сумму заказа. Укажите меньшее значение скидки.
|-
|106||Specify the correct additional service code.||Укажите корректный код дополнительной услуги.
|-
|107||Specify the correct additional service name.||Укажите корректное значение поля [advprice][value].
|-
|108||Specify the «Additional services» field value.||Укажите значение поля «Дополнительные услуги».
|-
|110||Specify the correct TIN.||Укажите корректный ИНН.
|-
|111||Specify the correct IIN (KZ).||Укажите корректный ИИН (КЗ).
|-
|112||Specify the overall volume.||Укажите общий объем.
|-
|113||Cannot apply the delivery mode. Select another delivery mode.||Режим доставки не подходит для заказа. Выберите другой режим.
|-
|114||The pickup point does not support the selected delivery mode. Specify another pickup point.||ПВЗ не подходит для выбранного режима доставки. Укажите другой ПВЗ.
|-
|115||Specify a valid recipient phone number.||Укажите корректный телефон получателя.
|-
|116||Specify recipient PIN code.||Укажите пин-код получателя.
|-
|117||Order date cannot be earlier than {0}. Specify another date.||Дата заказа не может быть раньше {0}. Укажите другую дату.
|-
|118||Pickup date cannot be earlier than {0}. Specify another date.||Дата забора не может быть раньше {0}. Укажите другую дату.
|-
|119||Specify the correct item type.||Укажите корректный тип вложения.
|-
|120||The pickup point does not accept payment by card.||В выбранном ПВЗ оплата картой не принимается.
|-
|121||Invalid item code format||Неверный формат кода товарной номенклатуры
|-
|}

== Запрос статуса заказов ==

=== Пример запроса статуса заказа ===
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<statusreq>
<auth extra="8" login="login" pass="pass"></auth>
<client>CLIENT</client>
<orderno>1234</orderno>
<orderno2>5678</orderno2>
<ordercode>34234</ordercode>
<givencode>234534</givencode>
<datefrom>2016-07-21</datefrom>
<dateto>2016-07-21</dateto>
<target>Автозавод</target>
<done>ONLY_NOT_DONE</done>
<changes>ONLY_LAST</changes>
<conditions>
<namecontains/>
<namestarts/>
</conditions>
</statusreq>
</source>

=== Описание полей запроса статуса ===
'''statusreq''' — Корневой контейнер. Обязательный элемент.
* '''auth''' — Авторизация. Обязательный элемент.
* '''client''' — Признак клиента или агента. Необязательный элемент.
:* CLIENT — Признак клиента, значение по умолчанию
:* AGENT — Признак агента. В ответ отдается информация по заказам, переданным агенту на доставку
* '''orderno''' — Номер заказа. Необязательный элемент.
* '''ordercode''' — Внутренний код заказа. Необязательный элемент.
* '''orderno2''' — Номер заказа из срочных. Необязательный элемент.
* '''datefrom''' — Дата заказа «с». Необязательный элемент.
* '''dateto''' — Дата заказа «по». Необязательный элемент.
* '''target''' — Строка поиска. Позволяет указать текст, который содержится в названии компании или адресе получателя.
* '''done''' — Может принимать значения:
:* ONLY_DONE — Только доставленные (имеются в виду успешные статусы, например, '''Доставлен''' или '''Частично доставлен''')
:* ONLY_NOT_DONE — Только не доставленные (заказы, которые не являются доставленными, например, '''Не доставлен''' или '''Утерян''')
:* ONLY_NEW — Только новые
:* ONLY_DELIVERY — Только заказы в обработке — заказы, находящиеся в любом статусе, кроме конечных: Доставлено, Не доставлено, Отменён и т. д.
:* ''Пусто'' — все корреспонденции

* '''changes''' — может принимать значение только ONLY_LAST. Если указан этот параметр, все остальные игнорируются. Описание данного режима приведено здесь: [[#Передача только изменившихся статусов|Передача только изменившихся статусов]]

* '''conditions''' — Задает условия фильтрации по «orderno». Все вложенные элементы одновременно накладывают условие «И». Минимум 5 символов!
:* '''namecontains''' — Поиск по номеру заказа(шифр), который содержит «orderno».
:* '''namestarts''' — Поиск по номеру заказа(шифр), который начинается с «orderno».

<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
'''Обратите внимание!'''
# Периода запроса статусов (контейнеры '''datefrom''' и '''dateto''') ограничивается двумя месяцами — два месяца до даты '''«по»'''.
# Если не указаны обе даты — '''dateto''' принимается равной текущей дате.
# Если не указана дата '''dateto''' — она принимается равной '''datefrom''' плюс 2 месяца.
# Если не указана дата '''datefrom''' — она принимается равной '''dateto''' минус 2 месяца.
# Поиск по '''conditions''' работает только для «Номер заказа(шифр)» и только от 4 символов
</div>
<br>

=== Примеры ответов ===
'''Пример успешного ответа'''

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<statusreq count="23">
<order orderno="111111" awb="qwerty" orderno2="123123" ordercode="34534234" givencode="2345334">
<barcode>111111</barcode>
<sender>
<company>МВД</company>
<person>Иванов И.И.</person>
<phone>123-45-67</phone>
<contacts>
<phone>+74951234567</phone>
</contacts>
<town code="23432">Санкт-Петербург</town>
<address>Петровка 38 офис 35</address>
<date>2014-03-22</date>
<time_min>09:00</time_min>
<time_max>14:00</time_max>
</sender>
<receiver>
<company>МВД</company>
<person>Иванов И.И.</person>
<phone>123-45-67 - Иван (916)234.45.21 Петр,mvd@mail.ru</phone>
<contacts>
<phone>+74951234567</phone>
<phone>+79162344521</phone>
<email>mvd@mail.ru</email>
</contacts>
<inn>1112223335</inn>
<zipcode>125480</zipcode>
<town code="153361" regioncode="78" regionname="Санкт-Петербург город">Санкт-Петербург город</town>
<address>Петровка 38 офис 35</address>
<pvz>
<code>126</code>
<clientcode>QWERTY</clientcode>
</pvz>
<date>2014-03-22</date>
<time_min>09:00</time_min>
<time_max>14:00</time_max>
<coords lat="55.680327" lon="37.604456"></coords>
<deliveryPIN>1234</deliveryPIN>
</receiver>
<pickup>NO</pickup>
<weight>5.1</weight>
<return_weight>5.1</return_weight>
<quantity>2</quantity>
<paytype>CASH</paytype>
<service>2</service>
<return_service>2</service>
<type>3</type>
<return_type>3</return_type>
<waittime>12</waittime>
<price>387.5</price>
<print_check>YES</print_check>
<inshprice>387.5</inshprice>
<enclosure>Детские игрушки</enclosure>
<instruction>Проверить при покупателе, подписать акт</instruction>
<currcoords lat="55.680327" lon="37.604456" accuracy="50" RequestDateTime="2014-04-21 18:07:45"></currcoords>
<courier>
<code>26</code>
<name>Иванов Владимир Петрович</name>
<phone>+79161234567</phone>
</courier>
<deliveryprice total="158.6" delivery="100.00" return="58.6">
<advprice code="1" price="150">База</advprice>
<advprice code="2" price="0">% от объявленной стоимости</advprice>
<advprice code="3" price="8.6">Топливный сбор</advprice>
<advprice code="4" price="0">Округление</advprice>
</deliveryprice>
<receiverpays>NO</receiverpays>
<acceptpartially>NO</acceptpartially>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 17:22:00" createtimegmt="2016-06-03 16:14:44" message="" title="Доставлен">COMPLETE</status>
<statushistory>
<status eventstore="Офис в Москве" eventtime="2016-05-30 10:20:00" createtimegmt="2016-06-03 16:14:44" message="" title="Новый">NEW</status>
<status eventstore="Офис в Москве" eventtime="2016-06-01 17:38:00" createtimegmt="2016-06-03 16:14:44" message="филиал в Санкт-Петербурге" title="Планируется отправка">DEPARTURING</status>
<status eventstore="Офис в Москве" eventtime="2016-06-01 19:53:00" createtimegmt="2016-06-03 16:14:44" message="филиал в Санкт-Петербурге" title="Отправлено со склада">DEPARTURE</status>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 07:41:00" createtimegmt="2016-06-03 16:14:44" message="" title="Получен складом">ACCEPTED</status>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 09:17:00" createtimegmt="2016-06-03 16:14:44" message="" title="Выдан курьеру на доставку">DELIVERY</status>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 17:22:00" createtimegmt="2016-06-03 16:14:44" message="" title="Доставлен (предварительно)">COURIERDELIVERED</status>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 17:22:00" createtimegmt="2016-06-03 16:14:44" message="" title="Доставлен">COMPLETE</status>
</statushistory>
<customstatecode>2<customstatecode>
<clientstatecode></clientstatecode>
<costcode>cc12345</costcode>
<receipt fdNum="124555" fnSn="9289000100295555" kktNum="0001611984048555" inn="7722756555" fdValue="2899551555" summ="387.5" ofdUrl="gate.ofd.ru">https://ofd.ru/rec/7722756555/0001611984048555/9289000100295555/124555/2899551555</receipt>
<deliveredto>Иванова, секр.</deliveredto>
<delivereddate>2016-06-02</delivereddate>
<deliveredtime>17:22</deliveredtime>
<arrival>2016-05-02 23:21</arrival>
<outstrbarcode>EXT123456</outstrbarcode>
<partner>Офис на Ленина</partner>
<return_message>Доставлено в целости</return_message>
<department>Отдел</department>
<items>
<item code="34533" extcode="abc123" quantity="1" mass="0.2" retprice="37.5" VATrate="0" barcode="2345625213125" article="1" returns="0" origincountry="040" GTD="" excise="0.00" governmentCode="11223311" suppcompany="Поставщик" suppINN="1112223334" suppphone="79161234567">Мяч</item>
<item code="34456" extcode="abc124" quantity="2" mass="2" retprice="100" VATrate="10" barcode="4645625213138" article="2" returns="0" governmentCode="">Обруч</item>
<item code="34421" extcode="abc125" quantity="3" mass="0.3" retprice="50" VATrate="18" barcode="2345625213126" itemcode="44123" article="3" returns="0" governmentCode="">Погремушка желтая</item>
</items>
<packages>
<package code="33331" strbarcode="ORD0000001" mass="1" message="" got="YES"></package>
<package code="33332" strbarcode="ORD0000002" mass="2.5" message="" got="NO"></package>
</packages>
</order>
</statusreq>
</source>

'''Пример ответа если нет заказов'''

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<statusreq count="0">
</statusreq>
</source>

'''Пример ответа при ошибке авторизации'''

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<request>
<error error="1" errormsg="authorization error"></error>
</request>
</source>

'''Пример ответа при ошибке синтаксиса'''

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<request>
<error>column:1 line:11 message:expected '>'</error>
</request>
</source>

=== Описание полей ответа статусов ===
Все поля ответа соответствуют структуре order при создании заказа, с некоторыми добавлениями:

* Атрибуты контейнера '''order''':
:* '''''awb''''' — Номер накладной в системе курьерской службы.
:* '''''orderno2''''' — Номер накладной в подсистеме срочной доставки курьерской службы.
:* '''''ordercode''''' — внутренний код заказа в системе, применяется для некоторых внутренних операций.
:* '''''givencode''''' — внутренний код заказа в системе, применяется для некоторых внутренних операций.

* атрибут '''''code''''' контейнера '''item''' — внутренний код строки заказа в системе, применяется для некоторых внутренних операций.
:* '''''returns''''' — количество данного товара, от которого отказался получатель. Не нулевое только в случае частичного отказа.

* атрибут '''''got''''' контейнера '''package''' — признак принятого места YES / NO.
:* '''''returns''''' — количество данного товара, от которого отказался получатель. Не нулевое только в случае частичного отказа.

* '''''coords''''' в контейнере '''receiver''' — координаты получателя.
* '''''deliveryPIN''''' в контейнере '''receiver''' — Пин-код.
* '''pickup''' — признак оформления забора, возможные значения: '''YES''', '''NO'''. Если указано '''YES''', то весь заказ считается заданием на забор груза, а не на доставку.
* '''currcoords''' — текущие координаты заказа. Атрибуты:
:* '''''lat''''' — широта
:* '''''lon''''' — долгота
:* '''''accuracy''''' — точность в метрах
:* '''''RequestDateTime''''' — дата/время последнего обновления координат.

* '''courier''' — Данные курьера, которому выдан заказ. Если заказ не выдан, то выводятся данные запланированного курьера.
* '''waittime ''' — Время ожидания курьера.
* '''deliveryprice''' — Стоимость услуг в валюте расчетов с клиентом. Атрибуты:
:* '''''total''''' — общая стоимость услуг
:* '''''delivery''''' — стоимость доставки «Туда»
:* '''''return''''' — стоимость доставки «Обратно» (если order->return=YES)
Тэг '''deliveryprice''' включает список дополнительных услуг (только для тарифа «Премиум»):
:* '''''advprice''''' — наименование дополнительной услуги
:* '''''code''''' — код дополнительной услуги
:* '''''price''''' — стоимость дополнительной услуги

* '''status''' — статус доставки (список статусов см. ниже). Атрибуты (заполняются начиная с версии системы 2008.0.0.670):
:* '''''eventstore''''' — филиал, к которому относится текущий статус
:* '''''eventtime''''' — время события по часовому поясу места его наступления.
:* '''''createtimegmt''''' — время по GMT создания записи о смене статуса в БД. Используется для сортировки записей, чтобы соблюсти хронологическую последовательность. <spoiler text="Подробнее">Большинство событий фиксируются в полях eventtime и createtimegmt на основании одного действия, тогда они отличаются только сдвигом от GMT. Однако, если курьер доставил отправление 10.10.2010 в 20:00, по какой-то причине не внес это в мобильное приложение, на следующий день сдал накладную, и в 9 утра оператор внесла, что он доставил вчера в 20:00. Тогда в createtimegmt будет сегодня 6 утра (для Москвы), а в eventtime — вчера в 20:00. При этом оператор по каким-то причинам может внести время вручения раньше, чем какое-то предыдущее событие, т.о. нарушится последовательность времени в eventtime, но при сортировке по createtimegmt все-равно все будет правильно.</spoiler>
:* '''''message''''' — наименование филиала-получателя, при передаче между филиалами
:* '''''title''''' — русское наименование статуса

* '''statushistory''' — история статусов доставки. Содержит список контейнеров '''status'''. Заполняется только для тарифа «Премиум» начиная с версии системы 2008.0.0.670.
* '''customstatecode''' — код внутреннего статуса курьерской службы. Значения уточняйте в курьерской службе. Назначаются курьерской службой в разделе «Справочники» — «Статусы» — «15 Статусы корреспонденции». Справочник не передается через API клиенту по причине возможного наличия в нем внутренних технологических статусов курьерской службы.
* '''clientstatecode''' — код статуса клиента. Используется, если клиент предлагает свои коды статусов доставки/причин недоставки.
* '''deliveredto''' — данные из поля «Инфо. о доставке» (может быть информация о доставке, причина недоставки и т. п.).
* '''delivereddate''' — дата вручения.
* '''deliveredtime''' — время вручения. В случае недоставки может быть пустым.
* '''arrival''' — плановая дата прибытия в формате гггг-мм-дд чч: мм: сс
* '''outstrbarcode''' — код у подрядчика (код заказа во внешней системе). Используется в интеграциях с внешними системами.
* '''partner''' — текущий филиал/подрядчик.
* '''return_message''' — информация о возврате
* '''department''' — Подразделение, в котором оформляется заказ.

Контейнер '''status''' может принимать следующие значения:
: AWAITING_SYNC — Ожидает синхронизации. Данные заказа пока не появились в службе доставки.
: '''NEW''' — Успешно создан, передан в службу доставки.
: NEWPICKUP — Создан забор.
: PICKUP — Забран у отправителя.
: WMSASSEMBLED — Скомплектован на складе фулфилмента.
: WMSDISASSEMBLED — Разукомплектован на склад фулфилмента.
: '''ACCEPTED''' — Получен складом.
: CUSTOMSPROCESS — Производится таможенный контроль.
: CUSTOMSFINISHED — Таможенный контроль произведен.
: CONFIRM — Согласована доставка.
: UNCONFIRM — Не удалось согласовать доставку.
: DEPARTURING — Планируется отправка со склада на другой склад.
: DEPARTURE — Отправлено со склада на другой склад.
: INVENTORY — Инвентаризация. Убедились в наличии отправления на складе.
: PICKUPREADY — Готов к выдаче в ПВЗ.
: '''DELIVERY''' — Выдан курьеру на доставку.
: COURIERDELIVERED — Доставлен (предварительно, ождает подтверждения менеджером, чтобы перейти в статус COMPLETE).
: COURIERPARTIALLY — Частично доставлен (предварительно, ождает подтверждения менеджером, чтобы перейти в статус PARTIALLY).
: COURIERCANCELED — Отказ (предварительно, после этого ожидается COURIERRETURN).
: COURIERRETURN — Возвращено курьером. Курьер не смог доставить до получателя и вернул заказ обратно на склад. Это промежуточный статус, после которого менеджер выясняет, нужно ли повторно доставлять (статусы DATECHANGE/DELIVERY) или это окончательная недоставка (CANCELED).
: DATECHANGE — Перенос даты доставки.

: '''COMPLETE''' — Доставлен.
: '''PARTIALLY''' — Доставлен частично.
: '''CANCELED''' — Не доставлен (Возврат/Отмена). После этого статуса отправление должны вернуть заказчику, будут статусы RETURNING и RETURNED

: RETURNING — Планируется возврат заказчику (после CANCELED).
: RETURNED — Возвращен заказчику.
: LOST — Утрачен/утерян.

'''Примечание.''' В будущем возможно дополнение используемого набора статусов.

<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
'''Обратите внимание!'''

# Контейнер '''statushistory''' и '''deliveryprice''' заполняется для тарифов [[Личный кабинет курьерской службы#Функции личного кабинета|Премиум и Максимум]].
# Система никогда не гарантирует последовательность прохождения заказом набора статусов. То есть Вы можете получить статус «COMPLETE», а следующим запросом — «NEW» — такое может произойти, например, если оператор ошибочно отметил заказ выполненным, а затем исправил ошибку.
</div>
<br>

=== Передача только изменившихся статусов ===
В нашем API предусмотрено удобное средство получения статусов всех заказов, без необходимости «бомбить» сервер запросами статусов по каждому заказу. Работает это так: раз, например, в 10 минут, вы посылаете запрос «покажите все изменившиеся статусы». Пример запроса ниже. Система вам отдает ВСЕ заказы, статусы (или некоторые другие поля, см. ниже) которых изменились с момента последнего запроса. Вы разбираете полученный документ, по каждому заказу сохраняете его актуальный статус в своей системе, и если все хорошо, у вас все получилось, ваша система неожиданно не упала от наплыва информации, посылаете нам запрос подтверждения получения статусов (commitlaststatus). Мы у себя отмечаем, что эти статусы вами получены и их не надо передавать повторно. Таким образом, сколько бы заказов у вас ни было, статусы по ним всем почти в реальном времени вы можете получать всего двумя запросами.

Для получения только изменившихся статусов отправьте запрос:
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<statusreq>
<auth extra="8" login="login" pass="pass"></auth>
<changes>ONLY_LAST</changes>
<streamid>1234</streamid>
</statusreq>
</source>

Система выдает все заказы, в которых с момента последнего запроса в этом режиме изменилось хотя бы одно из полей:
orderno
status
delivereddate
deliveredtime
deliveredto
receiver->date
receiver->address
price

После успешной обработки ответа необходимо отметить полученные статусы успешно полученными, отправив запрос:
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<commitlaststatus>
<auth extra="8" login="login" pass="pass"></auth>
<client>CLIENT</client>
<streamid>1234</streamid>
</commitlaststatus>
</source>

'''Описание полей запроса'''

* '''auth''' — авторизация. Обязательный элемент.
* '''streamid''' — идентификатор потока. Если у вас несколько интеграций и каждая нуждается в получении статусов, вы можете передавать данный параметр и тем самым разделять получение и отметку об успешном получении статусов по заказам. Значение должно входить в промежуток от 100 до 10000, включительно. Необязательный элемент.
* '''client''' — признак клиента или агента. Необязательный элемент.
:* CLIENT — признак клиента, значение по умолчанию
:* AGENT — признак агента. В ответ отдается информация по заказам, переданным агенту на доставку

В случае успеха вы получите ответ:
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<commitlaststatus error="0">OK</commitlaststatus>
</source>

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

<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
# При этом способе передачи (<changes>ONLY_LAST</changes>) система просматривает заказы, оформленные за последние 3 месяца. Если заказ сделан ранее, изменение статуса по нему не попадет в результат выполнения запроса.
# Система всегда выдает текущий статус. Вы можете одним запросом получить статус «NEW», а следующим — «COMPLETE». Между запросами отправление могло пройти через несколько промежуточных статусов. Если нужна гарантия получения всех промежуточных статусов, нужно анализировать блок statushistory (может не заполняться вследствие ограничений версии или тарифа конкретной службы доставки).
# Система не гарантирует последовательность прохождения заказом набора статусов. Вы можете получить статус «COMPLETE», а следующим запросом «NEW» — такое может произойти, например, если оператор ошибочно отметил заказ выполненным, а затем исправил ошибку.
</div>
<br>

== Трекинг заказа по номеру ==
Запрос трекинга по номеру предназначен для выдачи минимальной обезличенной информации о конкретном заказе не авторизованному пользователю. Наша система имеет для этого интерфейс по адресу «home.courierexe.ru/{код экстра}/tracking». Вы можете либо сделать ссылку на такую страницу на своем сайте, либо разместить ее iframe’ом у себя, либо сделать свою и пользоваться нашим API. Этот интерфейс создан специально для выдачи информации живому пользователю сайта. Для получения статусов заказов в свою информационную систему нужно использовать запрос «statusreq», желательно с параметром changes=ONLY_LAST!

'''Пример запроса:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<tracking>
<extra>8</extra>
<orderno>1234</orderno>
</tracking>
</source>

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<tracking>
<order orderno="111111">
<barcode>111111</barcode>
<AWB>111111</AWB>
<sender>
<town code="1" country="RU">Москва город</town>
<date>2014-03-22</date>
<time_min>09:00</time_min>
<time_max>14:00</time_max>
</sender>
<receiver>
<town code="1" country="RU">Москва город</town>
<zipcode>125480</zipcode>
<date>2014-03-22</date>
<time_min>09:00</time_min>
<time_max>14:00</time_max>
</receiver>
<price>387.5</price>
<inshprice>387.5</inshprice>
<paytype>CASH</paytype>
<weight>5.1</weight>
<quantity>2</quantity>
<service>2</service>
<type>3</type>
<return>NO</return>
<return_service>2</return_service>
<return_date></return_date>
<return_time></return_time>
<return_message></return_message>
<waittime>12</waittime>
<enclosure>Детские игрушки</enclosure>
<instruction>Проверить при покупателе, подписать акт</instruction>
<deliveryprice total="158.6" delivery="100.00" return="58.6" />
<courier>
<code>26</code>
<name>Иванов Владимир Петрович</name>
<phone>+79161234567</phone>
</courier>
<currcoords lat="55.680327" lon="37.604456" accuracy="50" RequestDateTime="2014-04-21 18:07:45" />
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 17:22:00" createtimegmt="2016-06-03 16:14:44" message="" title="Доставлен">COMPLETE</status>
<statushistory>
<status eventstore="Офис в Москве" eventtime="2016-05-30 10:20:00" createtimegmt="2016-06-03 16:14:44" message="" title="Новый">NEW</status>
<status eventstore="Офис в Москве" eventtime="2016-06-01 17:38:00" createtimegmt="2016-06-03 16:14:44" message="филиал в Санкт-Петербурге" title="Планируется отправка">DEPARTURING</status>
<status eventstore="Офис в Москве" eventtime="2016-06-01 19:53:00" createtimegmt="2016-06-03 16:14:44" message="филиал в Санкт-Петербурге" title="Отправлено со склада">DEPARTURE</status>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 07:41:00" createtimegmt="2016-06-03 16:14:44" message="" title="Получен складом">ACCEPTED</status>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 09:17:00" createtimegmt="2016-06-03 16:14:44" message="" title="Выдан курьеру на доставку">DELIVERY</status>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 17:22:00" createtimegmt="2016-06-03 16:14:44" message="" title="Доставлен (предварительно)">COURIERDELIVERED</status>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 17:22:00" createtimegmt="2016-06-03 16:14:44" message="" title="Доставлен">COMPLETE</status>
</statushistory>
<deliveredto>Иванова, секр.</deliveredto>
<delivereddate>2016-06-02</delivereddate>
<deliveredtime>17:22</deliveredtime>
<outstrbarcode>EXT123456</outstrbarcode>
<items>
<item code="34533" extcode="abc123" quantity="1" mass="0.2" retprice="37.5" VATrate="0" barcode="2345625213125" article="1" returns="0" origincountry="040" GTD="" excise="0.00" governmentCode="11223311" suppcompany="Поставщик" suppINN="1112223334" suppphone="79161234567">Мяч</item>
<item code="34456" extcode="abc124" quantity="2" mass="2" retprice="100" VATrate="10" barcode="4645625213138" article="2" returns="0" governmentCode="">Обруч</item>
<item code="34421" extcode="abc125" quantity="3" mass="0.3" retprice="50" VATrate="18" barcode="2345625213126" article="3" returns="0" governmentCode="">Погремушка желтая</item>
</items>
</order>
</tracking>
</source>

'''Получение информации в формате 17 TRACK'''

'''Пример запроса:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<tracking17>
<extra>8</extra>
<orderno>1234</orderno>
</tracking17>
</source>

'''Пример ответа:'''
<pre>{
"number":"ExtNumber",
"oriNumber":"1234",
"oriCountry":"RU",
"destCountry":"RU",
"status":"Complete",
"events":[
{
"time":"2016-06-02 17:22:00",
"location":"RU",
"content":"Complete"
},
{
"time":"2016-06-02 17:22:00",
"location":"RU",
"content":"Courierdelivered"
},
{
"time":"2016-06-02 09:17:00",
"location":"RU",
"content":"Delivery"
},
{
"time":"2016-06-02 07:41:00",
"location":"RU",
"content":"Accepted"
},
{
"time":"2016-06-01 19:53:00",
"location":"RU",
"content":"Departure"
},
{
"time":"2016-06-01 17:38:00",
"location":"RU",
"content":"Departuring"
},
{
"time":"2016-05-30 10:20:00",
"location":"RU",
"content":"New"
}
]
}</pre>

Функция ищет последний заказ по номеру среди заказов всех клиентов. Выдает неперсонализированную информацию о текущем состоянии заказа.<br>
Описание контейнеров ответа аналогично описанию [[API#.D0.97.D0.B0.D0.BF.D1.80.D0.BE.D1.81 .D1.81.D1.82.D0.B0.D1.82.D1.83.D1.81.D0.B0 .D0.B7.D0.B0.D0.BA.D0.B0.D0.B7.D0.BE.D0.B2|Запроса статусов заказов]].

== Изменение заказа ==
Запрос предназначен для изменения заказов, по которым не было произведено изменений статуса корреспонденции, времени доставки — то есть заказов, которые ещё не в работе.

Изменять заказы могут курьерские службы с тарифами «Премиум» и «Максимум». Чтобы разрешить изменение заказов, в личном кабинете курьерской службы перейдите в '''Параметры''' > '''Расширенные''' и установите флажок '''Разрешить отмену и изменение заказов'''.

<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
'''Обратите внимание!'''
# Данные запроса изменения указываются '''полностью''', как если бы заказ создавался впервые.
# При отсутствии вложения в запросе изменения данное вложение '''не удаляется''' из заказа, но его количество становится равным 0.
# При одновременном изменении заказа в API и системе курьерской службы приоритет отдается данным системы курьерской службы. То есть изменения в API приняты не будут.
</div>

При редактировании заказа может быть отменен запланированный курьер. Это зависит от значения переменной '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Автоматически устанавливать заплан. курьера по району''':
* '''Нет''' — при редактировании заказа по АПИ курьер не изменяется;
* '''Район''' — если изменен адрес доставки, курьер сбрасывается;
* '''Район или дата план. доставки''' — если изменен адрес доставки или плановая дата вручения, курьер сбрасывается.

=== Описание полей запроса изменения ===
Все поля запроса соответствуют структуре order при создании заказа за исключением:
* вместо корневого тэга '''neworder''' указывается '''editorder''';
* тэг штрихкода '''barcode''' не указывается, поскольку присваивается при создании заказа;
* тэг курьера '''courier''' можно изменить только при включенной настройке '''Разрешить изменение курьера по АПИ''';
* для вложений '''item''' указывается внутренний код вложения в атрибуте '''code''', который можно получить при получении статуса заказа.

Значение '''orderno''' данным методом изменить нельзя.

=== Описание полей ответа изменения ===
Все поля ответа соответствуют ответу при создании заказа за исключением корневого тэга — вместо '''neworder''' возвращается '''editorder'''.

== Отмена заказа ==
Запрос предназначен для отмены заказов, по которым не было произведено изменений статуса доставки, статуса корреспонденции, времени доставки, то есть заказов, которые ещё не в работе.

Отменять заказы могут курьерские службы с тарифами «Премиум» и «Максимум». Чтобы разрешить отмену заказов, в личном кабинете курьерской службы перейдите в '''Параметры''' > '''Расширенные''' и установите флажок '''Разрешить отмену и изменение заказов'''.

При отмене заказа поле «Инфо о доставке» получает значение «Отменено заказчиком», поле «Дата доставки» — текущую дату, а «Вручил курьер» — системную запись «ОТМЕНА».

'''Пример запроса отмены заказа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<cancelorder>
<auth extra="8" login="login" pass="pass" />
<order orderno="" ordercode="123456" />
<order orderno="123aaa" ordercode="" />
</cancelorder>
</source>

'''Описание полей:'''

'''cancelorder''' — Корневой контейнер. Обязательный элемент.
* '''auth''' — Авторизация. Обязательный элемент.
* '''order''' — Контейнер отменяемого заказа. Обязательный элемент. Запрос может содержать более одного контейнера '''order'''. Атрибуты:
:* '''''orderno''''' — Шифр заказа.
:* '''''ordercode''''' — Внутренний код заказа.
Обратите внимание, что должен быть указан хотя бы один из атрибутов ''orderno'' или ''ordercode''!

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<cancelorder>
<order orderno="123test" ordercode="123456" error="0" errormsg="OK" errormsgru="Успешно" />
<order orderno="123aaa" ordercode="" error="52" errormsg="order not found" errormsgru="Заказ не найден" />
</cancelorder>
</source>

== Добавление вложений к накладной ==
'''Пример запроса:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<addattachments>
<auth extra="8" login="login" pass="pass" />
<orderno>1234567</orderno>
<attachments>
<item name="photo1.jpg">JVBERi0xLjMN1wb25lbnQgMQ
JUBQREYwMTIzNDU2Nzg5IDI NMyAwIG9iag08PA0vVHlwZSA
U3VidHlwZSAvSW1hZ2UNL1d pZHRoIDE4MDgNL0hlaWdodCA
ggNCAwIFINL0JpdHNQZXJDb 21wb25lbnQgMQ0vRGVjb2RlU
ENL0NvbHVtbnMgMTgwOA0+P g0vSW1hZ2VNYXNrIHRydWUNL
XhEZWNvZGUNPj4Nc3RyZWFt DQ</item>
<item name="photo2.jpg">VBERi0xLjMNAwIG9iag0HRoJ
JUBQREYwMTIzNDU2Nzg5IDI NMyAwIG9iag08PA0vVHlwZSA
vWE9iamVjdA0vU3VidHlwZS AvSW1hZ2UNL1dpZHRoIDEzNj
gNL0hlaWdodCAxMzMzDS9MZ W5ndGggNCAwIFINL0JpdHNQZ
XJDb21wb25lbnQgMQ0vRGVj b2RlUGFybXMgPDwNL0sgLTEN
L0NvbHVtbnMgMTM2OA0+Pg0 vSW</item>
</attachments>
</addattachments>
</source>

'''Описание полей:'''

'''addattachments''' — Корневой контейнер. Обязательный элемент.
* '''auth''' — Авторизация. Обязательный элемент.
* '''orderno''' — Номер заказа. Обязательный элемент. Может использоваться тэг <ordercode> с указанием внутреннего кода заказа.
* '''attachments''' — Обязательный элемент, в котором перечисляются передаваемые данные файлов.
** '''item''' — Бинарные данные (файл), закодированные в base64. Обязательный элемент.
*** '''name''' — Атрибут элемента '''item''', в котором передается имя файла. Обязательный элемент.

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<addattachments>
<attachments>
<item name="photo1.jpg" error="0" errormsg="OK" errormsgru="Успешно" />
<item name="photo2.jpg" error="0" errormsg="OK" errormsgru="Успешно" />
</attachments>
</addattachments>
</source>

== Получение вложений к накладной ==
'''Пример запроса:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<attachments>
<auth extra="8" login="login" pass="pass" />
<orderno>1234567</orderno>
</attachments>
</source>

'''Описание полей:'''

'''attachments''' — Корневой контейнер. Обязательный элемент.
* '''auth''' — Авторизация. Обязательный элемент.
* '''orderno''' — Номер/код заказа. Обязательный элемент.

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<attachments>
<item name="doc1.docx" size="35654">JVBERi0xLjMN
JUBQREYwMTIzNDU2Nzg5IDI NMyAwIG9iag08PA0vVHlwZSA
U3VidHlwZSAvSW1hZ2UNL1d pZHRoIDE4MDgNL0hlaWdodCA
ggNCAwIFINL0JpdHNQZXJDb 21wb25lbnQgMQ0vRGVjb2RlU
ENL0NvbHVtbnMgMTgwOA0+P g0vSW1hZ2VNYXNrIHRydWUNL
XhEZWNvZGUNPj4Nc3RyZWFt DQ</item>
<item name="photo2.jpg" size="74861">VBERi0xLjMN
JUBQREYwMTIzNDU2Nzg5IDI NMyAwIG9iag08PA0vVHlwZSA
vWE9iamVjdA0vU3VidHlwZS AvSW1hZ2UNL1dpZHRoIDEzNj
gNL0hlaWdodCAxMzMzDS9MZ W5ndGggNCAwIFINL0JpdHNQZ
XJDb21wb25lbnQgMQ0vRGVj b2RlUGFybXMgPDwNL0sgLTEN
L0NvbHVtbnMgMTM2OA0+Pg0 vSW</item>
</attachments>
</source>

В тегах item возвращаются бинарные данные (файлы), закодированные в base64.

== Изменение статуса агентом ==
Запрос изменения статуса заказа позволяет установить окончательный статус заказа — «Доставлен» или «Не доставлен (Возврат/Отмена)».

Кроме этого, устанавливается дата и время (при необходимости) изменения статуса, а также сообщение в поле ''Инфо о доставке''.

При необходимости к заказу можно прикрепить изображения.

'''Пример запроса изменения статуса:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<setorderinfo>
<auth extra="8" login="login" pass="pass" />
<order ordercode="123456">
<message>Получил Иванов</message>
<outstrbarcode>7654312</outstrbarcode>
</order>
<order ordercode="234567">
<status>PICKUPREADY</status>
<eventtime>2016-05-30 10:20:00</eventtime>
<message>Клиент отказался от покупки</message>
<paytype>CASH</paytype>
<items>
<item code="34533" quantity="1" reason="0" />
<item code="34456" quantity="0" reason="0" />
<item code="34421" quantity="2" reason="0" />
</items>
<image filename="filename1.jpg"> /9j/4AAQSkZJRgA
BAQAAAQABAAD/2wBDAA0JCg sKCA0LCgsODg0PEyAVExISEy
ccHhcgLikxMC4pLSwzOko+M zZGNywtQFdBRkxOUlNSMj5aY
VpQYEpRUk//2wBDAQ4ODhMR EyYVFSZPNS01T09PT09PT09P
T09PT09PT09PT09PT09PT09 PT09PT09PT09PT09PT09PT09
PT09PT0//wAARCAYACAADAS IA</image>
</order>
</setorderinfo>
</source>

'''Описание полей запроса статуса:'''

'''setorderinfo''' — Корневой контейнер. Обязательный элемент.
* '''auth''' — Авторизация. Обязательный элемент.
* '''order''' — Контейнер заказа. Обязательный элемент. Запрос может содержать более одного контейнера '''order'''. Атрибут '''''ordercode''''' — внутренний код заказа.
* '''status''' — Новый статус заказа. Доступны статусы из раздела [[#Описание полей ответа статусов]], кроме AWAITING_SYNC и NEW.
* '''eventtime''' — Дата и время изменения статуса. Обязательно при указании статуса.
* '''message''' — Текст сообщения ''Инфо о доставке''.
* '''outstrbarcode''' — код у подрядчика (код заказа во внешней системе). Используется в интеграциях с внешними системами.
* '''paytype''' — Тип оплаты заказа. Допустимые значения CASH/CARD.
* '''items''' — Контейнер для описания вложений '''item''' . Атрибуты:
:* '''''code''''' — Код вложения.
:* '''''quantity''''' — Количество доставленных единиц вложения.
:* '''''reason''''' — Причина недоставки, выбирается из соответствующего списка статусов.
* '''image''' — Контейнер прикрепляемого изображения. Содержит текст файла изображения, закодированный по стандарту ''base64''. Контейнер '''order''' может содержать более одного контейнера '''image'''. Атрибут:
:* '''''filename''''' — Имя файла.

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<setorderinfo>
<order ordercode="123456" error="0" errormsg="OK" errormsgru="Успешно" />
<order ordercode="234567" error="59" errormsg="value [date_put] is already set" errormsgru="Значение [Дата доставки] уже указано" />
</setorderinfo>
</source>

== Получение документов для печати ==
'''Пример запроса получения печатных форм:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<waybill>
<auth extra="8" login="login" pass="pass" />
<orders>
<order orderno="1234567" ordercode="33331" />
<order orderno="1234568" ordercode="33332" />
</orders>
<form>1</form>
</waybill>
</source>

'''Описание полей:'''

'''waybill''' — Корневой контейнер. Обязательный элемент
* '''auth''' — Авторизация. Обязательный элемент
* '''orders''' — Список заказов для получения печатных форм. Содержит тэги '''order''' с атрибутами:
:* '''''orderno''''' — шифр заказа
:* '''''ordercode''''' — внутренний код заказа. Указывать необходимо один из атрибутов для всех заказов. Приоритет имеет атрибут '''''ordercode'''''
* '''form''' — Формат накладной. Не обязательный элемент. Принимает значения:
:* 1 — Подробная накладная (по-умолчанию)
:* 2 — Наклейки Zebra
:* 3 — Наклейки на страницу формата А4
:* 4 — Акты приема-передачи

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<waybill>
<content>EODIcaI8KSBlwQ 4MnEOR7Px8U8EBAyGICBnwpw
IZhQgz0ZxuPs8EBM/GcbjzB AwhBl8hwQYIO00GmEwg1CeEG
mqYTChNU0wqf8l8nz4zgc+K fCno+zwU5GjOZmzXGcbEQYIM
4zkegRE40zWzONyoNNMIOIa cWnp6aDCGEGE9NQmoQd2mg00
79U4f3hPTwnfp6Sdrafeqpa JDpFw/1aYT077VNNNdO00G3q
mqqvp9p2E7T0/wiFemv8uG6 OM</content>
</waybill>
</source>

В тэге content возвращаются бинарные данные (файл pdf), закодированные в base64.

'''Обратите внимание''', что печатные формы для заборов не формируются.

== Справочник городов ==
'''Пример запроса справочника городов:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<townlist>
<auth extra="8" />
<codesearch>
<zipcode>110000</zipcode>
<kladrcode>0100000100800</kladrcode>
<fiascode>bd21979d-46f8-49d0-9105-e8d65172a983</fiascode>
<code>123</code>
</codesearch>
<conditions>
<city>Краснодарский край</city>
<namecontains>новгород</namecontains>
<namestarts>Моск</namestarts>
<name>Москва</name>
<fullname>Москва город</fullname>
<country>1</country>
</conditions>
<limit>
<limitfrom>30</limitfrom>
<limitcount>10</limitcount>
<countall>YES</countall>
</limit>
</townlist>
</source>

Внутри контейнера townlist все элементы могут как отсутствовать, так и комбинироваться. Поиск не чувствителен к регистру.

* '''auth''' — Авторизация, необязательный элемент. Используется в случае включенного и настроенного ограничения по населенным пунктам в конкретной курьерской службе.

* '''codesearch''' — Поиск по кодам. В случае использования — контейнеры conditions и limit игнорируются.
:* '''zipcode''' — Поиск по индексу. Обратите внимание на то, что один почтовый индекс может распространяться на несколько населенных пунктов. В этом случае система вернет несколько записей.
:* '''kladrcode''' — Поиск по 13-ти значному коду КЛАДР.
:* '''fiascode''' — Поиск по коду ФИАС (AOGUID).
:* '''code''' — Поиск по коду в системе.

* '''conditions''' — Задает условия поиска. Все вложенные элементы одновременно накладывают условие «И».
:* '''city''' — Поиск по всем населенным пунктам региона.
:* '''namecontains''' — Поиск населенных пунктов, название которых содержит указанный текст.
:* '''namestarts''' — Поиск населенных пунктов, название которых начинается с указанного текста.
:* '''name''' — Поиск населенных пунктов, название которых соответствует указанному тексту.
:* '''fullname''' — Поиск населенных пунктов, название вместе с типом населенного пункта которых соответствует указанному тексту.
:* '''country''' — Поиск только по стране с указанным внутренним кодом или текстовым кодом в соответствии [https://ru.wikipedia.org/wiki/ISO_3166-1 стандартом ISO_3166-1], например, «RU», «RUS» для России.

* '''limit''' — Ограничивает вывод результата.
:* '''limitfrom''' — Задает номер записи результата, начиная с которой выдавать ответ. По-умолчанию — 0.
:* '''limitcount'''- Задает количество записей результата, которые нужно вернуть. По-умолчанию — 10000.
:* '''countall''' — YES указывает на необходимость подсчета общего количества найденных совпадений. Это может замедлять выполнение запроса. Если отключено — в ответе не указываются totalcount и totalpages.

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<townlist count="3" page="1" totalcount="3" totalpages="1">
<town>
<code>26379</code>
<city>
<code>23</code>
<name>Краснодарский край</name>
</city>
<name>Сочи город</name>
<fiascode>79da737a-603b-4c19-9b54-9114c96fb912</fiascode>
<kladrcode>2300000700000</kladrcode>
<shortname /> (not yet supported)
<typename /> (not yet supported)
<coords lat="43.5855" lon="39.7231" />
</town>
<town>
<code>40331</code>
<city>
<code>32</code>
<name>Брянская область</name>
</city>
<name>Сочилов хутор</name>
<fiascode>c9c96c67-2cc9-4f10-afde-fd32417ea216</fiascode>
<kladrcode>3201900011100</kladrcode>
<shortname />
<typename />
<coords lat="52.6407" lon="33.1724" />
</town>
<town>
<code>114016</code>
<city>
<code>60</code>
<name>Псковская область</name>
</city>
<name>Сочихино деревня</name>
<fiascode>10df7588-19c1-49d1-a387-9de1cf3eb26f</fiascode>
<kladrcode>6001900015400</kladrcode>
<shortname />
<typename />
<coords lat="56.6003" lon="29.3542" />
</town>
</townlist>
</source>

В ответе города сортируются по популярности, важности (районные центры и т. д.), и только затем — по алфавиту.

== Справочник регионов ==
'''Пример запроса справочника:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<regionlist>
<codesearch>
<code>77</code>
</codesearch>
<conditions>
<namecontains>край</namecontains>
<namestarts>Моск</namestarts>
<fullname>Московская область</fullname>
<country>RU</country>
</conditions>
</regionlist>
</source>

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<regionlist count="2">
<city>
<code>80</code>
<country>
<code>1</code>
<name>Россия</name>
<id>643</id>
<ShortName1>RU</ShortName1>
<ShortName2>RUS</ShortName2>
</country>
<name>Агинский Бурятский автономный округ</name>
</city>
<city>
<code>1</code>
<country>
<code>1</code>
<name>Россия</name>
<id>643</id>
<ShortName1>RU</ShortName1>
<ShortName2>RUS</ShortName2>
</country>
<name>Адыгея республика</name>
</city>
</regionlist>
</source>

== Справочник улиц ==
'''Пример запроса справочника улиц:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<streetlist>
<conditions>
<town>Москва город</town> // ОБЯЗАТЕЛЬНОЕ ПОЛЕ!
<namecontains>Хохло</namecontains>
<namestarts>Академика Х</namestarts>
<name>Академика Хохлова</name>
<fullname>Академика Хохлова ул.</fullname>
</conditions>
<limit>
<limitfrom>30</limitfrom>
<limitcount>10</limitcount>
<countall>YES</countall>
</limit>
</streetlist>
</source>

* '''conditions''' — Задает условия поиска. Все вложенные элементы одновременно накладывают условие «И».
:* '''town''' — Обязательное поле. Название или код населенного пункта.
:* '''namecontains''' — Поиск улиц, название которых содержит указанный текст.
:* '''namestarts''' — Поиск улиц, название которых начинается с указанного текста.
:* '''name''' — Поиск улиц, название которых соответствует указанному тексту.
:* '''fullname''' — Поиск улиц, для которых название вместе с типом соответствует указанному тексту.

* '''limit''' — Ограничивает вывод результата.
:* '''limitfrom''' — Задает номер записи результата, начиная с которой выдавать ответ. По-умолчанию — 0.
:* '''limitcount'''- Задает количество записей результата, которые нужно вернуть. По-умолчанию — 10000.
:* '''countall''' — YES указывает на необходимость подсчета общего количества найденных совпадений. Это может замедлять выполнение запроса. Если отключено, в ответе не указываются totalcount и totalpages.

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<streetlist count="1" page="1" totalcount="3" totalpages="1">
<street>
<code>124</code>
<name>Академика Хохлова ул.</name>
<shortname>Академика Хохлова</shortname>
<typename>ул.</typename>
</street>
</streetlist>
</source>

В ответе улицы сортируются по алфавиту.

== Справочник номенклатуры ==
'''Пример запроса справочника номенклатуры:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<itemlist>
<auth extra="8" login="login" pass="pass"></auth>
<codesearch>
<code>123456</code>
<article>FD343</article>
<barcode>2345625213125</barcode>
</codesearch>
<conditions>
<namecontains>телевизор</namecontains>
<namestarts>sony</namestarts>
<name>Sony KDL-55W905 ЖК-телевизор</name>
<quantity>EXISTING_ONLY</quantity>
<store>2</store>
</conditions>
<except>
<code>123478</code>
</except>
<limit>
<limitfrom>30</limitfrom>
<limitcount>10</limitcount>
<countall>YES</countall>
</limit>
</itemlist>
</source>

Внутри контейнера itemlist все элементы могут как отсутствовать, так и комбинироваться. Поиск не чувствителен к регистру.
* '''codesearch''' — Поиск по кодам. В случае использования — контейнеры conditions и limit игнорируются.
:* '''code''' — Поиск по внутреннему коду системы.
:* '''article''' — Поиск по артикулу.
:* '''barcode''' — Поиск по штрихкоду.

* '''conditions''' — Задает условия поиска. Все вложенные элементы одновременно накладывают условие «И».
:* '''namecontains''' — Поиск товаров, название которых содержит указанный текст.
:* '''namestarts''' — Поиск товаров, название которых начинается с указанного текста.
:* '''name''' — Поиск товаров, название которых соответствует указанному тексту.
:* '''quantity''' — Наличие на складе. Принимает значения EXISTING_ONLY — Только в наличии, NOT_EXISTING_ONLY — Только не в наличии, ALL — Все. ''Это поле может быть недоступным в некоторых установках.''
:* '''store''' — Поиск товаров по определенному складу.

* '''except''' — Описание исключений для корректного определения количества зарезервированной номенклатуры.
:* '''code''' — Код заказа.

* '''limit''' — Ограничивает вывод результата.
:* '''limitfrom''' — Задает номер записи результата, начиная с которой выдавать ответ.
:* '''limitcount''' — Задает количество записей результата, которые нужно вернуть.

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<itemlist count="3" totalcount="3" page="1" totalpages="1">
<item>
<code>123456</code>
<article>FD343</article>
<barcode>2345625213125</barcode>
<name>Sony KDL-55W905 ЖК-телевизор</name>
<retprice>65000</retprice>
<purchprice>50000</purchprice>
<weight>5.1</weight>
<length>50</length>
<width>30</width>
<height>40</height>
<VATrate>20</VATrate>
<CountInPallet>30</CountInPallet>
<CountInBox>2</CountInBox>
<HasSerials>1</HasSerials>
<CountryOfOrigin>Малайзия</CountryOfOrigin> (not yet supported)
<Message>Хороший телевизор</Message>
<Message2>Снова хороший телевизор</Message2>
<quantity>12</quantity>
<reserved>3</reserved>
<item>
...
</itemlist>
</source>

'''Описание полей:'''
* '''code''' — Внутренний идентификатор, присвоенный системой.
* '''article''' — Артикул, назначенный клиентом (поставщиком).
* '''barcode''' — Штрихкод производителя.
* '''name''' — Наименование.
* '''retprice''' — Розничная цена по-умолчанию. При оформлении заказа цена используется та, которая указана в заказе.
* '''purchprice''' — Закупочная цена.
* '''weight''' — Масса в килограммах.
* '''length''' — Длина в сантиметрах.
* '''width''' — Ширина в сантиметрах.
* '''height''' — Высота в сантиметрах.
* '''VATrate''' — Ставка НДС, целое число процентов.
* '''CountInPallet''' — Количество штук в паллете.
* '''CountInBox''' — Количество штук в упаковке.
* '''HasSerials''' — Требует учета серийных номеров. Принимает значения 1 — да, 0 — нет.
* '''CountryOfOrigin''' — Наименование страны происхождения на русском языке.
* '''Message''' — Комментарий.
* '''Message2''' — Дополнительный комментарий.
* '''quantity''' — Количество на складе. Товары, уже собранные в заказы в этом количестве не присутствуют, считаются покинувшими товарный склад. ''Это поле может быть недоступным в некоторых установках.''
* '''reserved''' — Количество зарезервированного товара. Может превышать остаток на складе, если покупатели ждут следующей поставки. ''Это поле может быть недоступным в некоторых установках.''

== Движение номенклатуры ==
'''Пример запроса движения номенклатуры:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<itemmovements>
<auth extra="8" login="login" pass="pass"></auth>
<code>4259</code>
<datefrom>2020-10-01</datefrom>
<dateto>2020-10-02</dateto>
</itemmovements>
</source>

* '''code''' — внутренний код товара в справочнике номенклатуры.
* '''datefrom''' — дата начала периода.
* '''dateto''' — дата окончания периода.
Может быть указан или код, или период, или код и период одновременно.

'''Пример ответа движения номенклатуры:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<itemmovements count="16">
<itemmovement>
<code>151500</code>
<date>2017-05-26</date>
<retprice>0</retprice>
<quantity>1</quantity>
<delivered>0</delivered>
<item>
<code>4259</code>
<name>Настольная игра Дженга</name>
</item>
<status>
<code>5</code>
<name>Возврат от покупателя</name>
</status>
<store>
<code>1</code>
<name>офис в Москве</name>
</store>
<order>
<ordercode>3374830</ordercode>
<number>123660-0</number>
<date>2017-05-24</date>
<orderno>14123</orderno>
<barcode>0000000670</barcode>
<company>ТОВАР</company>
<address>Кравченко ул., 1</address>
<delivereddate>2017-05-29</delivereddate>
<deliveredtime>12:00:00</deliveredtime>
<deliveredto />
</order>
<document>
<code>21991</code>
<number>318</number>
<date>2017-05-26</date>
<message></message>
</document>
</itemmovements>
</itemlist>
</source>

''' Описание полей ответа '''
* '''code''' — внутренний код операции движения
* '''date''' — дата операции
* '''retprice''' — цена товара
* '''quantity''' — количество товара операции
* '''delivered''' — количество доставленного товара

* '''item''' — контейнер товара
:* '''code''' — внутренний код товара
:* '''name''' — наименование товара

* '''status''' — контейнер статуса операции
:* '''code''' — код статуса
:* '''name''' — наименование

* '''store''' — контейнер филиала, к которому относится операция
:* '''code''' — код филиала
:* '''name''' — наименование филиала

* '''order''' — контейнер корреспонденции
:* '''ordercode''' — внутренний код заказа
:* '''number''' — номер заказа
:* '''date''' — дата заказа
:* '''orderno''' — шифр
:* '''barcode''' — штрихкод
:* '''company''' — компания
:* '''address''' — адрес
:* '''delivereddate''' — дата вручения
:* '''deliveredtime''' — время вручения
:* '''deliveredto''' — данные о вручении, либо причина недоставки

* '''document''' — контейнер документа операции
:* '''code''' — внутренний код документа
:* '''number''' — номер документа
:* '''extnumber''' — внешний номер документа
:* '''date''' — дата документа
:* '''message''' — комментарий

== Получение справочника тарифов по городам ==
<br>
<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
'''Обратите внимание!'''
Если в запросе отсутствует параметр nofederal, то Москва будет обрабатываться иначе, чем остальные города. В ответе будут города Москвы и МО, с добавленной ценой за километраж
</div>
<br>

'''Пример запроса справочника тарифов по городам'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<tariffs>
<auth extra="8" login="login" pass="pass" />
<townfrom>Москва</townfrom>
<service>1</service>
<mainonly>1</mainonly>
<nofederal>1</nofederal>
</tariffs>
</source>

* '''auth''' — атрибут '''extra''' обязателен, по нему определяется курьерская служба.
* '''townfrom''' — город-отправитель. Если не передан, то городом будет «Москва».
* '''service''' — режим доставки. Обязательный элемент.
* '''mainonly''' — необязательный элемент. Если передан, то в ответе будут данные только по городам из справочника '''Межгород''' > '''Зоны'''.
* '''nofederal''' — необязательный элемент. Если передан, то в ответе город федерального значения Москва будет обрабатываться как обычный город.

'''Пример ответа справочника тарифов по городам'''
<source lang="json">
{
"townfrom": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
"service": 1,
"tariffs": [
{
"towntofias": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
"towntocode": 1,
"towntoname": "Москва город",
"distance": 0,
"pricedistance": 0,
"pricesnew": {
"before": [
{
"price": 100,
"every": 0,
"mass": 1
},
{
"price": 150,
"every": 0,
"mass": 5
}
],
"after": [
{
"price": 0,
"every": 1,
"mass": 38.01
},
{
"price": 15,
"every": 1,
"mass": 51.01
}
]
},
"deliveryPeriodMin": 1,
"deliveryPeriodMax": 2
}
]
}
</source>

''' Описание полей ответа '''
* '''townfrom''' — код ФИАС города-отправителя.
* '''service''' — режим доставки.
* '''tariffs''' — cписок тарифов по городу.
:* '''towntofias''' — код ФИАС города-получателя.
:* '''towntocode''' — внутренний код города-получателя.
:* '''towntoname''' — наименование города-получателя.
:* '''distance''' — дистанция в км до города от МКАД, если в запросе townfrom — Москва.
:* '''pricedistance''' — сумма за километраж до города от МКАД, если в запросе townfrom — Москва.
:* '''pricesnew''' — ваши настройки тарифов из справочника '''Межгород''' > '''Тарифы по зонам'''.
::* '''before/after''' — контейнеры ДО/ОТ.
:::* '''price''' — цена. Если ответ идет по «before», то в цену также плюсуется сумма pricedistance
:::* '''every''' — за каждые.
:::* '''mass''' — масса.
:* '''prices''' — устаревший элемент, не используется.
:* '''deliveryPeriodMin''' — минимальный срок доставки.
:* '''deliveryPeriodMax''' — максимальный срок доставки.

== Номенклатура приходной накладной ==
'''Пример запроса номенклатуры приходной накладной:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<itemdoc>
<auth extra="8" login="login" pass="pass"></auth>
<code>21991</code>
</itemdoc>
</source>

* '''code''' — внутренний код документа приходной накладной (см. предыдущий запрос).

'''Пример ответа движения номенклатуры:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<itemdoc>
<code>21991</code>
<number>318</number>
<date>2017-05-26</date>
<message></message>
<items>
<item code="4259" quantity="1" barcode="200300" article="123555">Настольная игра Дженга</item>
</items>
</itemdoc>
</source>

''' Описание полей ответа '''
* '''code''' — внутренний код приходной накладной
* '''number''' — номер документа
* '''date''' — дата документа
* '''message''' — комментарий

* '''item''' — контейнер товара
:* '''code''' — внутренний код товара
:* '''barcode''' — штрихкод товара
:* '''article''' — артикул товара
:* '''quantity''' — количество поступившего товара

== Справочник филиалов ==
'''Пример запроса списка филиалов:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<storelist>
<auth extra="8"></auth>
<json>YES</json>
<client_code>7890</client_code>
</storelist>
</source>

* '''auth''' — Атрибут '''extra''' — обязателен, по нему определяется курьерская служба
* '''json''' — Признак вывода ответа в виде JSON YES/NO
* '''client_code''' — Код клиента курьерской службы

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<storelist count="2">
<store>
<code>123</code>
<name>ABC</name>
</store>
<store>
<code>456</code>
<name>Филиал 2</name>
</store>
</storelist>
</source>

* '''code''' — Код филиала.
* '''name''' — Наименование филиала.

== Справочник пунктов самовывоза ==
Для отображения списка пунктов выдачи (ПВЗ) есть '''готовый JavaScript модуль''': https://home.courierexe.ru/js/measoft_map.js Инструкция по использованию — внутри. Посмотреть пример работы можно [https://home.courierexe.ru/pvz_test.html Здесь]

Уникальные запросы списка ПВЗ кешируются на стороне личного кабинета и хранятся до 7 часов утра по московскому времени следующего дня. Например, если уникальный запрос с массой 2 кг был отправлен сегодня в 10 часов, то завтра в 7 утра он сбросится. Если сегодня в 18 часов в этом же запросе вы укажете массу 2 кг, в ответе вернется тот же список ПВЗ. Если передадите массу 3 кг, список может быть другим.

'''Пример запроса пунктов самовывоза:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<pvzlist>
<auth extra="8" login="login" pass="pass"></auth>
<code>1234</code>
<client_code>7890</client_code>
<city>Свердловская область</city>
<town regioncode="66" country="RU">Нижний Тагил</town>
<parentcode>6</parentcode>
<acceptcash>YES</acceptcash>
<acceptcard>YES</acceptcard>
<acceptfitting>YES</acceptfitting>
<maxweight>30</maxweight>
<acceptindividuals>YES</acceptindividuals>
<lt>57.924737</lt>
<lg>59.940019</lg>
<rt>57.905682</rt>
<rg>59.984669</rg>
<json>YES</json>
<limit>
<limitfrom>30</limitfrom>
<limitcount>2</limitcount>
<countall>YES</countall>
</limit>
</pvzlist>
</source>

* '''auth''' — Атрибут '''extra''' — обязателен, по нему определяется курьерская служба, '''login''' и '''pass''' позволяют авторизоваться под клиентом: для отдельного клиента могут быть ограничения по доступности некоторых ПВЗ, и в этом случае они будут учтены.
* '''code''' — Внутренний код.
* '''client_code''' — Код клиента курьерской службы.
* '''city''' — Регион получателя. Можно указать код региона или полное наименование региона из [[#Справочник регионов|справочника регионов]].
* '''town''' — Город получателя.
Для тега города '''town''' можно указать код региона в атрибуте '''''regioncode''''' из [[#Справочник регионов|справочника регионов]]. Поиск будет производиться в указанном регионе.

Также можно указать страну получателя в атрибуте '''''country''''' в соответствии с [https://ru.wikipedia.org/wiki/ISO_3166-1 стандартом ISO_3166-1], например, «RU», «RUS» или «643» для России.

* '''parentcode''' — Фильтр по родительскому [[#Справочник филиалов|филиалу]]
* '''acceptcash''' — Фильтр по приему наличных YES/NO
* '''acceptcard''' — Фильтр по приему банковских карт YES/NO
* '''acceptfitting''' — Фильтр по наличию примерки YES/NO
* '''maxweight''' — Фильтр по максимальному весу, с которым работает ПВЗ
* '''acceptindividuals''' — Фильтр по доступности физическим лицам YES/NO
* '''lt''' — Широта левого верхнего угла
* '''lg''' — Долгота левого верхнего угла
* '''rt''' — Широта правого нижнего угла
* '''rg''' — Долгота правого нижнего угла
* '''json''' — Признак вывода ответа в виде JSON YES/NO
* '''limit''' — Ограничивает вывод результата.
:* '''limitfrom''' — Задает номер записи результата, начиная с которой выдавать ответ. По-умолчанию — 0.
:* '''limitcount'''- Задает количество записей результата, которые нужно вернуть. По-умолчанию — 100.
:* '''countall''' — YES указывает на необходимость подсчета общего количества найденных совпадений. Это может замедлять выполнение запроса. Если отключено — в ответе не указываeтся totalcount.

'''Пример ответа справочника пунктов самовывоза:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<pvzlist count="2" totalcount="40465">
<pvz>
<code>126</code>
<clientcode>3</clientcode>
<name>Нижний Тагил</name>
<parentcode>6</parentcode>
<parentname>Интеграция</parentname>
<town code="124267" regioncode="66" regionname="Свердловская область">Нижний Тагил город</town>
<address>622036, г. Нижний Тагил, ул. Циолковского, д. 17</address>
<phone>+73435417709, +73435254989</phone>
<comment>Новый пункт доставки</comment>
<worktime>Вс 10:00-16:00, Сб 10:00-16:00, Пн-Пт 10:00-20:00</worktime>
<traveldescription>Жилое 5-ти этажное здание, торцом к дороге, второе здание от перекрестка Пархоменко-Циолковского</traveldescription>
<maxweight>10</maxweight>
<acceptcash>YES</acceptcash>
<acceptcard>YES</acceptcard>
<acceptfitting>YES</acceptfitting>
<acceptindividuals>YES</acceptindividuals>
<latitude>57.93457</latitude>
<longitude>59.95131</longitude>
<uid>40606d00-9c51-11eb-b2c9-cfd6c1111392</uid>
</pvz>
<pvz>
<code>245</code>
<clientcode>NTG1</clientcode>
<name>На Красноармейской</name>
<parentcode>6</parentcode>
<parentname>Интеграция</parentname>
<town code="124267" regioncode="66" regionname="Свердловская область">Нижний Тагил город</town>
<address>КРАСНОАРМЕЙСКАЯ, д.79</address>
<phone>+7(3435)379-044</phone>
<comment>Возможность примерки отсутствует</comment>
<worktime>Вс 10:00-16:00, Сб 10:00-16:00, Пн-Пт 10:00-20:00</worktime>
<traveldescription>Напротив ТЦ Пирамида</traveldescription>
<maxweight>20</maxweight>
<acceptcash>YES</acceptcash>
<acceptcard>YES</acceptcard>
<acceptfitting>NO</acceptfitting>
<acceptindividuals>YES</acceptindividuals>
<latitude>57.93468</latitude>
<longitude>60.55476</longitude>
<uid>41116853-9c51-11eb-b2c9-cfd6c1451392</uid>
</pvz>
</pvzlist>
</source>

* '''code''' — Код ПВЗ в системе. Используется в запросе [[API#Оформление заказа|оформления заказов]]
* '''clientcode''' — Код ПВЗ используемый компанией-подрядчиком.
* '''name''' — Наименование ПВЗ.
* '''parentcode''' — Код родительского элемента.
* '''parentname''' — Наименование родительского элемента.
* '''town''' — Населенный пункт с кодом из [[#Справочник городов|справочника городов]], а также с кодом и наименованием региона.
* '''address''' — Адрес ПВЗ.
* '''phone''' — Телефоны ПВЗ.
* '''comment''' — Дополнительная информация.
* '''worktime''' — Режим работы ПВЗ.
* '''traveldescription''' — Описание местонахождения ПВЗ или пути к нему.
* '''maxweight''' — Максимальный вес, с которым работает ПВЗ.
* '''acceptcash''' — Признак приема наличных
* '''acceptcard''' — Признак приема банковских карт
* '''acceptfitting''' — Наличие примерки
* '''latitude''' — Широта
* '''longitude''' — Долгота
* '''uid''' — Уникальный идентификатор ПВЗ в системе Measoft
* '''count''' — Количество записей в ответе
* '''totalcount''' — Общее количество записей, отвечающее параметрам запроса

== Получение фискальных данных заказа ==
'''Пример запроса получения фискальных данных:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<receiptdata>
<auth extra="8" login="login" pass="pass" />
<orders>
<order orderno="123456" />
<order orderno="890111C" />
</orders>
</receiptdata>

</source>

'''Пример ответа получения фискальных данных:'''
<source lang="xml">

<?xml version="1.0" encoding="UTF-8"?>
<receipts count="1">
<receipt>
<orderno>123456</orderno>
<fdDatetime>2020-06-07 12:14:00</fdDatetime>
<fdValue>123</fdValue>
<fdNum>456</fdNum>
<fnSn>789</fnSn>
<kktNum>100</kktNum>
<inn>222</inn>
<ofdUrl>gate.ofd.ru</ofdUrl>
<fullUrl>https://check.ofd.ru/123</fullUrl>
<price>12345</price>
<lines count="1">
<line>
<item>1111764</item>
<name>Сапоги</name>
<qty>1</qty>
<price>1000</price>
<vatRate>20</vatRate>
<governmentCode>Z16513LK2</governmentCode>
<itemType>1</itemType>
</line>
</lines>
</receipt>
</receipts>
</source>

Параметры ответа:
* '''orderno''' — Номер заказа
* '''fdDatetime''' — Дата и время пробития фискального чека
* '''fdValue''' — ФПД (фискальный признак документа)
* '''fdNum''' — ФИСКАЛЬНЫЙ ДОКУМЕНТ (фискальный номер чека)
* '''fnSn''' — ФН (номер фискального накопителя)
* '''kktNum''' — РН (регистрационный номер кассы)
* '''inn''' — ИНН
* '''ofdUrl''' — URL адрес (доменное имя) ОФД
* '''price''' — Сумма чека
* '''fullUrl''' — URL чека для просмотра онлайн
* '''lines''' — Позиции чека
:* '''item''' — код товара
:* '''name''' — наименование товара
:* '''qty''' — количество товара
:* '''price''' — цена товара
:* '''governmentCode''' — считанная последовательность, которая в дальнейшем преобразуется по алгоритму тега 1162
:* '''vatRate''' — НДС товара
:* '''itemType''' — тип товара (товар, доставка и т. д.)

== Справочник Виды срочности ==
'''Пример запроса видов срочности:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<services>
<auth extra="8"/>
</services>
</source>

'''Пример ответа справочника видов срочности:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<services count="2">
<service>
<code>1</code>
<name>Эконом</name>
</service>
<service>
<code>2</code>
<name>Срочно</name>
</service>
</services>
</source>

== Справочник дополнительных услуг ==
'''Пример запроса дополнительных услуг:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<advprices>
<auth extra="8" login="login" pass="pass" />
<visible>NO</visible>
</advprices>
</source>

'''advprices''' — Корневой контейнер. Обязательный элемент.
* '''visible''' — Признак возврата '''только''' тех услуг, что доступны для отображения в ЛК YES/NO. Необязательный элемент. По-умолчанию NO

'''Пример ответа справочника дополнительных услуг:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<advprices>
<advprice>
<code>1</code>
<name>Этажей в доме</name>
<type>int</type>
</advprice>
<advprice>
<code>2</code>
<name>Коэффициент надбавки</name>
<type>float</type>
</advprice>
<advprice>
<code>3</code>
<name>Расписаться на упаковке</name>
<type>bool</type>
</advprice>
</advprices>
</source>

Параметры:
* '''code''' — внутренний код услуги
* '''name''' — наименование услуги. Если поле «название в ЛК» в настройках услуги не пусто, то возвращает значение поля «название в ЛК».
* '''hine''' — подсказка по доп услуге для пользователя
* '''type''' — тип услуги. Может иметь значения:
:* '''bool''' — для услуг вида «чекбокс», «Да»
:* '''float''' — для числа с плавающей точкой
:* '''int''' — для целого числа

== Расчет стоимости доставки ==
'''Пример запроса стоимости доставки:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<calculator>
<auth extra="8" login="login" pass="pass" />
<order>
<pricetype>CUSTOMER</pricetype>
<sender>
<town>Санкт-Петербург</town>
<address>Петровка 38 офис 35</address>
<coords lat="55.680327" lon="37.604456"></coords>
</sender>
<receiver>
<zipcode>125480</zipcode>
<town regioncode="78" country="RU">Санкт-Петербург</town>
<address>Петровка 38 офис 35</address>
<pvz>124</pvz>
<coords lat="55.680327" lon="37.604456"></coords>
</receiver>
<weight>5.1</weight>
<service>2</service>
<paytype>CASH</paytype>
<price>387.5</price>
<deliveryprice>150</deliveryprice>
<inshprice>387.5</inshprice>
<packages>
<package mass="1" quantity="5"></package>
<package mass="2.5" length="10" width="20" height="30"></package>
</packages>
<userid>user123</userid>
<groupid>customer</groupid>
</order>
</calculator>
</source>

Параметры:
Структура данных и заполнение полей аналогичны и совместимы с [[#Оформление заказа]].

Дополнительные поля:
* '''pricetype''' — тип требуемой цены. Возможные значения: «CUSTOMER» (по-умолчанию) — [[Личный кабинет клиента#Цена доставки для получателя|цена для конечного получателя]], «CLIENT» — цена курьерской службы для клиента.
* '''userid''' — Идентификатор пользователя, строковый или числовой тип. Виртуальное поле. Необязательное. Данное поле используется совместно с настройками «Цена доставки для получателя», определяя приоритет правила. Можно использовать в различных CMS/CRM системах, настраивая цены для определенного покупателя.
* '''groupid''' — Идентификатор группы пользователя, строковый или числовой тип. Виртуальное поле. Необязательное. Данное поле используется совместно с настройками «Цена доставки для получателя», определяя приоритет правила. Можно использовать в различных CMS/CRM системах, настраивая цены для определенной группы покупателей.

Суммы НП и ОЦ, а также тип оплаты CARD имеют значение при настроенных в тарифе на вкладке Прочее долях (в процентах) от данных сумм.

В авторизации можно опустить параметры login и pass, тогда расчет будет производиться по стандартному тарифу курьерской службы, без учета возможных отличий для конкретного клиента.<br>
Объемный вес будет учитываться только при условии указания всех габаритов: длины, ширины и высоты.<br>
В полях город-отправитель и город-получатель можно указывать название города (не рекомендуется!), либо код города из нашего справочника, либо 13-ти значный код КЛАДР, либо 36-ти значный код адресной системы ФИАС (AOID).

'''Пример ответа стоимости доставки:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<calculator>
<calc>
<townfrom code="1">Москва город</townfrom>
<townto code="56603">Иркутск город</townto>
<mass>3.7</mass>
<service name="Экспресс">1</service>
<zone>2</zone>
<price>1113</price>
<mindeliverydays>1</mindeliverydays>
<maxdeliverydays>3</maxdeliverydays>
<mindeliverydate>2020-05-13</mindeliverydate>
<deliveryprice>
<advprice code="1" price="1000">База</advprice>
<advprice code="4" price="100">Процент от суммы руб</advprice>
<advprice code="5" price="63">Процент от объявленной стоимости</advprice>
<advprice code="6" price="-50">Скидка при доставке</advprice>
</deliveryprice>
</calc>
</calculator>
</source>

Параметры:
* '''townfrom''' — Город-отправитель так, как система его распознала и привязала к справочнику. Атрибут '''code''' — код из справочника городов системы.
* '''townto''' — Город-получатель так, как система его распознала и привязала к справочнику. Атрибут '''code''' — код из справочника городов системы.
* '''mass''' — Масса в килограммах
* '''service''' — Режим доставки — число, указывающее на запись в справочнике видов срочности (см описание на этой странице).
* '''zone''' — номер тарифной зоны, по которой рассчиталась стоимость. В зависимости от зоны выбирается тарифная сетка. Так же к цене могут применяться повышающие или понижающие коэффициенты при доставке не из/в региональный центр.
* '''price''' — рассчитанная стоимость доставки в валюте прайс-листа курьерской службы. Рекомендуется к использованию в отличие от одноименного атрибута родительского контейнера.
* '''maxdeliverydays''' — максимальный срок доставки в рабочих днях.
* '''mindeliverydate''' — минимальная дата доставки в учетом выходных дней.
* '''deliveryprice''' — Данные по составляющим ценам доставки

'''''Обратите внимание:''''' В реальном ответе сервера в теге calc присутствует атрибут «price». Он оставлен для обратной совместимости, не используйте его. Пользуйтесь вложенным тегом price.

== Получение информации о клиенте ==
'''Пример запроса получения информации о клиенте:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<client>
<auth extra="8" login="login" pass="pass" />
</client>
</source>

'''client''' — Корневой контейнер. Обязательный элемент.
* '''auth''' — Авторизация. Обязательный элемент.

'''Пример ответа на запрос получения информации о клиенте:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<client>
<code>1082</code>
</client>
</source>

* '''code''' — Код клиента

== Список актов передачи денег ==
'''Пример запроса списка актов передачи денег:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<smalist>
<auth extra="8" login="login" pass="pass" />
<datefrom>2016-02-10</datefrom>
<dateto>2016-03-10</dateto>
</smalist>
</source>

'''smalist''' — Корневой контейнер. Обязательный элемент.
* '''auth''' — Авторизация. Обязательный элемент.
* '''datefrom''' — Дата «с». Необязательный элемент.
* '''dateto''' — Дата «по». Необязательный элемент.
Если интервал дат не указан, то возвращаются акты передачи денег за последний месяц.

'''Пример ответа на запрос списка актов передачи денег:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<smalist count="1">
<sma>
<code>6278</code>
<number>3992</number>
<actdate>2016-02-12</actdate>
<datepay></datepay>
<dateto>2016-02-12</dateto>
<promiseddatepay></promiseddatepay>
<price>637.00</price>
<pricecorr>113.00</pricecorr>
<rur>13430.00</rur>
<pricekur>570.00</pricekur>
<priceag>67.00</priceag>
<payno>42423</payno>
<paytype>1</paytype>
<paytypename>Безнал</paytypename>
<signedcopyreceived>NO</signedcopyreceived>
</sma>
</smalist>
</source>

* '''code''' — Код акта
* '''number''' — Номер акта в системе
* '''actdate''' — Дата акта
* '''datepay''' — Дата оплаты по акту
* '''dateto''' — Дата конечного периода для формирования АПД
* '''promiseddatepay''' — Плановая дата оплаты
* '''price''' — Стоимость услуг
* '''pricecorr''' — Сумма корректировки
* '''rur''' — Сумма заказа
* '''pricekur''' — Стоимость курьерской доставки
* '''priceag''' — Агентское вознаграждение
* '''payno''' — Номер платежного поручения
* '''paytype''' — Тип оплаты: 1 — безнал, 2 — наличными курьером, 3 — наличными в офисе, 4 — перевод на карту
* '''paytypename''' — Строковое представление типа оплаты
* '''signedcopyreceived''' — Признак факта возврата акта YES/NO

== Детализация актов передачи денег ==
'''Пример запроса детализации актов передачи денег:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<smadetail>
<auth extra="8" login="login" pass="pass" />
<code>6278</code>
</smadetail>
</source>

'''smadetail''' — Корневой контейнер. Обязательный элемент.
* '''auth''' — Авторизация. Обязательный элемент.
* '''code''' — Код акта передачи денег (см. запрос списка АПД). Обязательный элемент.

'''Пример ответа на запрос детализации актов передачи денег:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<smadetail count="2">
<specialsma>
<code>42494</code>
<ordercode>14424</ordercode>
<orderno>11111</orderno>
<orderdate>2018-01-01</orderdate>
<delivereddate>2018-10-01</delivereddate>
<company>Компания</company>
<price>314.00</price>
<rur>8800.00</rur>
<inshprice>314.00</inshprice>
<pricekur>270.00</pricekur>
<priceag>44.00</priceag>
<pricecalc>8486.00</pricecalc>
<paytype>2</paytype>
<paytypename>наличными курьером</paytypename>
<weight>0.400</weight>
<distance>0.0</distance>
<status>Доставлено</status>
</specialsma>
</smadetail>
</source>

* '''code''' — Код записи.
* '''ordercode''' — Код заказа.
* '''orderno''' — Шифр заказа.
* '''orderdate''' — Дата заказа.
* '''delivereddate''' — Дата доставки.
* '''company''' — Получатель.
* '''price''' — Стоимость услуг.
* '''rur''' — Сумма заказа.
* '''inshprice''' — Стоимость заказа.
* '''pricekur''' — Стоимость курьерской доставки.
* '''priceag''' — Агентское вознаграждение.
* '''pricecalc''' — Сумма для передачи агенту.
* '''paytype''' — Тип оплаты: 1 — безнал, 2 — наличными курьером, 3 — наличными в офисе, 4 — перевод на карту.
* '''paytypename''' — Строковое представление типа оплаты
* '''weight''' — Вес заказа.
* '''distance''' — Дистанция по заказу
* '''status''' — Статус заказа.

== Генерация коротких ссылок ==
В некоторых случаях, например, при использовании в СМС, может потребоваться использование коротких ссылок на ЛК.
Для этого, необходимо отправить запрос с полной ссылкой, в ответ на который придёт хэш-код для ссылки.

'''Пример запроса генерации коротких ссылок:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<shortlink>
<link short="0"> https://home.courierexe.ru/8/site/orders </link>
</shortlink>
</source>

'''shortlink''' — Корневой контейнер. Обязательный элемент.
* '''link''' — Полная ссылка, для которой необходимо получить код. Обязательный элемент. Если атрибут '''short''' равен 1, то ответ не будет содержать XML, а только хэш-код.

'''Пример ответа на запрос генерации коротких ссылок:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<shortlink>
<hash>35AF350C</hash>
</shortlink>
</source>

* '''hash''' — Хэш-код ссылки.

Далее, можно использовать ссылку на ЛК:

<nowiki>https://home.courierexe.ru/35AF350C или curie.ru/35AF350C</nowiki>

'''Примечание!''' Сервис коротких ссылок работает только для ресурсов компании MeaSoft.

== Проверка надежности покупателя ==
Проверка надежности работает только для тарифа «Максимум» личного кабинета.

<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<mcheck>
<auth extra="8" login="login" pass="pass" />
<phones>
<phone>89161147992</phone>
</phones>
</mcheck>
</source>

Ответ:

<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<mcheck>
<phones>
<phone rate="90">89161147992</phone>
</phones>
</mcheck>
</source>

API

2022-05-31T14:52:38Z

Olga:

<div style="font-size: 18px; color: #a92424; background-color: #ffdede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
'''Изменения для 54-ФЗ'''

Для передачи ставки НДС при оформлении заказа добавлен атрибут items > item > VATrate.

При использовании услуги кассового обслуживания необходимо в обязательном порядке передавать состав заказа со ставками НДС.

'''ВНИМАНИЕ'''

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

</div>

<div style="font-size: 24px; color: #2424a9; background-color: #deffde; border: 1px solid #ebccd1; padding: 3px 10px 10px; text-align: center">
'''English version is [[API Documentation|HERE!]]'''
</div>

Вы можете настроить интеграцию с MeaSoft средствами XML API по протоколу HTTP POST.

API предназначено для интеграции клиентов (интернет-магазинов и прочих компаний-заказчиков доставки) с [http://courierexe.ru/our_clients.htm курьерскими службами], работающими под управлением системы [https://curie.ru/ MeaSoft].

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

Если вы '''подрядчик''', вы можете забирать заказы, используя значение client=AGENT в запросе [[#Пример запроса статуса заказа|statusreq]], и передавать статусы заказов, используя метод [[#Изменение статуса агентом|setorderinfo]]. Также для интеграций с подрядчиками у нас есть специальная платформа, но добавлять подрядчиков в нее можно только на нашей стороне. Присылайте нам коммерческое предложение, описание вашего сервиса, и мы с радостью его рассмотрим.

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

Если у вас после прочтения документации остались вопросы, задайте их по почте [mailto:support@courierexe.ru support@courierexe.ru]. Обязательно представьтесь, напишите ваши контактные данные (телефон, скайп) и название компании, с которой вы хотите интегрироваться.

== Готовые интеграции ==

Для работы с популярными CMS и CRM-системами разработаны модули интеграции, перечисленные в таблице ниже.

'''Модули распространяются бесплатно, без гарантий со стороны разработчика''', и не являются средством полной автоматизации взаимодействия с курьерской службой. Модули — это помощь разработчикам интернет-магазинов в построении интеграции с курьерскими службами. '''Ответственность за корректность передачи данных лежит на интернет-магазине.'''

Сообщайте нам свои пожелания по работе наших модулей. Мы учтем их в новых версиях.

{| class="wikitable" align="center" style="width: 80%; margin: auto; background-color:#ffffff; border: 1px solid #999999;" cellpadding="10" cellspacing="0"
!style="width: 35%;"|Система управления контентом (CMS)
!style="width: 15%;"|Ссылка
!style="width: 35%;"|Примечание
|-
|[[Файл:bitrix.png|center|x44px]]
|style="text-align: center;" | [https://marketplace.1c-bitrix.ru/solutions/measoft.courier/ Установить] 
|Поддерживает версии 14.5 и выше. Подробнее см. [[1C-Битрикс|описание]].
|-
|[[Файл:prestashop.png|center|x60px]]
|style="text-align: center;"|[https://courierexe.ru/download/api/prestashop.zip Скачать]
|Поддерживает версии 1.5.2.0 и выше.
|-
|[[Файл:OpencartOCStore.png|center|x60px]]
|style="text-align: center;"|[https://courierexe.ru/download/api/opencart.zip Скачать для версии 1.5.5.1]<br>[https://courierexe.ru/download/api/measoft_oc2.ocmod.zip Скачать для версии 2.0]<br>[https://courierexe.ru/download/api/measoft_oc2.3.ocmod.zip Скачать для версии 2.3]<br>[https://courierexe.ru/download/api/measoft_ос3.ocmod.zip Скачать для версии 3.0]
|Поддерживает версии с 1.5.5.1.<br>Скачивайте модули для своей версии OpenCart.<br>Подробнее см. [[OpenCart|описание]].<br>[https://opencartforum.com/files/file/2906-avtomatizaciya-otpravki-i-otslezhivanie-dostavok-courierexe-dlya-opencart-15x/ Альтернативный модуль сторонних разработчиков]
|-
|[[Файл:webasyst-shopscript.png|center|x44px]]
|style="text-align: center;"|[https://www.webasyst.ru/store/plugin/shop/measoftcourier/ Установить модуль]<br>[https://www.webasyst.ru/store/plugin/shipping/measoftcourier/ Установить плагин]
|Модуль предназначен для отправки заявок в КС, а плагин для расчета стоимости доставки при оформлении заказа.
|-

|[[Файл:insales.png|center|x80px]]
|style="text-align: center;"|Настраивается в [[Личный кабинет клиента|ЛК пользователя]]
|[[InSales|Инструкция по настройке]]
|-
|[[Файл:Leadvertex.png|center|x44px]]
|style="text-align: center;"|[https://blog.leadvertex.ru/news/2110-integraciya-s-kurerkami-na-platforme-measoft Настраивается] в ЛК [https://Leadvertex.ru Leadvertex]
|[[LeadVertex|Инструкция по настройке]]<br>Модуль разработан и поддерживается компанией LeadVertex.
|-
|[[Файл:Retailcrm.png|center|x30px]]
|style="text-align: center;"|[https://www.retailcrm.ru/ RetailCRM]
|[[RetailCRM|Настраивается]] в ЛК пользователя в системе
|-
|[[Файл:1C.jpg|center|x44px]]
|style="text-align: center;"|-
|[https://infostart.ru/public/692790/ Альтернативный модуль сторонних разработчиков (1 версия)]

[https://infostart.ru/public/1531484/ Альтернативный модуль сторонних разработчиков (2 версия)]
|-
|[[Файл:Joomla2.jpg|center|x60px]]
|style="text-align: center;"|[https://courierexe.ru/download/api/com_measoft.zip Скачать]
|Работает только с компонентом Virtuemart.
|-
|[[Файл:Amocrm.png|center|x44px]]
|style="text-align: center;"|[https://www.amocrm.ru/extensions/courier2008 Установить]
|Подробнее см. [[amoCRM|описание]].
|-
|rowspan="2"|[[Файл:MoySclad.jpg|center|x30px]]
|style="height:50px; text-align: center;"|[https://home.courierexe.ru/moysklad/step1 Настроить интеграцию с MeaSoft]
|[[МойСклад|Инструкция]]
|-
|style="height:50px; text-align: center;"|[https://itmdev.ru/ms/shipping/ Скачать модуль сторонних разработчиков]
|Интеграция МойСклад с курьерскими службами от сторонних разработчиков
|-
|[[Файл:wordpress.jpg|center|x80px]]
|style="text-align: center;"|[https://courierexe.ru/download/api/wordpress.zip Скачать]
|[[Wordpress|Инструкция]]
|-
|[[Файл:Cscart.png|center|x60px]]
|style="text-align: center;"|[https://marketplace.cs-cart.com/measoft-en.html Установить]
|Поддерживает версии 4.10 и выше.<br>[[CS-Cart|Инструкция]]
|-
|style="height:100px; text-align: center;"|'''Webhook'''
|style="text-align: center;"|Читайте описание [[Webhook|на этой странице]]
|Передача информации о статусах и заказах в вашу систему
|-
|}

'''Обратите внимание!''' В модулях систем PrestaShop и Joomla для отправки заказа в курьерскую службу зайдите в карточку заказа. В карточке отображается специальная форма отправки заказа, а если заказ отправлен, она позволяет проверить его статус:[[Файл:Form.png|400 px|Форма отправки заказа|none]]

Для отображения списка пунктов выдачи есть [https://home.courierexe.ru/js/measoft_map.js JavaScript модуль]. Инструкция по использованию — внутри. Посмотреть пример работы можно [https://home.courierexe.ru/pvz_test.html здесь].

== Тестовый аккаунт ==

Для отладки зайдите в тестовый личный кабинет по адресу [https://home.courierexe.ru/8 https://home.courierexe.ru/8], логин: login пароль: pass.

На вкладке '''Интеграция''' > '''Отладка''' вы можете пробовать выполнять запросы к API для отладки, а также видеть историю отправленных запросов. Созданные заказы появятся в пункте основного меню '''Отслеживание'''.

Для упрощения интеграции можно скачать [https://courierexe.ru/download/api/php_sample.zip пример обращения к сервису на PHP].

== Рабочий аккаунт для подключения ==

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

<source lang=xml>
<auth extra="8" login="login" pass="pass"></auth>
</source>

Описание параметров:
* '''extra''' — экстра-код, уникальный идентификатор компании, с которой вы интегрируетесь.
* '''login''' — логин клиента;
* '''pass''' — пароль клиента.

Запросите эти данные у курьерской службы, к которой вы подключаетесь. Курьерская служба передает временный пароль, его нужно сменить после первого входа в [[Личный кабинет клиента|ЛК клиента]].

== Авторизация курьерской службы ==

Если курьерской службе требуется подключение под своими учетным данными, используйте строку вида:

<source lang=xml>
<auth extra="8" login="login" pass="pass" clientcode="123"></auth>
</source>

Описание:
* '''extra''' — уникальный идентификатор компании;
* '''login''' — логин курьерской службы;
* '''pass''' — пароль курьерской службы;
* '''clientcode''' — внутренний код клиента (вкладка '''Клиенты''', столбец «Внутренний код»).

Вы можете узнать код экстра, логин и пароль курьерской службы в офисном приложении MeaSoft в справочнике '''Дополнительные возможности'''. Подробнее см. раздел [[Личный_кабинет_курьерской_службы#Подключение|«Подключение»]].

== Общие понятия ==
На стороне курьерской службы имеется веб-сервис по адресу: https://home.courierexe.ru/api/. <rspoiler text="Еще есть порт 8443.">Некоторые маршрутизаторы, используемые провайдерами, РНК и прочее, в попытке глубокого анализа могут повреждать трафик на стандартный порт 443. Сделано по тикету 10964.</rspoiler> Обратите внимание на символ '''"/"''' (slash) в конце адреса! Тестовые авторизационные данные: логин: login пароль: pass, параметр extra: 8. Обратите внимание, что тестовая площадка для всех одна. Не нужно передавать в нее заказы с конфиденциальными данными, их смогут увидеть другие участники.

Для использования интеграции в «боевом» режиме, запросите '''логин''', '''пароль''', и параметр '''extra''' у той компании, с которой интегрируетесь.

Вы можете отправлять тестовые запросы к нашему сервису и видеть историю отправленных запросов в личном кабинете на закладке '''Интеграция'''.

Клиент отправляет запросы к сервису методом HTTP POST, сервис обрабатывает запросы и возвращает результат выполнения. Все запросы и ответы передаются в формате XML.
Кодировка — UTF-8. Разделитель целой и дробной частей чисел — используется символ точки. Даты представляются в виде YYYY-MM-DD, время — HH:MM.

В силу [https://ru.wikipedia.org/wiki/XML#.D0.A0.D0.B5.D1.88.D0.B5.D0.BD.D0.B8.D0.B5_.D0.BF.D1.80.D0.BE.D0.B1.D0.BB.D0.B5.D0.BC.D1.8B_.D0.BD.D0.B5.D0.BE.D0.B4.D0.BD.D0.BE.D0.B7.D0.BD.D0.B0.D1.87.D0.BD.D0.BE.D1.81.D1.82.D0.B8_.D1.80.D0.B0.D0.B7.D0.BC.D0.B5.D1.82.D0.BA.D0.B8 особенностей языка XML], некоторые символы в тексте должны быть заменены: & на &amp; < на &lt; > на &gt; " на &quot;

Наше API принципиально работает только по HTTPS, так как передает конфиденциальные данные. В некоторых системах с этим возникают проблемы. Если ваша система не может полноценно работать с шифрованием, мы рекомендуем развернуть http-сервер у себя локально, установить [http://courierexe.ru/download/api/proxy.zip прокси на PHP]. <spoiler text="Как запустить">Для теста можете запустить его на сервере следующей командой: php -S <IP>:8080 proxy.php
где <IP> — это адрес вашего сервера, а 8080 порт, на котором будут приниматься запросы.
Тогда для обмена данными с нашим АПИ необходимо будет использовать адрес <IP>:8080</spoiler>
Доступность функций, описанных в этом разделе, зависит от [[Личный кабинет курьерской службы#Функции личного кабинета|тарифа вашего личного кабинета]].

== Ограничения ==
С целью защиты от нецелевого использования сервисов и DDoS-атак действуют следующие ограничения:
*30 запросов tracking с одного IP-адреса за 1 минуту (используйте statusreq!);
*150 запросов с одного IP-адреса/акаунта за 1 минуту;
*1500 запросов с одного IP-адреса/акаунта за 20 минут;
*3000 запросов с одного аккаунта за 1 час;
*200 Мб скачанных текстовых данных за 3 часа.
*Превышение количества запросов статусов несуществующих заказов над существующими

В случае превышения IP-адрес или аккаунт блокируется на время до 3-х часов.

Чтобы не происходило блокировок:
* не нужно «бомбить» наше API запросами статусов, последовательно перебирая номера всех ваших заказов, особенно запросами "tracking", они предназначены не для этого (смотрите описание). Особенно ровно в 00 минут каждого часа;
* не нужно каждые 5 минут делать запросы «Покажите статусы всех заказов за последние 3 месяца»;
* для проверки статусов заказов лучше всего использовать запросы [[#Передача только изменившихся статусов|измененных статусов changes=ONLY_LAST]];
* при запросе измененных статусов ОБЯЗАТЕЛЬНО нужно подтверждать успешное получение запросом [[#Передача только изменившихся статусов|commitlaststatus]].
* вы должны знать номера заказов, которые вы отправили. Не нужно перебирать номера всех заказов или брутфорсом перебирать все возможные номера.

Мы абсолютно уверены, что данные ограничения на порядки превосходят необходимые объемы предоставления сервиса для решения любых задач. Если у вас возникают проблемы, вы не знаете, как уложиться в эти рамки — спросите у нас, мы обязательно поможем!

== Оформление заказа ==
=== Пример оформления заказа ===

<source lang=xml>
<?xml version="1.0" encoding="UTF-8"?>
<neworder newfolder="NO">
<auth extra="8" login="login" pass="pass"></auth>
<order orderno="111111">
<barcode>111111</barcode>
<sender>
<company>МВД</company>
<person>Иванов И.И.</person>
<phone>123-45-67</phone>
<town>Санкт-Петербург</town>
<address>Петровка 38 офис 35</address>
<date>2014-03-22</date>
<time_min>09:00</time_min>
<time_max>14:00</time_max>
</sender>
<receiver>
<company>МВД</company>
<person>Чип & Дейл</person>
<phone>123-45-67</phone>
<zipcode>125480</zipcode>
<town regioncode="78" country="RU">Санкт-Петербург</town>
<address>Петровка 38 офис 35</address>
<pvz>124</pvz>
<inn>1112223335</inn>
<date>2014-03-22</date>
<time_min>09:00</time_min>
<time_max>14:00</time_max>
<deliveryPIN>1234</deliveryPIN>
<coords lat="55.680327" lon="37.604456"></coords>
</receiver>
<return>NO</return>
<weight>5.1</weight>
<return_weight>5.1</return_weight>
<quantity>2</quantity>
<paytype>CASH</paytype>
<service>2</service>
<return_service>1</return_service>
<type>3</type>
<return_type>3</return_type>
<courier>22</courier>
<price>387.5</price>
<deliveryprice VATrate="20">150</deliveryprice>
<inshprice>387.5</inshprice>
<receiverpays>NO</receiverpays>
<discount>120</discount>
<enclosure>Детские игрушки</enclosure>
<instruction>Проверить при покупателе, подписать акт</instruction>
<department>Отдел</department>
<pickup>NO</pickup>
<acceptpartially>NO</acceptpartially>
<costcode>cc12345</costcode>
<respstore>4</respstore>
<items>
<item extcode="abc123" quantity="1" mass="0.2" retprice="37.5" VATrate="0" barcode="2345625213125" textArticle="1" article="1" volume="3" origincountry="AUT" GTD="321546654" excise="15.20" suppcompany="ООО "Рога и копыта"" suppphone="79161234567" suppINN="1112223334" governmentCode="11223311">Мяч</item>
<item extcode="abc124" quantity="2" mass="2" retprice="100" inshprice="100" VATrate="10" barcode="4645625213138" article="2" length="10" width="20" height="30" origincountry="004">Обруч</item>
<item extcode="abc125" quantity="3" mass="0.3" retprice="50" inshprice="50" barcode="2345625213126" itemcode="44123" article="3" type="1">Погремушка желтая</item>
</items>
<packages>
<package strbarcode="ORD0000001" mass="1" message="" quantity="3"></package>
<package strbarcode="ORD0000002" mass="2.5" message="" length="10" width="20" height="30"></package>
</packages>
<deliveryset above_price="100" return_price="1000" VATrate="10">
<below below_sum="500" price="500" />
<below below_sum="2000" price="300" />
</deliveryset>
<advprices>
<advprice>
<code>1</code>
<value>123</value>
</advprice>
<advprice>
<code>2</code>
<value>10.5</value>
</advprice>
<advprice>
<code>3</code>
<value>true</value>
</advprice>
</advprices>
<overall_volume>81</overall_volume>
<userid>user123</userid>
<groupid>customer</groupid>
</order>
</neworder>
</source>

=== Описание элементов для оформления заказа ===
'''Обязательные поля'''

Обязательными на уровне системы являются только 3 поля: receiver->company или receiver->person, receiver->address и receiver->phone. Так же в настройках системы сама курьерская служба может назначить какие-то дополнительные поля обязательными, тогда, если вы их не укажете, получите сообщение об ошибке.
<spoiler text="Пример минимально возможного заказа">
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<neworder>
<auth extra="8" login="login" pass="pass" />
<order>
<receiver>
<company>МВД</company>
<phone>(495)123-45-67</phone>
<address>Петровка, 38</address>
</receiver>
</order>
</neworder>
</source>
</spoiler>

'''Описание полей'''

*'''neworder''' - Корневой контейнер, обязательный элемент.

:* '''''newfolder''''' - Признак нового заказа YES/NO. Если стоит YES, то в системе курьерской службы для данной корреспонденции создастся новый заказ. Необязательный элемент.

*'''order''' - Контейнер для описания одного заказа, обязательный элемент. В одном контейнере '''neworder''' может быть много контейнеров '''order''' для создания нескольких заказов одним запросом.

:* '''''orderno''''' - Номер заказа. Если присваивается клиентом - указывается здесь. Если не присваивается - можно оставить пустым, система сгенерирует свой номер, и вернет его в ответе. Система проверяет наличие заказов с указанным номером в пределах текущего календарного года, и в случае их существования - заказ создан не будет, а в ответе вернется ошибка 17 "Such number exists". Если не указан штрих-код (поле barcode), и значение поля подходит для использования его в качестве штрих-кода, данное значение будет скопировано в поле "Штрих-код". Это накладывает ограничения в частности, на длину указанного поля (25 знаков, чтобы работали стандартные печатные формы).

*'''barcode''' - Штрих-код заказа. Если клиент штрихкодирует свои отправления и штрихкод отличается от номера заказа, в этом поле указывается штрихкод. В случае наличия нескольких мест и раздельной их маркировки в этом поле допустимы маски в виде символов подчеркивания, говорящие о позициях штрихкода, переменных для разных мест в рамках одного заказа.<br />
''Например'': В заказе номер 123 имеется 20 товарных вложений, которые упакованы в 3 транспортных места. Клиент формирует 3 штрихкода на транспортные места: CLNT0012301, CLNT0012302, CLNT0012303, где CLNT - префикс клиента, 00123 - номер заказа, 01-03 - номер транспортного места в заказе. В поле barcode нужно указать CLNT00123__ (система поймет, что 2 последних символа могут быть любыми и будут отражать штрихкоды к одному заказу). Если вы не сами печатаете накладные с указанным штрихкодом, то указанный штрихкод не должен быть длиннее 25 знаков, иначе он не поместится на стандартных печатных формах.

*'''sender''' - Информация о отправителе заказа. Необязательный контейнер.
<source lang="xml">
<sender>
<company>Название компании отправителя</company>
<person>Контактное лицо отправителя</person>
<phone>Телефон, Email отправителя</phone>
<town>Город отправителя в формате "Москва город"</town>
<address>Адрес отправителя</address>
<date>Дата забора в формате "YYYY-MM-DD"</date>
<time_min>Желаемое время забора в формате "HH:MM"</time_min>
<time_max>Желаемое время забора в формате "HH:MM"</time_max>
</sender>
</source>

*'''receiver''' - Информация о получателе заказа. Обязательный контейнер.
<source lang="xml">
<receiver>
<company>Название компании получателя</company>
<person>Контактное лицо получателя</person>
<phone>Телефон, Email получателя</phone>
<town regioncode="Код региона">Город получателя в формате "Москва город"</town>
<address>Адрес получателя</address>
<inn>ИНН получателя</inn>
<pvz>Код пункта самовывоза по справочнику</pvz>
<date>Дата доставки в формате "YYYY-MM-DD"</date>
<time_min>Желаемое время доставки в формате "HH:MM"</time_min>
<time_max>Желаемое время доставки в формате "HH:MM"</time_max>
<deliveryPIN>Пин-код для подтверждения получателем</deliveryPIN>
<coords lat="55.680327" lon="37.604456"></coords>
</receiver>
</source>

*'''company''' - Компания-получатель.
*'''person''' - Контактное лицо. ''Должно быть заполнено хотя бы одно из полей - company или person!''
*'''phone''' - Телефон. Можно указывать несколько телефонов, E-mail в этом поле.
*'''town''' - Город.
*'''pvz''' - Код пункта самовывоза по справочнику. Кроме того, ПВЗ можно указать в строке '''''address''''' в виде:
:* код ПВЗ в нашей системе
:* код ПВЗ в системе подрядчика
:* наименование ПВЗ в виде строки "ПВЗ " + "Наименование ПВЗ"

Для тега города '''town''' можно указать код региона в атрибуте '''''regioncode''''' из [[#Справочник регионов|справочника регионов]]. Поиск будет производиться в указанном регионе.

Также можно указать страну получателя в атрибуте '''''country''''' в соответствии с [https://ru.wikipedia.org/wiki/ISO_3166-1 стандартом ISO_3166-1], например, "RU", "RUS" или "643" для России.

Кроме того, поиск города осуществляется с учетом почтового индекса, указанного в теге '''zipcode'''.

Поле '''Город''' контейнеров '''sender''' и '''receiver''' можно указать одним из следующих способов:
:* код населенного пункта из [[#Справочник городов|справочника городов]]
:* 13-ти значный код адресного классификатора КЛАДР
:* 36-ти значный код адресной системы <rspoiler text="ФИАС">Федеральная информационная адресная система — единый российский государственный адресный реестр</rspoiler> (AOID)
:* название города (не рекомендуется!)

*'''coords''' - Координаты получателя. Если не указаны, система будет геокодировать самостоятельно.

*'''paytype''' - Тип оплаты заказа получателем. Принимает значения:
:* CASH - Наличными при получении (по-умолчанию)
:* CARD - Картой при получении
:* NO - Без оплаты. Этот тип оплаты передается, если заказ уже оплачен и не требует инкассации. API добавит к товарам строку предоплаты в сумму заказа, чтобы общая сумма была 0, однако в кассовом чеке будут все товары с ценами, и оплата предоплатой, как того требует 54-ФЗ.
:* OTHER - Прочее (Предусмотрен для того, чтобы оплата поступала непосредственно в курьерскую службу посредством прочих типов оплаты - таких как: вебмани, яденьги, картой на сайте, прочие платежные системы и т.д.)
:* OPTION - На выбор получателя. Этот тип оплаты нельзя передавать с заказом. Он выставляется автоматически в зависимости от настройки клиента.

*'''zipcode''' - Почтовый индекс.
*'''weight''' - Общий вес заказа в килограммах.
*'''return_weight''' - Общий вес возврата заказа в килограммах.
*'''quantity''' - Количество мест.
*'''service''' - Режим доставки (тип услуги) передается код из справочника [[#Справочник Видов срочности|"Виды срочности"]].
*'''return_service''' - Режим возврата (тип услуги) передается код из справочника "Виды срочности".
*'''type''' - Тип корреспонденции (отправления) передается код из справочника "Типы корреспонденции".
*'''return_type''' - Тип возвратной корреспонденции (отправления) передается код из справочника "Типы корреспонденции".
*'''price''' - Сумма заказа. В случае наличия контейнера items значение этого параметра будет проигнорировано и рассчитано автоматически.
*'''deliveryprice''' - Сумма доставки. В случае наличия контейнера items в него будет добавлено вложение "Доставка".
:* '''''VATrate''''' - Ставка НДС - целое число процентов.
*'''return''' - Признак необходимости возврата.
*'''return_service''' - Режим возврата (тип услуги) передается код из справочника "Виды срочности".
*'''discount''' - Сумма скидки. Скидка "размазывается" по товарным вложениям, сумма НП уменьшается на сумму скидки. При этом вложение Скидка не создается. ВНИМАНИЕ, при использовании этого тега общая сумма может расходиться на копейки из-за округления! Старайтесь не использовать этот тег, а указывать цену товаров уже с учетом скидок.
*'''enclosure''' - Вложение.
*'''inshprice''' - Объявленная ценность. Если явно не указана сумма - автоматически считается как сумма по товарам.
*'''instruction''' - Поручение - Примечание.
*'''courier''' - Запланированный курьер. Согласно коду курьера в КС2008.
*'''receiverpays''' - Признак оплаты стоимости доставки - услуг службы доставки получателем, а не заказчиком YES/NO.
*'''department''' - Подразделение, в котором оформляется заказ.
*'''pickup''' - Признак оформления забора YES/NO. Если стоит YES, то весь заказ считается заданием на забор груза, а не на доставку! Применяется для вызова курьера к отправителю для забора других отправлений. ''Внимание!'' при добавлении в забор складских товаров, их тип '''''type''''' всегда должен быть установлен как [7] Забор товара, если будет указан другой тип, то он будет исправлен в момент добавления заказа на [7] Забор товара
*'''acceptpartially''' - Признак возможности частичного выкупа товаров отправления YES/NO.

*'''items''' - Контейнер для описания вложений. <rspoiler text="Необязательный контейнер">Если для поставщика товара в системе MeaSoft не указаны полное наименование компании и ИНН в карточке клиента, заполните параметры <code>suppcompany</code> и <code>suppINN</code> в этом контейнере. Отсутствие информации о поставщике приведет к [[Настройка модуля печати кассовых чеков#Ошибка фискализации (ошибка программирования реквизита 1226)|ошибке фискализации]].</rspoiler>. Атрибуты:
:* '''''item''''' - Название вложения.
:* '''''quantity''''' - Количество единиц товара.
:* '''''mass''''' - Масса единицы товара в килограммах.
:* '''''volume''''' - Объемный вес единицы товара в килограммах. При указании объемного веса значение подставляется вместо массы
:* '''''length''''' - Длина единицы товара (в сантиметрах).
:* '''''width''''' - Ширина единицы товара (в сантиметрах).
:* '''''height''''' - Высота единицы товара (в сантиметрах).
:* '''''retprice''''' - Цена единицы товара. Округляется до копеек. Должна быть с учетом всех скидок и наценок. Для вложений типов 1, 2, 3 не может быть отрицательной. 
:* '''''inshprice''''' - Объявленная ценность единицы товара. Округляется до копеек. Если не указана принимается равной '''''retprice'''''.
:* '''''VATrate''''' - Ставка НДС - целое число процентов. Если значение не указано, подставляется значение "20". Значение "0" означает ставку "Без НДС", ставка "0%" на данный момент не поддерживается.
:* '''''barcode''''' - Штрих-код вложения. [[Файл:Article.png|thumb|100px|right]]
:* '''''article''''' - Артикул вложения. ''Внимание!'' Указание артикула используется только тогда, когда товар хранится на ответственном хранении в службе доставки, и необходима комплектация. В этом случае система пытается привязать товар к [[API#Справочник номенклатуры|справочнику номенклатуры]]. Если товар в справочнике не найден - система выдаст соответствующую ошибку. Если по артикулу найдено несколько товаров - система выберет один из них случайным образом, что может привести к ошибочной комплектации! Если товар НЕ на ответственном хранении - артикул указывать НЕ нужно. Позиция попадет в систему просто текстом.
:* '''''itemcode''''' - Внутренний код товара, может использоваться вместо артикула. ''Внимание!'' Указание кода товара используется только тогда, когда товар хранится на ответственном хранении в службе доставки, и необходима комплектация. В этом случае система пытается привязать товар к [[API#Справочник номенклатуры|справочнику номенклатуры]]. Если товар в справочнике не найден - система выдаст соответствующую ошибку. Если товар НЕ на ответственном хранении - код товара указывать НЕ нужно.
:* '''''type''''' - Тип вложения. Принимает значения:
:: 1 - Товар. По-умолчанию.
:: 2 - Доставка. Такое вложение добавится автоматически, если заполнить order->deliveryprice
:: 3 - Услуга
:: 4 - Предоплата. Указывается сумма. Поле quantity игнорируется, всегда "1". В заказе сумма будет отрицательной независимо от знака в запросе. Такое вложение добавится автоматически при указании order->paytype=NO.
:: 6 - Оплата кредитом. Указывается сумма. Поле quantity игнорируется, всегда "1". В заказе сумма будет отрицательной независимо от знака в запросе.
:: 7 - Забор товара. Если товар нужно у получателя забрать, возможно - вернуть деньги, или его стоимость вычтется из суммы других товаров. У такого товара в заказе будет отрицательное количество независимо от знака в запросе.
:* '''''extcode''''' - Внешний код строки. Используется для идентификации строк заказов при получении статусов. Необязательное поле.
:* '''''origincountry''''' - Код страны-производителя в соответствии со [https://ru.wikipedia.org/wiki/ISO_3166-1 стандартом ISO_3166-1], например, "RU", "RUS" или "643" для России.
:* '''''GTD''''' - Номер ГТД.
:* '''''excise''''' - Сумма акциза.
:* '''''suppcompany''''' - Наименование компании поставщика, если отличается от заказчика.
:* '''''suppphone''''' - Номер телефона компании поставщика, если отличается от заказчика.
:* '''''suppINN''''' - ИНН компании поставщика, если отличается от заказчика.
:* '''''governmentCode''''' - Код товарной номенклатуры. Используется для [[Маркировка | маркированных товаров ("Честный знак")]]. Нужно указывать все данные из нанесенного QR-кода кроме не читаемых символов (#29). Если код не известен - укажите знак вопроса "?", тогда курьер отсканирует код фактически передаваемого покупателю товара. Для некоторых процессов может использоваться значение "!" - в этом случае курьер сканирует серийный номер товара, но это не считается кодом маркировки. Если поле заполнено - поле quantity должно содержать только "1", иначе вернется ошибка.

*'''packages''' - Контейнер для описания мест. Необязательный контейнер. Атрибуты:
:* '''''package''''' - Название места.
:* '''''code''''' - Внутренний код строки.
:* '''''strbarcode''''' - Штрих-код места.
:* '''''mass''''' - Масса места в килограммах.
:* '''''message''''' - Строка сообщения.
:* '''''length''''' - Длина товарного места (в сантиметрах).
:* '''''width''''' - Ширина товарного места (в сантиметрах).
:* '''''height''''' - Высота товарного места (в сантиметрах).
:* '''''quantity''''' - Количество мест с данным набором параметров. Действует ограничение на общее количество мест в заказе. Общее количество мест в заказе не может быть больше 1000.

* '''deliveryset''' - настройка [[Дифференцированная стоимость доставки | дифференцированной стоимости доставки]]. Атрибуты:
:* '''''above_price''''' - стоимость в случае полного выкупа заказа (действует как "сумма от" последней границы, указанной в теге below_sum)
:* '''''return_price''''' - стоимость в случае возврата заказа
:* '''''VATrate''''' - Ставка НДС - целое число процентов.

* '''below''' - граница стоимости настроек
:* '''''below_sum''''' - граница стоимости выкупаемого заказа
:* '''''price''''' - стоимость выкупаемого заказа до соответствующей границы

* '''advprices''' - Контейнер для описания дополнительных услуг. Необязательный элемент. <span style="color: red;>Для обработки в API включите дополнительные услуги в настройках полей [[Личный_кабинет_курьерской_службы#Настройка личного кабинета клиента|заказов и заборов]]</span>
:* '''''code''''' - код услуги.
:* '''''value''''' - значение услуги. Если тип услуги bool, то в значении передаем true.

*'''costcode''' - Кост-код сотрудника.
*'''respstore''' - Код ответственного филиала.

*'''overall_volume''' - Общий объем, м3. Виртуальное поле. Необязательное. Из этого поля рассчитывается длина/высота/ширина места. Расчет срабатывает только если в каждом месте есть нулевые значения длины или высоты или ширины.

*'''userid''' - Идентификатор пользователя, строковый или числовой тип. Виртуальное поле. Необязательное. Данное поле используется совместно с настройками "Цена доставки для получателя", определяя приоритет правила. Можно использовать в различных CMS/CRM системах, настраивая цены для определенного покупателя.

*'''groupid''' - Идентификатор группы пользователя, строковый или числовой тип. Виртуальное поле. Необязательное. Данное поле используется совместно с настройками "Цена доставки для получателя", определяя приоритет правила. Можно использовать в различных CMS/CRM системах, настраивая цены для определенной группы покупателей.

<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
'''Обратите внимание!'''
При передаче заказов, у которых плановая дата доставки/забора меньше ближайшей возможной, дата автоматически меняется на самую раннюю возможную. [[Личный_кабинет_курьерской_службы#Как считается минимальная дата возможной доставки|Подробнее]]</div>

В случае необходимости указания, помимо товаров, дополнительных услуг (например, ДОСТАВКА, комплектация, подъем на этаж и т.д.) - их нужно указать в том же контейнере items как товары, без артикула.

=== Примеры ответов ===
При успешном выполнении запроса, создании заказа, возвращается сумма заказа в атрибуте orderprice, а также ошибка 0. При не успешном - номер ошибки и текст ее на английском языке в атрибуте errormsg, для некоторых ошибок выводится перевод на русский в атрибуте errormsgru.
В атрибут orderno помещается номер заказа, в атрибут barcode - штрихкод заказа.

'''Пример успешного ответа'''

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<neworder>
<createorder orderno="AB23541" barcode="67567#114" error="0" errormsg="Success" errormsgru="Успешно" orderprice="5000" />
<createorder orderno="AB23542" barcode="67567#115" error="0" errormsg="Success" errormsgru="Успешно" orderprice="6000" />
<createorder orderno="AB23543" barcode="67567#116" error="0" errormsg="Success" errormsgru="Успешно" orderprice="0" />
</neworder>
</source>

'''Пример ответа с ошибкой'''

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<neworder>
<createorder orderno="AB23541" barcode="67567#114" error="67" errormsg="Order barcode already exists in the database." errormsgru="Такой штрихкод заказа уже есть в базе." />
<createorder orderno="AB23542" barcode="67567#115" error="17" errormsg="Order number already exists in the database." errormsgru="Такой номер заказа уже есть в базе." />
<createorder orderno="AB23543" barcode="67567#116" error="67" errormsg="Order barcode already exists in the database." errormsgru="Такой штрихкод заказа уже есть в базе." />
</neworder>
</source>

'''Пример ответа при ошибке авторизации'''

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<request>
<error error="1" errormsg="authorization error"></error>
</request>
</source>

'''Пример ответа при ошибке синтаксиса'''

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<request>
<error>column:1 line:11 message:expected '>'</error>
</request>
</source>

=== Коды и описание ошибок ===

{|class=wikitable
!Код ошибки
!Английское описание
!Русское описание
|-
|0||Success||Успешно
|-
|1||Wrong XML||Некорректный файл XML.
|-
|2||Lat is empty||Укажите широту.
|-
|3||Specify a valid "Price" field value.||Укажите корректное значение поля «Сумма».
|-
|4||Specify a valid "Weight" field value.||Укажите корректное значение поля «Вес».
|-
|5||Recepient city/town not found.||Город назначения не найден.
|-
|6||Sender city/town not found.||Город отправления не найден.
|-
|7||Specify the "Recipient address" field value.||Укажите значение поля «Адрес получателя».
|-
|8||Specify the "Recipient phone" field value.||Укажите значение поля «Телефон получателя».
|-
|9||Specify the "Recipient name" field value.||Укажите значение поля «ФИО получателя».
|-
|10||Specify a valid "Quantity" field value.||Укажите корректное значение поля «Количество».
|-
|11||Specify a valid "Declared value" field value.||Укажите корректное значение поля «Объявленная ценность».
|-
|12||Supplier SKU ID not found.||Артикул не найден.
|-
|17||Order number already exists in the database.||Такой номер заказа уже есть в базе.
|-
|18||Order code already exists in the database.||Такой код заказа уже есть в базе.
|-
|19||The delivery date format is not valid. Specify a date in YYYY-MM-DD format.||Укажите значение поля «Дата доставки» в формате гггг-мм-дд.
|-
|20||Specify a valid "Delivery mode" field value.||Укажите корректное значение поля «Режим доставки».
|-
|21||Specify a valid "Return trip mode" field value.||Укажите корректное значение поля «Режим возврата».
|-
|22||Specify a valid "Delivery type" field value.||Укажите корректное значение поля «Тип доставки».
|-
|23||Specify a valid "Return shipment type" field value.||Укажите корректное значение поля «Тип возврата».
|-
|30||Specify the "Order number" field value.||Укажите значение поля «Номер заказа».
|-
|31||Specify the "Barcode" field value.||Укажите значение поля «Штрихкод».
|-
|32||Specify the "Sender company" field value.||Укажите значение поля «Компания-отправитель».
|-
|33||Specify the "Sender name" field value.||Укажите значение поля «ФИО отправителя».
|-
|34||Specify the "Sender phone" field value.||Укажите значение поля «Телефон отправителя».
|-
|35||Specify the "Sender city/town" field value.||Укажите значение поля «Город отправителя».
|-
|36||Specify the "Sender address" field value.||Укажите значение поля «Адрес отправителя».
|-
|37||Specify the "Pickup date" field value.||Укажите значение поля «Дата забора».
|-
|38||Specify the "Pickup time from" field value.||Укажите значение поля «Время забора с».
|-
|39||Specify the "Pickup time to" field value.||Укажите значение поля «Время забора до».
|-
|40||Specify the "Recipient company" field value.||Укажите значение поля «Компания-получатель».
|-
|41||Specify the "Recipient name" field value.||Укажите значение поля «ФИО получателя».
|-
|42||Specify the "Recipient phone" field value.||Укажите значение поля «Телефон получателя».
|-
|43||Specify the "Recipient city/town" field value.||Укажите значение поля «Город получателя».
|-
|44||Specify the "Recipient address" field value.||Укажите значение поля «Адрес получателя».
|-
|45||Specify the "Delivery date" field value.||Укажите значение поля «Дата доставки».
|-
|46||Specify the "Delivery time from" field value.||Укажите значение поля «Время доставки с».
|-
|47||Specify the "Delivery time to" field value.||Укажите значение поля «Время доставки до».
|-
|48||Specify the "Recipient postcode" field value.||Укажите значение поля «Индекс получателя».
|-
|49||Specify the "Weight" field value.||Укажите значение поля «Вес».
|-
|50||Specify the "Payment type" field value.||Укажите значение поля «Тип оплаты».
|-
|51||Specify the "Quantity" field value.||Укажите значение поля «Количество».
|-
|52||Specify the "Amount" field value.||Укажите значение поля «Сумма».
|-
|53||Specify the "Declared value" field value.||Укажите значение поля «Объявленная стоимость».
|-
|54||Specify the "Description" field value.||Укажите значение поля «Описание».
|-
|55||Specify the "Instruction" field value.||Укажите значение поля «Поручение».
|-
|56||Specify the "Delivery mode" field value.||Укажите значение поля «Режим доставки».
|-
|57||Specify the "Shipment type" field value.||Укажите значение поля «Тип отправления».
|-
|58||Specify whether return trip is required.||Укажите значение поля «Необходимость возврата».
|-
|59||Specify the "Return trip mode" field value.||Укажите значение поля «Режим возврата»
|-
|60||Specify the "Return shipment type" field value.||Укажите значение поля «Тип возврата».
|-
|61||Specify barcode.||Укажите штрихкод.
|-
|62||Specify item weight.||Укажите массу единицы товара.
|-
|63||Specify item quantity.||Укажите количество товара.
|-
|64||Specify item price.||Укажите цену единицы товара.
|-
|65||Specify item name.||Укажите название товара.
|-
|66||Wrong XLS file||Некорректный файл XLS.
|-
|67||Order barcode already exists in the database.||Такой штрихкод заказа уже есть в базе.
|-
|68||Select the "Payment by recipient" field value.||Укажите значение поля «Оплата получателем».
|-
|69||Specify department.||Укажите отдел.
|-
|70||Specify service partner code.||Укажите значение поля «Код подрядчика».
|-
|71||Date cannot be earlier than tomorrow.||Дата не может быть раньше чем завтра.
|-
|72||Date cannot be later than 15 days from now.||Дата не может быть позже чем через 15 дней.
|-
|73||Date cannot be earlier than today.||Дата не может быть раньше чем сегодня.
|-
|74||Date cannot be later than {0} days from now.||Дата не может быть позже, чем через {0} дней.
|-
|75||Specify a valid "Item weight" field value.||Укажите корректное значение поля «Масса единицы товара».
|-
|76||Specify a valid "Quantity" field value.||Укажите корректное значение поля «Количество товара».
|-
|77||Specify a valid "Item price" field value.||Укажите корректное значение поля «Цена единицы товара».
|-
|78||Specify a valid "Delivery time from" field value.||Укажите корректное значение поля «Время доставки с».
|-
|79||Specify a valid "Delivery time to" field value.||Укажите корректное значение поля «Время доставки до».
|-
|80||Specify a valid "Pickup time from" field value.||Укажите корректное значение поля «Время забора с».
|-
|81||Specify a valid "Pickup time to" field value.||Укажите корректное значение поля «Время забора до».
|-
|82||Specify a valid "Pickup point" field value.||Укажите корректное значение поля «ПВЗ».
|-
|83||Duplicate number in the registry.||Дублирование номера в реестре.
|-
|84||Duplicate barcode in the registry.||Дублирование штрихкода в реестре.
|-
|85||Specify a valid "Weight at return trip" field value.||Укажите корректное значение поля «Вес возврата».
|-
|86||Specify the "Weight at return trip" field value.||Укажите значение поля «Вес возврата».
|-
|87||Order weight exceeds the allowed maximum for the pickup point.||Вес превышает допустимое значение для этого ПВЗ.
|-
|88||Pickup date cannot be earlier than today.||Дата забора не может быть раньше чем сегодня.
|-
|89||Specify a later delivery date.||Укажите более позднюю дату доставки.
|-
|90||Inappropriate "Weight" or "Pay type" field value for the selected city or town. Please review and correct the values.||Значение поля «Масса» или «Тип оплаты» для выбранного города указано некорректно или отсутствует. Проверьте значения и исправьте.
|-
|91||{deliverytype} {deliverydate} is {holidaytype}. Select another date.||{deliverytype} {deliverydate} является {holidaytype}. Выберите другую дату.
|-
|92||{deliverytype} {deliverydate} is {holidaytype}. Select another date.||{deliverytype} {deliverydate} является {holidaytype}. Выберите другую дату.
|-
|93||Add items.||Добавьте товары.
|-
|95||The selected pickup point only allows paid orders.||Выбранный ПВЗ выдает только предоплаченные заказы.
|-
|96||Order barcode exceeds the allowed maximum (25) symbols.||Длина штрихкода заказа превышает максимально допустимую (25 символов).
|-
|97||The pickup date format is not valid. Specify a date in YYYY-MM-DD format.||Укажите значение поля «Дата забора» в формате гггг-мм-дд.
|-
|98||Specify the cost code.||Укажите значение поля «Кост-код».
|-
|99||The item is not in stock.||Товар отсутствует на складе.
|-
|100||Set the quantity of the item marked with Chestny ZNAK to one.||Укажите количество товара, маркированного кодом «Честный ЗНАК», равным единице.
|-
|101||Quantity of item Delivery cannot be greater than 1||Количество вложений типа «Доставка» не может быть более 1.
|-
|102||А database error occurred. Please try later again.||Ошибка базы данных. Попробуйте позже.
|-
|103||Order not found.||Заказ не найден.
|-
|104||Cannot edit order in the current status.||Невозможно изменить заказ в текущем статусе.
|-
|105||Discount cannot be greater than the order amount. Specify a smaller value.||Размер скидки не может превышать сумму заказа. Укажите меньшее значение скидки.
|-
|106||Specify the correct additional service code.||Укажите корректный код дополнительной услуги.
|-
|107||Specify the correct additional service name.||Укажите корректное значение поля [advprice][value].
|-
|108||Specify the "Additional services" field value.||Укажите значение поля «Дополнительные услуги».
|-
|110||Specify the correct TIN.||Укажите корректный ИНН.
|-
|111||Specify the correct IIN (KZ).||Укажите корректный ИИН (КЗ).
|-
|112||Specify the overall volume.||Укажите общий объем.
|-
|113||Cannot apply the delivery mode. Select another delivery mode.||Режим доставки не подходит для заказа. Выберите другой режим.
|-
|114||The pickup point does not support the selected delivery mode. Specify another pickup point.||ПВЗ не подходит для выбранного режима доставки. Укажите другой ПВЗ.
|-
|115||Specify a valid recipient phone number.||Укажите корректный телефон получателя.
|-
|116||Specify recipient PIN code.||Укажите пин-код получателя.
|-
|117||Order date cannot be earlier than {0}. Specify another date.||Дата заказа не может быть раньше {0}. Укажите другую дату.
|-
|118||Pickup date cannot be earlier than {0}. Specify another date.||Дата забора не может быть раньше {0}. Укажите другую дату.
|-
|119||Specify the correct item type.||Укажите корректный тип вложения.
|-
|120||The pickup point does not accept payment by card.||В выбранном ПВЗ оплата картой не принимается.
|-
|121||Invalid item code format||Неверный формат кода товарной номенклатуры
|-
|}

== Запрос статуса заказов ==

=== Пример запроса статуса заказа ===

<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<statusreq>
<auth extra="8" login="login" pass="pass"></auth>
<client>CLIENT</client>
<orderno>1234</orderno>
<orderno2>5678</orderno2>
<ordercode>34234</ordercode>
<givencode>234534</givencode>
<datefrom>2016-07-21</datefrom>
<dateto>2016-07-21</dateto>
<target>Автозавод</target>
<done>ONLY_NOT_DONE</done>
<changes>ONLY_LAST</changes>
<conditions>
<namecontains/>
<namestarts/>
</conditions>
</statusreq>
</source>

=== Описание полей запроса статуса ===

'''statusreq''' - Корневой контейнер. Обязательный элемент.
*'''auth''' - Авторизация. Обязательный элемент.
*'''client''' - Признак клиента или агента. Необязательный элемент.
:* CLIENT - Признак клиента, значение по умолчанию
:* AGENT - Признак агента. В ответ отдается информация по заказам, переданным агенту на доставку
*'''orderno''' - Номер заказа. Необязательный элемент.
*'''ordercode''' - Внутренний код заказа. Необязательный элемент.
*'''orderno2''' - Номер заказа из срочных. Необязательный элемент.
*'''datefrom''' - Дата заказа "с". Необязательный элемент.
*'''dateto''' - Дата заказа "по". Необязательный элемент.
*'''target''' - Строка поиска. Позволяет указать текст, который содержится в названии компании или адресе получателя.
*'''done''' - Может принимать значения:
:* ONLY_DONE - Только доставленные (имеются в виду успешные статусы, например, '''Доставлен''' или '''Частично доставлен''')
:* ONLY_NOT_DONE - Только не доставленные (заказы, которые не являются доставленными, например, '''Не доставлен''' или '''Утерян''')
:* ONLY_NEW - Только новые
:* ONLY_DELIVERY - Только заказы в обработке - заказы, находящиеся в любом статусе, кроме конечных: Доставлено, Не доставлено, Отменён и т.д.
:* ''Пусто'' - все корреспонденции

*'''changes''' - может принимать значение только ONLY_LAST. Если указан этот параметр, все остальные игнорируются. Описание данного режима приведено здесь: [[#Передача только изменившихся статусов|Передача только изменившихся статусов]]

*'''conditions''' - Задает условия фильтрации по "orderno". Все вложенные элементы одновременно накладывают условие "И". Минимум 5 символов!
:* '''namecontains''' - Поиск по номеру заказа(шифр), который содержит "orderno".
:* '''namestarts''' - Поиск по номеру заказа(шифр), который начинается с "orderno".

<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
'''Обратите внимание!'''
# Периода запроса статусов (контейнеры '''datefrom''' и '''dateto''') ограничивается двумя месяцами — два месяца до даты '''"по"'''.
# Если не указаны обе даты — '''dateto''' принимается равной текущей дате.
# Если не указана дата '''dateto''' — она принимается равной '''datefrom''' плюс 2 месяца.
# Если не указана дата '''datefrom''' — она принимается равной '''dateto''' минус 2 месяца.
# Поиск по '''conditions''' работает только для "Номер заказа(шифр)" и только от 4 символов
</div>
<br />

=== Примеры ответов ===

'''Пример успешного ответа'''

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<statusreq count="23">
<order orderno="111111" awb="qwerty" orderno2="123123" ordercode="34534234" givencode="2345334">
<barcode>111111</barcode>
<sender>
<company>МВД</company>
<person>Иванов И.И.</person>
<phone>123-45-67</phone>
<contacts>
<phone>+74951234567</phone>
</contacts>
<town code="23432">Санкт-Петербург</town>
<address>Петровка 38 офис 35</address>
<date>2014-03-22</date>
<time_min>09:00</time_min>
<time_max>14:00</time_max>
</sender>
<receiver>
<company>МВД</company>
<person>Иванов И.И.</person>
<phone>123-45-67 - Иван (916)234.45.21 Петр,mvd@mail.ru</phone>
<contacts>
<phone>+74951234567</phone>
<phone>+79162344521</phone>
<email>mvd@mail.ru</email>
</contacts>
<inn>1112223335</inn>
<zipcode>125480</zipcode>
<town code="153361" regioncode="78" regionname="Санкт-Петербург город">Санкт-Петербург город</town>
<address>Петровка 38 офис 35</address>
<pvz>
<code>126</code>
<clientcode>QWERTY</clientcode>
</pvz>
<date>2014-03-22</date>
<time_min>09:00</time_min>
<time_max>14:00</time_max>
<coords lat="55.680327" lon="37.604456"></coords>
<deliveryPIN>1234</deliveryPIN>
</receiver>
<pickup>NO</pickup>
<weight>5.1</weight>
<return_weight>5.1</return_weight>
<quantity>2</quantity>
<paytype>CASH</paytype>
<service>2</service>
<return_service>2</service>
<type>3</type>
<return_type>3</return_type>
<waittime>12</waittime>
<price>387.5</price>
<print_check>YES</print_check>
<inshprice>387.5</inshprice>
<enclosure>Детские игрушки</enclosure>
<instruction>Проверить при покупателе, подписать акт</instruction>
<currcoords lat="55.680327" lon="37.604456" accuracy="50" RequestDateTime="2014-04-21 18:07:45"></currcoords>
<courier>
<code>26</code>
<name>Иванов Владимир Петрович</name>
<phone>+79161234567</phone>
</courier>
<deliveryprice total="158.6" delivery="100.00" return="58.6">
<advprice code="1" price="150">База</advprice>
<advprice code="2" price="0">% от объявленной стоимости</advprice>
<advprice code="3" price="8.6">Топливный сбор</advprice>
<advprice code="4" price="0">Округление</advprice>
</deliveryprice>
<receiverpays>NO</receiverpays>
<acceptpartially>NO</acceptpartially>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 17:22:00" createtimegmt="2016-06-03 16:14:44" message="" title="Доставлен">COMPLETE</status>
<statushistory>
<status eventstore="Офис в Москве" eventtime="2016-05-30 10:20:00" createtimegmt="2016-06-03 16:14:44" message="" title="Новый">NEW</status>
<status eventstore="Офис в Москве" eventtime="2016-06-01 17:38:00" createtimegmt="2016-06-03 16:14:44" message="филиал в Санкт-Петербурге" title="Планируется отправка">DEPARTURING</status>
<status eventstore="Офис в Москве" eventtime="2016-06-01 19:53:00" createtimegmt="2016-06-03 16:14:44" message="филиал в Санкт-Петербурге" title="Отправлено со склада">DEPARTURE</status>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 07:41:00" createtimegmt="2016-06-03 16:14:44" message="" title="Получен складом">ACCEPTED</status>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 09:17:00" createtimegmt="2016-06-03 16:14:44" message="" title="Выдан курьеру на доставку">DELIVERY</status>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 17:22:00" createtimegmt="2016-06-03 16:14:44" message="" title="Доставлен (предварительно)">COURIERDELIVERED</status>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 17:22:00" createtimegmt="2016-06-03 16:14:44" message="" title="Доставлен">COMPLETE</status>
</statushistory>
<customstatecode>2<customstatecode>
<clientstatecode></clientstatecode>
<costcode>cc12345</costcode>
<receipt fdNum="124555" fnSn="9289000100295555" kktNum="0001611984048555" inn="7722756555" fdValue="2899551555" summ="387.5" ofdUrl="gate.ofd.ru">https://ofd.ru/rec/7722756555/0001611984048555/9289000100295555/124555/2899551555</receipt>
<deliveredto>Иванова, секр.</deliveredto>
<delivereddate>2016-06-02</delivereddate>
<deliveredtime>17:22</deliveredtime>
<arrival>2016-05-02 23:21</arrival>
<outstrbarcode>EXT123456</outstrbarcode>
<partner>Офис на Ленина</partner>
<return_message>Доставлено в целости</return_message>
<department>Отдел</department>
<items>
<item code="34533" extcode="abc123" quantity="1" mass="0.2" retprice="37.5" VATrate="0" barcode="2345625213125" article="1" returns="0" origincountry="040" GTD="" excise="0.00" governmentCode="11223311" suppcompany="Поставщик" suppINN="1112223334" suppphone="79161234567">Мяч</item>
<item code="34456" extcode="abc124" quantity="2" mass="2" retprice="100" VATrate="10" barcode="4645625213138" article="2" returns="0" governmentCode="">Обруч</item>
<item code="34421" extcode="abc125" quantity="3" mass="0.3" retprice="50" VATrate="18" barcode="2345625213126" itemcode="44123" article="3" returns="0" governmentCode="">Погремушка желтая</item>
</items>
<packages>
<package code="33331" strbarcode="ORD0000001" mass="1" message="" got="YES"></package>
<package code="33332" strbarcode="ORD0000002" mass="2.5" message="" got="NO"></package>
</packages>
</order>
</statusreq>
</source>

'''Пример ответа если нет заказов'''

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<statusreq count="0">
</statusreq>
</source>

'''Пример ответа при ошибке авторизации'''

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<request>
<error error="1" errormsg="authorization error"></error>
</request>
</source>

'''Пример ответа при ошибке синтаксиса'''

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<request>
<error>column:1 line:11 message:expected '>'</error>
</request>
</source>

=== Описание полей ответа статусов ===
Все поля ответа соответствуют структуре order при создании заказа, с некоторыми добавлениями:

* Атрибуты контейнера '''order''':
:* '''''awb''''' - Номер накладной в системе курьерской службы.
:* '''''orderno2''''' - Номер накладной в подсистеме срочной доставки курьерской службы.
:* '''''ordercode''''' - внутренний код заказа в системе, применяется для некоторых внутренних операций.
:* '''''givencode''''' - внутренний код заказа в системе, применяется для некоторых внутренних операций.

* атрибут '''''code''''' контейнера '''item''' - внутренний код строки заказа в системе, применяется для некоторых внутренних операций.
:* '''''returns''''' - количество данного товара, от которого отказался получатель. Не нулевое только в случае частичного отказа.

* атрибут '''''got''''' контейнера '''package''' - признак принятого места YES / NO.
:* '''''returns''''' - количество данного товара, от которого отказался получатель. Не нулевое только в случае частичного отказа.

* '''''coords''''' в контейнере '''receiver''' - координаты получателя.
* '''''deliveryPIN''''' в контейнере '''receiver''' - Пин-код.
* '''pickup''' - признак оформления забора, возможные значения: '''YES''', '''NO'''. Если указано '''YES''', то весь заказ считается заданием на забор груза, а не на доставку.
* '''currcoords''' - текущие координаты заказа. Атрибуты:
:* '''''lat''''' - широта
:* '''''lon''''' - долгота
:* '''''accuracy''''' - точность в метрах
:* '''''RequestDateTime''''' - дата/время последнего обновления координат.

* '''courier''' - Данные курьера, которому выдан заказ. Если заказ не выдан, то выводятся данные запланированного курьера.
* '''waittime ''' - Время ожидания курьера.
* '''deliveryprice''' - Стоимость услуг в валюте расчетов с клиентом. Атрибуты:
:* '''''total''''' - общая стоимость услуг
:* '''''delivery''''' - стоимость доставки "Туда"
:* '''''return''''' - стоимость доставки "Обратно" (если order->return=YES)
Тэг '''deliveryprice''' включает список дополнительных услуг (только для тарифа "Премиум"):
:* '''''advprice''''' - наименование дополнительной услуги
:* '''''code''''' - код дополнительной услуги
:* '''''price''''' - стоимость дополнительной услуги

* '''status''' - статус доставки (список статусов см. ниже). Атрибуты (заполняются начиная с версии системы 2008.0.0.670):
:* '''''eventstore''''' - филиал, к которому относится текущий статус
:* '''''eventtime''''' - время события по часовому поясу места его наступления.
:* '''''createtimegmt''''' - время по GMT создания записи о смене статуса в БД. Используется для сортировки записей, чтобы соблюсти хронологическую последовательность. <spoiler text="Подробнее">Большинство событий фиксируются в полях eventtime и createtimegmt на основании одного действия, тогда они отличаются только сдвигом от GMT. Однако, если курьер доставил отправление 10.10.2010 в 20:00, по какой-то причине не внес это в мобильное приложение, на следующий день сдал накладную, и в 9 утра оператор внесла, что он доставил вчера в 20:00. Тогда в createtimegmt будет сегодня 6 утра (для Москвы), а в eventtime - вчера в 20:00. При этом оператор по каким-то причинам может внести время вручения раньше, чем какое-то предыдущее событие, т.о. нарушится последовательность времени в eventtime, но при сортировке по createtimegmt все-равно все будет правильно.</spoiler>
:* '''''message''''' - наименование филиала-получателя, при передаче между филиалами
:* '''''title''''' - русское наименование статуса

* '''statushistory''' - история статусов доставки. Содержит список контейнеров '''status'''. Заполняется только для тарифа "Премиум" начиная с версии системы 2008.0.0.670.
* '''customstatecode''' - код внутреннего статуса курьерской службы. Значения уточняйте в курьерской службе. Назначаются курьерской службой в разделе "Справочники" - "Статусы" - "15 Статусы корреспонденции". Справочник не передается через API клиенту по причине возможного наличия в нем внутренних технологических статусов курьерской службы.
* '''clientstatecode''' - код статуса клиента. Используется, если клиент предлагает свои коды статусов доставки/причин недоставки.
* '''deliveredto''' - данные из поля "Инфо. о доставке" (может быть информация о доставке, причина недоставки и т.п.).
* '''delivereddate''' - дата вручения.
* '''deliveredtime''' - время вручения. В случае недоставки может быть пустым.
* '''arrival''' - плановая дата прибытия в формате гггг-мм-дд чч:мм:сс
* '''outstrbarcode''' - код у подрядчика (код заказа во внешней системе). Используется в интеграциях с внешними системами.
* '''partner''' - текущий филиал/подрядчик.
* '''return_message''' - информация о возврате
* '''department''' - Подразделение, в котором оформляется заказ.

Контейнер '''status''' может принимать следующие значения:
: AWAITING_SYNC — Ожидает синхронизации. Данные заказа пока не появились в службе доставки.
: '''NEW''' — Успешно создан, передан в службу доставки.
: NEWPICKUP — Создан забор.
: PICKUP — Забран у отправителя.
: WMSASSEMBLED — Скомплектован на складе фулфилмента.
: WMSDISASSEMBLED — Разукомплектован на склад фулфилмента.
: '''ACCEPTED''' — Получен складом.
: CUSTOMSPROCESS — Производится таможенный контроль.
: CUSTOMSFINISHED — Таможенный контроль произведен.
: CONFIRM — Согласована доставка.
: UNCONFIRM — Не удалось согласовать доставку.
: DEPARTURING — Планируется отправка со склада на другой склад.
: DEPARTURE — Отправлено со склада на другой склад.
: INVENTORY — Инвентаризация. Убедились в наличии отправления на складе.
: PICKUPREADY — Готов к выдаче в ПВЗ.
: '''DELIVERY''' — Выдан курьеру на доставку.
: COURIERDELIVERED — Доставлен (предварительно, ождает подтверждения менеджером, чтобы перейти в статус COMPLETE).
: COURIERPARTIALLY — Частично доставлен (предварительно, ождает подтверждения менеджером, чтобы перейти в статус PARTIALLY).
: COURIERCANCELED — Отказ (предварительно, после этого ожидается COURIERRETURN).
: COURIERRETURN — Возвращено курьером. Курьер не смог доставить до получателя и вернул заказ обратно на склад. Это промежуточный статус, после которого менеджер выясняет, нужно ли повторно доставлять (статусы DATECHANGE/DELIVERY) или это окончательная недоставка (CANCELED).
: DATECHANGE — Перенос даты доставки.

: '''COMPLETE''' — Доставлен.
: '''PARTIALLY''' — Доставлен частично.
: '''CANCELED''' — Не доставлен (Возврат/Отмена). После этого статуса отправление должны вернуть заказчику, будут статусы RETURNING и RETURNED

: RETURNING — Планируется возврат заказчику (после CANCELED).
: RETURNED — Возвращен заказчику.
: LOST — Утрачен/утерян.

'''Примечание.''' В будущем возможно дополнение используемого набора статусов.

<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
'''Обратите внимание!'''

# Контейнер '''statushistory''' и '''deliveryprice''' заполняется для тарифов [[Личный кабинет курьерской службы#Функции личного кабинета|Премиум и Максимум]].
# Система никогда не гарантирует последовательность прохождения заказом набора статусов. Т.е. Вы можете получить статус "COMPLETE", а следующим запросом - "NEW" - такое может произойти, например, если оператор ошибочно отметил заказ выполненным, а затем исправил ошибку.
</div>
<br />

=== Передача только изменившихся статусов ===
В нашем API предусмотрено удобное средство получения статусов всех заказов, без необходимости «бомбить» сервер запросами статусов по каждому заказу. Работает это так: раз, например, в 10 минут, вы посылаете запрос «покажите все изменившиеся статусы». Пример запроса ниже. Система вам отдает ВСЕ заказы, статусы (или некоторые другие поля, см. ниже) которых изменились с момента последнего запроса. Вы разбираете полученный документ, по каждому заказу сохраняете его актуальный статус в своей системе, и если все хорошо, у вас все получилось, ваша система неожиданно не упала от наплыва информации, посылаете нам запрос подтверждения получения статусов (commitlaststatus). Мы у себя отмечаем, что эти статусы вами получены и их не надо передавать повторно. Таким образом, сколько бы заказов у вас ни было, статусы по ним всем почти в реальном времени вы можете получать всего двумя запросами.

Для получения только изменившихся статусов отправьте запрос:
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<statusreq>
<auth extra="8" login="login" pass="pass"></auth>
<changes>ONLY_LAST</changes>
<streamid>1234</streamid>
</statusreq>
</source>

Система выдает все заказы, в которых с момента последнего запроса в этом режиме изменилось хотя бы одно из полей:
orderno
status
delivereddate
deliveredtime
deliveredto
receiver->date
receiver->address
price

После успешной обработки ответа необходимо отметить полученные статусы успешно полученными, отправив запрос:
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<commitlaststatus>
<auth extra="8" login="login" pass="pass"></auth>
<client>CLIENT</client>
<streamid>1234</streamid>
</commitlaststatus>
</source>

'''Описание полей запроса'''

* '''auth''' — авторизация. Обязательный элемент.
* '''streamid''' — идентификатор потока. Если у вас несколько интеграций и каждая нуждается в получении статусов, вы можете передавать данный параметр и тем самым разделять получение и отметку об успешном получении статусов по заказам. Значение должно входить в промежуток от 100 до 10000, включительно. Необязательный элемент.
* '''client''' — признак клиента или агента. Необязательный элемент.
:* CLIENT — признак клиента, значение по умолчанию
:* AGENT — признак агента. В ответ отдается информация по заказам, переданным агенту на доставку

В случае успеха вы получите ответ:
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<commitlaststatus error="0">OK</commitlaststatus>
</source>

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

<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
# При этом способе передачи (<changes>ONLY_LAST</changes>) система просматривает заказы, оформленные за последние 3 месяца. Если заказ сделан ранее, изменение статуса по нему не попадет в результат выполнения запроса.
# Система всегда выдает текущий статус. Вы можете одним запросом получить статус «NEW», а следующим — «COMPLETE». Между запросами отправление могло пройти через несколько промежуточных статусов. Если нужна гарантия получения всех промежуточных статусов, нужно анализировать блок statushistory (может не заполняться вследствие ограничений версии или тарифа конкретной службы доставки).
# Система не гарантирует последовательность прохождения заказом набора статусов. Вы можете получить статус «COMPLETE», а следующим запросом «NEW» — такое может произойти, например, если оператор ошибочно отметил заказ выполненным, а затем исправил ошибку.
</div>
<br>

== Трекинг заказа по номеру ==

Запрос трекинга по номеру предназначен для выдачи минимальной обезличенной информации о конкретном заказе не авторизованному пользователю. Наша система имеет для этого интерфейс по адресу "home.courierexe.ru/{код экстра}/tracking". Вы можете либо сделать ссылку на такую страницу на своем сайте, либо разместить ее iframe'ом у себя, либо сделать свою и пользоваться нашим API. Этот интерфейс создан специально для выдачи информации живому пользователю сайта. Для получения статусов заказов в свою информационную систему нужно использовать запрос "statusreq", желательно с параметром changes=ONLY_LAST!

'''Пример запроса:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<tracking>
<extra>8</extra>
<orderno>1234</orderno>
</tracking>
</source>

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<tracking>
<order orderno="111111">
<barcode>111111</barcode>
<AWB>111111</AWB>
<sender>
<town code="1" country="RU">Москва город</town>
<date>2014-03-22</date>
<time_min>09:00</time_min>
<time_max>14:00</time_max>
</sender>
<receiver>
<town code="1" country="RU">Москва город</town>
<zipcode>125480</zipcode>
<date>2014-03-22</date>
<time_min>09:00</time_min>
<time_max>14:00</time_max>
</receiver>
<price>387.5</price>
<inshprice>387.5</inshprice>
<paytype>CASH</paytype>
<weight>5.1</weight>
<quantity>2</quantity>
<service>2</service>
<type>3</type>
<return>NO</return>
<return_service>2</return_service>
<return_date></return_date>
<return_time></return_time>
<return_message></return_message>
<waittime>12</waittime>
<enclosure>Детские игрушки</enclosure>
<instruction>Проверить при покупателе, подписать акт</instruction>
<deliveryprice total="158.6" delivery="100.00" return="58.6" />
<courier>
<code>26</code>
<name>Иванов Владимир Петрович</name>
<phone>+79161234567</phone>
</courier>
<currcoords lat="55.680327" lon="37.604456" accuracy="50" RequestDateTime="2014-04-21 18:07:45" />
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 17:22:00" createtimegmt="2016-06-03 16:14:44" message="" title="Доставлен">COMPLETE</status>
<statushistory>
<status eventstore="Офис в Москве" eventtime="2016-05-30 10:20:00" createtimegmt="2016-06-03 16:14:44" message="" title="Новый">NEW</status>
<status eventstore="Офис в Москве" eventtime="2016-06-01 17:38:00" createtimegmt="2016-06-03 16:14:44" message="филиал в Санкт-Петербурге" title="Планируется отправка">DEPARTURING</status>
<status eventstore="Офис в Москве" eventtime="2016-06-01 19:53:00" createtimegmt="2016-06-03 16:14:44" message="филиал в Санкт-Петербурге" title="Отправлено со склада">DEPARTURE</status>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 07:41:00" createtimegmt="2016-06-03 16:14:44" message="" title="Получен складом">ACCEPTED</status>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 09:17:00" createtimegmt="2016-06-03 16:14:44" message="" title="Выдан курьеру на доставку">DELIVERY</status>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 17:22:00" createtimegmt="2016-06-03 16:14:44" message="" title="Доставлен (предварительно)">COURIERDELIVERED</status>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 17:22:00" createtimegmt="2016-06-03 16:14:44" message="" title="Доставлен">COMPLETE</status>
</statushistory>
<deliveredto>Иванова, секр.</deliveredto>
<delivereddate>2016-06-02</delivereddate>
<deliveredtime>17:22</deliveredtime>
<outstrbarcode>EXT123456</outstrbarcode>
<items>
<item code="34533" extcode="abc123" quantity="1" mass="0.2" retprice="37.5" VATrate="0" barcode="2345625213125" article="1" returns="0" origincountry="040" GTD="" excise="0.00" governmentCode="11223311" suppcompany="Поставщик" suppINN="1112223334" suppphone="79161234567">Мяч</item>
<item code="34456" extcode="abc124" quantity="2" mass="2" retprice="100" VATrate="10" barcode="4645625213138" article="2" returns="0" governmentCode="">Обруч</item>
<item code="34421" extcode="abc125" quantity="3" mass="0.3" retprice="50" VATrate="18" barcode="2345625213126" article="3" returns="0" governmentCode="">Погремушка желтая</item>
</items>
</order>
</tracking>
</source>

'''Получение информации в формате 17 TRACK'''

'''Пример запроса:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<tracking17>
<extra>8</extra>
<orderno>1234</orderno>
</tracking17>
</source>

'''Пример ответа:'''
<pre>{
"number":"ExtNumber",
"oriNumber":"1234",
"oriCountry":"RU",
"destCountry":"RU",
"status":"Complete",
"events":[
{
"time":"2016-06-02 17:22:00",
"location":"RU",
"content":"Complete"
},
{
"time":"2016-06-02 17:22:00",
"location":"RU",
"content":"Courierdelivered"
},
{
"time":"2016-06-02 09:17:00",
"location":"RU",
"content":"Delivery"
},
{
"time":"2016-06-02 07:41:00",
"location":"RU",
"content":"Accepted"
},
{
"time":"2016-06-01 19:53:00",
"location":"RU",
"content":"Departure"
},
{
"time":"2016-06-01 17:38:00",
"location":"RU",
"content":"Departuring"
},
{
"time":"2016-05-30 10:20:00",
"location":"RU",
"content":"New"
}
]
}</pre>

Функция ищет последний заказ по номеру среди заказов всех клиентов. Выдает неперсонализированную информацию о текущем состоянии заказа.<br />
Описание контейнеров ответа аналогично описанию [[API#.D0.97.D0.B0.D0.BF.D1.80.D0.BE.D1.81_.D1.81.D1.82.D0.B0.D1.82.D1.83.D1.81.D0.B0_.D0.B7.D0.B0.D0.BA.D0.B0.D0.B7.D0.BE.D0.B2|Запроса статусов заказов]].

== Изменение заказа ==
Запрос предназначен для изменения заказов, по которым не было произведено изменений статуса корреспонденции, времени доставки — то есть заказов, которые ещё не в работе.

Изменять заказы могут курьерские службы с тарифами «Премиум» и «Максимум». Чтобы разрешить изменение заказов, в личном кабинете курьерской службы перейдите в '''Параметры''' > '''Расширенные''' и установите флажок '''Разрешить отмену и изменение заказов'''.

<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
'''Обратите внимание!'''
# Данные запроса изменения указываются '''полностью''', как если бы заказ создавался впервые.
# При отсутствии вложения в запросе изменения данное вложение '''не удаляется''' из заказа, но его количество становится равным 0.
# При одновременном изменении заказа в API и системе курьерской службы приоритет отдается данным системы курьерской службы. То есть изменения в API приняты не будут.
</div>

При редактировании заказа может быть отменен запланированный курьер. Это зависит от значения переменной '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Автоматически устанавливать заплан. курьера по району''':
* '''Нет''' — при редактировании заказа по АПИ курьер не изменяется;
* '''Район''' — если изменен адрес доставки, курьер сбрасывается;
* '''Район или дата план. доставки''' — если изменен адрес доставки или плановая дата вручения, курьер сбрасывается.

=== Описание полей запроса изменения ===
Все поля запроса соответствуют структуре order при создании заказа за исключением:
* вместо корневого тэга '''neworder''' указывается '''editorder''';
* тэг штрихкода '''barcode''' не указывается, поскольку присваивается при создании заказа;
* тэг курьера '''courier''' можно изменить только при включенной настройке '''Разрешить изменение курьера по АПИ''';
* для вложений '''item''' указывается внутренний код вложения в атрибуте '''code''', который можно получить при получении статуса заказа.

Значение '''orderno''' данным методом изменить нельзя.

=== Описание полей ответа изменения ===
Все поля ответа соответствуют ответу при создании заказа за исключением корневого тэга — вместо '''neworder''' возвращается '''editorder'''.

== Отмена заказа ==
Запрос предназначен для отмены заказов, по которым не было произведено изменений статуса доставки, статуса корреспонденции, времени доставки, то есть заказов, которые ещё не в работе.

Отменять заказы могут курьерские службы с тарифами «Премиум» и «Максимум». Чтобы разрешить отмену заказов, в личном кабинете курьерской службы перейдите в '''Параметры''' > '''Расширенные''' и установите флажок '''Разрешить отмену и изменение заказов'''.

При отмене заказа поле «Инфо о доставке» получает значение «Отменено заказчиком», поле «Дата доставки» — текущую дату, а «Вручил курьер» — системную запись «ОТМЕНА».

'''Пример запроса отмены заказа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<cancelorder>
<auth extra="8" login="login" pass="pass" />
<order orderno="" ordercode="123456" />
<order orderno="123aaa" ordercode="" />
</cancelorder>
</source>

'''Описание полей:'''

'''cancelorder''' — Корневой контейнер. Обязательный элемент.
* '''auth''' — Авторизация. Обязательный элемент.
* '''order''' — Контейнер отменяемого заказа. Обязательный элемент. Запрос может содержать более одного контейнера '''order'''. Атрибуты:
:* '''''orderno''''' — Шифр заказа.
:* '''''ordercode''''' — Внутренний код заказа.
Обратите внимание, что должен быть указан хотя бы один из атрибутов ''orderno'' или ''ordercode''!

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<cancelorder>
<order orderno="123test" ordercode="123456" error="0" errormsg="OK" errormsgru="Успешно" />
<order orderno="123aaa" ordercode="" error="52" errormsg="order not found" errormsgru="Заказ не найден" />
</cancelorder>
</source>

== Добавление вложений к накладной ==

'''Пример запроса:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<addattachments>
<auth extra="8" login="login" pass="pass" />
<orderno>1234567</orderno>
<attachments>
<item name="photo1.jpg">JVBERi0xLjMN1wb25lbnQgMQ
JUBQREYwMTIzNDU2Nzg5IDI NMyAwIG9iag08PA0vVHlwZSA
U3VidHlwZSAvSW1hZ2UNL1d pZHRoIDE4MDgNL0hlaWdodCA
ggNCAwIFINL0JpdHNQZXJDb 21wb25lbnQgMQ0vRGVjb2RlU
ENL0NvbHVtbnMgMTgwOA0+P g0vSW1hZ2VNYXNrIHRydWUNL
XhEZWNvZGUNPj4Nc3RyZWFt DQ</item>
<item name="photo2.jpg">VBERi0xLjMNAwIG9iag0HRoJ
JUBQREYwMTIzNDU2Nzg5IDI NMyAwIG9iag08PA0vVHlwZSA
vWE9iamVjdA0vU3VidHlwZS AvSW1hZ2UNL1dpZHRoIDEzNj
gNL0hlaWdodCAxMzMzDS9MZ W5ndGggNCAwIFINL0JpdHNQZ
XJDb21wb25lbnQgMQ0vRGVj b2RlUGFybXMgPDwNL0sgLTEN
L0NvbHVtbnMgMTM2OA0+Pg0 vSW</item>
</attachments>
</addattachments>
</source>

'''Описание полей:'''

'''addattachments''' - Корневой контейнер. Обязательный элемент.
*'''auth''' - Авторизация. Обязательный элемент.
*'''orderno''' - Номер заказа. Обязательный элемент. Может использоваться тэг <ordercode> с указанием внутреннего кода заказа.
*'''attachments''' - Обязательный элемент, в котором перечисляются передаваемые данные файлов.
**'''item''' - Бинарные данные (файл), закодированные в base64. Обязательный элемент.
***'''name''' - Атрибут элемента '''item''', в котором передается имя файла. Обязательный элемент.

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<addattachments>
<attachments>
<item name="photo1.jpg" error="0" errormsg="OK" errormsgru="Успешно" />
<item name="photo2.jpg" error="0" errormsg="OK" errormsgru="Успешно" />
</attachments>
</addattachments>
</source>

== Получение вложений к накладной ==

'''Пример запроса:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<attachments>
<auth extra="8" login="login" pass="pass" />
<orderno>1234567</orderno>
</attachments>
</source>

'''Описание полей:'''

'''attachments''' - Корневой контейнер. Обязательный элемент.
*'''auth''' - Авторизация. Обязательный элемент.
*'''orderno''' - Номер/код заказа. Обязательный элемент.

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<attachments>
<item name="doc1.docx" size="35654">JVBERi0xLjMN
JUBQREYwMTIzNDU2Nzg5IDI NMyAwIG9iag08PA0vVHlwZSA
U3VidHlwZSAvSW1hZ2UNL1d pZHRoIDE4MDgNL0hlaWdodCA
ggNCAwIFINL0JpdHNQZXJDb 21wb25lbnQgMQ0vRGVjb2RlU
ENL0NvbHVtbnMgMTgwOA0+P g0vSW1hZ2VNYXNrIHRydWUNL
XhEZWNvZGUNPj4Nc3RyZWFt DQ</item>
<item name="photo2.jpg" size="74861">VBERi0xLjMN
JUBQREYwMTIzNDU2Nzg5IDI NMyAwIG9iag08PA0vVHlwZSA
vWE9iamVjdA0vU3VidHlwZS AvSW1hZ2UNL1dpZHRoIDEzNj
gNL0hlaWdodCAxMzMzDS9MZ W5ndGggNCAwIFINL0JpdHNQZ
XJDb21wb25lbnQgMQ0vRGVj b2RlUGFybXMgPDwNL0sgLTEN
L0NvbHVtbnMgMTM2OA0+Pg0 vSW</item>
</attachments>
</source>

В тегах item возвращаются бинарные данные (файлы), закодированные в base64.

== Изменение статуса агентом ==

Запрос изменения статуса заказа позволяет установить окончательный статус заказа - "Доставлен" или "Не доставлен (Возврат/Отмена)".

Кроме этого, устанавливается дата и время (при необходимости) изменения статуса, а также сообщение в поле ''Инфо о доставке''.

При необходимости к заказу можно прикрепить изображения.

'''Пример запроса изменения статуса:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<setorderinfo>
<auth extra="8" login="login" pass="pass" />
<order ordercode="123456">
<message>Получил Иванов</message>
<outstrbarcode>7654312</outstrbarcode>
</order>
<order ordercode="234567">
<status>PICKUPREADY</status>
<eventtime>2016-05-30 10:20:00</eventtime>
<message>Клиент отказался от покупки</message>
<paytype>CASH</paytype>
<items>
<item code="34533" quantity="1" reason="0" />
<item code="34456" quantity="0" reason="0" />
<item code="34421" quantity="2" reason="0" />
</items>
<image filename="filename1.jpg"> /9j/4AAQSkZJRgA
BAQAAAQABAAD/2wBDAA0JCg sKCA0LCgsODg0PEyAVExISEy
ccHhcgLikxMC4pLSwzOko+M zZGNywtQFdBRkxOUlNSMj5aY
VpQYEpRUk//2wBDAQ4ODhMR EyYVFSZPNS01T09PT09PT09P
T09PT09PT09PT09PT09PT09 PT09PT09PT09PT09PT09PT09
PT09PT0//wAARCAYACAADAS IA</image>
</order>
</setorderinfo>
</source>

'''Описание полей запроса статуса:'''

'''setorderinfo''' - Корневой контейнер. Обязательный элемент.
*'''auth''' - Авторизация. Обязательный элемент.
*'''order''' - Контейнер заказа. Обязательный элемент. Запрос может содержать более одного контейнера '''order'''. Атрибут '''''ordercode''''' - внутренний код заказа.
*'''status''' - Новый статус заказа. Доступны статусы из раздела [[#Описание полей ответа статусов]], кроме AWAITING_SYNC и NEW.
*'''eventtime''' - Дата и время изменения статуса. Обязательно при указании статуса.
*'''message''' - Текст сообщения ''Инфо о доставке''.
*'''outstrbarcode''' - код у подрядчика (код заказа во внешней системе). Используется в интеграциях с внешними системами.
*'''paytype''' - Тип оплаты заказа. Допустимые значения CASH/CARD.
*'''items''' - Контейнер для описания вложений '''item''' . Атрибуты:
:* '''''code''''' - Код вложения.
:* '''''quantity''''' - Количество доставленных единиц вложения.
:* '''''reason''''' - Причина недоставки, выбирается из соответствующего списка статусов.
*'''image''' - Контейнер прикрепляемого изображения. Содержит текст файла изображения, закодированный по стандарту ''base64''. Контейнер '''order''' может содержать более одного контейнера '''image'''. Атрибут:
:* '''''filename''''' - Имя файла.

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<setorderinfo>
<order ordercode="123456" error="0" errormsg="OK" errormsgru="Успешно" />
<order ordercode="234567" error="59" errormsg="value [date_put] is already set" errormsgru="Значение [Дата доставки] уже указано" />
</setorderinfo>
</source>

== Получение документов для печати ==

'''Пример запроса получения печатных форм:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<waybill>
<auth extra="8" login="login" pass="pass" />
<orders>
<order orderno="1234567" ordercode="33331" />
<order orderno="1234568" ordercode="33332" />
</orders>
<form>1</form>
</waybill>
</source>

'''Описание полей:'''

'''waybill''' - Корневой контейнер. Обязательный элемент
*'''auth''' - Авторизация. Обязательный элемент
*'''orders''' - Список заказов для получения печатных форм. Содержит тэги '''order''' с атрибутами:
:* '''''orderno''''' - шифр заказа
:* '''''ordercode''''' - внутренний код заказа. Указывать необходимо один из атрибутов для всех заказов. Приоритет имеет атрибут '''''ordercode'''''
*'''form''' - Формат накладной. Не обязательный элемент. Принимает значения:
:* 1 - Подробная накладная (по-умолчанию)
:* 2 - Наклейки Zebra
:* 3 - Наклейки на страницу формата А4
:* 4 - Акты приема-передачи

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<waybill>
<content>EODIcaI8KSBlwQ 4MnEOR7Px8U8EBAyGICBnwpw
IZhQgz0ZxuPs8EBM/GcbjzB AwhBl8hwQYIO00GmEwg1CeEG
mqYTChNU0wqf8l8nz4zgc+K fCno+zwU5GjOZmzXGcbEQYIM
4zkegRE40zWzONyoNNMIOIa cWnp6aDCGEGE9NQmoQd2mg00
79U4f3hPTwnfp6Sdrafeqpa JDpFw/1aYT077VNNNdO00G3q
mqqvp9p2E7T0/wiFemv8uG6 OM</content>
</waybill>
</source>

В тэге content возвращаются бинарные данные (файл pdf), закодированные в base64.

'''Обратите внимание''', что печатные формы для заборов не формируются.

== Справочник городов ==

'''Пример запроса справочника городов:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<townlist>
<auth extra="8" />
<codesearch>
<zipcode>110000</zipcode>
<kladrcode>0100000100800</kladrcode>
<fiascode>bd21979d-46f8-49d0-9105-e8d65172a983</fiascode>
<code>123</code>
</codesearch>
<conditions>
<city>Краснодарский край</city>
<namecontains>новгород</namecontains>
<namestarts>Моск</namestarts>
<name>Москва</name>
<fullname>Москва город</fullname>
<country>1</country>
</conditions>
<limit>
<limitfrom>30</limitfrom>
<limitcount>10</limitcount>
<countall>YES</countall>
</limit>
</townlist>
</source>

Внутри контейнера townlist все элементы могут как отсутствовать, так и комбинироваться. Поиск не чувствителен к регистру.

*'''auth''' - Авторизация, необязательный элемент. Используется в случае включенного и настроенного ограничения по населенным пунктам в конкретной курьерской службе.

*'''codesearch''' - Поиск по кодам. В случае использования - контейнеры conditions и limit игнорируются.
:* '''zipcode''' - Поиск по индексу. Обратите внимание на то, что один почтовый индекс может распространяться на несколько населенных пунктов. В этом случае система вернет несколько записей.
:* '''kladrcode''' - Поиск по 13-ти значному коду КЛАДР.
:* '''fiascode''' - Поиск по коду ФИАС (AOGUID).
:* '''code''' - Поиск по коду в системе.

*'''conditions''' - Задает условия поиска. Все вложенные элементы одновременно накладывают условие "И".
:* '''city''' - Поиск по всем населенным пунктам региона.
:* '''namecontains''' - Поиск населенных пунктов, название которых содержит указанный текст.
:* '''namestarts''' - Поиск населенных пунктов, название которых начинается с указанного текста.
:* '''name''' - Поиск населенных пунктов, название которых соответствует указанному тексту.
:* '''fullname''' - Поиск населенных пунктов, название вместе с типом населенного пункта которых соответствует указанному тексту.
:* '''country''' - Поиск только по стране с указанным внутренним кодом или текстовым кодом в соответствии [https://ru.wikipedia.org/wiki/ISO_3166-1 стандартом ISO_3166-1], например, "RU", "RUS" для России.

*'''limit''' - Ограничивает вывод результата.
:* '''limitfrom''' - Задает номер записи результата, начиная с которой выдавать ответ. По-умолчанию - 0.
:* '''limitcount'''- Задает количество записей результата, которые нужно вернуть. По-умолчанию - 10000.
:* '''countall''' - YES указывает на необходимость подсчета общего количества найденных совпадений. Это может замедлять выполнение запроса. Если отключено - в ответе не указываются totalcount и totalpages.

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<townlist count="3" page="1" totalcount="3" totalpages="1">
<town>
<code>26379</code>
<city>
<code>23</code>
<name>Краснодарский край</name>
</city>
<name>Сочи город</name>
<fiascode>79da737a-603b-4c19-9b54-9114c96fb912</fiascode>
<kladrcode>2300000700000</kladrcode>
<shortname /> (not yet supported)
<typename /> (not yet supported)
<coords lat="43.5855" lon="39.7231" />
</town>
<town>
<code>40331</code>
<city>
<code>32</code>
<name>Брянская область</name>
</city>
<name>Сочилов хутор</name>
<fiascode>c9c96c67-2cc9-4f10-afde-fd32417ea216</fiascode>
<kladrcode>3201900011100</kladrcode>
<shortname />
<typename />
<coords lat="52.6407" lon="33.1724" />
</town>
<town>
<code>114016</code>
<city>
<code>60</code>
<name>Псковская область</name>
</city>
<name>Сочихино деревня</name>
<fiascode>10df7588-19c1-49d1-a387-9de1cf3eb26f</fiascode>
<kladrcode>6001900015400</kladrcode>
<shortname />
<typename />
<coords lat="56.6003" lon="29.3542" />
</town>
</townlist>
</source>

В ответе города сортируются по популярности, важности (районные центры и т.д.), и только затем - по алфавиту.

== Справочник регионов ==

'''Пример запроса справочника:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<regionlist>
<codesearch>
<code>77</code>
</codesearch>
<conditions>
<namecontains>край</namecontains>
<namestarts>Моск</namestarts>
<fullname>Московская область</fullname>
<country>RU</country>
</conditions>
</regionlist>
</source>

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<regionlist count="2">
<city>
<code>80</code>
<country>
<code>1</code>
<name>Россия</name>
<id>643</id>
<ShortName1>RU</ShortName1>
<ShortName2>RUS</ShortName2>
</country>
<name>Агинский Бурятский автономный округ</name>
</city>
<city>
<code>1</code>
<country>
<code>1</code>
<name>Россия</name>
<id>643</id>
<ShortName1>RU</ShortName1>
<ShortName2>RUS</ShortName2>
</country>
<name>Адыгея республика</name>
</city>
</regionlist>
</source>

== Справочник улиц ==

'''Пример запроса справочника улиц:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<streetlist>
<conditions>
<town>Москва город</town> // ОБЯЗАТЕЛЬНОЕ ПОЛЕ!
<namecontains>Хохло</namecontains>
<namestarts>Академика Х</namestarts>
<name>Академика Хохлова</name>
<fullname>Академика Хохлова ул.</fullname>
</conditions>
<limit>
<limitfrom>30</limitfrom>
<limitcount>10</limitcount>
<countall>YES</countall>
</limit>
</streetlist>
</source>

*'''conditions''' - Задает условия поиска. Все вложенные элементы одновременно накладывают условие "И".
:* '''town''' - Обязательное поле. Название или код населенного пункта.
:* '''namecontains''' - Поиск улиц, название которых содержит указанный текст.
:* '''namestarts''' - Поиск улиц, название которых начинается с указанного текста.
:* '''name''' - Поиск улиц, название которых соответствует указанному тексту.
:* '''fullname''' - Поиск улиц, для которых название вместе с типом соответствует указанному тексту.

*'''limit''' - Ограничивает вывод результата.
:* '''limitfrom''' - Задает номер записи результата, начиная с которой выдавать ответ. По-умолчанию - 0.
:* '''limitcount'''- Задает количество записей результата, которые нужно вернуть. По-умолчанию - 10000.
:* '''countall''' - YES указывает на необходимость подсчета общего количества найденных совпадений. Это может замедлять выполнение запроса. Если отключено, в ответе не указываются totalcount и totalpages.

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<streetlist count="1" page="1" totalcount="3" totalpages="1">
<street>
<code>124</code>
<name>Академика Хохлова ул.</name>
<shortname>Академика Хохлова</shortname>
<typename>ул.</typename>
</street>
</streetlist>
</source>

В ответе улицы сортируются по алфавиту.

== Справочник номенклатуры ==

'''Пример запроса справочника номенклатуры:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<itemlist>
<auth extra="8" login="login" pass="pass"></auth>
<codesearch>
<code>123456</code>
<article>FD343</article>
<barcode>2345625213125</barcode>
</codesearch>
<conditions>
<namecontains>телевизор</namecontains>
<namestarts>sony</namestarts>
<name>Sony KDL-55W905 ЖК-телевизор</name>
<quantity>EXISTING_ONLY</quantity>
<store>2</store>
</conditions>
<except>
<code>123478</code>
</except>
<limit>
<limitfrom>30</limitfrom>
<limitcount>10</limitcount>
<countall>YES</countall>
</limit>
</itemlist>
</source>

Внутри контейнера itemlist все элементы могут как отсутствовать, так и комбинироваться. Поиск не чувствителен к регистру.
*'''codesearch''' - Поиск по кодам. В случае использования - контейнеры conditions и limit игнорируются.
:* '''code''' - Поиск по внутреннему коду системы.
:* '''article''' - Поиск по артикулу.
:* '''barcode''' - Поиск по штрих-коду.

*'''conditions''' - Задает условия поиска. Все вложенные элементы одновременно накладывают условие "И".
:* '''namecontains''' - Поиск товаров, название которых содержит указанный текст.
:* '''namestarts''' - Поиск товаров, название которых начинается с указанного текста.
:* '''name''' - Поиск товаров, название которых соответствует указанному тексту.
:* '''quantity''' - Наличие на складе. Принимает значения EXISTING_ONLY - Только в наличии, NOT_EXISTING_ONLY - Только не в наличии, ALL - Все. ''Это поле может быть недоступным в некоторых установках.''
:* '''store''' - Поиск товаров по определенному складу.

*'''except''' - Описание исключений для корректного определения количества зарезервированной номенклатуры.
:* '''code''' - Код заказа.

*'''limit''' - Ограничивает вывод результата.
:* '''limitfrom''' - Задает номер записи результата, начиная с которой выдавать ответ.
:* '''limitcount''' - Задает количество записей результата, которые нужно вернуть.

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<itemlist count="3" totalcount="3" page="1" totalpages="1">
<item>
<code>123456</code>
<article>FD343</article>
<barcode>2345625213125</barcode>
<name>Sony KDL-55W905 ЖК-телевизор</name>
<retprice>65000</retprice>
<purchprice>50000</purchprice>
<weight>5.1</weight>
<length>50</length>
<width>30</width>
<height>40</height>
<VATrate>20</VATrate>
<CountInPallet>30</CountInPallet>
<CountInBox>2</CountInBox>
<HasSerials>1</HasSerials>
<CountryOfOrigin>Малайзия</CountryOfOrigin> (not yet supported)
<Message>Хороший телевизор</Message>
<Message2>Снова хороший телевизор</Message2>
<quantity>12</quantity>
<reserved>3</reserved>
<item>
...
</itemlist>
</source>

'''Описание полей:'''
*'''code''' - Внутренний идентификатор, присвоенный системой.
*'''article''' - Артикул, назначенный клиентом (поставщиком).
*'''barcode''' - Штрих-код производителя.
*'''name''' - Наименование.
*'''retprice''' - Розничная цена по-умолчанию. При оформлении заказа цена используется та, которая указана в заказе.
*'''purchprice''' - Закупочная цена.
*'''weight''' - Масса в килограммах.
*'''length''' - Длина в сантиметрах.
*'''width''' - Ширина в сантиметрах.
*'''height''' - Высота в сантиметрах.
*'''VATrate''' - Ставка НДС, целое число процентов.
*'''CountInPallet''' - Количество штук в паллете.
*'''CountInBox''' - Количество штук в упаковке.
*'''HasSerials''' - Требует учета серийных номеров. Принимает значения 1 - да, 0 - нет.
*'''CountryOfOrigin''' - Наименование страны происхождения на русском языке.
*'''Message''' - Комментарий.
*'''Message2''' - Дополнительный комментарий.
*'''quantity''' - Количество на складе. Товары, уже собранные в заказы в этом количестве не присутствуют, считаются покинувшими товарный склад. ''Это поле может быть недоступным в некоторых установках.''
*'''reserved''' - Количество зарезервированного товара. Может превышать остаток на складе, если покупатели ждут следующей поставки. ''Это поле может быть недоступным в некоторых установках.''

== Движение номенклатуры ==

'''Пример запроса движения номенклатуры:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<itemmovements>
<auth extra="8" login="login" pass="pass"></auth>
<code>4259</code>
<datefrom>2020-10-01</datefrom>
<dateto>2020-10-02</dateto>
</itemmovements>
</source>

*'''code''' - внутренний код товара в справочнике номенклатуры.
*'''datefrom''' - дата начала периода.
*'''dateto''' - дата окончания периода.
Может быть указан или код, или период, или код и период одновременно.

'''Пример ответа движения номенклатуры:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<itemmovements count="16">
<itemmovement>
<code>151500</code>
<date>2017-05-26</date>
<retprice>0</retprice>
<quantity>1</quantity>
<delivered>0</delivered>
<item>
<code>4259</code>
<name>Настольная игра Дженга</name>
</item>
<status>
<code>5</code>
<name>Возврат от покупателя</name>
</status>
<store>
<code>1</code>
<name>офис в Москве</name>
</store>
<order>
<ordercode>3374830</ordercode>
<number>123660-0</number>
<date>2017-05-24</date>
<orderno>14123</orderno>
<barcode>0000000670</barcode>
<company>ТОВАР</company>
<address>Кравченко ул., 1</address>
<delivereddate>2017-05-29</delivereddate>
<deliveredtime>12:00:00</deliveredtime>
<deliveredto />
</order>
<document>
<code>21991</code>
<number>318</number>
<date>2017-05-26</date>
<message></message>
</document>
</itemmovements>
</itemlist>
</source>

''' Описание полей ответа '''
*'''code''' - внутренний код операции движения
*'''date''' - дата операции
*'''retprice''' - цена товара
*'''quantity''' - количество товара операции
*'''delivered''' - количество доставленного товара

*'''item''' - контейнер товара
:* '''code''' - внутренний код товара
:* '''name''' - наименование товара

*'''status''' - контейнер статуса операции
:* '''code''' - код статуса
:* '''name''' - наименование

*'''store''' - контейнер филиала, к которому относится операция
:* '''code''' - код филиала
:* '''name''' - наименование филиала

*'''order''' - контейнер корреспонденции
:* '''ordercode''' - внутренний код заказа
:* '''number''' - номер заказа
:* '''date''' - дата заказа
:* '''orderno''' - шифр
:* '''barcode''' - штрих-код
:* '''company''' - компания
:* '''address''' - адрес
:* '''delivereddate''' - дата вручения
:* '''deliveredtime''' - время вручения
:* '''deliveredto''' - данные о вручении, либо причина недоставки

*'''document''' - контейнер документа операции
:* '''code''' - внутренний код документа
:* '''number''' - номер документа
:* '''extnumber''' - внешний номер документа
:* '''date''' - дата документа
:* '''message''' - комментарий

== Получение справочника тарифов по городам ==
<br />
<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
'''Обратите внимание!'''
Если в запросе отсутствует параметр nofederal, то Москва будет обрабатываться иначе, чем остальные города. В ответе будут города Москвы и МО, с добавленной ценой за километраж
</div>
<br />

'''Пример запроса справочника тарифов по городам'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<tariffs>
<auth extra="8" login="login" pass="pass" />
<townfrom>Москва</townfrom>
<service>1</service>
<mainonly>1</mainonly>
<nofederal>1</nofederal>
</tariffs>
</source>

*'''auth''' — атрибут '''extra''' обязателен, по нему определяется курьерская служба.
*'''townfrom''' — город-отправитель. Если не передан, то городом будет «Москва».
*'''service''' — режим доставки. Обязательный элемент.
*'''mainonly''' — необязательный элемент. Если передан, то в ответе будут данные только по городам из справочника '''Межгород''' > '''Зоны'''.
*'''nofederal''' — необязательный элемент. Если передан, то в ответе город федерального значения Москва будет обрабатываться как обычный город.

'''Пример ответа справочника тарифов по городам'''
<source lang="json">
{
"townfrom": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
"service": 1,
"tariffs": [
{
"towntofias": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
"towntocode": 1,
"towntoname": "Москва город",
"distance": 0,
"pricedistance": 0,
"pricesnew": {
"before": [
{
"price": 100,
"every": 0,
"mass": 1
},
{
"price": 150,
"every": 0,
"mass": 5
}
],
"after": [
{
"price": 0,
"every": 1,
"mass": 38.01
},
{
"price": 15,
"every": 1,
"mass": 51.01
}
]
},
"deliveryPeriodMin": 1,
"deliveryPeriodMax": 2
}
]
}
</source>

''' Описание полей ответа '''
* '''townfrom''' — код ФИАС города-отправителя.
* '''service''' — режим доставки.
*'''tariffs''' — cписок тарифов по городу.
:* '''towntofias''' — код ФИАС города-получателя.
:* '''towntocode''' — внутренний код города-получателя.
:* '''towntoname''' — наименование города-получателя.
:* '''distance''' — дистанция в км до города от МКАД, если в запросе townfrom - Москва.
:* '''pricedistance''' — сумма за километраж до города от МКАД, если в запросе townfrom - Москва.
:* '''pricesnew''' — ваши настройки тарифов из справочника '''Межгород''' > '''Тарифы по зонам'''.
::* '''before/after''' — контейнеры ДО/ОТ.
:::* '''price''' — цена. Если ответ идет по "before", то в цену также плюсуется сумма pricedistance
:::* '''every''' — за каждые.
:::* '''mass''' — масса.
:* '''prices''' — устаревший элемент, не используется.
:* '''deliveryPeriodMin''' — минимальный срок доставки.
:* '''deliveryPeriodMax''' — максимальный срок доставки.

== Номенклатура приходной накладной ==

'''Пример запроса номенклатуры приходной накладной:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<itemdoc>
<auth extra="8" login="login" pass="pass"></auth>
<code>21991</code>
</itemdoc>
</source>

*'''code''' - внутренний код документа приходной накладной (см. предыдущий запрос).

'''Пример ответа движения номенклатуры:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<itemdoc>
<code>21991</code>
<number>318</number>
<date>2017-05-26</date>
<message></message>
<items>
<item code="4259" quantity="1" barcode="200300" article="123555">Настольная игра Дженга</item>
</items>
</itemdoc>
</source>

''' Описание полей ответа '''
* '''code''' - внутренний код приходной накладной
* '''number''' - номер документа
* '''date''' - дата документа
* '''message''' - комментарий

*'''item''' - контейнер товара
:* '''code''' - внутренний код товара
:* '''barcode''' - штрих-код товара
:* '''article''' - артикул товара
:* '''quantity''' - количество поступившего товара

== Справочник филиалов ==

'''Пример запроса списка филиалов:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<storelist>
<auth extra="8"></auth>
<json>YES</json>
<client_code>7890</client_code>
</storelist>
</source>

*'''auth''' - Атрибут '''extra''' - обязателен, по нему определяется курьерская служба
*'''json''' - Признак вывода ответа в виде JSON YES/NO
*'''client_code''' - Код клиента курьерской службы

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<storelist count="2">
<store>
<code>123</code>
<name>ABC</name>
</store>
<store>
<code>456</code>
<name>Филиал 2</name>
</store>
</storelist>
</source>

*'''code''' - Код филиала.
*'''name''' - Наименование филиала.

== Справочник пунктов самовывоза ==

Для отображения списка пунктов выдачи (ПВЗ) есть '''готовый JavaScript модуль''': https://home.courierexe.ru/js/measoft_map.js Инструкция по использованию - внутри. Посмотреть пример работы можно [https://home.courierexe.ru/pvz_test.html Здесь]

Уникальные запросы списка ПВЗ кешируются на стороне личного кабинета и хранятся до 7 часов утра по московскому времени следующего дня. Например, если уникальный запрос с массой 2 кг был отправлен сегодня в 10 часов, то завтра в 7 утра он сбросится. Если сегодня в 18 часов в этом же запросе вы укажете массу 2 кг, в ответе вернется тот же список ПВЗ. Если передадите массу 3 кг, список может быть другим.

'''Пример запроса пунктов самовывоза:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<pvzlist>
<auth extra="8" login="login" pass="pass"></auth>
<code>1234</code>
<client_code>7890</client_code>
<city>Свердловская область</city>
<town regioncode="66" country="RU">Нижний Тагил</town>
<parentcode>6</parentcode>
<acceptcash>YES</acceptcash>
<acceptcard>YES</acceptcard>
<acceptfitting>YES</acceptfitting>
<maxweight>30</maxweight>
<acceptindividuals>YES</acceptindividuals>
<lt>57.924737</lt>
<lg>59.940019</lg>
<rt>57.905682</rt>
<rg>59.984669</rg>
<json>YES</json>
<limit>
<limitfrom>30</limitfrom>
<limitcount>2</limitcount>
<countall>YES</countall>
</limit>
</pvzlist>
</source>

*'''auth''' - Атрибут '''extra''' - обязателен, по нему определяется курьерская служба, '''login''' и '''pass''' позволяют авторизоваться под клиентом: для отдельного клиента могут быть ограничения по доступности некоторых ПВЗ, и в этом случае они будут учтены.
*'''code''' - Внутренний код.
*'''client_code''' - Код клиента курьерской службы.
*'''city''' - Регион получателя. Можно указать код региона или полное наименование региона из [[#Справочник регионов|справочника регионов]].
*'''town''' - Город получателя.
Для тега города '''town''' можно указать код региона в атрибуте '''''regioncode''''' из [[#Справочник регионов|справочника регионов]]. Поиск будет производиться в указанном регионе.

Также можно указать страну получателя в атрибуте '''''country''''' в соответствии с [https://ru.wikipedia.org/wiki/ISO_3166-1 стандартом ISO_3166-1], например, "RU", "RUS" или "643" для России.

*'''parentcode''' - Фильтр по родительскому [[#Справочник филиалов|филиалу]]
*'''acceptcash''' - Фильтр по приему наличных YES/NO
*'''acceptcard''' - Фильтр по приему банковских карт YES/NO
*'''acceptfitting''' - Фильтр по наличию примерки YES/NO
*'''maxweight''' - Фильтр по максимальному весу, с которым работает ПВЗ
*'''acceptindividuals''' - Фильтр по доступности физическим лицам YES/NO
*'''lt''' - Широта левого верхнего угла
*'''lg''' - Долгота левого верхнего угла
*'''rt''' - Широта правого нижнего угла
*'''rg''' - Долгота правого нижнего угла
*'''json''' - Признак вывода ответа в виде JSON YES/NO
*'''limit''' - Ограничивает вывод результата.
:* '''limitfrom''' - Задает номер записи результата, начиная с которой выдавать ответ. По-умолчанию - 0.
:* '''limitcount'''- Задает количество записей результата, которые нужно вернуть. По-умолчанию - 100.
:* '''countall''' - YES указывает на необходимость подсчета общего количества найденных совпадений. Это может замедлять выполнение запроса. Если отключено - в ответе не указываeтся totalcount.

'''Пример ответа справочника пунктов самовывоза:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<pvzlist count="2" totalcount="40465">
<pvz>
<code>126</code>
<clientcode>3</clientcode>
<name>Нижний Тагил</name>
<parentcode>6</parentcode>
<parentname>Интеграция</parentname>
<town code="124267" regioncode="66" regionname="Свердловская область">Нижний Тагил город</town>
<address>622036, г. Нижний Тагил, ул. Циолковского, д. 17</address>
<phone>+73435417709, +73435254989</phone>
<comment>Новый пункт доставки</comment>
<worktime>Вс 10:00-16:00, Сб 10:00-16:00, Пн-Пт 10:00-20:00</worktime>
<traveldescription>Жилое 5-ти этажное здание, торцом к дороге, второе здание от перекрестка Пархоменко-Циолковского</traveldescription>
<maxweight>10</maxweight>
<acceptcash>YES</acceptcash>
<acceptcard>YES</acceptcard>
<acceptfitting>YES</acceptfitting>
<acceptindividuals>YES</acceptindividuals>
<latitude>57.93457</latitude>
<longitude>59.95131</longitude>
<uid>40606d00-9c51-11eb-b2c9-cfd6c1111392</uid>
</pvz>
<pvz>
<code>245</code>
<clientcode>NTG1</clientcode>
<name>На Красноармейской</name>
<parentcode>6</parentcode>
<parentname>Интеграция</parentname>
<town code="124267" regioncode="66" regionname="Свердловская область">Нижний Тагил город</town>
<address>КРАСНОАРМЕЙСКАЯ, д.79</address>
<phone>+7(3435)379-044</phone>
<comment>Возможность примерки отсутствует</comment>
<worktime>Вс 10:00-16:00, Сб 10:00-16:00, Пн-Пт 10:00-20:00</worktime>
<traveldescription>Напротив ТЦ Пирамида</traveldescription>
<maxweight>20</maxweight>
<acceptcash>YES</acceptcash>
<acceptcard>YES</acceptcard>
<acceptfitting>NO</acceptfitting>
<acceptindividuals>YES</acceptindividuals>
<latitude>57.93468</latitude>
<longitude>60.55476</longitude>
<uid>41116853-9c51-11eb-b2c9-cfd6c1451392</uid>
</pvz>
</pvzlist>
</source>

*'''code''' - Код ПВЗ в системе. Используется в запросе [[API#Оформление заказа|оформления заказов]]
*'''clientcode''' - Код ПВЗ используемый компанией-подрядчиком.
*'''name''' - Наименование ПВЗ.
*'''parentcode''' - Код родительского элемента.
*'''parentname''' - Наименование родительского элемента.
*'''town''' - Населенный пункт с кодом из [[#Справочник городов|справочника городов]], а также с кодом и наименованием региона.
*'''address''' - Адрес ПВЗ.
*'''phone''' - Телефоны ПВЗ.
*'''comment''' - Дополнительная информация.
*'''worktime''' - Режим работы ПВЗ.
*'''traveldescription''' - Описание местонахождения ПВЗ или пути к нему.
*'''maxweight''' - Максимальный вес, с которым работает ПВЗ.
*'''acceptcash''' - Признак приема наличных
*'''acceptcard''' - Признак приема банковских карт
*'''acceptfitting''' - Наличие примерки
*'''latitude''' - Широта
*'''longitude''' - Долгота
*'''uid''' - Уникальный идентификатор ПВЗ в системе Measoft
*'''count''' - Количество записей в ответе
*'''totalcount''' - Общее количество записей, отвечающее параметрам запроса

== Получение фискальных данных заказа ==

'''Пример запроса получения фискальных данных:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<receiptdata>
<auth extra="8" login="login" pass="pass" />
<orders>
<order orderno="123456" />
<order orderno="890111C" />
</orders>
</receiptdata>

</source>

'''Пример ответа получения фискальных данных:'''
<source lang="xml">

<?xml version="1.0" encoding="UTF-8"?>
<receipts count="1">
<receipt>
<orderno>123456</orderno>
<fdDatetime>2020-06-07 12:14:00</fdDatetime>
<fdValue>123</fdValue>
<fdNum>456</fdNum>
<fnSn>789</fnSn>
<kktNum>100</kktNum>
<inn>222</inn>
<ofdUrl>gate.ofd.ru</ofdUrl>
<fullUrl>https://check.ofd.ru/123</fullUrl>
<price>12345</price>
<lines count="1">
<line>
<item>1111764</item>
<name>Сапоги</name>
<qty>1</qty>
<price>1000</price>
<vatRate>20</vatRate>
<governmentCode>Z16513LK2</governmentCode>
<itemType>1</itemType>
</line>
</lines>
</receipt>
</receipts>
</source>

Параметры ответа:
*'''orderno''' - Номер заказа
*'''fdDatetime''' - Дата и время пробития фискального чека
*'''fdValue''' - ФПД (фискальный признак документа)
*'''fdNum''' - ФИСКАЛЬНЫЙ ДОКУМЕНТ (фискальный номер чека)
*'''fnSn''' - ФН (номер фискального накопителя)
*'''kktNum''' - РН (регистрационный номер кассы)
*'''inn''' - ИНН
*'''ofdUrl''' - URL адрес (доменное имя) ОФД
*'''price''' - Сумма чека
*'''fullUrl''' - URL чека для просмотра онлайн
*'''lines''' - Позиции чека
:*'''item''' - код товара
:*'''name''' - наименование товара
:*'''qty''' - количество товара
:*'''price''' - цена товара
:*'''governmentCode''' - считанная последовательность, которая в дальнейшем преобразуется по алгоритму тега 1162
:*'''vatRate''' - НДС товара
:*'''itemType''' - тип товара (товар, доставка и т.д.)

== Справочник Виды срочности ==

'''Пример запроса видов срочности:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<services>
<auth extra="8"/>
</services>
</source>

'''Пример ответа справочника видов срочности:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<services count="2">
<service>
<code>1</code>
<name>Эконом</name>
</service>
<service>
<code>2</code>
<name>Срочно</name>
</service>
</services>
</source>

== Справочник дополнительных услуг ==

'''Пример запроса дополнительных услуг:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<advprices>
<auth extra="8" login="login" pass="pass" />
<visible>NO</visible>
</advprices>
</source>

'''advprices''' - Корневой контейнер. Обязательный элемент.
*'''visible''' - Признак возврата '''только''' тех услуг, что доступны для отображения в ЛК YES/NO. Необязательный элемент. По-умолчанию NO

'''Пример ответа справочника дополнительных услуг:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<advprices>
<advprice>
<code>1</code>
<name>Этажей в доме</name>
<type>int</type>
</advprice>
<advprice>
<code>2</code>
<name>Коэффициент надбавки</name>
<type>float</type>
</advprice>
<advprice>
<code>3</code>
<name>Расписаться на упаковке</name>
<type>bool</type>
</advprice>
</advprices>
</source>

Параметры:
*'''code''' - внутренний код услуги
*'''name''' - наименование услуги. Если поле "название в ЛК" в настройках услуги не пусто, то возвращает значение поля "название в ЛК".
*'''hine''' - подсказка по доп услуге для пользователя
*'''type''' - тип услуги. Может иметь значения:
:*'''bool''' - для услуг вида "чекбокс", "Да"
:*'''float''' - для числа с плавающей точкой
:*'''int''' - для целого числа

== Расчет стоимости доставки ==

'''Пример запроса стоимости доставки:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<calculator>
<auth extra="8" login="login" pass="pass" />
<order>
<pricetype>CUSTOMER</pricetype>
<sender>
<town>Санкт-Петербург</town>
<address>Петровка 38 офис 35</address>
<coords lat="55.680327" lon="37.604456"></coords>
</sender>
<receiver>
<zipcode>125480</zipcode>
<town regioncode="78" country="RU">Санкт-Петербург</town>
<address>Петровка 38 офис 35</address>
<pvz>124</pvz>
<coords lat="55.680327" lon="37.604456"></coords>
</receiver>
<weight>5.1</weight>
<service>2</service>
<paytype>CASH</paytype>
<price>387.5</price>
<deliveryprice>150</deliveryprice>
<inshprice>387.5</inshprice>
<packages>
<package mass="1" quantity="5"></package>
<package mass="2.5" length="10" width="20" height="30"></package>
</packages>
<userid>user123</userid>
<groupid>customer</groupid>
</order>
</calculator>
</source>

Параметры:
Структура данных и заполнение полей аналогичны и совместимы с [[#Оформление заказа]].

Дополнительные поля:
*'''pricetype''' - тип требуемой цены. Возможные значения: "CUSTOMER" (по-умолчанию) - [[Личный кабинет клиента#Цена доставки для получателя|цена для конечного получателя]], "CLIENT" - цена курьерской службы для клиента.
*'''userid''' - Идентификатор пользователя, строковый или числовой тип. Виртуальное поле. Необязательное. Данное поле используется совместно с настройками "Цена доставки для получателя", определяя приоритет правила. Можно использовать в различных CMS/CRM системах, настраивая цены для определенного покупателя.
*'''groupid''' - Идентификатор группы пользователя, строковый или числовой тип. Виртуальное поле. Необязательное. Данное поле используется совместно с настройками "Цена доставки для получателя", определяя приоритет правила. Можно использовать в различных CMS/CRM системах, настраивая цены для определенной группы покупателей.

Суммы НП и ОЦ, а также тип оплаты CARD имеют значение при настроенных в тарифе на вкладке Прочее долях (в процентах) от данных сумм.

В авторизации можно опустить параметры login и pass, тогда расчет будет производиться по стандартному тарифу курьерской службы, без учета возможных отличий для конкретного клиента.<br>
Объемный вес будет учитываться только при условии указания всех габаритов: длины, ширины и высоты.<br>
В полях город-отправитель и город-получатель можно указывать название города (не рекомендуется!), либо код города из нашего справочника, либо 13-ти значный код КЛАДР, либо 36-ти значный код адресной системы ФИАС (AOID).

'''Пример ответа стоимости доставки:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<calculator>
<calc>
<townfrom code="1">Москва город</townfrom>
<townto code="56603">Иркутск город</townto>
<mass>3.7</mass>
<service name="Экспресс">1</service>
<zone>2</zone>
<price>1113</price>
<mindeliverydays>1</mindeliverydays>
<maxdeliverydays>3</maxdeliverydays>
<mindeliverydate>2020-05-13</mindeliverydate>
<deliveryprice>
<advprice code="1" price="1000">База</advprice>
<advprice code="4" price="100">Процент от суммы руб</advprice>
<advprice code="5" price="63">Процент от объявленной стоимости</advprice>
<advprice code="6" price="-50">Скидка при доставке</advprice>
</deliveryprice>
</calc>
</calculator>
</source>

Параметры:
*'''townfrom''' - Город-отправитель так, как система его распознала и привязала к справочнику. Атрибут '''code''' - код из справочника городов системы.
*'''townto''' - Город-получатель так, как система его распознала и привязала к справочнику. Атрибут '''code''' - код из справочника городов системы.
*'''mass''' - Масса в килограммах
*'''service''' - Режим доставки - число, указывающее на запись в справочнике видов срочности (см описание на этой странице).
*'''zone''' - номер тарифной зоны, по которой рассчиталась стоимость. В зависимости от зоны выбирается тарифная сетка. Так же к цене могут применяться повышающие или понижающие коэффициенты при доставке не из/в региональный центр.
*'''price''' - рассчитанная стоимость доставки в валюте прайс-листа курьерской службы. Рекомендуется к использованию в отличие от одноименного атрибута родительского контейнера.
*'''maxdeliverydays''' - максимальный срок доставки в рабочих днях.
*'''mindeliverydate''' - минимальная дата доставки в учетом выходных дней.
*'''deliveryprice''' - Данные по составляющим ценам доставки

'''''Обратите внимание:''''' В реальном ответе сервера в теге calc присутствует атрибут "price". Он оставлен для обратной совместимости, не используйте его. Пользуйтесь вложенным тегом price.

== Получение информации о клиенте ==

'''Пример запроса получения информации о клиенте:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<client>
<auth extra="8" login="login" pass="pass" />
</client>
</source>

'''client''' - Корневой контейнер. Обязательный элемент.
*'''auth''' - Авторизация. Обязательный элемент.

'''Пример ответа на запрос получения информации о клиенте:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<client>
<code>1082</code>
</client>
</source>

*'''code''' - Код клиента

== Список актов передачи денег ==

'''Пример запроса списка актов передачи денег:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<smalist>
<auth extra="8" login="login" pass="pass" />
<datefrom>2016-02-10</datefrom>
<dateto>2016-03-10</dateto>
</smalist>
</source>

'''smalist''' - Корневой контейнер. Обязательный элемент.
*'''auth''' - Авторизация. Обязательный элемент.
*'''datefrom''' - Дата "с". Необязательный элемент.
*'''dateto''' - Дата "по". Необязательный элемент.
Если интервал дат не указан, то возвращаются акты передачи денег за последний месяц.

'''Пример ответа на запрос списка актов передачи денег:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<smalist count="1">
<sma>
<code>6278</code>
<number>3992</number>
<actdate>2016-02-12</actdate>
<datepay></datepay>
<dateto>2016-02-12</dateto>
<promiseddatepay></promiseddatepay>
<price>637.00</price>
<pricecorr>113.00</pricecorr>
<rur>13430.00</rur>
<pricekur>570.00</pricekur>
<priceag>67.00</priceag>
<payno>42423</payno>
<paytype>1</paytype>
<paytypename>Безнал</paytypename>
<signedcopyreceived>NO</signedcopyreceived>
</sma>
</smalist>
</source>

*'''code''' - Код акта
*'''number''' - Номер акта в системе
*'''actdate''' - Дата акта
*'''datepay''' - Дата оплаты по акту
*'''dateto''' - Дата конечного периода для формирования АПД
*'''promiseddatepay''' - Плановая дата оплаты
*'''price''' - Стоимость услуг
*'''pricecorr''' - Сумма корректировки
*'''rur''' - Сумма заказа
*'''pricekur''' - Стоимость курьерской доставки
*'''priceag''' - Агентское вознаграждение
*'''payno''' - Номер платежного поручения
*'''paytype''' - Тип оплаты: 1 - безнал, 2 - наличными курьером, 3 - наличными в офисе, 4 - перевод на карту
*'''paytypename''' - Строковое представление типа оплаты
*'''signedcopyreceived''' - Признак факта возврата акта YES/NO

== Детализация актов передачи денег ==

'''Пример запроса детализации актов передачи денег:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<smadetail>
<auth extra="8" login="login" pass="pass" />
<code>6278</code>
</smadetail>
</source>

'''smadetail''' - Корневой контейнер. Обязательный элемент.
*'''auth''' - Авторизация. Обязательный элемент.
*'''code''' - Код акта передачи денег (см. запрос списка АПД). Обязательный элемент.

'''Пример ответа на запрос детализации актов передачи денег:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<smadetail count="2">
<specialsma>
<code>42494</code>
<ordercode>14424</ordercode>
<orderno>11111</orderno>
<orderdate>2018-01-01</orderdate>
<delivereddate>2018-10-01</delivereddate>
<company>Компания</company>
<price>314.00</price>
<rur>8800.00</rur>
<inshprice>314.00</inshprice>
<pricekur>270.00</pricekur>
<priceag>44.00</priceag>
<pricecalc>8486.00</pricecalc>
<paytype>2</paytype>
<paytypename>наличными курьером</paytypename>
<weight>0.400</weight>
<distance>0.0</distance>
<status>Доставлено</status>
</specialsma>
</smadetail>
</source>

*'''code''' - Код записи.
*'''ordercode''' - Код заказа.
*'''orderno''' - Шифр заказа.
*'''orderdate''' - Дата заказа.
*'''delivereddate''' - Дата доставки.
*'''company''' - Получатель.
*'''price''' - Стоимость услуг.
*'''rur''' - Сумма заказа.
*'''inshprice''' - Стоимость заказа.
*'''pricekur''' - Стоимость курьерской доставки.
*'''priceag''' - Агентское вознаграждение.
*'''pricecalc''' - Сумма для передачи агенту.
*'''paytype''' - Тип оплаты: 1 - безнал, 2 - наличными курьером, 3 - наличными в офисе, 4 - перевод на карту.
*'''paytypename''' - Строковое представление типа оплаты
*'''weight''' - Вес заказа.
*'''distance''' - Дистанция по заказу
*'''status''' - Статус заказа.

== Генерация коротких ссылок ==

В некоторых случаях, например, при использовании в СМС, может потребоваться использование коротких ссылок на ЛК.
Для этого, необходимо отправить запрос с полной ссылкой, в ответ на который придёт хэш-код для ссылки.

'''Пример запроса генерации коротких ссылок:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<shortlink>
<link short="0"> https://home.courierexe.ru/8/site/orders </link>
</shortlink>
</source>

'''shortlink''' - Корневой контейнер. Обязательный элемент.
*'''link''' - Полная ссылка, для которой необходимо получить код. Обязательный элемент. Если атрибут '''short''' равен 1, то ответ не будет содержать XML, а только хэш-код.

'''Пример ответа на запрос генерации коротких ссылок:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<shortlink>
<hash>35AF350C</hash>
</shortlink>
</source>

*'''hash''' - Хэш-код ссылки.

Далее, можно использовать ссылку на ЛК:

<nowiki>https://home.courierexe.ru/35AF350C или curie.ru/35AF350C</nowiki>

'''Примечание!''' Сервис коротких ссылок работает только для ресурсов компании MeaSoft.

== Проверка надежности покупателя ==

Проверка надежности работает только для тарифа "Максимум" личного кабинета.

<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<mcheck>
<auth extra="8" login="login" pass="pass" />
<phones>
<phone>89161147992</phone>
</phones>
</mcheck>
</source>

Ответ:

<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<mcheck>
<phones>
<phone rate="90">89161147992</phone>
</phones>
</mcheck>
</source>

Как выдать корреспонденцию курьеру

2022-05-31T14:51:00Z

Olga:

Передачу корреспонденции на руки курьеру необходимо отмечать в программе. Это позволит отслеживать статус выполняемых заказов. В процессе передачи оператор работает в программе на вкладке '''Выдача'''. В этой статье описан только алгоритм передачи корреспонденции курьеру. Подробное описание см. в статье «[[Выдача корреспонденции курьерам]]».

Чтобы выдать корреспонденцию курьеру:
# Перейдите на вкладку '''Выдача''' в верхнем меню программы.
# Отсканируйте удостоверение или выберите курьера из списка слева. Если курьера нет в списке, то перейдите на вкладку '''Сотрудники''', выделите запись курьера в списке нажмите на кнопку '''Выдача корреспонденции'''.
# Убедитесь, что установлен режим '''Выдача'''. Система автоматически указывает текущий день как дату выдачи.
# Отсканируйте штрихкод корреспонденции к выдаче.
# Отправление добавится в таблицу заказов справа со статусом по выдаче «На руках». Заказ останется в таблице, пока оператор не закроет его — назначит статус «Доставлено», «Не доставлено» или «Не доставлено по причине». Чтобы увидеть в таблице закрытые заказы, укажите их дату выдачи.
# Выдайте отсканированную корреспонденцию курьеру вместе с сопроводительными документами. О создании сопроводительных документов см. [[Как сформировать сопроводительные документы|в следующем шаге быстрого старта]].

[[Файл:Выдача.png|none|1000 px]]

<table style="width:100%">
<tr>
<td>
<p style="text-align:left">Предыдущий шаг</p>
[[Файл:left.png|link=Как_запланировать_отправление_на_курьера|left|75px|Назад]]
</td>
<td>
<p style="text-align:right">Следующий шаг</p>
[[Файл:right.png|link=Как_сформировать_сопроводительные_документы|right|75px|Вперед]]
</td>
</tr>
</table>

Внешние склады

2022-05-31T14:46:05Z

Olga:

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

Чтобы открыть справочник, в главном меню программы выберите '''Справочники''' > '''Внешние склады'''. Окно справочника выглядит следующим образом:

[[Файл:vns.png|none]]

С помощью контекстного меню вы можете добавить новый склад и открыть карточку склада для редактирования.

При необходимости можно настроить создание автоматических заборов с внешних складов на центральный и далее комплектовать сами заказы.

Файл:Vns.png

2022-05-31T14:44:10Z

Olga: Olga загрузила новую версию Файл:Vns.png

Тарифы клиентов

2022-05-31T14:37:09Z

Olga: /* Междугородние отправления */

=Тарифы=
Справочник «Тарифы» предназначен для создания и хранения тарифов клиентов на городские и индивидуальные междугородние доставки.

Чтобы увидеть список тарифов, выберите '''Справочники''' > '''Тарифы'''. Откроется список тарифов, отсортированный по названию.

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

[[Файл:Список тарифов по городу.png|none|250 px]]

Количество тарифов не ограничено, можно создавать их копии и привязывать к клиентам.

Чтобы создать тариф, нажмите '''F3'''.

Чтобы создать копию существующего тарифа, выделите его в списке и в контекстном меню выберите '''Создать копию'''.

Чтобы удалить тариф, выделите его в списке и в контекстном меню выберите '''Удалить'''. Удалить тариф невозможно, если он назначен клиенту.

Карточка тарифа выглядит следующим образом:

[[Файл:Редактирование тарифа.png|500 px|none]]

Вкладки '''Доставка''' и '''Забор''' предназначены для настройки [[#Городские отправления|тарифов на доставку по городу]].

Вкладка '''Межгород''' предназначена для [[#Междугородние отправления|настройки междугородних тарифов]].

На вкладке '''Прочее''' можно настроить [[#Прочее|дополнительные наценки]] для тарифа.

Вкладка '''Услуги''' предназначена для тарификации [[#Дополнительные услуги|дополнительных услуг]], например подъем на этаж или упаковка.

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

=== Городские отправления ===
====Доставка====

Вкладка '''Доставка''' предназначена для создания и хранения расценок на доставку корреспонденции.

[[Файл:Редактирование тарифа.png|500px]]

'''Название'''. Укажите название тарифа.

Стоимость доставки зависит от следующих параметров:
* '''количество отправлений'''. Это может быть количество единиц корреспонденции в заказе или общее количество по всем заказам, полученным в течение месяца. Укажите нужный режим в блоке '''Учет кол-ва отправлений'''.<br>Чтобы добавить строку в таблицу '''Количество отправлений''', нажмите F3 или выберите пункт контекстного меню '''Добавить''' и укажите количество отправлений. При этом для нового количества копируются зоны и тарифная сетка предыдущего количества.<br>Основные критерии для расчета количества отправлений содержатся в разделе '''Справочники''' > '''Переменные''' > '''Финансы''' > '''Подсчет кол-ва отправлений за месяц'''.<br>Для версии системы 2008.0.0.669 и выше в расчет количества отправлений за месяц можно включить дополнительные параметры отбора. Для этого предназначена системная дополнительная возможность '''OnOrderCountCalc''', для ее изменения обратитесь в службу технической поддержки.
* '''зона доставки'''. В таблице '''Зона''' отображаются все зоны, нарисованные в справочнике [[Зоны на карте|'''Зоны на карте''']]. Если зоны не заданы, для Москвы и Санкт-Петербурга по умолчанию отображаются зоны '''1''' и '''2''' — внутри (М)КАД и за (М)КАД соответственно. Выделите зону в таблице и настройте для нее тарифную сетку.
* '''режим срочности''' в таблице тарифа. Режимы срочности нельзя удалить, но можно скрыть, если не используется. Чтобы добавить новый режим или скрыть неиспользуемый, перейдите в '''Справочники''' > '''Статусы''' > '''17 Виды срочности'''. Там же в контекстном меню режима по кнопке '''Дополнительная информация''' можно изменить срок доставки для режима срочности.

'''Индивидуальные зоны'''. Если флажок установлен, для тарифа можно нарисовать индивидуальные зоны и вести расчет стоимости доставки по ним.

'''Зоны'''. По нажатии на кнопку открывается карта для создания индивидуальных зон тарифа.

В таблице тарифа укажите стоимость доставки для разных типов корреспонденции в зависимости от режима срочности. По умолчанию в таблице указаны 3 типа корреспонденции: '''Письмо''', '''Посылка''', '''Бандероль'''. Типы корреспонденции хранятся в '''Справочники''' > '''Статусы''' > '''18 Типы корреспонденции'''.

Чтобы установить зависимость стоимости доставки от массы корреспонденции:
# В таблице тарифа нажмите F3 или выберите в контекстном меню '''Добавить'''. Появится новая строка '''Масса'''.
#:В строке такого типа можно прописать стоимость доставки корреспонденции, масса которой:
#* не превышает значение, заданное в столбце '''Масса''' — установите флажок в столбце '''До''' и значение '''0''' в столбце '''Каждые'''. Например, на рисунке выше для корреспонденции массой от 1 до 2 кг сумма доставки составит 170 рублей при режиме срочности «Экспресс»;
#* равна или превышает значение, заданное в столбце '''Масса''' — установите шаг тарификации в столбце '''Каждые''', снимите флажок '''До'''. Например, на рисунке выше при превышении массы 3 кг на каждые 0,5 кг сумма доставки увеличивается на 20 рублей при режиме срочности «Эконом».
# Создайте нужное количество строк '''Масса''' и установите предельные значения массы и шаг превышения.
# Для каждой строки укажите тариф для разных режимов срочности.

'''Отдельно для денежных'''. Если флажок установлен, для доставок с наложенным платежом (денежных заданий) используется отдельная тарифная сетка, и ее нужно обязательно заполнить. Она отображается при установленном флажке '''Денежное'''. Если флажок '''Отдельно для денежных''' установлен, а тарифная сетка для денежных заданий не заполнена, денежные задания не тарифицируются.

Для филиалов в разных городах может быть настроена одна тарифная сетка внутригородской доставки. Для этого достаточно в справочнике [[Зоны на карте|«Зоны на карте»]] нарисовать зоны в городах и присвоить им одинаковые названия, например центр везде обозначить как зону 1. В этом случае город доставки определяется филиалом курьера.

====Забор====
Вкладка '''Забор''' предназначена для создания и хранения расценок на забор корреспонденции.

[[Файл:Редактирование тарифа забор.png|500px]]

Есть следующие варианты расчета стоимости забора:
* укажите фиксированную стоимость забора в поле '''Фиксированная стоимость забора'''. Если в поле указано значение, тарифная сетка не работает. Таким образом, если указать значение '''0''', забор будет бесплатным;
* создайте тарифную сетку в зависимости от количества отправлений, зон, режимов срочности и массы корреспонденции. Подробнее см. описание вкладки [[#Доставка|'''Доставка''']].

Вы можете создать отдельные режимы срочности для заборов. Для этого откройте '''Справочники''' > '''Статусы''' > '''17 Виды срочности''', создайте новый вид срочности и в дополнительной информации установите признак '''Включено только для заборов'''.

=== Междугородние отправления ===

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

[[Файл:Ред тарифа межгород.png|500 px]]

Чтобы создать индивидуальные тарифы, установите флажок '''Индивидуальные тарифы по зонам''' и нажмите на кнопку '''Тарифы'''. Индивидуальные тарифы настраиваются так же, как и общие. Подробнее см. [[Тарифы по зонам|«Тарифы по зонам»]].

Чтобы настроить индивидуальные зоны для клиентов, установите флажок '''Индивидуальные зоны''' и нажмите на кнопку '''Зоны'''. Индивидуальные зоны устанавливаются так же, как и общие. Подробнее см. [[Зоны|«Зоны»]].

Если оба флажка сняты, действуют общие тарифы и общие зоны междугородней доставки.

'''Таможенное оформление'''. Стоимость таможенного оформления.

<spoiler text="См. также">
[[Тарифы по зонам]]<br>
[[Тарифы#Тарифы на междугороднюю доставку|Тарифы на междугородную доставку]]
</spoiler>

===Прочее===

Вкладка '''Прочее''' предназначена для настройки дополнительных параметров тарифа.

[[Файл:Ред тарифа прочее.png|500 px]]

'''Ожидание'''. Укажите время и стоимость ожидания клиента курьером.

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

'''% при оплате картой'''. Размер комиссии курьерской службы за эквайринг.

'''% от объявленной ценности'''. Этот процент берется от разницы между объявленной ценностью и инкассируемой суммой, если она больше или равна нулю и суммируется с процентом от инкассируемой суммы.

'''Объем беспл. скл. хран., м^3''', '''Хранение 1 м^3 в день стоит'''. Поля относятся к [[Модуль складского учета|модулю складского хранения]]. На конец каждого дня периода хранения рассчитывается объем товаров поставщика на складе курьерской службы, объемы суммируются и умножаются на значение стоимости хранения 1 м^3 в день. Вы можете просмотреть отчет в пункте главного меню '''Склад''' > '''Отчеты''' > '''Отчет по стоимости хранения'''.

'''Коэфф. объемного веса'''. Подробнее см. [https://ru.wikipedia.org/wiki/%D0%9E%D0%B1%D1%8A%D1%91%D0%BC%D0%BD%D1%8B%D0%B9_%D0%B2%D0%B5%D1%81_%D0%BE%D1%82%D0%BF%D1%80%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D1%8F Объёмный вес отправления]. После ввода нового значения поля перезапустите MeaSoft для применения изменений. Значение коэффициента по умолчанию устанавливается в <mparam code="ValueToMass"/>.

'''% от цены товара, взимаемый за хранение 1 шт на складе в день'''. % от розничной стоимости товара, который добавляется к ежедневной стоимости хранения этого товара на складе. Цена товара указывается в карточке номенклатуры, в поле '''Розничная цена'''.

'''Учитывать зону отправителя'''. Работает для внутригородских отправлений. Если флажок установлен, стоимость доставки корреспонденции «обратно» рассчитывается для зоны, в которую входит адрес отправителя. Если флажок снят, то для зоны, в которую входит адрес получателя. Если код зоны отправителя ('''Справочники''' > '''Статусы''' > '''51 Зоны''' > '''Зоны клиентов''') больше кода зоны получателя, то стоимость доставки «туда» рассчитывается по зоне отправителя.

'''Учитывать город отправителя'''. Если флажок установлен, доставка тарифицируется по междугородним тарифам. Если флажок снят, то городом отправителя считается город филиала, с которым работает клиент.

<spoiler text="Схема работы флажков">[[Файл:Схема тарифов.png|none|1000 px]]</spoiler>
'''Считать доставку внутригородской, если адрес попал в зоны на карте'''. Если флажок установлен, то отправление, попавшее в зону другого города, тарифицируется по внутригородским расценкам этого города. Например, при доставке из Санкт-Петербурга в Москву будет действовать тариф на доставку по Москве.

'''Не учитывать возврат'''. Если флажок установлен, перевозка возвратных документов от клиента не тарифицируется.

'''Считать сроки с учетом выходных дней'''. Если флажок установлен, плановая дата доставки рассчитывается с учетом [[Выходные дни|выходных дней]]. Если флажок снят, срок доставки считается по календарным дням без учета выходных.

'''Филиал'''. В выпадающем списке выберите филиал, с которым работает клиент курьерской службы.

'''Формула'''. Поле для ввода текстовой формулы дополнительной услуги. Рассчитанная по формуле стоимость попадает в строку «База» спецификации услуг.

'''Тариф км'''. Табличная часть для дополнительной тарификации доставки в районы с пометкой '''Область'''. Если районы не установлены, для Москвы и Санкт-Петербурга тарифицируется расстояние по дорогам от МКАД/КАД. Для остальных городов вычисляется расстояние по прямой от района без флажка '''Область''' до адреса. Вычисленная надбавка попадает в строку «База» спецификации услуг. Подробнее см. раздел [[Расчет километража|«Расчет километража»]].

=== Услуги ===

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

[[Файл:Ред тарифа доп услуги.png|900 px|none]]

Подробнее о настройке услуг см. статью [[Дополнительные услуги|«Дополнительные услуги»]].

Если в столбце «Заменяет услугу» выбрать общую услугу, услуга тарифа будет применяться вместо нее.

Услуги, настроенные в тарифе, в [[Карточка корреспонденции#Услуги|карточке корреспонденции]] отображаются после общих услуг.

Тарифы клиентов

2022-05-31T14:34:54Z

Olga: /* Доставка */

=Тарифы=
Справочник «Тарифы» предназначен для создания и хранения тарифов клиентов на городские и индивидуальные междугородние доставки.

Чтобы увидеть список тарифов, выберите '''Справочники''' > '''Тарифы'''. Откроется список тарифов, отсортированный по названию.

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

[[Файл:Список тарифов по городу.png|none|250 px]]

Количество тарифов не ограничено, можно создавать их копии и привязывать к клиентам.

Чтобы создать тариф, нажмите '''F3'''.

Чтобы создать копию существующего тарифа, выделите его в списке и в контекстном меню выберите '''Создать копию'''.

Чтобы удалить тариф, выделите его в списке и в контекстном меню выберите '''Удалить'''. Удалить тариф невозможно, если он назначен клиенту.

Карточка тарифа выглядит следующим образом:

[[Файл:Редактирование тарифа.png|500 px|none]]

Вкладки '''Доставка''' и '''Забор''' предназначены для настройки [[#Городские отправления|тарифов на доставку по городу]].

Вкладка '''Межгород''' предназначена для [[#Междугородние отправления|настройки междугородних тарифов]].

На вкладке '''Прочее''' можно настроить [[#Прочее|дополнительные наценки]] для тарифа.

Вкладка '''Услуги''' предназначена для тарификации [[#Дополнительные услуги|дополнительных услуг]], например подъем на этаж или упаковка.

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

=== Городские отправления ===
====Доставка====

Вкладка '''Доставка''' предназначена для создания и хранения расценок на доставку корреспонденции.

[[Файл:Редактирование тарифа.png|500px]]

'''Название'''. Укажите название тарифа.

Стоимость доставки зависит от следующих параметров:
* '''количество отправлений'''. Это может быть количество единиц корреспонденции в заказе или общее количество по всем заказам, полученным в течение месяца. Укажите нужный режим в блоке '''Учет кол-ва отправлений'''.<br>Чтобы добавить строку в таблицу '''Количество отправлений''', нажмите F3 или выберите пункт контекстного меню '''Добавить''' и укажите количество отправлений. При этом для нового количества копируются зоны и тарифная сетка предыдущего количества.<br>Основные критерии для расчета количества отправлений содержатся в разделе '''Справочники''' > '''Переменные''' > '''Финансы''' > '''Подсчет кол-ва отправлений за месяц'''.<br>Для версии системы 2008.0.0.669 и выше в расчет количества отправлений за месяц можно включить дополнительные параметры отбора. Для этого предназначена системная дополнительная возможность '''OnOrderCountCalc''', для ее изменения обратитесь в службу технической поддержки.
* '''зона доставки'''. В таблице '''Зона''' отображаются все зоны, нарисованные в справочнике [[Зоны на карте|'''Зоны на карте''']]. Если зоны не заданы, для Москвы и Санкт-Петербурга по умолчанию отображаются зоны '''1''' и '''2''' — внутри (М)КАД и за (М)КАД соответственно. Выделите зону в таблице и настройте для нее тарифную сетку.
* '''режим срочности''' в таблице тарифа. Режимы срочности нельзя удалить, но можно скрыть, если не используется. Чтобы добавить новый режим или скрыть неиспользуемый, перейдите в '''Справочники''' > '''Статусы''' > '''17 Виды срочности'''. Там же в контекстном меню режима по кнопке '''Дополнительная информация''' можно изменить срок доставки для режима срочности.

'''Индивидуальные зоны'''. Если флажок установлен, для тарифа можно нарисовать индивидуальные зоны и вести расчет стоимости доставки по ним.

'''Зоны'''. По нажатии на кнопку открывается карта для создания индивидуальных зон тарифа.

В таблице тарифа укажите стоимость доставки для разных типов корреспонденции в зависимости от режима срочности. По умолчанию в таблице указаны 3 типа корреспонденции: '''Письмо''', '''Посылка''', '''Бандероль'''. Типы корреспонденции хранятся в '''Справочники''' > '''Статусы''' > '''18 Типы корреспонденции'''.

Чтобы установить зависимость стоимости доставки от массы корреспонденции:
# В таблице тарифа нажмите F3 или выберите в контекстном меню '''Добавить'''. Появится новая строка '''Масса'''.
#:В строке такого типа можно прописать стоимость доставки корреспонденции, масса которой:
#* не превышает значение, заданное в столбце '''Масса''' — установите флажок в столбце '''До''' и значение '''0''' в столбце '''Каждые'''. Например, на рисунке выше для корреспонденции массой от 1 до 2 кг сумма доставки составит 170 рублей при режиме срочности «Экспресс»;
#* равна или превышает значение, заданное в столбце '''Масса''' — установите шаг тарификации в столбце '''Каждые''', снимите флажок '''До'''. Например, на рисунке выше при превышении массы 3 кг на каждые 0,5 кг сумма доставки увеличивается на 20 рублей при режиме срочности «Эконом».
# Создайте нужное количество строк '''Масса''' и установите предельные значения массы и шаг превышения.
# Для каждой строки укажите тариф для разных режимов срочности.

'''Отдельно для денежных'''. Если флажок установлен, для доставок с наложенным платежом (денежных заданий) используется отдельная тарифная сетка, и ее нужно обязательно заполнить. Она отображается при установленном флажке '''Денежное'''. Если флажок '''Отдельно для денежных''' установлен, а тарифная сетка для денежных заданий не заполнена, денежные задания не тарифицируются.

Для филиалов в разных городах может быть настроена одна тарифная сетка внутригородской доставки. Для этого достаточно в справочнике [[Зоны на карте|«Зоны на карте»]] нарисовать зоны в городах и присвоить им одинаковые названия, например центр везде обозначить как зону 1. В этом случае город доставки определяется филиалом курьера.

====Забор====
Вкладка '''Забор''' предназначена для создания и хранения расценок на забор корреспонденции.

[[Файл:Редактирование тарифа забор.png|500px]]

Есть следующие варианты расчета стоимости забора:
* укажите фиксированную стоимость забора в поле '''Фиксированная стоимость забора'''. Если в поле указано значение, тарифная сетка не работает. Таким образом, если указать значение '''0''', забор будет бесплатным;
* создайте тарифную сетку в зависимости от количества отправлений, зон, режимов срочности и массы корреспонденции. Подробнее см. описание вкладки [[#Доставка|'''Доставка''']].

Вы можете создать отдельные режимы срочности для заборов. Для этого откройте '''Справочники''' > '''Статусы''' > '''17 Виды срочности''', создайте новый вид срочности и в дополнительной информации установите признак '''Включено только для заборов'''.

=== Междугородние отправления ===

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

[[Файл:Ред тарифа межгород.png|500 px]]

Чтобы создать индивидуальные тарифы, установите флажок '''Индивидуальные тарифы по зонам''' и нажмите на кнопку '''Тарифы'''. Индивидуальные тарифы настраиваются так же, как и общие. Подробнее см. [[Тарифы по зонам|«Тарифы по зонам»]].

Чтобы настроить индивидуальные зоны для клиентов, установите флажок '''Индивидуальные зоны''' и нажмите на кнопку '''Зоны'''. Индивидуальные зоны устанавливаются так же, как и общие. Подробнее см. [[Зоны|«Зоны»]].

Если оба флажка сняты, действуют общие тарифы и общие зоны междугородней доставки.

'''Таможенное оформление'''. Стоимость таможенного оформления.

<spoiler text="См. также">
[[Тарифы#Тарифы по зонам|Тарифы по зонам]]<br>
[[Тарифы#Тарифы для междугородной доставки|Тарифы на междугородную доставку]]
</spoiler>

===Прочее===

Вкладка '''Прочее''' предназначена для настройки дополнительных параметров тарифа.

[[Файл:Ред тарифа прочее.png|500 px]]

'''Ожидание'''. Укажите время и стоимость ожидания клиента курьером.

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

'''% при оплате картой'''. Размер комиссии курьерской службы за эквайринг.

'''% от объявленной ценности'''. Этот процент берется от разницы между объявленной ценностью и инкассируемой суммой, если она больше или равна нулю и суммируется с процентом от инкассируемой суммы.

'''Объем беспл. скл. хран., м^3''', '''Хранение 1 м^3 в день стоит'''. Поля относятся к [[Модуль складского учета|модулю складского хранения]]. На конец каждого дня периода хранения рассчитывается объем товаров поставщика на складе курьерской службы, объемы суммируются и умножаются на значение стоимости хранения 1 м^3 в день. Вы можете просмотреть отчет в пункте главного меню '''Склад''' > '''Отчеты''' > '''Отчет по стоимости хранения'''.

'''Коэфф. объемного веса'''. Подробнее см. [https://ru.wikipedia.org/wiki/%D0%9E%D0%B1%D1%8A%D1%91%D0%BC%D0%BD%D1%8B%D0%B9_%D0%B2%D0%B5%D1%81_%D0%BE%D1%82%D0%BF%D1%80%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D1%8F Объёмный вес отправления]. После ввода нового значения поля перезапустите MeaSoft для применения изменений. Значение коэффициента по умолчанию устанавливается в <mparam code="ValueToMass"/>.

'''% от цены товара, взимаемый за хранение 1 шт на складе в день'''. % от розничной стоимости товара, который добавляется к ежедневной стоимости хранения этого товара на складе. Цена товара указывается в карточке номенклатуры, в поле '''Розничная цена'''.

'''Учитывать зону отправителя'''. Работает для внутригородских отправлений. Если флажок установлен, стоимость доставки корреспонденции «обратно» рассчитывается для зоны, в которую входит адрес отправителя. Если флажок снят, то для зоны, в которую входит адрес получателя. Если код зоны отправителя ('''Справочники''' > '''Статусы''' > '''51 Зоны''' > '''Зоны клиентов''') больше кода зоны получателя, то стоимость доставки «туда» рассчитывается по зоне отправителя.

'''Учитывать город отправителя'''. Если флажок установлен, доставка тарифицируется по междугородним тарифам. Если флажок снят, то городом отправителя считается город филиала, с которым работает клиент.

<spoiler text="Схема работы флажков">[[Файл:Схема тарифов.png|none|1000 px]]</spoiler>
'''Считать доставку внутригородской, если адрес попал в зоны на карте'''. Если флажок установлен, то отправление, попавшее в зону другого города, тарифицируется по внутригородским расценкам этого города. Например, при доставке из Санкт-Петербурга в Москву будет действовать тариф на доставку по Москве.

'''Не учитывать возврат'''. Если флажок установлен, перевозка возвратных документов от клиента не тарифицируется.

'''Считать сроки с учетом выходных дней'''. Если флажок установлен, плановая дата доставки рассчитывается с учетом [[Выходные дни|выходных дней]]. Если флажок снят, срок доставки считается по календарным дням без учета выходных.

'''Филиал'''. В выпадающем списке выберите филиал, с которым работает клиент курьерской службы.

'''Формула'''. Поле для ввода текстовой формулы дополнительной услуги. Рассчитанная по формуле стоимость попадает в строку «База» спецификации услуг.

'''Тариф км'''. Табличная часть для дополнительной тарификации доставки в районы с пометкой '''Область'''. Если районы не установлены, для Москвы и Санкт-Петербурга тарифицируется расстояние по дорогам от МКАД/КАД. Для остальных городов вычисляется расстояние по прямой от района без флажка '''Область''' до адреса. Вычисленная надбавка попадает в строку «База» спецификации услуг. Подробнее см. раздел [[Расчет километража|«Расчет километража»]].

=== Услуги ===

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

[[Файл:Ред тарифа доп услуги.png|900 px|none]]

Подробнее о настройке услуг см. статью [[Дополнительные услуги|«Дополнительные услуги»]].

Если в столбце «Заменяет услугу» выбрать общую услугу, услуга тарифа будет применяться вместо нее.

Услуги, настроенные в тарифе, в [[Карточка корреспонденции#Услуги|карточке корреспонденции]] отображаются после общих услуг.

Настройка модуля автоматизации

2022-05-31T14:00:15Z

Olga:

Модуль автоматизации (интеграции с внешними системами) предназначен для выполнения периодических заданий импорта, экспорта, обработки данных. Модуль представляет из себя службу Windows, которая каждые 10 секунд проверяет наличие заданий в таблице scheduler.jobs с прошедшим временем следующего выполнения и выполняет эти задания.

Заданиями для модуля интеграции (модуля автоматизации) могут быть:
* оборудование: автопечать продажных/возвратных чеков, автоматическое ежедневное формирование Z-отчета для фискальных регистраторов;
* отчеты: всевозможные email-оповещения в формате Excel (например, отчет о доставке);
* SMS-оповещения: автоматические SMS рассылки для клиентов/курьеров;
* интеграция: процесс обмена заказами и их статусами с другими компаниями (например, курьерскими службами, интернет магазинами);
* автоматический экспорт-импорт информации с БД систем других производителей (например, WMS-системами — «системами управления складом»).

'''Документация ниже не предлагает всем пользователям системы самостоятельно настраивать задания данного модуля. Наоборот, мы рекомендуем обращаться за настройкой к нам. Однако документация ПОЗВОЛЯЕТ при желании и наличии специалистов выполнить настройку самостоятельно.'''

== Рекомендации для создания автоматической e-mail/смс рассылки ==
Перед формированием заявки для настройки автоматической email- или смс-рассылки пользователю системы крайне желательно ознакомиться с этой инструкцией.

# Не рассылайте одновременно e-mail и смс-уведомление. Массовая автоматическая рассылка в системе может быть реализована двумя способами:
#* e-mail-уведомление — более востребованы для рассылки клиентам информации с вложениями в виде прикрепляемых файлов с отчетами;
#* смс-информирование — подходят для сообщения получателю, что к нему едет курьер. Можно в этом же сообщении отправить телефон курьера, чтобы получатель мог напрямую в течение дня у курьера уточнить, когда именно тот планирует приехать.<br>Для каждого нового задания рекомендуется выбирать один из этих способов. Не следует перегружать клиента избыточной или регулярно повторяющейся информацией.
# Предусмотрите набор типов рассылки в карточке клиента (пользовательские поля для клиентов). Вы можете создать список рассылок в карточке клиента в виде флажков. Этот функционал позволяет включить клиента в рассылку или отключить от нее, а также настроить тарификацию необходимых рассылок в виде дополнительных услуг, предоставляемых клиенту.
# Периодичность рассылки и ее рабочее время. Задания рассылки могут выполняться с заданной периодичностью. Заданий для рассылки в системе может быть несколько, поэтому нужно оптимально распределить время их выполнения. ОПределите, будете ли вы отправлять e-mail-уведомление по каждому событию или разово, единым реестром в конце дня, недели и т. д. Например, e-mail-рассылка отчета о доставках выполняется утром в 9:00 за предыдущий день.<br>Выбор периодичности обязательно должен учитывать и интересы клиента: будет клиент просматривать множество писем с информацией или одно письмо с итоговой информацией в виде реестра.<br>Настройка рабочего времени рассылки (или часовой диапазон) больше применимы для смс-информирования. Эта настройка призвана разделять рабочее время и время отдыха. Таким образом, клиент не получит смс в 6 часов утра или в 11 часов вечера. Стандартно в системе принято условие для смс-рассылки с 8 до 10 вечера (по местному времени), но по желанию клиента этот диапазон может быть изменен.
# Продумайте текст рассылки, ее алгоритм, способ, а затем обращайтесь для настройки. Специальные теги в системе позволят добавить информацию, например о номере документа или периоде его формирования.
# Узнать у клиента, какие рассылки ему требуются. Хорошей практикой перед запросом для настройки рассылки может стать предварительный опрос клиентов — какая рассылка действительно необходима клиенту? необходима ли она ему вообще? сколько для клиента будет стоить эта услуга? Как и при каких условиях клиент сможет отписаться от рассылки?
# Длина и кодировка смс-рассылки (ссылка). Известно, что длина смс сообщения влияет на его стоимость. Уменьшить длину поможет выбор типа кодировки сообщения: кириллица или транслитерация. Перед планированием смс-рассылки проанализируйте предполагаемые расходы в сутки/месяц. Это поможет сразу построить эффективную модель задания и избавит от последующих изменений и корректировок в скрипте задания. Более подробно этот вопрос рассмотрен в статье [[Модуль отправки SMS-сообщений#Почему мои сообщения не доставлены?|Почему мои сообщения не доставлены? Почему уходит много денег?]].
# Подготовительная работа в системе перед настройкой рассылки. Заранее выберите и настройте [[Настройка глобальных параметров#Настройка подключения к почтовому серверу|почтовый адрес]] для отправки писем. Для смс-рассылки выберите [[Модуль отправки SMS-сообщений#Провайдеры|провайдера услуг]], настройте подключение к системе и протестируйте отправку сообщений в ручном режиме.
# Используйте статусную модель для заказов в ЛК как альтернативу рассылке отчета о доставках. Любой клиент MeaSoft может отслеживать свои заказы в [[Личный кабинет курьерской службы#Отслеживание заказа по номеру|личном кабинете]] и в режиме реального времени узнать статус их выполнения, что, несомненно, является весомым преимуществом по сравнению с почтовым уведомлением.
# Спам-фильтры и блокировка уведомлений на стороне клиента. Для email-рассылки с большими объемами всегда существует проблема — большинство почтовых серверов могут начать воспринимать сообщения из рассылки как спам, и бОльшая часть почты будет проигнорирована получателем или же попадет в соответствующие папки. Нередко получателю надоедает регулярно повторяющаяся информация, и он самостоятельно блокирует нежелательную почту как спам. Со временем почтовый адрес компании, отправляющей письма, может попасть в глобальный черный список антиспам-систем и заработать глобальную блокировку.

== Установка ==

== Настройка ==
параметры ini файла:

SMTPProtocol — тип протокола отправки почты: 0 — SMTP, 1 — SSL, 2 — TLS.

== Создание заданий ==
Задания описываются в текстовом виде в поле TEXT таблицы jobs.

В одном тексте может быть несколько заданий, разделенных пустой строкой, за исключением случая, когда текст начинается с префикса интерпретатора («<?>»).

Задание может быть следующих видов: «Интерпретируемый код», «Импорт данных», «Выполнение запроса» (возможно, с экспортом результата).

== Интерпретируемый код ==
Если задание начинается с префикса интерпретатора, то весь последующий код обрабатывается им.

== Импорт данных ==
input, OperNo, FileType, Param1, Param2, Param3, Param4, Param5, Param6

{|
!Параметр
!Описание
|-
|input
|Признак типа задания — импорт данных
|-
|OperNo
|Номер действия. Значения: 0 — загрузка по FTP, SFTP. 1 — Получение почты.
|-
|FileType
|Тип файла. Принимает значения:

0 — Формат «Йота»

1 — Формат «Сони»

2 — Формат «Омни»

3 — [[Описание стандартного протокола интеграции|Стандартный формат заказов]]

4 — [[Описание стандартного протокола интеграции|Стандартный формат отчетов]]

5 — Пользовательская процедура импорта

6 — Пользовательская процедура импорта, без загрузки файла

|-
|Param1
|Полный путь к папке на FTP-сервере (вместе с именем сервера) (для SFTP используйте sftp://имя_сервера)
|-
|Param2
|Имя пользователя FTP-сервера
|-
|Param3
|Пароль FTP-сервера
|-
|Param4
|Маска имен файлов, подлежащих загрузке
|-
|Param5
|Код клиента (поле courier.clients.code), для привязки загруженных заказов
|-
|Param6
|Активное соединение FTP. Для использования активного режима укажите active
|}

При задании «1» — Импорт почты система получает почту по всем аккаунтам из таблицы Accounts и загружает их в таблицы messages и attachment

== Экспорт данных ==
query, OperNo, FileType, Param1, Param2, Param3, Param4, Param5, Param6
QueryText

Модуль выполняет запрос QueryText, и передает результат его выполнения функции отправки, описанной в первой строке задания.

{|
!Параметр
!Описание
|-
|query
|Признак типа задания — экспорт данных
|-
|OperNo
|
Номер действия. Значения:
0 - Только выполнение запроса.
1 - Отправка по электронной почте
2 - Выгрузка файла на FTP, SFTP-сервер

7 - Отправка сообщений из тикетов <spoiler text="Параметры">FileType=2 - отключает отправку писем на входящие сообщения.</spoiler>
|-
|FileType
|
Тип файла. Принимает значения:
1 - Формат CSV
2 - Формат «Сони»
3 - Формат XLS
4 - формат CSV (с заголовками)
5 - загрузка файла и запуск скрипта
6 - запуск скрипта (без загрузки файла)
|}

Значения параметров 1-6 зависят от типа операции:

'''Тип операции — 0:'''
Не используются.

'''Тип операции — 1:'''
{|
!Параметр
!Описание
|-
|Param1
|Адрес e-mail для отправки
|-
|Param2
|Тема сообщения. Если пусто — «CourierAutoReport»
|-
|Param3
|Текст сообщения. Если пусто — «see attachment»
|-
|Param4
|Маска имени файла. Доступны шаблоны %DT%, %D%, %T% — Дата/время в форматах YYYYMMDDHHMMSS, YYYYMMDD, HHMMSS соответственно. Если пусто — используется ДатаВремя
|-
|Param5
|Не используется
|-
|Param6
|Не используется
|}

'''Тип операции — 2:'''
{|
!Параметр
!Описание
|-
|Param1
|Полный путь к папке на FTP-сервере (вместе с именем сервера) (для SFTP используйте "sftp://имя_сервера...»)
|-
|Param2
|Имя пользователя FTP-сервера
|-
|Param3
|Пароль FTP-сервера
|-
|Param4
|Маска имен файла. Доступны шаблоны %DT%, %D%, %T% — Дата/время в форматах YYYYMMDDHHMMSS, YYYYMMDD, HHMMSS соответственно. Если пусто — используется ДатаВремя
|-
|Param5
|Активное соединение FTP. Для использования активного режима укажите active
|-
|Param6
|Не обязательный параметр, полный путь к папке на FTP-сервере для сохранения копии
|}



== Примеры использования ==

=== Импорт заказов в стандартном формате с FTP-сервера ===
input, 0, 4, myftphost.ru/upload/folder/, MyUserName, MyPassword, *_orders.csv, 123, active

=== Экспорт заказов в CSV-файле на FTP-сервер ===
query, 0
replace scheduler.sent (code, sent, source, rectype)
select a.code, 'F', b.source, 2
from
courier.address a join zakaz b on a.zakaz=b.code left join scheduler.sent s on s.code=a.code and s.source=b.source and s.rectype=2
where a.ldtime>=date_sub(now(), interval 7 day)
and s.code is null
and b.source=123

query, 2, 1, myftphost.ru/upload/foulder/, MyUserName, MyPassword, MY-ORD-%DT%
select a.code, a.strbarcode, a.target, a.name, a.address, a.phone, a.rur
from scheduler.sent s join courier.address a on s.code=a.code
where s.sent='F' and s.source=123 and s.rectype=2

query, 0
update scheduler.sent set sent='T' where sent='F' and source=123 and rectype=2

Это задание состоит из 3 подзаданий. В первом запрос собирает коды отправлений, измененных за последние 7 дней, но не добавленных в очередь отправки в таблице sent. Во втором происходит формирование CSV-файла с заказами, у которых стоит отметка, что они не отправлены (sent.sent='F'), и отправка файла на FTP-сервер. В последнем подзадании запрос отмечает всю корреспонденцию отправленной. Если на втором этапе при отправке файла произойдет ошибка, то третий запрос не будет выполнен, заказы останутся в состоянии «не отправлен», и в следующий раз будет предпринята повторная попытка их отправки.

Автозамена

2022-05-31T13:02:20Z

Olga: Перенаправление на Импорт баз данных#Автозамена

#redirect[[Импорт баз данных#Автозамена]]

Работа с пунктами самовывоза (ПВЗ)

2022-05-31T13:00:58Z

Olga: /* Импорт из файла Excel с указанием ПВЗ */

== Введение ==

Пунктами самовывоза могут быть склады и филиалы курьерской службы, а также отделения партнеров курьерской службы. Получатель выбирает пункт выдачи на сайте <rspoiler text="интернет-магазина">Клиента курьерской службы</rspoiler> и узнает номер заказа или шифр его отправления. При поступлении отправления в ПВЗ получатель называет номер заказа или шифр работнику пункта или вводит данные в специальную панель и забирает корреспонденцию.

Процесс оформления корреспонденции для самовывоза описан в разделе [[Прием корреспонденции на склад#Самовывоз|«Самовывоз»]].

Информация о ПВЗ в Measoft хранится в справочнике [[Филиалы|'''Филиалы''']]. ПВЗ отображаются в выпадающем списке при вводе заказа как в офисной программе, так и в [[Личный кабинет клиента#Пункты выдачи заказов|личном кабинете]]. Это позволяет корректно указывать адреса ПВЗ.

Для отображения списка пунктов выдачи есть [https://home.courierexe.ru/js/measoft_map.js JavaScript модуль]. Инструкция по использованию — внутри. Посмотреть пример работы можно [https://home.courierexe.ru/pvz_test.html здесь].

== Пример создания корреспонденции с указанием ПВЗ ==

Чтобы при создании корреспонденции появилась возможность указать ПВЗ, в карточке корреспонденции установите флажок '''Самовывоз'''. После этого в поле '''ПВЗ''' появится список пунктов самовывоза. В списке отображаются только подчиненные филиалы, отмеченные флажком '''ПВЗ'''.

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

[[Файл:pvz014.png|700 px|none]]

== Загрузка ПВЗ через интеграцию (СДЭК, BOXBERRY) ==

Чтобы в систему загрузились ПВЗ компаний, например СДЭК или BOXBERRY, настройте с ними интеграции в соответствии с разделом [[Интеграция с другими системами#Тарификация и выбор подрядчика и его тарифа клиентом|«Тарификация и выбор подрядчика и его тарифа клиентом»]].

Обмен запросами при настроенной интеграции проходит каждые 30 минут.

Пример загруженного ПВЗ можно увидеть ниже. В карточке ПВЗ заполняется поле '''Код в филиале''' и устанавливается флажок '''Загружен из внешней системы'''.

[[Файл:pvz015.png|none]]

Чтобы клиенты не могли выбрать ПВЗ при оформлении заказа, в карточке филиала на вкладке '''Дополнительно''' установите флажок '''Не использовать подчиненные ПВЗ'''. Чтобы скрыть все подчиненные ПВЗ, установите этот флажок для родительского филиала.

== Права пользователя на просмотр заказов всех филиалов ==

В основном пункте меню '''Настройка''' > '''Пользователи''' откройте карточку пользователя и на вкладке '''Настройки''' укажите филиал, в котором он работает.

[[Файл:pvz016.png|400px|none]]

При этом он не сможет видеть заказы, в которых поле '''Отв. филиал''' отличается от филиала, указанного в карточке пользователя.

Чтобы пользователь видел заказы других филиалов, перейдите в '''Настройка''' > '''Пользователи''', выделите пользователя в окне слева и в дереве прав справа установите флажок '''Видеть данные всех филиалов'''.

В результате на вкладке '''Адреса''' в фильтре на вкладке '''Дополнительно''' для пользователя появится флажок '''Только относящиеся к моему филиалу'''. Если этот флажок снять, выполняется поиск по всем филиалам.

== Работа с ПВЗ в личном кабинете ==

[[Личный кабинет курьерской службы#Настройка полей и вкладок|Как настроить ПВЗ в личном кабинете]]

[[Личный кабинет клиента#Пункты выдачи заказов|Как работать с ПВЗ в личном кабинете]]

== Импорт из файла Excel с указанием ПВЗ ==

Чтобы автоматически распознавать ПВЗ при [[Импорт баз данных|импорте файла]] Microsoft Excel из интерфейса программы ('''Связь''' > '''Импорт БД из Excel'''):

* укажите в поле '''Адрес''' в загружаемом файле наименование ПВЗ и обязательно заполните поле '''Город получателя''', т.к. у многих ПВЗ в разных городах имеются одинаковые наименования.

Перед наименованием ПВЗ добавляйте префикс «ПВЗ »:

[[Файл:pvz024.png|400px|none]]

* укажите в поле '''Адрес''' значение из поля '''Код''' [[Филиалы|карточки ПВЗ]]. В этом случае город получателя указывать необязательно, так как код ПВЗ уникален.

Статусы

2022-05-31T12:58:45Z

Olga: /* Виды срочности */

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

[[Файл:Статусы.PNG|none]]

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

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

Действия со статусами совершаются с помощью контекстного меню статуса:
* '''Переименовать''' — переименовать выбранный статус;
* '''Добавить''' — добавить статус;
* '''Удалить''' — удалить выбранный статус;
* '''Изменить цвет''' — изменить цвет, которым подсвечивается строка или столбец с этим статусом в интерфейсе пользователя;
* '''Разрешения''' — настроить права доступа пользователей на установку выделенного статуса;
* '''Дополнительная информация''' — настроить дополнительные параметры статуса. См. ниже на примере настройки [[#виды срочности|видов срочности]];
* '''Выключить/включить''' — отключить или включить статус. Отключенные статусы отображаются перечеркнутыми;
* '''Скопировать путь''' — скопировать в буфер обмена программный путь статуса вида «"Справочники" -> "Статусы" -> "10 Статусы принятия на работу" -> "1 Не приглашен"».

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

Изменения в справочнике вступают в силу только после перезагрузки системы.

= Виды срочности =
Виды срочности настраиваются в справочнике '''Статусы''' > '''Виды срочности'''.

Удалять виды срочности нельзя, но можно отключить неиспользуемые. Для этого в контекстном меню записи вида срочности выберите '''Выключить/Включить'''.

Чтобы настроить параметры, в контекстном меню вида срочности выберите ''' Дополнительная информация'''. Откроется окно настройки:

[[Файл:Виды срочности.png|none]]

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

Параметры видов срочности и особенности настройки перечислены в таблице:

{|class="wikitable" align="center" style="width: 80%;
!style="width: 5%;"|Параметр
!style="width: 45%;"|Описание
!style="width: 50%;"|Возможные значения, пояснения
|-
| colspan="3" style="text-align:center;" | Строка 1 — общие параметры
|-
|1||Срок доставки в рабочих днях||'''0''' — доставка сегодня,<br> '''1''' — доставка сегодня или завтра,<br>'''2 и больше или пусто''' — в штатном режиме.<br>Значения 0 и 1 подсвечивают недоставивших курьеров в выдаче
|-
|2||Cокращенное название вида срочности ||Для печати и отчетов
|-
|3||Доступность в ЛК||'''Пусто/0''' — доступен,<br>'''1''' — недоступен,<br>'''2''' — доступен только для доставки,<br>'''3''' — доступен только для заборов,<br>'''4''' — в ЛК недоступен, используется только для интеграций
|-
|4||Отображение в ЛК при импорте из Excel||Принудительно, независимо от значения 3 параметра<br>'''0''' — не отображать, <br>'''1''' — отображать
|-
|5||Виды срочности, учитываемые при тарификации забора по количеству доставок||Значение указывается в формате 'X,Y,Z'<br>Если параметр пустой, учитываются все виды срочности
|-
|6||Вид срочности для деления стоимости доставки на 2 этапа||Первый этап — доставка до регионального центра, рассчитывается по указанному в параметре виду срочности; второй этап — до клиента
|-
|7||Преобразование адреса для новых заказов||'''0''' — преобразовывать адрес согласно [[Импорт баз данных#Автозамена|справочнику автозамен]], <br> '''1''' — отключить преобразование адреса для новых заказов
|-
|8||Типы клиентов, которым доступен этот режим срочности в заказах||'''0''' — режим срочности доступен неавторизованному пользователю в калькуляторе <br> Типы клиентов хранятся в справочнике '''Справочники''' > '''Статусы''' > '''Типы клиентов'''<br>
|-
| colspan="3" style="text-align:center;" | Строка 2 — параметры для [[Интеграция_с_другими_системами#Сквозная интеграция|сквозной интеграции]]
|-
|1||Код филиала партнера||Код можно посмотреть в '''Справочники''' > '''Межгород''' > '''Филиалы'''. Можно в одинарных кавычках указать несколько ответственных филиалов через запятую, тогда режим срочности будет доступен для всех перечисленных филиалов. Для версии системы 2021.0.0.38 и выше вместо кода филиала можно указать знак вопроса (?), это обозначит доступность режима срочности для всех филиалов
|-
|2||Экстра-код партнера в системе MeaSoft|| Коды для сторонних компаний приведены в [[Интеграция_с_другими_системами#Настройка интеграции|таблице]]
|-
|3||Имя пользователя в системе партнера||Может отличаться от того, под которым работает интеграция, здесь нужно для расчета цены для клиента
|-
|4||Пароль пользователя, указанного в 3 параметре||
|-
|5||Вид срочности партнера||Посмотреть доступные коды видов срочности можно по ссылке в [[Интеграция_с_другими_системами#Настройка интеграции|таблице]], в калькуляторе в выпадающем списке. Можно в одинарных кавычках указать несколько видов срочности через запятую, тогда система будет выбирать из них первый доступный
|-
|6||Наценка к стоимости, передаваемой подрядчиком||В деньгах или в процентах, если стоит знак процента. Например 10 — наценка 10 рублей, 10% — наценка 10 процентов
|-
|7||Отключение сквозной тарификации||'''1''' — выключить сквозную тарификацию. Параметр используется, если подключение нужно только для передачи заказов по интеграции, а расчет цены не нужен. <br> Если для заказа назначен режим срочности с отключенной сквозной тарификацией, то расчет ведется по внутренним тарифам, а подрядчику заказ отправляется тарифом указанным в настройках второй строки.
|-
|8||Поиск наименьшей стоимости|| '''1''' — искать самый дешевый тариф в указанных режимах срочности партнера. Работает для СДЭК и Почты России
|}

Импорт баз данных

2022-05-31T12:55:25Z

Olga: /* Шаблон как отдельный файл */

== Логика загрузки заказов ==

Для загрузки заказов из MS Excel в MeaSoft используются шаблоны.

Шаблон описывает соответствие между столбцами таблицы Excel и параметрами заказа в системе. Например, в файле Excel в столбце H указан телефон получателя. Шаблон нужен, чтобы перенести значение из столбца H в параметр заказа «Телефон получателя».

В системе нет готовых шаблонов. Как правило, шаблоны каждой курьерской службы уникальны. Содержимое шаблона зависит от формата данных во входящих Excel-файлах.

В процессе импорта система может выполнить обработку отдельных значений. Для этого добавьте в шаблон выражение на внутреннем языке разработки. Подробнее см. в статье [[Руководство программиста|«Руководство программиста»]]. Например, рекомендуем приводить адрес доставки к внутреннему формату системы.

MeaSoft поддерживает импорт из всех форматов данных, которые предоставляет Excel. Подробнее см. [https://support.office.com/ru-ru/article/поддерживаемые-excel-форматы-файлов-0943ff2c-6014-4e8d-aaea-b83d51d46247 на официальном сайте Microsoft Office].

== Создание шаблона загрузки ==
Чтобы создать шаблон:
# Перейдите в '''Связь''' > '''Импорт БД из Excel''', затем в окне «Импорт из Excel» нажмите на кнопку '''Шаблоны'''. Откроется окно со списком шаблонов.
# Нажмите на кнопку F3. Откроется окно «Шаблон загрузки»:[[Файл:Vlog 5.png|none]]

Для загрузки по шаблону достаточно настроить вкладку '''Основное'''. Настройка остальных вкладок необязательна и зависит от формата заказов в Excel-файле.

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

'''Поля вкладки «Основное»'''

'''Название'''. Укажите название шаблона.

'''Личный шаблон'''. Если флажок установлен, другие пользователи не могут редактировать шаблон. Личный шаблон может изменить его владелец или администратор системы.

'''Первая строка'''. Укажите номер первой строки с заказом в таблице Excel. Не указывайте номер строки с заголовком таблицы. Например, если в шаблоне первая строка это заголовок таблицы и поле '''Условие загрузки''' пустое, то система создаст заказ на основе заголовка таблицы.

'''Условие загрузки'''. Дополнительное условие, значение — логическое выражение на [[Руководство программиста|внутреннем языке разработки]]. <rspoiler text ="Посмотреть примеры условий"> <p><nowiki>A!''</nowiki></p> <p>A!'Итого'</p> <p>A!A(-1)</p> </rspoiler>. Во время чтения таблицы система проверяет каждую строку по указанному условию:
* условие выполнено — формируется новый заказ из строки;
* условие не выполнено — пропускает строку и переходит к следующей.

'''Адрес не пустой'''. Если флажок установлен, заказы создаются только из строк с заполненным адресом.

'''Контролировать уникальность шифра'''. Если флажок установлен, нельзя создавать заказ с шифром, который уже есть в системе.

'''Только в недоставленных'''. Если флажок установлен, не нужно проверять уникальность шифра среди доставленной корреспонденции.

'''Идентификация отправителя'''. Выберите параметр, по которому будет определяться отпавитель. Возможные значения: '''Нет''', '''Юр. лицо''', '''ИНН''', '''ID'''.

'''Столбец''' и '''Строка'''. Укажите столбец и строку с информацией об отправителе.

'''Пересчитать стоимость после загрузки'''. Если флажок установлен, стоимость доставки пересчитывается после завершения загрузки из файла.

В таблице настройте соответствие столбцов в Excel с параметрами заказа в системе. Столбцы в таблице:
* '''Поле''' — внутреннее имя параметра заказа;
* '''Название''' — название параметра в MeaSoft;
* '''По умолчанию''' — значение параметра, если столбец «Значение» пустой;
* '''Значение''' — значение параметра. Укажите буквенное обозначение столбца в Excel. Система использует значение из указанного столбца текущей строки. Чтобы отредактировать исходное значение, используйте внутренний язык разработки. Например, в Excel фамилия, имя и отчество получателя указаны в отдельных столбцах: A, B и C. MeaSoft хранит эти данные в одном параметре «ФИО получателя» (name). Чтобы сложить значения из трех столбцов в один параметр, для ФИО получателя укажите следующее: «A+' '+B+' '+C».

Для параметра '''Адрес получателя''' используйте значение вида «MakeAddress(буква столбца)». Такой подход преобразует адрес во внутренний формат системы.

== Как указать лист с заказами в Excel-файле ==
По умолчанию система ищет информацию о товарах на первом листе Excel-файла. Эту логику можно изменить вручную. Для этого:
# Откройте существующий шаблон на редактирование или добавьте новый шаблон.
# Перейдите на вкладку '''Дополнительно'''.
# В поле '''Скрипт до загрузки''' напишите формулу:
<?>
SetSheet(х);

В указанной формуле х — это номер листа с заказами в Excel-файле. Замените х на подходящее число.

== Как загрузить заказы ==

=== Загрузка из одного файла ===
# Убедитесь, что в MeaSoft есть [[Клиенты и партнеры|запись клиента]], от имени которого будет создан заказ. Для этого перейдите на вкладку '''Клиенты''' и используйте поиск в правой части окна. Например, укажите название компании, ФИО менеджера и нажмите '''Вывести'''.
# Если клиент не найден, то нажмите F3 и в окне новой записи заполните вкладки '''Основное''', '''Реквизиты''' и '''Финансы'''.
# Перейдите на вкладку '''Заказы''' и создайте новый [[Работа с заказами#Карточка заказа|заказ]].
# В главном меню выберите '''Связь''' > '''Импорт БД из Excel'''. Откроется окно «Импорт из Excel»:[[Файл:Импорт из эксель.png|none]]
# В поле '''Формат''' выберите шаблон импорта.
# В поле '''Заказ''' укажите номер созданного заказа или выберите его из списка по кнопке [[Файл:More.png]]. В этот заказ будут загружены данные файла.
# В поле '''Файл''' нажмите на кнопку [[Файл:More.png]] справа и укажите путь к файлу MS Excel с информацией о заказах.
# Нажмите '''Старт''', чтобы начать импорт данных.

=== Загрузка из нескольких файлов ===
# Убедитесь, что в MeaSoft есть [[Клиенты и партнеры|запись клиента]], от имени которого будет создан заказ. Для этого перейдите на вкладку '''Клиенты''' и используйте поиск в правой части окна. Например, укажите название компании, ФИО менеджера и нажмите '''Вывести'''.
# Если клиент не найден, то нажмите F3 и в окне новой записи заполните вкладки '''Основное''', '''Реквизиты''' и '''Финансы'''.
# В главном меню выберите '''Связь''' > '''Импорт БД из папки'''. Откроется окно «Импорт из папки»:[[Файл:Importfromfolder.png|none]]
# В поле '''Папка''' нажмите на кнопку [[Файл:More.png]] справа и укажите укажите путь к папке с нужными Excel-файлами. Убедитесь, что в папке хранятся только файлы с заказами. Система не проверяет содержимое файлов.
# В поле '''Клиент''' укажите название клиента, для которого будет создан заказ. В поле работает автозаполнение при вводе.
# В списке '''Шаблон''' выберите шаблон импорта для обработки первого файла в списке. Для удобства рекомендуем в названии Excel-файлов писать название подходящего шаблона или клиента.
# Нажмите '''Загрузить'''. Система обработает первый файл и уберет его из списка, в панели внизу отобразится отчет о количестве обработанных записей.
# Если в списке остались элементы, повторите действия, начиная с пункта 4, для следующего файла.

==Автозамена==

При оформлении заказа клиенты и покупатели могут указывать один и тот же адрес в разных форматах, что ведет к ошибкам [[Модуль_«Карта»#Геокодирование|геокодирования]].

Чтобы привести адрес к [[Знакомство_с_программой#Ввод адресной информации|требуемому формату]], вы можете настроить правила автозамены для загруженных извне заказов. Для выполнения операции требуются права «Администрирование».

Чтобы настроить автозамену:
# В главном меню выберите '''Связь''' > '''Импорт БД из Excel''' и в окне «Импорт из Excel» нажмите на кнопку '''Автозамена'''. Откроется окно «Настройка автозамены»:[[Файл:Настройка автозамены.png|none]]
# Нажмите F3 и создайте новое правило автозамены. При нажатии на кнопку '''ОК''' в списке правил добавится еще одна строка.<br>Чтобы изменить правило, щелкните дважды на его строке. Чтобы удалить правило, используйте комбинацию клавиш CTRL+F8.
# После создания правил с помощью кнопок '''Вверх''' и '''Вниз''' определите их порядок. Автозамены применяются к адресу последовательно сверху вниз.

Автозамену можно отключить для определенных режимов срочности. Для этого в справочнике '''Статусы''' > '''17 Виды срочности''' для режима срочности установите 7 параметр первой строки в значение 1. Подробнее см. раздел «[[Виды срочности]]».

Автозамены, предусмотренные исходным кодом системы:
* следующие слова удаляются из начала адреса еще до срабатывания пользовательской автозамены:
вул.,ул.,пр.,проспект,проезд,шоссе ,шоссе,аллея,ул ,пр-д,пер.,пер ,ул ,пр ,пр-т,пр-кт,бульвар,бул.,бул ,набережная,наб.,наб

* если улица не найдена, но в справочнике есть другая улица, название которой отличается на одну букву, срабатывает подмена одной буквы в названии улицы. Если улица была указана корректно, укажите ее вручную. Система «запомнит» эту улицу, и ошибка больше не повторится.

== Шаблон как отдельный файл ==
Вы можете сохранить шаблон в отдельный XML-файл. Или загрузить шаблон в систему из XML-файла.
{{Note|При выгрузке и загрузке шаблона система не копирует настройки на вкладке '''Услуги'''. Укажите эти настройки вручную после импорта шаблона.}}

=== Сохранить шаблон в файл ===
# Перейдите в '''Связь''' → '''Импорт БД из Excel''' → '''Шаблоны'''.
# Выберите шаблон для выгрузки и кликните на нем правой кнопкой мыши.
# Нажмите '''Сохранить в файл'''.
# Выберите папку и нажмите '''Сохранить'''.

Сохранение шаблона:
[[Файл:Vlog 12_1.png|center|300px]]

=== Добавить в систему шаблон из файла ===
# Перейдите в '''Связь''' → '''Импорт БД из Excel''' → '''Шаблоны'''.
# Выберите шаблон для выгрузки и кликните на нем правой кнопкой мыши.
# Нажмите '''Добавить из файла'''.
# Выберите XML-файл шаблона и нажмите '''Открыть'''.

Загрузка шаблона:
[[Файл:Vlog 12_2.png|center|300px]]

== Пример создания простого шаблона для загрузки вложений ==
{{Note|Пример построения простого шаблона рассмотрен в этой статье в целях обучения и для возможности самостоятельного создания шаблона пользователем. В случае необходимости создания сложного шаблона для клиента, который включает в себя сложные модификаторы формул, процедуры преобразования типов и множество прочих нюансов - следует обращаться с вопросами в техническую поддержку (желательно с файлом реестра Вашего клиента и описанием желаемых требований для его загрузки в MeaSoft).}}

Для импорта базы рассылки в формате Microsoft Excel необходимо сделать заказ (вкладка основного окна программы '''«Заказы»'''), в который будет производиться импорт. Затем, в главном меню основного окна программы выберите пункт меню '''«Связь» → «Импорт БД из Excel»''' (необходимо наличие прав создания почтовых заказов). Откроется окно следующего вида:

[[Файл:vlog 1.png|none]]

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

[[Файл:vlog 2.png|none]]

Чтобы редактировать шаблон, нажмите на кнопку '''Шаблоны'''. Можно использовать существующий шаблон или же создать новый путём нажатия клавиши F3.

Шаблон состоит из заголовка, который включает в себя название шаблона, порядковый номер первой загружаемой строки в таблице, а также условие загрузки каждой конкретной строки (номер первой строки и условие загрузки могут задаваться формулами), и строк описания значений, помещаемых в каждое конкретное поле базы данных адресов. Строка состоит из названия поля в БД по-английски и описания по-русски, значения по умолчанию, и значения ячейки. Если поле '''значение''' пустое — программа использует значение поля '''значение по умолчанию'''. Поля «значение» и «значение по умолчанию» описывают преобразования данных на внутреннем языке формул (описание языка приведено по ссылке [http://wiki.courierexe.ru/index.php/Руководство_программиста]).

Процесс импорта реестра заказов из Microsoft Excel в систему будет выполнен на примере построения шаблона с именем '''«пример»'''. На рисунке ниже изображено содержимое таблицы Microsoft Excel с заказами клиента:

[[Файл:vlog_3.png|none|1000px]]

В данном реестре мы видим, что заказы № 1-3 имеют одного и того же получателя, поэтому для удобства выполнения их можно объединить в одну единицу корреспонденции. Такая же ситуация с заказами № 4-6.

Примечание: На рисунке выше, поля столбцов по горизонтали нумеруются буквами латинского алфавита (A-N), однако данное представление в пакете MS Office может отличаться от привычного и иметь цифровую нумерацию (R1C1). На рисунке ниже представлено меню настроек (включение/отключение) в программе Microsoft Excel для стиля ссылок R1C1. Для работы с цифровым представлением столбцов Microsoft Excel — соответствие цифровой нумерации буквенной происходит путем простого преобразования: номер цифры = порядковому номеру буквы алфавита (1-‘A’, 2-‘B’, 3-‘C’ и т. д.):

[[Файл:vlog 4.png|none]]

'''Примечание:''' Обработка программой реестра заказов из файла происходит с первого листа документа, поэтому таблица заказов должна находиться на первой странице.

Редактирование старых и создание новых шаблонов доступно по нажатию на кнопку '''«Шаблоны…»''' в окне '''«Импорт из Excel»'''. Буквенные соответствия столбцов таблицы указаны напротив ячеек с названием. На рисунке ниже показано окно редактирования шаблона с именем '''«пример»'''.

Для поля '''«Адрес получателя»''' указано значение с функцией '''MakeAddress'''(буква столбца с адресом из реестра в Excel файле). Функция '''MakeAddress'''(e) — помогает и позволяет синтактически более точно преобразовывать адрес получателя путем его многократного преобразования и приведения к внутреннему стандарту программы. Параметры преобразования адреса можно задать путем нажатия кнопки '''«Автозамена…»''' в окне '''«Импорт из Excel»'''.

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

[[Файл:vlog 5.png|none]]

В данном примере мы видим, что первой строкой, из которой программа начнёт считывать данные, является строка под номером 10. Условием загрузки является то, что ячейка ‘d’ (Контактное лицо (Ф.И.О.)) не равна своему же значению из предыдущей строки. Если равно, то такая строка будет считаться вложением к предыдущей строке. Вложения необходимы для того, чтобы можно было объединять несколько единиц корреспонденции в одну карточку при выполнении заданных условий (в нашем случае таким условием является то, что получателем корреспонденции является одно и то же лицо по одному и тому же адресу).

Для работы с вложениями необходимо перейти во вкладку '''«Дополнительно»''' и в окне '''«Скрипт после загрузки (используйте %zakaz% как код загружаемого заказа)»''' ввести следующий скрипт (первая строка должна быть пустой):

Query update address a join
(select b.address, sum(b.kol_vo*b.price) as price, sum(b.kol_vo*b.mass) as mass,
sum(b.kol_vo) as kol_vo
from address a join boxes b on b.address=a.code
where a.zakaz=%zakaz%
group by b.address) b on a.code=b.address
set
a.kol_vo=b.kol_vo,
a.rur=b.price,
a.mass=CalcAddressMass(a.code)
WHERE NOT EXISTS (SELECT r.code FROM boxes bb JOIN `returns` r ON r.box=bb.code WHERE bb.address=a.code) and a.date_put is null

[[Файл:vlog 6.png|none]]

Этот скрипт необходим для суммирования значений переменных '''«количество»''', '''«масса»''' и '''«цена»''' вложений в карточке корреспонденции.

Далее переходим во вкладку '''«Вложения»''':

[[Файл:vlog 7.png|none]]

Ставим галку '''«Загружать вложения»'''.

Условием загрузки в данном примере является то, что ячейка ‘d’ не пустая. Наименование вложения будет браться из ячейки ‘h’.

Поле '''«Код товара»''' используется как артикул в [[Модуль складского учета#Карточка товара|номенклатуре поставщика]] (актуально при использовании модуля складского учёта). В нашем случае оно пустое.

Каждое из полей в настройке шаблона соответствует определенному полю в карточке единицы корреспонденции, показанному на рисунке ниже. Заполнение полей шаблона «пример» происходит в соответствии со структурой и содержимым ячеек реестра в Excel файле. Поля на вкладке '''«Получатель»''' единицы корреспонденции заполняются следующим образом:

[[Файл:vlog 8.png|none]]

* Значения ячейеек ‘m’, ‘g’, ‘i’ в карточке корреспонденции будут суммироваться согласно своим значениям во вложениях.

Поля на вкладке '''«Вложения»''' единицы корреспонденции заполнятся так:

[[Файл:vlog 9.png|none]]

После создания и редактирования нового шаблона становится возможным автоматическая загрузка заказов из файла Excel. Для этого в окне '''«Импорт из Excel»''', последовательно указываем тип шаблона для обработки реестра заказов в Excel, номер заказа и файл реестра. По нажатию на кнопку '''«Cтарт»''' происходит последовательная обработка строк из файла Excel, ячейки которой считываются в базу данных заказов программы. Процесс завершения обработки сопровождается информационным сообщением содержащим статистику обработки записей:

[[Файл:vlog 10.png|none]]

Из результата импорта видно, что программа обработала 6 записей из файла реестра Excel, которые были объеденены в 2 карточки корреспонденции согласно заданных в шаблоне условий.
После этого мы можем перейти во вкладку '''«Адреса»''' где можно просмотреть те единицы корреспонденции, которые были импортированы в заказ (в данном случае это заказ № 120340) и продолжить работу в программе:

[[Файл:vlog_11.png|none|1000px]]

== Примеры модификаций содержимого ячеек при помощи формул ==
Иногда для приведения содержимого ячеек Excel к стандартному типу, который будет понятен программе, следует воспользоваться [[Руководство программиста|специальными функциями]]. Простые примеры применения функций рассмотрены ниже.

'''1.'''Пример содержимого ячейки Excel «F»: «Россия, Москва, Горького ул., д. 23»

Задача: Копировать из ячейки слово «Москва».

Решение: '''PARAM(replace(f, ' ', ','), 2)'''

Комментарий: Делим строку разделителями пробелов на параметры и читаем второй параметр. На выходе получаем «Москва».

'''2.'''Пример содержимого ячейки Excel «J»: «с 11 до 18»

Задача А: приведение строки к стандартному типу времени ЧЧ:ММ (например, для времени доставки). Необходимо к значению времени «11» добавить значение «:00».

Решение: '''LEFT(REMSPACE(replace(J, 'с', '')), 2)+':00''''

Комментарий: Поиском слева ищем в строке значение «c», после читаем второй параметр, разделенный символом пробел — число «11», затем к нему прибавляем значение «:00». На выходе получаем «11:00».

Задача Б: приведение строки к стандартному типу времени ЧЧ:ММ (например, для времени доставки). Необходимо к значению времени «18» добавить значение «:00».

Решение: '''RIGHT(J, 2)+':00''''

Комментарий: Копируем справа от начала строки 2 символа — значение «18», затем к нему прибавляем значение «:00». На выходе получаем «18:00».

'''3.'''Пример содержимого ячейки Excel «A»: «'забор груза'», либо «'забор'»

Задача: Определять при чтении содержимого ячейки забор или доставку. В случае наличия слова «'забор груза'», либо «'забор'» — подставлять в ячейку цифру «0»,
иначе подставлять следующий порядковый номер.

Решение: '''if((C='забор груза')+(C='забор'), 0, GetNewNumber)'''

Комментарий: При помощи условия if и логического ИЛИ выполняем проверку, если условие соблюдается — подставиться значение «0», если не соблюдается — подставлять следующий порядковый номер (функция GetNewNumber).

'''4.'''Пример содержимого ячейки Excel «K» -«забрать документы», содержимого ячейки Excel «L» — «поставить печать»:

Задача: сложить одержимое двух ячеек для загрузки поля «поручение курьера».

Решение: '''k+', '+l'''

Комментарий: Выполняем сложение содержимого двух ячеек «K» и «L», разделенного запятой и пробелом. На выходе получаем «забрать документы, поставить печать».

'''5.'''Пример содержимого ячейки «масса, грамм» в Excel «N»: «2500»

Задача: Перевод значения ячейки «масса» из грамм в килограмм.

Решение: '''n/1000'''

Комментарий: Выполняем операцию деления. На выходе получаем значение для поля масса "2.5 ".

'''6.'''Пример расчета сроков доставки

Задача: Рассчитать планируемую дату доставки на основе [[Тарифы клиентов|сроков доставки]]

Решение: '''CalcDeliveryDate(ZakazRecord.source, Mode, TownTo, TownFrom, ZakazRecord.date_beg)'''

Комментарий: Вызываем функцию CalcTownDeliveryDate которая рассчитывает дату планируемой доставки по таблице сроков. В функцию передаем : ZakazRecord.date_beg — дата заказа, к ней будет добавлено найденное количество дней на доставку. ZakazRecord.source — код клиента, по нему будет найден тариф с указанными сроками. Mode — режим срочности. TownTo, TownFrom — коды городов отправителя и получателя.
Примечание:
функция CalcDeliveryDate до версии 804, имела имя CalcTownDeliveryDate

Файл:Настройка автозамены.png

2022-05-31T12:07:14Z

Olga:

Модуль «Кросс-докинг»

2022-05-30T11:38:22Z

Olga: /* Интерфейс */

Модуль используется, когда курьерская служба оказывает услугу по комплектации заказов.

Интернет-магазин формирует заказ и привозит на склад курьерской службы товар. В заказе перечислены адреса, куда нужно выполнить доставку, а на вкладке '''Вложения''' перечислены данные товара: название, количество, цена, штрихкод производителя. Курьерской службе нужно как можно быстрее принять товар на складе, разложить по адресам, упаковать, промаркировать, из какого он заказа, и потом его можно выдавать курьерам.

Модуль «Кросс-докинг» имеет следующие возможности:
* [[#Комплектация|комплектация заказов]];
* [[#Адресное хранение|адресное хранение]] — поиск ячейки хранения товара по штрихкоду производителя в адресах;
* [[#Сборка комплектов|сборка комплектов]] для выдачи курьерам.

Схема работы модуля:[[Файл:Кросс-докинг.png|none|1000 px]]

= Интерфейс =

;Полка
:Условное пространство, на котором может быть товар только из одного адреса. Полка имеет имя и штрихкод.

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

Во всех пунктах меню '''Справочники''' > '''Стеллажи''' определяются полки, с которыми программа будет работать. Каждый квадрат на рисунке — отдельная полка, на примере определены 16 полок (4 ряда x 4 столбца):

[[Файл:St.png|none]]

По умолчанию полки нумеруются в формате A1, Б1, где буква обозначает ряд, а цифра столбец. Программа при комплектации может говорить названия полок. Чтобы переименовать полку, нажмите на прямоугольник и введите имя полки.

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

Чтобы иметь возможность «класть» и «снимать» товар с полки, нужен штрихкод полки. Чтобы распечатать штрихкод, нажмите '''Печать штрихкодов'''. Формат наклеек определится автоматически в зависимости от типа принтера — листы А4 или этикетка для термопринтера.

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

Для работы понадобятся следующие виды штрихкодов:
* штрихкод товара — расположен на упаковке с товаром. Используется для поиска товара в адресах;
* штрихкод полки — расположен на наклейке. Печатается в любом пункте меню '''Cправочники''' > '''Стеллажи''' или '''Функции''' > '''Печать служебных штрихкодов'''. Чтобы напечатать штрихкоды для отдельных полок, выделите полки в интерфейсе модуля «Кросс-докинг», удерживая зажатой клавишу SHIFT, и нажмите на кнопку '''Печать штрихкодов''';
* штрихкод отправления — создается в MeaSoft. В окне комплектации можно распечатать наклейку со штрихкодом для уже скомплектованных заказов с помощью кнопки '''Печатать наклейки'''.

= Комплектация =

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

Чтобы начать комплектацию, на вкладке '''Заказы''' выберите заказы, которые будете комплектовать, и в контекстном меню выберите пункт '''Комплектация адресов'''. Откроется окно «Комплектация адресов по заказу»:

[[Файл:sort2.png|none|800px]]

Поиск товара по штрихкоду ограничен только выбранными заказами.

'''Заказ''', '''Номер''', '''Шифр''' — данные карточки корреспонденции, которая сейчас комплектуется. Кнопка [[Файл:More.png]] предназначена для перехода к карточке корреспонденции.

'''Наименование''' — название найденного товара из карточки корреспонденции.

'''Сообщение''' — показывает сообщение пользователю в течение 10 секунд. Это может быть описание ошибки или ожидаемого от пользователя действия. В случае ошибки фон поля окрашивается красным цветом. Важные сообщения дублируются голосом, потому что кладовщик может быть не за компьютером и не видеть сообщения.

'''Ручной ввод''' — поле для ввода штрихкодов с клавиатуры.

'''Полка''' — отображает название активной полки.

'''Количество''' — количество отсканированного товара в отправлении. Например, есть отправление, по которому нужно доставить один ноутбук и две флешки. При сканировании флешки будет указано 2, ноутбук 1.

'''Настройка''' — кнопка раскрывает список дополнительных настроек:
* '''Крупногабарит (сразу поместить товар на полку)''' — при сканировании штрихкода товара, если он найден в адресах, сразу печатается наклейка корреспонденции, и товар автоматически помещается на полку, без сканирования штрихкода полки. Кладовщику нужно прикрепить наклейку к товару и переместить крупногабарит сразу на место, откуда он будет выдан курьеру. Если в этом заказе есть некрупногабаритный товар, он может быть укомплектован позднее в другом месте и соединен с крупногабаритным: штрихкоды полок могут быть распечатаны в нескольких экземплярах и одна полка может находится физически в двух местах на складе;
* '''Не использовать полки, когда одна ед. товара''' — если флажок установлен, при сканировании единственного товара адресе для него сразу печатается наклейка и устанавливается статус «Заказ собран». Кладовщику остается упаковать товар и наклеить наклейку корреспонденции;
* '''Полки справа налево''' — если флажок установлен, нумерация полок меняет направление;
* '''Печатать бланк''' — если флажок установлен, по завершении комплектации печатается выбранный бланк. Бланки хранятся в '''Справочники''' > '''Печатные формы''' > '''Бланки для корреспонденции'''.
* '''Печатать файлы''' — если флажок установлен, по завершении комплектации распечатываются прикрепленные к корреспонденции файлы. Просмотреть файлы можно в карточке корреспонденции по кнопке '''Функции''' > '''Прикрепленные файлы'''.
* '''Печатать наклейки на место''' — снимите флажок, если нужно отключать печать наклейки на места при использовании упаковок.

Цвета состояния полок:
* cерый цвет — пустые полки;
* желтый цвет — полки, на которых уже есть товар, но не весь;
* зеленый цвет — полки, на которых товар собран полностью.

В комплектации существует две основных операции: «[[#Операция «положить товар на полку»|положить товар на полку]]» и «[[#Операция «снять заказ с полки»|снять заказ с полки]]».

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

=== Операция «положить товар на полку» ===

Это основная операция комплектации. Товар сначала помещается на желтые (частично заполненные) полки, а потом на серые полки (пустые).
# Отсканируйте штрихкод производителя на упаковке с товаром. Программа находит в комплектуемом заказе адрес с таким товаром и выбирает нужную полку. На экране полка выделится красным, отображается сообщение «Положите товар на полку …».
# Кладовщик несет товар к полке и сканирует ее штрихкод. В программе одна единица товара помещается на полку, операция завершается.

Если на полке будет собран весь товар по отправлению, полка окрасится в зеленый цвет, и в названии полки будет отображен статус «Готов».

Если отправление на полке не полностью укомплектовано, полка окрасится в желтый цвет, и в названии полки будет статус «Кол-во на полке» из «Кол-ва товаров в заказе».

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

=== Учет мест и упаковки ===
Чтобы учитывать использованные упаковки и распределение товара по местам, нужно вести комплектацию по местам с упаковкой. Тогда процесс будет таким:
# Отсканируйте штрихкод товара. Программа говорит, на какую полку его нужно отнести.
# Отсканируйте штрихкод упаковки. Упаковка добавлена в карточку корреспонденции, списана со склада.
# Отсканируйте штрихкод полки. Товар и упаковка помещаются на полку, в корреспонденции создается место, печатается наклейка на место, ее нужно наклеить на упаковку.
# Отсканируйте штрихкод товара, чтобы скомплектовать следующий товар. Вместо штрихкода полки теперь можно использовать штрихкод места.
# Если потребуется собирать следующее место, необходимо повторить процесс с 1 шага: сканирование штрихкода товара > штрихкода упаковки > штрихкода полки.

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

=== Операция «снять заказ с полки» ===
Когда заказ на полке укомплектован полностью (полка окрашена в зелёный цвет), снять его с полки можно операцией «снять заказ с полки» или кнопкой '''Очистить полки'''. Операция '''Очистить полки''' убирает весь товар с полки и, если товар складской, возвращает на склад.

Чтобы снять заказ с полки:
# Для укомплектованных заказов распечатайте наклейку с помощью кнопки '''Печатать наклейки'''. Наклейки будут распечатаны только для укомплектованных заказов по порядку сверху-вниз, слева направо.
# Отсканируйте штрихкод корреспонденции. Полка, на которой лежит товар из этой корреспонденции, подсветится красным цветом, отобразится сообщение «Отсканируйте полку …».
# Кладовщик собирает товар с полки, упаковывает его, приклеивает наклейку со штрихкодом корреспонденции.
# Кладовщик сканирует штрихкод полки, полка в программе окрашивается в серый цвет, отображается сообщение «Заказ собран». В карточке адреса проставляется количество принятого товара, равное количеству мест.
# Теперь полка пуста и может использоваться для комплектации другого заказа.

=== Модификации операции «Положить товар на полку» ===
Иногда приходит товар, частично промаркированный интернет-магазином, на нем может быть наклеен штрихкод клиента.

Чтобы убедиться, что наклейка на товаре принадлежит именно тому заказу, который выбрала система, операцию приема можно изменить следующим образом: сканирование штрихкода товара > сканирование штрихкода клиента > сканирование штрихкода полки.

Перечислите клиентов, для которых необходимо делать такую проверку, в переменной '''Справочники''' > '''Переменные''' > '''Прочие` > '''ShelvingClientCheck'''.

=== Модификация печати стикера адреса ===
Чтобы отключить автоматическую печать наклейки корреспонденции, отключите переменную '''Корреспонденция''' > '''Печатать наклейку адреса автоматически при комплектации'''.

В таком случае снимать товар с полки можно сканированием штрихкода клиента или шифра, а потом полки.

Комплектация одновременно может происходить с нескольких рабочих мест, программа полностью автоматически будет следить за распределением полок и товара по заказам. Когда происходит операция «положить товар на полку», товар и полка резервируется, чтобы никто не мог её использовать, пока операция не будет завершена кладовщиком, начавшим её. По умолчанию резерв ставится на 20 минут. Резерв снимается автоматически, когда операция завершена или прошло больше 20 минут.

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

В дополнительных возможностях есть функция OnShelvingBarScan — в нее передается отсканированный штрихкод, она проверяет его по таблице перекодировки и, если нужно, изменяет его.

= Адресное хранение =

;Адресное хранение
: Способ размещения товара на складе, при котором каждому месту хранения присваивается индивидуальное наименование (адрес).

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

Чтобы привязать заказ к полке, нужен ее штрихкод. Чтобы распечатать штрихкод, нажмите '''Печать штрихкодов''' или используйте пункт меню '''Функции''' > '''Печать служебных штрих-кодов''' > '''Печать этикеток для адресного хранения'''.

Этикетки содержат штрихкод и номер полки. После приема корреспонденции положите ее на любую полку и отсканируйте штрихкод этой полки. Номер полки будет в карточке корреспонденции на вкладке '''Прочее''' в поле '''Хранится в ячейке'''. Таким образом, адресное хранение позволяет быстро находить нужную корреспонденцию по номеру полки. Подробнее о приеме корреспонденции см. раздел «[[Прием корреспонденции на склад#Самовывоз|Самовывоз]]».

= Сборка комплектов =

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

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

Когда полки в программе созданы, распечатайте наклейки для сборки комплектов и сканируйте корреспонденцию. Подробнее см. раздел «[[Выдача корреспонденции курьерам#Предварительная сборка комплекта заказов|Предварительная сборка комплекта заказов]]».

С помощью дополнительной возможности «Назначить полки план. курьерам (32577)» вы можете настроить процесс автоматической сборки комплектов заказов по запланированным курьерам:

# Настройте отображение справочника '''Сборка комплектов''' в соответствии с действительным расположением полок на складе.
# Чтобы подключить доп. возможность, обратитесь в техническую поддержку MeaSoft.
# [[Учет корреспонденции#Учет корреспонденции|Запланируйте]] заказы на курьеров.
# Запустите доп. возможность, в открывшемся окне укажите склад и плановую дату доставки. В результате формируются сборки комплектов. Они отображаются на вкладке '''Выдача''' в узле '''Сборка комплекта заказов'''.
# Запустите [[Прием корреспонденции на склад|прием корреспонденции]] по клавише F10. В окне «Прием корреспонденции» в настройках выберите пункт '''Диктовать: номер сборки комплекта'''.
# Сканируйте отправление. Отобразится номер полки, отведенный для этой корреспонденции, информация продублируется голосом.
# Положите отправление на указанную полку и отсканируйте ее штрихкод.
# Повторите шаги 6-7 для всех отправлений.
# Чтобы выдать сборку курьеру, перейдите на вкладку '''Выдача''' и отсканируйте штрихкод полки.

Заглавная страница

2022-05-26T09:16:37Z

Olga: /* Содержание */

__NOTOC__
Эта страница — оглавление документации к системе [http://courierexe.ru MeaSoft]. Мы постоянно дополняем и улучшаем описания функциональности. Все вопросы и предложения направляйте в службу технической поддержки.

Опубликованная документация описывает текущую версию системы. Если у вас установлена одна из предыдущих версий, то [http://courierexe.ru/contacts.htm обратитесь к нам] для обновления. Обновление может быть платным. Историю изменений программы смотрите на [https://home.courierexe.ru/whatsnew специальной странице].

Спасибо, что пользуетесь системой MeaSoft и принимаете участие в ее развитии!


==Содержание==

<table style="width: 100%;">
<tr>
<td style="text-align:right; padding-top: 20px">[[File:general.png|50px]]</td>
<td style="text-align:left; padding-top: 20px"><h3>Общий раздел</h3></td>
<td style="text-align:right; padding-top: 20px">[[File:operator.png|50px]]</td>
<td style="text-align:left; padding-top: 20px"><h3>Работа с заказами</h3></td>
<td style="text-align:right; padding-top: 20px">[[File:admin.png|50px]]</td>
<td style="text-align:left; padding-top: 20px"><h3>Настройка системы</h3></td>
</tr>
<tr>
<td colspan="2" style="vertical-align:top; padding-left: 20px">
<ul>
<li>[[Как с нами работать]]</li>
<li>[[Справки о налоговом резидентстве]]</li>
<li>[https://home.courierexe.ru/whatsnew История изменений]</li>
<li>[[Файлы для загрузки]]</li>
<li>[[Видео уроки|Видеоуроки]]</li>
<li>[https://courierexe.userecho.com/ Часто задаваемые вопросы]</li>
<li>[[План изучения MeaSoft]]</li>
<li>[[English Help]]</li>
</ul>
</td>
<td colspan="2" style="vertical-align:top; padding-left: 20px">
<ul>
<li>[[Знакомство с программой|Знакомство с программой]]</li>
<li>[[Учет корреспонденции]]</li>
<li>[[Работа с заказами]]</li>
<li>[[Модуль «Карта»#Виды планирования|Планирование доставок на карте]]</li>
<li>[[Печать ведомостей и наклеек]]</li>
<li>[[Выдача корреспонденции курьерам]]</li>
<li>[[Манифесты]]</li>
<li>[[Доска приема]]</li>
<li>[[Документы]]</li>
<ul>
<li>[[Приходные кассовые ордера]]</li>
<li>[[Путевые листы]]</li>
<li>[[Счета|Работа со счетами]]</li>
<li>[[Акты передачи денег и корреспонденции]]</li>
</ul>
<li>[[Учет наличных по бухгалтерии]]</li>
<li>[[Биллинг курьеров]]</li>
<li>[[Работа со срочными заказами]]</li>
<li>[[Импорт баз данных|Импорт заказов из Excel]]</li>
<li>[[Модуль складского учета|Складской учет]]</li>
<li>[[Работа с Почтой России]]</li>
<li>[[Отчеты]]</li>
<li>[[Задания]]</li>
<li>[[Честный ЗНАК]]</li>
<li>[[Функции|Функции]]</li>
</ul>
</td>
<td colspan="2" style="vertical-align:top; padding-left: 20px">
<ul>
<li>[[Начало использования]]</li>
<li>[[Настройка глобальных параметров|Глобальные параметры]]</li>
<li>[[Настройка параметров рабочего места|Рабочее место]]</li>

<li>[[Быстрый старт]]</li>
<li>[[Клиенты и партнеры]]</li>
<li>[[Сотрудники]]</li>
<li>[[Пользователи]]</li>
<li>[[Модуль «Карта»#Настройка|Модуль «Карта»]]</li>
<li>[[Тарифы]]</li>
<li>[[Работа с пунктами самовывоза (ПВЗ)|Пункты самовывоза (ПВЗ)]]</li>
<li>[[Зарплата]]</li>
<li>[[Собеседования]]</li>
<li>[[Тикеты]]</li>
<li>[[Справочники]]</li>
<li>[[Охрана]]</li>
<li>[[Устранение неполадок]]</li>
<li>[[Оборудование]]</li>
<li>[[Дополнительные модули]]</li>
<ul>
<li>[[Настройка модуля печати кассовых чеков|Модуль печати кассовых чеков]]</li>
<li>[[Настройка модуля автоматизации|Модуль автоматизации]]</li>
<li>[[Модуль «Кросс-докинг»]]</li>
<li>[[Модуль отправки SMS-сообщений]]</li>
<li>[[Модуль репликации данных]]</li>
</ul>
<li>[[Интеграция с другими системами]]</li>
</ul>
</td>
</tr>
<tr>
<td style="text-align:right; padding-top: 20px">[[File:developer.png|50px]]</td>
<td style="text-align:left; padding-top: 20px"><h3>Для разработчиков</h3></td>
<td style="text-align:right; padding-top: 20px">[[File:cabinet.png|50px]]</td>
<td style="text-align:left; padding-top: 20px"><h3>Сервисы</h3></td>
<td style="text-align:right; padding-top: 20px">[[File:mobile.png|50px]]</td>
<td style="text-align:left; padding-top: 20px"><h3>Мобильные приложения</h3></td>
</tr>
<tr>
<td colspan="2" style="vertical-align:top; padding-left: 20px">
<ul>
<li>[[Руководство программиста]]</li>
<li>[[API|API-интеграция]]</li>
<li>[[Пользовательские отчеты]]</li>
<li>[[Пользовательские поля]]</li>
</ul>
</td>
<td colspan="2" style="vertical-align:top; padding-left: 20px">
<ul>
<li>[[Личный кабинет клиента]]</li>
<li>[[Личный кабинет курьерской службы]]</li>
<li>[[Личный кабинет курьера]]</li>
<li>[[M-POINT]]</li>
<li>[[Веб-сервисы]]</li>
<li>[[MeaShip]]</li>
</ul>
</td>
<td colspan="2" style="vertical-align:top; padding-left: 20px">
<ul>
<li>[[Мобильное приложение курьера для Android|Приложение курьера для Android]]</li>
<li>[[Мобильное приложение курьера для IPhone|Приложение курьера для iOS]]</li>
<li>[[Мобильное приложение кладовщика для Android|Приложение кладовщика для Android]]</li>
</ul>
</td>
</tr>
</table>

==Наши контакты==

<div style="font-size: 13px; overflow: hidden; min-width: 400px;">
<div style="overflow:hidden; margin-bottom: 20px;">
<div style="width: 40%; float: left;">
<div style="padding-left: 90px;">
<div style="width: 90px; float:left; margin-left: -90px;">
</div>

<div style="float: left;">
<h3> Техническая поддержка </h3>

<p style="padding: 0; margin: 0; line-height: 19px;"> <b>По будням </b> обращайтесь с 8:00 до 21:00 по московскому времени. </p>

<p style="padding: 0; margin: 0; line-height: 19px;"> <b>По выходным</b> помогаем вам с 10:00 до 18:00. </p>

<p style="padding: 0; margin: 0; line-height: 19px;"> Email: [mailto:support@courierexe.ru support@courierexe.ru] </p>

<p style="padding: 0; margin: 0; line-height: 19px;"> Телефон: +7 (495) 987-17-12, 8 (800) 707-90-35 </p>

<p style="padding: 0; margin: 0; line-height: 19px;"> Skype: courierexe, courierexe1, courierexe2, courierexe3, courierexe4 </p>

<p style="padding: 0; margin: 0; line-height: 19px;">
<spoiler text="Подробнее о поддержке">Перед обращением в поддержку, пожалуйста, поищите решение проблемы в этой документации и в сообществе пользователей [http://courierexe.userecho.com courierexe.userecho.com]. В сообществе вы можете оставить свой вопрос и мы обязательно на него ответим!

Если вы не нашли ответ и не оставили свой вопрос, то позвоните нам по телефону или Skype. Мы спросим ваше имя и название компании, которую представляете. Также будьте готовы оставить телефон для связи и заранее установите программу для подключения к вашему компьютеру: [https://download.teamviewer.com/download/TeamViewer_Setup.exe TeamViewer] или [https://anydesk.com Any Desk].</spoiler> </p>
</div>

<div style="float: left;">
<h3> Социальные сети </h3>
<p style="padding: 0; margin: 0; line-height: 19px;"> Мы доступны в социальных сетях! Там мы пишем об изменениях в системе и проводим голосования. Планируем публиковать обучающие видео. </p>

<p style="padding: 0; margin: 0; line-height: 19px;"> [https://vk.com/measoft ВКонтакте] </p>

<p style="padding: 0; margin: 0; line-height: 19px;"> [https://facebook.com/courierexe Facebook] </p>
</div>
</div>
</div>

<div style="width: 43%; float: right;">
<div style="padding-left: 90px;">
<div style="width: 90px; float:left; margin-left: -90px;">
</div>
<div style="float: left; width: 100%;">
<h3> Сообщество пользователей</h3>

<p style="padding: 0; margin: 0; line-height: 19px;">
[http://courierexe.userecho.com courierexe.userecho.com]
</p>

<p style="padding: 0; margin: 0; line-height: 19px;">
Здесь вы можете предложить свою идею по улучшению или обсудить работу сервиса с другими
пользователями.
</p>
<p style="padding: 0; margin: 0; line-height: 19px;">

[https://t.me/measoft Telegram-канал]
</p>

<p style="padding: 0; margin: 0; line-height: 19px;">
Подпишитесь на наш канал и будьте уверены, что не пропустите важную для вашей работы<br>
новую функциональность! Обсуждайте обновления с другими пользователями и расскажите,<br>
что вы думаете о работе сервиса.
</p>
</div>
</div>
</div>

</div>

Импорт баз данных

2022-05-26T08:42:37Z

Olga: /* Как загрузить заказы */

== Логика загрузки заказов ==

Для загрузки заказов из MS Excel в MeaSoft используются шаблоны.

Шаблон описывает соответствие между столбцами таблицы Excel и параметрами заказа в системе. Например, в файле Excel в столбце H указан телефон получателя. Шаблон нужен, чтобы перенести значение из столбца H в параметр заказа «Телефон получателя».

В системе нет готовых шаблонов. Как правило, шаблоны каждой курьерской службы уникальны. Содержимое шаблона зависит от формата данных во входящих Excel-файлах.

В процессе импорта система может выполнить обработку отдельных значений. Для этого добавьте в шаблон выражение на внутреннем языке разработки. Подробнее см. в статье [[Руководство программиста|«Руководство программиста»]]. Например, рекомендуем приводить адрес доставки к внутреннему формату системы.

MeaSoft поддерживает импорт из всех форматов данных, которые предоставляет Excel. Подробнее см. [https://support.office.com/ru-ru/article/поддерживаемые-excel-форматы-файлов-0943ff2c-6014-4e8d-aaea-b83d51d46247 на официальном сайте Microsoft Office].

== Создание шаблона загрузки ==
Чтобы создать шаблон:
# Перейдите в '''Связь''' > '''Импорт БД из Excel''', затем в окне «Импорт из Excel» нажмите на кнопку '''Шаблоны'''. Откроется окно со списком шаблонов.
# Нажмите на кнопку F3. Откроется окно «Шаблон загрузки»:[[Файл:Vlog 5.png|none]]

Для загрузки по шаблону достаточно настроить вкладку '''Основное'''. Настройка остальных вкладок необязательна и зависит от формата заказов в Excel-файле.

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

'''Поля вкладки «Основное»'''

'''Название'''. Укажите название шаблона.

'''Личный шаблон'''. Если флажок установлен, другие пользователи не могут редактировать шаблон. Личный шаблон может изменить его владелец или администратор системы.

'''Первая строка'''. Укажите номер первой строки с заказом в таблице Excel. Не указывайте номер строки с заголовком таблицы. Например, если в шаблоне первая строка это заголовок таблицы и поле '''Условие загрузки''' пустое, то система создаст заказ на основе заголовка таблицы.

'''Условие загрузки'''. Дополнительное условие, значение — логическое выражение на [[Руководство программиста|внутреннем языке разработки]]. <rspoiler text ="Посмотреть примеры условий"> <p><nowiki>A!''</nowiki></p> <p>A!'Итого'</p> <p>A!A(-1)</p> </rspoiler>. Во время чтения таблицы система проверяет каждую строку по указанному условию:
* условие выполнено — формируется новый заказ из строки;
* условие не выполнено — пропускает строку и переходит к следующей.

'''Адрес не пустой'''. Если флажок установлен, заказы создаются только из строк с заполненным адресом.

'''Контролировать уникальность шифра'''. Если флажок установлен, нельзя создавать заказ с шифром, который уже есть в системе.

'''Только в недоставленных'''. Если флажок установлен, не нужно проверять уникальность шифра среди доставленной корреспонденции.

'''Идентификация отправителя'''. Выберите параметр, по которому будет определяться отпавитель. Возможные значения: '''Нет''', '''Юр. лицо''', '''ИНН''', '''ID'''.

'''Столбец''' и '''Строка'''. Укажите столбец и строку с информацией об отправителе.

'''Пересчитать стоимость после загрузки'''. Если флажок установлен, стоимость доставки пересчитывается после завершения загрузки из файла.

В таблице настройте соответствие столбцов в Excel с параметрами заказа в системе. Столбцы в таблице:
* '''Поле''' — внутреннее имя параметра заказа;
* '''Название''' — название параметра в MeaSoft;
* '''По умолчанию''' — значение параметра, если столбец «Значение» пустой;
* '''Значение''' — значение параметра. Укажите буквенное обозначение столбца в Excel. Система использует значение из указанного столбца текущей строки. Чтобы отредактировать исходное значение, используйте внутренний язык разработки. Например, в Excel фамилия, имя и отчество получателя указаны в отдельных столбцах: A, B и C. MeaSoft хранит эти данные в одном параметре «ФИО получателя» (name). Чтобы сложить значения из трех столбцов в один параметр, для ФИО получателя укажите следующее: «A+' '+B+' '+C».

Для параметра '''Адрес получателя''' используйте значение вида «MakeAddress(буква столбца)». Такой подход преобразует адрес во внутренний формат системы.

== Как указать лист с заказами в Excel-файле ==
По умолчанию система ищет информацию о товарах на первом листе Excel-файла. Эту логику можно изменить вручную. Для этого:
# Откройте существующий шаблон на редактирование или добавьте новый шаблон.
# Перейдите на вкладку '''Дополнительно'''.
# В поле '''Скрипт до загрузки''' напишите формулу:
<?>
SetSheet(х);

В указанной формуле х — это номер листа с заказами в Excel-файле. Замените х на подходящее число.

== Как загрузить заказы ==

=== Загрузка из одного файла ===
# Убедитесь, что в MeaSoft есть [[Клиенты и партнеры|запись клиента]], от имени которого будет создан заказ. Для этого перейдите на вкладку '''Клиенты''' и используйте поиск в правой части окна. Например, укажите название компании, ФИО менеджера и нажмите '''Вывести'''.
# Если клиент не найден, то нажмите F3 и в окне новой записи заполните вкладки '''Основное''', '''Реквизиты''' и '''Финансы'''.
# Перейдите на вкладку '''Заказы''' и создайте новый [[Работа с заказами#Карточка заказа|заказ]].
# В главном меню выберите '''Связь''' > '''Импорт БД из Excel'''. Откроется окно «Импорт из Excel»:[[Файл:Импорт из эксель.png|none]]
# В поле '''Формат''' выберите шаблон импорта.
# В поле '''Заказ''' укажите номер созданного заказа или выберите его из списка по кнопке [[Файл:More.png]]. В этот заказ будут загружены данные файла.
# В поле '''Файл''' нажмите на кнопку [[Файл:More.png]] справа и укажите путь к файлу MS Excel с информацией о заказах.
# Нажмите '''Старт''', чтобы начать импорт данных.

=== Загрузка из нескольких файлов ===
# Убедитесь, что в MeaSoft есть [[Клиенты и партнеры|запись клиента]], от имени которого будет создан заказ. Для этого перейдите на вкладку '''Клиенты''' и используйте поиск в правой части окна. Например, укажите название компании, ФИО менеджера и нажмите '''Вывести'''.
# Если клиент не найден, то нажмите F3 и в окне новой записи заполните вкладки '''Основное''', '''Реквизиты''' и '''Финансы'''.
# В главном меню выберите '''Связь''' > '''Импорт БД из папки'''. Откроется окно «Импорт из папки»:[[Файл:Importfromfolder.png|none]]
# В поле '''Папка''' нажмите на кнопку [[Файл:More.png]] справа и укажите укажите путь к папке с нужными Excel-файлами. Убедитесь, что в папке хранятся только файлы с заказами. Система не проверяет содержимое файлов.
# В поле '''Клиент''' укажите название клиента, для которого будет создан заказ. В поле работает автозаполнение при вводе.
# В списке '''Шаблон''' выберите шаблон импорта для обработки первого файла в списке. Для удобства рекомендуем в названии Excel-файлов писать название подходящего шаблона или клиента.
# Нажмите '''Загрузить'''. Система обработает первый файл и уберет его из списка, в панели внизу отобразится отчет о количестве обработанных записей.
# Если в списке остались элементы, повторите действия, начиная с пункта 4, для следующего файла.

== Шаблон как отдельный файл ==
Вы можете сохранить шаблон в отдельный XML-файл. Или загрузить шаблон в систему из XML-файла.
{{Note|При выгрузке и загрузке шаблона система не копирует настройки на вкладке '''Услуги'''. Укажите эти настройки вручную после импорта шаблона.}}

=== Сохранить шаблон в файл ===
# Перейдите в '''Связь''' → '''Импорт БД из Excel''' → '''Шаблоны'''.
# Выберите шаблон для выгрузки и кликните на нем правой кнопкой мыши.
# Нажмите '''Сохранить в файл'''.
# Выберите папку и нажмите '''Сохранить'''.

Сохранение шаблона:
[[Файл:Vlog 12_1.png|center|300px]]

=== Добавить в систему шаблон из файла ===
# Перейдите в '''Связь''' → '''Импорт БД из Excel''' → '''Шаблоны'''.
# Выберите шаблон для выгрузки и кликните на нем правой кнопкой мыши.
# Нажмите '''Добавить из файла'''.
# Выберите XML-файл шаблона и нажмите '''Открыть'''.

Загрузка шаблона:
[[Файл:Vlog 12_2.png|center|300px]]

== Пример создания простого шаблона для загрузки вложений ==
{{Note|Пример построения простого шаблона рассмотрен в этой статье в целях обучения и для возможности самостоятельного создания шаблона пользователем. В случае необходимости создания сложного шаблона для клиента, который включает в себя сложные модификаторы формул, процедуры преобразования типов и множество прочих нюансов - следует обращаться с вопросами в техническую поддержку (желательно с файлом реестра Вашего клиента и описанием желаемых требований для его загрузки в MeaSoft).}}

Для импорта базы рассылки в формате Microsoft Excel необходимо сделать заказ (вкладка основного окна программы '''«Заказы»'''), в который будет производиться импорт. Затем, в главном меню основного окна программы выберите пункт меню '''«Связь» → «Импорт БД из Excel»''' (необходимо наличие прав создания почтовых заказов). Откроется окно следующего вида:

[[Файл:vlog 1.png|none]]

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

[[Файл:vlog 2.png|none]]

Чтобы редактировать шаблон, нажмите на кнопку '''Шаблоны'''. Можно использовать существующий шаблон или же создать новый путём нажатия клавиши F3.

Шаблон состоит из заголовка, который включает в себя название шаблона, порядковый номер первой загружаемой строки в таблице, а также условие загрузки каждой конкретной строки (номер первой строки и условие загрузки могут задаваться формулами), и строк описания значений, помещаемых в каждое конкретное поле базы данных адресов. Строка состоит из названия поля в БД по-английски и описания по-русски, значения по умолчанию, и значения ячейки. Если поле '''значение''' пустое — программа использует значение поля '''значение по умолчанию'''. Поля «значение» и «значение по умолчанию» описывают преобразования данных на внутреннем языке формул (описание языка приведено по ссылке [http://wiki.courierexe.ru/index.php/Руководство_программиста]).

Процесс импорта реестра заказов из Microsoft Excel в систему будет выполнен на примере построения шаблона с именем '''«пример»'''. На рисунке ниже изображено содержимое таблицы Microsoft Excel с заказами клиента:

[[Файл:vlog_3.png|none|1000px]]

В данном реестре мы видим, что заказы № 1-3 имеют одного и того же получателя, поэтому для удобства выполнения их можно объединить в одну единицу корреспонденции. Такая же ситуация с заказами № 4-6.

Примечание: На рисунке выше, поля столбцов по горизонтали нумеруются буквами латинского алфавита (A-N), однако данное представление в пакете MS Office может отличаться от привычного и иметь цифровую нумерацию (R1C1). На рисунке ниже представлено меню настроек (включение/отключение) в программе Microsoft Excel для стиля ссылок R1C1. Для работы с цифровым представлением столбцов Microsoft Excel — соответствие цифровой нумерации буквенной происходит путем простого преобразования: номер цифры = порядковому номеру буквы алфавита (1-‘A’, 2-‘B’, 3-‘C’ и т. д.):

[[Файл:vlog 4.png|none]]

'''Примечание:''' Обработка программой реестра заказов из файла происходит с первого листа документа, поэтому таблица заказов должна находиться на первой странице.

Редактирование старых и создание новых шаблонов доступно по нажатию на кнопку '''«Шаблоны…»''' в окне '''«Импорт из Excel»'''. Буквенные соответствия столбцов таблицы указаны напротив ячеек с названием. На рисунке ниже показано окно редактирования шаблона с именем '''«пример»'''.

Для поля '''«Адрес получателя»''' указано значение с функцией '''MakeAddress'''(буква столбца с адресом из реестра в Excel файле). Функция '''MakeAddress'''(e) — помогает и позволяет синтактически более точно преобразовывать адрес получателя путем его многократного преобразования и приведения к внутреннему стандарту программы. Параметры преобразования адреса можно задать путем нажатия кнопки '''«Автозамена…»''' в окне '''«Импорт из Excel»'''.

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

[[Файл:vlog 5.png|none]]

В данном примере мы видим, что первой строкой, из которой программа начнёт считывать данные, является строка под номером 10. Условием загрузки является то, что ячейка ‘d’ (Контактное лицо (Ф.И.О.)) не равна своему же значению из предыдущей строки. Если равно, то такая строка будет считаться вложением к предыдущей строке. Вложения необходимы для того, чтобы можно было объединять несколько единиц корреспонденции в одну карточку при выполнении заданных условий (в нашем случае таким условием является то, что получателем корреспонденции является одно и то же лицо по одному и тому же адресу).

Для работы с вложениями необходимо перейти во вкладку '''«Дополнительно»''' и в окне '''«Скрипт после загрузки (используйте %zakaz% как код загружаемого заказа)»''' ввести следующий скрипт (первая строка должна быть пустой):

Query update address a join
(select b.address, sum(b.kol_vo*b.price) as price, sum(b.kol_vo*b.mass) as mass,
sum(b.kol_vo) as kol_vo
from address a join boxes b on b.address=a.code
where a.zakaz=%zakaz%
group by b.address) b on a.code=b.address
set
a.kol_vo=b.kol_vo,
a.rur=b.price,
a.mass=CalcAddressMass(a.code)
WHERE NOT EXISTS (SELECT r.code FROM boxes bb JOIN `returns` r ON r.box=bb.code WHERE bb.address=a.code) and a.date_put is null

[[Файл:vlog 6.png|none]]

Этот скрипт необходим для суммирования значений переменных '''«количество»''', '''«масса»''' и '''«цена»''' вложений в карточке корреспонденции.

Далее переходим во вкладку '''«Вложения»''':

[[Файл:vlog 7.png|none]]

Ставим галку '''«Загружать вложения»'''.

Условием загрузки в данном примере является то, что ячейка ‘d’ не пустая. Наименование вложения будет браться из ячейки ‘h’.

Поле '''«Код товара»''' используется как артикул в [[Модуль складского учета#Карточка товара|номенклатуре поставщика]] (актуально при использовании модуля складского учёта). В нашем случае оно пустое.

Каждое из полей в настройке шаблона соответствует определенному полю в карточке единицы корреспонденции, показанному на рисунке ниже. Заполнение полей шаблона «пример» происходит в соответствии со структурой и содержимым ячеек реестра в Excel файле. Поля на вкладке '''«Получатель»''' единицы корреспонденции заполняются следующим образом:

[[Файл:vlog 8.png|none]]

* Значения ячейеек ‘m’, ‘g’, ‘i’ в карточке корреспонденции будут суммироваться согласно своим значениям во вложениях.

Поля на вкладке '''«Вложения»''' единицы корреспонденции заполнятся так:

[[Файл:vlog 9.png|none]]

После создания и редактирования нового шаблона становится возможным автоматическая загрузка заказов из файла Excel. Для этого в окне '''«Импорт из Excel»''', последовательно указываем тип шаблона для обработки реестра заказов в Excel, номер заказа и файл реестра. По нажатию на кнопку '''«Cтарт»''' происходит последовательная обработка строк из файла Excel, ячейки которой считываются в базу данных заказов программы. Процесс завершения обработки сопровождается информационным сообщением содержащим статистику обработки записей:

[[Файл:vlog 10.png|none]]

Из результата импорта видно, что программа обработала 6 записей из файла реестра Excel, которые были объеденены в 2 карточки корреспонденции согласно заданных в шаблоне условий.
После этого мы можем перейти во вкладку '''«Адреса»''' где можно просмотреть те единицы корреспонденции, которые были импортированы в заказ (в данном случае это заказ № 120340) и продолжить работу в программе:

[[Файл:vlog_11.png|none|1000px]]

== Примеры модификаций содержимого ячеек при помощи формул ==
Иногда для приведения содержимого ячеек Excel к стандартному типу, который будет понятен программе, следует воспользоваться [[Руководство программиста|специальными функциями]]. Простые примеры применения функций рассмотрены ниже.

'''1.'''Пример содержимого ячейки Excel «F»: «Россия, Москва, Горького ул., д. 23»

Задача: Копировать из ячейки слово «Москва».

Решение: '''PARAM(replace(f, ' ', ','), 2)'''

Комментарий: Делим строку разделителями пробелов на параметры и читаем второй параметр. На выходе получаем «Москва».

'''2.'''Пример содержимого ячейки Excel «J»: «с 11 до 18»

Задача А: приведение строки к стандартному типу времени ЧЧ:ММ (например, для времени доставки). Необходимо к значению времени «11» добавить значение «:00».

Решение: '''LEFT(REMSPACE(replace(J, 'с', '')), 2)+':00''''

Комментарий: Поиском слева ищем в строке значение «c», после читаем второй параметр, разделенный символом пробел — число «11», затем к нему прибавляем значение «:00». На выходе получаем «11:00».

Задача Б: приведение строки к стандартному типу времени ЧЧ:ММ (например, для времени доставки). Необходимо к значению времени «18» добавить значение «:00».

Решение: '''RIGHT(J, 2)+':00''''

Комментарий: Копируем справа от начала строки 2 символа — значение «18», затем к нему прибавляем значение «:00». На выходе получаем «18:00».

'''3.'''Пример содержимого ячейки Excel «A»: «'забор груза'», либо «'забор'»

Задача: Определять при чтении содержимого ячейки забор или доставку. В случае наличия слова «'забор груза'», либо «'забор'» — подставлять в ячейку цифру «0»,
иначе подставлять следующий порядковый номер.

Решение: '''if((C='забор груза')+(C='забор'), 0, GetNewNumber)'''

Комментарий: При помощи условия if и логического ИЛИ выполняем проверку, если условие соблюдается — подставиться значение «0», если не соблюдается — подставлять следующий порядковый номер (функция GetNewNumber).

'''4.'''Пример содержимого ячейки Excel «K» -«забрать документы», содержимого ячейки Excel «L» — «поставить печать»:

Задача: сложить одержимое двух ячеек для загрузки поля «поручение курьера».

Решение: '''k+', '+l'''

Комментарий: Выполняем сложение содержимого двух ячеек «K» и «L», разделенного запятой и пробелом. На выходе получаем «забрать документы, поставить печать».

'''5.'''Пример содержимого ячейки «масса, грамм» в Excel «N»: «2500»

Задача: Перевод значения ячейки «масса» из грамм в килограмм.

Решение: '''n/1000'''

Комментарий: Выполняем операцию деления. На выходе получаем значение для поля масса "2.5 ".

'''6.'''Пример расчета сроков доставки

Задача: Рассчитать планируемую дату доставки на основе [[Тарифы клиентов|сроков доставки]]

Решение: '''CalcDeliveryDate(ZakazRecord.source, Mode, TownTo, TownFrom, ZakazRecord.date_beg)'''

Комментарий: Вызываем функцию CalcTownDeliveryDate которая рассчитывает дату планируемой доставки по таблице сроков. В функцию передаем : ZakazRecord.date_beg — дата заказа, к ней будет добавлено найденное количество дней на доставку. ZakazRecord.source — код клиента, по нему будет найден тариф с указанными сроками. Mode — режим срочности. TownTo, TownFrom — коды городов отправителя и получателя.
Примечание:
функция CalcDeliveryDate до версии 804, имела имя CalcTownDeliveryDate

Файл:Importfromfolder.png

2022-05-26T08:38:54Z

Olga: Olga загрузила новую версию Файл:Importfromfolder.png

Импорт баз данных

2022-05-26T08:20:25Z

Olga: /* Загрузка из одного файла */

== Логика загрузки заказов ==

Для загрузки заказов из MS Excel в MeaSoft используются шаблоны.

Шаблон описывает соответствие между столбцами таблицы Excel и параметрами заказа в системе. Например, в файле Excel в столбце H указан телефон получателя. Шаблон нужен, чтобы перенести значение из столбца H в параметр заказа «Телефон получателя».

В системе нет готовых шаблонов. Как правило, шаблоны каждой курьерской службы уникальны. Содержимое шаблона зависит от формата данных во входящих Excel-файлах.

В процессе импорта система может выполнить обработку отдельных значений. Для этого добавьте в шаблон выражение на внутреннем языке разработки. Подробнее см. в статье [[Руководство программиста|«Руководство программиста»]]. Например, рекомендуем приводить адрес доставки к внутреннему формату системы.

MeaSoft поддерживает импорт из всех форматов данных, которые предоставляет Excel. Подробнее см. [https://support.office.com/ru-ru/article/поддерживаемые-excel-форматы-файлов-0943ff2c-6014-4e8d-aaea-b83d51d46247 на официальном сайте Microsoft Office].

== Создание шаблона загрузки ==
Чтобы создать шаблон:
# Перейдите в '''Связь''' > '''Импорт БД из Excel''', затем в окне «Импорт из Excel» нажмите на кнопку '''Шаблоны'''. Откроется окно со списком шаблонов.
# Нажмите на кнопку F3. Откроется окно «Шаблон загрузки»:[[Файл:Vlog 5.png|none]]

Для загрузки по шаблону достаточно настроить вкладку '''Основное'''. Настройка остальных вкладок необязательна и зависит от формата заказов в Excel-файле.

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

'''Поля вкладки «Основное»'''

'''Название'''. Укажите название шаблона.

'''Личный шаблон'''. Если флажок установлен, другие пользователи не могут редактировать шаблон. Личный шаблон может изменить его владелец или администратор системы.

'''Первая строка'''. Укажите номер первой строки с заказом в таблице Excel. Не указывайте номер строки с заголовком таблицы. Например, если в шаблоне первая строка это заголовок таблицы и поле '''Условие загрузки''' пустое, то система создаст заказ на основе заголовка таблицы.

'''Условие загрузки'''. Дополнительное условие, значение — логическое выражение на [[Руководство программиста|внутреннем языке разработки]]. <rspoiler text ="Посмотреть примеры условий"> <p><nowiki>A!''</nowiki></p> <p>A!'Итого'</p> <p>A!A(-1)</p> </rspoiler>. Во время чтения таблицы система проверяет каждую строку по указанному условию:
* условие выполнено — формируется новый заказ из строки;
* условие не выполнено — пропускает строку и переходит к следующей.

'''Адрес не пустой'''. Если флажок установлен, заказы создаются только из строк с заполненным адресом.

'''Контролировать уникальность шифра'''. Если флажок установлен, нельзя создавать заказ с шифром, который уже есть в системе.

'''Только в недоставленных'''. Если флажок установлен, не нужно проверять уникальность шифра среди доставленной корреспонденции.

'''Идентификация отправителя'''. Выберите параметр, по которому будет определяться отпавитель. Возможные значения: '''Нет''', '''Юр. лицо''', '''ИНН''', '''ID'''.

'''Столбец''' и '''Строка'''. Укажите столбец и строку с информацией об отправителе.

'''Пересчитать стоимость после загрузки'''. Если флажок установлен, стоимость доставки пересчитывается после завершения загрузки из файла.

В таблице настройте соответствие столбцов в Excel с параметрами заказа в системе. Столбцы в таблице:
* '''Поле''' — внутреннее имя параметра заказа;
* '''Название''' — название параметра в MeaSoft;
* '''По умолчанию''' — значение параметра, если столбец «Значение» пустой;
* '''Значение''' — значение параметра. Укажите буквенное обозначение столбца в Excel. Система использует значение из указанного столбца текущей строки. Чтобы отредактировать исходное значение, используйте внутренний язык разработки. Например, в Excel фамилия, имя и отчество получателя указаны в отдельных столбцах: A, B и C. MeaSoft хранит эти данные в одном параметре «ФИО получателя» (name). Чтобы сложить значения из трех столбцов в один параметр, для ФИО получателя укажите следующее: «A+' '+B+' '+C».

Для параметра '''Адрес получателя''' используйте значение вида «MakeAddress(буква столбца)». Такой подход преобразует адрес во внутренний формат системы.

== Как указать лист с заказами в Excel-файле ==
По умолчанию система ищет информацию о товарах на первом листе Excel-файла. Эту логику можно изменить вручную. Для этого:
# Откройте существующий шаблон на редактирование или добавьте новый шаблон.
# Перейдите на вкладку '''Дополнительно'''.
# В поле '''Скрипт до загрузки''' напишите формулу:
<?>
SetSheet(х);

В указанной формуле х — это номер листа с заказами в Excel-файле. Замените х на подходящее число.

== Как загрузить заказы ==

=== Загрузка из одного файла ===
# Убедитесь, что в MeaSoft есть [[Клиенты и партнеры|запись клиента]], от имени которого будет создан заказ. Для этого перейдите на вкладку '''Клиенты''' и используйте поиск в правой части окна. Например, укажите название компании, ФИО менеджера и нажмите '''Вывести'''.
# Если клиент не найден, то нажмите '''F3''' и в окне новой записи заполните вкладки '''Основное''', '''Реквизиты''' и '''Финансы'''.
# Перейдите на вкладку '''Заказы''' и создайте новый [[Работа с заказами#Карточка заказа|заказ]].
# В главном меню выберите '''Связь''' > '''Импорт БД из Excel'''. Откроется окно «Импорт из Excel»:[[Файл:Импорт из эксель.png|none]]
# В поле '''Формат''' выберите шаблон импорта.
# В поле '''Заказ''' укажите номер созданного заказа или выберите его из списка по кнопке [[Файл:More.png]]. В этот заказ будут загружены данные файла.
# В поле '''Файл''' нажмите на кнопку [[Файл:More.png]] справа и укажите путь к файлу MS Excel с информацией о заказах.
# Нажмите '''Старт''', чтобы начать импорт данных.

=== Загрузка из нескольких файлов ===
# Убедитесь, что в систему добавлен нужный клиент. Для этого перейдите на вкладку '''Клиенты''' и используйте поиск в правой части окна. Например, укажите название '''Компании''', '''ФИО''' менеджера и нажмите '''Вывести'''.
# Если клиент не найден, то нажмите '''F3''', чтобы добавить нового. В открывшемся окне обязательно заполните вкладки '''Основное''', '''Реквизиты''' и '''Финансы'''. Их подробное описание см. в статье [[Клиенты и партнеры]].
# Укажите '''Папку''' с нужными Excel-файлами. Убедитесь, что в папке хранятся только файлы с заказами. Система не проверяет содержимое файлов.
# Укажите '''Клиента''', для которого система создаст новый заказ.
# Выберите '''Шаблон''' импорта для обработки первого файлу в списке. Для удобства рекомендуем в названии Excel-файлов писать название подходящего шаблона или клиента.
# Нажмите '''Загрузить'''. Система обработает первый файл и уберет его из списка.
# Если в списке остались элементы, то вернитесь на пункт 2 и повторите действия для следующего файла.

Форма импорта из нескольких файлов:
[[Файл:Importfromfolder.png|center|500px]]

== Шаблон как отдельный файл ==
Вы можете сохранить шаблон в отдельный XML-файл. Или загрузить шаблон в систему из XML-файла.
{{Note|При выгрузке и загрузке шаблона система не копирует настройки на вкладке '''Услуги'''. Укажите эти настройки вручную после импорта шаблона.}}

=== Сохранить шаблон в файл ===
# Перейдите в '''Связь''' → '''Импорт БД из Excel''' → '''Шаблоны'''.
# Выберите шаблон для выгрузки и кликните на нем правой кнопкой мыши.
# Нажмите '''Сохранить в файл'''.
# Выберите папку и нажмите '''Сохранить'''.

Сохранение шаблона:
[[Файл:Vlog 12_1.png|center|300px]]

=== Добавить в систему шаблон из файла ===
# Перейдите в '''Связь''' → '''Импорт БД из Excel''' → '''Шаблоны'''.
# Выберите шаблон для выгрузки и кликните на нем правой кнопкой мыши.
# Нажмите '''Добавить из файла'''.
# Выберите XML-файл шаблона и нажмите '''Открыть'''.

Загрузка шаблона:
[[Файл:Vlog 12_2.png|center|300px]]

== Пример создания простого шаблона для загрузки вложений ==
{{Note|Пример построения простого шаблона рассмотрен в этой статье в целях обучения и для возможности самостоятельного создания шаблона пользователем. В случае необходимости создания сложного шаблона для клиента, который включает в себя сложные модификаторы формул, процедуры преобразования типов и множество прочих нюансов - следует обращаться с вопросами в техническую поддержку (желательно с файлом реестра Вашего клиента и описанием желаемых требований для его загрузки в MeaSoft).}}

Для импорта базы рассылки в формате Microsoft Excel необходимо сделать заказ (вкладка основного окна программы '''«Заказы»'''), в который будет производиться импорт. Затем, в главном меню основного окна программы выберите пункт меню '''«Связь» → «Импорт БД из Excel»''' (необходимо наличие прав создания почтовых заказов). Откроется окно следующего вида:

[[Файл:vlog 1.png|none]]

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

[[Файл:vlog 2.png|none]]

Чтобы редактировать шаблон, нажмите на кнопку '''Шаблоны'''. Можно использовать существующий шаблон или же создать новый путём нажатия клавиши F3.

Шаблон состоит из заголовка, который включает в себя название шаблона, порядковый номер первой загружаемой строки в таблице, а также условие загрузки каждой конкретной строки (номер первой строки и условие загрузки могут задаваться формулами), и строк описания значений, помещаемых в каждое конкретное поле базы данных адресов. Строка состоит из названия поля в БД по-английски и описания по-русски, значения по умолчанию, и значения ячейки. Если поле '''значение''' пустое — программа использует значение поля '''значение по умолчанию'''. Поля «значение» и «значение по умолчанию» описывают преобразования данных на внутреннем языке формул (описание языка приведено по ссылке [http://wiki.courierexe.ru/index.php/Руководство_программиста]).

Процесс импорта реестра заказов из Microsoft Excel в систему будет выполнен на примере построения шаблона с именем '''«пример»'''. На рисунке ниже изображено содержимое таблицы Microsoft Excel с заказами клиента:

[[Файл:vlog_3.png|none|1000px]]

В данном реестре мы видим, что заказы № 1-3 имеют одного и того же получателя, поэтому для удобства выполнения их можно объединить в одну единицу корреспонденции. Такая же ситуация с заказами № 4-6.

Примечание: На рисунке выше, поля столбцов по горизонтали нумеруются буквами латинского алфавита (A-N), однако данное представление в пакете MS Office может отличаться от привычного и иметь цифровую нумерацию (R1C1). На рисунке ниже представлено меню настроек (включение/отключение) в программе Microsoft Excel для стиля ссылок R1C1. Для работы с цифровым представлением столбцов Microsoft Excel — соответствие цифровой нумерации буквенной происходит путем простого преобразования: номер цифры = порядковому номеру буквы алфавита (1-‘A’, 2-‘B’, 3-‘C’ и т. д.):

[[Файл:vlog 4.png|none]]

'''Примечание:''' Обработка программой реестра заказов из файла происходит с первого листа документа, поэтому таблица заказов должна находиться на первой странице.

Редактирование старых и создание новых шаблонов доступно по нажатию на кнопку '''«Шаблоны…»''' в окне '''«Импорт из Excel»'''. Буквенные соответствия столбцов таблицы указаны напротив ячеек с названием. На рисунке ниже показано окно редактирования шаблона с именем '''«пример»'''.

Для поля '''«Адрес получателя»''' указано значение с функцией '''MakeAddress'''(буква столбца с адресом из реестра в Excel файле). Функция '''MakeAddress'''(e) — помогает и позволяет синтактически более точно преобразовывать адрес получателя путем его многократного преобразования и приведения к внутреннему стандарту программы. Параметры преобразования адреса можно задать путем нажатия кнопки '''«Автозамена…»''' в окне '''«Импорт из Excel»'''.

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

[[Файл:vlog 5.png|none]]

В данном примере мы видим, что первой строкой, из которой программа начнёт считывать данные, является строка под номером 10. Условием загрузки является то, что ячейка ‘d’ (Контактное лицо (Ф.И.О.)) не равна своему же значению из предыдущей строки. Если равно, то такая строка будет считаться вложением к предыдущей строке. Вложения необходимы для того, чтобы можно было объединять несколько единиц корреспонденции в одну карточку при выполнении заданных условий (в нашем случае таким условием является то, что получателем корреспонденции является одно и то же лицо по одному и тому же адресу).

Для работы с вложениями необходимо перейти во вкладку '''«Дополнительно»''' и в окне '''«Скрипт после загрузки (используйте %zakaz% как код загружаемого заказа)»''' ввести следующий скрипт (первая строка должна быть пустой):

Query update address a join
(select b.address, sum(b.kol_vo*b.price) as price, sum(b.kol_vo*b.mass) as mass,
sum(b.kol_vo) as kol_vo
from address a join boxes b on b.address=a.code
where a.zakaz=%zakaz%
group by b.address) b on a.code=b.address
set
a.kol_vo=b.kol_vo,
a.rur=b.price,
a.mass=CalcAddressMass(a.code)
WHERE NOT EXISTS (SELECT r.code FROM boxes bb JOIN `returns` r ON r.box=bb.code WHERE bb.address=a.code) and a.date_put is null

[[Файл:vlog 6.png|none]]

Этот скрипт необходим для суммирования значений переменных '''«количество»''', '''«масса»''' и '''«цена»''' вложений в карточке корреспонденции.

Далее переходим во вкладку '''«Вложения»''':

[[Файл:vlog 7.png|none]]

Ставим галку '''«Загружать вложения»'''.

Условием загрузки в данном примере является то, что ячейка ‘d’ не пустая. Наименование вложения будет браться из ячейки ‘h’.

Поле '''«Код товара»''' используется как артикул в [[Модуль складского учета#Карточка товара|номенклатуре поставщика]] (актуально при использовании модуля складского учёта). В нашем случае оно пустое.

Каждое из полей в настройке шаблона соответствует определенному полю в карточке единицы корреспонденции, показанному на рисунке ниже. Заполнение полей шаблона «пример» происходит в соответствии со структурой и содержимым ячеек реестра в Excel файле. Поля на вкладке '''«Получатель»''' единицы корреспонденции заполняются следующим образом:

[[Файл:vlog 8.png|none]]

* Значения ячейеек ‘m’, ‘g’, ‘i’ в карточке корреспонденции будут суммироваться согласно своим значениям во вложениях.

Поля на вкладке '''«Вложения»''' единицы корреспонденции заполнятся так:

[[Файл:vlog 9.png|none]]

После создания и редактирования нового шаблона становится возможным автоматическая загрузка заказов из файла Excel. Для этого в окне '''«Импорт из Excel»''', последовательно указываем тип шаблона для обработки реестра заказов в Excel, номер заказа и файл реестра. По нажатию на кнопку '''«Cтарт»''' происходит последовательная обработка строк из файла Excel, ячейки которой считываются в базу данных заказов программы. Процесс завершения обработки сопровождается информационным сообщением содержащим статистику обработки записей:

[[Файл:vlog 10.png|none]]

Из результата импорта видно, что программа обработала 6 записей из файла реестра Excel, которые были объеденены в 2 карточки корреспонденции согласно заданных в шаблоне условий.
После этого мы можем перейти во вкладку '''«Адреса»''' где можно просмотреть те единицы корреспонденции, которые были импортированы в заказ (в данном случае это заказ № 120340) и продолжить работу в программе:

[[Файл:vlog_11.png|none|1000px]]

== Примеры модификаций содержимого ячеек при помощи формул ==
Иногда для приведения содержимого ячеек Excel к стандартному типу, который будет понятен программе, следует воспользоваться [[Руководство программиста|специальными функциями]]. Простые примеры применения функций рассмотрены ниже.

'''1.'''Пример содержимого ячейки Excel «F»: «Россия, Москва, Горького ул., д. 23»

Задача: Копировать из ячейки слово «Москва».

Решение: '''PARAM(replace(f, ' ', ','), 2)'''

Комментарий: Делим строку разделителями пробелов на параметры и читаем второй параметр. На выходе получаем «Москва».

'''2.'''Пример содержимого ячейки Excel «J»: «с 11 до 18»

Задача А: приведение строки к стандартному типу времени ЧЧ:ММ (например, для времени доставки). Необходимо к значению времени «11» добавить значение «:00».

Решение: '''LEFT(REMSPACE(replace(J, 'с', '')), 2)+':00''''

Комментарий: Поиском слева ищем в строке значение «c», после читаем второй параметр, разделенный символом пробел — число «11», затем к нему прибавляем значение «:00». На выходе получаем «11:00».

Задача Б: приведение строки к стандартному типу времени ЧЧ:ММ (например, для времени доставки). Необходимо к значению времени «18» добавить значение «:00».

Решение: '''RIGHT(J, 2)+':00''''

Комментарий: Копируем справа от начала строки 2 символа — значение «18», затем к нему прибавляем значение «:00». На выходе получаем «18:00».

'''3.'''Пример содержимого ячейки Excel «A»: «'забор груза'», либо «'забор'»

Задача: Определять при чтении содержимого ячейки забор или доставку. В случае наличия слова «'забор груза'», либо «'забор'» — подставлять в ячейку цифру «0»,
иначе подставлять следующий порядковый номер.

Решение: '''if((C='забор груза')+(C='забор'), 0, GetNewNumber)'''

Комментарий: При помощи условия if и логического ИЛИ выполняем проверку, если условие соблюдается — подставиться значение «0», если не соблюдается — подставлять следующий порядковый номер (функция GetNewNumber).

'''4.'''Пример содержимого ячейки Excel «K» -«забрать документы», содержимого ячейки Excel «L» — «поставить печать»:

Задача: сложить одержимое двух ячеек для загрузки поля «поручение курьера».

Решение: '''k+', '+l'''

Комментарий: Выполняем сложение содержимого двух ячеек «K» и «L», разделенного запятой и пробелом. На выходе получаем «забрать документы, поставить печать».

'''5.'''Пример содержимого ячейки «масса, грамм» в Excel «N»: «2500»

Задача: Перевод значения ячейки «масса» из грамм в килограмм.

Решение: '''n/1000'''

Комментарий: Выполняем операцию деления. На выходе получаем значение для поля масса "2.5 ".

'''6.'''Пример расчета сроков доставки

Задача: Рассчитать планируемую дату доставки на основе [[Тарифы клиентов|сроков доставки]]

Решение: '''CalcDeliveryDate(ZakazRecord.source, Mode, TownTo, TownFrom, ZakazRecord.date_beg)'''

Комментарий: Вызываем функцию CalcTownDeliveryDate которая рассчитывает дату планируемой доставки по таблице сроков. В функцию передаем : ZakazRecord.date_beg — дата заказа, к ней будет добавлено найденное количество дней на доставку. ZakazRecord.source — код клиента, по нему будет найден тариф с указанными сроками. Mode — режим срочности. TownTo, TownFrom — коды городов отправителя и получателя.
Примечание:
функция CalcDeliveryDate до версии 804, имела имя CalcTownDeliveryDate

Импорт баз данных

2022-05-26T08:19:30Z

Olga: /* Загрузка из одного файла */

== Логика загрузки заказов ==

Для загрузки заказов из MS Excel в MeaSoft используются шаблоны.

Шаблон описывает соответствие между столбцами таблицы Excel и параметрами заказа в системе. Например, в файле Excel в столбце H указан телефон получателя. Шаблон нужен, чтобы перенести значение из столбца H в параметр заказа «Телефон получателя».

В системе нет готовых шаблонов. Как правило, шаблоны каждой курьерской службы уникальны. Содержимое шаблона зависит от формата данных во входящих Excel-файлах.

В процессе импорта система может выполнить обработку отдельных значений. Для этого добавьте в шаблон выражение на внутреннем языке разработки. Подробнее см. в статье [[Руководство программиста|«Руководство программиста»]]. Например, рекомендуем приводить адрес доставки к внутреннему формату системы.

MeaSoft поддерживает импорт из всех форматов данных, которые предоставляет Excel. Подробнее см. [https://support.office.com/ru-ru/article/поддерживаемые-excel-форматы-файлов-0943ff2c-6014-4e8d-aaea-b83d51d46247 на официальном сайте Microsoft Office].

== Создание шаблона загрузки ==
Чтобы создать шаблон:
# Перейдите в '''Связь''' > '''Импорт БД из Excel''', затем в окне «Импорт из Excel» нажмите на кнопку '''Шаблоны'''. Откроется окно со списком шаблонов.
# Нажмите на кнопку F3. Откроется окно «Шаблон загрузки»:[[Файл:Vlog 5.png|none]]

Для загрузки по шаблону достаточно настроить вкладку '''Основное'''. Настройка остальных вкладок необязательна и зависит от формата заказов в Excel-файле.

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

'''Поля вкладки «Основное»'''

'''Название'''. Укажите название шаблона.

'''Личный шаблон'''. Если флажок установлен, другие пользователи не могут редактировать шаблон. Личный шаблон может изменить его владелец или администратор системы.

'''Первая строка'''. Укажите номер первой строки с заказом в таблице Excel. Не указывайте номер строки с заголовком таблицы. Например, если в шаблоне первая строка это заголовок таблицы и поле '''Условие загрузки''' пустое, то система создаст заказ на основе заголовка таблицы.

'''Условие загрузки'''. Дополнительное условие, значение — логическое выражение на [[Руководство программиста|внутреннем языке разработки]]. <rspoiler text ="Посмотреть примеры условий"> <p><nowiki>A!''</nowiki></p> <p>A!'Итого'</p> <p>A!A(-1)</p> </rspoiler>. Во время чтения таблицы система проверяет каждую строку по указанному условию:
* условие выполнено — формируется новый заказ из строки;
* условие не выполнено — пропускает строку и переходит к следующей.

'''Адрес не пустой'''. Если флажок установлен, заказы создаются только из строк с заполненным адресом.

'''Контролировать уникальность шифра'''. Если флажок установлен, нельзя создавать заказ с шифром, который уже есть в системе.

'''Только в недоставленных'''. Если флажок установлен, не нужно проверять уникальность шифра среди доставленной корреспонденции.

'''Идентификация отправителя'''. Выберите параметр, по которому будет определяться отпавитель. Возможные значения: '''Нет''', '''Юр. лицо''', '''ИНН''', '''ID'''.

'''Столбец''' и '''Строка'''. Укажите столбец и строку с информацией об отправителе.

'''Пересчитать стоимость после загрузки'''. Если флажок установлен, стоимость доставки пересчитывается после завершения загрузки из файла.

В таблице настройте соответствие столбцов в Excel с параметрами заказа в системе. Столбцы в таблице:
* '''Поле''' — внутреннее имя параметра заказа;
* '''Название''' — название параметра в MeaSoft;
* '''По умолчанию''' — значение параметра, если столбец «Значение» пустой;
* '''Значение''' — значение параметра. Укажите буквенное обозначение столбца в Excel. Система использует значение из указанного столбца текущей строки. Чтобы отредактировать исходное значение, используйте внутренний язык разработки. Например, в Excel фамилия, имя и отчество получателя указаны в отдельных столбцах: A, B и C. MeaSoft хранит эти данные в одном параметре «ФИО получателя» (name). Чтобы сложить значения из трех столбцов в один параметр, для ФИО получателя укажите следующее: «A+' '+B+' '+C».

Для параметра '''Адрес получателя''' используйте значение вида «MakeAddress(буква столбца)». Такой подход преобразует адрес во внутренний формат системы.

== Как указать лист с заказами в Excel-файле ==
По умолчанию система ищет информацию о товарах на первом листе Excel-файла. Эту логику можно изменить вручную. Для этого:
# Откройте существующий шаблон на редактирование или добавьте новый шаблон.
# Перейдите на вкладку '''Дополнительно'''.
# В поле '''Скрипт до загрузки''' напишите формулу:
<?>
SetSheet(х);

В указанной формуле х — это номер листа с заказами в Excel-файле. Замените х на подходящее число.

== Как загрузить заказы ==

=== Загрузка из одного файла ===
# Убедитесь, что в MeaSoft есть [[Клиенты и партнеры|запись заказчика]]. Для этого перейдите на вкладку '''Клиенты''' и используйте поиск в правой части окна. Например, укажите название компании, ФИО менеджера и нажмите '''Вывести'''.
# Если клиент не найден, то нажмите '''F3''' и в окне новой записи заполните вкладки '''Основное''', '''Реквизиты''' и '''Финансы'''.
# Перейдите на вкладку '''Заказы''' и создайте новый [[Работа с заказами#Карточка заказа|заказ]].
# В главном меню выберите '''Связь''' > '''Импорт БД из Excel'''. Откроется окно «Импорт из Excel»:[[Файл:Импорт из эксель.png|none]]
# В поле '''Формат''' выберите шаблон импорта.
# В поле '''Заказ''' укажите номер созданного заказа или выберите его из списка по кнопке [[Файл:More.png]]. В этот заказ будут загружены данные файла.
# В поле '''Файл''' нажмите на кнопку [[Файл:More.png]] справа и укажите путь к файлу MS Excel с информацией о заказах.
# Нажмите '''Старт''', чтобы начать импорт данных.

=== Загрузка из нескольких файлов ===
# Убедитесь, что в систему добавлен нужный клиент. Для этого перейдите на вкладку '''Клиенты''' и используйте поиск в правой части окна. Например, укажите название '''Компании''', '''ФИО''' менеджера и нажмите '''Вывести'''.
# Если клиент не найден, то нажмите '''F3''', чтобы добавить нового. В открывшемся окне обязательно заполните вкладки '''Основное''', '''Реквизиты''' и '''Финансы'''. Их подробное описание см. в статье [[Клиенты и партнеры]].
# Укажите '''Папку''' с нужными Excel-файлами. Убедитесь, что в папке хранятся только файлы с заказами. Система не проверяет содержимое файлов.
# Укажите '''Клиента''', для которого система создаст новый заказ.
# Выберите '''Шаблон''' импорта для обработки первого файлу в списке. Для удобства рекомендуем в названии Excel-файлов писать название подходящего шаблона или клиента.
# Нажмите '''Загрузить'''. Система обработает первый файл и уберет его из списка.
# Если в списке остались элементы, то вернитесь на пункт 2 и повторите действия для следующего файла.

Форма импорта из нескольких файлов:
[[Файл:Importfromfolder.png|center|500px]]

== Шаблон как отдельный файл ==
Вы можете сохранить шаблон в отдельный XML-файл. Или загрузить шаблон в систему из XML-файла.
{{Note|При выгрузке и загрузке шаблона система не копирует настройки на вкладке '''Услуги'''. Укажите эти настройки вручную после импорта шаблона.}}

=== Сохранить шаблон в файл ===
# Перейдите в '''Связь''' → '''Импорт БД из Excel''' → '''Шаблоны'''.
# Выберите шаблон для выгрузки и кликните на нем правой кнопкой мыши.
# Нажмите '''Сохранить в файл'''.
# Выберите папку и нажмите '''Сохранить'''.

Сохранение шаблона:
[[Файл:Vlog 12_1.png|center|300px]]

=== Добавить в систему шаблон из файла ===
# Перейдите в '''Связь''' → '''Импорт БД из Excel''' → '''Шаблоны'''.
# Выберите шаблон для выгрузки и кликните на нем правой кнопкой мыши.
# Нажмите '''Добавить из файла'''.
# Выберите XML-файл шаблона и нажмите '''Открыть'''.

Загрузка шаблона:
[[Файл:Vlog 12_2.png|center|300px]]

== Пример создания простого шаблона для загрузки вложений ==
{{Note|Пример построения простого шаблона рассмотрен в этой статье в целях обучения и для возможности самостоятельного создания шаблона пользователем. В случае необходимости создания сложного шаблона для клиента, который включает в себя сложные модификаторы формул, процедуры преобразования типов и множество прочих нюансов - следует обращаться с вопросами в техническую поддержку (желательно с файлом реестра Вашего клиента и описанием желаемых требований для его загрузки в MeaSoft).}}

Для импорта базы рассылки в формате Microsoft Excel необходимо сделать заказ (вкладка основного окна программы '''«Заказы»'''), в который будет производиться импорт. Затем, в главном меню основного окна программы выберите пункт меню '''«Связь» → «Импорт БД из Excel»''' (необходимо наличие прав создания почтовых заказов). Откроется окно следующего вида:

[[Файл:vlog 1.png|none]]

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

[[Файл:vlog 2.png|none]]

Чтобы редактировать шаблон, нажмите на кнопку '''Шаблоны'''. Можно использовать существующий шаблон или же создать новый путём нажатия клавиши F3.

Шаблон состоит из заголовка, который включает в себя название шаблона, порядковый номер первой загружаемой строки в таблице, а также условие загрузки каждой конкретной строки (номер первой строки и условие загрузки могут задаваться формулами), и строк описания значений, помещаемых в каждое конкретное поле базы данных адресов. Строка состоит из названия поля в БД по-английски и описания по-русски, значения по умолчанию, и значения ячейки. Если поле '''значение''' пустое — программа использует значение поля '''значение по умолчанию'''. Поля «значение» и «значение по умолчанию» описывают преобразования данных на внутреннем языке формул (описание языка приведено по ссылке [http://wiki.courierexe.ru/index.php/Руководство_программиста]).

Процесс импорта реестра заказов из Microsoft Excel в систему будет выполнен на примере построения шаблона с именем '''«пример»'''. На рисунке ниже изображено содержимое таблицы Microsoft Excel с заказами клиента:

[[Файл:vlog_3.png|none|1000px]]

В данном реестре мы видим, что заказы № 1-3 имеют одного и того же получателя, поэтому для удобства выполнения их можно объединить в одну единицу корреспонденции. Такая же ситуация с заказами № 4-6.

Примечание: На рисунке выше, поля столбцов по горизонтали нумеруются буквами латинского алфавита (A-N), однако данное представление в пакете MS Office может отличаться от привычного и иметь цифровую нумерацию (R1C1). На рисунке ниже представлено меню настроек (включение/отключение) в программе Microsoft Excel для стиля ссылок R1C1. Для работы с цифровым представлением столбцов Microsoft Excel — соответствие цифровой нумерации буквенной происходит путем простого преобразования: номер цифры = порядковому номеру буквы алфавита (1-‘A’, 2-‘B’, 3-‘C’ и т. д.):

[[Файл:vlog 4.png|none]]

'''Примечание:''' Обработка программой реестра заказов из файла происходит с первого листа документа, поэтому таблица заказов должна находиться на первой странице.

Редактирование старых и создание новых шаблонов доступно по нажатию на кнопку '''«Шаблоны…»''' в окне '''«Импорт из Excel»'''. Буквенные соответствия столбцов таблицы указаны напротив ячеек с названием. На рисунке ниже показано окно редактирования шаблона с именем '''«пример»'''.

Для поля '''«Адрес получателя»''' указано значение с функцией '''MakeAddress'''(буква столбца с адресом из реестра в Excel файле). Функция '''MakeAddress'''(e) — помогает и позволяет синтактически более точно преобразовывать адрес получателя путем его многократного преобразования и приведения к внутреннему стандарту программы. Параметры преобразования адреса можно задать путем нажатия кнопки '''«Автозамена…»''' в окне '''«Импорт из Excel»'''.

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

[[Файл:vlog 5.png|none]]

В данном примере мы видим, что первой строкой, из которой программа начнёт считывать данные, является строка под номером 10. Условием загрузки является то, что ячейка ‘d’ (Контактное лицо (Ф.И.О.)) не равна своему же значению из предыдущей строки. Если равно, то такая строка будет считаться вложением к предыдущей строке. Вложения необходимы для того, чтобы можно было объединять несколько единиц корреспонденции в одну карточку при выполнении заданных условий (в нашем случае таким условием является то, что получателем корреспонденции является одно и то же лицо по одному и тому же адресу).

Для работы с вложениями необходимо перейти во вкладку '''«Дополнительно»''' и в окне '''«Скрипт после загрузки (используйте %zakaz% как код загружаемого заказа)»''' ввести следующий скрипт (первая строка должна быть пустой):

Query update address a join
(select b.address, sum(b.kol_vo*b.price) as price, sum(b.kol_vo*b.mass) as mass,
sum(b.kol_vo) as kol_vo
from address a join boxes b on b.address=a.code
where a.zakaz=%zakaz%
group by b.address) b on a.code=b.address
set
a.kol_vo=b.kol_vo,
a.rur=b.price,
a.mass=CalcAddressMass(a.code)
WHERE NOT EXISTS (SELECT r.code FROM boxes bb JOIN `returns` r ON r.box=bb.code WHERE bb.address=a.code) and a.date_put is null

[[Файл:vlog 6.png|none]]

Этот скрипт необходим для суммирования значений переменных '''«количество»''', '''«масса»''' и '''«цена»''' вложений в карточке корреспонденции.

Далее переходим во вкладку '''«Вложения»''':

[[Файл:vlog 7.png|none]]

Ставим галку '''«Загружать вложения»'''.

Условием загрузки в данном примере является то, что ячейка ‘d’ не пустая. Наименование вложения будет браться из ячейки ‘h’.

Поле '''«Код товара»''' используется как артикул в [[Модуль складского учета#Карточка товара|номенклатуре поставщика]] (актуально при использовании модуля складского учёта). В нашем случае оно пустое.

Каждое из полей в настройке шаблона соответствует определенному полю в карточке единицы корреспонденции, показанному на рисунке ниже. Заполнение полей шаблона «пример» происходит в соответствии со структурой и содержимым ячеек реестра в Excel файле. Поля на вкладке '''«Получатель»''' единицы корреспонденции заполняются следующим образом:

[[Файл:vlog 8.png|none]]

* Значения ячейеек ‘m’, ‘g’, ‘i’ в карточке корреспонденции будут суммироваться согласно своим значениям во вложениях.

Поля на вкладке '''«Вложения»''' единицы корреспонденции заполнятся так:

[[Файл:vlog 9.png|none]]

После создания и редактирования нового шаблона становится возможным автоматическая загрузка заказов из файла Excel. Для этого в окне '''«Импорт из Excel»''', последовательно указываем тип шаблона для обработки реестра заказов в Excel, номер заказа и файл реестра. По нажатию на кнопку '''«Cтарт»''' происходит последовательная обработка строк из файла Excel, ячейки которой считываются в базу данных заказов программы. Процесс завершения обработки сопровождается информационным сообщением содержащим статистику обработки записей:

[[Файл:vlog 10.png|none]]

Из результата импорта видно, что программа обработала 6 записей из файла реестра Excel, которые были объеденены в 2 карточки корреспонденции согласно заданных в шаблоне условий.
После этого мы можем перейти во вкладку '''«Адреса»''' где можно просмотреть те единицы корреспонденции, которые были импортированы в заказ (в данном случае это заказ № 120340) и продолжить работу в программе:

[[Файл:vlog_11.png|none|1000px]]

== Примеры модификаций содержимого ячеек при помощи формул ==
Иногда для приведения содержимого ячеек Excel к стандартному типу, который будет понятен программе, следует воспользоваться [[Руководство программиста|специальными функциями]]. Простые примеры применения функций рассмотрены ниже.

'''1.'''Пример содержимого ячейки Excel «F»: «Россия, Москва, Горького ул., д. 23»

Задача: Копировать из ячейки слово «Москва».

Решение: '''PARAM(replace(f, ' ', ','), 2)'''

Комментарий: Делим строку разделителями пробелов на параметры и читаем второй параметр. На выходе получаем «Москва».

'''2.'''Пример содержимого ячейки Excel «J»: «с 11 до 18»

Задача А: приведение строки к стандартному типу времени ЧЧ:ММ (например, для времени доставки). Необходимо к значению времени «11» добавить значение «:00».

Решение: '''LEFT(REMSPACE(replace(J, 'с', '')), 2)+':00''''

Комментарий: Поиском слева ищем в строке значение «c», после читаем второй параметр, разделенный символом пробел — число «11», затем к нему прибавляем значение «:00». На выходе получаем «11:00».

Задача Б: приведение строки к стандартному типу времени ЧЧ:ММ (например, для времени доставки). Необходимо к значению времени «18» добавить значение «:00».

Решение: '''RIGHT(J, 2)+':00''''

Комментарий: Копируем справа от начала строки 2 символа — значение «18», затем к нему прибавляем значение «:00». На выходе получаем «18:00».

'''3.'''Пример содержимого ячейки Excel «A»: «'забор груза'», либо «'забор'»

Задача: Определять при чтении содержимого ячейки забор или доставку. В случае наличия слова «'забор груза'», либо «'забор'» — подставлять в ячейку цифру «0»,
иначе подставлять следующий порядковый номер.

Решение: '''if((C='забор груза')+(C='забор'), 0, GetNewNumber)'''

Комментарий: При помощи условия if и логического ИЛИ выполняем проверку, если условие соблюдается — подставиться значение «0», если не соблюдается — подставлять следующий порядковый номер (функция GetNewNumber).

'''4.'''Пример содержимого ячейки Excel «K» -«забрать документы», содержимого ячейки Excel «L» — «поставить печать»:

Задача: сложить одержимое двух ячеек для загрузки поля «поручение курьера».

Решение: '''k+', '+l'''

Комментарий: Выполняем сложение содержимого двух ячеек «K» и «L», разделенного запятой и пробелом. На выходе получаем «забрать документы, поставить печать».

'''5.'''Пример содержимого ячейки «масса, грамм» в Excel «N»: «2500»

Задача: Перевод значения ячейки «масса» из грамм в килограмм.

Решение: '''n/1000'''

Комментарий: Выполняем операцию деления. На выходе получаем значение для поля масса "2.5 ".

'''6.'''Пример расчета сроков доставки

Задача: Рассчитать планируемую дату доставки на основе [[Тарифы клиентов|сроков доставки]]

Решение: '''CalcDeliveryDate(ZakazRecord.source, Mode, TownTo, TownFrom, ZakazRecord.date_beg)'''

Комментарий: Вызываем функцию CalcTownDeliveryDate которая рассчитывает дату планируемой доставки по таблице сроков. В функцию передаем : ZakazRecord.date_beg — дата заказа, к ней будет добавлено найденное количество дней на доставку. ZakazRecord.source — код клиента, по нему будет найден тариф с указанными сроками. Mode — режим срочности. TownTo, TownFrom — коды городов отправителя и получателя.
Примечание:
функция CalcDeliveryDate до версии 804, имела имя CalcTownDeliveryDate

Файл:Импорт из эксель.png

2022-05-26T08:11:21Z

Olga:

Импорт баз данных

2022-05-25T14:48:23Z

Olga: /* Создание шаблона */

== Логика загрузки заказов ==

Для загрузки заказов из MS Excel в MeaSoft используются шаблоны.

Шаблон описывает соответствие между столбцами таблицы Excel и параметрами заказа в системе. Например, в файле Excel в столбце H указан телефон получателя. Шаблон нужен, чтобы перенести значение из столбца H в параметр заказа «Телефон получателя».

В системе нет готовых шаблонов. Как правило, шаблоны каждой курьерской службы уникальны. Содержимое шаблона зависит от формата данных во входящих Excel-файлах.

В процессе импорта система может выполнить обработку отдельных значений. Для этого добавьте в шаблон выражение на внутреннем языке разработки. Подробнее см. в статье [[Руководство программиста|«Руководство программиста»]]. Например, рекомендуем приводить адрес доставки к внутреннему формату системы.

MeaSoft поддерживает импорт из всех форматов данных, которые предоставляет Excel. Подробнее см. [https://support.office.com/ru-ru/article/поддерживаемые-excel-форматы-файлов-0943ff2c-6014-4e8d-aaea-b83d51d46247 на официальном сайте Microsoft Office].

== Создание шаблона загрузки ==
Чтобы создать шаблон:
# Перейдите в '''Связь''' > '''Импорт БД из Excel''', затем в окне «Импорт из Excel» нажмите на кнопку '''Шаблоны'''. Откроется окно со списком шаблонов.
# Нажмите на кнопку F3. Откроется окно «Шаблон загрузки»:[[Файл:Vlog 5.png|none]]

Для загрузки по шаблону достаточно настроить вкладку '''Основное'''. Настройка остальных вкладок необязательна и зависит от формата заказов в Excel-файле.

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

'''Поля вкладки «Основное»'''

'''Название'''. Укажите название шаблона.

'''Личный шаблон'''. Если флажок установлен, другие пользователи не могут редактировать шаблон. Личный шаблон может изменить его владелец или администратор системы.

'''Первая строка'''. Укажите номер первой строки с заказом в таблице Excel. Не указывайте номер строки с заголовком таблицы. Например, если в шаблоне первая строка это заголовок таблицы и поле '''Условие загрузки''' пустое, то система создаст заказ на основе заголовка таблицы.

'''Условие загрузки'''. Дополнительное условие, значение — логическое выражение на [[Руководство программиста|внутреннем языке разработки]]. <rspoiler text ="Посмотреть примеры условий"> <p><nowiki>A!''</nowiki></p> <p>A!'Итого'</p> <p>A!A(-1)</p> </rspoiler>. Во время чтения таблицы система проверяет каждую строку по указанному условию:
* условие выполнено — формируется новый заказ из строки;
* условие не выполнено — пропускает строку и переходит к следующей.

'''Адрес не пустой'''. Если флажок установлен, заказы создаются только из строк с заполненным адресом.

'''Контролировать уникальность шифра'''. Если флажок установлен, нельзя создавать заказ с шифром, который уже есть в системе.

'''Только в недоставленных'''. Если флажок установлен, не нужно проверять уникальность шифра среди доставленной корреспонденции.

'''Идентификация отправителя'''. Выберите параметр, по которому будет определяться отпавитель. Возможные значения: '''Нет''', '''Юр. лицо''', '''ИНН''', '''ID'''.

'''Столбец''' и '''Строка'''. Укажите столбец и строку с информацией об отправителе.

'''Пересчитать стоимость после загрузки'''. Если флажок установлен, стоимость доставки пересчитывается после завершения загрузки из файла.

В таблице настройте соответствие столбцов в Excel с параметрами заказа в системе. Столбцы в таблице:
* '''Поле''' — внутреннее имя параметра заказа;
* '''Название''' — название параметра в MeaSoft;
* '''По умолчанию''' — значение параметра, если столбец «Значение» пустой;
* '''Значение''' — значение параметра. Укажите буквенное обозначение столбца в Excel. Система использует значение из указанного столбца текущей строки. Чтобы отредактировать исходное значение, используйте внутренний язык разработки. Например, в Excel фамилия, имя и отчество получателя указаны в отдельных столбцах: A, B и C. MeaSoft хранит эти данные в одном параметре «ФИО получателя» (name). Чтобы сложить значения из трех столбцов в один параметр, для ФИО получателя укажите следующее: «A+' '+B+' '+C».

Для параметра '''Адрес получателя''' используйте значение вида «MakeAddress(буква столбца)». Такой подход преобразует адрес во внутренний формат системы.

== Как указать лист с заказами в Excel-файле ==
По умолчанию система ищет информацию о товарах на первом листе Excel-файла. Эту логику можно изменить вручную. Для этого:
# Откройте существующий шаблон на редактирование или добавьте новый шаблон.
# Перейдите на вкладку '''Дополнительно'''.
# В поле '''Скрипт до загрузки''' напишите формулу:
<?>
SetSheet(х);

В указанной формуле х — это номер листа с заказами в Excel-файле. Замените х на подходящее число.

== Как загрузить заказы ==

=== Загрузка из одного файла ===
# Убедитесь, что в систему добавлен нужный клиент. Для этого перейдите на вкладку '''Клиенты''' и используйте поиск в правой части окна. Например, укажите название '''Компании''', '''ФИО''' менеджера и нажмите '''Вывести'''.
# Если клиент не найден, то нажмите '''F3''', чтобы добавить нового. В открывшемся окне обязательно заполните вкладки '''Основное''', '''Реквизиты''' и '''Финансы'''. Их подробное описание см. в статье [[Клиенты и партнеры]].
# Перейдите на вкладку '''Заказы''' и нажмите '''F3''', чтобы создать новый заказ. Система откроет окно Информация о заказе.
# Укажите '''Заказчика'''. В поле работает автозаполнение: введите часть значения и нажмите '''Tab''', когда предложено подходящее. Система автоматически заполнит часть полей, используя информацию о клиенте.
# Выберите '''Тип заказа'''.
# Нажмите '''OK''', чтобы создать заказ.
# В верхнем меню выберите '''Связь''' → '''Импорт БД из Excel'''.
# В поле '''Формат''' выберите шаблон импорта.
# Укажите созданный '''Заказ'''.
# Выберите '''Файл''' Excel с информацией о заказах.
# Нажмите '''Старт''', чтобы начать импорт данных.

Форма импорта заказов:
[[Файл:Import.png|center|500px]]

=== Загрузка из нескольких файлов ===
# Убедитесь, что в систему добавлен нужный клиент. Для этого перейдите на вкладку '''Клиенты''' и используйте поиск в правой части окна. Например, укажите название '''Компании''', '''ФИО''' менеджера и нажмите '''Вывести'''.
# Если клиент не найден, то нажмите '''F3''', чтобы добавить нового. В открывшемся окне обязательно заполните вкладки '''Основное''', '''Реквизиты''' и '''Финансы'''. Их подробное описание см. в статье [[Клиенты и партнеры]].
# Укажите '''Папку''' с нужными Excel-файлами. Убедитесь, что в папке хранятся только файлы с заказами. Система не проверяет содержимое файлов.
# Укажите '''Клиента''', для которого система создаст новый заказ.
# Выберите '''Шаблон''' импорта для обработки первого файлу в списке. Для удобства рекомендуем в названии Excel-файлов писать название подходящего шаблона или клиента.
# Нажмите '''Загрузить'''. Система обработает первый файл и уберет его из списка.
# Если в списке остались элементы, то вернитесь на пункт 2 и повторите действия для следующего файла.

Форма импорта из нескольких файлов:
[[Файл:Importfromfolder.png|center|500px]]

== Шаблон как отдельный файл ==
Вы можете сохранить шаблон в отдельный XML-файл. Или загрузить шаблон в систему из XML-файла.
{{Note|При выгрузке и загрузке шаблона система не копирует настройки на вкладке '''Услуги'''. Укажите эти настройки вручную после импорта шаблона.}}

=== Сохранить шаблон в файл ===
# Перейдите в '''Связь''' → '''Импорт БД из Excel''' → '''Шаблоны'''.
# Выберите шаблон для выгрузки и кликните на нем правой кнопкой мыши.
# Нажмите '''Сохранить в файл'''.
# Выберите папку и нажмите '''Сохранить'''.

Сохранение шаблона:
[[Файл:Vlog 12_1.png|center|300px]]

=== Добавить в систему шаблон из файла ===
# Перейдите в '''Связь''' → '''Импорт БД из Excel''' → '''Шаблоны'''.
# Выберите шаблон для выгрузки и кликните на нем правой кнопкой мыши.
# Нажмите '''Добавить из файла'''.
# Выберите XML-файл шаблона и нажмите '''Открыть'''.

Загрузка шаблона:
[[Файл:Vlog 12_2.png|center|300px]]

== Пример создания простого шаблона для загрузки вложений ==
{{Note|Пример построения простого шаблона рассмотрен в этой статье в целях обучения и для возможности самостоятельного создания шаблона пользователем. В случае необходимости создания сложного шаблона для клиента, который включает в себя сложные модификаторы формул, процедуры преобразования типов и множество прочих нюансов - следует обращаться с вопросами в техническую поддержку (желательно с файлом реестра Вашего клиента и описанием желаемых требований для его загрузки в MeaSoft).}}

Для импорта базы рассылки в формате Microsoft Excel необходимо сделать заказ (вкладка основного окна программы '''«Заказы»'''), в который будет производиться импорт. Затем, в главном меню основного окна программы выберите пункт меню '''«Связь» → «Импорт БД из Excel»''' (необходимо наличие прав создания почтовых заказов). Откроется окно следующего вида:

[[Файл:vlog 1.png|none]]

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

[[Файл:vlog 2.png|none]]

Чтобы редактировать шаблон, нажмите на кнопку '''Шаблоны'''. Можно использовать существующий шаблон или же создать новый путём нажатия клавиши F3.

Шаблон состоит из заголовка, который включает в себя название шаблона, порядковый номер первой загружаемой строки в таблице, а также условие загрузки каждой конкретной строки (номер первой строки и условие загрузки могут задаваться формулами), и строк описания значений, помещаемых в каждое конкретное поле базы данных адресов. Строка состоит из названия поля в БД по-английски и описания по-русски, значения по умолчанию, и значения ячейки. Если поле '''значение''' пустое — программа использует значение поля '''значение по умолчанию'''. Поля «значение» и «значение по умолчанию» описывают преобразования данных на внутреннем языке формул (описание языка приведено по ссылке [http://wiki.courierexe.ru/index.php/Руководство_программиста]).

Процесс импорта реестра заказов из Microsoft Excel в систему будет выполнен на примере построения шаблона с именем '''«пример»'''. На рисунке ниже изображено содержимое таблицы Microsoft Excel с заказами клиента:

[[Файл:vlog_3.png|none|1000px]]

В данном реестре мы видим, что заказы № 1-3 имеют одного и того же получателя, поэтому для удобства выполнения их можно объединить в одну единицу корреспонденции. Такая же ситуация с заказами № 4-6.

Примечание: На рисунке выше, поля столбцов по горизонтали нумеруются буквами латинского алфавита (A-N), однако данное представление в пакете MS Office может отличаться от привычного и иметь цифровую нумерацию (R1C1). На рисунке ниже представлено меню настроек (включение/отключение) в программе Microsoft Excel для стиля ссылок R1C1. Для работы с цифровым представлением столбцов Microsoft Excel — соответствие цифровой нумерации буквенной происходит путем простого преобразования: номер цифры = порядковому номеру буквы алфавита (1-‘A’, 2-‘B’, 3-‘C’ и т. д.):

[[Файл:vlog 4.png|none]]

'''Примечание:''' Обработка программой реестра заказов из файла происходит с первого листа документа, поэтому таблица заказов должна находиться на первой странице.

Редактирование старых и создание новых шаблонов доступно по нажатию на кнопку '''«Шаблоны…»''' в окне '''«Импорт из Excel»'''. Буквенные соответствия столбцов таблицы указаны напротив ячеек с названием. На рисунке ниже показано окно редактирования шаблона с именем '''«пример»'''.

Для поля '''«Адрес получателя»''' указано значение с функцией '''MakeAddress'''(буква столбца с адресом из реестра в Excel файле). Функция '''MakeAddress'''(e) — помогает и позволяет синтактически более точно преобразовывать адрес получателя путем его многократного преобразования и приведения к внутреннему стандарту программы. Параметры преобразования адреса можно задать путем нажатия кнопки '''«Автозамена…»''' в окне '''«Импорт из Excel»'''.

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

[[Файл:vlog 5.png|none]]

В данном примере мы видим, что первой строкой, из которой программа начнёт считывать данные, является строка под номером 10. Условием загрузки является то, что ячейка ‘d’ (Контактное лицо (Ф.И.О.)) не равна своему же значению из предыдущей строки. Если равно, то такая строка будет считаться вложением к предыдущей строке. Вложения необходимы для того, чтобы можно было объединять несколько единиц корреспонденции в одну карточку при выполнении заданных условий (в нашем случае таким условием является то, что получателем корреспонденции является одно и то же лицо по одному и тому же адресу).

Для работы с вложениями необходимо перейти во вкладку '''«Дополнительно»''' и в окне '''«Скрипт после загрузки (используйте %zakaz% как код загружаемого заказа)»''' ввести следующий скрипт (первая строка должна быть пустой):

Query update address a join
(select b.address, sum(b.kol_vo*b.price) as price, sum(b.kol_vo*b.mass) as mass,
sum(b.kol_vo) as kol_vo
from address a join boxes b on b.address=a.code
where a.zakaz=%zakaz%
group by b.address) b on a.code=b.address
set
a.kol_vo=b.kol_vo,
a.rur=b.price,
a.mass=CalcAddressMass(a.code)
WHERE NOT EXISTS (SELECT r.code FROM boxes bb JOIN `returns` r ON r.box=bb.code WHERE bb.address=a.code) and a.date_put is null

[[Файл:vlog 6.png|none]]

Этот скрипт необходим для суммирования значений переменных '''«количество»''', '''«масса»''' и '''«цена»''' вложений в карточке корреспонденции.

Далее переходим во вкладку '''«Вложения»''':

[[Файл:vlog 7.png|none]]

Ставим галку '''«Загружать вложения»'''.

Условием загрузки в данном примере является то, что ячейка ‘d’ не пустая. Наименование вложения будет браться из ячейки ‘h’.

Поле '''«Код товара»''' используется как артикул в [[Модуль складского учета#Карточка товара|номенклатуре поставщика]] (актуально при использовании модуля складского учёта). В нашем случае оно пустое.

Каждое из полей в настройке шаблона соответствует определенному полю в карточке единицы корреспонденции, показанному на рисунке ниже. Заполнение полей шаблона «пример» происходит в соответствии со структурой и содержимым ячеек реестра в Excel файле. Поля на вкладке '''«Получатель»''' единицы корреспонденции заполняются следующим образом:

[[Файл:vlog 8.png|none]]

* Значения ячейеек ‘m’, ‘g’, ‘i’ в карточке корреспонденции будут суммироваться согласно своим значениям во вложениях.

Поля на вкладке '''«Вложения»''' единицы корреспонденции заполнятся так:

[[Файл:vlog 9.png|none]]

После создания и редактирования нового шаблона становится возможным автоматическая загрузка заказов из файла Excel. Для этого в окне '''«Импорт из Excel»''', последовательно указываем тип шаблона для обработки реестра заказов в Excel, номер заказа и файл реестра. По нажатию на кнопку '''«Cтарт»''' происходит последовательная обработка строк из файла Excel, ячейки которой считываются в базу данных заказов программы. Процесс завершения обработки сопровождается информационным сообщением содержащим статистику обработки записей:

[[Файл:vlog 10.png|none]]

Из результата импорта видно, что программа обработала 6 записей из файла реестра Excel, которые были объеденены в 2 карточки корреспонденции согласно заданных в шаблоне условий.
После этого мы можем перейти во вкладку '''«Адреса»''' где можно просмотреть те единицы корреспонденции, которые были импортированы в заказ (в данном случае это заказ № 120340) и продолжить работу в программе:

[[Файл:vlog_11.png|none|1000px]]

== Примеры модификаций содержимого ячеек при помощи формул ==
Иногда для приведения содержимого ячеек Excel к стандартному типу, который будет понятен программе, следует воспользоваться [[Руководство программиста|специальными функциями]]. Простые примеры применения функций рассмотрены ниже.

'''1.'''Пример содержимого ячейки Excel «F»: «Россия, Москва, Горького ул., д. 23»

Задача: Копировать из ячейки слово «Москва».

Решение: '''PARAM(replace(f, ' ', ','), 2)'''

Комментарий: Делим строку разделителями пробелов на параметры и читаем второй параметр. На выходе получаем «Москва».

'''2.'''Пример содержимого ячейки Excel «J»: «с 11 до 18»

Задача А: приведение строки к стандартному типу времени ЧЧ:ММ (например, для времени доставки). Необходимо к значению времени «11» добавить значение «:00».

Решение: '''LEFT(REMSPACE(replace(J, 'с', '')), 2)+':00''''

Комментарий: Поиском слева ищем в строке значение «c», после читаем второй параметр, разделенный символом пробел — число «11», затем к нему прибавляем значение «:00». На выходе получаем «11:00».

Задача Б: приведение строки к стандартному типу времени ЧЧ:ММ (например, для времени доставки). Необходимо к значению времени «18» добавить значение «:00».

Решение: '''RIGHT(J, 2)+':00''''

Комментарий: Копируем справа от начала строки 2 символа — значение «18», затем к нему прибавляем значение «:00». На выходе получаем «18:00».

'''3.'''Пример содержимого ячейки Excel «A»: «'забор груза'», либо «'забор'»

Задача: Определять при чтении содержимого ячейки забор или доставку. В случае наличия слова «'забор груза'», либо «'забор'» — подставлять в ячейку цифру «0»,
иначе подставлять следующий порядковый номер.

Решение: '''if((C='забор груза')+(C='забор'), 0, GetNewNumber)'''

Комментарий: При помощи условия if и логического ИЛИ выполняем проверку, если условие соблюдается — подставиться значение «0», если не соблюдается — подставлять следующий порядковый номер (функция GetNewNumber).

'''4.'''Пример содержимого ячейки Excel «K» -«забрать документы», содержимого ячейки Excel «L» — «поставить печать»:

Задача: сложить одержимое двух ячеек для загрузки поля «поручение курьера».

Решение: '''k+', '+l'''

Комментарий: Выполняем сложение содержимого двух ячеек «K» и «L», разделенного запятой и пробелом. На выходе получаем «забрать документы, поставить печать».

'''5.'''Пример содержимого ячейки «масса, грамм» в Excel «N»: «2500»

Задача: Перевод значения ячейки «масса» из грамм в килограмм.

Решение: '''n/1000'''

Комментарий: Выполняем операцию деления. На выходе получаем значение для поля масса "2.5 ".

'''6.'''Пример расчета сроков доставки

Задача: Рассчитать планируемую дату доставки на основе [[Тарифы клиентов|сроков доставки]]

Решение: '''CalcDeliveryDate(ZakazRecord.source, Mode, TownTo, TownFrom, ZakazRecord.date_beg)'''

Комментарий: Вызываем функцию CalcTownDeliveryDate которая рассчитывает дату планируемой доставки по таблице сроков. В функцию передаем : ZakazRecord.date_beg — дата заказа, к ней будет добавлено найденное количество дней на доставку. ZakazRecord.source — код клиента, по нему будет найден тариф с указанными сроками. Mode — режим срочности. TownTo, TownFrom — коды городов отправителя и получателя.
Примечание:
функция CalcDeliveryDate до версии 804, имела имя CalcTownDeliveryDate

Файл:Vlog 5.png

2022-05-25T13:54:34Z

Olga: Olga загрузила новую версию Файл:Vlog 5.png

Импорт баз данных

2022-05-25T13:44:40Z

Olga: /* Логика загрузки заказов */

== Логика загрузки заказов ==

Для загрузки заказов из MS Excel в MeaSoft используются шаблоны.

Шаблон описывает соответствие между столбцами таблицы Excel и параметрами заказа в системе. Например, в файле Excel в столбце H указан телефон получателя. Шаблон нужен, чтобы перенести значение из столбца H в параметр заказа «Телефон получателя».

В системе нет готовых шаблонов. Как правило, шаблоны каждой курьерской службы уникальны. Содержимое шаблона зависит от формата данных во входящих Excel-файлах.

В процессе импорта система может выполнить обработку отдельных значений. Для этого добавьте в шаблон выражение на внутреннем языке разработки. Подробнее см. в статье [[Руководство программиста|«Руководство программиста»]]. Например, рекомендуем приводить адрес доставки к внутреннему формату системы.

MeaSoft поддерживает импорт из всех форматов данных, которые предоставляет Excel. Подробнее см. [https://support.office.com/ru-ru/article/поддерживаемые-excel-форматы-файлов-0943ff2c-6014-4e8d-aaea-b83d51d46247 на официальном сайте Microsoft Office].

== Создание шаблона ==
На форме настройки шаблона есть несколько вкладок: '''Основное''', '''Места''', '''Вложения''', '''Услуги''' и '''Дополнительные'''. Для загрузки по шаблону настройте вкладку '''Основное'''. Настройка остальных вкладок необязательна и зависит от формата заказов в Excel-файле.

{{Note|Не рекомендуем самостоятельно писать скрипты на '''Дополнительных''' вкладках. Если надо изменить логику обработки заказов, то обратитесь в службу поддержки MEA Soft.}}

=== Как добавить шаблон ===
Создать шаблон загрузки может пользователь с доступом к созданию заказа. Чтобы создать шаблон:
# Перейдите в '''Связь''' → '''Импорт БД из Excel'''.
# Нажмите '''Шаблоны''' → '''F3''', чтобы добавить шаблон.
# Укажите '''Название''' шаблона.
# Включите опцию '''Личный шаблон''', чтобы другие пользователи не могли его редактировать. Личный шаблон может изменить его владелец или администратор системы.
# Укажите номер '''Первой строки''' с заказом в электронной таблице. Не указывайте номер строки с заголовком таблицы. Например, если в шаблоне '''Первая строка''' это заголовок таблицы и поле '''Условие загрузки''' пустое, то система создаст заказ на основе заголовка таблицы.
# Включите опцию '''Адрес не пустой''', чтобы система создавала заказы только из строк с указанным адресом.
# Если требуется дополнительное условие, то укажите '''Условие загрузки''' — логическое выражение на [[Руководство программиста|внутреннем языке разработки]]. <rspoiler text ="Посмотреть примеры условий"> <p><nowiki>A!''</nowiki></p> <p>A!'Итого'</p> <p>A!A(-1)</p> </rspoiler>. Во время чтения таблицы система проверяет каждую строку по указанному условию:
#* условие выполнено — система формирует новый заказ из строки;
#* условие не выполнено — система пропускает строку и переходит к следующей.
# Включите опцию '''Контролировать уникальность шифра''', чтобы пропускать заказы с шифром, который уже есть в системе.
# Включите опцию '''Только в недоставленных''', чтобы система не проверяла уникальность шифра среди доставленной корреспонденции.
# Выберите способ '''Идентификации отправителя'''. Укажите '''Столбец''' и '''Строку''' с информацией об отправителе.
# Включите опцию '''Пересчитать стоимость после загрузки''', чтобы система рассчитала стоимость доставки после завершения загрузки из файла.
# В таблице настройте соответствие столбцов в Excel с параметрами заказа в системе. Столбцы в таблице:
#* '''Поле''' — внутреннее имя параметра заказа;
#* '''Название''' параметра в MeaSoft;
#* '''По умолчанию''' — значение параметра, если столбец Значение пустой;
#* '''Значение''' параметра. Укажите буквенное обозначение столбца в Excel. Система использует значение из указанного столбца текущей строки. Чтобы отредактировать исходное значение, используйте внутренний язык разработки. Например, в Excel фамилия имя и отчество получателя указаны в отдельных столбцах: A, B и C. MeaSoft хранит эти данные в одном параметре «ФИО получателя» (name). Чтобы сложить значения из трех столбцов в один параметр, для ФИО получателя укажите следующее: «A+' '+B+' '+C».

{{Note|Для параметра '''Адрес получателя''' используйте значение вида "MakeAddress(буква столбца)". Такой подход преобразует адрес во внутренний формат системы. }}

Форма настройки шаблона:
[[Файл:Vlog 5.png|center|600px|]]

=== Как указать лист с заказами в Excel-файле ===
По умолчанию система ищет информацию о товарах на первом листе Excel-файла. Эту логику можно изменить вручную. Для этого:
# Откройте существующий шаблон на редактирование. Или добавьте новый шаблон.
# Перейдите на вкладку '''Дополнительно'''.
# В поле '''Скрипт до загрузки''' напишите формулу:
<?>
SetSheet(2);

В указанной формуле 2 это номер листа с заказами в Excel-файле. Замените 2 на подходящее вам число.

[[Файл:template_setsheet.png|center|600px|]]

== Как загрузить заказы ==

=== Загрузка из одного файла ===
# Убедитесь, что в систему добавлен нужный клиент. Для этого перейдите на вкладку '''Клиенты''' и используйте поиск в правой части окна. Например, укажите название '''Компании''', '''ФИО''' менеджера и нажмите '''Вывести'''.
# Если клиент не найден, то нажмите '''F3''', чтобы добавить нового. В открывшемся окне обязательно заполните вкладки '''Основное''', '''Реквизиты''' и '''Финансы'''. Их подробное описание см. в статье [[Клиенты и партнеры]].
# Перейдите на вкладку '''Заказы''' и нажмите '''F3''', чтобы создать новый заказ. Система откроет окно Информация о заказе.
# Укажите '''Заказчика'''. В поле работает автозаполнение: введите часть значения и нажмите '''Tab''', когда предложено подходящее. Система автоматически заполнит часть полей, используя информацию о клиенте.
# Выберите '''Тип заказа'''.
# Нажмите '''OK''', чтобы создать заказ.
# В верхнем меню выберите '''Связь''' → '''Импорт БД из Excel'''.
# В поле '''Формат''' выберите шаблон импорта.
# Укажите созданный '''Заказ'''.
# Выберите '''Файл''' Excel с информацией о заказах.
# Нажмите '''Старт''', чтобы начать импорт данных.

Форма импорта заказов:
[[Файл:Import.png|center|500px]]

=== Загрузка из нескольких файлов ===
# Убедитесь, что в систему добавлен нужный клиент. Для этого перейдите на вкладку '''Клиенты''' и используйте поиск в правой части окна. Например, укажите название '''Компании''', '''ФИО''' менеджера и нажмите '''Вывести'''.
# Если клиент не найден, то нажмите '''F3''', чтобы добавить нового. В открывшемся окне обязательно заполните вкладки '''Основное''', '''Реквизиты''' и '''Финансы'''. Их подробное описание см. в статье [[Клиенты и партнеры]].
# Укажите '''Папку''' с нужными Excel-файлами. Убедитесь, что в папке хранятся только файлы с заказами. Система не проверяет содержимое файлов.
# Укажите '''Клиента''', для которого система создаст новый заказ.
# Выберите '''Шаблон''' импорта для обработки первого файлу в списке. Для удобства рекомендуем в названии Excel-файлов писать название подходящего шаблона или клиента.
# Нажмите '''Загрузить'''. Система обработает первый файл и уберет его из списка.
# Если в списке остались элементы, то вернитесь на пункт 2 и повторите действия для следующего файла.

Форма импорта из нескольких файлов:
[[Файл:Importfromfolder.png|center|500px]]

== Шаблон как отдельный файл ==
Вы можете сохранить шаблон в отдельный XML-файл. Или загрузить шаблон в систему из XML-файла.
{{Note|При выгрузке и загрузке шаблона система не копирует настройки на вкладке '''Услуги'''. Укажите эти настройки вручную после импорта шаблона.}}

=== Сохранить шаблон в файл ===
# Перейдите в '''Связь''' → '''Импорт БД из Excel''' → '''Шаблоны'''.
# Выберите шаблон для выгрузки и кликните на нем правой кнопкой мыши.
# Нажмите '''Сохранить в файл'''.
# Выберите папку и нажмите '''Сохранить'''.

Сохранение шаблона:
[[Файл:Vlog 12_1.png|center|300px]]

=== Добавить в систему шаблон из файла ===
# Перейдите в '''Связь''' → '''Импорт БД из Excel''' → '''Шаблоны'''.
# Выберите шаблон для выгрузки и кликните на нем правой кнопкой мыши.
# Нажмите '''Добавить из файла'''.
# Выберите XML-файл шаблона и нажмите '''Открыть'''.

Загрузка шаблона:
[[Файл:Vlog 12_2.png|center|300px]]

== Пример создания простого шаблона для загрузки вложений ==
{{Note|Пример построения простого шаблона рассмотрен в этой статье в целях обучения и для возможности самостоятельного создания шаблона пользователем. В случае необходимости создания сложного шаблона для клиента, который включает в себя сложные модификаторы формул, процедуры преобразования типов и множество прочих нюансов - следует обращаться с вопросами в техническую поддержку (желательно с файлом реестра Вашего клиента и описанием желаемых требований для его загрузки в MeaSoft).}}

Для импорта базы рассылки в формате Microsoft Excel необходимо сделать заказ (вкладка основного окна программы '''«Заказы»'''), в который будет производиться импорт. Затем, в главном меню основного окна программы выберите пункт меню '''«Связь» → «Импорт БД из Excel»''' (необходимо наличие прав создания почтовых заказов). Откроется окно следующего вида:

[[Файл:vlog 1.png|none]]

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

[[Файл:vlog 2.png|none]]

Чтобы редактировать шаблон, нажмите на кнопку '''Шаблоны'''. Можно использовать существующий шаблон или же создать новый путём нажатия клавиши F3.

Шаблон состоит из заголовка, который включает в себя название шаблона, порядковый номер первой загружаемой строки в таблице, а также условие загрузки каждой конкретной строки (номер первой строки и условие загрузки могут задаваться формулами), и строк описания значений, помещаемых в каждое конкретное поле базы данных адресов. Строка состоит из названия поля в БД по-английски и описания по-русски, значения по умолчанию, и значения ячейки. Если поле '''значение''' пустое — программа использует значение поля '''значение по умолчанию'''. Поля «значение» и «значение по умолчанию» описывают преобразования данных на внутреннем языке формул (описание языка приведено по ссылке [http://wiki.courierexe.ru/index.php/Руководство_программиста]).

Процесс импорта реестра заказов из Microsoft Excel в систему будет выполнен на примере построения шаблона с именем '''«пример»'''. На рисунке ниже изображено содержимое таблицы Microsoft Excel с заказами клиента:

[[Файл:vlog_3.png|none|1000px]]

В данном реестре мы видим, что заказы № 1-3 имеют одного и того же получателя, поэтому для удобства выполнения их можно объединить в одну единицу корреспонденции. Такая же ситуация с заказами № 4-6.

Примечание: На рисунке выше, поля столбцов по горизонтали нумеруются буквами латинского алфавита (A-N), однако данное представление в пакете MS Office может отличаться от привычного и иметь цифровую нумерацию (R1C1). На рисунке ниже представлено меню настроек (включение/отключение) в программе Microsoft Excel для стиля ссылок R1C1. Для работы с цифровым представлением столбцов Microsoft Excel — соответствие цифровой нумерации буквенной происходит путем простого преобразования: номер цифры = порядковому номеру буквы алфавита (1-‘A’, 2-‘B’, 3-‘C’ и т. д.):

[[Файл:vlog 4.png|none]]

'''Примечание:''' Обработка программой реестра заказов из файла происходит с первого листа документа, поэтому таблица заказов должна находиться на первой странице.

Редактирование старых и создание новых шаблонов доступно по нажатию на кнопку '''«Шаблоны…»''' в окне '''«Импорт из Excel»'''. Буквенные соответствия столбцов таблицы указаны напротив ячеек с названием. На рисунке ниже показано окно редактирования шаблона с именем '''«пример»'''.

Для поля '''«Адрес получателя»''' указано значение с функцией '''MakeAddress'''(буква столбца с адресом из реестра в Excel файле). Функция '''MakeAddress'''(e) — помогает и позволяет синтактически более точно преобразовывать адрес получателя путем его многократного преобразования и приведения к внутреннему стандарту программы. Параметры преобразования адреса можно задать путем нажатия кнопки '''«Автозамена…»''' в окне '''«Импорт из Excel»'''.

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

[[Файл:vlog 5.png|none]]

В данном примере мы видим, что первой строкой, из которой программа начнёт считывать данные, является строка под номером 10. Условием загрузки является то, что ячейка ‘d’ (Контактное лицо (Ф.И.О.)) не равна своему же значению из предыдущей строки. Если равно, то такая строка будет считаться вложением к предыдущей строке. Вложения необходимы для того, чтобы можно было объединять несколько единиц корреспонденции в одну карточку при выполнении заданных условий (в нашем случае таким условием является то, что получателем корреспонденции является одно и то же лицо по одному и тому же адресу).

Для работы с вложениями необходимо перейти во вкладку '''«Дополнительно»''' и в окне '''«Скрипт после загрузки (используйте %zakaz% как код загружаемого заказа)»''' ввести следующий скрипт (первая строка должна быть пустой):

Query update address a join
(select b.address, sum(b.kol_vo*b.price) as price, sum(b.kol_vo*b.mass) as mass,
sum(b.kol_vo) as kol_vo
from address a join boxes b on b.address=a.code
where a.zakaz=%zakaz%
group by b.address) b on a.code=b.address
set
a.kol_vo=b.kol_vo,
a.rur=b.price,
a.mass=CalcAddressMass(a.code)
WHERE NOT EXISTS (SELECT r.code FROM boxes bb JOIN `returns` r ON r.box=bb.code WHERE bb.address=a.code) and a.date_put is null

[[Файл:vlog 6.png|none]]

Этот скрипт необходим для суммирования значений переменных '''«количество»''', '''«масса»''' и '''«цена»''' вложений в карточке корреспонденции.

Далее переходим во вкладку '''«Вложения»''':

[[Файл:vlog 7.png|none]]

Ставим галку '''«Загружать вложения»'''.

Условием загрузки в данном примере является то, что ячейка ‘d’ не пустая. Наименование вложения будет браться из ячейки ‘h’.

Поле '''«Код товара»''' используется как артикул в [[Модуль складского учета#Карточка товара|номенклатуре поставщика]] (актуально при использовании модуля складского учёта). В нашем случае оно пустое.

Каждое из полей в настройке шаблона соответствует определенному полю в карточке единицы корреспонденции, показанному на рисунке ниже. Заполнение полей шаблона «пример» происходит в соответствии со структурой и содержимым ячеек реестра в Excel файле. Поля на вкладке '''«Получатель»''' единицы корреспонденции заполняются следующим образом:

[[Файл:vlog 8.png|none]]

* Значения ячейеек ‘m’, ‘g’, ‘i’ в карточке корреспонденции будут суммироваться согласно своим значениям во вложениях.

Поля на вкладке '''«Вложения»''' единицы корреспонденции заполнятся так:

[[Файл:vlog 9.png|none]]

После создания и редактирования нового шаблона становится возможным автоматическая загрузка заказов из файла Excel. Для этого в окне '''«Импорт из Excel»''', последовательно указываем тип шаблона для обработки реестра заказов в Excel, номер заказа и файл реестра. По нажатию на кнопку '''«Cтарт»''' происходит последовательная обработка строк из файла Excel, ячейки которой считываются в базу данных заказов программы. Процесс завершения обработки сопровождается информационным сообщением содержащим статистику обработки записей:

[[Файл:vlog 10.png|none]]

Из результата импорта видно, что программа обработала 6 записей из файла реестра Excel, которые были объеденены в 2 карточки корреспонденции согласно заданных в шаблоне условий.
После этого мы можем перейти во вкладку '''«Адреса»''' где можно просмотреть те единицы корреспонденции, которые были импортированы в заказ (в данном случае это заказ № 120340) и продолжить работу в программе:

[[Файл:vlog_11.png|none|1000px]]

== Примеры модификаций содержимого ячеек при помощи формул ==
Иногда для приведения содержимого ячеек Excel к стандартному типу, который будет понятен программе, следует воспользоваться [[Руководство программиста|специальными функциями]]. Простые примеры применения функций рассмотрены ниже.

'''1.'''Пример содержимого ячейки Excel «F»: «Россия, Москва, Горького ул., д. 23»

Задача: Копировать из ячейки слово «Москва».

Решение: '''PARAM(replace(f, ' ', ','), 2)'''

Комментарий: Делим строку разделителями пробелов на параметры и читаем второй параметр. На выходе получаем «Москва».

'''2.'''Пример содержимого ячейки Excel «J»: «с 11 до 18»

Задача А: приведение строки к стандартному типу времени ЧЧ:ММ (например, для времени доставки). Необходимо к значению времени «11» добавить значение «:00».

Решение: '''LEFT(REMSPACE(replace(J, 'с', '')), 2)+':00''''

Комментарий: Поиском слева ищем в строке значение «c», после читаем второй параметр, разделенный символом пробел — число «11», затем к нему прибавляем значение «:00». На выходе получаем «11:00».

Задача Б: приведение строки к стандартному типу времени ЧЧ:ММ (например, для времени доставки). Необходимо к значению времени «18» добавить значение «:00».

Решение: '''RIGHT(J, 2)+':00''''

Комментарий: Копируем справа от начала строки 2 символа — значение «18», затем к нему прибавляем значение «:00». На выходе получаем «18:00».

'''3.'''Пример содержимого ячейки Excel «A»: «'забор груза'», либо «'забор'»

Задача: Определять при чтении содержимого ячейки забор или доставку. В случае наличия слова «'забор груза'», либо «'забор'» — подставлять в ячейку цифру «0»,
иначе подставлять следующий порядковый номер.

Решение: '''if((C='забор груза')+(C='забор'), 0, GetNewNumber)'''

Комментарий: При помощи условия if и логического ИЛИ выполняем проверку, если условие соблюдается — подставиться значение «0», если не соблюдается — подставлять следующий порядковый номер (функция GetNewNumber).

'''4.'''Пример содержимого ячейки Excel «K» -«забрать документы», содержимого ячейки Excel «L» — «поставить печать»:

Задача: сложить одержимое двух ячеек для загрузки поля «поручение курьера».

Решение: '''k+', '+l'''

Комментарий: Выполняем сложение содержимого двух ячеек «K» и «L», разделенного запятой и пробелом. На выходе получаем «забрать документы, поставить печать».

'''5.'''Пример содержимого ячейки «масса, грамм» в Excel «N»: «2500»

Задача: Перевод значения ячейки «масса» из грамм в килограмм.

Решение: '''n/1000'''

Комментарий: Выполняем операцию деления. На выходе получаем значение для поля масса "2.5 ".

'''6.'''Пример расчета сроков доставки

Задача: Рассчитать планируемую дату доставки на основе [[Тарифы клиентов|сроков доставки]]

Решение: '''CalcDeliveryDate(ZakazRecord.source, Mode, TownTo, TownFrom, ZakazRecord.date_beg)'''

Комментарий: Вызываем функцию CalcTownDeliveryDate которая рассчитывает дату планируемой доставки по таблице сроков. В функцию передаем : ZakazRecord.date_beg — дата заказа, к ней будет добавлено найденное количество дней на доставку. ZakazRecord.source — код клиента, по нему будет найден тариф с указанными сроками. Mode — режим срочности. TownTo, TownFrom — коды городов отправителя и получателя.
Примечание:
функция CalcDeliveryDate до версии 804, имела имя CalcTownDeliveryDate

Курсы валют

2022-05-25T13:30:10Z

Olga:

Вы можете вести расчеты с клиентами и сотрудниками в разных валютах.

Чтобы добавить валюту:

# Откройте '''Справочники''' > '''Статусы''' > '''32 Валюты''' и в контекстном меню выберите '''Добавить'''. Подробнее о справочнике см. раздел [[Статусы|«Статусы»]].
# Настройте написание валюты в разных склонениях для документов. Для этого выберите пункт контекстного меню '''Дополнительная информация''', в первой строке укажите через запятую обозначение и код валюты, во второй строке укажите язык написания (например, rus:) и укажите варианты наименования в различных склонениях. <br>'''Пример 1:''' <br /> грн., uah <br /> rus:гривна, гривны, гривен, 0, копейка, копейки, копеек, 0 <br /> ukr:гривна, гривны, гривен, 0, копійка, копійки, копійок, 0 <br />'''Пример 2:''' <br /> $, usd <br /> rus:доллар, доллара, долларов, 1, цент, цента, центов, 1[[Файл:Валюта.PNG|none|700px]]
# Откройте '''Справочники''' > '''Переменные''' > '''Региональные настройки''' > '''Валюта по умолчанию''' и выберите валюту по умолчанию.
# Откройте '''Справочники''' > '''Курсы валют''' и с помощью контекстного меню добавьте дату и присвойте ей курс валюты.[[Файл:Курсы_валют.PNG|none|600px]]

С помощью [[Дополнительные модули#Настройка модуля автоматизации|модуля автоматизации]] можно настроить автоматическое обновление курса валют с официального сайта Национального (Центрального) банка страны.

Работа с пунктами самовывоза (ПВЗ)

2022-05-25T11:56:15Z

Olga: /* Загрузка ПВЗ через интеграцию (СДЭК, BOXBERRY) */

== Введение ==

Пунктами самовывоза могут быть склады и филиалы курьерской службы, а также отделения партнеров курьерской службы. Получатель выбирает пункт выдачи на сайте <rspoiler text="интернет-магазина">Клиента курьерской службы</rspoiler> и узнает номер заказа или шифр его отправления. При поступлении отправления в ПВЗ получатель называет номер заказа или шифр работнику пункта или вводит данные в специальную панель и забирает корреспонденцию.

Процесс оформления корреспонденции для самовывоза описан в разделе [[Прием корреспонденции на склад#Самовывоз|«Самовывоз»]].

Информация о ПВЗ в Measoft хранится в справочнике [[Филиалы|'''Филиалы''']]. ПВЗ отображаются в выпадающем списке при вводе заказа как в офисной программе, так и в [[Личный кабинет клиента#Пункты выдачи заказов|личном кабинете]]. Это позволяет корректно указывать адреса ПВЗ.

Для отображения списка пунктов выдачи есть [https://home.courierexe.ru/js/measoft_map.js JavaScript модуль]. Инструкция по использованию — внутри. Посмотреть пример работы можно [https://home.courierexe.ru/pvz_test.html здесь].

== Пример создания корреспонденции с указанием ПВЗ ==

Чтобы при создании корреспонденции появилась возможность указать ПВЗ, в карточке корреспонденции установите флажок '''Самовывоз'''. После этого в поле '''ПВЗ''' появится список пунктов самовывоза. В списке отображаются только подчиненные филиалы, отмеченные флажком '''ПВЗ'''.

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

[[Файл:pvz014.png|700 px|none]]

== Загрузка ПВЗ через интеграцию (СДЭК, BOXBERRY) ==

Чтобы в систему загрузились ПВЗ компаний, например СДЭК или BOXBERRY, настройте с ними интеграции в соответствии с разделом [[Интеграция с другими системами#Тарификация и выбор подрядчика и его тарифа клиентом|«Тарификация и выбор подрядчика и его тарифа клиентом»]].

Обмен запросами при настроенной интеграции проходит каждые 30 минут.

Пример загруженного ПВЗ можно увидеть ниже. В карточке ПВЗ заполняется поле '''Код в филиале''' и устанавливается флажок '''Загружен из внешней системы'''.

[[Файл:pvz015.png|none]]

Чтобы клиенты не могли выбрать ПВЗ при оформлении заказа, в карточке филиала на вкладке '''Дополнительно''' установите флажок '''Не использовать подчиненные ПВЗ'''. Чтобы скрыть все подчиненные ПВЗ, установите этот флажок для родительского филиала.

== Права пользователя на просмотр заказов всех филиалов ==

В основном пункте меню '''Настройка''' > '''Пользователи''' откройте карточку пользователя и на вкладке '''Настройки''' укажите филиал, в котором он работает.

[[Файл:pvz016.png|400px|none]]

При этом он не сможет видеть заказы, в которых поле '''Отв. филиал''' отличается от филиала, указанного в карточке пользователя.

Чтобы пользователь видел заказы других филиалов, перейдите в '''Настройка''' > '''Пользователи''', выделите пользователя в окне слева и в дереве прав справа установите флажок '''Видеть данные всех филиалов'''.

В результате на вкладке '''Адреса''' в фильтре на вкладке '''Дополнительно''' для пользователя появится флажок '''Только относящиеся к моему филиалу'''. Если этот флажок снять, выполняется поиск по всем филиалам.

== Работа с ПВЗ в личном кабинете ==

[[Личный кабинет курьерской службы#Настройка полей и вкладок|Как настроить ПВЗ в личном кабинете]]

[[Личный кабинет клиента#Пункты выдачи заказов|Как работать с ПВЗ в личном кабинете]]

== Импорт из файла Excel с указанием ПВЗ ==

Чтобы автоматически распознавать ПВЗ при импорте файла Microsoft Excel из интерфейса программы ('''Связь''' > '''Импорт БД из Excel'''):

* укажите в поле '''Адрес''' в загружаемом файле наименование ПВЗ и обязательно заполните поле '''Город получателя''', т.к. у многих ПВЗ в разных городах имеются одинаковые наименования.

Перед наименованием ПВЗ добавляйте префикс «ПВЗ »:

[[Файл:pvz024.png|400px|none]]

* укажите в поле '''Адрес''' значение из поля '''Код''' [[Филиалы|карточки ПВЗ]]. В этом случае город получателя указывать необязательно, так как код ПВЗ уникален.

Пользовательские поля

2022-05-25T09:44:37Z

Olga:

Пользовательские поля отображаются на вкладке '''Пользовательская''' в карточках следующих объектов системы:
* заказ;
* корреспонденция;
* сотрудник;
* клиент;
* тариф;
* зарплата сотрудников.

По умолчанию вкладки скрыты. Чтобы они отобразились, укажите поля и их типы в '''Справочники''' > '''Статусы''' > '''42 Пользовательские поля'''.

Одно пользовательское поле соответствует одному статусу, название статуса используется как название пользовательского поля. Тип поля определяется в дополнительной информации статуса.

Формат записи: <code>Видимость, тип поля, [параметры в зависимости от типа]</code>

Пример записи:
1, DATE, 01.01.2020

Первый параметр указывает, отображается поле или нет:
* '''1''' — отображается;
* '''0''' — скрыто.
Этот параметр устарел, хоть и поддерживается. Рекомендуется управлять видимостью поля с помощью пункта контекстного меню '''Выключить/Включить'''.

Второй параметр определяет тип поля:
* INT — вводит целое число (как UPDOWN, с границами диапазона от −1000000 до 1000000);
* STR — вводит строку;
* CUSTSTR — вводит строку, но не экранирует ее при подстановке в запрос;
* FLOAT — вводит число с плавающей точкой;
* CHECK — вводит булево значение, отображается на форме в виде флажка;
* DATE — вводит дату;
* COMBO — вводит текст с возможностью выбора из выпадающего списка;
* COMBOLIST — вводит текст из выпадающего списка;
* UPDOWN — вводит целое число со стрелками уменьшения/увеличения, с возможностью определения диапазона (пример: UPDOWN, 0-100, 1);
* (типы FILESTR и SAVEFILESTR не поддерживаются);
* GROUPBOX — создает панель и помещает на нее последующие поля. Можно добавлять все поля или только указанное количество в третьем параметре. Пример: GROUPBOX, название группы.

Третий параметр — значение по умолчанию.

Все три параметра обязательные.

'''Особенности:'''
* для поля типа COMBOBOX третий параметр — это SQL-запрос для заполнения, а четвёртый — номер записи из списка;
* для поля типа UPDOWN третий параметр — это границы диапазона изменения значений (указываются через тире), а четвертый — значение по умолчанию. Пример использования: 1,UPDOWN,0-100,1 — поле с возможностью выбора значения с помощью стрелок уменьшения/увеличения, возможные значения поля лежат в диапазоне от 0 до 100, значение по умолчанию равно 1.

Примеры объявления
1, COMBOLIST, 'Нет, Вечерний менеджер 1, Вечерний менеджер 2', 'Нет'
1, COMBOLIST, 'Нет, Вечерний менеджер 1, Вечерний менеджер 2', 0
1, COMBOLIST, 'select "Нет SMS" as name union select "SMS Обычные" union select "SMS Китай"', 0
1, STR, '''''''

При наличии хотя бы одного видимого поля вкладка будет отображена.

== Пример использования ==

Чтобы только для конкретных клиентов работала отправка электронного сообщения с отчетом о доставленных заказах:
# Перейдите в '''Справочники''' > '''Статусы''' > '''42 Пользовательские поля''' > '''Пользовательские поля для клиентов''' и нажмите на кнопку F3.
# В окне «Создание статуса» введите название поля.
# В контекстном меню созданного статуса выберите пункт '''Дополнительная информация''', укажите строкой параметры <code>1, CHECK, F</code> и нажмите на кнопку '''ОК'''.

В результате в карточке клиента появится вкладка '''Пользовательская''', и будет создан флажок:

[[Файл:UserField_1.png|500 px|none]]

Если установить флажок в карточке клиента, будет работать отправка электронного сообщения (при наличии задания в модуле автоматизации).

Пользовательские поля

2022-05-25T09:08:28Z

Olga: /* Пример использования */

Пользовательские поля отображаются на вкладке '''Пользовательская''' в карточках следующих объектов системы:
* заказ;
* корреспонденция;
* сотрудник;
* клиент;
* тариф;
* зарплата сотрудников.

По умолчанию вкладки скрыты. Чтобы они отобразились, укажите поля и их типы в '''Справочники''' > '''Статусы''' > '''42 Пользовательские поля'''.

Одно пользовательское поле соответствует одному статусу, название статуса используется как название пользовательского поля. Тип поля определяется в дополнительной информации статуса.

Формат записи: <code>Видимость, тип поля [, параметры в зависимости от типа]</code>

Пример записи:
1, DATE, 01.01.2020

Первый параметр указывает, отображается поле или нет:
* '''1''' — отображается;
* '''0''' — скрыто.
Этот параметр устарел, хоть и поддерживается. Рекомендуется управлять видимостью поля с помощью пункта контекстного меню '''Выключить/Включить'''.

Второй параметр определяет тип поля:
* INT — вводит целое число (как UPDOWN, с границами диапазона от −1000000 до 1000000);
* STR — вводит строку;
* CUSTSTR — вводит строку, но не экранирует ее при подстановке в запрос;
* FLOAT — вводит число с плавающей точкой;
* CHECK — вводит булево значение, отображается на форме в виде флажка;
* DATE — вводит дату;
* COMBO — вводит текст с возможностью выбора из выпадающего списка;
* COMBOLIST — вводит текст из выпадающего списка;
* UPDOWN — вводит целое число со стрелками уменьшения/увеличения, с возможностью определения диапазона (пример: UPDOWN, 0-100, 1);
* (типы FILESTR и SAVEFILESTR не поддерживаются);
* GROUPBOX — создает панель и помещает на нее последующие поля. Можно добавлять все поля или только указанное количество в третьем параметре. Пример: GROUPBOX, название группы.

Третий параметр — значение по умолчанию.

Все три параметра обязательные.

'''Особенности:'''
* для поля типа COMBOBOX третий параметр — это SQL-запрос для заполнения, а четвёртый — номер записи из списка;
* для поля типа UPDOWN третий параметр — это границы диапазона изменения значений (указываются через тире), а четвертый — значение по умолчанию. Пример использования: 1,UPDOWN,0-100,1 — поле с возможностью выбора значения с помощью стрелок уменьшения/увеличения, возможные значения поля лежат в диапазоне от 0 до 100, значение по умолчанию равно 1.

Примеры объявления
1, COMBOLIST, 'Нет, Вечерний менеджер 1, Вечерний менеджер 2', 'Нет'
1, COMBOLIST, 'Нет, Вечерний менеджер 1, Вечерний менеджер 2', 0
1, COMBOLIST, 'select "Нет SMS" as name union select "SMS Обычные" union select "SMS Китай"', 0
1, STR, '''''''

При наличии хотя бы одного видимого поля вкладка будет отображена.

== Пример использования ==

Чтобы только для конкретных клиентов работала отправка электронного сообщения с отчетом о доставленных заказах:
# Перейдите в '''Справочники''' > '''Статусы''' > '''42 Пользовательские поля''' > '''Пользовательские поля для клиентов''' и нажмите на кнопку F3.
# В окне «Создание статуса» введите название поля.
# В контекстном меню созданного статуса выберите пункт '''Дополнительная информация''', укажите строкой параметры <code>1, CHECK, F</code> и нажмите на кнопку '''ОК'''.

В результате в карточке клиента появится вкладка '''Пользовательская''' и будет создан флажок:

[[Файл:UserField_1.png|680 px|none]]

Если установить флажок в карточке клиента, будет работать отправка электронного сообщения (при наличии задания в модуле автоматизации).

Охрана

2022-05-25T09:01:59Z

Olga:

Вкладка предназначена для отметки фактического рабочего времени сотрудника. Для этого на входе сотрудник сканирует [[Сотрудники#Удостоверение сотрудника|удостоверение]] сотрудника на открытой вкладке '''Охрана'''.

При сканировании удостоверения работающего сотрудника вкладка выглядит следующим образом:

[[Файл:Ohrana1.png|none|900px]]

В верхней части окна отображается фотография сотрудника.

Поле '''ФИО''' отображает имя работника из карточки сотрудника.

Значение поля '''Состояние''' изменяется в зависимости от того, работает, уволен или увольняется сотрудник.

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

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

После сканирования удостоверения сотрудника в его график добавляется запись о приходе в виде текущего времени. После повторного сканирования текущее время проставится в поле '''Ушел''' и столбце '''Факт. вр. ух.'''.

Для сканирования удостоверений подходит любой сканер, приведенный в разделе [[Оборудование#Подключение и настройка сканеров штрихкодов|«Оборудование»]].

Файл:Ohrana1.png

2022-05-25T08:24:59Z

Olga: Olga загрузила новую версию Файл:Ohrana1.png

Изображение вкладки "Охрана"

Знакомство с программой

2022-05-25T08:04:46Z

Olga: /* Ручная сортировка */

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

[[Файл:2_interface.png|none|1200px]]

= Интерфейс =
[[Терминология#Основные принципы работы в программе |Интерфейс]] позволяет решать задачи пользователя через взаимосвязь «задача — элемент интерфейса».

Базовый интерфейс программы содержит основное меню, вкладки, таблицы, [[Основные принципы работы в программе#Кнопки в программе |кнопки]], фильтры отображения.

== Работа с таблицами ==
Вы можете изменять столбцы таблиц в любой части программы: менять местами перетаскиванием, сортировать по столбцу нажатием на заголовок, управлять данными таблицы через контекстное меню.

Виды сортировки:
* простая сортировка по одному столбцу по убыванию или возрастанию. Нажмите на заголовок столбца один раз — по возрастанию, второй раз — по убыванию;
* многоуровневая сортировка. Например, нужно отсортировать следующим образом: сначала по одному столбцу, внутри этой сортировки по какому-то другому столбцу, а внутри этой сортировки — по третьему и т. д. Для этого сначала нажмите левой кнопкой мыши на первый столбец, требующий сортировки, затем, удерживая нажатой клавишу CTRL, нажмите на заголовки столбцов в нужной последовательности.

Чтобы сбросить сортировку, выберите пункт контекстного меню заголовка '''Сбросить сортировку'''.

В контекстном меню на заголовке таблицы доступны следующие действия:
* '''Столбцы''' — просмотреть список всех возможных столбцов. Чтобы столбец отобразился в таблице, установите около него флажок. В окне «Столбцы» через контекстное меню можно выделить все столбцы, снять выделение со всех столбцов, сортировать по порядку или по названию;
* '''Скрыть столбец''' — скрыть текущий столбец;
* '''Шрифт''' — настроить шрифт, размер и цвет текста;
* '''Экспорт в Excel''' — выгрузить таблицу с текущими настройками отображения в файл Microsoft Excel. Пользователь должен иметь [[Пользователи|право]] «Экспортировать корреспонденции» (в узле «Отчеты»), чтобы выгружать таблицы с вкладки '''Адреса''' и '''Выдача''', и право «Экспортировать клиентов», чтобы выгружать данные вкладки '''Клиенты''';
* '''Шаблоны''' — создать шаблон с необходимыми столбцами. Подробнее см. раздел [[#Работа с шаблонами|«Работа с шаблонами»]];
* '''Обновить''' — обновить данные в таблице. Таблицы во вкладках '''Сотрудники''', '''Клиенты''' и '''Заказы''' обновляются автоматически с периодичностью 6 секунд. В остальных таблицах данные могут изменяться (другой пользователь может внести информацию или поступают данные через интеграцию), поэтому их стоит периодически обновлять;
* '''Сбросить сортировку''' — отменить сортировку. Опция активна, если предварительно в таблице была сделана сортировка по одному или нескольким столбцам.

=== Работа с шаблонами ===
Шаблоны позволяют создать таблицы с определенной очередностью столбцов под конкретные задачи. Для этого надо вывести нужные столбцы, выбрать пункт контекстного меню '''Шаблоны''', выбрать '''Сохранить''', указать название шаблона и нажать '''ОК'''.

Чтобы использовать шаблон, выберите пункт контекстного меню '''Шаблоны''' > '''Загрузить''' и укажите нужный шаблон.

Варианты работы с шаблонами таблиц на вкладке '''Адреса''':
* планирование доставки корреспонденции для городских или междугородних отправлений;
* шаблон таблицы для формирования отчета. Отобразите нужные столбцы (например, «Дата», «Масса», «Стоимость» и т.д) и сохраните как шаблон. Затем примените фильтр для компании, по которой формируется отчет и выгрузите данные из получившейся таблицы в Microsoft Excel. Для этого выберите пункт контекстного меню '''Экспорт в Excel'''.

Чтобы удалить шаблон, в контекстном меню заголовка столбца выберите пункт '''Шаблоны''' > '''Удалить''' и выберите из списка удаляемый шаблон.

=== Поиск информации ===

Поиск по ключевым словам позволяет найти точные совпадения в тексте и работает на всех вкладках, кроме '''Направления''' и '''Охрана'''. Для поиска информации нажмите комбинацию клавиш CTRL + F и введите искомые слова. Совпадения подсвечиваются на вкладке:

[[Файл:4_interface.png|900px]]

Вы можете перемещаться по найденным совпадениям с помощью стрелок [[Файл:Поиск вниз.png]] и [[Файл:Поиск вверх.png]] или ввести параметры, уточняющие поиск, по кнопке [[Файл:Поиск опции.png]].
Критерии поиска:
* '''Область поиска''' — часть таблицы, где будет производиться поиск. Возможные значения: '''Текущая колонка''', '''Вся таблица''';
* '''С учетом регистра''' — поиск ведется с учетом регистра поискового запроса;
* '''Целые слова''' — целые слова должны совпадать с введенным запросом;
* '''Начинается с''' — результат поиска будет начинаться с поискового запроса.

= Горячие клавиши =
Кнопки или комбинация кнопок, которые позволяют выполнить то или иное действие. Горячие клавиши могут быть не активны, если действие, которое они выполняют, заблокировано [[Сотрудники#Права пользователей |правами пользователя]].
{|class="wikitable" width="70%"
!style="width: 30%;"|Общие (действуют везде)
!style="width: 40%;"|Вкладка Адреса
!style="width: 30%;"|Вкладка Срочные
|-
|F1 — справка (CTRL+F1 для вкладки '''Срочные''' и карточки корреспонденции)

F3 — создать

ESC — закрыть

Enter — открыть

F11 — обновить список

CRTL+F8 — удалить выбранную позицию

CTRL+ALT+B — имитация считывания штрихкода

CTRL+P — печать
|
F1 — просмотреть информацию о заказе

F2 — сортировка

F4 — скопировать все адреса в срочные

F5 — ввод информации о доставке и предпросмотр прикрепленных фото

F6 — фильтр заказов

F7 — формирует отчет по выборке для денежных заданий

F8 — удалить из выборки

F9 — открывает окно экспорта выборки в Microsoft Excel с возможностью отправки информации по e-mail

CTRL+F1 — открыть карточку клиента

CTRL+F3 — создать заборную накладную по выборке

CTRL+F12, CTRL+P — печать ведомостей/наклеек

CTRL+ENTER (dblClick) — выбор по компании-получателю (выбрать только адреса с компанией-получателем, как у выбранного)

CTRL+S — показать на карте

CTRL+M — добавить в новый манифест (открытие карточки создания манифеста)

CTRL+T — принять в работу на завтра

CTRL+O — выбрать только выделенное

CTRL+К — выбор по запланированным курьерам (выбрать только адреса запланированные на того же курьера, что и выбранный)

CTRL+SHIFT+F10 — оплата доставки отправителем (если заказ с наличной оплатой, откроется карта внесения платежа)

BACKSPACE — предыдущая выборка

SHIFT+BACKSPACE — следующая выборка

|CTRL+F1 — справка

CTRL+F9 — печать таблицы

'''7''' — проставить «?» в курьере

'''8''' — показать карточку клиента

'''+''' — проставить «+» (в случае наличного заказа необходимо внести платеж)

'''-''' — проставить «V»

F1 — показать список работающих курьеров, заказы в разрезе курьеров

F2 — показать заказы в разрезе клиентов

F4 — уменьшить статус

F5 — увеличить статус
|}

{|class="wikitable" width="80%"
!style="width: 20%;"|Вкладка Сотрудники
!style="width: 25%;"|Вкладка Собеседования
!style="width: 30%;"|Вкладка Задания
!style="width: 25%;"|Окно Платежи
|-
|F9 — отчет «Работающие курьеры»
|F9 — составить отчет по собеседованиям
|CTRL+F3 — создать новое периодическое задание
|CTRL+F3 — посмотреть привязку к счетам
|}

{|class="wikitable" width="80%"
!style="width: 15%;"|Вкладка Клиенты
!style="width: 25%;"|Вкладка Выдача
!style="width: 22%;"|Вкладка Манифесты
!style="width: 20%;"|Вкладка Заказы
!style="width: 18%;"|Окно Счета
|-
|F2 — выставить счет

F5 — внести оплату

|F5 — проставить информацию о доставке в [[Карточка корреспонденции|карточке отправления]]

F12 — бонус/штраф курьера

CTRL+M — показать на карте

CTRL+ENTER — выбор по компании-получателю (выбрать только адреса с компанией-получателем, как у выбранного)

|CTRL+M — печатать манифест

SHIFT+CTRL+M — печатать манифест 2

CTRL+R — рентабельность

|SPACE (пробел) — открыть адреса выбранного заказа

F10 — [[Прием корреспонденции на склад]]

|F5 — внести оплату

F9 — детализация

CTRL+F9 — отчет по суммам и датам оплаты

CTRL+F12 — переместить в доставку

|}

= Общие сведения об элементах управления =

В определенных полях и формах программы используются упрощения ввода:
* в поле типа «Дата» и «Время» при нажатии клавиши SPACE (пробел) будет проставлены сегодняшнее число и время на компьютере;
* в поле типа «Дата» можно проставлять значение вида «121022», программа приводит это значение к общепринятому обозначению даты — 12.10.2022;
* в полях выбора сотрудника, например «Курьер», можно перемещаться между записями сотрудников клавишами PAGE UP и PAGE DOWN;
* вы можете устанавливать количество столбцов в меню. Например, в курьерской службе работает более 220 курьеров, тогда в контекстном меню '''Запланировать на курьера''' на вкладке '''Адреса''' записи объединяются по алфавиту. По такому же принципу происходит объединение и в других меню в программе. Чтобы настроить такое поведение, выберите основной пункт меню '''Настройка''' > '''Параметры''' > '''Отображение''' > '''Группировать пункты меню, если их больше''' и укажите количество пунктов.

= Сортировка списка адресов =
;Сортировка
:Упорядочивание данных в зависимости от выбранного критерия.

Вы можете использовать следующие виды сортировки информации на вкладке '''Адреса''':
* по заказу и номеру — сортировка используется по умолчанию при переходе из '''Заказы''' в '''Адреса'''. Наверху отображаются последние заказы;
* по району — внутри района сортировка происходит по последовательности станций метро и по получателю, в алфавитном порядке. При этой сортировке видны все заказы районов;
* по компании-получателю — сортировка в алфавитном порядке компаний-получателей;
* по заказу и району — корреспонденция из заказов сортируется с учетом районов;
* по сроку доставки и району — сортировка по двум полям, наверху будут отображаться заказы с наименьшим временем, которое осталось до окончания доставки, а также используется разделение по районам.

== Ручная сортировка ==

Этот тип сортировки предназначен для изменения порядка следования заказов на вкладке '''Адреса''' в ручном режиме. Ручная сортировка включается клавишей F2 и доступна в следующих режимах:
* по району;
* по компании-получателю;
* по заказу и номеру;
* по заказу и району;
* по сроку доставки и району.

Чтобы переключиться между режимами, нажмите на клавишу F2.

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

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

Порядок последовательности сохраняется для выбранного режима сортировки.

= Ввод адресной информации =

При определении станции метро программа считает улицей текст до первой запятой, а между первой и второй запятыми — номером дома. В первую очередь производится поиск по улице и номеру дома, а при отсутствии таких данных — только по улице.

При сохранении корреспонденции программа сохраняет и соответствие станции метро для конкретной улицы и номера дома.

Указанный формат написания адресов используется и в карточках [[Клиенты и партнеры|клиентов]] и [[Сотрудники|сотрудников]] для поля '''Адрес'''.

[[Файл:17_interface.png|none]]

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

Если нужного населенного пункта нет в списке городов, нажмите [[Файл:Кнопка Лупа.png|20px]] и поищите населенный пункт по региону и названию города. Возможны ситуации, когда в одной области может быть несколько городов с одним названием, тогда они объединяются в программе как один.

Чтобы отправить корреспонденцию в другую страну, вместо города введите название страны и города на английском языке. Если нужного города нет, его можно добавить вручную. После модерации город появится в программе. Подробнее см. в разделе [[Города|«Города»]].

'''Правила написания адресов'''

В программе используется интеграция с [[Терминология#Основные принципы работы в программе|КЛАДР]] и [[Терминология#Основные принципы работы в программе|ФИАС]], что позволяет искать адреса в актуальных базах. В карточке корреспонденции в поле '''Адрес получателя''' используется автоподстановка адресов из баз. По введенному адресу автоматически определяется [[Метро|станция метро]].

Правила написания адресов:
{| class="wikitable"
|-
! Правило || Пример
|-
|В начале пишется название улицы. Слово «дом» или сокращение «д.» при написании адреса не нужно. Формат записи содержит запятые, пробелы и точки || Щепкина ул., 42/2а, стр. 1, кв. 50, синяя дверь со стороны Профсоюзной ул.
|-
|Модификаторы названий, такие как «Большая», «Малая», «Нижняя» и т. п. (улица) сокращаются до одной буквы с точкой, и дальше слитно, без пробела, пишется само название || М.Каретный пер., 7, стр. 1
|-
|Порядковые числительные в названиях улиц пишутся перед названием улицы с наращением окончания до одной буквы через дефис || 4-й Лесной пер., 4; 3-я Ямского Поля ул., 2
|-
|Типы улиц пишутся полностью, кроме: «улица» — сокращается до «ул.», «переулок» — сокращается до «пер.» и «набережная» — до «наб.»|| Звездный бульвар, 23 с.10
|-
|Когда улица имеет исторически сложившееся название, не требующее указания типа || Маросейка, 15
|-
|Когда улица имеет тип, официально не считающийся типом || Коровий вал, 20
|-
|Названия городов с дефисом должны писаться именно с дефисом|| Санкт-Петербург (не Санкт Петербург)
|-
|При необходимости указания города в строке адреса сначала указываем наименование, потом пишем «город», «поселок» и т. д. || Видное город, им. Цюрупы рабочий поселок
|}

= Кнопки в программе =
[[Файл:History1.png]] — просмотр истории изменения.

[[Файл:Print.png]] — печать документов, заполняемых автоматически по шаблонам.

[[Файл:Icon docs.png]] — просмотр и добавление прикрепленных документов.

[[Файл:Message.png]] — просмотр истории переписки (СМС, e-mail, отправленные через программу).

[[Файл:Icon call.png]] — вызов через программу. Если у контакта несколько номеров, то можно выбрать любой из них. Используются Skype или программы для IP-телефонии.

[[Файл:Icon e-mail.png]] — отправка e-mail через программу. Можно использовать Outlook и подобные программы. Возможна работа с шаблонами.

[[Файл:Icon sms.png]] — отправка СМС, можно использовать готовые шаблоны.

[[Файл:Кнопка Лупа.png]] — поиск информации.

[[Файл:Settings.png]] — открывает настройки.

[[Файл:Globe.png]] — обзор всей карты. Позволяет увидеть все маркеры корреспонденции.

= Перейти к быстрому старту =

Эта статья первая в разделе [[Быстрый старт]]. Нажмите кнопку ниже, чтобы перейти к следующей по порядку статье.

<table style="width:100%">
<tr>
<td>
<p style="text-align:right">Следующий шаг</p>
[[File:right.png|link=Как_добавить_клиента|right|75px|Вперед]]
</td>
</tr>
</table>

Знакомство с программой

2022-05-25T07:47:10Z

Olga: /* Кнопки в программе */

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

[[Файл:2_interface.png|none|1200px]]

= Интерфейс =
[[Терминология#Основные принципы работы в программе |Интерфейс]] позволяет решать задачи пользователя через взаимосвязь «задача — элемент интерфейса».

Базовый интерфейс программы содержит основное меню, вкладки, таблицы, [[Основные принципы работы в программе#Кнопки в программе |кнопки]], фильтры отображения.

== Работа с таблицами ==
Вы можете изменять столбцы таблиц в любой части программы: менять местами перетаскиванием, сортировать по столбцу нажатием на заголовок, управлять данными таблицы через контекстное меню.

Виды сортировки:
* простая сортировка по одному столбцу по убыванию или возрастанию. Нажмите на заголовок столбца один раз — по возрастанию, второй раз — по убыванию;
* многоуровневая сортировка. Например, нужно отсортировать следующим образом: сначала по одному столбцу, внутри этой сортировки по какому-то другому столбцу, а внутри этой сортировки — по третьему и т. д. Для этого сначала нажмите левой кнопкой мыши на первый столбец, требующий сортировки, затем, удерживая нажатой клавишу CTRL, нажмите на заголовки столбцов в нужной последовательности.

Чтобы сбросить сортировку, выберите пункт контекстного меню заголовка '''Сбросить сортировку'''.

В контекстном меню на заголовке таблицы доступны следующие действия:
* '''Столбцы''' — просмотреть список всех возможных столбцов. Чтобы столбец отобразился в таблице, установите около него флажок. В окне «Столбцы» через контекстное меню можно выделить все столбцы, снять выделение со всех столбцов, сортировать по порядку или по названию;
* '''Скрыть столбец''' — скрыть текущий столбец;
* '''Шрифт''' — настроить шрифт, размер и цвет текста;
* '''Экспорт в Excel''' — выгрузить таблицу с текущими настройками отображения в файл Microsoft Excel. Пользователь должен иметь [[Пользователи|право]] «Экспортировать корреспонденции» (в узле «Отчеты»), чтобы выгружать таблицы с вкладки '''Адреса''' и '''Выдача''', и право «Экспортировать клиентов», чтобы выгружать данные вкладки '''Клиенты''';
* '''Шаблоны''' — создать шаблон с необходимыми столбцами. Подробнее см. раздел [[#Работа с шаблонами|«Работа с шаблонами»]];
* '''Обновить''' — обновить данные в таблице. Таблицы во вкладках '''Сотрудники''', '''Клиенты''' и '''Заказы''' обновляются автоматически с периодичностью 6 секунд. В остальных таблицах данные могут изменяться (другой пользователь может внести информацию или поступают данные через интеграцию), поэтому их стоит периодически обновлять;
* '''Сбросить сортировку''' — отменить сортировку. Опция активна, если предварительно в таблице была сделана сортировка по одному или нескольким столбцам.

=== Работа с шаблонами ===
Шаблоны позволяют создать таблицы с определенной очередностью столбцов под конкретные задачи. Для этого надо вывести нужные столбцы, выбрать пункт контекстного меню '''Шаблоны''', выбрать '''Сохранить''', указать название шаблона и нажать '''ОК'''.

Чтобы использовать шаблон, выберите пункт контекстного меню '''Шаблоны''' > '''Загрузить''' и укажите нужный шаблон.

Варианты работы с шаблонами таблиц на вкладке '''Адреса''':
* планирование доставки корреспонденции для городских или междугородних отправлений;
* шаблон таблицы для формирования отчета. Отобразите нужные столбцы (например, «Дата», «Масса», «Стоимость» и т.д) и сохраните как шаблон. Затем примените фильтр для компании, по которой формируется отчет и выгрузите данные из получившейся таблицы в Microsoft Excel. Для этого выберите пункт контекстного меню '''Экспорт в Excel'''.

Чтобы удалить шаблон, в контекстном меню заголовка столбца выберите пункт '''Шаблоны''' > '''Удалить''' и выберите из списка удаляемый шаблон.

=== Поиск информации ===

Поиск по ключевым словам позволяет найти точные совпадения в тексте и работает на всех вкладках, кроме '''Направления''' и '''Охрана'''. Для поиска информации нажмите комбинацию клавиш CTRL + F и введите искомые слова. Совпадения подсвечиваются на вкладке:

[[Файл:4_interface.png|900px]]

Вы можете перемещаться по найденным совпадениям с помощью стрелок [[Файл:Поиск вниз.png]] и [[Файл:Поиск вверх.png]] или ввести параметры, уточняющие поиск, по кнопке [[Файл:Поиск опции.png]].
Критерии поиска:
* '''Область поиска''' — часть таблицы, где будет производиться поиск. Возможные значения: '''Текущая колонка''', '''Вся таблица''';
* '''С учетом регистра''' — поиск ведется с учетом регистра поискового запроса;
* '''Целые слова''' — целые слова должны совпадать с введенным запросом;
* '''Начинается с''' — результат поиска будет начинаться с поискового запроса.

= Горячие клавиши =
Кнопки или комбинация кнопок, которые позволяют выполнить то или иное действие. Горячие клавиши могут быть не активны, если действие, которое они выполняют, заблокировано [[Сотрудники#Права пользователей |правами пользователя]].
{|class="wikitable" width="70%"
!style="width: 30%;"|Общие (действуют везде)
!style="width: 40%;"|Вкладка Адреса
!style="width: 30%;"|Вкладка Срочные
|-
|F1 — справка (CTRL+F1 для вкладки '''Срочные''' и карточки корреспонденции)

F3 — создать

ESC — закрыть

Enter — открыть

F11 — обновить список

CRTL+F8 — удалить выбранную позицию

CTRL+ALT+B — имитация считывания штрихкода

CTRL+P — печать
|
F1 — просмотреть информацию о заказе

F2 — сортировка

F4 — скопировать все адреса в срочные

F5 — ввод информации о доставке и предпросмотр прикрепленных фото

F6 — фильтр заказов

F7 — формирует отчет по выборке для денежных заданий

F8 — удалить из выборки

F9 — открывает окно экспорта выборки в Microsoft Excel с возможностью отправки информации по e-mail

CTRL+F1 — открыть карточку клиента

CTRL+F3 — создать заборную накладную по выборке

CTRL+F12, CTRL+P — печать ведомостей/наклеек

CTRL+ENTER (dblClick) — выбор по компании-получателю (выбрать только адреса с компанией-получателем, как у выбранного)

CTRL+S — показать на карте

CTRL+M — добавить в новый манифест (открытие карточки создания манифеста)

CTRL+T — принять в работу на завтра

CTRL+O — выбрать только выделенное

CTRL+К — выбор по запланированным курьерам (выбрать только адреса запланированные на того же курьера, что и выбранный)

CTRL+SHIFT+F10 — оплата доставки отправителем (если заказ с наличной оплатой, откроется карта внесения платежа)

BACKSPACE — предыдущая выборка

SHIFT+BACKSPACE — следующая выборка

|CTRL+F1 — справка

CTRL+F9 — печать таблицы

'''7''' — проставить «?» в курьере

'''8''' — показать карточку клиента

'''+''' — проставить «+» (в случае наличного заказа необходимо внести платеж)

'''-''' — проставить «V»

F1 — показать список работающих курьеров, заказы в разрезе курьеров

F2 — показать заказы в разрезе клиентов

F4 — уменьшить статус

F5 — увеличить статус
|}

{|class="wikitable" width="80%"
!style="width: 20%;"|Вкладка Сотрудники
!style="width: 25%;"|Вкладка Собеседования
!style="width: 30%;"|Вкладка Задания
!style="width: 25%;"|Окно Платежи
|-
|F9 — отчет «Работающие курьеры»
|F9 — составить отчет по собеседованиям
|CTRL+F3 — создать новое периодическое задание
|CTRL+F3 — посмотреть привязку к счетам
|}

{|class="wikitable" width="80%"
!style="width: 15%;"|Вкладка Клиенты
!style="width: 25%;"|Вкладка Выдача
!style="width: 22%;"|Вкладка Манифесты
!style="width: 20%;"|Вкладка Заказы
!style="width: 18%;"|Окно Счета
|-
|F2 — выставить счет

F5 — внести оплату

|F5 — проставить информацию о доставке в [[Карточка корреспонденции|карточке отправления]]

F12 — бонус/штраф курьера

CTRL+M — показать на карте

CTRL+ENTER — выбор по компании-получателю (выбрать только адреса с компанией-получателем, как у выбранного)

|CTRL+M — печатать манифест

SHIFT+CTRL+M — печатать манифест 2

CTRL+R — рентабельность

|SPACE (пробел) — открыть адреса выбранного заказа

F10 — [[Прием корреспонденции на склад]]

|F5 — внести оплату

F9 — детализация

CTRL+F9 — отчет по суммам и датам оплаты

CTRL+F12 — переместить в доставку

|}

= Общие сведения об элементах управления =

В определенных полях и формах программы используются упрощения ввода:
* в поле типа «Дата» и «Время» при нажатии клавиши SPACE (пробел) будет проставлены сегодняшнее число и время на компьютере;
* в поле типа «Дата» можно проставлять значение вида «121022», программа приводит это значение к общепринятому обозначению даты — 12.10.2022;
* в полях выбора сотрудника, например «Курьер», можно перемещаться между записями сотрудников клавишами PAGE UP и PAGE DOWN;
* вы можете устанавливать количество столбцов в меню. Например, в курьерской службе работает более 220 курьеров, тогда в контекстном меню '''Запланировать на курьера''' на вкладке '''Адреса''' записи объединяются по алфавиту. По такому же принципу происходит объединение и в других меню в программе. Чтобы настроить такое поведение, выберите основной пункт меню '''Настройка''' > '''Параметры''' > '''Отображение''' > '''Группировать пункты меню, если их больше''' и укажите количество пунктов.

= Сортировка списка адресов =
;Сортировка
:Упорядочивание данных в зависимости от выбранного критерия.

Вы можете использовать следующие виды сортировки информации на вкладке '''Адреса''':
* по заказу и номеру — сортировка используется по умолчанию при переходе из '''Заказы''' в '''Адреса'''. Наверху отображаются последние заказы;
* по району — внутри района сортировка происходит по последовательности станций метро и по получателю, в алфавитном порядке. При этой сортировке видны все заказы районов;
* по компании-получателю — сортировка в алфавитном порядке компаний-получателей;
* по заказу и району — корреспонденция из заказов сортируется с учетом районов;
* по сроку доставки и району — сортировка по двум полям, наверху будут отображаться заказы с наименьшим временем, которое осталось до окончания доставки, а также используется разделение по районам.

== Ручная сортировка ==
[[Файл:12a_interface.png|300px|right|thumb|Сортировка по району]]
Этот тип сортировки предназначен для изменения порядка следования заказов на вкладке '''Адреса''' в ручном режиме. Ручная сортировка включается клавишей F2 и доступна в следующих режимах:
* сортировка по району;
* сортировка по заказу и району;
* сортировка по сроку доставки и району.

Для режимов сортировки, где присутствует район, слева отобразится пустой фиксированный столбец.

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

Порядок последовательности сохраняется для выбранного режима сортировки.

= Ввод адресной информации =

При определении станции метро программа считает улицей текст до первой запятой, а между первой и второй запятыми — номером дома. В первую очередь производится поиск по улице и номеру дома, а при отсутствии таких данных — только по улице.

При сохранении корреспонденции программа сохраняет и соответствие станции метро для конкретной улицы и номера дома.

Указанный формат написания адресов используется и в карточках [[Клиенты и партнеры|клиентов]] и [[Сотрудники|сотрудников]] для поля '''Адрес'''.

[[Файл:17_interface.png|none]]

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

Если нужного населенного пункта нет в списке городов, нажмите [[Файл:Кнопка Лупа.png|20px]] и поищите населенный пункт по региону и названию города. Возможны ситуации, когда в одной области может быть несколько городов с одним названием, тогда они объединяются в программе как один.

Чтобы отправить корреспонденцию в другую страну, вместо города введите название страны и города на английском языке. Если нужного города нет, его можно добавить вручную. После модерации город появится в программе. Подробнее см. в разделе [[Города|«Города»]].

'''Правила написания адресов'''

В программе используется интеграция с [[Терминология#Основные принципы работы в программе|КЛАДР]] и [[Терминология#Основные принципы работы в программе|ФИАС]], что позволяет искать адреса в актуальных базах. В карточке корреспонденции в поле '''Адрес получателя''' используется автоподстановка адресов из баз. По введенному адресу автоматически определяется [[Метро|станция метро]].

Правила написания адресов:
{| class="wikitable"
|-
! Правило || Пример
|-
|В начале пишется название улицы. Слово «дом» или сокращение «д.» при написании адреса не нужно. Формат записи содержит запятые, пробелы и точки || Щепкина ул., 42/2а, стр. 1, кв. 50, синяя дверь со стороны Профсоюзной ул.
|-
|Модификаторы названий, такие как «Большая», «Малая», «Нижняя» и т. п. (улица) сокращаются до одной буквы с точкой, и дальше слитно, без пробела, пишется само название || М.Каретный пер., 7, стр. 1
|-
|Порядковые числительные в названиях улиц пишутся перед названием улицы с наращением окончания до одной буквы через дефис || 4-й Лесной пер., 4; 3-я Ямского Поля ул., 2
|-
|Типы улиц пишутся полностью, кроме: «улица» — сокращается до «ул.», «переулок» — сокращается до «пер.» и «набережная» — до «наб.»|| Звездный бульвар, 23 с.10
|-
|Когда улица имеет исторически сложившееся название, не требующее указания типа || Маросейка, 15
|-
|Когда улица имеет тип, официально не считающийся типом || Коровий вал, 20
|-
|Названия городов с дефисом должны писаться именно с дефисом|| Санкт-Петербург (не Санкт Петербург)
|-
|При необходимости указания города в строке адреса сначала указываем наименование, потом пишем «город», «поселок» и т. д. || Видное город, им. Цюрупы рабочий поселок
|}

= Кнопки в программе =
[[Файл:History1.png]] — просмотр истории изменения.

[[Файл:Print.png]] — печать документов, заполняемых автоматически по шаблонам.

[[Файл:Icon docs.png]] — просмотр и добавление прикрепленных документов.

[[Файл:Message.png]] — просмотр истории переписки (СМС, e-mail, отправленные через программу).

[[Файл:Icon call.png]] — вызов через программу. Если у контакта несколько номеров, то можно выбрать любой из них. Используются Skype или программы для IP-телефонии.

[[Файл:Icon e-mail.png]] — отправка e-mail через программу. Можно использовать Outlook и подобные программы. Возможна работа с шаблонами.

[[Файл:Icon sms.png]] — отправка СМС, можно использовать готовые шаблоны.

[[Файл:Кнопка Лупа.png]] — поиск информации.

[[Файл:Settings.png]] — открывает настройки.

[[Файл:Globe.png]] — обзор всей карты. Позволяет увидеть все маркеры корреспонденции.

= Перейти к быстрому старту =

Эта статья первая в разделе [[Быстрый старт]]. Нажмите кнопку ниже, чтобы перейти к следующей по порядку статье.

<table style="width:100%">
<tr>
<td>
<p style="text-align:right">Следующий шаг</p>
[[File:right.png|link=Как_добавить_клиента|right|75px|Вперед]]
</td>
</tr>
</table>

Знакомство с программой

2022-05-25T07:44:20Z

Olga: /* Ввод адресной информации */

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

[[Файл:2_interface.png|none|1200px]]

= Интерфейс =
[[Терминология#Основные принципы работы в программе |Интерфейс]] позволяет решать задачи пользователя через взаимосвязь «задача — элемент интерфейса».

Базовый интерфейс программы содержит основное меню, вкладки, таблицы, [[Основные принципы работы в программе#Кнопки в программе |кнопки]], фильтры отображения.

== Работа с таблицами ==
Вы можете изменять столбцы таблиц в любой части программы: менять местами перетаскиванием, сортировать по столбцу нажатием на заголовок, управлять данными таблицы через контекстное меню.

Виды сортировки:
* простая сортировка по одному столбцу по убыванию или возрастанию. Нажмите на заголовок столбца один раз — по возрастанию, второй раз — по убыванию;
* многоуровневая сортировка. Например, нужно отсортировать следующим образом: сначала по одному столбцу, внутри этой сортировки по какому-то другому столбцу, а внутри этой сортировки — по третьему и т. д. Для этого сначала нажмите левой кнопкой мыши на первый столбец, требующий сортировки, затем, удерживая нажатой клавишу CTRL, нажмите на заголовки столбцов в нужной последовательности.

Чтобы сбросить сортировку, выберите пункт контекстного меню заголовка '''Сбросить сортировку'''.

В контекстном меню на заголовке таблицы доступны следующие действия:
* '''Столбцы''' — просмотреть список всех возможных столбцов. Чтобы столбец отобразился в таблице, установите около него флажок. В окне «Столбцы» через контекстное меню можно выделить все столбцы, снять выделение со всех столбцов, сортировать по порядку или по названию;
* '''Скрыть столбец''' — скрыть текущий столбец;
* '''Шрифт''' — настроить шрифт, размер и цвет текста;
* '''Экспорт в Excel''' — выгрузить таблицу с текущими настройками отображения в файл Microsoft Excel. Пользователь должен иметь [[Пользователи|право]] «Экспортировать корреспонденции» (в узле «Отчеты»), чтобы выгружать таблицы с вкладки '''Адреса''' и '''Выдача''', и право «Экспортировать клиентов», чтобы выгружать данные вкладки '''Клиенты''';
* '''Шаблоны''' — создать шаблон с необходимыми столбцами. Подробнее см. раздел [[#Работа с шаблонами|«Работа с шаблонами»]];
* '''Обновить''' — обновить данные в таблице. Таблицы во вкладках '''Сотрудники''', '''Клиенты''' и '''Заказы''' обновляются автоматически с периодичностью 6 секунд. В остальных таблицах данные могут изменяться (другой пользователь может внести информацию или поступают данные через интеграцию), поэтому их стоит периодически обновлять;
* '''Сбросить сортировку''' — отменить сортировку. Опция активна, если предварительно в таблице была сделана сортировка по одному или нескольким столбцам.

=== Работа с шаблонами ===
Шаблоны позволяют создать таблицы с определенной очередностью столбцов под конкретные задачи. Для этого надо вывести нужные столбцы, выбрать пункт контекстного меню '''Шаблоны''', выбрать '''Сохранить''', указать название шаблона и нажать '''ОК'''.

Чтобы использовать шаблон, выберите пункт контекстного меню '''Шаблоны''' > '''Загрузить''' и укажите нужный шаблон.

Варианты работы с шаблонами таблиц на вкладке '''Адреса''':
* планирование доставки корреспонденции для городских или междугородних отправлений;
* шаблон таблицы для формирования отчета. Отобразите нужные столбцы (например, «Дата», «Масса», «Стоимость» и т.д) и сохраните как шаблон. Затем примените фильтр для компании, по которой формируется отчет и выгрузите данные из получившейся таблицы в Microsoft Excel. Для этого выберите пункт контекстного меню '''Экспорт в Excel'''.

Чтобы удалить шаблон, в контекстном меню заголовка столбца выберите пункт '''Шаблоны''' > '''Удалить''' и выберите из списка удаляемый шаблон.

=== Поиск информации ===

Поиск по ключевым словам позволяет найти точные совпадения в тексте и работает на всех вкладках, кроме '''Направления''' и '''Охрана'''. Для поиска информации нажмите комбинацию клавиш CTRL + F и введите искомые слова. Совпадения подсвечиваются на вкладке:

[[Файл:4_interface.png|900px]]

Вы можете перемещаться по найденным совпадениям с помощью стрелок [[Файл:Поиск вниз.png]] и [[Файл:Поиск вверх.png]] или ввести параметры, уточняющие поиск, по кнопке [[Файл:Поиск опции.png]].
Критерии поиска:
* '''Область поиска''' — часть таблицы, где будет производиться поиск. Возможные значения: '''Текущая колонка''', '''Вся таблица''';
* '''С учетом регистра''' — поиск ведется с учетом регистра поискового запроса;
* '''Целые слова''' — целые слова должны совпадать с введенным запросом;
* '''Начинается с''' — результат поиска будет начинаться с поискового запроса.

= Горячие клавиши =
Кнопки или комбинация кнопок, которые позволяют выполнить то или иное действие. Горячие клавиши могут быть не активны, если действие, которое они выполняют, заблокировано [[Сотрудники#Права пользователей |правами пользователя]].
{|class="wikitable" width="70%"
!style="width: 30%;"|Общие (действуют везде)
!style="width: 40%;"|Вкладка Адреса
!style="width: 30%;"|Вкладка Срочные
|-
|F1 — справка (CTRL+F1 для вкладки '''Срочные''' и карточки корреспонденции)

F3 — создать

ESC — закрыть

Enter — открыть

F11 — обновить список

CRTL+F8 — удалить выбранную позицию

CTRL+ALT+B — имитация считывания штрихкода

CTRL+P — печать
|
F1 — просмотреть информацию о заказе

F2 — сортировка

F4 — скопировать все адреса в срочные

F5 — ввод информации о доставке и предпросмотр прикрепленных фото

F6 — фильтр заказов

F7 — формирует отчет по выборке для денежных заданий

F8 — удалить из выборки

F9 — открывает окно экспорта выборки в Microsoft Excel с возможностью отправки информации по e-mail

CTRL+F1 — открыть карточку клиента

CTRL+F3 — создать заборную накладную по выборке

CTRL+F12, CTRL+P — печать ведомостей/наклеек

CTRL+ENTER (dblClick) — выбор по компании-получателю (выбрать только адреса с компанией-получателем, как у выбранного)

CTRL+S — показать на карте

CTRL+M — добавить в новый манифест (открытие карточки создания манифеста)

CTRL+T — принять в работу на завтра

CTRL+O — выбрать только выделенное

CTRL+К — выбор по запланированным курьерам (выбрать только адреса запланированные на того же курьера, что и выбранный)

CTRL+SHIFT+F10 — оплата доставки отправителем (если заказ с наличной оплатой, откроется карта внесения платежа)

BACKSPACE — предыдущая выборка

SHIFT+BACKSPACE — следующая выборка

|CTRL+F1 — справка

CTRL+F9 — печать таблицы

'''7''' — проставить «?» в курьере

'''8''' — показать карточку клиента

'''+''' — проставить «+» (в случае наличного заказа необходимо внести платеж)

'''-''' — проставить «V»

F1 — показать список работающих курьеров, заказы в разрезе курьеров

F2 — показать заказы в разрезе клиентов

F4 — уменьшить статус

F5 — увеличить статус
|}

{|class="wikitable" width="80%"
!style="width: 20%;"|Вкладка Сотрудники
!style="width: 25%;"|Вкладка Собеседования
!style="width: 30%;"|Вкладка Задания
!style="width: 25%;"|Окно Платежи
|-
|F9 — отчет «Работающие курьеры»
|F9 — составить отчет по собеседованиям
|CTRL+F3 — создать новое периодическое задание
|CTRL+F3 — посмотреть привязку к счетам
|}

{|class="wikitable" width="80%"
!style="width: 15%;"|Вкладка Клиенты
!style="width: 25%;"|Вкладка Выдача
!style="width: 22%;"|Вкладка Манифесты
!style="width: 20%;"|Вкладка Заказы
!style="width: 18%;"|Окно Счета
|-
|F2 — выставить счет

F5 — внести оплату

|F5 — проставить информацию о доставке в [[Карточка корреспонденции|карточке отправления]]

F12 — бонус/штраф курьера

CTRL+M — показать на карте

CTRL+ENTER — выбор по компании-получателю (выбрать только адреса с компанией-получателем, как у выбранного)

|CTRL+M — печатать манифест

SHIFT+CTRL+M — печатать манифест 2

CTRL+R — рентабельность

|SPACE (пробел) — открыть адреса выбранного заказа

F10 — [[Прием корреспонденции на склад]]

|F5 — внести оплату

F9 — детализация

CTRL+F9 — отчет по суммам и датам оплаты

CTRL+F12 — переместить в доставку

|}

= Общие сведения об элементах управления =

В определенных полях и формах программы используются упрощения ввода:
* в поле типа «Дата» и «Время» при нажатии клавиши SPACE (пробел) будет проставлены сегодняшнее число и время на компьютере;
* в поле типа «Дата» можно проставлять значение вида «121022», программа приводит это значение к общепринятому обозначению даты — 12.10.2022;
* в полях выбора сотрудника, например «Курьер», можно перемещаться между записями сотрудников клавишами PAGE UP и PAGE DOWN;
* вы можете устанавливать количество столбцов в меню. Например, в курьерской службе работает более 220 курьеров, тогда в контекстном меню '''Запланировать на курьера''' на вкладке '''Адреса''' записи объединяются по алфавиту. По такому же принципу происходит объединение и в других меню в программе. Чтобы настроить такое поведение, выберите основной пункт меню '''Настройка''' > '''Параметры''' > '''Отображение''' > '''Группировать пункты меню, если их больше''' и укажите количество пунктов.

= Сортировка списка адресов =
;Сортировка
:Упорядочивание данных в зависимости от выбранного критерия.

Вы можете использовать следующие виды сортировки информации на вкладке '''Адреса''':
* по заказу и номеру — сортировка используется по умолчанию при переходе из '''Заказы''' в '''Адреса'''. Наверху отображаются последние заказы;
* по району — внутри района сортировка происходит по последовательности станций метро и по получателю, в алфавитном порядке. При этой сортировке видны все заказы районов;
* по компании-получателю — сортировка в алфавитном порядке компаний-получателей;
* по заказу и району — корреспонденция из заказов сортируется с учетом районов;
* по сроку доставки и району — сортировка по двум полям, наверху будут отображаться заказы с наименьшим временем, которое осталось до окончания доставки, а также используется разделение по районам.

== Ручная сортировка ==
[[Файл:12a_interface.png|300px|right|thumb|Сортировка по району]]
Этот тип сортировки предназначен для изменения порядка следования заказов на вкладке '''Адреса''' в ручном режиме. Ручная сортировка включается клавишей F2 и доступна в следующих режимах:
* сортировка по району;
* сортировка по заказу и району;
* сортировка по сроку доставки и району.

Для режимов сортировки, где присутствует район, слева отобразится пустой фиксированный столбец.

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

Порядок последовательности сохраняется для выбранного режима сортировки.

= Ввод адресной информации =

При определении станции метро программа считает улицей текст до первой запятой, а между первой и второй запятыми — номером дома. В первую очередь производится поиск по улице и номеру дома, а при отсутствии таких данных — только по улице.

При сохранении корреспонденции программа сохраняет и соответствие станции метро для конкретной улицы и номера дома.

Указанный формат написания адресов используется и в карточках [[Клиенты и партнеры|клиентов]] и [[Сотрудники|сотрудников]] для поля '''Адрес'''.

[[Файл:17_interface.png|none]]

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

Если нужного населенного пункта нет в списке городов, нажмите [[Файл:Кнопка Лупа.png|20px]] и поищите населенный пункт по региону и названию города. Возможны ситуации, когда в одной области может быть несколько городов с одним названием, тогда они объединяются в программе как один.

Чтобы отправить корреспонденцию в другую страну, вместо города введите название страны и города на английском языке. Если нужного города нет, его можно добавить вручную. После модерации город появится в программе. Подробнее см. в разделе [[Города|«Города»]].

'''Правила написания адресов'''

В программе используется интеграция с [[Терминология#Основные принципы работы в программе|КЛАДР]] и [[Терминология#Основные принципы работы в программе|ФИАС]], что позволяет искать адреса в актуальных базах. В карточке корреспонденции в поле '''Адрес получателя''' используется автоподстановка адресов из баз. По введенному адресу автоматически определяется [[Метро|станция метро]].

Правила написания адресов:
{| class="wikitable"
|-
! Правило || Пример
|-
|В начале пишется название улицы. Слово «дом» или сокращение «д.» при написании адреса не нужно. Формат записи содержит запятые, пробелы и точки || Щепкина ул., 42/2а, стр. 1, кв. 50, синяя дверь со стороны Профсоюзной ул.
|-
|Модификаторы названий, такие как «Большая», «Малая», «Нижняя» и т. п. (улица) сокращаются до одной буквы с точкой, и дальше слитно, без пробела, пишется само название || М.Каретный пер., 7, стр. 1
|-
|Порядковые числительные в названиях улиц пишутся перед названием улицы с наращением окончания до одной буквы через дефис || 4-й Лесной пер., 4; 3-я Ямского Поля ул., 2
|-
|Типы улиц пишутся полностью, кроме: «улица» — сокращается до «ул.», «переулок» — сокращается до «пер.» и «набережная» — до «наб.»|| Звездный бульвар, 23 с.10
|-
|Когда улица имеет исторически сложившееся название, не требующее указания типа || Маросейка, 15
|-
|Когда улица имеет тип, официально не считающийся типом || Коровий вал, 20
|-
|Названия городов с дефисом должны писаться именно с дефисом|| Санкт-Петербург (не Санкт Петербург)
|-
|При необходимости указания города в строке адреса сначала указываем наименование, потом пишем «город», «поселок» и т. д. || Видное город, им. Цюрупы рабочий поселок
|}

= Кнопки в программе =
[[Файл:History1.png]] — просмотр истории изменения.

[[Файл:Print.png]] — печать документов, заполняемых автоматически по шаблонам.

[[Файл:Icon docs.png]] — просмотр и добавление прикрепленных документов.

[[Файл:Message.png]] — просмотр истории переписки (СМС, e-mail, отправленные через программу).

[[Файл:Icon call.png]] — вызов через программу. Если у контакта несколько номеров, то можно выбрать любой из них. Используются Skype или программы для IP-телефонии.

[[Файл:Icon e-mail.png]] — отправка e-mail через программу. Можно использовать Outlook и подобные программы. Возможна работа с шаблонами.

[[Файл:Icon sms.png]] — отправка СМС, можно использовать готовые шаблоны.

[[Файл:Кнопка Поиск.png]] — поиск информации.

[[Файл:Settings.png]] — открывает настройки.

[[Файл:Globe.png]] — обзор всей карты. Позволяет увидеть все маркеры корреспонденции.

= Перейти к быстрому старту =

Эта статья первая в разделе [[Быстрый старт]]. Нажмите кнопку ниже, чтобы перейти к следующей по порядку статье.

<table style="width:100%">
<tr>
<td>
<p style="text-align:right">Следующий шаг</p>
[[File:right.png|link=Как_добавить_клиента|right|75px|Вперед]]
</td>
</tr>
</table>

Модуль репликации данных

2022-05-25T07:15:04Z

Olga:

Модуль репликации используется для синхронизации данных между инсталляциями системы, а также между офисной базой данных и сайтом. Модуль представляет собой службу Windows «MyRplService», которая каждые 3 минуты одновременно подключается к локальной и удаленной БД системы (филиал в другом городе, хостинг-площадка провайдера) для синхронизации информации.

Модуль репликации данных состоит из файлов:
* MyRplService.exe — исполняемый файл службы;
* MyRplService.xml — конфигурационный файл;
* MyRplService.log — файл журнала (протокол работы службы). Если его нет, он создается при запуске службы.

'''Примечание'''. Для работы службы репликации с сайтом по протоколу ssh (доступ к MySQL на хостинг-площадку провайдера) требуется дополнительная установка и настройка службы Windows «Myentunnel».

Знакомство с программой

2022-05-24T15:03:01Z

Olga: /* Сортировка списка адресов */

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

[[Файл:2_interface.png|none|1200px]]

= Интерфейс =
[[Терминология#Основные принципы работы в программе |Интерфейс]] позволяет решать задачи пользователя через взаимосвязь «задача — элемент интерфейса».

Базовый интерфейс программы содержит основное меню, вкладки, таблицы, [[Основные принципы работы в программе#Кнопки в программе |кнопки]], фильтры отображения.

== Работа с таблицами ==
Вы можете изменять столбцы таблиц в любой части программы: менять местами перетаскиванием, сортировать по столбцу нажатием на заголовок, управлять данными таблицы через контекстное меню.

Виды сортировки:
* простая сортировка по одному столбцу по убыванию или возрастанию. Нажмите на заголовок столбца один раз — по возрастанию, второй раз — по убыванию;
* многоуровневая сортировка. Например, нужно отсортировать следующим образом: сначала по одному столбцу, внутри этой сортировки по какому-то другому столбцу, а внутри этой сортировки — по третьему и т. д. Для этого сначала нажмите левой кнопкой мыши на первый столбец, требующий сортировки, затем, удерживая нажатой клавишу CTRL, нажмите на заголовки столбцов в нужной последовательности.

Чтобы сбросить сортировку, выберите пункт контекстного меню заголовка '''Сбросить сортировку'''.

В контекстном меню на заголовке таблицы доступны следующие действия:
* '''Столбцы''' — просмотреть список всех возможных столбцов. Чтобы столбец отобразился в таблице, установите около него флажок. В окне «Столбцы» через контекстное меню можно выделить все столбцы, снять выделение со всех столбцов, сортировать по порядку или по названию;
* '''Скрыть столбец''' — скрыть текущий столбец;
* '''Шрифт''' — настроить шрифт, размер и цвет текста;
* '''Экспорт в Excel''' — выгрузить таблицу с текущими настройками отображения в файл Microsoft Excel. Пользователь должен иметь [[Пользователи|право]] «Экспортировать корреспонденции» (в узле «Отчеты»), чтобы выгружать таблицы с вкладки '''Адреса''' и '''Выдача''', и право «Экспортировать клиентов», чтобы выгружать данные вкладки '''Клиенты''';
* '''Шаблоны''' — создать шаблон с необходимыми столбцами. Подробнее см. раздел [[#Работа с шаблонами|«Работа с шаблонами»]];
* '''Обновить''' — обновить данные в таблице. Таблицы во вкладках '''Сотрудники''', '''Клиенты''' и '''Заказы''' обновляются автоматически с периодичностью 6 секунд. В остальных таблицах данные могут изменяться (другой пользователь может внести информацию или поступают данные через интеграцию), поэтому их стоит периодически обновлять;
* '''Сбросить сортировку''' — отменить сортировку. Опция активна, если предварительно в таблице была сделана сортировка по одному или нескольким столбцам.

=== Работа с шаблонами ===
Шаблоны позволяют создать таблицы с определенной очередностью столбцов под конкретные задачи. Для этого надо вывести нужные столбцы, выбрать пункт контекстного меню '''Шаблоны''', выбрать '''Сохранить''', указать название шаблона и нажать '''ОК'''.

Чтобы использовать шаблон, выберите пункт контекстного меню '''Шаблоны''' > '''Загрузить''' и укажите нужный шаблон.

Варианты работы с шаблонами таблиц на вкладке '''Адреса''':
* планирование доставки корреспонденции для городских или междугородних отправлений;
* шаблон таблицы для формирования отчета. Отобразите нужные столбцы (например, «Дата», «Масса», «Стоимость» и т.д) и сохраните как шаблон. Затем примените фильтр для компании, по которой формируется отчет и выгрузите данные из получившейся таблицы в Microsoft Excel. Для этого выберите пункт контекстного меню '''Экспорт в Excel'''.

Чтобы удалить шаблон, в контекстном меню заголовка столбца выберите пункт '''Шаблоны''' > '''Удалить''' и выберите из списка удаляемый шаблон.

=== Поиск информации ===

Поиск по ключевым словам позволяет найти точные совпадения в тексте и работает на всех вкладках, кроме '''Направления''' и '''Охрана'''. Для поиска информации нажмите комбинацию клавиш CTRL + F и введите искомые слова. Совпадения подсвечиваются на вкладке:

[[Файл:4_interface.png|900px]]

Вы можете перемещаться по найденным совпадениям с помощью стрелок [[Файл:Поиск вниз.png]] и [[Файл:Поиск вверх.png]] или ввести параметры, уточняющие поиск, по кнопке [[Файл:Поиск опции.png]].
Критерии поиска:
* '''Область поиска''' — часть таблицы, где будет производиться поиск. Возможные значения: '''Текущая колонка''', '''Вся таблица''';
* '''С учетом регистра''' — поиск ведется с учетом регистра поискового запроса;
* '''Целые слова''' — целые слова должны совпадать с введенным запросом;
* '''Начинается с''' — результат поиска будет начинаться с поискового запроса.

= Горячие клавиши =
Кнопки или комбинация кнопок, которые позволяют выполнить то или иное действие. Горячие клавиши могут быть не активны, если действие, которое они выполняют, заблокировано [[Сотрудники#Права пользователей |правами пользователя]].
{|class="wikitable" width="70%"
!style="width: 30%;"|Общие (действуют везде)
!style="width: 40%;"|Вкладка Адреса
!style="width: 30%;"|Вкладка Срочные
|-
|F1 — справка (CTRL+F1 для вкладки '''Срочные''' и карточки корреспонденции)

F3 — создать

ESC — закрыть

Enter — открыть

F11 — обновить список

CRTL+F8 — удалить выбранную позицию

CTRL+ALT+B — имитация считывания штрихкода

CTRL+P — печать
|
F1 — просмотреть информацию о заказе

F2 — сортировка

F4 — скопировать все адреса в срочные

F5 — ввод информации о доставке и предпросмотр прикрепленных фото

F6 — фильтр заказов

F7 — формирует отчет по выборке для денежных заданий

F8 — удалить из выборки

F9 — открывает окно экспорта выборки в Microsoft Excel с возможностью отправки информации по e-mail

CTRL+F1 — открыть карточку клиента

CTRL+F3 — создать заборную накладную по выборке

CTRL+F12, CTRL+P — печать ведомостей/наклеек

CTRL+ENTER (dblClick) — выбор по компании-получателю (выбрать только адреса с компанией-получателем, как у выбранного)

CTRL+S — показать на карте

CTRL+M — добавить в новый манифест (открытие карточки создания манифеста)

CTRL+T — принять в работу на завтра

CTRL+O — выбрать только выделенное

CTRL+К — выбор по запланированным курьерам (выбрать только адреса запланированные на того же курьера, что и выбранный)

CTRL+SHIFT+F10 — оплата доставки отправителем (если заказ с наличной оплатой, откроется карта внесения платежа)

BACKSPACE — предыдущая выборка

SHIFT+BACKSPACE — следующая выборка

|CTRL+F1 — справка

CTRL+F9 — печать таблицы

'''7''' — проставить «?» в курьере

'''8''' — показать карточку клиента

'''+''' — проставить «+» (в случае наличного заказа необходимо внести платеж)

'''-''' — проставить «V»

F1 — показать список работающих курьеров, заказы в разрезе курьеров

F2 — показать заказы в разрезе клиентов

F4 — уменьшить статус

F5 — увеличить статус
|}

{|class="wikitable" width="80%"
!style="width: 20%;"|Вкладка Сотрудники
!style="width: 25%;"|Вкладка Собеседования
!style="width: 30%;"|Вкладка Задания
!style="width: 25%;"|Окно Платежи
|-
|F9 — отчет «Работающие курьеры»
|F9 — составить отчет по собеседованиям
|CTRL+F3 — создать новое периодическое задание
|CTRL+F3 — посмотреть привязку к счетам
|}

{|class="wikitable" width="80%"
!style="width: 15%;"|Вкладка Клиенты
!style="width: 25%;"|Вкладка Выдача
!style="width: 22%;"|Вкладка Манифесты
!style="width: 20%;"|Вкладка Заказы
!style="width: 18%;"|Окно Счета
|-
|F2 — выставить счет

F5 — внести оплату

|F5 — проставить информацию о доставке в [[Карточка корреспонденции|карточке отправления]]

F12 — бонус/штраф курьера

CTRL+M — показать на карте

CTRL+ENTER — выбор по компании-получателю (выбрать только адреса с компанией-получателем, как у выбранного)

|CTRL+M — печатать манифест

SHIFT+CTRL+M — печатать манифест 2

CTRL+R — рентабельность

|SPACE (пробел) — открыть адреса выбранного заказа

F10 — [[Прием корреспонденции на склад]]

|F5 — внести оплату

F9 — детализация

CTRL+F9 — отчет по суммам и датам оплаты

CTRL+F12 — переместить в доставку

|}

= Общие сведения об элементах управления =

В определенных полях и формах программы используются упрощения ввода:
* в поле типа «Дата» и «Время» при нажатии клавиши SPACE (пробел) будет проставлены сегодняшнее число и время на компьютере;
* в поле типа «Дата» можно проставлять значение вида «121022», программа приводит это значение к общепринятому обозначению даты — 12.10.2022;
* в полях выбора сотрудника, например «Курьер», можно перемещаться между записями сотрудников клавишами PAGE UP и PAGE DOWN;
* вы можете устанавливать количество столбцов в меню. Например, в курьерской службе работает более 220 курьеров, тогда в контекстном меню '''Запланировать на курьера''' на вкладке '''Адреса''' записи объединяются по алфавиту. По такому же принципу происходит объединение и в других меню в программе. Чтобы настроить такое поведение, выберите основной пункт меню '''Настройка''' > '''Параметры''' > '''Отображение''' > '''Группировать пункты меню, если их больше''' и укажите количество пунктов.

= Сортировка списка адресов =
;Сортировка
:Упорядочивание данных в зависимости от выбранного критерия.

Вы можете использовать следующие виды сортировки информации на вкладке '''Адреса''':
* по заказу и номеру — сортировка используется по умолчанию при переходе из '''Заказы''' в '''Адреса'''. Наверху отображаются последние заказы;
* по району — внутри района сортировка происходит по последовательности станций метро и по получателю, в алфавитном порядке. При этой сортировке видны все заказы районов;
* по компании-получателю — сортировка в алфавитном порядке компаний-получателей;
* по заказу и району — корреспонденция из заказов сортируется с учетом районов;
* по сроку доставки и району — сортировка по двум полям, наверху будут отображаться заказы с наименьшим временем, которое осталось до окончания доставки, а также используется разделение по районам.

== Ручная сортировка ==
[[Файл:12a_interface.png|300px|right|thumb|Сортировка по району]]
Этот тип сортировки предназначен для изменения порядка следования заказов на вкладке '''Адреса''' в ручном режиме. Ручная сортировка включается клавишей F2 и доступна в следующих режимах:
* сортировка по району;
* сортировка по заказу и району;
* сортировка по сроку доставки и району.

Для режимов сортировки, где присутствует район, слева отобразится пустой фиксированный столбец.

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

Порядок последовательности сохраняется для выбранного режима сортировки.

= Ввод адресной информации =

При определении станции метро программа считает улицей текст до первой запятой, а между первой и второй запятыми – номером дома. В первую очередь производится поиск по улице и номеру дома, а при отсутствии таких данных – только по улице. При сохранении корреспонденции программа сохраняет и соответствие станции метро для конкретной улицы и номера дома. Указанный формат написания адресов используется и для поля “Адрес” на вкладках: “Клиенты” и “Cотрудники” в карточках клиентов и сотрудников.
[[Файл:17_interface.png|300px|right|Город получателя]]
Для написания адреса доставки междугороднего отправления предусмотрен другой механизм, который помимо задания адреса требует указания региона (страны) и города-получателя. Выбор города получателя доступен при помощи указания в поле “Индекс” его почтового индекса (программа определяет индексы России, но не определяет индексы других стран), либо ручной выбор из выпадающего списка области или региона получателя, а затем выбор города получателя из выпадающего списка городов. Обратите внимание, что под одним индексом может быть несколько городов/населенных пунктов и программа выбирает случайным образом один из них, поэтому необходимо проверить наличие необходимого города в списке городов, формируемом справа. В случае, когда необходим населенный пункт, которого нет в списке городов и известно, что город находится в конкретном регионе, то можно воспользоваться "поиском населенного пункта", для этого нажмите [[Файл:find.png|20px]]. Откроется новое окно, в котором можно искать по "Региону" и названию города. Также возникают ситуации, когда в одной области может быть несколько городов с одним названием, тогда они объединяются в программе как один.

Если необходимо отправить корреспонденцию в другую страну, то вместо города вводится название страны и города на английском языке. В базе программы присутствуют все города России и большинство городов мира, если необходимого города нет, то его можно добавить вручную и после прохождения модерации город появится в программе. Подробнее о [[Города |Добавлении городов]].

'''Правила написания адресов'''

В программе осуществляется интеграция с [[Терминология#Основные принципы работы в программе |КЛАДР]] и [[Терминология#Основные принципы работы в программе |ФИАС]], что позволяет осуществлять поиск адресов из актуальных баз. В карточке корреспонденции, в поле "Адрес получателя" используется автоподстановка адресов из баз. По введенному адресу автоматически определяется [[Метро |станцию метро]].

Правила написания адресов:
{| class="wikitable"
|-
! Правило || Пример
|-
|В начале пишется название улицы. Слово «дом» или сокращение «д.» при написании адреса не нужно. Формат записи содержит запятые, пробелы и точки || Щепкина ул., 42/2а, стр. 1, кв. 50, синяя дверь со стороны Профсоюзной ул.
|-
|Модификаторы названий, такие как «Большая», «Малая», «Нижняя» и т.п. (улица) сокращаются до одной буквы с точкой, и дальше слитно, без пробела, пишется само название || М.Каретный пер., 7, стр. 1
|-
|Порядковые числительные в названиях улиц пишутся перед названием улицы с наращением окончания до одной буквы через дефис || 4-й Лесной пер., 4; 3-я Ямского Поля ул., 2
|-
|Типы улиц пишутся полностью, кроме: «улица» — сокращается до «ул.», «переулок» - сокращается до «пер.» и «набережная» - до «наб.»|| Звездный бульвар, 23 с.10
|-
|Когда улица имеет исторически сложившееся название, не требующее указания типа || Маросейка, 15
|-
|Когда улица имеет тип, официально не считающийся типом || Коровий вал, 20
|-
|Названия городов с дефисом должны писаться именно с дефисом|| Санкт-Петербург (не Санкт Петербург)
|-
|При необходимости указания города в строке адреса сначала указываем наименование, потом пишем «город», «поселок» и т.д. || Видное город, им. Цюрупы рабочий поселок
|}

= Кнопки в программе =
[[Файл:History1.png]] — просмотр истории изменения.

[[Файл:Print.png]] — печать документов, заполняемых автоматически по шаблонам.

[[Файл:Icon docs.png]] — просмотр и добавление прикрепленных документов.

[[Файл:Message.png]] — просмотр истории переписки (СМС, e-mail, отправленные через программу).

[[Файл:Icon call.png]] — вызов через программу. Если у контакта несколько номеров, то можно выбрать любой из них. Используются Skype или программы для IP-телефонии.

[[Файл:Icon e-mail.png]] — отправка e-mail через программу. Можно использовать Outlook и подобные программы. Возможна работа с шаблонами.

[[Файл:Icon sms.png]] — отправка СМС, можно использовать готовые шаблоны.

[[Файл:Кнопка Поиск.png]] — поиск информации.

[[Файл:Settings.png]] — открывает настройки.

[[Файл:Globe.png]] — обзор всей карты. Позволяет увидеть все маркеры корреспонденции.

= Перейти к быстрому старту =

Эта статья первая в разделе [[Быстрый старт]]. Нажмите кнопку ниже, чтобы перейти к следующей по порядку статье.

<table style="width:100%">
<tr>
<td>
<p style="text-align:right">Следующий шаг</p>
[[File:right.png|link=Как_добавить_клиента|right|75px|Вперед]]
</td>
</tr>
</table>

Знакомство с программой

2022-05-24T14:53:16Z

Olga: /* Общие сведения об элементах управления */

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

[[Файл:2_interface.png|none|1200px]]

= Интерфейс =
[[Терминология#Основные принципы работы в программе |Интерфейс]] позволяет решать задачи пользователя через взаимосвязь «задача — элемент интерфейса».

Базовый интерфейс программы содержит основное меню, вкладки, таблицы, [[Основные принципы работы в программе#Кнопки в программе |кнопки]], фильтры отображения.

== Работа с таблицами ==
Вы можете изменять столбцы таблиц в любой части программы: менять местами перетаскиванием, сортировать по столбцу нажатием на заголовок, управлять данными таблицы через контекстное меню.

Виды сортировки:
* простая сортировка по одному столбцу по убыванию или возрастанию. Нажмите на заголовок столбца один раз — по возрастанию, второй раз — по убыванию;
* многоуровневая сортировка. Например, нужно отсортировать следующим образом: сначала по одному столбцу, внутри этой сортировки по какому-то другому столбцу, а внутри этой сортировки — по третьему и т. д. Для этого сначала нажмите левой кнопкой мыши на первый столбец, требующий сортировки, затем, удерживая нажатой клавишу CTRL, нажмите на заголовки столбцов в нужной последовательности.

Чтобы сбросить сортировку, выберите пункт контекстного меню заголовка '''Сбросить сортировку'''.

В контекстном меню на заголовке таблицы доступны следующие действия:
* '''Столбцы''' — просмотреть список всех возможных столбцов. Чтобы столбец отобразился в таблице, установите около него флажок. В окне «Столбцы» через контекстное меню можно выделить все столбцы, снять выделение со всех столбцов, сортировать по порядку или по названию;
* '''Скрыть столбец''' — скрыть текущий столбец;
* '''Шрифт''' — настроить шрифт, размер и цвет текста;
* '''Экспорт в Excel''' — выгрузить таблицу с текущими настройками отображения в файл Microsoft Excel. Пользователь должен иметь [[Пользователи|право]] «Экспортировать корреспонденции» (в узле «Отчеты»), чтобы выгружать таблицы с вкладки '''Адреса''' и '''Выдача''', и право «Экспортировать клиентов», чтобы выгружать данные вкладки '''Клиенты''';
* '''Шаблоны''' — создать шаблон с необходимыми столбцами. Подробнее см. раздел [[#Работа с шаблонами|«Работа с шаблонами»]];
* '''Обновить''' — обновить данные в таблице. Таблицы во вкладках '''Сотрудники''', '''Клиенты''' и '''Заказы''' обновляются автоматически с периодичностью 6 секунд. В остальных таблицах данные могут изменяться (другой пользователь может внести информацию или поступают данные через интеграцию), поэтому их стоит периодически обновлять;
* '''Сбросить сортировку''' — отменить сортировку. Опция активна, если предварительно в таблице была сделана сортировка по одному или нескольким столбцам.

=== Работа с шаблонами ===
Шаблоны позволяют создать таблицы с определенной очередностью столбцов под конкретные задачи. Для этого надо вывести нужные столбцы, выбрать пункт контекстного меню '''Шаблоны''', выбрать '''Сохранить''', указать название шаблона и нажать '''ОК'''.

Чтобы использовать шаблон, выберите пункт контекстного меню '''Шаблоны''' > '''Загрузить''' и укажите нужный шаблон.

Варианты работы с шаблонами таблиц на вкладке '''Адреса''':
* планирование доставки корреспонденции для городских или междугородних отправлений;
* шаблон таблицы для формирования отчета. Отобразите нужные столбцы (например, «Дата», «Масса», «Стоимость» и т.д) и сохраните как шаблон. Затем примените фильтр для компании, по которой формируется отчет и выгрузите данные из получившейся таблицы в Microsoft Excel. Для этого выберите пункт контекстного меню '''Экспорт в Excel'''.

Чтобы удалить шаблон, в контекстном меню заголовка столбца выберите пункт '''Шаблоны''' > '''Удалить''' и выберите из списка удаляемый шаблон.

=== Поиск информации ===

Поиск по ключевым словам позволяет найти точные совпадения в тексте и работает на всех вкладках, кроме '''Направления''' и '''Охрана'''. Для поиска информации нажмите комбинацию клавиш CTRL + F и введите искомые слова. Совпадения подсвечиваются на вкладке:

[[Файл:4_interface.png|900px]]

Вы можете перемещаться по найденным совпадениям с помощью стрелок [[Файл:Поиск вниз.png]] и [[Файл:Поиск вверх.png]] или ввести параметры, уточняющие поиск, по кнопке [[Файл:Поиск опции.png]].
Критерии поиска:
* '''Область поиска''' — часть таблицы, где будет производиться поиск. Возможные значения: '''Текущая колонка''', '''Вся таблица''';
* '''С учетом регистра''' — поиск ведется с учетом регистра поискового запроса;
* '''Целые слова''' — целые слова должны совпадать с введенным запросом;
* '''Начинается с''' — результат поиска будет начинаться с поискового запроса.

= Горячие клавиши =
Кнопки или комбинация кнопок, которые позволяют выполнить то или иное действие. Горячие клавиши могут быть не активны, если действие, которое они выполняют, заблокировано [[Сотрудники#Права пользователей |правами пользователя]].
{|class="wikitable" width="70%"
!style="width: 30%;"|Общие (действуют везде)
!style="width: 40%;"|Вкладка Адреса
!style="width: 30%;"|Вкладка Срочные
|-
|F1 — справка (CTRL+F1 для вкладки '''Срочные''' и карточки корреспонденции)

F3 — создать

ESC — закрыть

Enter — открыть

F11 — обновить список

CRTL+F8 — удалить выбранную позицию

CTRL+ALT+B — имитация считывания штрихкода

CTRL+P — печать
|
F1 — просмотреть информацию о заказе

F2 — сортировка

F4 — скопировать все адреса в срочные

F5 — ввод информации о доставке и предпросмотр прикрепленных фото

F6 — фильтр заказов

F7 — формирует отчет по выборке для денежных заданий

F8 — удалить из выборки

F9 — открывает окно экспорта выборки в Microsoft Excel с возможностью отправки информации по e-mail

CTRL+F1 — открыть карточку клиента

CTRL+F3 — создать заборную накладную по выборке

CTRL+F12, CTRL+P — печать ведомостей/наклеек

CTRL+ENTER (dblClick) — выбор по компании-получателю (выбрать только адреса с компанией-получателем, как у выбранного)

CTRL+S — показать на карте

CTRL+M — добавить в новый манифест (открытие карточки создания манифеста)

CTRL+T — принять в работу на завтра

CTRL+O — выбрать только выделенное

CTRL+К — выбор по запланированным курьерам (выбрать только адреса запланированные на того же курьера, что и выбранный)

CTRL+SHIFT+F10 — оплата доставки отправителем (если заказ с наличной оплатой, откроется карта внесения платежа)

BACKSPACE — предыдущая выборка

SHIFT+BACKSPACE — следующая выборка

|CTRL+F1 — справка

CTRL+F9 — печать таблицы

'''7''' — проставить «?» в курьере

'''8''' — показать карточку клиента

'''+''' — проставить «+» (в случае наличного заказа необходимо внести платеж)

'''-''' — проставить «V»

F1 — показать список работающих курьеров, заказы в разрезе курьеров

F2 — показать заказы в разрезе клиентов

F4 — уменьшить статус

F5 — увеличить статус
|}

{|class="wikitable" width="80%"
!style="width: 20%;"|Вкладка Сотрудники
!style="width: 25%;"|Вкладка Собеседования
!style="width: 30%;"|Вкладка Задания
!style="width: 25%;"|Окно Платежи
|-
|F9 — отчет «Работающие курьеры»
|F9 — составить отчет по собеседованиям
|CTRL+F3 — создать новое периодическое задание
|CTRL+F3 — посмотреть привязку к счетам
|}

{|class="wikitable" width="80%"
!style="width: 15%;"|Вкладка Клиенты
!style="width: 25%;"|Вкладка Выдача
!style="width: 22%;"|Вкладка Манифесты
!style="width: 20%;"|Вкладка Заказы
!style="width: 18%;"|Окно Счета
|-
|F2 — выставить счет

F5 — внести оплату

|F5 — проставить информацию о доставке в [[Карточка корреспонденции|карточке отправления]]

F12 — бонус/штраф курьера

CTRL+M — показать на карте

CTRL+ENTER — выбор по компании-получателю (выбрать только адреса с компанией-получателем, как у выбранного)

|CTRL+M — печатать манифест

SHIFT+CTRL+M — печатать манифест 2

CTRL+R — рентабельность

|SPACE (пробел) — открыть адреса выбранного заказа

F10 — [[Прием корреспонденции на склад]]

|F5 — внести оплату

F9 — детализация

CTRL+F9 — отчет по суммам и датам оплаты

CTRL+F12 — переместить в доставку

|}

= Общие сведения об элементах управления =

В определенных полях и формах программы используются упрощения ввода:
* в поле типа «Дата» и «Время» при нажатии клавиши SPACE (пробел) будет проставлены сегодняшнее число и время на компьютере;
* в поле типа «Дата» можно проставлять значение вида «121022», программа приводит это значение к общепринятому обозначению даты — 12.10.2022;
* в полях выбора сотрудника, например «Курьер», можно перемещаться между записями сотрудников клавишами PAGE UP и PAGE DOWN;
* вы можете устанавливать количество столбцов в меню. Например, в курьерской службе работает более 220 курьеров, тогда в контекстном меню '''Запланировать на курьера''' на вкладке '''Адреса''' записи объединяются по алфавиту. По такому же принципу происходит объединение и в других меню в программе. Чтобы настроить такое поведение, выберите основной пункт меню '''Настройка''' > '''Параметры''' > '''Отображение''' > '''Группировать пункты меню, если их больше''' и укажите количество пунктов.

= Сортировка списка адресов =
Сортировка — последовательное расположение или разбиение на группы чего-либо в зависимости от выбранного критерия. Изменить сортировку представленной табличной информации на вкладке “Адреса” можно по 5 типам:
*По заказу и номеру - сортировка используется по умолчанию при переходе из "Заказы" в "Адреса". В верху показываются последние заказы.
*По району - внутри района сортировка происходит по последовательности станций метро, а так же по получателю, в алфавитном порядке. При этой сортировке видны все заказы районов.
*По компании получателю - сортировка в алфавитном порядке компаний получателей.
*По заказу и району - корреспонденция из заказов сортируется с учетом районов.
*По сроку доставки и району - сортировка по двум полям, в верху будут отображаться заказы с наименьшим временем, которое осталось до окончания доставки, а так же используется разделение по районам.

== Ручная сортировка ==
[[Файл:12a_interface.png|300px|right|thumb|Сортировка по району]]
Этот тип сортировки предназначен для изменения порядка следования заказов (на вкладке “Адреса”) в ручном режиме. Ручная сортировка включается клавишей '''F2''' и доступна в следующих режимах:
*Сортировка по району;
*Сортировка по заказу и району;
*Сортировка по сроку доставки и району.

Для режимов сортировки, где присутствует район, слева отобразится пустой фиксированный столбец.

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

= Ввод адресной информации =

При определении станции метро программа считает улицей текст до первой запятой, а между первой и второй запятыми – номером дома. В первую очередь производится поиск по улице и номеру дома, а при отсутствии таких данных – только по улице. При сохранении корреспонденции программа сохраняет и соответствие станции метро для конкретной улицы и номера дома. Указанный формат написания адресов используется и для поля “Адрес” на вкладках: “Клиенты” и “Cотрудники” в карточках клиентов и сотрудников.
[[Файл:17_interface.png|300px|right|Город получателя]]
Для написания адреса доставки междугороднего отправления предусмотрен другой механизм, который помимо задания адреса требует указания региона (страны) и города-получателя. Выбор города получателя доступен при помощи указания в поле “Индекс” его почтового индекса (программа определяет индексы России, но не определяет индексы других стран), либо ручной выбор из выпадающего списка области или региона получателя, а затем выбор города получателя из выпадающего списка городов. Обратите внимание, что под одним индексом может быть несколько городов/населенных пунктов и программа выбирает случайным образом один из них, поэтому необходимо проверить наличие необходимого города в списке городов, формируемом справа. В случае, когда необходим населенный пункт, которого нет в списке городов и известно, что город находится в конкретном регионе, то можно воспользоваться "поиском населенного пункта", для этого нажмите [[Файл:find.png|20px]]. Откроется новое окно, в котором можно искать по "Региону" и названию города. Также возникают ситуации, когда в одной области может быть несколько городов с одним названием, тогда они объединяются в программе как один.

Если необходимо отправить корреспонденцию в другую страну, то вместо города вводится название страны и города на английском языке. В базе программы присутствуют все города России и большинство городов мира, если необходимого города нет, то его можно добавить вручную и после прохождения модерации город появится в программе. Подробнее о [[Города |Добавлении городов]].

'''Правила написания адресов'''

В программе осуществляется интеграция с [[Терминология#Основные принципы работы в программе |КЛАДР]] и [[Терминология#Основные принципы работы в программе |ФИАС]], что позволяет осуществлять поиск адресов из актуальных баз. В карточке корреспонденции, в поле "Адрес получателя" используется автоподстановка адресов из баз. По введенному адресу автоматически определяется [[Метро |станцию метро]].

Правила написания адресов:
{| class="wikitable"
|-
! Правило || Пример
|-
|В начале пишется название улицы. Слово «дом» или сокращение «д.» при написании адреса не нужно. Формат записи содержит запятые, пробелы и точки || Щепкина ул., 42/2а, стр. 1, кв. 50, синяя дверь со стороны Профсоюзной ул.
|-
|Модификаторы названий, такие как «Большая», «Малая», «Нижняя» и т.п. (улица) сокращаются до одной буквы с точкой, и дальше слитно, без пробела, пишется само название || М.Каретный пер., 7, стр. 1
|-
|Порядковые числительные в названиях улиц пишутся перед названием улицы с наращением окончания до одной буквы через дефис || 4-й Лесной пер., 4; 3-я Ямского Поля ул., 2
|-
|Типы улиц пишутся полностью, кроме: «улица» — сокращается до «ул.», «переулок» - сокращается до «пер.» и «набережная» - до «наб.»|| Звездный бульвар, 23 с.10
|-
|Когда улица имеет исторически сложившееся название, не требующее указания типа || Маросейка, 15
|-
|Когда улица имеет тип, официально не считающийся типом || Коровий вал, 20
|-
|Названия городов с дефисом должны писаться именно с дефисом|| Санкт-Петербург (не Санкт Петербург)
|-
|При необходимости указания города в строке адреса сначала указываем наименование, потом пишем «город», «поселок» и т.д. || Видное город, им. Цюрупы рабочий поселок
|}

= Кнопки в программе =
[[Файл:History1.png]] — просмотр истории изменения.

[[Файл:Print.png]] — печать документов, заполняемых автоматически по шаблонам.

[[Файл:Icon docs.png]] — просмотр и добавление прикрепленных документов.

[[Файл:Message.png]] — просмотр истории переписки (СМС, e-mail, отправленные через программу).

[[Файл:Icon call.png]] — вызов через программу. Если у контакта несколько номеров, то можно выбрать любой из них. Используются Skype или программы для IP-телефонии.

[[Файл:Icon e-mail.png]] — отправка e-mail через программу. Можно использовать Outlook и подобные программы. Возможна работа с шаблонами.

[[Файл:Icon sms.png]] — отправка СМС, можно использовать готовые шаблоны.

[[Файл:Кнопка Поиск.png]] — поиск информации.

[[Файл:Settings.png]] — открывает настройки.

[[Файл:Globe.png]] — обзор всей карты. Позволяет увидеть все маркеры корреспонденции.

= Перейти к быстрому старту =

Эта статья первая в разделе [[Быстрый старт]]. Нажмите кнопку ниже, чтобы перейти к следующей по порядку статье.

<table style="width:100%">
<tr>
<td>
<p style="text-align:right">Следующий шаг</p>
[[File:right.png|link=Как_добавить_клиента|right|75px|Вперед]]
</td>
</tr>
</table>

Статусы

2022-05-24T14:32:36Z

Olga:

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

[[Файл:Статусы.PNG|none]]

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

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

Действия со статусами совершаются с помощью контекстного меню статуса:
* '''Переименовать''' — переименовать выбранный статус;
* '''Добавить''' — добавить статус;
* '''Удалить''' — удалить выбранный статус;
* '''Изменить цвет''' — изменить цвет, которым подсвечивается строка или столбец с этим статусом в интерфейсе пользователя;
* '''Разрешения''' — настроить права доступа пользователей на установку выделенного статуса;
* '''Дополнительная информация''' — настроить дополнительные параметры статуса. См. ниже на примере настройки [[#виды срочности|видов срочности]];
* '''Выключить/включить''' — отключить или включить статус. Отключенные статусы отображаются перечеркнутыми;
* '''Скопировать путь''' — скопировать в буфер обмена программный путь статуса вида «"Справочники" -> "Статусы" -> "10 Статусы принятия на работу" -> "1 Не приглашен"».

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

Изменения в справочнике вступают в силу только после перезагрузки системы.

= Виды срочности =
Виды срочности настраиваются в справочнике '''Статусы''' > '''Виды срочности'''.

Удалять виды срочности нельзя, но можно отключить неиспользуемые. Для этого в контекстном меню записи вида срочности выберите '''Выключить/Включить'''.

Чтобы настроить параметры, в контекстном меню вида срочности выберите ''' Дополнительная информация'''. Откроется окно настройки:

[[Файл:Виды срочности.png|none]]

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

Параметры видов срочности и особенности настройки перечислены в таблице:

{|class="wikitable" align="center" style="width: 80%;
!style="width: 5%;"|Параметр
!style="width: 45%;"|Описание
!style="width: 50%;"|Возможные значения, пояснения
|-
| colspan="3" style="text-align:center;" | Строка 1 — общие параметры
|-
|1||Срок доставки в рабочих днях||'''0''' — доставка сегодня,<br> '''1''' — доставка сегодня или завтра,<br>'''2 и больше или пусто''' — в штатном режиме.<br>Значения 0 и 1 подсвечивают недоставивших курьеров в выдаче
|-
|2||Cокращенное название вида срочности ||Для печати и отчетов
|-
|3||Доступность в ЛК||'''Пусто/0''' — доступен,<br>'''1''' — недоступен,<br>'''2''' — доступен только для доставки,<br>'''3''' — доступен только для заборов,<br>'''4''' — в ЛК недоступен, используется только для интеграций
|-
|4||Отображение в ЛК при импорте из Excel||Принудительно, независимо от значения 3 параметра<br>'''0''' — не отображать, <br>'''1''' — отображать
|-
|5||Виды срочности, учитываемые при тарификации забора по количеству доставок||Значение указывается в формате 'X,Y,Z'<br>Если параметр пустой, учитываются все виды срочности
|-
|6||Вид срочности для деления стоимости доставки на 2 этапа||Первый этап — доставка до регионального центра, рассчитывается по указанному в параметре виду срочности; второй этап — до клиента
|-
|7||Преобразование адреса для новых заказов||'''0''' — преобразовывать адрес согласно справочнику автозамен '''Связь''' > '''Импорт БД из Excel''' > '''Автозамена''', <br> '''1''' — отключить преобразование адреса для новых заказов
|-
|8||Типы клиентов, которым доступен этот режим срочности в заказах||'''0''' — режим срочности доступен неавторизованному пользователю в калькуляторе <br> Типы клиентов хранятся в справочнике '''Справочники''' > '''Статусы''' > '''Типы клиентов'''<br>
|-
| colspan="3" style="text-align:center;" | Строка 2 — параметры для [[Интеграция_с_другими_системами#Сквозная интеграция|сквозной интеграции]]
|-
|1||Код филиала партнера||Код можно посмотреть в '''Справочники''' > '''Межгород''' > '''Филиалы'''. Можно в одинарных кавычках указать несколько ответственных филиалов через запятую, тогда режим срочности будет доступен для всех перечисленных филиалов. Для версии системы 2021.0.0.38 и выше вместо кода филиала можно указать знак вопроса (?), это обозначит доступность режима срочности для всех филиалов
|-
|2||Экстра-код партнера в системе MeaSoft|| Коды для сторонних компаний приведены в [[Интеграция_с_другими_системами#Настройка интеграции|таблице]]
|-
|3||Имя пользователя в системе партнера||Может отличаться от того, под которым работает интеграция, здесь нужно для расчета цены для клиента
|-
|4||Пароль пользователя, указанного в 3 параметре||
|-
|5||Вид срочности партнера||Посмотреть доступные коды видов срочности можно по ссылке в [[Интеграция_с_другими_системами#Настройка интеграции|таблице]], в калькуляторе в выпадающем списке. Можно в одинарных кавычках указать несколько видов срочности через запятую, тогда система будет выбирать из них первый доступный
|-
|6||Наценка к стоимости, передаваемой подрядчиком||В деньгах или в процентах, если стоит знак процента. Например 10 — наценка 10 рублей, 10% — наценка 10 процентов
|-
|7||Отключение сквозной интеграции||'''1''' — выключить сквозную тарификацию. Параметр используется, если подключение нужно только для передачи заказов по интеграции, а расчет цены не нужен
|-
|8||Поиск наименьшей стоимости|| '''1''' — искать самый дешевый тариф в указанных режимах срочности партнера. Работает для СДЭК и Почты России
|}

Тарифы

2022-05-24T14:19:06Z

Olga: /* Тарифы клиентов */

В программе MeaSoft тарифы на доставку представлены в следующих видах:
* тарифы клиентов. Подробнее см. раздел [[Тарифы#Тарифы клиентов|«Тарифы клиентов»]];
* тарифы курьеров. Влияют на заработную плату курьера. Подробнее см. раздел [[Зарплата|«Зарплата»]];
* тарифы агентов. Определяют стоимость услуг контрагентов. Подробнее см. раздел [[Тарифы#Тарифы агентов|«Тарифы агентов»]].

==Тарифы клиентов==

Определяют стоимость доставки для клиента. Делятся на:
* [[Тарифы клиентов#Городские отправления|тарифы на доставку по городу и области]];
* [[Тарифы клиентов#Междугородние отправления|междугородние тарифы]].

Для клиентов можно настроить индивидуальные тарифы как на городскую доставку, так и на межгород.

В таблице ниже указаны места настройки клиентских тарифов и представлены ссылки на разделы с их описанием:

{|class="wikitable"
!Область применения тарифа
!Общие тарифы
!Индивидуальные тарифы
|-
|Город и область||Справочник '''[[Тарифы клиентов|Тарифы]]'''||- флажок в [[Клиенты и партнеры#Финансы|карточке клиента]]; <br>- копированием общего тарифа; <br>- переменная '''Справочники''' > '''Переменные''' > '''Клиенты''' > '''Индивидуальные тарифы'''
|-
|Межгород||Справочник '''[[Тарифы по зонам|Тарифы по зонам]]'''||- '''Тарифы''' > '''[[Тарифы клиентов#Междугородние отправления|Межгород]]'''; <br>- копированием общего тарифа
|-
|}

==Предварительные шаги==

Перед настройкой тарифа выполните следующие шаги:
# Создайте [[виды срочности]].
# Нарисуйте [[Зоны на карте|зоны доставки]] при необходимости. По умолчанию для Москвы и Санкт-Петербурга установлены следующие зоны:
#* 1 — зона внутри МКАД/КАД;
#* 2 — зона за МКАД/КАД.

Тарификация при [[Модуль Карта#Единое районирование|едином районировании]] ведется по зонам на карте.

===Тарифы на городскую доставку ===

Городские отправления тарифицируются с помощью справочника '''[[Тарифы клиентов|Тарифы]]'''.

=== Тарифы на междугороднюю доставку ===

Настройка междугородних тарифов заключается в последовательном заполнении данных следующих таблиц:
* '''[[Зоны]]'''. Таблица городов-получателей и городов-отправителей, на пересечении которых определяется номер зоны в виде цифрового значения для другой таблицы — '''Тарифы по зонам'''.<br>Рекомендуется вносить в таблицу только региональные центры. Остальные населенные пункты региона тарифицируются с помощью [[Коэффициенты|коэффициентов]] в записи регионального центра;
* '''[[Тарифы по зонам|Тарифы]]'''. Таблица тарификации отправлений по зонам позволяет настроить стоимость доставки в зависимости от массы, режима срочности и количества отправлений.

====Общие междугородние тарифы====

Общие тарифы межгорода настраиваются при помощи трех справочников основного меню системы '''Справочники''' > '''Межгород''':
* '''[[Города]]''' — справочник позволяет добавить отсутствующий в системе населенный пункт;
* '''[[Зоны]]''' — устанавливаются зоны доставки;
* '''[[Тарифы по зонам]]''' — устанавливается тарификация для указанных зон.

Рекомендуется в первую очередь настроить тарифы для основных городов доставки. В дальнейшем при необходимости добавьте малые города, в которые была хоть одна доставка.

====Индивидуальные междугородние тарифы====

Тарифы межгорода можно настроить индивидуально из [[Тарифы клиентов#Междугородние отправления|карточки тарифа клиента]].

Чтобы настроить индивидуальный тариф, перейдите в '''Справочники''' > '''Тарифы''', откройте нужный тариф и на вкладке '''Межгород''' установите флажки '''Индивидуальные тарифы по зонам''' и '''Индивидуальные зоны'''. Порядок действий аналогичен порядку настройки общих [[Зоны|зон]] и [[Тарифы по зонам|тарифов]].

Если настроен индивидуальный междугородний тариф, то он перекрывает общий междугородний тариф.

[[Файл:Ред тарифа межгород.png|none|500 px]]

== Тарифы агентов ==

Тарифы агентов хранятся в справочнике '''[[Филиалы]]'''.

Чтобы создать тариф агента:
# Откройте '''Справочники''' > '''Межгород''' > '''Филиалы''', выберите филиал в списке и в карточке филиала перейдите на вкладку '''Тариф'''.
# С помощью кнопок '''Зоны''' и '''Тарифы по зонам''' настройте зоны и тарифы по зонам аналогично настройке [[Тарифы#Тарифы на междугороднюю доставку|тарифов на междугородную доставку]].

Чтобы увидеть агентскую цену, откройте карточку корреспонденции, перейдите на вкладку '''Межгород''' и справа от поля '''Отв. филиал''' нажмите на кнопку [[Файл:Кнопка точки.png]]. Откроется окно с агентским тарифами. Таким образом можно увидеть, какие филиалы или ПВЗ могут доставить корреспонденцию в указанный город с учетом их ограничений.

Если окно с агентскими тарифами не открывается, значит не выполнены следующие условия:
* на вкладке '''Тарифы''' в карточке филиала должны быть настроены зоны доставки в город-получатель, указанный в карточке корреспонденции;
* филиал подходит по условиям доставки: максимальный вес, прием платежей, оплата картой;
* в карточке филиала должен быть установлен флажок '''Работающий'''.

Стоимость доставки считается у <rspoiler text="основных филиалов">Филиал считается основным, если в карточке филиала на вкладке '''Основное''' в поле '''Подчинен филиалу''' установлено '''Нет'''</rspoiler>.

Подчиненные филиалы отображаются, если включена переменная '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Использовать только доступные города''' и настроены зоны доставки филиалов.

Статусная модель

2022-05-24T13:22:15Z

Olga: /* Виды статусов */

=Виды статусов =
Основные виды статусов, связанные с доставкой отправлений:
* статус корреспонденции — пользовательский статус отправления, отображается в [[Карточка корреспонденции#Общие поля|карточке корреспонденции]]. Значения можно добавлять и изменять в справочнике '''Статусы''' > '''15 Статусы корреспонденции''';
* статус срочного заказа — системный статус выполнения [[Срочные заказы#Вкладка «Срочные»|срочного заказа]]. Статусы определены в справочнике '''Статусы''' > '''3 Статусы для срочных'''. Вы можете изменить название статуса и цвет, которым окрашена соответствующая строка в таблице. Количество статусов изменить нельзя;
* статус клиента — дополнительные статусы отправления, настраиваются по просьбе клиента в случае использования своего набора статусов. Подробнее см. раздел [[Клиенты и партнеры#Основное|«Клиенты и партнеры»]];
* статус манифеста — системные статусы, хранятся в справочнике '''Статусы''' > '''43 Системные''' > '''63 Статусы манифестов'''. Статусы нельзя изменять, можно выбрать их цвета. Подробнее см. в разделе [[Манифесты#Статусы манифеста|«Статусы манифеста»]];
* статус со слов курьера — статус доставки, который сообщает курьер, отображается на вкладке [[Выдача корреспонденции курьерам#Вкладка «Выдача»|'''Выдача''']]. Значения статуса хранятся в справочнике '''Статусы''' > '''43 Системные''' > '''64 Статусы со слов курьера'''. Если включена переменная '''Справочники''' > '''Переменные''' > '''Выдача''' > '''Использовать статус со слов курьера в первую очередь''', то в карточке корреспонденции в поле '''Инфо о доставке''' копируется примечание, которое курьер указал в мобильном приложении при проставлении статуса недоставки, и вне зависимости от статуса выдачи всегда будет проставлен тот, который указан в статусе со слов курьера;
* статус выдачи — статус доставки, которые [[Выдача корреспонденции курьерам#Статус выдачи|устанавливает]] менеджер в офисе при приемке работы курьера, отображается на вкладке [[Выдача корреспонденции курьерам#Вкладка «Выдача»|'''Выдача''']]. Значения статуса хранятся в справочнике '''Справочники''' > '''Статусы''' > '''8 Статусы выдачи'''. Пользователи могут только переименовывать и назначать цвета статусов выдачи;
* статусы трекинга — системные статусы, устанавливаются автоматически, пользователь не может их изменить. Значения статуса хранятся в справочнике '''Справочники''' > '''Статусы''' > '''43 Системные''' > '''1 Статусы трекинга'''.

==Статусы трекинга ==

Статусы трекинга отображаются:
* в карточке отправления — '''Функции''' > '''История статусов''';
* в ответах на запрос по [[API#Запрос статуса заказов|API]];
* в [[Личный кабинет курьерской службы#Отслеживание заказа по номеру|трекинге]] заказа в личном кабинете;
* в информации по заказу в ЛК клиента, в офисной системе можно вывести столбец со статусами на вкладке '''Адреса'''.

В таблице ниже указаны события, при наступлении каждого из которых устанавливается определенный статус трекинга.

{|class = "wikitable" style = "width: 80%;"
!Код статуса
!Название
!В каких случаях устанавливается статус
|-
|AWAITING_SYNC||Ожидает синхронизации||Служба доставки еще не получила данные заказа
|-
|NEW||Новый||Добавлено отправление на вкладке '''Адреса'''
|-
|NEWPICKUP||Создан забор||Добавлено отправление на вкладке '''Адреса''' типа «забор» (номер 0)
|-
|PICKUP||Забран у отправителя||Если отправлению типа «забор» установили статус «Доставлено» или доставочную кор-ию приняли через мобильное приложение по забору или в мобильном приложении в заявке на забор установлен статус «Получено».
|-
|WMSASSEMBLED||Скомплектован на складе фулфилмента||На складе ответственного хранения скомплектовали отправление
|-
|WMSDISASSEMBLED|| Разукомплектован на склад фулфилмента||На складе ответственного хранения разукомплектовали отправление
|-
|ACCEPTED||Получен складом||Отправление [[Прием корреспонденции на склад#Прием корреспонденции|принято]] на склад
|-
|CUSTOMSPROCESS||Производится таможенный контроль||Установлен статус отправления, указанный в переменной '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Статусы таможенного контроля в процессе'''. Подробнее см. раздел [[Манифесты#Таможенное оформление отправления|«Таможенное оформление отправления»]]
|-
|CUSTOMSFINISHED|| Таможенный контроль произведен||Установлен статус отправления, указанный в переменной '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Статусы пройденного таможенного контроля'''. Подробнее см. раздел [[Манифесты#Таможенное оформление отправления|«Таможенное оформление отправления»]]
|-
|CONFIRM||Согласована доставка||Установлен статус отправления, указанный в переменной '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Статусы успешного согласования доставки'''
|-
|UNCONFIRM||Не удалось согласовать доставку||Установлен статус отправления, указанный в переменной '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Статусы НЕ успешного согласования доставки'''.
|-
|DEPARTURING||Планируется отправка||Отправление запланировано в манифест
|-
|DEPARTURE||Отправлено со склада||В манифесте указали дату отправки и отсканировали отправление в мешок
|-
|INVENTORY||Инвентаризация||Отправление отсканировано в интерфейсе функции [[Функции#Инвентаризация корреспонденции|«Инвентаризация корреспонденции»]]
|-
|PICKUPREADY||Готов к выдаче||Если получатель — ПВЗ, и отправление принято на ПВЗ
|-
|DELIVERY||Выдан курьеру на доставку||Отправление выдается курьеру, статус в выдаче — «На руках»
|-
|COURIERDELIVERED||Доставлен (предварительно)||Отправлению установлен статус со слов курьера '''Доставлено''' или статус в выдаче '''Доставлено'''
|-
|COURIERPARTIALLY||Частично со слов курьера||Установлен статус со слов курьера «Частично доставлено»
|-
|COURIERCANCELED||Отказ со слов курьера ||Установлен статус со слов курьера «Не доставлено»
|-
|COURIERRETURN||Возвращено курьером (курьер вернул на склад)||Курьер не смог доставить отправление получателю и вернул заказ обратно на склад. Это промежуточный статус, после которого оператор выясняет, нужно ли еще раз доставлять заказ или это окончательная недоставка. Статус отправления в выдаче «Не доставлено» или «Не доставлено по причине»
|-
|DATECHANGE||Перенос||Изменена плановая дата доставки
|-
|COMPLETE||Доставлен||В карточке отправления указаны дата и время вручения
|-
|PARTIALLY||Доставлен частично||В карточке отправления указаны дата и время вручения, но есть возвраты вложений
|-
|CANCELED||Не доставлен (Возврат/Отмена)||В карточке отправления указана только дата вручения, без времени
|-
|RETURNING||Планируется возврат||Отправление отсканировано в интерфейсе [[Акты_передачи_денег_и_корреспонденции#Акты передачи корреспонденции (АПК)|АПК]]
|-
|RETURNED||Возвращен||В АПК указали дату отправки
|-
|LOST||Утрачен||В карточке корреспонденции установлен флажок '''Утрачено'''
|}

Статусная модель

2022-05-24T09:10:31Z

Olga: /* Виды статусов */

=Виды статусов =
Основные виды статусов, связанные с доставкой отправлений:
* статус корреспонденции — пользовательский статус отправления, отображается в [[Карточка корреспонденции#Общие поля|карточке корреспонденции]]. Значения можно добавлять и изменять в справочнике '''Статусы''' > '''15 Статусы корреспонденции''';
* статус клиента — дополнительные статусы отправления, настраиваются по просьбе клиента в случае использования своего набора статусов. Подробнее см. раздел [[Клиенты и партнеры#Основное|«Клиенты и партнеры»]];
* статус манифеста — системные статусы, хранятся в справочнике '''Статусы''' > '''43 Системные''' > '''63 Статусы манифестов'''. Статусы нельзя изменять, можно выбрать их цвета. Подробнее см. в разделе [[Манифесты#Статусы манифеста|«Статусы манифеста»]];
* статус со слов курьера — статус доставки, который сообщает курьер, отображается на вкладке [[Выдача корреспонденции курьерам#Вкладка «Выдача»|'''Выдача''']]. Значения статуса хранятся в справочнике '''Статусы''' > '''43 Системные''' > '''64 Статусы со слов курьера'''. Если включена переменная '''Справочники''' > '''Переменные''' > '''Выдача''' > '''Использовать статус со слов курьера в первую очередь''', то в карточке корреспонденции в поле '''Инфо о доставке''' копируется примечание, которое курьер указал в мобильном приложении при проставлении статуса недоставки, и вне зависимости от статуса выдачи всегда будет проставлен тот, который указан в статусе со слов курьера;
* статус выдачи — статус доставки, которые [[Выдача корреспонденции курьерам#Статус выдачи|устанавливает]] менеджер в офисе при приемке работы курьера, отображается на вкладке [[Выдача корреспонденции курьерам#Вкладка «Выдача»|'''Выдача''']]. Значения статуса хранятся в справочнике '''Справочники''' > '''Статусы''' > '''8 Статусы выдачи'''. Пользователи могут только переименовывать и назначать цвета статусов выдачи;
* статусы трекинга — системные статусы, устанавливаются автоматически, пользователь не может их изменить. Значения статуса хранятся в справочнике '''Справочники''' > '''Статусы''' > '''43 Системные''' > '''1 Статусы трекинга'''.

==Статусы трекинга ==

Статусы трекинга отображаются:
* в карточке отправления — '''Функции''' > '''История статусов''';
* в ответах на запрос по [[API#Запрос статуса заказов|API]];
* в [[Личный кабинет курьерской службы#Отслеживание заказа по номеру|трекинге]] заказа в личном кабинете;
* в информации по заказу в ЛК клиента, в офисной системе можно вывести столбец со статусами на вкладке '''Адреса'''.

В таблице ниже указаны события, при наступлении каждого из которых устанавливается определенный статус трекинга.

{|class = "wikitable" style = "width: 80%;"
!Код статуса
!Название
!В каких случаях устанавливается статус
|-
|AWAITING_SYNC||Ожидает синхронизации||Служба доставки еще не получила данные заказа
|-
|NEW||Новый||Добавлено отправление на вкладке '''Адреса'''
|-
|NEWPICKUP||Создан забор||Добавлено отправление на вкладке '''Адреса''' типа «забор» (номер 0)
|-
|PICKUP||Забран у отправителя||Если отправлению типа «забор» установили статус «Доставлено» или доставочную кор-ию приняли через мобильное приложение по забору или в мобильном приложении в заявке на забор установлен статус «Получено».
|-
|WMSASSEMBLED||Скомплектован на складе фулфилмента||На складе ответственного хранения скомплектовали отправление
|-
|WMSDISASSEMBLED|| Разукомплектован на склад фулфилмента||На складе ответственного хранения разукомплектовали отправление
|-
|ACCEPTED||Получен складом||Отправление [[Прием корреспонденции на склад#Прием корреспонденции|принято]] на склад
|-
|CUSTOMSPROCESS||Производится таможенный контроль||Установлен статус отправления, указанный в переменной '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Статусы таможенного контроля в процессе'''. Подробнее см. раздел [[Манифесты#Таможенное оформление отправления|«Таможенное оформление отправления»]]
|-
|CUSTOMSFINISHED|| Таможенный контроль произведен||Установлен статус отправления, указанный в переменной '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Статусы пройденного таможенного контроля'''. Подробнее см. раздел [[Манифесты#Таможенное оформление отправления|«Таможенное оформление отправления»]]
|-
|CONFIRM||Согласована доставка||Установлен статус отправления, указанный в переменной '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Статусы успешного согласования доставки'''
|-
|UNCONFIRM||Не удалось согласовать доставку||Установлен статус отправления, указанный в переменной '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Статусы НЕ успешного согласования доставки'''.
|-
|DEPARTURING||Планируется отправка||Отправление запланировано в манифест
|-
|DEPARTURE||Отправлено со склада||В манифесте указали дату отправки и отсканировали отправление в мешок
|-
|INVENTORY||Инвентаризация||Отправление отсканировано в интерфейсе функции [[Функции#Инвентаризация корреспонденции|«Инвентаризация корреспонденции»]]
|-
|PICKUPREADY||Готов к выдаче||Если получатель — ПВЗ, и отправление принято на ПВЗ
|-
|DELIVERY||Выдан курьеру на доставку||Отправление выдается курьеру, статус в выдаче — «На руках»
|-
|COURIERDELIVERED||Доставлен (предварительно)||Отправлению установлен статус со слов курьера '''Доставлено''' или статус в выдаче '''Доставлено'''
|-
|COURIERPARTIALLY||Частично со слов курьера||Установлен статус со слов курьера «Частично доставлено»
|-
|COURIERCANCELED||Отказ со слов курьера ||Установлен статус со слов курьера «Не доставлено»
|-
|COURIERRETURN||Возвращено курьером (курьер вернул на склад)||Курьер не смог доставить отправление получателю и вернул заказ обратно на склад. Это промежуточный статус, после которого оператор выясняет, нужно ли еще раз доставлять заказ или это окончательная недоставка. Статус отправления в выдаче «Не доставлено» или «Не доставлено по причине»
|-
|DATECHANGE||Перенос||Изменена плановая дата доставки
|-
|COMPLETE||Доставлен||В карточке отправления указаны дата и время вручения
|-
|PARTIALLY||Доставлен частично||В карточке отправления указаны дата и время вручения, но есть возвраты вложений
|-
|CANCELED||Не доставлен (Возврат/Отмена)||В карточке отправления указана только дата вручения, без времени
|-
|RETURNING||Планируется возврат||Отправление отсканировано в интерфейсе [[Акты_передачи_денег_и_корреспонденции#Акты передачи корреспонденции (АПК)|АПК]]
|-
|RETURNED||Возвращен||В АПК указали дату отправки
|-
|LOST||Утрачен||В карточке корреспонденции установлен флажок '''Утрачено'''
|}

Статусная модель

2022-05-24T08:35:17Z

Olga: /* Статусы трекинга */

=Виды статусов =
Основные виды статусов, связанные с доставкой отправлений:
* статус корреспонденции — пользовательский статус отправления, отображается в [[Карточка корреспонденции#Общие поля|карточке корреспонденции]]. Значения можно добавлять и изменять в справочнике '''Статусы''' > '''15 Статусы корреспонденции''';
* статус клиента — дополнительные статусы отправления, настраиваются по просьбе клиента в случае использования своего набора статусов. Подробнее см. раздел [[Клиенты и партнеры#Основное|«Клиенты и партнеры»]];
* статус манифеста — системные статусы, хранятся в справочнике '''Статусы''' > '''43 Системные''' > '''63 Статусы манифестов'''. Статусы нельзя изменять, можно выбрать их цвета. Подробнее см. в разделе [[Манифесты#Статусы манифеста|«Статусы манифеста»]];
* статус со слов курьера — статус доставки, который сообщает курьер, отображается на вкладке [[Выдача корреспонденции курьерам#Вкладка «Выдача»|'''Выдача''']]. Значения статуса хранятся в справочнике '''Статусы''' > '''43 Системные''' > '''64 Статусы со слов курьера'''. Если включена переменная '''Справочники''' > '''Переменные''' > '''Выдача''' > '''Использовать статус со слов курьера в первую очередь''', то в карточке корреспонденции в поле '''Инфо о доставке''' копируется примечание, которое курьер указал в мобильном приложении при проставлении статуса недоставки, и вне зависимости от статуса выдачи всегда будет проставлен тот, который указан в статусе со слов курьера;
* статус выдачи — статус доставки, которые [[Выдача корреспонденции курьерам#Статус выдачи|устанавливает]] менеджер в офисе при приемке работы курьера, отображается на вкладке [[Выдача корреспонденции курьерам#Вкладка «Выдача»|'''Выдача''']. Значения статуса хранятся в справочнике '''Справочники''' > '''Статусы''' > '''8 Статусы выдачи'''. Пользователи могут только переименовывать и назначать цвета статусов выдачи;
* статусы трекинга — системные статусы, устанавливаются автоматически, пользователь не может их изменить. Значения статуса хранятся в справочнике '''Справочники''' > '''Статусы''' > '''43 Системные''' > '''1 Статусы трекинга'''.

==Статусы трекинга ==

Статусы трекинга отображаются:
* в карточке отправления — '''Функции''' > '''История статусов''';
* в ответах на запрос по [[API#Запрос статуса заказов|API]];
* в [[Личный кабинет курьерской службы#Отслеживание заказа по номеру|трекинге]] заказа в личном кабинете;
* в информации по заказу в ЛК клиента, в офисной системе можно вывести столбец со статусами на вкладке '''Адреса'''.

В таблице ниже указаны события, при наступлении каждого из которых устанавливается определенный статус трекинга.

{|class = "wikitable" style = "width: 80%;"
!Код статуса
!Название
!В каких случаях устанавливается статус
|-
|AWAITING_SYNC||Ожидает синхронизации||Служба доставки еще не получила данные заказа
|-
|NEW||Новый||Добавлено отправление на вкладке '''Адреса'''
|-
|NEWPICKUP||Создан забор||Добавлено отправление на вкладке '''Адреса''' типа «забор» (номер 0)
|-
|PICKUP||Забран у отправителя||Если отправлению типа «забор» установили статус «Доставлено» или доставочную кор-ию приняли через мобильное приложение по забору или в мобильном приложении в заявке на забор установлен статус «Получено».
|-
|WMSASSEMBLED||Скомплектован на складе фулфилмента||На складе ответственного хранения скомплектовали отправление
|-
|WMSDISASSEMBLED|| Разукомплектован на склад фулфилмента||На складе ответственного хранения разукомплектовали отправление
|-
|ACCEPTED||Получен складом||Отправление [[Прием корреспонденции на склад#Прием корреспонденции|принято]] на склад
|-
|CUSTOMSPROCESS||Производится таможенный контроль||Установлен статус отправления, указанный в переменной '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Статусы таможенного контроля в процессе'''. Подробнее см. раздел [[Манифесты#Таможенное оформление отправления|«Таможенное оформление отправления»]]
|-
|CUSTOMSFINISHED|| Таможенный контроль произведен||Установлен статус отправления, указанный в переменной '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Статусы пройденного таможенного контроля'''. Подробнее см. раздел [[Манифесты#Таможенное оформление отправления|«Таможенное оформление отправления»]]
|-
|CONFIRM||Согласована доставка||Установлен статус отправления, указанный в переменной '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Статусы успешного согласования доставки'''
|-
|UNCONFIRM||Не удалось согласовать доставку||Установлен статус отправления, указанный в переменной '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Статусы НЕ успешного согласования доставки'''.
|-
|DEPARTURING||Планируется отправка||Отправление запланировано в манифест
|-
|DEPARTURE||Отправлено со склада||В манифесте указали дату отправки и отсканировали отправление в мешок
|-
|INVENTORY||Инвентаризация||Отправление отсканировано в интерфейсе функции [[Функции#Инвентаризация корреспонденции|«Инвентаризация корреспонденции»]]
|-
|PICKUPREADY||Готов к выдаче||Если получатель — ПВЗ, и отправление принято на ПВЗ
|-
|DELIVERY||Выдан курьеру на доставку||Отправление выдается курьеру, статус в выдаче — «На руках»
|-
|COURIERDELIVERED||Доставлен (предварительно)||Отправлению установлен статус со слов курьера '''Доставлено''' или статус в выдаче '''Доставлено'''
|-
|COURIERPARTIALLY||Частично со слов курьера||Установлен статус со слов курьера «Частично доставлено»
|-
|COURIERCANCELED||Отказ со слов курьера ||Установлен статус со слов курьера «Не доставлено»
|-
|COURIERRETURN||Возвращено курьером (курьер вернул на склад)||Курьер не смог доставить отправление получателю и вернул заказ обратно на склад. Это промежуточный статус, после которого оператор выясняет, нужно ли еще раз доставлять заказ или это окончательная недоставка. Статус отправления в выдаче «Не доставлено» или «Не доставлено по причине»
|-
|DATECHANGE||Перенос||Изменена плановая дата доставки
|-
|COMPLETE||Доставлен||В карточке отправления указаны дата и время вручения
|-
|PARTIALLY||Доставлен частично||В карточке отправления указаны дата и время вручения, но есть возвраты вложений
|-
|CANCELED||Не доставлен (Возврат/Отмена)||В карточке отправления указана только дата вручения, без времени
|-
|RETURNING||Планируется возврат||Отправление отсканировано в интерфейсе [[Акты_передачи_денег_и_корреспонденции#Акты передачи корреспонденции (АПК)|АПК]]
|-
|RETURNED||Возвращен||В АПК указали дату отправки
|-
|LOST||Утрачен||В карточке корреспонденции установлен флажок '''Утрачено'''
|}

Статусная модель

2022-05-24T08:20:41Z

Olga: Olga переименовала страницу Статусная модель в программе в Статусная модель

=Виды статусов =
Основные виды статусов, связанные с доставкой отправлений:
* статус корреспонденции — пользовательский статус отправления, отображается в [[Карточка корреспонденции#Общие поля|карточке корреспонденции]]. Значения можно добавлять и изменять в справочнике '''Статусы''' > '''15 Статусы корреспонденции''';
* статус клиента — дополнительные статусы отправления, настраиваются по просьбе клиента в случае использования своего набора статусов. Подробнее см. раздел [[Клиенты и партнеры#Основное|«Клиенты и партнеры»]];
* статус манифеста — системные статусы, хранятся в справочнике '''Статусы''' > '''43 Системные''' > '''63 Статусы манифестов'''. Статусы нельзя изменять, можно выбрать их цвета. Подробнее см. в разделе [[Манифесты#Статусы манифеста|«Статусы манифеста»]];
* статус со слов курьера — статус доставки, который сообщает курьер, отображается на вкладке [[Выдача корреспонденции курьерам#Вкладка «Выдача»|'''Выдача''']]. Значения статуса хранятся в справочнике '''Статусы''' > '''43 Системные''' > '''64 Статусы со слов курьера'''. Если включена переменная '''Справочники''' > '''Переменные''' > '''Выдача''' > '''Использовать статус со слов курьера в первую очередь''', то в карточке корреспонденции в поле '''Инфо о доставке''' копируется примечание, которое курьер указал в мобильном приложении при проставлении статуса недоставки, и вне зависимости от статуса выдачи всегда будет проставлен тот, который указан в статусе со слов курьера;
* статус выдачи — статус доставки, которые [[Выдача корреспонденции курьерам#Статус выдачи|устанавливает]] менеджер в офисе при приемке работы курьера, отображается на вкладке [[Выдача корреспонденции курьерам#Вкладка «Выдача»|'''Выдача''']. Значения статуса хранятся в справочнике '''Справочники''' > '''Статусы''' > '''8 Статусы выдачи'''. Пользователи могут только переименовывать и назначать цвета статусов выдачи;
* статусы трекинга — системные статусы, устанавливаются автоматически, пользователь не может их изменить. Значения статуса хранятся в справочнике '''Справочники''' > '''Статусы''' > '''43 Системные''' > '''1 Статусы трекинга'''.

==Статусы трекинга ==

Статусы трекинга отображаются:
* в карточке отправления — '''Функции''' > '''История статусов''';
* в ответах на запрос по [[API#Запрос статуса заказов|API]];
* в [[Личный кабинет курьерской службы#Отслеживание заказа по номеру|трекинге]] заказа в личном кабинете;
* в информации по заказу в ЛК клиента, в офисной системе можно вывести столбец со статусами на вкладке '''Адреса'''.

В таблице ниже указаны события, при наступлении каждого из которых устанавливается определенный статус трекинга.

{|class = "wikitable" style = "width: 80%;"
!Код статуса
!Название
!В каких случаях устанавливается статус
|-
|AWAITING_SYNC||Ожидает синхронизации||Служба доставки еще не получила данные заказа
|-
|NEW||Новый||Добавлено отправление на вкладке '''Адреса'''
|-
|NEWPICKUP||Создан забор||Добавлено отправление на вкладке '''Адреса''' типа «забор» (номер 0 и штрихкод "")
|-
|PICKUP||Забран у отправителя||Если отправлению типа «забор» установили статус «Доставлено» или доставочную кор-ию приняли через мобильное приложение по забору или в мобильном приложении в заявке на забор установлен статус «Получено».
|-
|WMSASSEMBLED||Скомплектован на складе фулфилмента||На складе ответственного хранения скомплектовали отправление
|-
|WMSDISASSEMBLED|| Разукомплектован на склад фулфилмента||На складе ответственного хранения разукомплектовали отправление
|-
|ACCEPTED||Получен складом||Отправление [[Прием корреспонденции на склад#Прием корреспонденции|принято]] на склад
|-
|CUSTOMSPROCESS||Производится таможенный контроль||Установлен статус отправления, указанный в переменной '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Статусы таможенного контроля в процессе'''. Подробнее см. раздел [[Манифесты#Таможенное оформление отправления|«Таможенное оформление отправления»]]
|-
|CUSTOMSFINISHED|| Таможенный контроль произведен||Установлен статус отправления, указанный в переменной '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Статусы пройденного таможенного контроля'''. Подробнее см. раздел [[Манифесты#Таможенное оформление отправления|«Таможенное оформление отправления»]]
|-
|CONFIRM||Согласована доставка||Установлен статус отправления, указанный в переменной '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Статусы успешного согласования доставки'''
|-
|UNCONFIRM||Не удалось согласовать доставку||Установлен статус отправления, указанный в переменной '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Статусы НЕ успешного согласования доставки'''.
|-
|DEPARTURING||Планируется отправка||Отправление запланировано в манифест
|-
|DEPARTURE||Отправлено со склада||В манифесте указали дату отправки и отсканировали отправление в мешок
|-
|INVENTORY||Инвентаризация||Отправление отсканировано в интерфейсе функции [[Функции#Инвентаризация корреспонденции|«Инвентаризация корреспонденции»]]
|-
|PICKUPREADY||Готов к выдаче||Если получатель — ПВЗ, и отправление принято на ПВЗ
|-
|DELIVERY||Выдан курьеру на доставку||Отправление выдается курьеру, статус в выдаче — «На руках»
|-
|COURIERDELIVERED||Доставлен (предварительно)||Отправлению установлен статус со слов курьера '''Доставлено''' или статус в выдаче '''Доставлено'''
|-
|COURIERPARTIALLY||Частично со слов курьера||Установлен статус со слов курьера «Частично доставлено»
|-
|COURIERCANCELED||Отказ со слов курьера ||Установлен статус со слов курьера «Не доставлено»
|-
|COURIERRETURN||Возвращено курьером (курьер вернул на склад)||Курьер не смог доставить отправление получателю и вернул заказ обратно на склад. Это промежуточный статус, после которого оператор выясняет, нужно ли еще раз доставлять заказ или это окончательная недоставка. Статус отправления в выдаче «Не доставлено» или «Не доставлено по причине»
|-
|DATECHANGE||Перенос||Изменена плановая дата доставки
|-
|COMPLETE||Доставлен||В карточке отправления указаны дата и время вручения
|-
|PARTIALLY||Доставлен частично||В карточке отправления указаны дата и время вручения, но есть возвраты вложений
|-
|CANCELED||Не доставлен (Возврат/Отмена)||В карточке отправления указана только дата вручения, без времени
|-
|RETURNING||Планируется возврат||Отправление отсканировано в интерфейсе [[Акты_передачи_денег_и_корреспонденции#Акты передачи корреспонденции (АПК)|АПК]]
|-
|RETURNED||Возвращен||В АПК указали дату отправки
|-
|LOST||Утрачен||В карточке корреспонденции установлен флажок '''Утрачено'''
|}

Статусная модель

2022-05-24T08:20:21Z

Olga: /* Виды статусов */

=Виды статусов =
Основные виды статусов, связанные с доставкой отправлений:
* статус корреспонденции — пользовательский статус отправления, отображается в [[Карточка корреспонденции#Общие поля|карточке корреспонденции]]. Значения можно добавлять и изменять в справочнике '''Статусы''' > '''15 Статусы корреспонденции''';
* статус клиента — дополнительные статусы отправления, настраиваются по просьбе клиента в случае использования своего набора статусов. Подробнее см. раздел [[Клиенты и партнеры#Основное|«Клиенты и партнеры»]];
* статус манифеста — системные статусы, хранятся в справочнике '''Статусы''' > '''43 Системные''' > '''63 Статусы манифестов'''. Статусы нельзя изменять, можно выбрать их цвета. Подробнее см. в разделе [[Манифесты#Статусы манифеста|«Статусы манифеста»]];
* статус со слов курьера — статус доставки, который сообщает курьер, отображается на вкладке [[Выдача корреспонденции курьерам#Вкладка «Выдача»|'''Выдача''']]. Значения статуса хранятся в справочнике '''Статусы''' > '''43 Системные''' > '''64 Статусы со слов курьера'''. Если включена переменная '''Справочники''' > '''Переменные''' > '''Выдача''' > '''Использовать статус со слов курьера в первую очередь''', то в карточке корреспонденции в поле '''Инфо о доставке''' копируется примечание, которое курьер указал в мобильном приложении при проставлении статуса недоставки, и вне зависимости от статуса выдачи всегда будет проставлен тот, который указан в статусе со слов курьера;
* статус выдачи — статус доставки, которые [[Выдача корреспонденции курьерам#Статус выдачи|устанавливает]] менеджер в офисе при приемке работы курьера, отображается на вкладке [[Выдача корреспонденции курьерам#Вкладка «Выдача»|'''Выдача''']. Значения статуса хранятся в справочнике '''Справочники''' > '''Статусы''' > '''8 Статусы выдачи'''. Пользователи могут только переименовывать и назначать цвета статусов выдачи;
* статусы трекинга — системные статусы, устанавливаются автоматически, пользователь не может их изменить. Значения статуса хранятся в справочнике '''Справочники''' > '''Статусы''' > '''43 Системные''' > '''1 Статусы трекинга'''.

==Статусы трекинга ==

Статусы трекинга отображаются:
* в карточке отправления — '''Функции''' > '''История статусов''';
* в ответах на запрос по [[API#Запрос статуса заказов|API]];
* в [[Личный кабинет курьерской службы#Отслеживание заказа по номеру|трекинге]] заказа в личном кабинете;
* в информации по заказу в ЛК клиента, в офисной системе можно вывести столбец со статусами на вкладке '''Адреса'''.

В таблице ниже указаны события, при наступлении каждого из которых устанавливается определенный статус трекинга.

{|class = "wikitable" style = "width: 80%;"
!Код статуса
!Название
!В каких случаях устанавливается статус
|-
|AWAITING_SYNC||Ожидает синхронизации||Служба доставки еще не получила данные заказа
|-
|NEW||Новый||Добавлено отправление на вкладке '''Адреса'''
|-
|NEWPICKUP||Создан забор||Добавлено отправление на вкладке '''Адреса''' типа «забор» (номер 0 и штрихкод "")
|-
|PICKUP||Забран у отправителя||Если отправлению типа «забор» установили статус «Доставлено» или доставочную кор-ию приняли через мобильное приложение по забору или в мобильном приложении в заявке на забор установлен статус «Получено».
|-
|WMSASSEMBLED||Скомплектован на складе фулфилмента||На складе ответственного хранения скомплектовали отправление
|-
|WMSDISASSEMBLED|| Разукомплектован на склад фулфилмента||На складе ответственного хранения разукомплектовали отправление
|-
|ACCEPTED||Получен складом||Отправление [[Прием корреспонденции на склад#Прием корреспонденции|принято]] на склад
|-
|CUSTOMSPROCESS||Производится таможенный контроль||Установлен статус отправления, указанный в переменной '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Статусы таможенного контроля в процессе'''. Подробнее см. раздел [[Манифесты#Таможенное оформление отправления|«Таможенное оформление отправления»]]
|-
|CUSTOMSFINISHED|| Таможенный контроль произведен||Установлен статус отправления, указанный в переменной '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Статусы пройденного таможенного контроля'''. Подробнее см. раздел [[Манифесты#Таможенное оформление отправления|«Таможенное оформление отправления»]]
|-
|CONFIRM||Согласована доставка||Установлен статус отправления, указанный в переменной '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Статусы успешного согласования доставки'''
|-
|UNCONFIRM||Не удалось согласовать доставку||Установлен статус отправления, указанный в переменной '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Статусы НЕ успешного согласования доставки'''.
|-
|DEPARTURING||Планируется отправка||Отправление запланировано в манифест
|-
|DEPARTURE||Отправлено со склада||В манифесте указали дату отправки и отсканировали отправление в мешок
|-
|INVENTORY||Инвентаризация||Отправление отсканировано в интерфейсе функции [[Функции#Инвентаризация корреспонденции|«Инвентаризация корреспонденции»]]
|-
|PICKUPREADY||Готов к выдаче||Если получатель — ПВЗ, и отправление принято на ПВЗ
|-
|DELIVERY||Выдан курьеру на доставку||Отправление выдается курьеру, статус в выдаче — «На руках»
|-
|COURIERDELIVERED||Доставлен (предварительно)||Отправлению установлен статус со слов курьера '''Доставлено''' или статус в выдаче '''Доставлено'''
|-
|COURIERPARTIALLY||Частично со слов курьера||Установлен статус со слов курьера «Частично доставлено»
|-
|COURIERCANCELED||Отказ со слов курьера ||Установлен статус со слов курьера «Не доставлено»
|-
|COURIERRETURN||Возвращено курьером (курьер вернул на склад)||Курьер не смог доставить отправление получателю и вернул заказ обратно на склад. Это промежуточный статус, после которого оператор выясняет, нужно ли еще раз доставлять заказ или это окончательная недоставка. Статус отправления в выдаче «Не доставлено» или «Не доставлено по причине»
|-
|DATECHANGE||Перенос||Изменена плановая дата доставки
|-
|COMPLETE||Доставлен||В карточке отправления указаны дата и время вручения
|-
|PARTIALLY||Доставлен частично||В карточке отправления указаны дата и время вручения, но есть возвраты вложений
|-
|CANCELED||Не доставлен (Возврат/Отмена)||В карточке отправления указана только дата вручения, без времени
|-
|RETURNING||Планируется возврат||Отправление отсканировано в интерфейсе [[Акты_передачи_денег_и_корреспонденции#Акты передачи корреспонденции (АПК)|АПК]]
|-
|RETURNED||Возвращен||В АПК указали дату отправки
|-
|LOST||Утрачен||В карточке корреспонденции установлен флажок '''Утрачено'''
|}

Статусная модель

2022-05-23T15:00:21Z

Olga:

=Виды статусов =
Основные виды статусов, связанные с доставкой отправлений:
* статус корреспонденции — пользовательский статус, отображается в карточке корреспонденции. Значения можно добавлять и изменять в справочнике '''Статусы''' > '''15 Статусы корреспонденции'''. Значения по умолчанию:
**'''Распечатан''' — устанавливается автоматически при печати ведомостей. Отключается с помощью переменной '''Справочники''' > '''Переменные''' > '''Печать''' > '''Не проставлять статус "Распечатан" для статусов корр-ции''';
:* '''Новый''' — новый заказ;
* статус клиента — дополнительные статусы, настраиваются по просьбе клиента в случае использования своего набора статусов. Подробнее см. раздел [[Клиенты и партнеры#Основное|«Клиенты и партнеры»]];
* статус манифеста — системные статусы, хранятся в справочнике '''Статусы''' > '''43 Системные''' > '''63 Статусы манифестов'''. Статусы нельзя изменять, можно выбрать их цвета. Подробнее см. в разделе [[Манифесты#Статусы манифеста|«Статусы манифеста»]];
* статус со слов курьера — статус доставки, который сообщает курьер. Значения статуса хранятся в справочнике '''Статусы''' > '''43 Системные''' > '''64 Статусы со слов курьера'''. Если включена переменная '''Справочники''' > '''Переменные''' > '''Выдача''' > '''Использовать статус со слов курьера в первую очередь''', то в карточке корреспонденции в поле '''Инфо о доставке''' копируется примечание, которое курьер указал в мобильном приложении при проставлении статуса недоставки, и вне зависимости от статуса выдачи всегда будет проставлен тот, который указан в статусе со слов курьера;
* статус выдачи — статус доставки, которые устанавливает менеджер в офисе при приемке работы курьера. Значения статуса хранятся в справочнике '''Справочники''' > '''Статусы''' > '''8 Статусы выдачи'''. Пользователи могут только переименовывать и назначать цвета статусов выдачи;
* статусы трекинга — системные статусы, устанавливаются автоматически, пользователь не может их изменить. Значения статуса хранятся в справочнике '''Справочники''' > '''Статусы''' > '''43 Системные''' > '''1 Статусы трекинга'''.

==Статусы трекинга ==


{|class = "wikitable" style = "width: 80%;"
!Код статуса
!Название
!В каких случаях устанавливается статус
|-
|AWAITING_SYNC||Ожидает синхронизации||Служба доставки еще не получила данные заказа
|-
|NEW||Новый||Добавлено отправление на вкладке '''Адреса'''
|-
|NEWPICKUP||Создан забор||Добавлено отправление на вкладке '''Адреса''' типа «забор» (номер 0 и штрихкод "")
|-
|PICKUP||Забран у отправителя||Если отправлению типа «забор» установили статус «Доставлено» или доставочную кор-ию приняли через мобильное приложение по забору или в мобильном приложении в заявке на забор установлен статус «Получено».
|-
|WMSASSEMBLED||Скомплектован на складе фулфилмента||На складе ответственного хранения скомлектовали отправление
|-
|WMSDISASSEMBLED|| Разукомплектован на склад фулфилмента||На складе ответственного хранения разукомлектовали отправление
|-
|ACCEPTED||Получен складом||Отправление [[Прием корреспонденции на склад#Прием корреспонденции|принято]] на склад
|-
|CUSTOMSPROCESS||Производится таможенный контроль||Установлен статус отправления, указанный в переменной '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Статусы таможенного контроля в процессе'''. Подробнее см. раздел [[Манифесты#Таможенное оформление отправления|«Таможенное оформление отправления»]]
|-
|CUSTOMSFINISHED|| Таможенный контроль произведен||Установлен статус отправления, указанный в переменной '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Статусы пройденного таможенного контроля'''. Подробнее см. раздел [[Манифесты#Таможенное оформление отправления|«Таможенное оформление отправления»]]
|-
|CONFIRM||Согласована доставка||Установлен статус отправления, указанный в переменной '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Статусы успешного согласования доставки'''
|-
|UNCONFIRM||Не удалось согласовать доставку||Установлен статус отправления, указанный в переменной '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Статусы НЕ успешного согласования доставки'''.
|-
|DEPARTURING||Планируется отправка||Отправление запланировано в манифест
|-
|DEPARTURE||Отправлено со склада||В манифесте указали дату отправки и отсканировали отправление в мешок
|-
|INVENTORY||Инвентаризация||Отправление отсканировано в интерфейсе функции [[Функции#Инвентаризация корреспонденции|«Инвентаризация корреспонденции»]]
|-
|PICKUPREADY||Готов к выдаче||Если получатель — ПВЗ, и отправление принято на ПВЗ
|-
|DELIVERY||Выдан курьеру на доставку||Отправление выдается курьеру, статус в выдаче — «На руках»
|-
|COURIERDELIVERED||Доставлен (предварительно)||Отправлению установлен статус со слов курьера '''Доставлено''' или статус в выдаче '''Доставлено'''
|-
|COURIERPARTIALLY||Частично со слов курьера||Установлен статус со слов курьера «Частично доставлено»
|-
|COURIERCANCELED||Отказ со слов курьера ||Установлен статус со слов курьера «Не доставлено»
|-
|COURIERRETURN||Возвращено курьером (курьер вернул на склад)||Курьер не смог доставить отправление получателю и вернул заказ обратно на склад. Это промежуточный статус, после которого оператор выясняет, нужно ли еще раз доставлять заказ или это окончательная недоставка. Статус отправления в выдаче «Не доставлено» или «Не доставлено по причине»
|-
|DATECHANGE||Перенос||Изменена плановая дата доставки
|-
|COMPLETE||Доставлен||В карточке отправления указаны дата и время вручения
|-
|PARTIALLY||Доставлен частично||В карточке отправления указаны дата и время вручения, но есть возвраты вложений
|-
|CANCELED||Не доставлен (Возврат/Отмена)||В карточке отправления указана только дата вручения, без времени
|-
|RETURNING||Планируется возврат||Отправление отсканировано в интерфейсе [[Акты_передачи_денег_и_корреспонденции#Акты передачи корреспонденции (АПК)|АПК]]
|-
|RETURNED||Возвращен||В АПК указали дату отправки
|-
|LOST||Утрачен||В карточке корреспонденции установлен флажок '''Утрачено'''
|}

Манифесты

2022-05-23T14:11:39Z

Olga: /* Статусы манифеста */

= Управление манифестами =
; Манифест
: Объединение корреспонденции в мешки, транспортные места и т. д. с единым реестром для передачи другой компании или филиалу с целью адресной доставки.

Для работы с манифестами используется вкладка '''Манифесты'''.

В общем случае жизненный цикл манифеста выглядит следующим образом:

[[Файл:Манифесты схема.png|none|1200 px]]

= Манифесты =
Вкладка выглядит следующим образом:

[[Файл:Манифесты.png|none]]

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

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

Существуют следующие виды манифестов:
* входящие — консолидация отправлений, созданная филиалом, партнером или агентом курьерской службы для текущего филиала для дальнейшей адресной доставки. Как только манифест создан, принимающий филиал получает уведомление о входящем манифесте с информацией о корреспонденции. При получении груза филиал [[Доска приема|принимает]] корреспонденцию и [[Модуль Карта#Планирование|планирует доставку]]. В микрофилиалах процесс проходит [[Отправка корреспонденции#Забор|иначе]];
* исходящие — грузы из текущего филиала, передаваемые другому филиалу, партнеру или агенту курьерской службы;
* прочие — манифесты структурных подразделений курьерской службы, не имеющих прямого отношения к филиалу, который их просматривает. Фильтрация манифестов с условием «Прочие» позволяет просмотреть работу по отправлениям в других филиалах. Пользователь должен иметь права <rspoiler text="права">Права настраиваются в пункте основного меню '''Настройка''' > '''Пользователи''' > '''Манифесты''' > установите флажок '''Видеть'''</rspoiler> на просмотр манифестов.

Работник склада может настроить отображение списка манифестов для комплектации отправлений с помощью следующих флажков:
* '''Не собранные'''. Если флажок установлен, отображаются манифесты, в которых присутствует не вся запланированная корреспонденция. Есть несколько причин: работник склада еще не закончил работу по комплектации манифеста, корреспонденция еще не поступила на склад, работник склада не может найти необходимую корреспонденцию;
* '''Не прибывшие'''. Если флажок установлен, отображаются манифесты, у которых не указана дата доставки перевозчиком и дата получения;
* '''Не отправленные'''. Если флажок установлен, отображаются манифесты, в которых не заполнена дата отправки. Может получиться, что манифест мог быть создан, получен, прибыл, выдан, собран, доставлен, а дата не проставлена;
* '''Не полученные'''. Если флажок установлен, отображаются манифесты, у которых не заполнена дата получения;
* '''Невыданные'''. Если флажок установлен, отображаются манифесты, у которых не заполнены поля '''Курьер''' и '''Номер накладной''';
* '''На контроле'''. Если флажок установлен, отображаются манифесты с установленным флажком '''Контроль''' в карточке манифеста, который означает, что отправление очень важное и требует дополнительного внимания.

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

Столбцы таблиц [[Основные принципы работы в программе#Работа с таблицами|можно настроить]].

== Контекстное меню таблиц ==
Контекстные меню таблиц содержат разный набор функций.

Контекстное меню верхней таблицы:
* '''Открыть''' — открыть карточку корреспонденции;
* '''Переместить в мешок''' — переместить выделенную корреспонденцию в мешок. Запись перемещается в нижнюю таблицу;
* '''Переместить все в мешок''' — переместить все корреспонденции верхней таблицы в мешок;
* '''Удалить''' — удалить отправление из манифеста;
* '''Удалить все''' — удалить все корреспонденции верхней таблицы из манифеста.

Контекстное меню средней таблицы:
* '''Открыть''' — открыть карточку манифеста;
* '''Создать''' — создать манифест;
* '''Удалить''' — удалить манифест;
* '''Сопр. документы''' — сформировать выбранный из списка сопроводительный документ. Формы документов хранятся в справочнике '''[[Печатные формы]]''' > '''Документы для манифестов''';
* '''Печатать''' — [[Печать ведомостей и наклеек|печатать]] наклейки или накладные на отправления;
* '''Печатать манифест'''— печатать [[#Сопроводительные документы|акт сверки манифеста]];
* '''Печатать манифест 2''' — печатать акт передачи манифеста. Печатная форма используется для автоматизированной загрузки данных в сторонние системы партнеров по доставке;
* '''Печатать наклейки''' — печатать наклейки на места манифеста;
* '''Печатать кассовые чеки''' — печатать кассовые чеки на товары, отправляемые в манифесте. Если агент или партнер не может распечатать чеки, вы можете их распечатать и вложить в отправление.
* '''Рентабельность''' — сформировать отчет о рентабельности доставки груза;
* '''Обновить''' — обновить информацию о манифесте;
* '''Пересчитать агентские цены''' — обновить информацию по ценам агента;
* '''Проставить счет перевозчика''' — указать номер счета от перевозчика;
* '''Проставить дату оплаты''' — указать дату платежа по счету от перевозчика;
* '''Сброс инфо об оплате''' — удалить дату платежа;
* '''Отправить манифест 2 по e-mail''' — отправить акт передачи манифеста на электронный адрес принимающего филиала. Текст письма можно изменить в справочнике '''Печатные формы''' > '''Шаблоны для e-mail''' > '''Шаблон для отправки манифеста'''. Отправленные письма можно просмотреть в пункте меню '''Отчеты''' > '''Сообщения''';
* '''Отправить по интеграции''' — передать информацию по отправлениям манифеста по интеграции для предварительного согласования с партнером. В верхней таблице вкладки в столбце '''Инфо о доставке''' записываются ошибки интеграции. Если интеграция прошла успешно, в карточке отправления заполняется поле '''Код у подрядчика''', и отправление можно комплектовать в манифест;
* '''Напечатать ТТН''' — сформировать стандартную ТТН в формате документа Microsoft Excel;
* '''Переместить в доставку''' — создать корреспонденцию на доставку груза перевозчику;
* '''Переместить в забор''' — создать корреспонденцию на забор груза от перевозчика;
* '''Проставить коды у подрядчика''' — коды выдаются, если соответствующее поле в карточке корреспонденции пустое. Если нужно выдать новый код подрядчика, предварительно удалите существующий код в карточке корреспонденции и повторно выдайте коды подрядчика. Если поле недоступно для редактирования, установите текущий филиал пользователя ответственным. Введенный код подрядчика очистится автоматически;
* '''Перейти к адресам''' — открыть список входящих в манифест отправлений.

Контекстное меню нижней таблицы:
* '''Открыть адрес''' — открыть карточку отправления;
* '''Добавить адрес''' — добавить отправление в мешок вводом номера накладной или номера заказа и отправления через тире;
* '''Удалить адрес''' — удалить отправление из мешка манифеста. Если оно было запланировано в манифест, при удалении оно переместится обратно в верхнюю таблицу.

Контекстное меню таблицы справа:
* '''Открыть''' — открыть информацию о грузовом месте. Можно редактировать параметры места: номер, номер пломбы и фактический вес;
* '''Печатать наклейки''' — печатать наклейки для мешков или грузовых мест;
* '''Создать''' — создать мешок или грузовое место;
* '''Удалить''' — удалить мешок или грузовое место;
* '''История''' — история изменения данных таблицы;
* '''Добавить транзитное место''' — указать вручную номер пломбы входящего [[#Транзитные места|транзитного манифеста]], корреспонденции которого нужно добавить в текущий.

== Подсветка полей таблицы ==
* Поле '''Статус манифеста''' — подсветка определяется в справочнике '''Статусы''' > '''43 Системные''' > '''63 Статусы манифестов'''.
* Если заполнены поля манифеста '''Вес фактический''' и '''Вес заявленный''' и разница в значениях более 0,3 кг, поля подсвечиваются в таблице мест.
* Столбцы в таблице манифеста '''Кол-во мест''' и '''Кол-во мест перевозчика''' подсвечиваются красным, если значения не совпадают.
* Столбец '''Масса манифеста''' <rspoiler text="сравнивается>Значение столбца '''Объем перевозчика''' при этом преобразуется в килограммы, плотность вещества равна 250 кг/м3.</rspoiler> со значением '''Масса перевозчика''' или '''Объем перевозчика''', в зависимости от того, какое значение больше. Если разница между значениями более 10 %, тогда столбцы '''Масса манифеста''' и '''Масса перевозчика''' подсвечиваются красным. <spoiler text="Пример">Масса манифеста = 3 кг, объем = 0,1.<br>Объем будет преобразован по формуле 0.1 * 250 = 25 кг. Выбирается больший вес из 3 кг и 25 кг и сравнивается с массой манифеста. </spoiler>
= Создание манифеста =

Способы создания манифеста:
* на вкладке '''Манифесты''' нажмите на кнопку F3 или в средней части окна выберите пункт контекстного меню '''Создать''';
* на вкладке '''Адреса''' выделите отправления и в контекстном меню выберите '''Добавить в манифест''' > '''Новый'''.

Откроется карточка манифеста:

[[Файл:Новый манифест.png|none]]

'''Номер'''. Порядковый номер документа, присваивается автоматически при сохранении.

'''Дата'''. Дата создания манифеста, заполняется автоматически.

'''Дата отправки'''. Заполняется при фактической передаче груза перевозчику. При проставлении даты отправки:
* ответственный филиал, указанный в карточке манифеста, копируется в карточки отправлений, помещенных в мешок;
* срабатывают настроенные [[Интеграция с другими системами|интеграции]];
* пересчитываются агентские цены, если они были нулевые;
* манифест становится невозможно изменить.

'''Филиал-создатель'''. Филиал курьерской службы, который создал манифест. Подробнее см. раздел «[[Филиалы]]».

'''Отв. филиал'''. Филиал организации, который отвечает за доставку корреспонденции манифеста. Выберите значение из выпадающего списка. Ответственный филиал автоматически копируется в [[Карточка корреспонденции#Межгород|карточки]] всех отправлений манифеста. С помощью кнопки [[Файл:More.png]] вы можете просмотреть карточку выбранного филиала.

Чтобы филиал-создатель мог указать любой филиал своего или верхнего уровня подчинения, включите переменную '''Справочники''' > '''Переменные''' > '''Манифесты''' > '''Расширенный список отв. филиалов'''.

'''Курьер'''. ФИО курьера, доставляющего груз ответственному филиалу или перевозчику.

'''Код'''. Код курьера в программе.

'''Автомобиль'''. Автомобиль, которым доставляется груз ответственному филиалу или перевозчику.

'''Город'''. Город-получатель отправления.

'''Количество мест'''. Количество грузовых мест, входящих в манифест. Указывается автоматически.

'''Масса'''. Сумма масс всех отправлений, входящих в манифест.

'''Таможня'''. Таможня, на которой корреспонденция должна быть оформлена. Вы можете указать название таможенных постов и подсветку для них в справочнике '''Статусы''' > '''48 Таможни'''. Поле используется для фильтрации. Подробнее см. раздел «[[#Таможенное оформление отправления|Таможенное оформление отправления]]».

'''Контроль'''. Если флажок установлен, манифест считается [[#Контроль отправлений|приоритетным]] для ответственного лица.

'''Перевозчик'''. Организация, доставляющая груз в город назначения. Список перевозчиков формируется в справочнике '''[[Перевозчики]]'''. Данные перевозчика используются для учета рейсов и при расчете рентабельности

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

'''Дата оплаты'''. Дата оплаты счета за услуги по доставке груза.

'''Планируемая дата доставки'''. Прогнозируемая дата доставки. Если отправление передается в свой филиал, заполните планируемую дату доставки, чтобы другой филиал знал, когда встречать груз.

'''Планируемое время доставки'''. Прогнозируемое время доставки.

'''Стоимость перевозки'''. Стоимость услуг перевозчика по доставке груза.

'''Доп. стоимость'''. Дополнительная стоимость услуг перевозчика по доставке груза.

Остальные поля заполняются данными из накладной, полученной от перевозчика:
* '''Дата'''. Фактическая дата доставки;
* '''Время'''. Фактическое время доставки;
* '''Номер накладной''';
* '''Количество мест''';
* '''Масса''';
* '''Объем''';
* '''Номер рейса'''.

В правом нижнем углу окна расположены [[Основные принципы работы в программе#Иконки в системе|кнопки стандартных функций]].

= Планирование отправки =

Для планирования корреспонденции в манифест можно использовать следующий способ:
# На вкладке '''Адреса''' отобразите столбцы '''Перевозчик''', '''Регион-получатель''', '''Город-получатель''', '''Масса''', '''Дата дост. план''', '''Количество'''. Подробнее см. раздел «[[Основные принципы работы в программе#Работа с таблицами|Работа с таблицами]]».
# Используйте [[Учет корреспонденции#Фильтр|фильтр]] адресов, чтобы отобразить подходящие для отправки корреспонденции.
# Отсортируйте список отправлений по столбцу '''Регион-получатель'''. Можно сделать многоуровневую сортировку: удерживая нажатой клавишу CTRL, нажмите на столбец, по которому надо произвести многоуровневую сортировку. Сортировка происходит с небольшой задержкой. Чтобы просмотреть статистику по регионам, наведите курсор на нижнюю границу таблицы адресов и, зажав левую кнопку мыши, потяните вверх. В открывшейся таблице отобразится информация по отправлениям в разрезе регионов-получателей. Двойным нажатием на строку можно перейти происходит к первой корреспонденции выбранной группы.
# Выделите отправления и назначьте [[Перевозчики|перевозчика]] одним из способов:
#* выберите пункт контекстного меню '''Указать перевозчика''';
#* нажмите на быструю клавишу перевозчика, назначенную в карточке [[Перевозчики|перевозчика]];
#* удерживая нажатой клавишу CTRL, вызовите контекстное меню. В таком меню есть только пункт '''Добавить в манифест''' и список перевозчиков.
# Запланируйте корреспонденцию в манифест. Для этого выделите отправления в списке и в контекстном меню выберите '''Добавить в манифест'''. В появившемся меню можно создать новый манифест или добавить корреспонденции в уже существующий неотправленный манифест. Список манифестов может быть разделен прямой линией на две группы: сверху — манифесты, которые направляются в тот же регион, что и добавляемые корреспонденции, снизу — все остальные манифесты.

В результате корреспонденция, запланированная для отправки в манифесте, появится на вкладке '''Манифесты ''' в верхней таблице.

Этап планирования можно опустить, если включена переменная '''Справочники''' > '''Переменные''' > '''Манифесты''' > '''Непосредственное добавление в манифест'''. В этом случае вы можете отсканировать корреспонденцию на вкладке '''Манифесты ''', и она добавится в мешок манифеста.

= Таможенное оформление отправления =
В системе MeaSoft для отправлений, проходящих таможенный контроль, вы можете:
* настроить статусы трекинга '''Производится таможенный контроль''' и '''Таможенный контроль произведен''', которые повысят прозрачность доставки и покажут клиенту, на каком этапе находится отправление;
* установить контроль таможенного оформления для отправлений, запланированных в манифесты.

Чтобы настроить статусы трекинга:
# Откройте справочник '''Переменные''' и для переменной '''Статусы таможенного контроля в процессе''' укажите статус корреспонденции, который будет соответствовать статусу трекинга '''Производится таможенный контроль'''.
# Для переменной '''Статусы пройденного таможенного контроля''' укажите статус корреспонденции, который будет соответствовать статусу трекинга '''Таможенный контроль произведен'''.

Статус трекинга можно просмотреть в карточке корреспонденции по кнопке '''Функции''' > '''История статусов''', в [[Личный кабинет клиента#Отслеживание заказов|личном кабинете]] и на [[Личный кабинет курьерской службы#Отслеживание заказа по номеру|странице отслеживания заказа]].

Чтобы установить контроль таможенного оформления для отправлений в манифестах, настройте статусы трекинга и в [[Филиалы#Вкладка «Дополнительно»|карточке ответственного филиала]], контролирующего прохождение таможенного оформления, установите флажок '''Таможенный контроль'''. В результате корреспонденции нельзя переместить в мешок манифеста, пока у них не будет статуса трекинга '''Таможенный контроль произведен'''.

= Комплектация отправления =
Работник склада комплектует отправления на вкладке '''Манифесты'''.

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

Как только работник склада заполняет мешок, он пломбирует его: в правой таблице с помощью контекстного меню открывает запись места и вводит номер пломбы вручную или сканирует штрихкод пломбы, если он есть. В результате номер пломбы отображается в таблице справа. Это означает, что мешок запечатан, и при следующем сканировании корреспонденции будет создан новый мешок. В запечатанный мешок ничего добавить нельзя. Чтобы создать мешок вручную, в таблице справа в контекстном меню выберите пункт '''Создать'''.

Если корреспонденция содержит несколько мест, можно напечатать столько наклеек, сколько мест указано в поле '''Количество'''. Подробнее см. раздел «[[#Сопроводительные документы|Сопроводительные документы]]». В нижней таблице появится строка, окрашенная желтым цветом, в которой поле '''Количество в манифесте''' содержит количество добавленных в мешки мест из корреспонденции. Когда будут отсканированы все наклейки, относящиеся к этой корреспонденции, строка окрасится зеленым цветом. До этого момента соответствующая строка сохраняется в верхней таблице, и при каждом сканировании значение поля '''Оставшееся количество''' в ней уменьшается на единицу. После заполнения мешка работник склада пломбирует его и переходит к комплектации следующего мешка.

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

= Отправка =

Заказ на доставку или забор манифеста может формироваться следующими способами:
* по несобранному манифесту — по всем запланированным корреспонденциям;
* если хотя бы одно отправление помещено в мешок манифеста — с учетом только помещенных в мешок корреспонденций.

Чтобы отправить корреспонденцию манифеста перевозчику:
# Выделите манифест в средней таблице и выберите пункт контекстного меню '''Переместить в доставку'''. В результате создается заказ на доставку корреспонденции до перевозчика и назначается курьеру.<br>Обратите внимание, что можно выбрать несколько манифестов и назначить их на доставку одному курьеру. Например, если у 5 манифестов один перевозчик, достаточно их выделить и выбрать пункт контекстного меню '''Переместить в доставку'''. Тогда один курьер повезет корреспонденцию из 5 манифестов до перевозчика.
# Распечатайте накладную, как при выдаче обычного заказа, и передайте курьеру вместе с корреспонденцией. Подробнее см. раздел «[[Выдача корреспонденции курьерам]]».

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

Если логист проставил дату отправки в карточке манифеста, но не перенес в доставку, то манифест считается запланированным на доставку, но не переносится во вкладки '''Заказы''' и '''Адреса''', а остается на вкладке '''Манифесты''' как отправленный. В карточке корреспонденции, которая входит в манифест, автоматически проставляется ответственный филиал. Если дата отправки проставлена, то добавить в манифест ничего нельзя, так как он считается запланированным на доставку (сформированным).

<spoiler text="См. также">[[Логистика]]</spoiler>

=Транзитные места=

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

Чтобы добавить в исходящий манифест всю корреспонденцию, находящуюся в мешке, на вкладке '''Манифесты''' отсканируйте номер пломбы транзитного места. В текущем манифесте создается место с таким же номером пломбы, и соответствующие корреспонденции входящего манифеста добавляются в текущий.

= Сопроводительные документы =
* Вкладываемый акт сверки манифеста. Распечатывается и вкладывается в сформированное отправление, чтобы ответственное лицо могло сравнить содержание отправления с перечнем, представленным в документе.<br>Чтобы сформировать акт сверки, в таблице манифестов выберите пункт контекстного меню '''Печать манифеста''' или нажмите CTRL + M.
* Электронный вариант акта сверки. Используется для передачи информации по манифесту партнерам, филиалам или агентам по электронной почте. Позволяет добавлять информацию в сторонние учетные системы, поддерживающие работу с таблицами Microsoft Excel.<br>Чтобы сформировать документ, воспользуйтесь пунктом контекстного меню '''Печатать манифест2''' или нажмите SHIFT + CTRL + M.<br>Чтобы отправить документ по e-mail, выделите манифесты в списке и в контекстном меню нажмите '''Отправить манифест2 по email'''.
* Наклейки. Наклейки для мешков или грузовых мест печатаются на выбранном термо- или термотрансферном принтере. На наклейку выводится следующая информация: номер манифеста, откуда и куда доставляется корреспонденция, сколько мешков или грузовых мест используется и штрихкод.<br>Чтобы распечатать наклейки, в контекстном меню выберите '''Печатать наклейки''' или нажмите CTRL + P. Подробнее см. раздел «[[Печать ведомостей и наклеек]]».<br>Чтобы печатать наклейки партнера по интеграции автоматически при сканировании отправлений в манифест:
*# В разделе «[[Файлы для загрузки#Печатные формы этикеток при комплектации в манифесты|Печатные формы этикеток при комплектации в манифесты]]» скачайте соответствующий файл.
*# Откройте карточку филиала, созданного для интеграции с партнером, и на вкладке '''Дополнительно''' вставьте текст из скачанного файла в поле '''Скрипт для выполнения в манифестах'''.
*# Сохраните карточку филиала.
* Кассовые чеки. Если партнер или агент, получающий отправление, не может распечатать чеки, вы можете распечатать кассовые чеки и вложить их в отправление.<br>Для этого выберите пункт контекстного меню '''Печатать кассовые чеки'''.
* Товарно-транспортная накладная (ТТН) — первичный учетный документ для учета движения товарно-материальных ценностей и расчетов за их перевозки автомобильным транспортом. Как правило, оформляется грузоотправителем. Однако по согласованию сторон документ может составляться и перевозчиком.<br>Чтобы сформировать ТТН, в контекстном меню выберите пункт '''Напечатать ТТН'''.
* Пользовательские документы. Вы можете создать свои [[печатные формы]] для накладных. Они будут доступны через пункт контекстного меню '''Сопроводительные документы'''.

= Статусы манифеста =

'''Создан''' — выставляется после создания, когда не был установлен другой статус.

'''Собран''' — все корреспонденции перемещены в мешок манифеста.

'''Выдан''' — в манифесте указан курьер.

'''Сдан перевозчику''' — в манифесте заполнено поле '''Номер накладной'''.

'''Отправлен''' — в манифесте заполнено поле '''Дата отправки'''.

'''Прибыл''' — в манифесте заполнено поле '''Дата доставки'''.

'''Опоздал''' — в манифесте дата доставки больше планируемой даты доставки.

'''Получен''' — статус устанавливается, если в манифесте указана дата получения. Дата может заполняться автоматически:
* в доске приема при приеме первой корреспонденции из манифеста;
* в окне приема '''Функции''' > '''Прием корреспонденции на склад''' при приеме корреспонденции из манифеста;
* если на манифест оформлена заборная накладная, то при проставлении статуса '''Доставлено''' в выдаче.

'''Доставлен''' — указан дата вручения в карточке всех корреспонденций, входящих в манифест.

=Рентабельность=

Отчет о рентабельности предназначен для оценки экономической эффективности использования услуг перевозчика.

Чтобы сформировать отчет, в таблице выделите манифесты, в контекстном меню выберите пункт '''Рентабельность''' или используйте сочетание клавиш CTRL + R.

Откроется отчет в Microsoft Excel следующего вида:

[[Файл:Рентабельность.png]]

Поля, влияющие на расчет рентабельности:
* '''Тариф партнера''' — стоимость услуг агента доставки. Значение берется из карточки корреспонденции, вкладка '''Межгород''', поле '''Агентская цена''';
* '''Тариф доставки''' — стоимость услуг перевозчика. Значение берется из карточки манифеста, поле '''Стоимость перевозки''';
* '''Доп. стоимость''' — добавка к стоимости услуг перевозчика. Значение берется из карточки манифеста, поле '''Доп. стоимость''';
* '''Сумма ТП+ТД+ДС''' — суммарная стоимость услуг перевозчика и агента. Вычисляется как сумма значений полей '''Тариф партнера''', '''Тариф доставки''' и '''Доп. стоимость''', распределенная пропорционально доле веса отправления в манифесте;
* '''Сумма счета''' — стоимость доставки отправления, которую нужно взять с получателя. Значение берется из карточки корреспонденции, поле '''Стоимость доставки'''.
* '''Прибыль''' — разница между суммой счета и суммой услуг подрядчиков;
* '''Рентабельность''' — отношение получаемой прибыли к выплачиваемой сумме услуг подрядчиков.

Перед формированием отчета агентские цены автоматически рассчитываются, если они еще не были рассчитаны.

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

В [[Отправка корреспонденции#Микрофилиалы|микрофилиале]] забор и доставка осуществляется курьером, закрепленным за отделением. Если в микрофилиале работает несколько курьеров, то можно назначить забор и доставку на конкретного сотрудника. Работает это следующим образом: сотрудник получает несколько заданий в мобильном приложении на базе [[Мобильное приложение курьера для Android|Android]] или [[Мобильное приложение курьера для IPhone|IOS]], одно из них забор от перевозчика, а остальные — на доставку корреспонденции получателю. После доставки корреспонденции курьер отчитывается о доставке в мобильном приложении.

= Прием манифеста =
Процесс приема корреспонденции подробно описан в статье «[[Прием корреспонденции на склад]]».

Манифесты также можно принимать с помощью [[Доска приема|доски приема]].

= Микрофилиалы =
; Микрофилиал
: Cтруктурное подразделение курьерской службы без офиса, с курьером/курьерами. Как правило, курьеры работают через мобильное приложение на [[Мобильное приложение курьера для Android|Android]] или [[Мобильное приложение курьера для IPhone|IOS]] и курируются другими подразделениями компании.

Чтобы отметить подразделение как микрофилиал, в карточке соответствующего филиала установите флажок '''Микрофилиал'''. Если флажок установлен, включается автоматическое создание накладных на доставку или забор. В [[Сотрудники#Дополнительно|карточках курьеров]] подразделения укажите их подчиненность этому [[Филиалы|филиалу]].

Если манифест отправляется в микрофилиал, стандартная последовательность действий такова:
# После указания даты отправки в манифесте появится окно с выбором курьера микрофилиала. Если в окне выбора нажать '''Отмена''', автоматическое создание корреспонденции отменяется.
# Указанному курьеру выдается задание на забор манифеста с датой заказа «сегодня» и заказчиком контрагентом филиала-создателя.
# Курьер принимает отправления, входящие в манифест, с помощью [[Мобильное приложение курьера для Android#Прием отправлений у клиента|мобильного приложения]].
# Когда в выдаче оператор проставит у корреспонденции на забор манифеста статус '''Доставлено''', считается, что микрофилиал получил манифест, и в этот момент:
#* в манифесте устанавливается дата доставки (со слов курьера из выдачи, если ее нет, используется дата доставки по выдаче);
#* все корреспонденции из манифеста принимаются в микрофилиале;
#* система предложит выдать курьеру корреспонденции из манифеста, если они по выдаче не выдавались.

Если неважно, какому курьеру микрофилиала выдавать отправления, можно использовать следующую последовательность действий:
# Когда манифест готов к отправке в микрофилиал, переместите его на доставку груза перевозчику.
# Когда оператор в корреспонденции на доставку указывает дату доставки:
#* Автоматически проставляется дата отправки манифеста.
#* Cоздается корреспонденция на забор отправления у перевозчика.
#* Корреспонденция на забор выдается первому в списке курьеру микрофилиала.
# Если курьер проставил заборной корреспонденции статус '''Доставлено''' и при этом не принял ни одного заказа из манифеста, все заказы манифеста выдаются ему автоматически.
:: Если курьер начал принимать отправления манифеста, при закрытии забора ему не выдаются непринятые отправления.

Существует и обратная последовательность: передача заказов из микрофилиала (когда он выступает филиалом-создателем) на доставку в другой ответственный филиал.

Когда курьер микрофилиала оформляет забор у клиента, заказ автоматически выдается ему на доставку, если город назначения заказа совпадает с городом курьера. Если города разные, заказ курьеру не назначается.

= Кейсы =
Раздел предназначен для описания реализованных по запросам клиентов задач.

'''Сортировка заказов для таможни'''

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

На узле происходила приемка и сортировка посылок для пересылки отправлений из Китая в Россию. Работник склада сканировал упаковку и распределял корреспонденцию по полетам. Причем распределение по полетам осуществлялось по правилам с учетом «зеленого» (отправления до 30 кг и до 1000 евро) и «красного» (отправления свыше 30 кг и дороже 1000 евро) коридоров.

Скрипт позволяет работнику узнать, на какой паллете есть место для отсканированной корреспонденции. Если на паллете не было место под корреспонденцию, то создавалось новое место на следующей паллете.

Скрипты можно изменять под разные таможенные условия или создать собственные условия, исходя из задач по сортировки корреспонденции. Подробная информация находится в разделе [[Системные доп. возможности#Скрипты|Системные доп. возможности]].

Статусы

2022-05-23T13:57:59Z

Olga: /* Виды срочности */

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

[[Файл:Статусы.PNG|none]]

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

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

Действия со статусами совершаются с помощью контекстного меню статуса:
* '''Переименовать''' — переименовать выбранный статус;
* '''Добавить''' — добавить статус;
* '''Удалить''' — удалить выбранный статус;
* '''Изменить цвет''' — изменить цвет, которым подсвечивается строка или столбец с этим статусом в интерфейсе пользователя;
* '''Разрешения''' — настроить права доступа пользователей на установку выделенного статуса;
* '''Дополнительная информация''' — настроить дополнительные [[#Дополнительная информация статуса|параметры]] статуса;
* '''Выключить/включить''' — отключить или включить статус. Отключенные статусы отображаются перечеркнутыми;
* '''Скопировать путь''' — скопировать в буфер обмена программный путь статуса. Например, "Справочники" -> "Статусы" -> "10 Статусы принятия на работу" -> "1 Не приглашен".

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

Изменения в справочнике вступают в силу только после перезагрузки системы.


= Виды срочности =
Виды срочности настраиваются в справочнике '''Статусы''' > '''Виды срочности'''.

Удалять виды срочности нельзя, но можно отключить неиспользуемые. Для этого в контекстном меню записи вида срочности выберите '''Выключить/Включить'''.

Чтобы настроить параметры, в контекстном меню вида срочности выберите ''' Дополнительная информация'''. Откроется окно настройки:

[[Файл:Виды срочности.png|none]]

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

Параметры видов срочности и особенности настройки перечислены в таблице:

{|class="wikitable" align="center" style="width: 80%;
!style="width: 5%;"|Параметр
!style="width: 45%;"|Описание
!style="width: 50%;"|Возможные значения, пояснения
|-
| colspan="3" style="text-align:center;" | Строка 1 — общие параметры
|-
|1||Срок доставки в рабочих днях||'''0''' — доставка сегодня,<br> '''1''' — доставка сегодня или завтра,<br>'''2 и больше или пусто''' — в штатном режиме.<br>Значения 0 и 1 подсвечивают недоставивших курьеров в выдаче
|-
|2||Cокращенное название вида срочности ||Для печати и отчетов
|-
|3||Доступность в ЛК||'''Пусто/0''' — доступен,<br>'''1''' — недоступен,<br>'''2''' — доступен только для доставки,<br>'''3''' — доступен только для заборов,<br>'''4''' — в ЛК недоступен, используется только для интеграций
|-
|4||Отображение в ЛК при импорте из Excel||Принудительно, независимо от значения 3 параметра<br>'''0''' — не отображать, <br>'''1''' — отображать
|-
|5||Виды срочности, учитываемые при тарификации забора по количеству доставок||Значение указывается в формате 'X,Y,Z'<br>Если параметр пустой, учитываются все виды срочности
|-
|6||Вид срочности для деления стоимости доставки на 2 этапа||Первый этап — доставка до регионального центра, рассчитывается по указанному в параметре виду срочности; второй этап — до клиента
|-
|7||Преобразование адреса для новых заказов||'''0''' — преобразовывать адрес согласно справочнику автозамен '''Связь''' > '''Импорт БД из Excel''' > '''Автозамена''', <br> '''1''' — отключить преобразование адреса для новых заказов
|-
|8||Типы клиентов, которым доступен этот режим срочности в заказах||'''0''' — режим срочности доступен неавторизованному пользователю в калькуляторе <br> Типы клиентов хранятся в справочнике '''Справочники''' > '''Статусы''' > '''Типы клиентов'''<br>
|-
| colspan="3" style="text-align:center;" | Строка 2 — параметры для [[Интеграция_с_другими_системами#Сквозная интеграция|сквозной интеграции]]
|-
|1||Код филиала партнера||Код можно посмотреть в '''Справочники''' > '''Межгород''' > '''Филиалы'''. Можно в одинарных кавычках указать несколько ответственных филиалов через запятую, тогда режим срочности будет доступен для всех перечисленных филиалов. Для версии системы 2021.0.0.38 и выше вместо кода филиала можно указать знак вопроса (?), это обозначит доступность режима срочности для всех филиалов
|-
|2||Экстра-код партнера в системе MeaSoft|| Коды для сторонних компаний приведены в [[Интеграция_с_другими_системами#Настройка интеграции|таблице]]
|-
|3||Имя пользователя в системе партнера||Может отличаться от того, под которым работает интеграция, здесь нужно для расчета цены для клиента
|-
|4||Пароль пользователя, указанного в 3 параметре||
|-
|5||Вид срочности партнера||Посмотреть доступные коды видов срочности можно по ссылке в [[Интеграция_с_другими_системами#Настройка интеграции|таблице]], в калькуляторе в выпадающем списке. Можно в одинарных кавычках указать несколько видов срочности через запятую, тогда система будет выбирать из них первый доступный
|-
|6||Наценка к стоимости, передаваемой подрядчиком||В деньгах или в процентах, если стоит знак процента. Например 10 — наценка 10 рублей, 10% — наценка 10 процентов
|-
|7||Отключение сквозной интеграции||'''1''' — выключить сквозную тарификацию. Параметр используется, если подключение нужно только для передачи заказов по интеграции, а расчет цены не нужен
|-
|8||Поиск наименьшей стоимости|| '''1''' — искать самый дешевый тариф в указанных режимах срочности партнера. Работает для СДЭК и Почты России
|}

API

2022-05-23T13:49:58Z

Olga: /* Описание полей запроса изменения */

<div style="font-size: 18px; color: #a92424; background-color: #ffdede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
'''Изменения для 54-ФЗ'''

Для передачи ставки НДС при оформлении заказа добавлен атрибут items > item > VATrate.

При использовании услуги кассового обслуживания необходимо в обязательном порядке передавать состав заказа со ставками НДС.

'''ВНИМАНИЕ'''

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

</div>

<div style="font-size: 24px; color: #2424a9; background-color: #deffde; border: 1px solid #ebccd1; padding: 3px 10px 10px; text-align: center">
'''English version is [[API Documentation|HERE!]]'''
</div>

Вы можете настроить интеграцию с MeaSoft средствами XML API по протоколу HTTP POST.

API предназначено для интеграции клиентов (интернет-магазинов и прочих компаний-заказчиков доставки) с [http://courierexe.ru/our_clients.htm курьерскими службами], работающими под управлением системы [https://curie.ru/ MeaSoft].

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

Если вы '''подрядчик''', вы можете забирать заказы, используя значение client=AGENT в запросе [[#Пример запроса статуса заказа|statusreq]], и передавать статусы заказов, используя метод [[#Изменение статуса агентом|setorderinfo]]. Также для интеграций с подрядчиками у нас есть специальная платформа, но добавлять подрядчиков в нее можно только на нашей стороне. Присылайте нам коммерческое предложение, описание вашего сервиса, и мы с радостью его рассмотрим.

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

Если у вас после прочтения документации остались вопросы, задайте их по почте [mailto:support@courierexe.ru support@courierexe.ru]. Обязательно представьтесь, напишите ваши контактные данные (телефон, скайп) и название компании, с которой вы хотите интегрироваться.

== Готовые интеграции ==

Для работы с популярными CMS и CRM-системами разработаны модули интеграции, перечисленные в таблице ниже.

'''Модули распространяются бесплатно, без гарантий со стороны разработчика''', и не являются средством полной автоматизации взаимодействия с курьерской службой. Модули — это помощь разработчикам интернет-магазинов в построении интеграции с курьерскими службами. '''Ответственность за корректность передачи данных лежит на интернет-магазине.'''

Сообщайте нам свои пожелания по работе наших модулей. Мы учтем их в новых версиях.

{| class="wikitable" align="center" style="width: 80%; margin: auto; background-color:#ffffff; border: 1px solid #999999;" cellpadding="10" cellspacing="0"
!style="width: 35%;"|Система управления контентом (CMS)
!style="width: 15%;"|Ссылка
!style="width: 35%;"|Примечание
|-
|[[Файл:bitrix.png|center|x44px]]
|style="text-align: center;" | [https://marketplace.1c-bitrix.ru/solutions/measoft.courier/ Установить] 
|Поддерживает версии 14.5 и выше. Подробнее см. [[1C-Битрикс|описание]].
|-
|[[Файл:prestashop.png|center|x60px]]
|style="text-align: center;"|[https://courierexe.ru/download/api/prestashop.zip Скачать]
|Поддерживает версии 1.5.2.0 и выше.
|-
|[[Файл:OpencartOCStore.png|center|x60px]]
|style="text-align: center;"|[https://courierexe.ru/download/api/opencart.zip Скачать для версии 1.5.5.1]<br>[https://courierexe.ru/download/api/measoft_oc2.ocmod.zip Скачать для версии 2.0]<br>[https://courierexe.ru/download/api/measoft_oc2.3.ocmod.zip Скачать для версии 2.3]<br>[https://courierexe.ru/download/api/measoft_ос3.ocmod.zip Скачать для версии 3.0]
|Поддерживает версии с 1.5.5.1.<br>Скачивайте модули для своей версии OpenCart.<br>Подробнее см. [[OpenCart|описание]].<br>[https://opencartforum.com/files/file/2906-avtomatizaciya-otpravki-i-otslezhivanie-dostavok-courierexe-dlya-opencart-15x/ Альтернативный модуль сторонних разработчиков]
|-
|[[Файл:webasyst-shopscript.png|center|x44px]]
|style="text-align: center;"|[https://www.webasyst.ru/store/plugin/shop/measoftcourier/ Установить модуль]<br>[https://www.webasyst.ru/store/plugin/shipping/measoftcourier/ Установить плагин]
|Модуль предназначен для отправки заявок в КС, а плагин для расчета стоимости доставки при оформлении заказа.
|-

|[[Файл:insales.png|center|x80px]]
|style="text-align: center;"|Настраивается в [[Личный кабинет клиента|ЛК пользователя]]
|[[InSales|Инструкция по настройке]]
|-
|[[Файл:Leadvertex.png|center|x44px]]
|style="text-align: center;"|[https://blog.leadvertex.ru/news/2110-integraciya-s-kurerkami-na-platforme-measoft Настраивается] в ЛК [https://Leadvertex.ru Leadvertex]
|[[LeadVertex|Инструкция по настройке]]<br>Модуль разработан и поддерживается компанией LeadVertex.
|-
|[[Файл:Retailcrm.png|center|x30px]]
|style="text-align: center;"|[https://www.retailcrm.ru/ RetailCRM]
|[[RetailCRM|Настраивается]] в ЛК пользователя в системе
|-
|[[Файл:1C.jpg|center|x44px]]
|style="text-align: center;"|-
|[https://infostart.ru/public/692790/ Альтернативный модуль сторонних разработчиков (1 версия)]

[https://infostart.ru/public/1531484/ Альтернативный модуль сторонних разработчиков (2 версия)]
|-
|[[Файл:Joomla2.jpg|center|x60px]]
|style="text-align: center;"|[https://courierexe.ru/download/api/com_measoft.zip Скачать]
|Работает только с компонентом Virtuemart.
|-
|[[Файл:Amocrm.png|center|x44px]]
|style="text-align: center;"|[https://www.amocrm.ru/extensions/courier2008 Установить]
|Подробнее см. [[amoCRM|описание]].
|-
|rowspan="2"|[[Файл:MoySclad.jpg|center|x30px]]
|style="height:50px; text-align: center;"|[https://home.courierexe.ru/moysklad/step1 Настроить интеграцию с MeaSoft]
|[[МойСклад|Инструкция]]
|-
|style="height:50px; text-align: center;"|[https://itmdev.ru/ms/shipping/ Скачать модуль сторонних разработчиков]
|Интеграция МойСклад с курьерскими службами от сторонних разработчиков
|-
|[[Файл:wordpress.jpg|center|x80px]]
|style="text-align: center;"|[https://courierexe.ru/download/api/wordpress.zip Скачать]
|[[Wordpress|Инструкция]]
|-
|[[Файл:Cscart.png|center|x60px]]
|style="text-align: center;"|[https://marketplace.cs-cart.com/measoft-en.html Установить]
|Поддерживает версии 4.10 и выше.<br>[[CS-Cart|Инструкция]]
|-
|style="height:100px; text-align: center;"|'''Webhook'''
|style="text-align: center;"|Читайте описание [[Webhook|на этой странице]]
|Передача информации о статусах и заказах в вашу систему
|-
|}

'''Обратите внимание!''' В модулях систем PrestaShop и Joomla для отправки заказа в курьерскую службу зайдите в карточку заказа. В карточке отображается специальная форма отправки заказа, а если заказ отправлен, она позволяет проверить его статус:[[Файл:Form.png|400 px|Форма отправки заказа|none]]

Для отображения списка пунктов выдачи есть [https://home.courierexe.ru/js/measoft_map.js JavaScript модуль]. Инструкция по использованию — внутри. Посмотреть пример работы можно [https://home.courierexe.ru/pvz_test.html здесь].

== Тестовый аккаунт ==

Для отладки зайдите в тестовый личный кабинет по адресу [https://home.courierexe.ru/8 https://home.courierexe.ru/8], логин: login пароль: pass.

На вкладке '''Интеграция''' > '''Отладка''' вы можете пробовать выполнять запросы к API для отладки, а также видеть историю отправленных запросов. Созданные заказы появятся в пункте основного меню '''Отслеживание'''.

Для упрощения интеграции можно скачать [https://courierexe.ru/download/api/php_sample.zip пример обращения к сервису на PHP].

== Рабочий аккаунт для подключения ==

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

<source lang=xml>
<auth extra="8" login="login" pass="pass"></auth>
</source>

Описание параметров:
* '''extra''' — экстра-код, уникальный идентификатор компании, с которой вы интегрируетесь.
* '''login''' — логин клиента;
* '''pass''' — пароль клиента.

Запросите эти данные у курьерской службы, к которой вы подключаетесь. Курьерская служба передает временный пароль, его нужно сменить после первого входа в [[Личный кабинет клиента|ЛК клиента]].

== Авторизация курьерской службы ==

Если курьерской службе требуется подключение под своими учетным данными, используйте строку вида:

<source lang=xml>
<auth extra="8" login="login" pass="pass" clientcode="123"></auth>
</source>

Описание:
* '''extra''' — уникальный идентификатор компании;
* '''login''' — логин курьерской службы;
* '''pass''' — пароль курьерской службы;
* '''clientcode''' — внутренний код клиента (вкладка '''Клиенты''', столбец «Внутренний код»).

Вы можете узнать код экстра, логин и пароль курьерской службы в офисном приложении MeaSoft в справочнике '''Дополнительные возможности'''. Подробнее см. раздел [[Личный_кабинет_курьерской_службы#Подключение|«Подключение»]].

== Общие понятия ==
На стороне курьерской службы имеется веб-сервис по адресу: https://home.courierexe.ru/api/. <rspoiler text="Еще есть порт 8443.">Некоторые маршрутизаторы, используемые провайдерами, РНК и прочее, в попытке глубокого анализа могут повреждать трафик на стандартный порт 443. Сделано по тикету 10964.</rspoiler> Обратите внимание на символ '''"/"''' (slash) в конце адреса! Тестовые авторизационные данные: логин: login пароль: pass, параметр extra: 8. Обратите внимание, что тестовая площадка для всех одна. Не нужно передавать в нее заказы с конфиденциальными данными, их смогут увидеть другие участники.

Для использования интеграции в «боевом» режиме, запросите '''логин''', '''пароль''', и параметр '''extra''' у той компании, с которой интегрируетесь.

Вы можете отправлять тестовые запросы к нашему сервису и видеть историю отправленных запросов в личном кабинете на закладке '''Интеграция'''.

Клиент отправляет запросы к сервису методом HTTP POST, сервис обрабатывает запросы и возвращает результат выполнения. Все запросы и ответы передаются в формате XML.
Кодировка — UTF-8. Разделитель целой и дробной частей чисел — используется символ точки. Даты представляются в виде YYYY-MM-DD, время — HH:MM.

В силу [https://ru.wikipedia.org/wiki/XML#.D0.A0.D0.B5.D1.88.D0.B5.D0.BD.D0.B8.D0.B5_.D0.BF.D1.80.D0.BE.D0.B1.D0.BB.D0.B5.D0.BC.D1.8B_.D0.BD.D0.B5.D0.BE.D0.B4.D0.BD.D0.BE.D0.B7.D0.BD.D0.B0.D1.87.D0.BD.D0.BE.D1.81.D1.82.D0.B8_.D1.80.D0.B0.D0.B7.D0.BC.D0.B5.D1.82.D0.BA.D0.B8 особенностей языка XML], некоторые символы в тексте должны быть заменены: & на &amp; < на &lt; > на &gt; " на &quot;

Наше API принципиально работает только по HTTPS, так как передает конфиденциальные данные. В некоторых системах с этим возникают проблемы. Если ваша система не может полноценно работать с шифрованием, мы рекомендуем развернуть http-сервер у себя локально, установить [http://courierexe.ru/download/api/proxy.zip прокси на PHP]. <spoiler text="Как запустить">Для теста можете запустить его на сервере следующей командой: php -S <IP>:8080 proxy.php
где <IP> — это адрес вашего сервера, а 8080 порт, на котором будут приниматься запросы.
Тогда для обмена данными с нашим АПИ необходимо будет использовать адрес <IP>:8080</spoiler>
Доступность функций, описанных в этом разделе, зависит от [[Личный кабинет курьерской службы#Функции личного кабинета|тарифа вашего личного кабинета]].

== Ограничения ==
С целью защиты от нецелевого использования сервисов и DDoS-атак действуют следующие ограничения:
*30 запросов tracking с одного IP-адреса за 1 минуту (используйте statusreq!);
*150 запросов с одного IP-адреса/акаунта за 1 минуту;
*1500 запросов с одного IP-адреса/акаунта за 20 минут;
*3000 запросов с одного аккаунта за 1 час;
*200 Мб скачанных текстовых данных за 3 часа.
*Превышение количества запросов статусов несуществующих заказов над существующими

В случае превышения IP-адрес или аккаунт блокируется на время до 3-х часов.

Чтобы не происходило блокировок:
* не нужно «бомбить» наше API запросами статусов, последовательно перебирая номера всех ваших заказов, особенно запросами "tracking", они предназначены не для этого (смотрите описание). Особенно ровно в 00 минут каждого часа;
* не нужно каждые 5 минут делать запросы «Покажите статусы всех заказов за последние 3 месяца»;
* для проверки статусов заказов лучше всего использовать запросы [[#Передача только изменившихся статусов|измененных статусов changes=ONLY_LAST]];
* при запросе измененных статусов ОБЯЗАТЕЛЬНО нужно подтверждать успешное получение запросом [[#Передача только изменившихся статусов|commitlaststatus]].
* вы должны знать номера заказов, которые вы отправили. Не нужно перебирать номера всех заказов или брутфорсом перебирать все возможные номера.

Мы абсолютно уверены, что данные ограничения на порядки превосходят необходимые объемы предоставления сервиса для решения любых задач. Если у вас возникают проблемы, вы не знаете, как уложиться в эти рамки — спросите у нас, мы обязательно поможем!

== Оформление заказа ==
=== Пример оформления заказа ===

<source lang=xml>
<?xml version="1.0" encoding="UTF-8"?>
<neworder newfolder="NO">
<auth extra="8" login="login" pass="pass"></auth>
<order orderno="111111">
<barcode>111111</barcode>
<sender>
<company>МВД</company>
<person>Иванов И.И.</person>
<phone>123-45-67</phone>
<town>Санкт-Петербург</town>
<address>Петровка 38 офис 35</address>
<date>2014-03-22</date>
<time_min>09:00</time_min>
<time_max>14:00</time_max>
</sender>
<receiver>
<company>МВД</company>
<person>Чип & Дейл</person>
<phone>123-45-67</phone>
<zipcode>125480</zipcode>
<town regioncode="78" country="RU">Санкт-Петербург</town>
<address>Петровка 38 офис 35</address>
<pvz>124</pvz>
<inn>1112223335</inn>
<date>2014-03-22</date>
<time_min>09:00</time_min>
<time_max>14:00</time_max>
<deliveryPIN>1234</deliveryPIN>
<coords lat="55.680327" lon="37.604456"></coords>
</receiver>
<return>NO</return>
<weight>5.1</weight>
<return_weight>5.1</return_weight>
<quantity>2</quantity>
<paytype>CASH</paytype>
<service>2</service>
<return_service>1</return_service>
<type>3</type>
<return_type>3</return_type>
<courier>22</courier>
<price>387.5</price>
<deliveryprice VATrate="20">150</deliveryprice>
<inshprice>387.5</inshprice>
<receiverpays>NO</receiverpays>
<discount>120</discount>
<enclosure>Детские игрушки</enclosure>
<instruction>Проверить при покупателе, подписать акт</instruction>
<department>Отдел</department>
<pickup>NO</pickup>
<acceptpartially>NO</acceptpartially>
<costcode>cc12345</costcode>
<items>
<item extcode="abc123" quantity="1" mass="0.2" retprice="37.5" VATrate="0" barcode="2345625213125" textArticle="1" article="1" volume="3" origincountry="AUT" GTD="321546654" excise="15.20" suppcompany="ООО "Рога и копыта"" suppphone="79161234567" suppINN="1112223334" governmentCode="11223311">Мяч</item>
<item extcode="abc124" quantity="2" mass="2" retprice="100" inshprice="100" VATrate="10" barcode="4645625213138" article="2" length="10" width="20" height="30" origincountry="004">Обруч</item>
<item extcode="abc125" quantity="3" mass="0.3" retprice="50" inshprice="50" barcode="2345625213126" itemcode="44123" article="3" type="1">Погремушка желтая</item>
</items>
<packages>
<package strbarcode="ORD0000001" mass="1" message="" quantity="3"></package>
<package strbarcode="ORD0000002" mass="2.5" message="" length="10" width="20" height="30"></package>
</packages>
<deliveryset above_price="100" return_price="1000" VATrate="10">
<below below_sum="500" price="500" />
<below below_sum="2000" price="300" />
</deliveryset>
<advprices>
<advprice>
<code>1</code>
<value>123</value>
</advprice>
<advprice>
<code>2</code>
<value>10.5</value>
</advprice>
<advprice>
<code>3</code>
<value>true</value>
</advprice>
</advprices>
<overall_volume>81</overall_volume>
<userid>user123</userid>
<groupid>customer</groupid>
</order>
</neworder>
</source>

=== Описание элементов для оформления заказа ===
'''Обязательные поля'''

Обязательными на уровне системы являются только 3 поля: receiver->company или receiver->person, receiver->address и receiver->phone. Так же в настройках системы сама курьерская служба может назначить какие-то дополнительные поля обязательными, тогда, если вы их не укажете, получите сообщение об ошибке.
<spoiler text="Пример минимально возможного заказа">
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<neworder>
<auth extra="8" login="login" pass="pass" />
<order>
<receiver>
<company>МВД</company>
<phone>(495)123-45-67</phone>
<address>Петровка, 38</address>
</receiver>
</order>
</neworder>
</source>
</spoiler>

'''Описание полей'''

*'''neworder''' - Корневой контейнер, обязательный элемент.

:* '''''newfolder''''' - Признак нового заказа YES/NO. Если стоит YES, то в системе курьерской службы для данной корреспонденции создастся новый заказ. Необязательный элемент.

*'''order''' - Контейнер для описания одного заказа, обязательный элемент. В одном контейнере '''neworder''' может быть много контейнеров '''order''' для создания нескольких заказов одним запросом.

:* '''''orderno''''' - Номер заказа. Если присваивается клиентом - указывается здесь. Если не присваивается - можно оставить пустым, система сгенерирует свой номер, и вернет его в ответе. Система проверяет наличие заказов с указанным номером в пределах текущего календарного года, и в случае их существования - заказ создан не будет, а в ответе вернется ошибка 17 "Such number exists". Если не указан штрих-код (поле barcode), и значение поля подходит для использования его в качестве штрих-кода, данное значение будет скопировано в поле "Штрих-код". Это накладывает ограничения в частности, на длину указанного поля (25 знаков, чтобы работали стандартные печатные формы).

*'''barcode''' - Штрих-код заказа. Если клиент штрихкодирует свои отправления и штрихкод отличается от номера заказа, в этом поле указывается штрихкод. В случае наличия нескольких мест и раздельной их маркировки в этом поле допустимы маски в виде символов подчеркивания, говорящие о позициях штрихкода, переменных для разных мест в рамках одного заказа.<br />
''Например'': В заказе номер 123 имеется 20 товарных вложений, которые упакованы в 3 транспортных места. Клиент формирует 3 штрихкода на транспортные места: CLNT0012301, CLNT0012302, CLNT0012303, где CLNT - префикс клиента, 00123 - номер заказа, 01-03 - номер транспортного места в заказе. В поле barcode нужно указать CLNT00123__ (система поймет, что 2 последних символа могут быть любыми и будут отражать штрихкоды к одному заказу). Если вы не сами печатаете накладные с указанным штрихкодом, то указанный штрихкод не должен быть длиннее 25 знаков, иначе он не поместится на стандартных печатных формах.

*'''sender''' - Информация о отправителе заказа. Необязательный контейнер.
<source lang="xml">
<sender>
<company>Название компании отправителя</company>
<person>Контактное лицо отправителя</person>
<phone>Телефон, Email отправителя</phone>
<town>Город отправителя в формате "Москва город"</town>
<address>Адрес отправителя</address>
<date>Дата забора в формате "YYYY-MM-DD"</date>
<time_min>Желаемое время забора в формате "HH:MM"</time_min>
<time_max>Желаемое время забора в формате "HH:MM"</time_max>
</sender>
</source>

*'''receiver''' - Информация о получателе заказа. Обязательный контейнер.
<source lang="xml">
<receiver>
<company>Название компании получателя</company>
<person>Контактное лицо получателя</person>
<phone>Телефон, Email получателя</phone>
<town regioncode="Код региона">Город получателя в формате "Москва город"</town>
<address>Адрес получателя</address>
<inn>ИНН получателя</inn>
<pvz>Код пункта самовывоза по справочнику</pvz>
<date>Дата доставки в формате "YYYY-MM-DD"</date>
<time_min>Желаемое время доставки в формате "HH:MM"</time_min>
<time_max>Желаемое время доставки в формате "HH:MM"</time_max>
<deliveryPIN>Пин-код для подтверждения получателем</deliveryPIN>
<coords lat="55.680327" lon="37.604456"></coords>
</receiver>
</source>

*'''company''' - Компания-получатель.
*'''person''' - Контактное лицо. ''Должно быть заполнено хотя бы одно из полей - company или person!''
*'''phone''' - Телефон. Можно указывать несколько телефонов, E-mail в этом поле.
*'''town''' - Город.
*'''pvz''' - Код пункта самовывоза по справочнику. Кроме того, ПВЗ можно указать в строке '''''address''''' в виде:
:* код ПВЗ в нашей системе
:* код ПВЗ в системе подрядчика
:* наименование ПВЗ в виде строки "ПВЗ " + "Наименование ПВЗ"

Для тега города '''town''' можно указать код региона в атрибуте '''''regioncode''''' из [[#Справочник регионов|справочника регионов]]. Поиск будет производиться в указанном регионе.

Также можно указать страну получателя в атрибуте '''''country''''' в соответствии с [https://ru.wikipedia.org/wiki/ISO_3166-1 стандартом ISO_3166-1], например, "RU", "RUS" или "643" для России.

Кроме того, поиск города осуществляется с учетом почтового индекса, указанного в теге '''zipcode'''.

Поле '''Город''' контейнеров '''sender''' и '''receiver''' можно указать одним из следующих способов:
:* код населенного пункта из [[#Справочник городов|справочника городов]]
:* 13-ти значный код адресного классификатора КЛАДР
:* 36-ти значный код адресной системы <rspoiler text="ФИАС">Федеральная информационная адресная система — единый российский государственный адресный реестр</rspoiler> (AOID)
:* название города (не рекомендуется!)

*'''coords''' - Координаты получателя. Если не указаны, система будет геокодировать самостоятельно.

*'''paytype''' - Тип оплаты заказа получателем. Принимает значения:
:* CASH - Наличными при получении (по-умолчанию)
:* CARD - Картой при получении
:* NO - Без оплаты. Этот тип оплаты передается, если заказ уже оплачен и не требует инкассации. API добавит к товарам строку предоплаты в сумму заказа, чтобы общая сумма была 0, однако в кассовом чеке будут все товары с ценами, и оплата предоплатой, как того требует 54-ФЗ.
:* OTHER - Прочее (Предусмотрен для того, чтобы оплата поступала непосредственно в курьерскую службу посредством прочих типов оплаты - таких как: вебмани, яденьги, картой на сайте, прочие платежные системы и т.д.)
:* OPTION - На выбор получателя. Этот тип оплаты нельзя передавать с заказом. Он выставляется автоматически в зависимости от настройки клиента.

*'''zipcode''' - Почтовый индекс.
*'''weight''' - Общий вес заказа в килограммах.
*'''return_weight''' - Общий вес возврата заказа в килограммах.
*'''quantity''' - Количество мест.
*'''service''' - Режим доставки (тип услуги) передается код из справочника [[#Справочник Видов срочности|"Виды срочности"]].
*'''return_service''' - Режим возврата (тип услуги) передается код из справочника "Виды срочности".
*'''type''' - Тип корреспонденции (отправления) передается код из справочника "Типы корреспонденции".
*'''return_type''' - Тип возвратной корреспонденции (отправления) передается код из справочника "Типы корреспонденции".
*'''price''' - Сумма заказа. В случае наличия контейнера items значение этого параметра будет проигнорировано и рассчитано автоматически.
*'''deliveryprice''' - Сумма доставки. В случае наличия контейнера items в него будет добавлено вложение "Доставка".
:* '''''VATrate''''' - Ставка НДС - целое число процентов.
*'''return''' - Признак необходимости возврата.
*'''return_service''' - Режим возврата (тип услуги) передается код из справочника "Виды срочности".
*'''discount''' - Сумма скидки. Скидка "размазывается" по товарным вложениям, сумма НП уменьшается на сумму скидки. При этом вложение Скидка не создается. ВНИМАНИЕ, при использовании этого тега общая сумма может расходиться на копейки из-за округления! Старайтесь не использовать этот тег, а указывать цену товаров уже с учетом скидок.
*'''enclosure''' - Вложение.
*'''inshprice''' - Объявленная ценность. Если явно не указана сумма - автоматически считается как сумма по товарам.
*'''instruction''' - Поручение - Примечание.
*'''courier''' - Запланированный курьер. Согласно коду курьера в КС2008.
*'''receiverpays''' - Признак оплаты стоимости доставки - услуг службы доставки получателем, а не заказчиком YES/NO.
*'''department''' - Подразделение, в котором оформляется заказ.
*'''pickup''' - Признак оформления забора YES/NO. Если стоит YES, то весь заказ считается заданием на забор груза, а не на доставку! Применяется для вызова курьера к отправителю для забора других отправлений. ''Внимание!'' при добавлении в забор складских товаров, их тип '''''type''''' всегда должен быть установлен как [7] Забор товара, если будет указан другой тип, то он будет исправлен в момент добавления заказа на [7] Забор товара
*'''acceptpartially''' - Признак возможности частичного выкупа товаров отправления YES/NO.

*'''items''' - Контейнер для описания вложений. <rspoiler text="Необязательный контейнер">Если для поставщика товара в системе MeaSoft не указаны полное наименование компании и ИНН в карточке клиента, заполните параметры <code>suppcompany</code> и <code>suppINN</code> в этом контейнере. Отсутствие информации о поставщике приведет к [[Настройка модуля печати кассовых чеков#Ошибка фискализации (ошибка программирования реквизита 1226)|ошибке фискализации]].</rspoiler>. Атрибуты:
:* '''''item''''' - Название вложения.
:* '''''quantity''''' - Количество единиц товара.
:* '''''mass''''' - Масса единицы товара в килограммах.
:* '''''volume''''' - Объемный вес единицы товара в килограммах. При указании объемного веса значение подставляется вместо массы
:* '''''length''''' - Длина единицы товара (в сантиметрах).
:* '''''width''''' - Ширина единицы товара (в сантиметрах).
:* '''''height''''' - Высота единицы товара (в сантиметрах).
:* '''''retprice''''' - Цена единицы товара. Округляется до копеек. Должна быть с учетом всех скидок и наценок. Для вложений типов 1, 2, 3 не может быть отрицательной. 
:* '''''inshprice''''' - Объявленная ценность единицы товара. Округляется до копеек. Если не указана принимается равной '''''retprice'''''.
:* '''''VATrate''''' - Ставка НДС - целое число процентов. Если значение не указано, подставляется значение "20". Значение "0" означает ставку "Без НДС", ставка "0%" на данный момент не поддерживается.
:* '''''barcode''''' - Штрих-код вложения. [[Файл:Article.png|thumb|100px|right]]
:* '''''article''''' - Артикул вложения. ''Внимание!'' Указание артикула используется только тогда, когда товар хранится на ответственном хранении в службе доставки, и необходима комплектация. В этом случае система пытается привязать товар к [[API#Справочник номенклатуры|справочнику номенклатуры]]. Если товар в справочнике не найден - система выдаст соответствующую ошибку. Если по артикулу найдено несколько товаров - система выберет один из них случайным образом, что может привести к ошибочной комплектации! Если товар НЕ на ответственном хранении - артикул указывать НЕ нужно. Позиция попадет в систему просто текстом.
:* '''''itemcode''''' - Внутренний код товара, может использоваться вместо артикула. ''Внимание!'' Указание кода товара используется только тогда, когда товар хранится на ответственном хранении в службе доставки, и необходима комплектация. В этом случае система пытается привязать товар к [[API#Справочник номенклатуры|справочнику номенклатуры]]. Если товар в справочнике не найден - система выдаст соответствующую ошибку. Если товар НЕ на ответственном хранении - код товара указывать НЕ нужно.
:* '''''type''''' - Тип вложения. Принимает значения:
:: 1 - Товар. По-умолчанию.
:: 2 - Доставка. Такое вложение добавится автоматически, если заполнить order->deliveryprice
:: 3 - Услуга
:: 4 - Предоплата. Указывается сумма. Поле quantity игнорируется, всегда "1". В заказе сумма будет отрицательной независимо от знака в запросе. Такое вложение добавится автоматически при указании order->paytype=NO.
:: 6 - Оплата кредитом. Указывается сумма. Поле quantity игнорируется, всегда "1". В заказе сумма будет отрицательной независимо от знака в запросе.
:: 7 - Забор товара. Если товар нужно у получателя забрать, возможно - вернуть деньги, или его стоимость вычтется из суммы других товаров. У такого товара в заказе будет отрицательное количество независимо от знака в запросе.
:* '''''extcode''''' - Внешний код строки. Используется для идентификации строк заказов при получении статусов. Необязательное поле.
:* '''''origincountry''''' - Код страны-производителя в соответствии со [https://ru.wikipedia.org/wiki/ISO_3166-1 стандартом ISO_3166-1], например, "RU", "RUS" или "643" для России.
:* '''''GTD''''' - Номер ГТД.
:* '''''excise''''' - Сумма акциза.
:* '''''suppcompany''''' - Наименование компании поставщика, если отличается от заказчика.
:* '''''suppphone''''' - Номер телефона компании поставщика, если отличается от заказчика.
:* '''''suppINN''''' - ИНН компании поставщика, если отличается от заказчика.
:* '''''governmentCode''''' - Код товарной номенклатуры. Используется для [[Маркировка | маркированных товаров ("Честный знак")]]. Нужно указывать все данные из нанесенного QR-кода кроме не читаемых символов (#29). Если код не известен - укажите знак вопроса "?", тогда курьер отсканирует код фактически передаваемого покупателю товара. Для некоторых процессов может использоваться значение "!" - в этом случае курьер сканирует серийный номер товара, но это не считается кодом маркировки. Если поле заполнено - поле quantity должно содержать только "1", иначе вернется ошибка.

*'''packages''' - Контейнер для описания мест. Необязательный контейнер. Атрибуты:
:* '''''package''''' - Название места.
:* '''''code''''' - Внутренний код строки.
:* '''''strbarcode''''' - Штрих-код места.
:* '''''mass''''' - Масса места в килограммах.
:* '''''message''''' - Строка сообщения.
:* '''''length''''' - Длина товарного места (в сантиметрах).
:* '''''width''''' - Ширина товарного места (в сантиметрах).
:* '''''height''''' - Высота товарного места (в сантиметрах).
:* '''''quantity''''' - Количество мест с данным набором параметров. Действует ограничение на общее количество мест в заказе. Общее количество мест в заказе не может быть больше 1000.

* '''deliveryset''' - настройка [[Дифференциальная стоимость доставки | дифференцированной стоимости доставки]]. Атрибуты:
:* '''''above_price''''' - стоимость в случае полного выкупа заказа (действует как "сумма от" последней границы, указанной в теге below_sum)
:* '''''return_price''''' - стоимость в случае возврата заказа
:* '''''VATrate''''' - Ставка НДС - целое число процентов.

* '''below''' - граница стоимости настроек
:* '''''below_sum''''' - граница стоимости выкупаемого заказа
:* '''''price''''' - стоимость выкупаемого заказа до соответствующей границы

* '''advprices''' - Контейнер для описания дополнительных услуг. Необязательный элемент. <span style="color: red;>Для обработки в API включите дополнительные услуги в настройках полей [[Личный_кабинет_курьерской_службы#Настройка личного кабинета клиента|заказов и заборов]]</span>
:* '''''code''''' - код услуги.
:* '''''value''''' - значение услуги. Если тип услуги bool, то в значении передаем true.

*'''costcode''' - Кост-код сотрудника.

*'''overall_volume''' - Общий объем, м3. Виртуальное поле. Необязательное. Из этого поля рассчитывается длина/высота/ширина места. Расчет срабатывает только если в каждом месте есть нулевые значения длины или высоты или ширины.

*'''userid''' - Идентификатор пользователя, строковый или числовой тип. Виртуальное поле. Необязательное. Данное поле используется совместно с настройками "Цена доставки для получателя", определяя приоритет правила. Можно использовать в различных CMS/CRM системах, настраивая цены для определенного покупателя.

*'''groupid''' - Идентификатор группы пользователя, строковый или числовой тип. Виртуальное поле. Необязательное. Данное поле используется совместно с настройками "Цена доставки для получателя", определяя приоритет правила. Можно использовать в различных CMS/CRM системах, настраивая цены для определенной группы покупателей.

<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
'''Обратите внимание!'''
При передаче заказов, у которых плановая дата доставки/забора меньше ближайшей возможной, дата автоматически меняется на самую раннюю возможную. [[Личный_кабинет_курьерской_службы#Как считается минимальная дата возможной доставки|Подробнее]]</div>

В случае необходимости указания, помимо товаров, дополнительных услуг (например, ДОСТАВКА, комплектация, подъем на этаж и т.д.) - их нужно указать в том же контейнере items как товары, без артикула.

=== Примеры ответов ===
При успешном выполнении запроса, создании заказа, возвращается сумма заказа в атрибуте orderprice, а также ошибка 0. При не успешном - номер ошибки и текст ее на английском языке в атрибуте errormsg, для некоторых ошибок выводится перевод на русский в атрибуте errormsgru.
В атрибут orderno помещается номер заказа, в атрибут barcode - штрихкод заказа.

'''Пример успешного ответа'''

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<neworder>
<createorder orderno="AB23541" barcode="67567#114" error="0" errormsg="Success" errormsgru="Успешно" orderprice="5000" />
<createorder orderno="AB23542" barcode="67567#115" error="0" errormsg="Success" errormsgru="Успешно" orderprice="6000" />
<createorder orderno="AB23543" barcode="67567#116" error="0" errormsg="Success" errormsgru="Успешно" orderprice="0" />
</neworder>
</source>

'''Пример ответа с ошибкой'''

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<neworder>
<createorder orderno="AB23541" barcode="67567#114" error="67" errormsg="Order barcode already exists in the database." errormsgru="Такой штрихкод заказа уже есть в базе." />
<createorder orderno="AB23542" barcode="67567#115" error="17" errormsg="Order number already exists in the database." errormsgru="Такой номер заказа уже есть в базе." />
<createorder orderno="AB23543" barcode="67567#116" error="67" errormsg="Order barcode already exists in the database." errormsgru="Такой штрихкод заказа уже есть в базе." />
</neworder>
</source>

'''Пример ответа при ошибке авторизации'''

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<request>
<error error="1" errormsg="authorization error"></error>
</request>
</source>

'''Пример ответа при ошибке синтаксиса'''

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<request>
<error>column:1 line:11 message:expected '>'</error>
</request>
</source>

=== Коды и описание ошибок ===

{|class=wikitable
!Код ошибки
!Английское описание
!Русское описание
|-
|0||Success||Успешно
|-
|1||Wrong XML||Некорректный файл XML.
|-
|2||Lat is empty||Укажите широту.
|-
|3||Specify a valid "Price" field value.||Укажите корректное значение поля «Сумма».
|-
|4||Specify a valid "Weight" field value.||Укажите корректное значение поля «Вес».
|-
|5||Recepient city/town not found.||Город назначения не найден.
|-
|6||Sender city/town not found.||Город отправления не найден.
|-
|7||Specify the "Recipient address" field value.||Укажите значение поля «Адрес получателя».
|-
|8||Specify the "Recipient phone" field value.||Укажите значение поля «Телефон получателя».
|-
|9||Specify the "Recipient name" field value.||Укажите значение поля «ФИО получателя».
|-
|10||Specify a valid "Quantity" field value.||Укажите корректное значение поля «Количество».
|-
|11||Specify a valid "Declared value" field value.||Укажите корректное значение поля «Объявленная ценность».
|-
|12||Supplier SKU ID not found.||Артикул не найден.
|-
|17||Order number already exists in the database.||Такой номер заказа уже есть в базе.
|-
|18||Order code already exists in the database.||Такой код заказа уже есть в базе.
|-
|19||The delivery date format is not valid. Specify a date in YYYY-MM-DD format.||Укажите значение поля «Дата доставки» в формате гггг-мм-дд.
|-
|20||Specify a valid "Delivery mode" field value.||Укажите корректное значение поля «Режим доставки».
|-
|21||Specify a valid "Return trip mode" field value.||Укажите корректное значение поля «Режим возврата».
|-
|22||Specify a valid "Delivery type" field value.||Укажите корректное значение поля «Тип доставки».
|-
|23||Specify a valid "Return shipment type" field value.||Укажите корректное значение поля «Тип возврата».
|-
|30||Specify the "Order number" field value.||Укажите значение поля «Номер заказа».
|-
|31||Specify the "Barcode" field value.||Укажите значение поля «Штрихкод».
|-
|32||Specify the "Sender company" field value.||Укажите значение поля «Компания-отправитель».
|-
|33||Specify the "Sender name" field value.||Укажите значение поля «ФИО отправителя».
|-
|34||Specify the "Sender phone" field value.||Укажите значение поля «Телефон отправителя».
|-
|35||Specify the "Sender city/town" field value.||Укажите значение поля «Город отправителя».
|-
|36||Specify the "Sender address" field value.||Укажите значение поля «Адрес отправителя».
|-
|37||Specify the "Pickup date" field value.||Укажите значение поля «Дата забора».
|-
|38||Specify the "Pickup time from" field value.||Укажите значение поля «Время забора с».
|-
|39||Specify the "Pickup time to" field value.||Укажите значение поля «Время забора до».
|-
|40||Specify the "Recipient company" field value.||Укажите значение поля «Компания-получатель».
|-
|41||Specify the "Recipient name" field value.||Укажите значение поля «ФИО получателя».
|-
|42||Specify the "Recipient phone" field value.||Укажите значение поля «Телефон получателя».
|-
|43||Specify the "Recipient city/town" field value.||Укажите значение поля «Город получателя».
|-
|44||Specify the "Recipient address" field value.||Укажите значение поля «Адрес получателя».
|-
|45||Specify the "Delivery date" field value.||Укажите значение поля «Дата доставки».
|-
|46||Specify the "Delivery time from" field value.||Укажите значение поля «Время доставки с».
|-
|47||Specify the "Delivery time to" field value.||Укажите значение поля «Время доставки до».
|-
|48||Specify the "Recipient postcode" field value.||Укажите значение поля «Индекс получателя».
|-
|49||Specify the "Weight" field value.||Укажите значение поля «Вес».
|-
|50||Specify the "Payment type" field value.||Укажите значение поля «Тип оплаты».
|-
|51||Specify the "Quantity" field value.||Укажите значение поля «Количество».
|-
|52||Specify the "Amount" field value.||Укажите значение поля «Сумма».
|-
|53||Specify the "Declared value" field value.||Укажите значение поля «Объявленная стоимость».
|-
|54||Specify the "Description" field value.||Укажите значение поля «Описание».
|-
|55||Specify the "Instruction" field value.||Укажите значение поля «Поручение».
|-
|56||Specify the "Delivery mode" field value.||Укажите значение поля «Режим доставки».
|-
|57||Specify the "Shipment type" field value.||Укажите значение поля «Тип отправления».
|-
|58||Specify whether return trip is required.||Укажите значение поля «Необходимость возврата».
|-
|59||Specify the "Return trip mode" field value.||Укажите значение поля «Режим возврата»
|-
|60||Specify the "Return shipment type" field value.||Укажите значение поля «Тип возврата».
|-
|61||Specify barcode.||Укажите штрихкод.
|-
|62||Specify item weight.||Укажите массу единицы товара.
|-
|63||Specify item quantity.||Укажите количество товара.
|-
|64||Specify item price.||Укажите цену единицы товара.
|-
|65||Specify item name.||Укажите название товара.
|-
|66||Wrong XLS file||Некорректный файл XLS.
|-
|67||Order barcode already exists in the database.||Такой штрихкод заказа уже есть в базе.
|-
|68||Select the "Payment by recipient" field value.||Укажите значение поля «Оплата получателем».
|-
|69||Specify department.||Укажите отдел.
|-
|70||Specify service partner code.||Укажите значение поля «Код подрядчика».
|-
|71||Date cannot be earlier than tomorrow.||Дата не может быть раньше чем завтра.
|-
|72||Date cannot be later than 15 days from now.||Дата не может быть позже чем через 15 дней.
|-
|73||Date cannot be earlier than today.||Дата не может быть раньше чем сегодня.
|-
|74||Date cannot be later than {0} days from now.||Дата не может быть позже, чем через {0} дней.
|-
|75||Specify a valid "Item weight" field value.||Укажите корректное значение поля «Масса единицы товара».
|-
|76||Specify a valid "Quantity" field value.||Укажите корректное значение поля «Количество товара».
|-
|77||Specify a valid "Item price" field value.||Укажите корректное значение поля «Цена единицы товара».
|-
|78||Specify a valid "Delivery time from" field value.||Укажите корректное значение поля «Время доставки с».
|-
|79||Specify a valid "Delivery time to" field value.||Укажите корректное значение поля «Время доставки до».
|-
|80||Specify a valid "Pickup time from" field value.||Укажите корректное значение поля «Время забора с».
|-
|81||Specify a valid "Pickup time to" field value.||Укажите корректное значение поля «Время забора до».
|-
|82||Specify a valid "Pickup point" field value.||Укажите корректное значение поля «ПВЗ».
|-
|83||Duplicate number in the registry.||Дублирование номера в реестре.
|-
|84||Duplicate barcode in the registry.||Дублирование штрихкода в реестре.
|-
|85||Specify a valid "Weight at return trip" field value.||Укажите корректное значение поля «Вес возврата».
|-
|86||Specify the "Weight at return trip" field value.||Укажите значение поля «Вес возврата».
|-
|87||Order weight exceeds the allowed maximum for the pickup point.||Вес превышает допустимое значение для этого ПВЗ.
|-
|88||Pickup date cannot be earlier than today.||Дата забора не может быть раньше чем сегодня.
|-
|89||Specify a later delivery date.||Укажите более позднюю дату доставки.
|-
|90||Inappropriate "Weight" or "Pay type" field value for the selected city or town. Please review and correct the values.||Значение поля «Масса» или «Тип оплаты» для выбранного города указано некорректно или отсутствует. Проверьте значения и исправьте.
|-
|91||{deliverytype} {deliverydate} is {holidaytype}. Select another date.||{deliverytype} {deliverydate} является {holidaytype}. Выберите другую дату.
|-
|92||{deliverytype} {deliverydate} is {holidaytype}. Select another date.||{deliverytype} {deliverydate} является {holidaytype}. Выберите другую дату.
|-
|93||Add items.||Добавьте товары.
|-
|95||The selected pickup point only allows paid orders.||Выбранный ПВЗ выдает только предоплаченные заказы.
|-
|96||Order barcode exceeds the allowed maximum (25) symbols.||Длина штрихкода заказа превышает максимально допустимую (25 символов).
|-
|97||The pickup date format is not valid. Specify a date in YYYY-MM-DD format.||Укажите значение поля «Дата забора» в формате гггг-мм-дд.
|-
|98||Specify the cost code.||Укажите значение поля «Кост-код».
|-
|99||The item is not in stock.||Товар отсутствует на складе.
|-
|100||Set the quantity of the item marked with Chestny ZNAK to one.||Укажите количество товара, маркированного кодом «Честный ЗНАК», равным единице.
|-
|101||Quantity of item Delivery cannot be greater than 1||Количество вложений типа «Доставка» не может быть более 1.
|-
|102||А database error occurred. Please try later again.||Ошибка базы данных. Попробуйте позже.
|-
|103||Order not found.||Заказ не найден.
|-
|104||Cannot edit order in the current status.||Невозможно изменить заказ в текущем статусе.
|-
|105||Discount cannot be greater than the order amount. Specify a smaller value.||Размер скидки не может превышать сумму заказа. Укажите меньшее значение скидки.
|-
|106||Specify the correct additional service code.||Укажите корректный код дополнительной услуги.
|-
|107||Specify the correct additional service name.||Укажите корректное значение поля [advprice][value].
|-
|108||Specify the "Additional services" field value.||Укажите значение поля «Дополнительные услуги».
|-
|110||Specify the correct TIN.||Укажите корректный ИНН.
|-
|111||Specify the correct IIN (KZ).||Укажите корректный ИИН (КЗ).
|-
|112||Specify the overall volume.||Укажите общий объем.
|-
|113||Cannot apply the delivery mode. Select another delivery mode.||Режим доставки не подходит для заказа. Выберите другой режим.
|-
|114||The pickup point does not support the selected delivery mode. Specify another pickup point.||ПВЗ не подходит для выбранного режима доставки. Укажите другой ПВЗ.
|-
|115||Specify a valid recipient phone number.||Укажите корректный телефон получателя.
|-
|116||Specify recipient PIN code.||Укажите пин-код получателя.
|-
|117||Order date cannot be earlier than {0}. Specify another date.||Дата заказа не может быть раньше {0}. Укажите другую дату.
|-
|118||Pickup date cannot be earlier than {0}. Specify another date.||Дата забора не может быть раньше {0}. Укажите другую дату.
|-
|119||Specify the correct item type.||Укажите корректный тип вложения.
|-
|120||The pickup point does not accept payment by card.||В выбранном ПВЗ оплата картой не принимается.
|-
|121||Invalid item code format||Неверный формат кода товарной номенклатуры
|-
|}

== Запрос статуса заказов ==

=== Пример запроса статуса заказа ===

<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<statusreq>
<auth extra="8" login="login" pass="pass"></auth>
<client>CLIENT</client>
<orderno>1234</orderno>
<orderno2>5678</orderno2>
<ordercode>34234</ordercode>
<givencode>234534</givencode>
<datefrom>2016-07-21</datefrom>
<dateto>2016-07-21</dateto>
<target>Автозавод</target>
<done>ONLY_NOT_DONE</done>
<changes>ONLY_LAST</changes>
<conditions>
<namecontains/>
<namestarts/>
</conditions>
</statusreq>
</source>

=== Описание полей запроса статуса ===

'''statusreq''' - Корневой контейнер. Обязательный элемент.
*'''auth''' - Авторизация. Обязательный элемент.
*'''client''' - Признак клиента или агента. Необязательный элемент.
:* CLIENT - Признак клиента, значение по умолчанию
:* AGENT - Признак агента. В ответ отдается информация по заказам, переданным агенту на доставку
*'''orderno''' - Номер заказа. Необязательный элемент.
*'''ordercode''' - Внутренний код заказа. Необязательный элемент.
*'''orderno2''' - Номер заказа из срочных. Необязательный элемент.
*'''datefrom''' - Дата заказа "с". Необязательный элемент.
*'''dateto''' - Дата заказа "по". Необязательный элемент.
*'''target''' - Строка поиска. Позволяет указать текст, который содержится в названии компании или адресе получателя.
*'''done''' - Может принимать значения:
:* ONLY_DONE - Только доставленные (имеются в виду успешные статусы, например, '''Доставлен''' или '''Частично доставлен''')
:* ONLY_NOT_DONE - Только не доставленные (заказы, которые не являются доставленными, например, '''Не доставлен''' или '''Утерян''')
:* ONLY_NEW - Только новые
:* ONLY_DELIVERY - Только заказы в обработке - заказы, находящиеся в любом статусе, кроме конечных: Доставлено, Не доставлено, Отменён и т.д.
:* ''Пусто'' - все корреспонденции

*'''changes''' - может принимать значение только ONLY_LAST. Если указан этот параметр, все остальные игнорируются. Описание данного режима приведено здесь: [[#Передача только изменившихся статусов|Передача только изменившихся статусов]]

*'''conditions''' - Задает условия фильтрации по "orderno". Все вложенные элементы одновременно накладывают условие "И". Минимум 5 символов!
:* '''namecontains''' - Поиск по номеру заказа(шифр), который содержит "orderno".
:* '''namestarts''' - Поиск по номеру заказа(шифр), который начинается с "orderno".

<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
'''Обратите внимание!'''
# Периода запроса статусов (контейнеры '''datefrom''' и '''dateto''') ограничивается двумя месяцами — два месяца до даты '''"по"'''.
# Если не указаны обе даты — '''dateto''' принимается равной текущей дате.
# Если не указана дата '''dateto''' — она принимается равной '''datefrom''' плюс 2 месяца.
# Если не указана дата '''datefrom''' — она принимается равной '''dateto''' минус 2 месяца.
# Поиск по '''conditions''' работает только для "Номер заказа(шифр)" и только от 4 символов
</div>
<br />

=== Примеры ответов ===

'''Пример успешного ответа'''

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<statusreq count="23">
<order orderno="111111" awb="qwerty" orderno2="123123" ordercode="34534234" givencode="2345334">
<barcode>111111</barcode>
<sender>
<company>МВД</company>
<person>Иванов И.И.</person>
<phone>123-45-67</phone>
<contacts>
<phone>+74951234567</phone>
</contacts>
<town code="23432">Санкт-Петербург</town>
<address>Петровка 38 офис 35</address>
<date>2014-03-22</date>
<time_min>09:00</time_min>
<time_max>14:00</time_max>
</sender>
<receiver>
<company>МВД</company>
<person>Иванов И.И.</person>
<phone>123-45-67 - Иван (916)234.45.21 Петр,mvd@mail.ru</phone>
<contacts>
<phone>+74951234567</phone>
<phone>+79162344521</phone>
<email>mvd@mail.ru</email>
</contacts>
<inn>1112223335</inn>
<zipcode>125480</zipcode>
<town code="153361" regioncode="78" regionname="Санкт-Петербург город">Санкт-Петербург город</town>
<address>Петровка 38 офис 35</address>
<pvz>
<code>126</code>
<clientcode>QWERTY</clientcode>
</pvz>
<date>2014-03-22</date>
<time_min>09:00</time_min>
<time_max>14:00</time_max>
<coords lat="55.680327" lon="37.604456"></coords>
<deliveryPIN>1234</deliveryPIN>
</receiver>
<pickup>NO</pickup>
<weight>5.1</weight>
<return_weight>5.1</return_weight>
<quantity>2</quantity>
<paytype>CASH</paytype>
<service>2</service>
<return_service>2</service>
<type>3</type>
<return_type>3</return_type>
<waittime>12</waittime>
<price>387.5</price>
<print_check>YES</print_check>
<inshprice>387.5</inshprice>
<enclosure>Детские игрушки</enclosure>
<instruction>Проверить при покупателе, подписать акт</instruction>
<currcoords lat="55.680327" lon="37.604456" accuracy="50" RequestDateTime="2014-04-21 18:07:45"></currcoords>
<courier>
<code>26</code>
<name>Иванов Владимир Петрович</name>
<phone>+79161234567</phone>
</courier>
<deliveryprice total="158.6" delivery="100.00" return="58.6">
<advprice code="1" price="150">База</advprice>
<advprice code="2" price="0">% от объявленной стоимости</advprice>
<advprice code="3" price="8.6">Топливный сбор</advprice>
<advprice code="4" price="0">Округление</advprice>
</deliveryprice>
<receiverpays>NO</receiverpays>
<acceptpartially>NO</acceptpartially>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 17:22:00" createtimegmt="2016-06-03 16:14:44" message="" title="Доставлен">COMPLETE</status>
<statushistory>
<status eventstore="Офис в Москве" eventtime="2016-05-30 10:20:00" createtimegmt="2016-06-03 16:14:44" message="" title="Новый">NEW</status>
<status eventstore="Офис в Москве" eventtime="2016-06-01 17:38:00" createtimegmt="2016-06-03 16:14:44" message="филиал в Санкт-Петербурге" title="Планируется отправка">DEPARTURING</status>
<status eventstore="Офис в Москве" eventtime="2016-06-01 19:53:00" createtimegmt="2016-06-03 16:14:44" message="филиал в Санкт-Петербурге" title="Отправлено со склада">DEPARTURE</status>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 07:41:00" createtimegmt="2016-06-03 16:14:44" message="" title="Получен складом">ACCEPTED</status>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 09:17:00" createtimegmt="2016-06-03 16:14:44" message="" title="Выдан курьеру на доставку">DELIVERY</status>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 17:22:00" createtimegmt="2016-06-03 16:14:44" message="" title="Доставлен (предварительно)">COURIERDELIVERED</status>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 17:22:00" createtimegmt="2016-06-03 16:14:44" message="" title="Доставлен">COMPLETE</status>
</statushistory>
<customstatecode>2<customstatecode>
<clientstatecode></clientstatecode>
<costcode>cc12345</costcode>
<receipt fdNum="124555" fnSn="9289000100295555" kktNum="0001611984048555" inn="7722756555" fdValue="2899551555" summ="387.5" ofdUrl="gate.ofd.ru">https://ofd.ru/rec/7722756555/0001611984048555/9289000100295555/124555/2899551555</receipt>
<deliveredto>Иванова, секр.</deliveredto>
<delivereddate>2016-06-02</delivereddate>
<deliveredtime>17:22</deliveredtime>
<arrival>2016-05-02 23:21</arrival>
<outstrbarcode>EXT123456</outstrbarcode>
<partner>Офис на Ленина</partner>
<return_message>Доставлено в целости</return_message>
<department>Отдел</department>
<items>
<item code="34533" extcode="abc123" quantity="1" mass="0.2" retprice="37.5" VATrate="0" barcode="2345625213125" article="1" returns="0" origincountry="040" GTD="" excise="0.00" governmentCode="11223311" suppcompany="Поставщик" suppINN="1112223334" suppphone="79161234567">Мяч</item>
<item code="34456" extcode="abc124" quantity="2" mass="2" retprice="100" VATrate="10" barcode="4645625213138" article="2" returns="0" governmentCode="">Обруч</item>
<item code="34421" extcode="abc125" quantity="3" mass="0.3" retprice="50" VATrate="18" barcode="2345625213126" itemcode="44123" article="3" returns="0" governmentCode="">Погремушка желтая</item>
</items>
<packages>
<package code="33331" strbarcode="ORD0000001" mass="1" message="" got="YES"></package>
<package code="33332" strbarcode="ORD0000002" mass="2.5" message="" got="NO"></package>
</packages>
</order>
</statusreq>
</source>

'''Пример ответа если нет заказов'''

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<statusreq count="0">
</statusreq>
</source>

'''Пример ответа при ошибке авторизации'''

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<request>
<error error="1" errormsg="authorization error"></error>
</request>
</source>

'''Пример ответа при ошибке синтаксиса'''

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<request>
<error>column:1 line:11 message:expected '>'</error>
</request>
</source>

=== Описание полей ответа статусов ===
Все поля ответа соответствуют структуре order при создании заказа, с некоторыми добавлениями:

* Атрибуты контейнера '''order''':
:* '''''awb''''' - Номер накладной в системе курьерской службы.
:* '''''orderno2''''' - Номер накладной в подсистеме срочной доставки курьерской службы.
:* '''''ordercode''''' - внутренний код заказа в системе, применяется для некоторых внутренних операций.
:* '''''givencode''''' - внутренний код заказа в системе, применяется для некоторых внутренних операций.

* атрибут '''''code''''' контейнера '''item''' - внутренний код строки заказа в системе, применяется для некоторых внутренних операций.
:* '''''returns''''' - количество данного товара, от которого отказался получатель. Не нулевое только в случае частичного отказа.

* атрибут '''''got''''' контейнера '''package''' - признак принятого места YES / NO.
:* '''''returns''''' - количество данного товара, от которого отказался получатель. Не нулевое только в случае частичного отказа.

* '''''coords''''' в контейнере '''receiver''' - координаты получателя.
* '''''deliveryPIN''''' в контейнере '''receiver''' - Пин-код.
* '''pickup''' - признак оформления забора, возможные значения: '''YES''', '''NO'''. Если указано '''YES''', то весь заказ считается заданием на забор груза, а не на доставку.
* '''currcoords''' - текущие координаты заказа. Атрибуты:
:* '''''lat''''' - широта
:* '''''lon''''' - долгота
:* '''''accuracy''''' - точность в метрах
:* '''''RequestDateTime''''' - дата/время последнего обновления координат.

* '''courier''' - Данные курьера, которому выдан заказ. Если заказ не выдан, то выводятся данные запланированного курьера.
* '''waittime ''' - Время ожидания курьера.
* '''deliveryprice''' - Стоимость услуг в валюте расчетов с клиентом. Атрибуты:
:* '''''total''''' - общая стоимость услуг
:* '''''delivery''''' - стоимость доставки "Туда"
:* '''''return''''' - стоимость доставки "Обратно" (если order->return=YES)
Тэг '''deliveryprice''' включает список дополнительных услуг (только для тарифа "Премиум"):
:* '''''advprice''''' - наименование дополнительной услуги
:* '''''code''''' - код дополнительной услуги
:* '''''price''''' - стоимость дополнительной услуги

* '''status''' - статус доставки (список статусов см. ниже). Атрибуты (заполняются начиная с версии системы 2008.0.0.670):
:* '''''eventstore''''' - филиал, к которому относится текущий статус
:* '''''eventtime''''' - время события по часовому поясу места его наступления.
:* '''''createtimegmt''''' - время по GMT создания записи о смене статуса в БД. Используется для сортировки записей, чтобы соблюсти хронологическую последовательность. <spoiler text="Подробнее">Большинство событий фиксируются в полях eventtime и createtimegmt на основании одного действия, тогда они отличаются только сдвигом от GMT. Однако, если курьер доставил отправление 10.10.2010 в 20:00, по какой-то причине не внес это в мобильное приложение, на следующий день сдал накладную, и в 9 утра оператор внесла, что он доставил вчера в 20:00. Тогда в createtimegmt будет сегодня 6 утра (для Москвы), а в eventtime - вчера в 20:00. При этом оператор по каким-то причинам может внести время вручения раньше, чем какое-то предыдущее событие, т.о. нарушится последовательность времени в eventtime, но при сортировке по createtimegmt все-равно все будет правильно.</spoiler>
:* '''''message''''' - наименование филиала-получателя, при передаче между филиалами
:* '''''title''''' - русское наименование статуса

* '''statushistory''' - история статусов доставки. Содержит список контейнеров '''status'''. Заполняется только для тарифа "Премиум" начиная с версии системы 2008.0.0.670.
* '''customstatecode''' - код внутреннего статуса курьерской службы. Значения уточняйте в курьерской службе. Назначаются курьерской службой в разделе "Справочники" - "Статусы" - "15 Статусы корреспонденции". Справочник не передается через API клиенту по причине возможного наличия в нем внутренних технологических статусов курьерской службы.
* '''clientstatecode''' - код статуса клиента. Используется, если клиент предлагает свои коды статусов доставки/причин недоставки.
* '''deliveredto''' - данные из поля "Инфо. о доставке" (может быть информация о доставке, причина недоставки и т.п.).
* '''delivereddate''' - дата вручения.
* '''deliveredtime''' - время вручения. В случае недоставки может быть пустым.
* '''arrival''' - плановая дата прибытия в формате гггг-мм-дд чч:мм:сс
* '''outstrbarcode''' - код у подрядчика (код заказа во внешней системе). Используется в интеграциях с внешними системами.
* '''partner''' - текущий филиал/подрядчик.
* '''return_message''' - информация о возврате
* '''department''' - Подразделение, в котором оформляется заказ.

Контейнер '''status''' может принимать следующие значения:
: AWAITING_SYNC — Ожидает синхронизации. Данные заказа пока не появились в службе доставки.
: '''NEW''' — Успешно создан, передан в службу доставки.
: NEWPICKUP — Создан забор.
: PICKUP — Забран у отправителя.
: WMSASSEMBLED — Скомплектован на складе фулфилмента.
: WMSDISASSEMBLED — Разукомплектован на склад фулфилмента.
: '''ACCEPTED''' — Получен складом.
: CUSTOMSPROCESS — Производится таможенный контроль.
: CUSTOMSFINISHED — Таможенный контроль произведен.
: CONFIRM — Согласована доставка.
: UNCONFIRM — Не удалось согласовать доставку.
: DEPARTURING — Планируется отправка со склада на другой склад.
: DEPARTURE — Отправлено со склада на другой склад.
: INVENTORY — Инвентаризация. Убедились в наличии отправления на складе.
: PICKUPREADY — Готов к выдаче в ПВЗ.
: '''DELIVERY''' — Выдан курьеру на доставку.
: COURIERDELIVERED — Доставлен (предварительно, ождает подтверждения менеджером, чтобы перейти в статус COMPLETE).
: COURIERPARTIALLY — Частично доставлен (предварительно, ождает подтверждения менеджером, чтобы перейти в статус PARTIALLY).
: COURIERCANCELED — Отказ (предварительно, после этого ожидается COURIERRETURN).
: COURIERRETURN — Возвращено курьером. Курьер не смог доставить до получателя и вернул заказ обратно на склад. Это промежуточный статус, после которого менеджер выясняет, нужно ли повторно доставлять (статусы DATECHANGE/DELIVERY) или это окончательная недоставка (CANCELED).
: DATECHANGE — Перенос даты доставки.

: '''COMPLETE''' — Доставлен.
: '''PARTIALLY''' — Доставлен частично.
: '''CANCELED''' — Не доставлен (Возврат/Отмена). После этого статуса отправление должны вернуть заказчику, будут статусы RETURNING и RETURNED

: RETURNING — Планируется возврат заказчику (после CANCELED).
: RETURNED — Возвращен заказчику.
: LOST — Утрачен/утерян.

'''Примечание.''' В будущем возможно дополнение используемого набора статусов.

<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
'''Обратите внимание!'''

# Контейнер '''statushistory''' и '''deliveryprice''' заполняется для тарифов [[Личный кабинет курьерской службы#Функции личного кабинета|Премиум и Максимум]].
# Система никогда не гарантирует последовательность прохождения заказом набора статусов. Т.е. Вы можете получить статус "COMPLETE", а следующим запросом - "NEW" - такое может произойти, например, если оператор ошибочно отметил заказ выполненным, а затем исправил ошибку.
</div>
<br />

=== Передача только изменившихся статусов ===
В нашем API предусмотрено удобное средство получения статусов всех заказов, без необходимости «бомбить» сервер запросами статусов по каждому заказу. Работает это так: раз, например, в 10 минут, вы посылаете запрос «покажите все изменившиеся статусы». Пример запроса ниже. Система вам отдает ВСЕ заказы, статусы (или некоторые другие поля, см. ниже) которых изменились с момента последнего запроса. Вы разбираете полученный документ, по каждому заказу сохраняете его актуальный статус в своей системе, и если все хорошо, у вас все получилось, ваша система неожиданно не упала от наплыва информации, посылаете нам запрос подтверждения получения статусов (commitlaststatus). Мы у себя отмечаем, что эти статусы вами получены и их не надо передавать повторно. Таким образом, сколько бы заказов у вас ни было, статусы по ним всем почти в реальном времени вы можете получать всего двумя запросами.

Для получения только изменившихся статусов отправьте запрос:
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<statusreq>
<auth extra="8" login="login" pass="pass"></auth>
<changes>ONLY_LAST</changes>
<streamid>1234</streamid>
</statusreq>
</source>

Система выдает все заказы, в которых с момента последнего запроса в этом режиме изменилось хотя бы одно из полей:
orderno
status
delivereddate
deliveredtime
deliveredto
receiver->date
receiver->address
price

После успешной обработки ответа необходимо отметить полученные статусы успешно полученными, отправив запрос:
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<commitlaststatus>
<auth extra="8" login="login" pass="pass"></auth>
<client>CLIENT</client>
<streamid>1234</streamid>
</commitlaststatus>
</source>

'''Описание полей запроса'''

* '''auth''' — авторизация. Обязательный элемент.
* '''streamid''' — идентификатор потока. Если у вас несколько интеграций и каждая нуждается в получении статусов, вы можете передавать данный параметр и тем самым разделять получение и отметку об успешном получении статусов по заказам. Значение должно входить в промежуток от 100 до 10000, включительно. Необязательный элемент.
* '''client''' — признак клиента или агента. Необязательный элемент.
:* CLIENT — признак клиента, значение по умолчанию
:* AGENT — признак агента. В ответ отдается информация по заказам, переданным агенту на доставку

В случае успеха вы получите ответ:
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<commitlaststatus error="0">OK</commitlaststatus>
</source>

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

<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
# При этом способе передачи (<changes>ONLY_LAST</changes>) система просматривает заказы, оформленные за последние 3 месяца. Если заказ сделан ранее, изменение статуса по нему не попадет в результат выполнения запроса.
# Система всегда выдает текущий статус. Вы можете одним запросом получить статус «NEW», а следующим — «COMPLETE». Между запросами отправление могло пройти через несколько промежуточных статусов. Если нужна гарантия получения всех промежуточных статусов, нужно анализировать блок statushistory (может не заполняться вследствие ограничений версии или тарифа конкретной службы доставки).
# Система не гарантирует последовательность прохождения заказом набора статусов. Вы можете получить статус «COMPLETE», а следующим запросом «NEW» — такое может произойти, например, если оператор ошибочно отметил заказ выполненным, а затем исправил ошибку.
</div>
<br>

== Трекинг заказа по номеру ==

Запрос трекинга по номеру предназначен для выдачи минимальной обезличенной информации о конкретном заказе не авторизованному пользователю. Наша система имеет для этого интерфейс по адресу "home.courierexe.ru/{код экстра}/tracking". Вы можете либо сделать ссылку на такую страницу на своем сайте, либо разместить ее iframe'ом у себя, либо сделать свою и пользоваться нашим API. Этот интерфейс создан специально для выдачи информации живому пользователю сайта. Для получения статусов заказов в свою информационную систему нужно использовать запрос "statusreq", желательно с параметром changes=ONLY_LAST!

'''Пример запроса:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<tracking>
<extra>8</extra>
<orderno>1234</orderno>
</tracking>
</source>

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<tracking>
<order orderno="111111">
<barcode>111111</barcode>
<AWB>111111</AWB>
<sender>
<town code="1" country="RU">Москва город</town>
<date>2014-03-22</date>
<time_min>09:00</time_min>
<time_max>14:00</time_max>
</sender>
<receiver>
<town code="1" country="RU">Москва город</town>
<zipcode>125480</zipcode>
<date>2014-03-22</date>
<time_min>09:00</time_min>
<time_max>14:00</time_max>
</receiver>
<price>387.5</price>
<inshprice>387.5</inshprice>
<paytype>CASH</paytype>
<weight>5.1</weight>
<quantity>2</quantity>
<service>2</service>
<type>3</type>
<return>NO</return>
<return_service>2</return_service>
<return_date></return_date>
<return_time></return_time>
<return_message></return_message>
<waittime>12</waittime>
<enclosure>Детские игрушки</enclosure>
<instruction>Проверить при покупателе, подписать акт</instruction>
<deliveryprice total="158.6" delivery="100.00" return="58.6" />
<courier>
<code>26</code>
<name>Иванов Владимир Петрович</name>
<phone>+79161234567</phone>
</courier>
<currcoords lat="55.680327" lon="37.604456" accuracy="50" RequestDateTime="2014-04-21 18:07:45" />
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 17:22:00" createtimegmt="2016-06-03 16:14:44" message="" title="Доставлен">COMPLETE</status>
<statushistory>
<status eventstore="Офис в Москве" eventtime="2016-05-30 10:20:00" createtimegmt="2016-06-03 16:14:44" message="" title="Новый">NEW</status>
<status eventstore="Офис в Москве" eventtime="2016-06-01 17:38:00" createtimegmt="2016-06-03 16:14:44" message="филиал в Санкт-Петербурге" title="Планируется отправка">DEPARTURING</status>
<status eventstore="Офис в Москве" eventtime="2016-06-01 19:53:00" createtimegmt="2016-06-03 16:14:44" message="филиал в Санкт-Петербурге" title="Отправлено со склада">DEPARTURE</status>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 07:41:00" createtimegmt="2016-06-03 16:14:44" message="" title="Получен складом">ACCEPTED</status>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 09:17:00" createtimegmt="2016-06-03 16:14:44" message="" title="Выдан курьеру на доставку">DELIVERY</status>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 17:22:00" createtimegmt="2016-06-03 16:14:44" message="" title="Доставлен (предварительно)">COURIERDELIVERED</status>
<status eventstore="филиал в Санкт-Петербурге" eventtime="2016-06-02 17:22:00" createtimegmt="2016-06-03 16:14:44" message="" title="Доставлен">COMPLETE</status>
</statushistory>
<deliveredto>Иванова, секр.</deliveredto>
<delivereddate>2016-06-02</delivereddate>
<deliveredtime>17:22</deliveredtime>
<outstrbarcode>EXT123456</outstrbarcode>
<items>
<item code="34533" extcode="abc123" quantity="1" mass="0.2" retprice="37.5" VATrate="0" barcode="2345625213125" article="1" returns="0" origincountry="040" GTD="" excise="0.00" governmentCode="11223311" suppcompany="Поставщик" suppINN="1112223334" suppphone="79161234567">Мяч</item>
<item code="34456" extcode="abc124" quantity="2" mass="2" retprice="100" VATrate="10" barcode="4645625213138" article="2" returns="0" governmentCode="">Обруч</item>
<item code="34421" extcode="abc125" quantity="3" mass="0.3" retprice="50" VATrate="18" barcode="2345625213126" article="3" returns="0" governmentCode="">Погремушка желтая</item>
</items>
</order>
</tracking>
</source>

'''Получение информации в формате 17 TRACK'''

'''Пример запроса:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<tracking17>
<extra>8</extra>
<orderno>1234</orderno>
</tracking17>
</source>

'''Пример ответа:'''
<pre>{
"number":"ExtNumber",
"oriNumber":"1234",
"oriCountry":"RU",
"destCountry":"RU",
"status":"Complete",
"events":[
{
"time":"2016-06-02 17:22:00",
"location":"RU",
"content":"Complete"
},
{
"time":"2016-06-02 17:22:00",
"location":"RU",
"content":"Courierdelivered"
},
{
"time":"2016-06-02 09:17:00",
"location":"RU",
"content":"Delivery"
},
{
"time":"2016-06-02 07:41:00",
"location":"RU",
"content":"Accepted"
},
{
"time":"2016-06-01 19:53:00",
"location":"RU",
"content":"Departure"
},
{
"time":"2016-06-01 17:38:00",
"location":"RU",
"content":"Departuring"
},
{
"time":"2016-05-30 10:20:00",
"location":"RU",
"content":"New"
}
]
}</pre>

Функция ищет последний заказ по номеру среди заказов всех клиентов. Выдает неперсонализированную информацию о текущем состоянии заказа.<br />
Описание контейнеров ответа аналогично описанию [[API#.D0.97.D0.B0.D0.BF.D1.80.D0.BE.D1.81_.D1.81.D1.82.D0.B0.D1.82.D1.83.D1.81.D0.B0_.D0.B7.D0.B0.D0.BA.D0.B0.D0.B7.D0.BE.D0.B2|Запроса статусов заказов]].

== Изменение заказа ==
Запрос предназначен для изменения заказов, по которым не было произведено изменений статуса корреспонденции, времени доставки — то есть заказов, которые ещё не в работе.

Изменять заказы могут курьерские службы с тарифами «Премиум» и «Максимум». Чтобы разрешить изменение заказов, в личном кабинете курьерской службы перейдите в '''Параметры''' > '''Расширенные''' и установите флажок '''Разрешить отмену и изменение заказов'''.

<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
'''Обратите внимание!'''
# Данные запроса изменения указываются '''полностью''', как если бы заказ создавался впервые.
# При отсутствии вложения в запросе изменения данное вложение '''не удаляется''' из заказа, но его количество становится равным 0.
# При одновременном изменении заказа в API и системе курьерской службы приоритет отдается данным системы курьерской службы. То есть изменения в API приняты не будут.
</div>

При редактировании заказа может быть отменен запланированный курьер. Это зависит от значения переменной '''Справочники''' > '''Переменные''' > '''Корреспонденция''' > '''Автоматически устанавливать заплан. курьера по району''':
* '''Нет''' — при редактировании заказа по АПИ курьер не изменяется;
* '''Район''' — если изменен адрес доставки, курьер сбрасывается;
* '''Район или дата план. доставки''' — если изменен адрес доставки или плановая дата вручения, курьер сбрасывается.

=== Описание полей запроса изменения ===
Все поля запроса соответствуют структуре order при создании заказа за исключением:
* вместо корневого тэга '''neworder''' указывается '''editorder''';
* тэг штрихкода '''barcode''' не указывается, поскольку присваивается при создании заказа;
* тэг курьера '''courier''' можно изменить только при включенной настройке '''Разрешить изменение курьера по АПИ''';
* для вложений '''item''' указывается внутренний код вложения в атрибуте '''code''', который можно получить при получении статуса заказа.

Значение '''orderno''' данным методом изменить нельзя.

=== Описание полей ответа изменения ===
Все поля ответа соответствуют ответу при создании заказа за исключением корневого тэга — вместо '''neworder''' возвращается '''editorder'''.

== Отмена заказа ==
Запрос предназначен для отмены заказов, по которым не было произведено изменений статуса доставки, статуса корреспонденции, времени доставки, то есть заказов, которые ещё не в работе.

Отменять заказы могут курьерские службы с тарифами «Премиум» и «Максимум». Чтобы разрешить отмену заказов, в личном кабинете курьерской службы перейдите в '''Параметры''' > '''Расширенные''' и установите флажок '''Разрешить отмену и изменение заказов'''.

При отмене заказа поле «Инфо о доставке» получает значение «Отменено заказчиком», поле «Дата доставки» — текущую дату, а «Вручил курьер» — системную запись «ОТМЕНА».

'''Пример запроса отмены заказа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<cancelorder>
<auth extra="8" login="login" pass="pass" />
<order orderno="" ordercode="123456" />
<order orderno="123aaa" ordercode="" />
</cancelorder>
</source>

'''Описание полей:'''

'''cancelorder''' — Корневой контейнер. Обязательный элемент.
* '''auth''' — Авторизация. Обязательный элемент.
* '''order''' — Контейнер отменяемого заказа. Обязательный элемент. Запрос может содержать более одного контейнера '''order'''. Атрибуты:
:* '''''orderno''''' — Шифр заказа.
:* '''''ordercode''''' — Внутренний код заказа.
Обратите внимание, что должен быть указан хотя бы один из атрибутов ''orderno'' или ''ordercode''!

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<cancelorder>
<order orderno="123test" ordercode="123456" error="0" errormsg="OK" errormsgru="Успешно" />
<order orderno="123aaa" ordercode="" error="52" errormsg="order not found" errormsgru="Заказ не найден" />
</cancelorder>
</source>

== Добавление вложений к накладной ==

'''Пример запроса:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<addattachments>
<auth extra="8" login="login" pass="pass" />
<orderno>1234567</orderno>
<attachments>
<item name="photo1.jpg">JVBERi0xLjMN1wb25lbnQgMQ
JUBQREYwMTIzNDU2Nzg5IDI NMyAwIG9iag08PA0vVHlwZSA
U3VidHlwZSAvSW1hZ2UNL1d pZHRoIDE4MDgNL0hlaWdodCA
ggNCAwIFINL0JpdHNQZXJDb 21wb25lbnQgMQ0vRGVjb2RlU
ENL0NvbHVtbnMgMTgwOA0+P g0vSW1hZ2VNYXNrIHRydWUNL
XhEZWNvZGUNPj4Nc3RyZWFt DQ</item>
<item name="photo2.jpg">VBERi0xLjMNAwIG9iag0HRoJ
JUBQREYwMTIzNDU2Nzg5IDI NMyAwIG9iag08PA0vVHlwZSA
vWE9iamVjdA0vU3VidHlwZS AvSW1hZ2UNL1dpZHRoIDEzNj
gNL0hlaWdodCAxMzMzDS9MZ W5ndGggNCAwIFINL0JpdHNQZ
XJDb21wb25lbnQgMQ0vRGVj b2RlUGFybXMgPDwNL0sgLTEN
L0NvbHVtbnMgMTM2OA0+Pg0 vSW</item>
</attachments>
</addattachments>
</source>

'''Описание полей:'''

'''addattachments''' - Корневой контейнер. Обязательный элемент.
*'''auth''' - Авторизация. Обязательный элемент.
*'''orderno''' - Номер заказа. Обязательный элемент. Может использоваться тэг <ordercode> с указанием внутреннего кода заказа.
*'''attachments''' - Обязательный элемент, в котором перечисляются передаваемые данные файлов.
**'''item''' - Бинарные данные (файл), закодированные в base64. Обязательный элемент.
***'''name''' - Атрибут элемента '''item''', в котором передается имя файла. Обязательный элемент.

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<addattachments>
<attachments>
<item name="photo1.jpg" error="0" errormsg="OK" errormsgru="Успешно" />
<item name="photo2.jpg" error="0" errormsg="OK" errormsgru="Успешно" />
</attachments>
</addattachments>
</source>

== Получение вложений к накладной ==

'''Пример запроса:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<attachments>
<auth extra="8" login="login" pass="pass" />
<orderno>1234567</orderno>
</attachments>
</source>

'''Описание полей:'''

'''attachments''' - Корневой контейнер. Обязательный элемент.
*'''auth''' - Авторизация. Обязательный элемент.
*'''orderno''' - Номер/код заказа. Обязательный элемент.

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<attachments>
<item name="doc1.docx" size="35654">JVBERi0xLjMN
JUBQREYwMTIzNDU2Nzg5IDI NMyAwIG9iag08PA0vVHlwZSA
U3VidHlwZSAvSW1hZ2UNL1d pZHRoIDE4MDgNL0hlaWdodCA
ggNCAwIFINL0JpdHNQZXJDb 21wb25lbnQgMQ0vRGVjb2RlU
ENL0NvbHVtbnMgMTgwOA0+P g0vSW1hZ2VNYXNrIHRydWUNL
XhEZWNvZGUNPj4Nc3RyZWFt DQ</item>
<item name="photo2.jpg" size="74861">VBERi0xLjMN
JUBQREYwMTIzNDU2Nzg5IDI NMyAwIG9iag08PA0vVHlwZSA
vWE9iamVjdA0vU3VidHlwZS AvSW1hZ2UNL1dpZHRoIDEzNj
gNL0hlaWdodCAxMzMzDS9MZ W5ndGggNCAwIFINL0JpdHNQZ
XJDb21wb25lbnQgMQ0vRGVj b2RlUGFybXMgPDwNL0sgLTEN
L0NvbHVtbnMgMTM2OA0+Pg0 vSW</item>
</attachments>
</source>

В тегах item возвращаются бинарные данные (файлы), закодированные в base64.

== Изменение статуса агентом ==

Запрос изменения статуса заказа позволяет установить окончательный статус заказа - "Доставлен" или "Не доставлен (Возврат/Отмена)".

Кроме этого, устанавливается дата и время (при необходимости) изменения статуса, а также сообщение в поле ''Инфо о доставке''.

При необходимости к заказу можно прикрепить изображения.

'''Пример запроса изменения статуса:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<setorderinfo>
<auth extra="8" login="login" pass="pass" />
<order ordercode="123456">
<message>Получил Иванов</message>
<outstrbarcode>7654312</outstrbarcode>
</order>
<order ordercode="234567">
<status>PICKUPREADY</status>
<eventtime>2016-05-30 10:20:00</eventtime>
<message>Клиент отказался от покупки</message>
<paytype>CASH</paytype>
<items>
<item code="34533" quantity="1" reason="0" />
<item code="34456" quantity="0" reason="0" />
<item code="34421" quantity="2" reason="0" />
</items>
<image filename="filename1.jpg"> /9j/4AAQSkZJRgA
BAQAAAQABAAD/2wBDAA0JCg sKCA0LCgsODg0PEyAVExISEy
ccHhcgLikxMC4pLSwzOko+M zZGNywtQFdBRkxOUlNSMj5aY
VpQYEpRUk//2wBDAQ4ODhMR EyYVFSZPNS01T09PT09PT09P
T09PT09PT09PT09PT09PT09 PT09PT09PT09PT09PT09PT09
PT09PT0//wAARCAYACAADAS IA</image>
</order>
</setorderinfo>
</source>

'''Описание полей запроса статуса:'''

'''setorderinfo''' - Корневой контейнер. Обязательный элемент.
*'''auth''' - Авторизация. Обязательный элемент.
*'''order''' - Контейнер заказа. Обязательный элемент. Запрос может содержать более одного контейнера '''order'''. Атрибут '''''ordercode''''' - внутренний код заказа.
*'''status''' - Новый статус заказа. Доступны статусы из раздела [[#Описание полей ответа статусов]], кроме AWAITING_SYNC и NEW.
*'''eventtime''' - Дата и время изменения статуса. Обязательно при указании статуса.
*'''message''' - Текст сообщения ''Инфо о доставке''.
*'''outstrbarcode''' - код у подрядчика (код заказа во внешней системе). Используется в интеграциях с внешними системами.
*'''paytype''' - Тип оплаты заказа. Допустимые значения CASH/CARD.
*'''items''' - Контейнер для описания вложений '''item''' . Атрибуты:
:* '''''code''''' - Код вложения.
:* '''''quantity''''' - Количество доставленных единиц вложения.
:* '''''reason''''' - Причина недоставки, выбирается из соответствующего списка статусов.
*'''image''' - Контейнер прикрепляемого изображения. Содержит текст файла изображения, закодированный по стандарту ''base64''. Контейнер '''order''' может содержать более одного контейнера '''image'''. Атрибут:
:* '''''filename''''' - Имя файла.

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<setorderinfo>
<order ordercode="123456" error="0" errormsg="OK" errormsgru="Успешно" />
<order ordercode="234567" error="59" errormsg="value [date_put] is already set" errormsgru="Значение [Дата доставки] уже указано" />
</setorderinfo>
</source>

== Получение документов для печати ==

'''Пример запроса получения печатных форм:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<waybill>
<auth extra="8" login="login" pass="pass" />
<orders>
<order orderno="1234567" ordercode="33331" />
<order orderno="1234568" ordercode="33332" />
</orders>
<form>1</form>
</waybill>
</source>

'''Описание полей:'''

'''waybill''' - Корневой контейнер. Обязательный элемент
*'''auth''' - Авторизация. Обязательный элемент
*'''orders''' - Список заказов для получения печатных форм. Содержит тэги '''order''' с атрибутами:
:* '''''orderno''''' - шифр заказа
:* '''''ordercode''''' - внутренний код заказа. Указывать необходимо один из атрибутов для всех заказов. Приоритет имеет атрибут '''''ordercode'''''
*'''form''' - Формат накладной. Не обязательный элемент. Принимает значения:
:* 1 - Подробная накладная (по-умолчанию)
:* 2 - Наклейки Zebra
:* 3 - Наклейки на страницу формата А4
:* 4 - Акты приема-передачи

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<waybill>
<content>EODIcaI8KSBlwQ 4MnEOR7Px8U8EBAyGICBnwpw
IZhQgz0ZxuPs8EBM/GcbjzB AwhBl8hwQYIO00GmEwg1CeEG
mqYTChNU0wqf8l8nz4zgc+K fCno+zwU5GjOZmzXGcbEQYIM
4zkegRE40zWzONyoNNMIOIa cWnp6aDCGEGE9NQmoQd2mg00
79U4f3hPTwnfp6Sdrafeqpa JDpFw/1aYT077VNNNdO00G3q
mqqvp9p2E7T0/wiFemv8uG6 OM</content>
</waybill>
</source>

В тэге content возвращаются бинарные данные (файл pdf), закодированные в base64.

'''Обратите внимание''', что печатные формы для заборов не формируются.

== Справочник городов ==

'''Пример запроса справочника городов:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<townlist>
<auth extra="8" />
<codesearch>
<zipcode>110000</zipcode>
<kladrcode>0100000100800</kladrcode>
<fiascode>bd21979d-46f8-49d0-9105-e8d65172a983</fiascode>
<code>123</code>
</codesearch>
<conditions>
<city>Краснодарский край</city>
<namecontains>новгород</namecontains>
<namestarts>Моск</namestarts>
<name>Москва</name>
<fullname>Москва город</fullname>
<country>1</country>
</conditions>
<limit>
<limitfrom>30</limitfrom>
<limitcount>10</limitcount>
<countall>YES</countall>
</limit>
</townlist>
</source>

Внутри контейнера townlist все элементы могут как отсутствовать, так и комбинироваться. Поиск не чувствителен к регистру.

*'''auth''' - Авторизация, необязательный элемент. Используется в случае включенного и настроенного ограничения по населенным пунктам в конкретной курьерской службе.

*'''codesearch''' - Поиск по кодам. В случае использования - контейнеры conditions и limit игнорируются.
:* '''zipcode''' - Поиск по индексу. Обратите внимание на то, что один почтовый индекс может распространяться на несколько населенных пунктов. В этом случае система вернет несколько записей.
:* '''kladrcode''' - Поиск по 13-ти значному коду КЛАДР.
:* '''fiascode''' - Поиск по коду ФИАС (AOGUID).
:* '''code''' - Поиск по коду в системе.

*'''conditions''' - Задает условия поиска. Все вложенные элементы одновременно накладывают условие "И".
:* '''city''' - Поиск по всем населенным пунктам региона.
:* '''namecontains''' - Поиск населенных пунктов, название которых содержит указанный текст.
:* '''namestarts''' - Поиск населенных пунктов, название которых начинается с указанного текста.
:* '''name''' - Поиск населенных пунктов, название которых соответствует указанному тексту.
:* '''fullname''' - Поиск населенных пунктов, название вместе с типом населенного пункта которых соответствует указанному тексту.
:* '''country''' - Поиск только по стране с указанным внутренним кодом или текстовым кодом в соответствии [https://ru.wikipedia.org/wiki/ISO_3166-1 стандартом ISO_3166-1], например, "RU", "RUS" для России.

*'''limit''' - Ограничивает вывод результата.
:* '''limitfrom''' - Задает номер записи результата, начиная с которой выдавать ответ. По-умолчанию - 0.
:* '''limitcount'''- Задает количество записей результата, которые нужно вернуть. По-умолчанию - 10000.
:* '''countall''' - YES указывает на необходимость подсчета общего количества найденных совпадений. Это может замедлять выполнение запроса. Если отключено - в ответе не указываются totalcount и totalpages.

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<townlist count="3" page="1" totalcount="3" totalpages="1">
<town>
<code>26379</code>
<city>
<code>23</code>
<name>Краснодарский край</name>
</city>
<name>Сочи город</name>
<fiascode>79da737a-603b-4c19-9b54-9114c96fb912</fiascode>
<kladrcode>2300000700000</kladrcode>
<shortname /> (not yet supported)
<typename /> (not yet supported)
<coords lat="43.5855" lon="39.7231" />
</town>
<town>
<code>40331</code>
<city>
<code>32</code>
<name>Брянская область</name>
</city>
<name>Сочилов хутор</name>
<fiascode>c9c96c67-2cc9-4f10-afde-fd32417ea216</fiascode>
<kladrcode>3201900011100</kladrcode>
<shortname />
<typename />
<coords lat="52.6407" lon="33.1724" />
</town>
<town>
<code>114016</code>
<city>
<code>60</code>
<name>Псковская область</name>
</city>
<name>Сочихино деревня</name>
<fiascode>10df7588-19c1-49d1-a387-9de1cf3eb26f</fiascode>
<kladrcode>6001900015400</kladrcode>
<shortname />
<typename />
<coords lat="56.6003" lon="29.3542" />
</town>
</townlist>
</source>

В ответе города сортируются по популярности, важности (районные центры и т.д.), и только затем - по алфавиту.

== Справочник регионов ==

'''Пример запроса справочника:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<regionlist>
<codesearch>
<code>77</code>
</codesearch>
<conditions>
<namecontains>край</namecontains>
<namestarts>Моск</namestarts>
<fullname>Московская область</fullname>
<country>RU</country>
</conditions>
</regionlist>
</source>

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<regionlist count="2">
<city>
<code>80</code>
<country>
<code>1</code>
<name>Россия</name>
<id>643</id>
<ShortName1>RU</ShortName1>
<ShortName2>RUS</ShortName2>
</country>
<name>Агинский Бурятский автономный округ</name>
</city>
<city>
<code>1</code>
<country>
<code>1</code>
<name>Россия</name>
<id>643</id>
<ShortName1>RU</ShortName1>
<ShortName2>RUS</ShortName2>
</country>
<name>Адыгея республика</name>
</city>
</regionlist>
</source>

== Справочник улиц ==

'''Пример запроса справочника улиц:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<streetlist>
<conditions>
<town>Москва город</town> // ОБЯЗАТЕЛЬНОЕ ПОЛЕ!
<namecontains>Хохло</namecontains>
<namestarts>Академика Х</namestarts>
<name>Академика Хохлова</name>
<fullname>Академика Хохлова ул.</fullname>
</conditions>
<limit>
<limitfrom>30</limitfrom>
<limitcount>10</limitcount>
<countall>YES</countall>
</limit>
</streetlist>
</source>

*'''conditions''' - Задает условия поиска. Все вложенные элементы одновременно накладывают условие "И".
:* '''town''' - Обязательное поле. Название или код населенного пункта.
:* '''namecontains''' - Поиск улиц, название которых содержит указанный текст.
:* '''namestarts''' - Поиск улиц, название которых начинается с указанного текста.
:* '''name''' - Поиск улиц, название которых соответствует указанному тексту.
:* '''fullname''' - Поиск улиц, для которых название вместе с типом соответствует указанному тексту.

*'''limit''' - Ограничивает вывод результата.
:* '''limitfrom''' - Задает номер записи результата, начиная с которой выдавать ответ. По-умолчанию - 0.
:* '''limitcount'''- Задает количество записей результата, которые нужно вернуть. По-умолчанию - 10000.
:* '''countall''' - YES указывает на необходимость подсчета общего количества найденных совпадений. Это может замедлять выполнение запроса. Если отключено, в ответе не указываются totalcount и totalpages.

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<streetlist count="1" page="1" totalcount="3" totalpages="1">
<street>
<code>124</code>
<name>Академика Хохлова ул.</name>
<shortname>Академика Хохлова</shortname>
<typename>ул.</typename>
</street>
</streetlist>
</source>

В ответе улицы сортируются по алфавиту.

== Справочник номенклатуры ==

'''Пример запроса справочника номенклатуры:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<itemlist>
<auth extra="8" login="login" pass="pass"></auth>
<codesearch>
<code>123456</code>
<article>FD343</article>
<barcode>2345625213125</barcode>
</codesearch>
<conditions>
<namecontains>телевизор</namecontains>
<namestarts>sony</namestarts>
<name>Sony KDL-55W905 ЖК-телевизор</name>
<quantity>EXISTING_ONLY</quantity>
<store>2</store>
</conditions>
<except>
<code>123478</code>
</except>
<limit>
<limitfrom>30</limitfrom>
<limitcount>10</limitcount>
<countall>YES</countall>
</limit>
</itemlist>
</source>

Внутри контейнера itemlist все элементы могут как отсутствовать, так и комбинироваться. Поиск не чувствителен к регистру.
*'''codesearch''' - Поиск по кодам. В случае использования - контейнеры conditions и limit игнорируются.
:* '''code''' - Поиск по внутреннему коду системы.
:* '''article''' - Поиск по артикулу.
:* '''barcode''' - Поиск по штрих-коду.

*'''conditions''' - Задает условия поиска. Все вложенные элементы одновременно накладывают условие "И".
:* '''namecontains''' - Поиск товаров, название которых содержит указанный текст.
:* '''namestarts''' - Поиск товаров, название которых начинается с указанного текста.
:* '''name''' - Поиск товаров, название которых соответствует указанному тексту.
:* '''quantity''' - Наличие на складе. Принимает значения EXISTING_ONLY - Только в наличии, NOT_EXISTING_ONLY - Только не в наличии, ALL - Все. ''Это поле может быть недоступным в некоторых установках.''
:* '''store''' - Поиск товаров по определенному складу.

*'''except''' - Описание исключений для корректного определения количества зарезервированной номенклатуры.
:* '''code''' - Код заказа.

*'''limit''' - Ограничивает вывод результата.
:* '''limitfrom''' - Задает номер записи результата, начиная с которой выдавать ответ.
:* '''limitcount''' - Задает количество записей результата, которые нужно вернуть.

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<itemlist count="3" totalcount="3" page="1" totalpages="1">
<item>
<code>123456</code>
<article>FD343</article>
<barcode>2345625213125</barcode>
<name>Sony KDL-55W905 ЖК-телевизор</name>
<retprice>65000</retprice>
<purchprice>50000</purchprice>
<weight>5.1</weight>
<length>50</length>
<width>30</width>
<height>40</height>
<VATrate>20</VATrate>
<CountInPallet>30</CountInPallet>
<CountInBox>2</CountInBox>
<HasSerials>1</HasSerials>
<CountryOfOrigin>Малайзия</CountryOfOrigin> (not yet supported)
<Message>Хороший телевизор</Message>
<Message2>Снова хороший телевизор</Message2>
<quantity>12</quantity>
<reserved>3</reserved>
<item>
...
</itemlist>
</source>

'''Описание полей:'''
*'''code''' - Внутренний идентификатор, присвоенный системой.
*'''article''' - Артикул, назначенный клиентом (поставщиком).
*'''barcode''' - Штрих-код производителя.
*'''name''' - Наименование.
*'''retprice''' - Розничная цена по-умолчанию. При оформлении заказа цена используется та, которая указана в заказе.
*'''purchprice''' - Закупочная цена.
*'''weight''' - Масса в килограммах.
*'''length''' - Длина в сантиметрах.
*'''width''' - Ширина в сантиметрах.
*'''height''' - Высота в сантиметрах.
*'''VATrate''' - Ставка НДС, целое число процентов.
*'''CountInPallet''' - Количество штук в паллете.
*'''CountInBox''' - Количество штук в упаковке.
*'''HasSerials''' - Требует учета серийных номеров. Принимает значения 1 - да, 0 - нет.
*'''CountryOfOrigin''' - Наименование страны происхождения на русском языке.
*'''Message''' - Комментарий.
*'''Message2''' - Дополнительный комментарий.
*'''quantity''' - Количество на складе. Товары, уже собранные в заказы в этом количестве не присутствуют, считаются покинувшими товарный склад. ''Это поле может быть недоступным в некоторых установках.''
*'''reserved''' - Количество зарезервированного товара. Может превышать остаток на складе, если покупатели ждут следующей поставки. ''Это поле может быть недоступным в некоторых установках.''

== Движение номенклатуры ==

'''Пример запроса движения номенклатуры:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<itemmovements>
<auth extra="8" login="login" pass="pass"></auth>
<code>4259</code>
<datefrom>2020-10-01</datefrom>
<dateto>2020-10-02</dateto>
</itemmovements>
</source>

*'''code''' - внутренний код товара в справочнике номенклатуры.
*'''datefrom''' - дата начала периода.
*'''dateto''' - дата окончания периода.
Может быть указан или код, или период, или код и период одновременно.

'''Пример ответа движения номенклатуры:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<itemmovements count="16">
<itemmovement>
<code>151500</code>
<date>2017-05-26</date>
<retprice>0</retprice>
<quantity>1</quantity>
<delivered>0</delivered>
<item>
<code>4259</code>
<name>Настольная игра Дженга</name>
</item>
<status>
<code>5</code>
<name>Возврат от покупателя</name>
</status>
<store>
<code>1</code>
<name>офис в Москве</name>
</store>
<order>
<ordercode>3374830</ordercode>
<number>123660-0</number>
<date>2017-05-24</date>
<orderno>14123</orderno>
<barcode>0000000670</barcode>
<company>ТОВАР</company>
<address>Кравченко ул., 1</address>
<delivereddate>2017-05-29</delivereddate>
<deliveredtime>12:00:00</deliveredtime>
<deliveredto />
</order>
<document>
<code>21991</code>
<number>318</number>
<date>2017-05-26</date>
<message></message>
</document>
</itemmovements>
</itemlist>
</source>

''' Описание полей ответа '''
*'''code''' - внутренний код операции движения
*'''date''' - дата операции
*'''retprice''' - цена товара
*'''quantity''' - количество товара операции
*'''delivered''' - количество доставленного товара

*'''item''' - контейнер товара
:* '''code''' - внутренний код товара
:* '''name''' - наименование товара

*'''status''' - контейнер статуса операции
:* '''code''' - код статуса
:* '''name''' - наименование

*'''store''' - контейнер филиала, к которому относится операция
:* '''code''' - код филиала
:* '''name''' - наименование филиала

*'''order''' - контейнер корреспонденции
:* '''ordercode''' - внутренний код заказа
:* '''number''' - номер заказа
:* '''date''' - дата заказа
:* '''orderno''' - шифр
:* '''barcode''' - штрих-код
:* '''company''' - компания
:* '''address''' - адрес
:* '''delivereddate''' - дата вручения
:* '''deliveredtime''' - время вручения
:* '''deliveredto''' - данные о вручении, либо причина недоставки

*'''document''' - контейнер документа операции
:* '''code''' - внутренний код документа
:* '''number''' - номер документа
:* '''extnumber''' - внешний номер документа
:* '''date''' - дата документа
:* '''message''' - комментарий

== Получение справочника тарифов по городам ==
<br />
<div style="color: #a94442; background-color: #f2dede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
'''Обратите внимание!'''
Если в запросе отсутствует параметр nofederal, то Москва будет обрабатываться иначе, чем остальные города. В ответе будут города Москвы и МО, с добавленной ценой за километраж
</div>
<br />

'''Пример запроса справочника тарифов по городам'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<tariffs>
<auth extra="8" login="login" pass="pass" />
<townfrom>Москва</townfrom>
<service>1</service>
<mainonly>1</mainonly>
<nofederal>1</nofederal>
</tariffs>
</source>

*'''auth''' — атрибут '''extra''' обязателен, по нему определяется курьерская служба.
*'''townfrom''' — город-отправитель. Если не передан, то городом будет «Москва».
*'''service''' — режим доставки. Обязательный элемент.
*'''mainonly''' — необязательный элемент. Если передан, то в ответе будут данные только по городам из справочника '''Межгород''' > '''Зоны'''.
*'''nofederal''' — необязательный элемент. Если передан, то в ответе город федерального значения Москва будет обрабатываться как обычный город.

'''Пример ответа справочника тарифов по городам'''
<source lang="json">
{
"townfrom": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
"service": 1,
"tariffs": [
{
"towntofias": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
"towntocode": 1,
"towntoname": "Москва город",
"distance": 0,
"pricedistance": 0,
"pricesnew": {
"before": [
{
"price": 100,
"every": 0,
"mass": 1
},
{
"price": 150,
"every": 0,
"mass": 5
}
],
"after": [
{
"price": 0,
"every": 1,
"mass": 38.01
},
{
"price": 15,
"every": 1,
"mass": 51.01
}
]
},
"deliveryPeriodMin": 1,
"deliveryPeriodMax": 2
}
]
}
</source>

''' Описание полей ответа '''
* '''townfrom''' — код ФИАС города-отправителя.
* '''service''' — режим доставки.
*'''tariffs''' — cписок тарифов по городу.
:* '''towntofias''' — код ФИАС города-получателя.
:* '''towntocode''' — внутренний код города-получателя.
:* '''towntoname''' — наименование города-получателя.
:* '''distance''' — дистанция в км до города от МКАД, если в запросе townfrom - Москва.
:* '''pricedistance''' — сумма за километраж до города от МКАД, если в запросе townfrom - Москва.
:* '''pricesnew''' — ваши настройки тарифов из справочника '''Межгород''' > '''Тарифы по зонам'''.
::* '''before/after''' — контейнеры ДО/ОТ.
:::* '''price''' — цена. Если ответ идет по "before", то в цену также плюсуется сумма pricedistance
:::* '''every''' — за каждые.
:::* '''mass''' — масса.
:* '''prices''' — устаревший элемент, не используется.
:* '''deliveryPeriodMin''' — минимальный срок доставки.
:* '''deliveryPeriodMax''' — максимальный срок доставки.

== Номенклатура приходной накладной ==

'''Пример запроса номенклатуры приходной накладной:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<itemdoc>
<auth extra="8" login="login" pass="pass"></auth>
<code>21991</code>
</itemdoc>
</source>

*'''code''' - внутренний код документа приходной накладной (см. предыдущий запрос).

'''Пример ответа движения номенклатуры:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<itemdoc>
<code>21991</code>
<number>318</number>
<date>2017-05-26</date>
<message></message>
<items>
<item code="4259" quantity="1" barcode="200300" article="123555">Настольная игра Дженга</item>
</items>
</itemdoc>
</source>

''' Описание полей ответа '''
* '''code''' - внутренний код приходной накладной
* '''number''' - номер документа
* '''date''' - дата документа
* '''message''' - комментарий

*'''item''' - контейнер товара
:* '''code''' - внутренний код товара
:* '''barcode''' - штрих-код товара
:* '''article''' - артикул товара
:* '''quantity''' - количество поступившего товара

== Справочник филиалов ==

'''Пример запроса списка филиалов:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<storelist>
<auth extra="8"></auth>
<json>YES</json>
<client_code>7890</client_code>
</storelist>
</source>

*'''auth''' - Атрибут '''extra''' - обязателен, по нему определяется курьерская служба
*'''json''' - Признак вывода ответа в виде JSON YES/NO
*'''client_code''' - Код клиента курьерской службы

'''Пример ответа:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<storelist count="2">
<store>
<code>123</code>
<name>ABC</name>
</store>
<store>
<code>456</code>
<name>Филиал 2</name>
</store>
</storelist>
</source>

*'''code''' - Код филиала.
*'''name''' - Наименование филиала.

== Справочник пунктов самовывоза ==

Для отображения списка пунктов выдачи (ПВЗ) есть '''готовый JavaScript модуль''': https://home.courierexe.ru/js/measoft_map.js Инструкция по использованию - внутри. Посмотреть пример работы можно [https://home.courierexe.ru/pvz_test.html Здесь]

Уникальные запросы списка ПВЗ кешируются на стороне личного кабинета и хранятся до 7 часов утра по московскому времени следующего дня. Например, если уникальный запрос с массой 2 кг был отправлен сегодня в 10 часов, то завтра в 7 утра он сбросится. Если сегодня в 18 часов в этом же запросе вы укажете массу 2 кг, в ответе вернется тот же список ПВЗ. Если передадите массу 3 кг, список может быть другим.

'''Пример запроса пунктов самовывоза:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<pvzlist>
<auth extra="8" login="login" pass="pass"></auth>
<code>1234</code>
<client_code>7890</client_code>
<city>Свердловская область</city>
<town regioncode="66" country="RU">Нижний Тагил</town>
<parentcode>6</parentcode>
<acceptcash>YES</acceptcash>
<acceptcard>YES</acceptcard>
<acceptfitting>YES</acceptfitting>
<maxweight>30</maxweight>
<acceptindividuals>YES</acceptindividuals>
<lt>57.924737</lt>
<lg>59.940019</lg>
<rt>57.905682</rt>
<rg>59.984669</rg>
<json>YES</json>
<limit>
<limitfrom>30</limitfrom>
<limitcount>2</limitcount>
<countall>YES</countall>
</limit>
</pvzlist>
</source>

*'''auth''' - Атрибут '''extra''' - обязателен, по нему определяется курьерская служба, '''login''' и '''pass''' позволяют авторизоваться под клиентом: для отдельного клиента могут быть ограничения по доступности некоторых ПВЗ, и в этом случае они будут учтены.
*'''code''' - Внутренний код.
*'''client_code''' - Код клиента курьерской службы.
*'''city''' - Регион получателя. Можно указать код региона или полное наименование региона из [[#Справочник регионов|справочника регионов]].
*'''town''' - Город получателя.
Для тега города '''town''' можно указать код региона в атрибуте '''''regioncode''''' из [[#Справочник регионов|справочника регионов]]. Поиск будет производиться в указанном регионе.

Также можно указать страну получателя в атрибуте '''''country''''' в соответствии с [https://ru.wikipedia.org/wiki/ISO_3166-1 стандартом ISO_3166-1], например, "RU", "RUS" или "643" для России.

*'''parentcode''' - Фильтр по родительскому [[#Справочник филиалов|филиалу]]
*'''acceptcash''' - Фильтр по приему наличных YES/NO
*'''acceptcard''' - Фильтр по приему банковских карт YES/NO
*'''acceptfitting''' - Фильтр по наличию примерки YES/NO
*'''maxweight''' - Фильтр по максимальному весу, с которым работает ПВЗ
*'''acceptindividuals''' - Фильтр по доступности физическим лицам YES/NO
*'''lt''' - Широта левого верхнего угла
*'''lg''' - Долгота левого верхнего угла
*'''rt''' - Широта правого нижнего угла
*'''rg''' - Долгота правого нижнего угла
*'''json''' - Признак вывода ответа в виде JSON YES/NO
*'''limit''' - Ограничивает вывод результата.
:* '''limitfrom''' - Задает номер записи результата, начиная с которой выдавать ответ. По-умолчанию - 0.
:* '''limitcount'''- Задает количество записей результата, которые нужно вернуть. По-умолчанию - 100.
:* '''countall''' - YES указывает на необходимость подсчета общего количества найденных совпадений. Это может замедлять выполнение запроса. Если отключено - в ответе не указываeтся totalcount.

'''Пример ответа справочника пунктов самовывоза:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<pvzlist count="2" totalcount="40465">
<pvz>
<code>126</code>
<clientcode>3</clientcode>
<name>Нижний Тагил</name>
<parentcode>6</parentcode>
<parentname>Интеграция</parentname>
<town code="124267" regioncode="66" regionname="Свердловская область">Нижний Тагил город</town>
<address>622036, г. Нижний Тагил, ул. Циолковского, д. 17</address>
<phone>+73435417709, +73435254989</phone>
<comment>Новый пункт доставки</comment>
<worktime>Вс 10:00-16:00, Сб 10:00-16:00, Пн-Пт 10:00-20:00</worktime>
<traveldescription>Жилое 5-ти этажное здание, торцом к дороге, второе здание от перекрестка Пархоменко-Циолковского</traveldescription>
<maxweight>10</maxweight>
<acceptcash>YES</acceptcash>
<acceptcard>YES</acceptcard>
<acceptfitting>YES</acceptfitting>
<acceptindividuals>YES</acceptindividuals>
<latitude>57.93457</latitude>
<longitude>59.95131</longitude>
<uid>40606d00-9c51-11eb-b2c9-cfd6c1111392</uid>
</pvz>
<pvz>
<code>245</code>
<clientcode>NTG1</clientcode>
<name>На Красноармейской</name>
<parentcode>6</parentcode>
<parentname>Интеграция</parentname>
<town code="124267" regioncode="66" regionname="Свердловская область">Нижний Тагил город</town>
<address>КРАСНОАРМЕЙСКАЯ, д.79</address>
<phone>+7(3435)379-044</phone>
<comment>Возможность примерки отсутствует</comment>
<worktime>Вс 10:00-16:00, Сб 10:00-16:00, Пн-Пт 10:00-20:00</worktime>
<traveldescription>Напротив ТЦ Пирамида</traveldescription>
<maxweight>20</maxweight>
<acceptcash>YES</acceptcash>
<acceptcard>YES</acceptcard>
<acceptfitting>NO</acceptfitting>
<acceptindividuals>YES</acceptindividuals>
<latitude>57.93468</latitude>
<longitude>60.55476</longitude>
<uid>41116853-9c51-11eb-b2c9-cfd6c1451392</uid>
</pvz>
</pvzlist>
</source>

*'''code''' - Код ПВЗ в системе. Используется в запросе [[API#Оформление заказа|оформления заказов]]
*'''clientcode''' - Код ПВЗ используемый компанией-подрядчиком.
*'''name''' - Наименование ПВЗ.
*'''parentcode''' - Код родительского элемента.
*'''parentname''' - Наименование родительского элемента.
*'''town''' - Населенный пункт с кодом из [[#Справочник городов|справочника городов]], а также с кодом и наименованием региона.
*'''address''' - Адрес ПВЗ.
*'''phone''' - Телефоны ПВЗ.
*'''comment''' - Дополнительная информация.
*'''worktime''' - Режим работы ПВЗ.
*'''traveldescription''' - Описание местонахождения ПВЗ или пути к нему.
*'''maxweight''' - Максимальный вес, с которым работает ПВЗ.
*'''acceptcash''' - Признак приема наличных
*'''acceptcard''' - Признак приема банковских карт
*'''acceptfitting''' - Наличие примерки
*'''latitude''' - Широта
*'''longitude''' - Долгота
*'''uid''' - Уникальный идентификатор ПВЗ в системе Measoft
*'''count''' - Количество записей в ответе
*'''totalcount''' - Общее количество записей, отвечающее параметрам запроса

== Получение фискальных данных заказа ==

'''Пример запроса получения фискальных данных:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<receiptdata>
<auth extra="8" login="login" pass="pass" />
<orders>
<order orderno="123456" />
<order orderno="890111C" />
</orders>
</receiptdata>

</source>

'''Пример ответа получения фискальных данных:'''
<source lang="xml">

<?xml version="1.0" encoding="UTF-8"?>
<receipts count="1">
<receipt>
<orderno>123456</orderno>
<fdDatetime>2020-06-07 12:14:00</fdDatetime>
<fdValue>123</fdValue>
<fdNum>456</fdNum>
<fnSn>789</fnSn>
<kktNum>100</kktNum>
<inn>222</inn>
<ofdUrl>gate.ofd.ru</ofdUrl>
<fullUrl>https://check.ofd.ru/123</fullUrl>
<price>12345</price>
<lines count="1">
<line>
<item>1111764</item>
<name>Сапоги</name>
<qty>1</qty>
<price>1000</price>
<vatRate>20</vatRate>
<governmentCode>Z16513LK2</governmentCode>
<itemType>1</itemType>
</line>
</lines>
</receipt>
</receipts>
</source>

Параметры ответа:
*'''orderno''' - Номер заказа
*'''fdDatetime''' - Дата и время пробития фискального чека
*'''fdValue''' - ФПД (фискальный признак документа)
*'''fdNum''' - ФИСКАЛЬНЫЙ ДОКУМЕНТ (фискальный номер чека)
*'''fnSn''' - ФН (номер фискального накопителя)
*'''kktNum''' - РН (регистрационный номер кассы)
*'''inn''' - ИНН
*'''ofdUrl''' - URL адрес (доменное имя) ОФД
*'''price''' - Сумма чека
*'''fullUrl''' - URL чека для просмотра онлайн
*'''lines''' - Позиции чека
:*'''item''' - код товара
:*'''name''' - наименование товара
:*'''qty''' - количество товара
:*'''price''' - цена товара
:*'''governmentCode''' - считанная последовательность, которая в дальнейшем преобразуется по алгоритму тега 1162
:*'''vatRate''' - НДС товара
:*'''itemType''' - тип товара (товар, доставка и т.д.)

== Справочник Виды срочности ==

'''Пример запроса видов срочности:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<services>
<auth extra="8"/>
</services>
</source>

'''Пример ответа справочника видов срочности:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<services count="2">
<service>
<code>1</code>
<name>Эконом</name>
</service>
<service>
<code>2</code>
<name>Срочно</name>
</service>
</services>
</source>

== Справочник дополнительных услуг ==

'''Пример запроса дополнительных услуг:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<advprices>
<auth extra="8" login="login" pass="pass" />
<visible>NO</visible>
</advprices>
</source>

'''advprices''' - Корневой контейнер. Обязательный элемент.
*'''visible''' - Признак возврата '''только''' тех услуг, что доступны для отображения в ЛК YES/NO. Необязательный элемент. По-умолчанию NO

'''Пример ответа справочника дополнительных услуг:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<advprices>
<advprice>
<code>1</code>
<name>Этажей в доме</name>
<type>int</type>
</advprice>
<advprice>
<code>2</code>
<name>Коэффициент надбавки</name>
<type>float</type>
</advprice>
<advprice>
<code>3</code>
<name>Расписаться на упаковке</name>
<type>bool</type>
</advprice>
</advprices>
</source>

Параметры:
*'''code''' - внутренний код услуги
*'''name''' - наименование услуги. Если поле "название в ЛК" в настройках услуги не пусто, то возвращает значение поля "название в ЛК".
*'''hine''' - подсказка по доп услуге для пользователя
*'''type''' - тип услуги. Может иметь значения:
:*'''bool''' - для услуг вида "чекбокс", "Да"
:*'''float''' - для числа с плавающей точкой
:*'''int''' - для целого числа

== Расчет стоимости доставки ==

'''Пример запроса стоимости доставки:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<calculator>
<auth extra="8" login="login" pass="pass" />
<order>
<pricetype>CUSTOMER</pricetype>
<sender>
<town>Санкт-Петербург</town>
<address>Петровка 38 офис 35</address>
<coords lat="55.680327" lon="37.604456"></coords>
</sender>
<receiver>
<zipcode>125480</zipcode>
<town regioncode="78" country="RU">Санкт-Петербург</town>
<address>Петровка 38 офис 35</address>
<pvz>124</pvz>
<coords lat="55.680327" lon="37.604456"></coords>
</receiver>
<weight>5.1</weight>
<service>2</service>
<paytype>CASH</paytype>
<price>387.5</price>
<deliveryprice>150</deliveryprice>
<inshprice>387.5</inshprice>
<packages>
<package mass="1" quantity="5"></package>
<package mass="2.5" length="10" width="20" height="30"></package>
</packages>
<userid>user123</userid>
<groupid>customer</groupid>
</order>
</calculator>
</source>

Параметры:
Структура данных и заполнение полей аналогичны и совместимы с [[#Оформление заказа]].

Дополнительные поля:
*'''pricetype''' - тип требуемой цены. Возможные значения: "CUSTOMER" (по-умолчанию) - [[Личный кабинет клиента#Цена доставки для получателя|цена для конечного получателя]], "CLIENT" - цена курьерской службы для клиента.
*'''userid''' - Идентификатор пользователя, строковый или числовой тип. Виртуальное поле. Необязательное. Данное поле используется совместно с настройками "Цена доставки для получателя", определяя приоритет правила. Можно использовать в различных CMS/CRM системах, настраивая цены для определенного покупателя.
*'''groupid''' - Идентификатор группы пользователя, строковый или числовой тип. Виртуальное поле. Необязательное. Данное поле используется совместно с настройками "Цена доставки для получателя", определяя приоритет правила. Можно использовать в различных CMS/CRM системах, настраивая цены для определенной группы покупателей.

Суммы НП и ОЦ, а также тип оплаты CARD имеют значение при настроенных в тарифе на вкладке Прочее долях (в процентах) от данных сумм.

В авторизации можно опустить параметры login и pass, тогда расчет будет производиться по стандартному тарифу курьерской службы, без учета возможных отличий для конкретного клиента.<br>
Объемный вес будет учитываться только при условии указания всех габаритов: длины, ширины и высоты.<br>
В полях город-отправитель и город-получатель можно указывать название города (не рекомендуется!), либо код города из нашего справочника, либо 13-ти значный код КЛАДР, либо 36-ти значный код адресной системы ФИАС (AOID).

'''Пример ответа стоимости доставки:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<calculator>
<calc>
<townfrom code="1">Москва город</townfrom>
<townto code="56603">Иркутск город</townto>
<mass>3.7</mass>
<service name="Экспресс">1</service>
<zone>2</zone>
<price>1113</price>
<mindeliverydays>1</mindeliverydays>
<maxdeliverydays>3</maxdeliverydays>
<mindeliverydate>2020-05-13</mindeliverydate>
<deliveryprice>
<advprice code="1" price="1000">База</advprice>
<advprice code="4" price="100">Процент от суммы руб</advprice>
<advprice code="5" price="63">Процент от объявленной стоимости</advprice>
<advprice code="6" price="-50">Скидка при доставке</advprice>
</deliveryprice>
</calc>
</calculator>
</source>

Параметры:
*'''townfrom''' - Город-отправитель так, как система его распознала и привязала к справочнику. Атрибут '''code''' - код из справочника городов системы.
*'''townto''' - Город-получатель так, как система его распознала и привязала к справочнику. Атрибут '''code''' - код из справочника городов системы.
*'''mass''' - Масса в килограммах
*'''service''' - Режим доставки - число, указывающее на запись в справочнике видов срочности (см описание на этой странице).
*'''zone''' - номер тарифной зоны, по которой рассчиталась стоимость. В зависимости от зоны выбирается тарифная сетка. Так же к цене могут применяться повышающие или понижающие коэффициенты при доставке не из/в региональный центр.
*'''price''' - рассчитанная стоимость доставки в валюте прайс-листа курьерской службы. Рекомендуется к использованию в отличие от одноименного атрибута родительского контейнера.
*'''maxdeliverydays''' - максимальный срок доставки в рабочих днях.
*'''mindeliverydate''' - минимальная дата доставки в учетом выходных дней.
*'''deliveryprice''' - Данные по составляющим ценам доставки

'''''Обратите внимание:''''' В реальном ответе сервера в теге calc присутствует атрибут "price". Он оставлен для обратной совместимости, не используйте его. Пользуйтесь вложенным тегом price.

== Получение информации о клиенте ==

'''Пример запроса получения информации о клиенте:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<client>
<auth extra="8" login="login" pass="pass" />
</client>
</source>

'''client''' - Корневой контейнер. Обязательный элемент.
*'''auth''' - Авторизация. Обязательный элемент.

'''Пример ответа на запрос получения информации о клиенте:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<client>
<code>1082</code>
</client>
</source>

*'''code''' - Код клиента

== Список актов передачи денег ==

'''Пример запроса списка актов передачи денег:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<smalist>
<auth extra="8" login="login" pass="pass" />
<datefrom>2016-02-10</datefrom>
<dateto>2016-03-10</dateto>
</smalist>
</source>

'''smalist''' - Корневой контейнер. Обязательный элемент.
*'''auth''' - Авторизация. Обязательный элемент.
*'''datefrom''' - Дата "с". Необязательный элемент.
*'''dateto''' - Дата "по". Необязательный элемент.
Если интервал дат не указан, то возвращаются акты передачи денег за последний месяц.

'''Пример ответа на запрос списка актов передачи денег:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<smalist count="1">
<sma>
<code>6278</code>
<number>3992</number>
<actdate>2016-02-12</actdate>
<datepay></datepay>
<dateto>2016-02-12</dateto>
<promiseddatepay></promiseddatepay>
<price>637.00</price>
<pricecorr>113.00</pricecorr>
<rur>13430.00</rur>
<pricekur>570.00</pricekur>
<priceag>67.00</priceag>
<payno>42423</payno>
<paytype>1</paytype>
<paytypename>Безнал</paytypename>
<signedcopyreceived>NO</signedcopyreceived>
</sma>
</smalist>
</source>

*'''code''' - Код акта
*'''number''' - Номер акта в системе
*'''actdate''' - Дата акта
*'''datepay''' - Дата оплаты по акту
*'''dateto''' - Дата конечного периода для формирования АПД
*'''promiseddatepay''' - Плановая дата оплаты
*'''price''' - Стоимость услуг
*'''pricecorr''' - Сумма корректировки
*'''rur''' - Сумма заказа
*'''pricekur''' - Стоимость курьерской доставки
*'''priceag''' - Агентское вознаграждение
*'''payno''' - Номер платежного поручения
*'''paytype''' - Тип оплаты: 1 - безнал, 2 - наличными курьером, 3 - наличными в офисе, 4 - перевод на карту
*'''paytypename''' - Строковое представление типа оплаты
*'''signedcopyreceived''' - Признак факта возврата акта YES/NO

== Детализация актов передачи денег ==

'''Пример запроса детализации актов передачи денег:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<smadetail>
<auth extra="8" login="login" pass="pass" />
<code>6278</code>
</smadetail>
</source>

'''smadetail''' - Корневой контейнер. Обязательный элемент.
*'''auth''' - Авторизация. Обязательный элемент.
*'''code''' - Код акта передачи денег (см. запрос списка АПД). Обязательный элемент.

'''Пример ответа на запрос детализации актов передачи денег:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<smadetail count="2">
<specialsma>
<code>42494</code>
<ordercode>14424</ordercode>
<orderno>11111</orderno>
<orderdate>2018-01-01</orderdate>
<delivereddate>2018-10-01</delivereddate>
<company>Компания</company>
<price>314.00</price>
<rur>8800.00</rur>
<inshprice>314.00</inshprice>
<pricekur>270.00</pricekur>
<priceag>44.00</priceag>
<pricecalc>8486.00</pricecalc>
<paytype>2</paytype>
<paytypename>наличными курьером</paytypename>
<weight>0.400</weight>
<distance>0.0</distance>
<status>Доставлено</status>
</specialsma>
</smadetail>
</source>

*'''code''' - Код записи.
*'''ordercode''' - Код заказа.
*'''orderno''' - Шифр заказа.
*'''orderdate''' - Дата заказа.
*'''delivereddate''' - Дата доставки.
*'''company''' - Получатель.
*'''price''' - Стоимость услуг.
*'''rur''' - Сумма заказа.
*'''inshprice''' - Стоимость заказа.
*'''pricekur''' - Стоимость курьерской доставки.
*'''priceag''' - Агентское вознаграждение.
*'''pricecalc''' - Сумма для передачи агенту.
*'''paytype''' - Тип оплаты: 1 - безнал, 2 - наличными курьером, 3 - наличными в офисе, 4 - перевод на карту.
*'''paytypename''' - Строковое представление типа оплаты
*'''weight''' - Вес заказа.
*'''distance''' - Дистанция по заказу
*'''status''' - Статус заказа.

== Генерация коротких ссылок ==

В некоторых случаях, например, при использовании в СМС, может потребоваться использование коротких ссылок на ЛК.
Для этого, необходимо отправить запрос с полной ссылкой, в ответ на который придёт хэш-код для ссылки.

'''Пример запроса генерации коротких ссылок:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<shortlink>
<link short="0"> https://home.courierexe.ru/8/site/orders </link>
</shortlink>
</source>

'''shortlink''' - Корневой контейнер. Обязательный элемент.
*'''link''' - Полная ссылка, для которой необходимо получить код. Обязательный элемент. Если атрибут '''short''' равен 1, то ответ не будет содержать XML, а только хэш-код.

'''Пример ответа на запрос генерации коротких ссылок:'''
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<shortlink>
<hash>35AF350C</hash>
</shortlink>
</source>

*'''hash''' - Хэш-код ссылки.

Далее, можно использовать ссылку на ЛК:

<nowiki>https://home.courierexe.ru/35AF350C или curie.ru/35AF350C</nowiki>

'''Примечание!''' Сервис коротких ссылок работает только для ресурсов компании MeaSoft.

== Проверка надежности покупателя ==

Проверка надежности работает только для тарифа "Максимум" личного кабинета.

<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<mcheck>
<auth extra="8" login="login" pass="pass" />
<phones>
<phone>89161147992</phone>
</phones>
</mcheck>
</source>

Ответ:

<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<mcheck>
<phones>
<phone rate="90">89161147992</phone>
</phones>
</mcheck>
</source>