Откройте настройки приложения. На вкладке "Ключи API" нажмите "Добавить аккаунт логистического оператора"

Новая Почта

Зайдите в личный кабинет на сайте novaposhta.ua. Сгенерируйте ключ в разделе Настройки > Безопасность.

Ключ создается на 1 год. После завершения действия ключа его нужно обновить или создать новый ключ.

УкрПочта

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

Meest Express

Для получения ключей нужно заключить договор, для этого обратитесь в контакт-центр.

DHL

1. Зарегистрируйте аккаунт на developer.dhl.com
   Войдите в аккаунт и создайте приложение в разделе «Apps».
   Введите любое название программы, например, LOGISTICS SYNC

2. DHL Global tracking. Добавьте "Shipment Tracking - Unified" из списка API в настройках созданного приложения. Скопируйте client_id (он же API key) и добавьте его в приложении.

3. DHL Parcel DE Shipping (Post&Parcel Germany). Добавьте "Parcel DE Shipping (Post & Parcel Germany)" из списка API в настройках созданного приложения.

Скопируйте client_id (он же API key) client_secret (он же API secret) из раздела Credentials  и добавьте в приложение Logistics sync. Чтобы получить GKP Username/GKP Password, создайте аккаунт с правами "system" в DHL Business Customers Portal и добавьте его в приложение Logistics sync.

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

B2B и длинные контракты (несколько ТТН в сделке)

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

Все ТТН опрашиваются на Новой почте и на вкладке "Список ТТН" можно увидеть актуальные статусы, но только одна ТТН, назначенная как "основная" для сделки переводит ее по стадиям. Первая ТТН в сделке автоматически назначается как основная, если необходимо выбрать ТТН для трекинга сделок - нажмите на ТТН и в выпадающем меню выберите "Сделать основной".

Возможность добавлять несколько ТТН в сделку можно отключить в настройках ключа - параметр "несколько ТТН в сделке".

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

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

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

Добавлен параметр "по умолчанию для направления", ключ можно выбирать как основной для конкретного направления (воронки) сделок, либо для всех направлений (воронок) по умолчанию. Если ключ выбран как основной, именно он автоматически выбирается при создании ТТН с соответствующими настройками отправителя. 

Замена ключа апи

Если Вам нужно заменить ключ API - это можно сделать в настройках ключа. При этом все настройки сохраняются. 

Нужно:

1. Выбрать ключ, в котором хотите сделать изменения.

2. Сохранить новый ключ в поле ключ API выбранного ключа.

3. Сохранить настройки ключа.

4. Обновить страницу настроек чтобы из нового аккаунта загрузились новые отправители.

5. Открыть настройки ключа, проверить, что отправители новые - из нового аккаунта.

6. Еще раз сохранить настройки чтобы обновился отправитель по умолчанию для создания ТТН.

Если не сделать пункты 4-6 при создании новым ключом вы получите ошибку, что отправитель не принадлежит этому пользователю (т.к. будут использваны старые отправители из прошлого ключа).

Если ключ API из другого кабинета Новой Почты, то вы не сможете управлять (удалять, оформлять возврат, печатать, также не оформится автовозврат с ошибкой "данный документ не принадлежит этому пользователю") ТТН, созданные с предыдущим ключом. Трекинг (отслеживание статусов и перемещение сделок по воронке) существующих ТТН завершится корректно.

Чтобы изменить в ключе не только ключ API, но и Оператора - сначала выберите "Тип оператора" в настройках ключа, затем повторите п.1-6

Направления (Воронки)

В приложении  есть поддержка направлений (воронок). Вы можете настраивать соответствия статусов логистических операторов независимо для каждого направления (воронки) и осуществлять трекинг ТТН в каждом из них.

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

Это можно сделать в разделе:

В Zoho - Setup-> Customization-> Pipelines.

В Pipedrive - Deals -> Pipeline -> New pipeline

В битриксе - CRM - More -> Settings -> CRM settings -> Deal pipelines

В амосрм - Leads -> Pipeline

После настройки направлений (воронок) необходимо перейти в настройки Логистика  sync на вкладку общие настройки, добавить нужные направления (воронки) и настроить соответствия статусов логистических операторов.

Теперь можно смело создавать заказы в нужных направлениях и они будут перемещаться по необходимым стадиям. А если вы привяжете к стадиям роботы, то в зависимости от нужного события будут отправляться SMS клиентам или ставиться задачи ответственным менеджерам.

Объемные воронки, что это такое?

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

Настройка и обновление стадий сделок

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

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

Например стадии в CRM могут быть:

Стадия 1. Новая сделка

Стадия 2. Согласование

Стадия 3. Получение оплаты

Стадия 4. Отправка товара (отправка sms с номером накладной) 

Стадия 4.4 Товар в пути

Стадия 5. Товар Прибыл (уведомление покупателя о необходимости забрать товар)

Стадия 6. 3 Дня на почте - уведомление менеджеру о необходимости контроля.

Стадия 7. Заказ выполнен - смс благодарности (получен товар без наложенного платежа или с услугой контроль оплаты - перевод наложенного платежа на р/c)

Стадия 7.1 Заказ выполнен - смс благодарности, Деньги отправлены (получен товар  и оплачен наложенный платеж, наложенный платеж отправлен наличными в отделение отправителя)

Стадия 7.2 Деньги получены (наложенный платеж получен отправителем наличными в отделении)

Стадия 8. Отказ от получения - уведомление менеджеру о необходимости взять обратную связь

Стадия 9. Оформлен возврат

Стадия 10. Возврат прибыл, необходимо забрать - уведомление на склад

Стадия 11. Возврат забран

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

Как правило, используются следующие соответствия стадий и статусов Новой Почты (НП)

Стадия 4 - статус НП 1 (сразу после создания ТТН) или статус НП 4 и 41 (фактическая отправка товара на НП)

Стадия 4.4 - статус НП 5,6,104 (в пути)

Стадия 5 - статус НП 7 и 8 (доставка в отделение), 101 (адресная доставка)

Стадия 6 - статус НП 6663 (3 дня на почте)

Стадия 7 - статус НП 9,106. (конечная стадия - успех, в статус 9 переводятся полученные посылки с контролем оплаты или без наложенного платежа)

Стадия 7.1 - статус НП 10 (в статус 10 переводятся посылки с наложенным платежом - посылка получена, наложенный платеж отправлен)

Стадия 7.2 - статус НП 11 (конечная стадия - успех, наложенный платеж получен отправителем посылки).

Стадия 8 - статус НП 102, 103, 108

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

Стадия 9 - статус НП 7777 (оформлен возврат)

Стадия 10 - статус НП 8888 (прибыл возврат)

Стадия 11 - статус НП 9999 (конечная стадия - провал, забран возврат)

Вы всегда можете настроить воронку согласно своим потребностям и бизнес-процессам.

Регламент обновления сделок 1 раз в час 24/7. 

Пользовательские поля ТТН, статус, дата и стоимость - обновляются в момент создания ТТН и при обновлении стадии, но не чаще 1 раза в час.

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

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

UPD2 если стадия не была назначена либо была изменена после смены статуса ТТН, то следующая смена стадии будет при движении ТТН по воронке на Новой Почте. Соответственно, если у вас ТТН попала в конечный статус и на этот момент не была назначена соответствующая стадия либо она была изменена после смены статуса, то сделка останется в той стадии, которая была настроена (или не настроена) в момент изменения статуса на Новой Почте.

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

UPD4 если по каким-либо причинам в конкретной сделке по вашим бизнес сценариям нужно отключить трекинг - настройте поле "Отключить трекинг" и роботом в нем устанавливайте соответствующее значение.

Как учитывать сделки с наложенном платежом и предоплатой

Как правило наши пользователи делают такие настройки:

1. Настраивают пользовательское поле "наложенный платеж", в которое передают роботом сумму заказа, либо "0"(ноль) если предоплата и нужно отключить наложенный платеж.

2. Настраивают статус 9 - посылка получена и 10 - посылка получена и есть наложенный платёж на одну стадию, например "товар забрали".

3. При переходе в эту стадию проверяют роботом, если поле наложки "0"(ноль), то отправляют сделку в "успешные", если не "0"(ноль) значит она перейдет дальше в стадию 11 - товар забрали и деньги получены, которую вы настроите как "успешная".

4. На практике даже с наложенными платежами ттн бывают попадают не в 10й, а в 9й статус и дальше в 11й не переключаются, в вашем случае они останутся в стадии "товар забрали" и менеджеру нужно будет обратить на них внимание.

Если нужные стадии настроены, а сделка не перемещается

Бывают ситуации когда приложения получает ошибку доступа - Access Denied, Wrong authorization data, Unable to authorize user, The user does not have access to the application, 401-Unauthorized со стороны  вашей CRM.

Очень часто подобные ошибки возникают если вы устанавливали/настраивали приложение не сами, а с помощью других людей, либо прав этих пользователей не хватает для обновления всех сделок. Приложение запоминает права доступа их учётной записи и после удаления ее с портала соответственно получает ошибку доступа. Поэтому после настройки рекомендуется открыть приложение вашей постоянной (которую вы не намерены удалять) учётной записью с правами администратора и установить ее права для работы приложения.

Так же если в вашей CRM пользователи оплачиваются отдельно может возникать ошибка Payment required, поэтому важно! дать приложению права того пользователя, который будет иметь максимальный доступ к сделкам для обновления и так же, который будет активный (постоянно оплачиваться crm), т.к. если пользователь будет не оплачен - при попытке доступа к API вернет ошибку - Payment required (необходима оплата) и сделка обновлена не будет. Поэтому рекомендуется открыть приложение вашей постоянной (которую вы не намерены удалять) учётной записью с правами администратора и которая активна (оплачивается) со стороны CRM и установить ее права для работы приложения.

для этого:

1. Откройте настройки приложения Логистика sync от имени пользователя с административными правами либо пользователя, который имеет доступ к изменению всех сделок, для которых необходима функция отправки

2. зайдите на вкладку "общие параметры"

3. внизу нажмите ссылку - установить права доступа для обновления стадий сделок

4. в открывшемся окне нажмите "установить права" и таким образом права текущего пользователя будут присвоены приложению для работы в фоновом режиме для корректного перемещения сделок по стадиям во избежание ошибок доступа - Access Denied, Wrong authorization data, Unable to authorize user, а также  Payment required  со стороны CRM.

Если меняете воронку (удаляете или добавляете стадии)

ВАЖНО, при внесении изменений в воронку (изменение, удаление стадий) - обновите настройки статусов в Логистика sync. 

Для этого зайдите на странице настроек приложения Логистика sync. На вкладке общие настройки - выберите настройки для нужного направления (воронки), просмотрите какие стадии назначены, убедитесь что во всех стадиях назначена стадия (не должно быть пустых значений) либо выбрано "пропустить", внесите необходимые изменения и сохраните. 

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

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

Теперь вы можете без настройки дополнительных роботов рассылать SMS сообщения с информацией о ходе выполнения доставки товара из приложения Логистика sync.

Как это работает?

Этап 1 - настройка  https://turbosms.ua/

1. Вам необходимо зарегистрировать аккаунт.

2. В личном кабинете turboSMS подать на регистрацию альфаимя, от имени которого будут отправляться  SMS вашей компании в разделе "Подписи". Пока альфаимя проходит процесс валидации ваши SMS будут отправляться от стандартного имени. Подать альфаимя на регистрацию необходимо, без него услуга отправки SMS через шлюз работать не будет. Если пройдены все формальные процедуры регистрация займет 1-2 недели.

3. В разделе SMS шлюз->подключение к шлюзу кабинета turboSMS выбрать:

Способ подключения: SOAP

Поддерживаемые каналы создания сообщений: SOAP

задать логин и пароль SMS шлюза.

Этап 2 - настройка SMS в Логистика sync

1. В разделе общие настройки -> настройка интеграции с turboSMS пропишите данные из Этап 1 - логин, пароль, альфаимя. Проверьте отправляются ли SMS (проверить настройки интеграции с  TurboSMS). Выберите "включить" для нужного ключа Логистика sync и сохраните настройки. Обратите внимание, что для каждого ключа Логистика sync можно привязать отдельное альфамя.

2. В разделе настройки статусов для направления (воронки) напротив нужного статуса добавьте шаблон SMS. Если шаблон не добавлен, то в этой стадии SMS отправляться не будет. В шаблоне можно использовать переменные ТТН, дата и время доставки. Обязательно после добавления шаблонов в выбранном направлении нажмите "сохранять статусы и изменения шаблонов SMS".

3. Для успешной отправки SMS телефон получателя должен быть в международном формате +380хх... Если ТТН добавляется вручную и так же необходимо SMS оповещение - перед добавлением ТТН в поле номер получателя добавьте номер (или оставьте тот, что подставился из заказа).

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

UPD Внедрен принцип разрешенного времени отправки смс. Окно отправки автоматически с 8 утра до 8 вечера, но вы можете его сузить, задав необходимый диапазон отправки в настройках приложения в разделе интеграция с turboSMS.

UPD2 Добавлена возможность отключать отправку SMS для конкретного заказа.

Для этого настройте пользовательское поле "Отправлять SMS по этому заказу?" и выведите в сделке настроенное поле.

Поле типа да/нет (логическое)

По умолчанию имеет значение - НЕТ, поэтому смс не будут по заказу отправляться, если нажать на это поле и уставить галочку - это режим ДА - означает, что смс по этому заказу нужно отправлять.

Если по умолчанию в заказах нужно отправлять SMS и настроено поле "Отправлять SMS по этому заказу?" в настройках этого поля в разделе Setup->Customization->Modules and Fields->Deals установите значение по умолчанию "Активировано по умолчанию" (Active by default).

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

В этом режиме достаточно открыть форму "Create Shipment" в сделке, заполнить необходимые поля. Нажать "Создать ТТН". Если данные корректно заполнены в форме ТТН появится Номер ТТН.

Если настроены пользовательские поля и в них подготовлены данные вручную менеджером или переданы через API вашей CRM, то при открытии формы "Create Shipment" переданные данные заполнят поля формы создания ТТН.

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

Создание ТТН автоматически

Приложение может создать ТТН автоматически из подготовленных заранее данных. Или из предварительно сохраненных данных в черновике (кнопка "сохранить черновик" в форме создания ТТН) или подготовленных данных в пользовательских полях сделки.

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

• Автоматичне створення ТТН - при переводе сделку в стадию сопоставленную с этим статусом приложение попробует создать ТТН автоматически

• Помилка автоматичного створення ТТН - если во время автоматического создания произошла ошибка приложение переведет сделку в стадию, сопоставленную с этим статусом. Ошибка сохранится в примечания сделки.

Добавление уже созданных ТТН для трекинга

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

Это можно сделать вручную в сделке в "Create Shipment", для этого необходимо:

• открыть в сделке форму "Create Shipment"

• нажать "Добавить ТТН"

• выбрать аккаунт, которому принадлежит ТТН или аккаунт оператора, которым создана ТТН, добавить номер ТТН и нажать "Добавить"

• Так же если настроено поле сделки "Номер ТТН" и в него добавлена ТТН вручную менеджером или через API CRM, сделка опросится и ТТН добавится для трекинга.

После того как ТТН добавлена сделка так же будет перемещаться согласно настроенным статусам в приложении.

Обратите внимание, для того чтобы ТТН добавилась для трекинга ключ API соответствующего оператора должен быть активен (оплачен в приложении). Если ключ API не был активен, то после его оплаты в приложении необходимо переместить сделки, в которых не включился трекинг в любую стадию, после этого сделка опросится, добавится ТТН и сделки переместятся согласно актуальному статусу, настроенному в приложении. 

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

Страховка

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

Если нужно передавать произвольную сумму настройте поле "объявленная стоимость"

Для настройки поля откройте настройки приложения -> Общие настройки ->Настройки пользовательских полей.

Наложенный платёж, контроль оплаты (перевод на счёт юрлица), перевод на VISA/MASTERCARD

ВАЖНО! Для тех кто использует контроль оплаты, обратите внимание!

В связи с тем, что возникает путаница с наложенным платежом и контролем оплаты теперь все привязано к параметру обратная доставка. Если она включена в параметрах ТТН при создании, то будет наложенный платеж или безналичный расчет (если включен контроль оплаты), если обратная доставка выключена, то ни наличной ни безналичной обратной доставки не будет. Прошу это учесть при создании ТТН.

Для тех кто не пользуется контролем оплаты:

контроль оплаты - это услуга Новой Почты по переводу наложенного платежа безналичным расчетом на расчетный счет юрлица. Чтобы воспользоваться этой услугой вам необходимо:

1. Заключить Договор с Новой Почтой от имени юрлица.

2. Договор с Новапей.

3. С помощью менеджера Новой Почты, который закреплён за вами активировать услугу "контроль оплаты" со стороны Новой Почты.

4. Включить контроль оплаты в настройках ключа в приложении.

5. Сохранить настройки ключа.

6. Используя этот ключ, создать ттн с обратной доставкой "грошовий переказ" и убедиться, что после создания ттн на распечатке есть отметка с услугой "контроль оплаты" - это означает, что услуга успешно активирована.

7. Если отметки нет, то повторите пункты 4-6.

8. Если во время создания ТТН с включенной услугой "контроль оплаты" Новая Почта возвращает ошибку - "услуга контроль оплаты не доступна". Обратитесь к вашему менеджеру на НП и  проверьте включена ли услуга "контроль оплаты" для выбранного ключа (кабинета НП) со стороны Новой Почты.

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

Перевод наложенного платежа для физлиц на карту VISA или  MASTERCARD работает ТОЛЬКО через кабинет или приложение Новой Почты, т.к. платежные системы предъявляют свои требования к транзакциям и Новая Почта не предоставляет эту услугу через API.

Автоотключение наложенного платежа

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

Если и в 1 и во 2 случаях сумма = 0 - обратная доставка по умолчанию выключена.

3 ДЕНЬ ХРАНЕНИЯ и АВТОВОЗВРАТЫ

Автоматический режим возврата посылки:

Автовозврат от 5ти до 14ти дней хранения. Настраивается в ключе на все ттн. Так же может изменяться или отключаться, при необходимости, для конкретной ттн в сделке Create Shipment->Список ТТН -> нажать на ТТН и изменить параметры автовозврата.

С учётом того, что есть человеческий фактор и на практике, даже после отказа и вашей беседы с клиентом он передумал отказываться и все-таки решил забрать посылку - автовозврат посылок в момент отказа отменён и до окончания указанного Вами срока возврата посылка будет находиться в отделении и ее можно забрать "повторно". Если необходимо вернуть посылку до дня возврата, вы можете оформить возврат вручную. (см.ниже).

Режим автовозврата можно включить в настройках ключа. Также можно активировать возврат при отказе.

С 12.03.2020, для упрощения учёта на Новой Почте для хранения считаются все календарные дни (так же выходные и праздничные). Так же количество бесплатных дней хранения увеличено до 7 для всех клиентов Новой Почты. Согласно этим изменениям при расчете параметров "АВТОВОЗВРАТ" и "ТРЕТИЙ ДЕНЬ ХРАНЕНИЯ" в приложении Новая Почта sync учитываются все календарные дни, т.е. если вы настроили АВТОВОЗВРАТ через 7 ДНЕЙ - это означает, что посылка будет на отделении 7 ДНЕЙ, с учётом дня прибытия, а после 16:00 седьмого календарного дня автоматически оформится возврат посылки.

В приложении дни хранения считаются с дня прибытия в отделение.

Автовозврат оформляется после 16:00. Почему 16:00? Чтобы не начислялась плата за дополнительный день хранения необходимо оформить возврат до граничного времени отправки "день-в-день" отделения, которое может в разных отделениях быть разным, но в целом, в больших и средних городах это до 17:00-18:00

Статус - 3й день хранения сработает на третий день хранения.

Если вам звонит клиент и просит задержать посылку (не успевает забрать), то автовозврат всегда можно отключить для конкретной ТТН. Для этого необходимо в сделке зайти в Create Shipment->Список ТТН, нажать на необходимую ТТН и выбрать автовозврат->отключён, либо увеличить количество дней до автовозврата.

Ручной режим возврата посылки:

Для возврата посылки вручную зайдите в сделке в Create Shipment->Список ТТН, нажмите на необходимую ТТН и выберите Вернуть сейчас. Если ТТН оформлялась в приложении, то приложение попробует оформить возврат и сообщит ответ Новой Почты.

Если вы передумали возвращать посылку и новая почта не запрещает отменять возврат - в этом же меню выберите "Отменить возврат" и созданная заявка на возврат будет отменена.

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

Обратите внимание, что если ТТН создана не в приложении или из другого кабинета Новой Почты чем тот, что зарегистрирован в приложении, либо ключ с помощью, которого была создана ТТН был удален из настроек приложения, то при попытке оформить возврат приложение получит ответ от Новой Почты - "Документ не належить даному користувачу" и возврат оформлен не будет.

Если вы изменили настройки автовозврата в ключе по умолчанию - это влияет на вновь созданные ттн. В ТТН, которые уже созданы, автовозрат тот, который использовался при создании ТТН. Его можно изменить либо в форме ТТН (см.выше) или через поле сделки "Автовозврат" (предварительно необходимо настроить). В поле сделки "автовозврат" необходимо внести число дней хранения до оформления возврата, "0"(ноль) - автовозврат отключен.

Также обратите внимание, что Новая Почта позволяет через API оформлять возврат посылок стоимостью менее 14 999 грн. При оформлении возврата посылки большей стоимости Новая Почта выдаст ошибку - Вартість відправлення перевищує 14 999 грн. Повернення можливе тільки при замовленні послуги. Відправником у відділенні. И возврат оформлен не будет.

Автовозвраты для юрлиц с филиальной структурой.

По умолчанию возвраты оформляются на отделения, с которых фактически была отправлена посылка, а не на отделения, которые указаны при создании ТТН.

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

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

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

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

Переадресации и трекинг переадресаций

Добавлена возможность создавать переадресации ТТН.

Для этого зайдите в Create Shipment в нужной сделке. Откройте Список ТТН и, нажав на нужную ТТН, в меню выберите - Переадресация.

Если вы передумали переадресовывать посылку и новая почта не запрещает отменять переадресацию - в этом же меню выберите "Отменить переадресацию" и созданная переадресация будет отменена.

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

При переадресации в сделку добавляется новая ттн и на нее переключается трекинг сделки. Количество переадресаций неограничено - вся история ТТН сохраняется. 

Запустили сервис печати ТТН без привязки к ключам  API.

Добавлено пользовательское поле "Внешняя ссылка для печати ТТН", в него сохраняется ссылка, в которой отсутствует привязка к ключу апи вашего кабинета Новой Почты, УкрПочты или Джастин. 

Ссылку можно передавать третьим лицам-контрагентам, с которыми вы взаимодействуете. При обращении к сервису печати откроется стикер pdf этой ТТН.

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

Сервис печати использует тот ключ апи, с помощью которого создавалась ТТН и если вы его заменили, то ссылка станет не актуальна, пересоздав ТТН вы сможете получить новую ссылку.

Если ссылка не актуальна, недействительный или просроченный ключ апи вашего аккаунта в приложении на момент печати или возраст ТТН больше 30 дней, то при попытке использовать такую ссылку сервис выдаст сообщение - "Ссылка неактуальна или печать недоступна".

Если ссылка актуальна и печать доступна в ответ на запрос откроется pdf.

Ссылка для печати имеет вид: 

Новая Почта

https://prn3tn.onlinetechretail.com/f48d.../20450472479509/s

УкрПочта

https://prn3tn.onlinetechretail.com/551cfc04/0503135890903/s

В окончании ссылки s - это признак для печати стикера.

Если нужен  A4 - s нужно заменить на a:

https://prn3tn.onlinetechretail.com/f48d.../20450472479509/a

Так же можно печать ТТН из сделки

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

В Zoho - Реестры открываются в меню Shipment Registry.

В Pipedrive - реестры открываются в сделке, в панели Logistics sync - Shipment registry

В битриксе - реестры открываются в сделке кнопка "реестры ттн" сверху под кнопкой "приложения" или в меню таймлайна сделки, возможно под кнопкой "еще", справа

В амосрм - реестры открываются в разделе Аналитика - Реестры ТТН

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

В списке ТТН вы сможете увидеть привязку к заказам и при необходимости открыть нужный заказ. Также распечатать реестры или ТТН, или удалить. Для печати доступны форматы А4 и для принтера zebra размером 85x85 и 100x100.

Список ТТН можно фильтровать (в меню - фильтр) по стадии, номеру получателя, номеру реестра (если вместо номера реестра ввести пробел, то покажет все ттн за выбранные даты без реестра), печатать, удалять, добавлять/удалять в/из реестра, экспортировать в CSV.