# Интеграция СДЭК и МойСклад

Приложение для создания накладных из заказов и отгрузок

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/Vk0ILPeUiJoX1xdJPDjj/cdek_ms.png)

## Что такое СДЭК?

[**СДЭК**](https://cdek.ru) — это надежная и быстрая курьерская служба с доставкой до двери и точек ПВЗ по России и зарубежью.

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

## Что такое МойСклад?

[**МойСклад**](https://www.moysklad.ru/) — облачный сервис управления торговлей и складом с любого компьютера, в любое время.

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

МойСклад предлагает [большое количество](https://www.moysklad.ru/vozmozhnosti/) облачных решений компаниям розничной, оптовой торговли, интернет-магазинам и производствам.

## Зачем нужна интеграция СДЭК и МойСклад?

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

### Возможности для пользователя интеграции&#x20;

* актуальный и быстрый [расчет](/osnovnye-vozmozhnosti/widget-prilozheniya/raschet-ceny) непосредственно в [виджете](/osnovnye-vozmozhnosti/widget-prilozheniya) приложения в документах заказа покупателя и отгрузки&#x20;
* [учет веса и габаритов](/nastroika/ves-i-gabarity) при расчете цены
* мгновенное [создание накладных из виджета](/osnovnye-vozmozhnosti/widget-prilozheniya/raschet-ceny) приложения в карточке заказа или отгрузки
* всегда [актуальный список ПВЗ](/osnovnye-vozmozhnosti/widget-prilozheniya/raschet-ceny#vybor-pvz) с возможностью выбора на карте прямо в заказе покупателя или отгрузке
* [автоматическое создание накладных](/osnovnye-vozmozhnosti/avtosozdanie-nakladnykh) по заранее заданному сценарию
* гибкая настройка приложения под [разные виды документов](/nastroika/translyaciya-statusov) МоегоСклада
* массовая и единичная печать накладных и штрихкодов мест по накладной
* контроль по возвратным накладным
* учет и передача в СДЭК серийных и маркированных товаров
* [вызов курьера](/osnovnye-vozmozhnosti/vyzov-kurera) на забор груза с вашего склада непосредственно из приложения по 1 клику
* [простановка статусов](/nastroika/translyaciya-statusov) в документах МойСклад в зависимости от статуса СДЭК
* возможность использовать [разные аккаунты СДЭК](/osnovnye-vozmozhnosti/widget-prilozheniya/dannye-po-zakazu#tochka-otgruzki) для отгрузки от разных складов или организаций в МоемСкладе
* [делать наценки и скидки](/nastroika/pravila-dostavki) в зависимости от региона покупателя (правила доставки)
* [виджет приложения](/osnovnye-vozmozhnosti/widget-prilozheniya) в карточке заказа и отгрузке обновляется моментально при редактировании состава заказа. Вы всегда имеете актуальную цену доставки под рукой
* возможность передавать в накладную [только необходимые позиции](/osnovnye-vozmozhnosti/widget-prilozheniya/dannye-po-zakazu#tovary-k-otgruzke) из документа МойСклад (например, только неотгруженные, или только доступные)
* [регистрировать договоренности](/osnovnye-vozmozhnosti/widget-prilozheniya/sozdannye-nakladnye) о доставке, менять адрес, время доставки, точки ПВЗ из виджета в заказе покупателя или отгрузке
* [демо-доступ](/nastroika/accounty-sdek#demo-rezhim) по тестовым ключам API
* [поддержку](/podderzhka) по вопросам настройки и использования приложения, возможность кастомизации&#x20;

### Стоимость <a href="#stoimost" id="stoimost"></a>

Приложение платное. Стоимость - 1300 ₽ в месяц. Оплата производится через МойСклад.

Пользователям предоставляется бесплатный триальный период в течении 14 дней с момента установки. &#x20;

При оплате на год предоставляется скидка 20% - 12480 ₽ в год

### Информация о разработчике <a href="#informaciya-o-razrabotchike" id="informaciya-o-razrabotchike"></a>

Полное наименование на русском языке: Индивидуальный предприниматель Потапов Денис Александрович

ОГРН 316501200052321 ИНН 501210739820

Юридический адрес: Московская область, г. Балашиха, мкр. Железнодорожный, улица Пионерская, дом 31, квартира 68

Банковские реквизиты:

р/с 40802810800005358057 в АО "ТИНЬКОФФ БАНК"

БИК 044525974

к/с 30101810145250000974

### Документы <a href="#dokumenty" id="dokumenty"></a>

[Договор оферта](https://cdek-ms.ru/files/oferta.pdf)

[Утвержденные тарифы](https://cdek-ms.ru/files/tarifs.pdf)

[Условия обработки персональных данных](https://cdek-ms.ru/files/privacy.pdf)

### Контакты <a href="#kontakty" id="kontakty"></a>

Сайт: [cdek-ms.ru](https://cdek-ms.ru)

Почта: <apps@cdek-ms.ru>

Телеграм: [@apps\_support](https://t.me/apps_support)


# Виджет приложения

## Общее описание виджета

Виджет приложения реализует интерфейс редактирования данных заказа, создание накладных СДЭК, просмотр уже созданных накладных по документу.

Виджет приложения доступен в `Заказе Покупателя` и `Отгрузке`.

![Интерфейс виджета приложения во вкладке "Данные заказа" ](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/mM5yDXfAFUVnlZJa3COV/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-08-31%20%D0%B2%2017.07.54.png)

Виджет состоит из 3 основных частей (вкладок)

* [**Данные заказа**](/osnovnye-vozmozhnosti/widget-prilozheniya/dannye-po-zakazu). Здесь пользователю предлагается решить какие данные нужно передать в СДЭК и перепроверить данные используемые для расчета (вес, габарит, наложенный платеж). В зависимости от настроек приложения в виджет автоматически подставляются данные клиента (имя, телефон, адрес).&#x20;
* [**Создание накладной**](/osnovnye-vozmozhnosti/widget-prilozheniya/raschet-ceny). Данная вкладка представляет собой расчетную часть, где пользователь приложения должен выбрать тариф доставки и режим доставки (до склада или до двери), выбрать точку ПВЗ (если режим доставки - до склада). Здесь же пользователь непосредственно отправляет данные в СДЭК и получает готовую к печати накладную.                                    &#x20;
* [**Накладные**](/osnovnye-vozmozhnosti/widget-prilozheniya/sozdannye-nakladnye). В данной вкладке представлены уже созданные по документу накладные, отображается краткая информация по накладной, ее текущий статус, а также реализована возможность регистрации договоренности о доставке с покупателем (например, время доставки, оговоренное с покупателем).


# Данные заказа

## Описание

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

![Интерфейс виджета приложения во вкладке "Данные заказа"](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/mM5yDXfAFUVnlZJa3COV/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-08-31%20%D0%B2%2017.07.54.png)

### Точка отгрузки&#x20;

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/gBOZXY8uay56eFbq3NO7/tochka.png)

В данном пункте виджета выбирается аккаунт СДЭК для создания накладной. Эта опция может понадобится, если у вас несколько точек отгрузки в разных городах с разными аккаунтами СДЭК (разными договорами).&#x20;

Для предвыбора данной опции [в настройках приложения](/nastroika/accounty-sdek) можно привязать аккаунт СДЭК к складу или организации. В этом случае сразу будет выбран аккаунт СДЭК, в зависимости от склада или организации указанных в заказе или отгрузке.

### Товары к отгрузке

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/wF7OvGKwj4WAbdftvH4N/otgruzhaem.png)

Здесь пользователь приложения выбирает какие товары из заказа или отгрузки попадут в накладную СДЭК.&#x20;

* все товары
* доступные
* в остатке
* неотгруженные
* неотгруженные доступные
* неотгруженные в остатке
* зарезервированные

Данная опция может быть удобна в случаях:

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

### Вариант отгрузки

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/JhS5aw9FxSkztQVvn4qq/variant-otgruzki.png)

Выбор варианта отгрузки. В СДЭК заказы можно отгружать двумя вариантами:

* **От склада**. Данный метод подразумевает, что вы сами передаете отправления на склад СДЭК. Передать отправления на склад СДЭК можно двумя способами:
  * заказав консолидированный забор со своего склада - через [вызов курьера СДЭК](/osnovnye-vozmozhnosti/vyzov-kurera#podacha-zayavki-na-vyzov-kurera)&#x20;
  * вы сдаете отправления сами в одном из ПВЗ СДЭК.
* **От двери**. Данный метод подразумевает вызов курьера на каждое созданное отправление. В виджете есть опция автоматического вызова курьера на такое отправление.

Отгрузку "от двери" стоит использовать при единичных отправлениях, в любых других случаях дешевле использовать отгрузку "от склада" с консолидированным забором через вызов курьера. Таким образом, например, у вас будет N накладных по режиму доставки склад-склад / склад - дверь и 1 накладная на забор груза по тарифу дверь - склад.

Подробнее про тарифы, режимы доставки и схемы работы со СДЭК читайте в разделах [Термины СДЭК](/ispolzovanie/untitled) и [Общие схемы работы со СДЭК](/ispolzovanie/obshie-skhemy-raboty-so-sdek).

### Имя получателя&#x20;

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/E2S9yA8VMJ2hTUQlhW4j/imya-poluchatelya.gif)

В имя получателя можно передавать данные клиента из:&#x20;

* наименования контрагента
* имя контактного лица
* имя, указанное в доп. поле заказа или отгрузки

Какое из этих значений будет передаваться в виджет по умолчанию можно указать в [настройках приложения](/nastroika/translyaciya-statusov).&#x20;

Для выбора имени из доп. поля заказа или отгрузки нужно заранее указать это доп. поле в [настройках приложения](/nastroika/translyaciya-statusov).

Также, при нажатии на стрелку справа от поля ввода можно прямо из виджета, не редактируя [основные настройки приложения](/nastroika/translyaciya-statusov), развернуть быструю настройку и выбрать откуда взять имя клиента.&#x20;

### Телефоны получателя

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/xhAZlahZnwwvQ11u5rp7/telephone_poluchatelya.gif)

В телефоны получателя можно передавать данные клиента из:&#x20;

* карточки контрагента
* телефон контактного лица
* телефон, указанный в доп. поле заказа или отгрузки
* все найденные телефоны из пунктов выше

Как в случае с именем получателя, какое из этих значений будет передаваться в виджет по умолчанию можно указать в [настройках приложения](/nastroika/translyaciya-statusov).&#x20;

Для выбора телефона из доп. поля заказа или отгрузки нужно заранее указать это доп. поле в [настройках приложения](/nastroika/translyaciya-statusov).

При нажатии на стрелку справа от поля ввода можно прямо из виджета, не редактируя основные [настройки приложения](/nastroika/translyaciya-statusov), развернуть быструю настройку и выбрать откуда взять телефон клиента.

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/33CT9CxfqrLqjweVcVlB/dop_telephon.gif)

При необходимости можно указать несколько контактных телефонов получателя.&#x20;

### Город и адрес получателя

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/dZgufisbGAAA3DErqr4J/chrome-capture.gif)

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

* карточки контрагента (физический адрес)
* карточки контрагента (юридический адрес)
* адрес, указанный в доп. поле заказа или отгрузки

Как в случаях выше, какое из этих значений будет передаваться в виджет по умолчанию можно указать в [настройках приложения](/nastroika/translyaciya-statusov).&#x20;

Для выбора адреса из доп. поля заказа или отгрузки нужно заранее указать это доп. поле в [настройках приложения](/nastroika/translyaciya-statusov).

При нажатии на стрелку справа от поля ввода можно прямо из виджета, не редактируя основные [настройки приложения](/nastroika/translyaciya-statusov), развернуть быструю настройку и выбрать откуда взять адрес клиента.

Город распознается автоматически из адреса клиента. Если город не распознался, или вы хотите изменить город получателя, его можно отредактировать прямо в виджете, при этом стоимость доставки пересчитается, а [карта с пунктами ПВЗ](/osnovnye-vozmozhnosti/widget-prilozheniya/raschet-ceny#vybor-pvz) обновится.&#x20;

{% hint style="warning" %}
Важно заметить, что город определяется из адреса в МоемСкладе и сопоставляется с базой городов СДЭК.  Правильность распознавание города из адреса не гарантируется, поэтому при оформлении стоит уделять отдельное внимание этому полю.
{% endhint %}

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/ZAiQ6qFzlJMeXv10RHV8/change-price.gif)

### Наложенный платеж

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/N5am6UHXrxXWmn9WzdUC/nalozhenniy-platezh.png)

Опция определяет нужно ли брать деньги с клиента при получении. Существует два варианта отправки:

* с наложенным платежом
* без наложенного платежа

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

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/KfPwyHRgLsWeoPE7TJcK/chrome-capture%20\(2\).gif)

Если в регионе недоступен прием наложенного платежа, опция автоматически устанавливается в значение "Без наложенного платежа", а выбор "Наложенного платежа" становится недоступен пользователю.&#x20;

Также информация об отсутствии в регионе возможности приема наложенного платежа появляется в [расчетной части виджета](/osnovnye-vozmozhnosti/widget-prilozheniya/raschet-ceny).

Отредактировать сумму наложенного платежа можно в меню редактирования позиций - нажав ссылку `Редактировать` (физически состав заказа в МоемСкладе остается прежним)

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/QIAfvOyQR6gWDZ3WhE8d/edit.png)

### Стоимость заказа

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/JcIme6qDBYZiXhF5vXsi/obyavlennaya-stoimost.png)

Под стоимостью заказа понимается объявленная стоимость всех позиций заказа. Именно с этой суммы СДЭК берет страховку в размере 0.75% и эту же сумму вернет вам, если заказ будет утерян или поврежден в процессе доставки.&#x20;

Страховка является обязательной для всех отправлений с объявленной стоимостью. Страховка учитывается в стоимости доставки по формуле: `Стоимость доставки = Расчетная стоимость по тарифу + Стоимость заказа * 0.75%`&#x20;

Вы можете [изменить процент страховки](/nastroika/strakhovka-i-nacenki) в настройках приложения, но стоит заметить, что это лишь уменьшит стоимость доставки для ваших клиентов, СДЭК с вас будет в любом случае удерживать 0.75% от стоимости заказа.  Подробнее читайте в [Терминах СДЭК](/ispolzovanie/untitled)

Отредактировать стоимость заказа можно в меню редактирования позиций - нажав ссылку `Редактировать` (физически состав заказа в МоемСкладе остается прежним)

### Стоимость доставки

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/Dbqss1yIF6gPhg4SFIqn/stoimost-dostavki.png)

Стоимость рассчитанная по минимальному из [доступных тарифов](/osnovnye-vozmozhnosti/widget-prilozheniya/raschet-ceny#vybor-tarifa) для данного направления при заданных значениях веса, габаритов и стоимости заказа.&#x20;

Вы можете редактировать стоимость доставки на свое усмотрение, а также включить сбор за доставку в накладную, отметив галкой `Включить сбор за доставку`.&#x20;

Если сбор за доставку включен, доставку оплачивает ваш клиент и при получении заказа он заплатит помимо наложенной стоимости заказа сбор за услуги СДЭК.&#x20;

### Вес и габариты

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/kzjAis0XJSkYHWhiNhZT/ves-i-gabarity.png)

Параметры отправления, исходя из которых рассчитывается стоимость доставки.&#x20;

Приложение может брать значения веса и габаритов из

* общих значений веса и габаритов в настройках приложения
* значений веса и габаритов из карточки товара

Стоит учитывать, что СДЭК считает доставку по наибольшему из двух весов: физическому весу или объемному весу. Подробнее про это читайте в [Терминах СДЭК](/ispolzovanie/untitled)

Подробнее про настройку передачи веса и габаритов читайте в [настройках приложения](/nastroika/ves-i-gabarity).

Отредактировать вес и габариты каждой позиции можно в меню редактирования позиций - нажав ссылку `Редактировать` (физически состав заказа в МоемСкладе остается прежним)


# Расчет цены и создание накладной

## Описание

В этой части виджета выводятся точки ПВЗ и стоимость по  тарифам, доступным для отправления по заданным параметрам из вкладки [**Данные заказа**](/osnovnye-vozmozhnosti/widget-prilozheniya/dannye-po-zakazu)

![Интерфейс виджета приложения во вкладке "Создание накладной" ](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/kNkHpbwPlTguHUIpAx9D/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-01%20%D0%B2%2015.29.04.png)

### Выбор тарифа

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/wmaT1oWxKHylrJQpOOfm/delivery-price-translations.gif)

При выборе тарифа доставки стоимость тарифа транслируется в поле [Стоимость заказа](/osnovnye-vozmozhnosti/widget-prilozheniya/dannye-po-zakazu#stoimost-zakaza).

Стоимость рассчитывается для всех включенных в [Настройках приложения тарифов](/nastroika/tarify).&#x20;

Помимо стоимости в расчетной части доступны [выбор ПВЗ](/osnovnye-vozmozhnosti/widget-prilozheniya/raschet-ceny#vybor-pvz) на карте, и контрольные сроки доставки по каждому из тарифов.

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/OMMtflfWj0AHtIBbTaNX/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-01%20%D0%B2%2017.00.23.png)

Если в городе получателя недоступен [Наложенный платеж](/osnovnye-vozmozhnosti/widget-prilozheniya/dannye-po-zakazu#nalozhennyi-platezh), пользователь получает уведомление при расчете цены, а опция [Наложенный платеж](/osnovnye-vozmozhnosti/widget-prilozheniya/dannye-po-zakazu#nalozhennyi-platezh) переключается в значение "Без наложенного платежа" автоматически

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/riHm73VSLVNLBU4GM9Qg/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-01%20%D0%B2%2016.55.52.png)

###

### Выбор ПВЗ

Если вы выбрали тариф **До склада** (т.е. до точки ПВЗ) - приложение предложит выбрать вам выбрать ПВЗ назначения на карте

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/1XhcAYqhPBxP2ok3jOSa/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-10-29%20%D0%B2%2015.16.42.png)

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/SeyGmfoc6Rsll95sJSfp/calculate.gif)

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

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

У каждой точки опционально отображаются на карте тарифы доступные для нее и сроки доставки.&#x20;

![Информация по выбранному ПВЗ](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/NsHatc5CIHbCsKx7bMsr/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-01%20%D0%B2%2018.24.19.png)

Если пользователь не выберет точку ПВЗ при заказе по тарифу **До склада**, он получит сообщение с предупреждением, а заказ не оформится.

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/2anhPFzCe8ZydXSe5Ogi/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-01%20%D0%B2%2015.40.58.png)

### Оформление накладной

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/JmOh61qYNfjpnsPnCfBv/make-invoice.png)

При нажатии на кнопку `Отправить` в виджете создается накладная, которая автоматически скачивается на компьютер пользователя.&#x20;

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/YxdAiRZj3eGJYJXpmkog/create-invoice%20\(1\).gif)

После оформления созданная накладная будет доступна во вкладке [Накладные](/osnovnye-vozmozhnosti/widget-prilozheniya/sozdannye-nakladnye)&#x20;

В зависимости от настроек приложения, номер накладной и ссылка на скачивание может [транслироваться](/nastroika/translyaciya-statusov) в дополнительные поля документа (заказа покупателя или отгрузки)


# Созданные к документу накладные

## Описание

В этой части виджета выводятся все созданные по данному документу (заказу покупателя или отгрузке) накладные СДЭК, а также их последний статус, краткая информация и возможность зарегистрировать договоренность о доставке.&#x20;

![Интерфейс виджета приложения во вкладке "Накладные" ](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/Kx04f6s2i7uu9xr7JP7c/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-01%20%D0%B2%2018.35.24.png)

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

Созданную накладную можно удалить, нажав на иконку `⛔️`

### Договоренности по доставке

**Опционально**, по каждой накладной можно зарегистрировать договоренности по доставки. Это необязательный шаг, т.к. СДЭК сам может прозвонить клиента и договориться о доставке.

Под договоренностями понимают:&#x20;

* изменение даты доставки (при доставке до двери)
* изменение времени доставки
* изменение метода доставки (доставку до двери можно поменять до склада)
* изменение ПВЗ (если доставка была до склада)

По каждой зарегистрированной договоренности обновляется статус со стороны СДЭК. Данный статус будет отображен в виджете приложения. Договоренность может быть в статусе:

* **Принята:** Договоренность создана в информационной системе СДЭК, но требуются дополнительные проверки&#x20;
* **Зарегистрирована:** Договоренность прошла необходимые проверки на возможность осуществления доставки в оговоренное время, место&#x20;
* **Некорректна:** Договоренность содержит некорректные данные&#x20;
* **Аннулирована:** Договоренность аннулирована в силу появления новой договоренности

Чтобы просмотреть зарегистрированные вами договоренности о доставки кликните по ссылке `Договоренности по доставке`

![В этом примере передана одна договоренность о доставке](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/JxqiGXsynoraPUv1Ibw6/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-01%20%D0%B2%2019.05.06.png)

### Регистрация договоренности

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/nOga3rHBTxpko5rDJ4bV/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-01%20%D0%B2%2019.04.47.png)

Если вам нужно зарегистрировать достигнутую с клиентом договоренность о доставке нужно кликнуть по ссылке `Зарегистрировать договоренность`.

В открывшемся списке вы можете изменить на выбор: дату, время, адрес или тип доставки.&#x20;

После проверки СДЭК возможности доставки по договоренности она получит статус `Зарегистрирована`.&#x20;


# Автосоздание накладных

## Описание

Помимо оформления накладных через [виджет](/osnovnye-vozmozhnosti/widget-prilozheniya), приложение позволяет оформлять накладные в фоновом режиме, без участия человека. Автоматическое создание накладных СДЭК доступно как для `Заказа покупателя` так и для `Отгрузки`

Данный функционал не имеет интерфейса пользователя, а ограничивается соответствующими [настройками автоматического создания накладных](/nastroika/avtomaticheskoe-sozdanie-nakladnykh), а также логом ошибок, если создание накладной закончилось неудачей.&#x20;

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

* срабатывание триггера на создание накладной. Это может быть создание документа, либо изменение документа: смена статуса документа, изменение доп. поля, изменение состава заказа, проводки и т.д.
* согласно настройкам [автоматического создания накладных](/nastroika/avtomaticheskoe-sozdanie-nakladnykh), в СДЭК оформляется накладная
* созданная накладная будет доступна для скачивания в разделе [**Накладные**](/osnovnye-vozmozhnosti/nakladnye)  и в [**Виджете**](/osnovnye-vozmozhnosti/widget-prilozheniya/sozdannye-nakladnye) приложения данного документа
* опционально приложение может прислать WebPush (только для браузера Google Chrome) со ссылкой на накладную пользователю в браузер


# Накладные

Во вкладке **Накладные** отображаются все созданные через [**виджет**](/osnovnye-vozmozhnosti/widget-prilozheniya) и [**автоматическое создание**](/osnovnye-vozmozhnosti/avtosozdanie-nakladnykh) накладные, их текущие статусы, данные по доставке, суммарные стоимости наложенного платежа и т.д.

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/fLNWiHehWSRI1zTYqkXd/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-01%20%D0%B2%2019.55.56.png)

### Фильтрация и сортировка

![Органы управления фильтрацией](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/YYYLtqwQgfIoUbkAJmsG/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-01%20%D0%B2%2020.03.33.png)

Пользователь может отфильтровать созданные накладные по&#x20;

* статусу доставки СДЭК
* статус документа в МоемСкладе
* дате создания накладной
* поиск по полям

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

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/ycdEBAOro9z2ORkgKlEO/chrome-capture%20\(4\).gif)

### Скачивание накладных

Накладные можно скачивать как единично, кликая на номер накладной, так и массово, выделив нужные накладные галочками и выбрав `Распечатать` в выпадающем меню

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/RVTg5lilZg2AyvdpG5qO/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-01%20%D0%B2%2020.36.49.png)

### Удаление накладных

Удалить накладные можно выделив галочками нужные и выбрав `Удалить` в выпадающем меню


# Вызов курьера

Во вкладке **Вызов курьера** отображаются все созданные заявки на вызов курьера. Здесь же можно оформить заявку на вызов курьера.

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/lMSGq8pZq465u5ITqKra/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-01%20%D0%B2%2020.43.31.png)

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

Созданную и еще не выполненную заявку можно удалить, нажав на иконку `⛔️` слева в строке заявки.

### Подача заявки на вызов курьера&#x20;

Условия формирования заявки:

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

Чтобы попасть в интерфейс вызова курьера нажмите `Вызвать курьера`&#x20;

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/Epv47ySXnrjQhRoMOXAI/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-01%20%D0%B2%2020.50.13.png)

Большинство данных будут предзаполнены из [настроек приложения](/nastroika/accounty-sdek)

Разберем отдельные пункты:

#### Тип забора

Существует два типа забора:&#x20;

* **Консолидированный забор**. Консолидированный забор используется для передачи на склад СДЭК **нескольких** накладных оформленных [**От склада**](/ispolzovanie/untitled)
* **Забор единичных заказов**. Единичный забор используется, если вам нужно забрать **один** заказ, оформленный по тарифу [От двери](/ispolzovanie/untitled) или [От склада](/ispolzovanie/untitled). В этом случае вам нужно указать номер накладной, для которой вызывается забор.&#x20;

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/Mt7YqkayY0nPETDBOm7z/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-01%20%D0%B2%2021.46.44.png)

#### Время вызова курьера

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

#### Точка отгрузки

Ваша точка отгрузки СДЭК (договор), от которого будет вызываться курьер. При смене точки отгрузки контактные данные в форме вызова курьера поменяются автоматически.

#### Телефоны для связи

Можно указать несколько контактных телефонов через `;`

#### Вес и габариты

Примерные вес и габариты отправлений, которые нужно забрать курьеру. Эти данные нужны СДЭК, чтобы понимать присылать ли вам пешего курьера, или нужна машина. Автоматически подставляются суммарные вес и габариты всех накладных в статусе `Создан`

#### Позвонить заранее

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


# Уведомления

Во вкладке **Уведомления** отображаются все созданные SMS и E-mail уведомления клиентам, их текущие статусы отправки, тип, предпросмотр отправленного текста, раздел редактирования [**Шаблонов**](/osnovnye-vozmozhnosti/uvedomleniya#shablony)

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/2J0kjhVVyjaF5bKPhziE/notifications.png)

### Фильтрация и сортировка <a href="#filtraciya-i-sortirovka" id="filtraciya-i-sortirovka"></a>

![](https://gblobscdn.gitbook.com/assets%2F-MWnBPTvqsDOTvJPBoGa%2F-MWtEZJMOblTh7g-zFmD%2F-MWtJPwB3DvCyPeTtwEi%2Fnotification_filter.png?alt=media\&token=2507fd4f-4840-4459-848c-4103cd3766de)

Пользователь может отфильтровать созданные уведомления по:

* статусу доставки СДЭК
* типу отправки (SMS или Email)
* статусу отправки
* фильтр по дате отправления
* поиск по полям

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

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/dFlWeTFnTTd5MJ1gnjtw/notification_sorting%20\(1\).gif)

### Шаблоны <a href="#shablony" id="shablony"></a>

Для управления шаблонами необходимо переключиться на вкладку `Шаблоны` в разделе `Уведомлений`

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/tqWPWruyb59r5pPgZBoL/templates.png)

Опции создания шаблонов доступны только после указания настроек SMS или Email-шлюза в [настройках приложения](/nastroika/uvedomleniya-klienta).

В противном случае пользователь получит соответсвующее уведомление.

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/daFDbSdFKXxWs7tIgi4h/notification_settings_required.png)

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

### Фильтрация и сортировка <a href="#filtraciya-i-sortirovka-1" id="filtraciya-i-sortirovka-1"></a>

![](https://gblobscdn.gitbook.com/assets%2F-MWnBPTvqsDOTvJPBoGa%2F-MWtKjr2JPaB9ASv7k-M%2F-MWtM-NBd7QJbPtuFd6J%2Ftemplate_filter.png?alt=media\&token=64dc206c-9c58-4a53-acea-766ff8addcc9)

Пользователь может отфильтровать созданные шаблоны по:

* статусу доставки СДЭК
* статусу шиблона (включен или выключен)
* типу отправки (SMS или Email)
* поиск по полям

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

### Управление шаблонами <a href="#upravlenie-shablonami" id="upravlenie-shablonami"></a>

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

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/lFaCXXYqUYeIIMThVwBx/templates_switch.png)

### Создание шаблона <a href="#sozdanie-shablona" id="sozdanie-shablona"></a>

![](https://gblobscdn.gitbook.com/assets%2F-MWnBPTvqsDOTvJPBoGa%2F-MWtNhWu8WZyzG2VWc9x%2F-MWtNrsPTK1nbwOeUZjZ%2Fcreate_template.png?alt=media\&token=93f2770b-3900-481d-8aae-28537e51be55)

Для создания шаблона необходимо указать:

1. название шаблона,
2. статус шаблона (включен или выключен)
3. документ, к которому применяется шаблона (заказ покупателя или отгрузка)
4. статус СДЭК, на который будет срабатывать шаблон

При создании шаблона для подстановки значений (например, сумма заказа, статус заказа, номер накладной) используйте язык шаблонизатора [Liquid](https://bytehand.yooogi.ru/nastroika/yazyk-shablonov-liquid) и подсказки `Языка Шаблонов`.

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/89C9dEXPLxn80QYKgW6x/liquid_lang.png)

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

Важно, чтобы по данному документу **уже** была созданная через приложение накладная **СДЭК**.

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/QzVx7NW2rQyUaJ2G4BvA/sms_template_preview%20\(1\).gif)


# Заключение договора

Для работы с приложением вам потребуется заключить договор с курьерской службой СДЭК. Алгоритм действий:

1. Для заключения договора со СДЭК необходимо отправить заявку на сайте в разделе «Заключить договор». Заполнить специальную форму <https://cdek.ru/zapolnit-anketu> и нажать кнопку ОТПРАВИТЬ.
2. На вашу почту в течение 30 минут поступит уведомление с номером принятой заявки и способах отслеживания ее состояния.
3. Ваша заявка будет передана менеджеру ответственного подразделения.
4. Назначенный сотрудник перезвонит вам в течение 1–2 рабочих дней для предоставления обратной связи.
5. Менеджер подготовит договор и отправит на согласование.
6. Подписанный договор в двух экземплярах будет направлен вам курьером в течение 3–4 рабочих дней. Дата и время доставки будут предварительно согласованы с вами курьером.
7. Вам необходимо подписать оба экземпляра договора, один экземпляр отправить обратно в СДЭК.
8. После получения подписанного договора вам на электронную почту поступит письмо с паролем для входа в Личный кабинет.

### Получение ключей API

Для работы приложения потребуются ключи API СДЭК. Запросить ключи можно **после заключения договора**, написав в свободной форме запрос на почту <integrator@cdek.ru>

{% hint style="info" %}
При запросе, важно указать, что вам нужны "боевые" ключи API СДЭК.
{% endhint %}


# Установка приложения

1. Зайдите в свой аккаунт МойСклад
2. Нажмите на название аккаунта в правом верхнем углу
3. В выпадающем меню нажмите на пункт `Приложения`
4. В открывшимся списке найдите [интеграцию со СДЭК](https://online.moysklad.ru/app/#apps?id=e3fa9bea-17d6-427e-b8bb-53ea58413622)
5. Нажмите [`Установить`](https://online.moysklad.ru/app/#apps?id=e3fa9bea-17d6-427e-b8bb-53ea58413622)&#x20;

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/meoqxZNKvCue9HV406m9/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-10-29%20%D0%B2%2017.33.11.png)

После установки приложения потребуется его настройка:

1. Указать боевые ключи API СДЭК или включить [демо-режим](/nastroika/accounty-sdek#demo-rezhim)
2. Указать телефон(ы) отправителя

{% hint style="info" %}
Без боевых ключей API вы можете протестировать работу приложения только в [демо-режиме](/nastroika/accounty-sdek#demo-rezhim) (с  техническими ограничениями)&#x20;

[Как запросить ключи API](/ustanovka/zaklyuchenie-dogovora#poluchenie-klyuchei-api)
{% endhint %}

### Удаление приложения

1. Зайдите в свой аккаунт МойСклад
2. Нажмите на название аккаунта в правом верхнем углу
3. В выпадающем меню нажмите на пункт `Приложения`
4. В открывшимся списке найдите интеграцию со СДЭК
5. Нажмите `Настроить`
6. В открывшемся окне нажмите `Удалить`

Стоит заметить, что при удалении приложения им **не удаляются** созданные доп. поля и справочники СДЭК, а так же информация добавленная в доп. поля документов (ваши созданные накладные останутся с вами).


# Оплата приложения

### Оплата приложения

Приложение платное. Стоимость - 1300 ₽ в месяц. Оплата производится через МойСклад.

Пользователям предоставляется бесплатный триальный период в течении 14 дней с момента установки. &#x20;

При оплате на год предоставляется скидка 20% - 12480 ₽ в год

### Приостановка приложения за неуплату

Если вы не оплачиваете приложение, оно приостанавливается на вашем аккаунте до момента оплаты.&#x20;


# Аккаунты СДЭК

### Описание &#x20;

Пользователь приложения, имеющий действующий договор со СДЭК, может добавить один и более аккаунт СДЭК. Каждый аккаунт можно привязать к конкретному складу МоегоСклада или к организации.

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/zc5nh70eyLc1I8ohD0yE/cdek_accounts.png)

{% hint style="warning" %}
Для корректной работы приложения вам понадобятся боевые ключи API СДЭК. Не имея заключенного договора со СДЭК, протестировать работу приложения можно только в демо-режиме (с существенными ограничениями)

Что такое [ключи API](/ispolzovanie/untitled) и [как их получить](/ustanovka/zaklyuchenie-dogovora).
{% endhint %}

#### Наименование точки

Ваше произвольное название для учетной записи. Эти данные не будут видны клиенту, Используется для выбора аккаунта СДЭК в [виджете](/osnovnye-vozmozhnosti/widget-prilozheniya) приложения.

#### Тип договора

В настоящее время доступен только один тип договора СДЭК: интернет-магазин.&#x20;

#### Демо-режим

Режим предназначен для ознакомления с приложением. Стоит учитывать, что функционал приложения в этом режиме ограничен в виду технических особенностей тестовых ключей API.&#x20;

Расчет ограничивается тарифом Экспресс-лайт, статусы накладных не обновляются, вызов курьера не работает, по накладным невозможно осуществить отправку и они не появляются в личном кабинете СДЭК.&#x20;

Все созданные накладные будут удалены спустя сутки.

#### Ключ и пароль API

Обязательное поле для заполнения.

Данные API доступа к вашему договору СДЭК. При наличии договора, [ключи API](/ispolzovanie/untitled) можно запросить по почте <integrator@cdek.ru> или в личном кабинете СДЭК в разделе Интеграции

{% hint style="danger" %}
Это **не** логин и пароль от личного кабинета СДЭК
{% endhint %}

{% hint style="info" %}
Разработчик приложения не выдает ключи API. Для этого обращайтесь по почте <integrator@cdek.ru> или в личном кабинете СДЭК в разделе Интеграции
{% endhint %}

#### Город отгрузки

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/PdjOjN81UQWX9ryMG5AV/choose-city-cdek.gif)

Обязательное поле для заполнения.

Город, откуда будут производится отправления. В выпадающем списке нужно выбрать нужный вариант. Если вы не нашли в списке нужный город - [обратитесь к разработчку приложения](/podderzhka).

#### Вариант отгрузки

Выбор варианта отгрузки. Исходя из данной настройки будет рассчитана цена и создана накладная в [виджете приложения](/osnovnye-vozmozhnosti/widget-prilozheniya) или при [автоматическом создании накладных](/osnovnye-vozmozhnosti/avtosozdanie-nakladnykh).

Следует заметить, что в виджете приложения имеется возможность [оперативного изменения варианта отгрузки](/osnovnye-vozmozhnosti/widget-prilozheniya/dannye-po-zakazu#variant-otgruzki).

&#x20;В СДЭК заказы можно отгружать двумя вариантами:

* **От склада**. Данный метод подразумевает, что вы сами передаете отправления на склад СДЭК. Передать отправления на склад СДЭК можно двумя способами:
  * заказав консолидированный забор со своего склада - через [вызов курьера СДЭК](/osnovnye-vozmozhnosti/vyzov-kurera#podacha-zayavki-na-vyzov-kurera)&#x20;
  * вы сдаете отправления сами в одном из ПВЗ СДЭК.
* **От двери**. Данный метод подразумевает вызов курьера на каждое созданное отправление. У данной опции имеется дополнительная настройка `Автоматически вызывать курьера`, которая передается в [виджет приложения](/osnovnye-vozmozhnosti/widget-prilozheniya). Если отметить, то на каждую созданную накладную **От Двери** будет вызван курьер.

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/iSqgSpv5E7fRePRBEIhd/chrome-capture%20\(6\).gif)

Отгрузку "от двери" стоит использовать при единичных отправлениях, в любых других случаях дешевле использовать отгрузку "от склада" с консолидированным забором через вызов курьера. Таким образом, например, у вас будет N накладных по режиму доставки склад-склад / склад - дверь и 1 накладная на забор груза по тарифу дверь - склад.

Подробнее про тарифы, режимы доставки и схемы работы со СДЭК читайте в разделах [Термины СДЭК](/ispolzovanie/untitled) и [Общие схемы работы со СДЭК](/ispolzovanie/obshie-skhemy-raboty-so-sdek).

#### Время вызова курьера

Интервал 3 часа.

Здесь и далее указанные данные к вызову курьера будут использованы при автоматическом вызове курьера при создании накладных **от двери** и в форме оформления [заявки на вызов курьера](/osnovnye-vozmozhnosti/vyzov-kurera#podacha-zayavki-na-vyzov-kurera) (консолидированный забор)

#### Адрес вызова курьера

Адрес, по которому нужно забрать отправление или консолидацию.

#### Контактное лицо вызова курьера

Контактное лицо, ответственное за сдачу посылок в СДЭК.

#### Телефон контактного лица для вызова курьера

Можно указать несколько контактных телефонов через `;`

#### Комментарий к вызову курьера

Желательно объяснить курьеру как вас найти, предупредить, если курьеру понадобится документы для пропуска и т.д.

#### Название продавца

Юридическое название компании продавца.&#x20;

#### Адрес продавца

Физический адрес компании продавца.

#### Телефон продавца

Актуальный телефон компании продавца.

#### Название отправителя

Торговое название отправителя. Например, ЛучшийМагазин.рф

#### Контактное лицо отправителя

Имя менеджера, с которым СДЭК будет контактировать по доставке отправления.

#### Адрес отправителя

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

#### Телефоны отправителя

Телефон менеджера, с которым СДЭК будет контактировать по доставке отправления.

#### Привязка аккаунта

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/xa8djK8x7oGB2CibkMeY/attach-account.gif)

Данная настройка позволяет автоматически выбирать нужный аккаунт СДЭК при расчете и создании накладных через [виджет](/osnovnye-vozmozhnosti/widget-prilozheniya) и через [автоматическое создание накладных](/osnovnye-vozmozhnosti/avtosozdanie-nakladnykh).

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

Например, использовать `Первый аккаунт СДЭК` для заказов покупателей  со `Склада 1`

#### Добавление еще одно аккаунту СДЭК

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/DXrGkLnVxTYyKJZzj9cf/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-03%20%D0%B2%2017.14.05.png)

Чтобы добавить еще один аккаунт СДЭК нажмите на ссылку `Добавить еще одну точку`


# Вес и габариты

### Описание

Данные настройки отвечают за корректную передачу значений веса и габаритов из МоегоСклада в СДЭК. На основании этих настроек будет рассчитаны параметры отправления в [виджете приложения ](/osnovnye-vozmozhnosti/widget-prilozheniya)и при [автоматическом создании накладных](/osnovnye-vozmozhnosti/avtosozdanie-nakladnykh).

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/D8LkBlBM8mdpwJCKK54u/ves-i-gabarity2.png)

### Учитывать габариты и вес

Пользователь может выбрать один из двух вариантов расчета веса и габаритов:

* **Игнорировать габариты и вес позиции, даже если они установлены в МойСклад**. В этом случае для расчета стоимости будут использованы значения среднего веса и габаритов из приложения, игнорируя данных из МоегоСклада.
* **Использовать габариты и вес позиции, если они установлены в МойСклад**. В этом случае, приложение будет брать значения веса и габаритов из МоегоСклада, если они имеются в карточке товара (поля Вес и Объем, см скриншот ниже).&#x20;

![Карточка товара в МойСклад с указанными весом и объемом](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/swFEvRwZumbSY1YUd31U/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-03%20%D0%B2%2015.55.29.png)

Первый вариант подойдет пользователям, которые не заполняли поля вес и объем в карточках товаров. Если у вас много однотипного товара, вы можете использовать приложение указав средний вес и габарит на позицию/наименование/заказ. Если у вас много разношерстного товара, и параметры товаров меняются значительно, данный вариант не подходит, и требуется рассматривать второй.&#x20;

Если для большинства позиций у вас указаны вес и объем, второй вариант предпочтительней, т.к. позволяет максимально точно рассчитать стоимость доставки. При отсутствии какого-либо из параметров у товара (например не задан объем) будет использовано значение по умолчанию из приложения.&#x20;

### Единицы измерения веса и объма в МоемСкладе

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/jE7HulCEAJOHaOPnhnJE/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-03%20%D0%B2%2016.03.49.png)

Если выбран вариант **Использовать габариты и вес позиции, если они установлены в МойСклад**, пользователю предлагается указать единицы измерения, в которых эти значения прописаны в карточке товара.&#x20;

Для веса:

* мг
* г
* кг

Для объема:&#x20;

* мм^3
* см^3
* м^3

При расчете и при передачи значений в СДЭК все параметры преводятся приложением к `граммам` и `см^3`.&#x20;

### Средний вес и габарит

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/X8gF6pqDF9d2eaBpOtwc/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-03%20%D0%B2%2016.10.33.png)

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

{% hint style="info" %}
СДЭК не принимает пустые значения веса и габарита для позиций. Из этого следует, что вес и габарит **для каждой позиции** будет задан пользователем или рассчитан исходя из настроек.
{% endhint %}

Пользователь может задать средний вес на выбор для:

* **Единицы позиции**. Например, если вы задали вес товара для единицы позиции 100гр, в заказе у вас 6 товарных наименований без веса по 5 шт (единицы позиции) каждой,  значит расчет будет произведен для 3000гр.&#x20;
* **Всего заказа**. Если вы указываете средний вес на заказ 3000гр, то приложение поделит этот вес на количество позиций. Например, заказе у вас 3 товарных наименования по 1шт, но у лишь у одного нет значения веса - приложение посчитает вес этой позиции как 3000 гр / 3 = 1000гр.&#x20;
* **Товарного наименования**. Например, если вы задали вес товара для товарного наименования 100гр, в заказе у вас 6 товарных наименований без веса по 5 шт (единицы позиции) каждой, значит расчет будет произведен для 600гр.

Все вышесказанное применимо в равной степени и к габаритам.&#x20;

Указывая настройки веса и габаритов учитывайте, что СДЭК рассчитывает стоимость доставки по наибольшему из двух весов: физическому или объемному (Ш\*Д\*В/5000см ). Подробнее читайте в [терминах СДЭК](/ispolzovanie/untitled).


# Общие настройки

### Описание

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

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/GOz7tXOCJCzUCmVmi9mI/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-03%20%D0%B2%2016.44.37.png)

### Товары к отгрузке&#x20;

Здесь пользователь приложения выбирает какие товары из заказа или отгрузки попадут в накладную СДЭК.&#x20;

* все товары
* доступные
* в остатке
* неотгруженные
* неотгруженные доступные
* неотгруженные в остатке
* зарезервированные

Данная опция может быть удобна в случаях:

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

Опция является предустановкой значения для [виджета](/osnovnye-vozmozhnosti/widget-prilozheniya/dannye-po-zakazu#tovary-k-otgruzke)&#x20;

### Отображать товары в накладной

Пользователь может выбрать как выгружать товары в накладную СДЭК:

* все позиции (т.е. каждая позиция будет указан в накладной СДЭК в отдельно)
* единой позицией с общим наименованием

Последняя опция носит скорее "экологический характер", т.к. при большом количестве позиций не всегда имеет смысл их пропечатывать в накладной СДЭК, растягивая на несколько листов. В этом случае в накладную выгрузится одна позиция с заданным наименованием (например, "Товары в ассортименте"), с общим весом, габаритом, и стоимостью.&#x20;

### Добавлять услуги в накладную

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

### Добавлять услугу доставки СДЭК в документ

Если опция включена, **после создания** накладной, приложение добавит в документ (заказ или отгрузку) услугу "Доставка СДЭК" с рассчитанной стоимостью доставки.

### Валюта расчетов

По умолчанию - российские рубли.

Позволяет пользователям из Казахстана и Беларуси изменить валюту расчетов из российских рублей в национальную.

### Ставка НДС за ед. товара

Опционально можно указать фиксированную ставку НДС, которая будет применяться ко всем позициям в накладной СДЭК.&#x20;

Если в МоемСкладе у вас задана ставка НДС для каждой позиции - вы можете включить опцию "Брать из МоегоСклада", в этом случае в накладную будут транслироваться данные из МоегоСклада.

### Ставка НДС за доставки СДЭК

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

### Подписка на уведомления

Иногда сервер СДЭК бывает перегружен, и накладные становятся доступны для печати, спустя 10-15 минут после создания (обычно при использовании версии API 1.5).&#x20;

Эта опция позволяет подписаться на уведомления, которые будут приходить прямо в браузер (web push уведомление), когда накладная будет готова для скачивания. Нужно перейти по ссылке, нажать кнопку 'Подписаться' и разрешить сайту присылать уведомления.

Также уведомления будут удобны, при оформлении накладных в фоновом режиме, при [автоматическом создании накладных](/osnovnye-vozmozhnosti/avtosozdanie-nakladnykh)

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/gm0F1bbAI4oZyzzbco6H/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-30%20%D0%B2%2014.38.24.png)

Только для пользователей браузера **Google Chrome**

### Используемая версия API СДЭК

Версия API СДЭК, используемая при оформлении заказа. Приложение поддерживает создание накладных по обоим протоколам (2.0 и 1.5)

Опция позволяет выбрать используемую версию API СДЭК. Версия 1.5 более стабильная. Накладная оформляется мгновенно, но могут наблюдаться задержки до 10 минут между созданием накладной и возможностью ее распечатать. Версия 2.0 находится в разработке, накладная оформляется чуть дольше, чем в 1.5 (около 10 секунд), но метод печати доступен сразу же. Переключайте эту опцию, только если наблюдаются проблемы в какой-то из версий API.

По умолчанию используемая версия API - 2.0


# Страховка и наценки

### Описание

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

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/duUU0l4eqWFSJhZQi7hC/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-03%20%D0%B2%2017.09.22.png)

### Страховка от суммы

Выбор базы для расчета страховки. По умолчанию страховка считается от полной стоимости заказа.&#x20;

Страховка является обязательной для всех отправлений с объявленной стоимостью и равна 0.75% ([пруф](https://global.cdek.ru/faq/strakhovanie)). Страховка учитывается в стоимости доставки по формуле: `Стоимость доставки = Расчетная стоимость по тарифу + Стоимость заказа * 0.75%`

Опционально доступны варианты:

* страховка от полной суммы заказа
* процент от суммы заказа
* фиксированная стоимость заказа

Под стоимостью заказа понимается объявленная стоимость всех позиций заказа. Именно с этой суммы СДЭК берет страховку в размере 0.75% и эту же сумму вернет вам, если заказ будет утерян или поврежден в процессе доставки. &#x20;

### Процент страховки

Вы можете изменить процент страховки, который учитывается в стоимости доставки, но стоит заметить, что это лишь изменит стоимость доставки для ваших клиентов, СДЭК с вас будет в любом случае удерживать 0.75% от стоимости заказа.  Подробнее читайте в [Терминах СДЭК](/ispolzovanie/untitled)

### Наценка на стоимость доставки

Опционально доступно два варианта:&#x20;

* абсолютная наценка на стоимость доставки
* процентная наценка

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

### Наценка на общую стоимость

Опционально доступно два варианта:&#x20;

* абсолютная наценка на общую стоимость
* процентная наценка

Процентная наценка будет рассчитана по формуле:

`Наценка = (Стоимость доставки + База стоимости ) * Процент / (1 - Процент)`

`Стоимость доставки = Стоимость доставки + Наценка` &#x20;

Опцию удобно использовать, если вы хотите включить процент за РКО от СДЭК в стоимость доставки (3%).


# Опции СДЭК

### Описание

Опции СДЭК, которые будут учитываться при создании накладной.

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/e7VxKcaiYUxV19GFWSMY/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-03%20%D0%B2%2017.41.21.png)

### Частичная доставка

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

### Примерка на дому

Позволяет клиенту осуществить примерку перед покупкой.&#x20;

### Осмотр вложимого

Позволяет клиенту ознакомиться с содержимым отправления перед оплатой. &#x20;

### Опасный груз

Платная опция для опасных грузов. Не включена в тариф стоимости доставки.&#x20;


# Тарифы

### Описание

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

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/9osSBDIQlbBbtQ0MwiM0/tarify-sdek.png)

### Тариф Посылка

Один из самых популярных тарифов СДЭК для интернет-магазинов и площадок дистанционной торговли. Стоимость доставки от 100р, вес отправления до 30кг. Регионы доставки: Россия, Казахстан, Беларусь, Армения, Узбекистан

[Описание тарифа на сайте СДЭК](https://cdek.ru/parcel)

### Тариф Экономичная посылка

Экономичная доставка для интернет-магазинов. Существенно дешевле чем тариф Посылка на дальних расстояниях, но с увеличенными сроками доставки. Стоит заметить, что тариф Экономичная посылка работает преимущественно **между** городами центральной части России и городами Сибири и Дальнего Востока. Вес отправления до 50кг. Регионы доставки: Россия

[Описание тарифа Экономичная посылка на сайте СДЭК](https://cdek.ru/economic-parcel)

### Тариф Экспресс-лайт

Экспресс доставка для бизнеса и частных лиц. Зачастую дороже тарифа Посылка с меньшими сроками доставки. Вес отправления до 30кг. Регионы доставки: Россия, Беларусь, Казахстан, Узбекистан, Армения.

{% hint style="info" %}
С ноября 2020 года тариф Экспресс-лайт и Экспресс Тяжеловесы слиты в один тариф Экспресс.&#x20;
{% endhint %}

[Описание тарифа Экспресс-лайт на сайте СДЭК](https://cdek.ru/express-light)

### Тариф Магистральный Экспресс

Экономичная наземная доставка. Регионы доставки: Россия, Казахстан, Киргизия, Беларусь

[Описание тарифа Магистральный Экспресс на сайте СДЭК](https://cdek.ru/mainexpress)

### Тариф Магистральный Супер-Экспресс

Экономичная наземная доставка к определенному часу. Регионы доставки: Россия, Казахстан, Киргизия, Беларусь

[Описание тарифа Магистральный Супер-Экспресс на сайте СДЭК](https://cdek.ru/main-superexpress)

### Тариф Тяжеловесы

Экспресс доставка тяжелых и негабаритных грузов. Вес отправления от 30кг. Регионы доставки: Россия, Беларусь, Казахстан, Армения, Киргизия, Узбекистан.

[Описание тарифа Экспресс-тяжеловесы на сайте СДЭК](https://cdek.ru/hard-express)

### Сравнительная таблица тарифов СДЭК&#x20;

<https://cdek.ru/online-stores/tariffs>


# Отображение тарифов

### Описание

Данный раздел настроек позволяет вам кастомизировать отображение тарифов в [виджете](/osnovnye-vozmozhnosti/widget-prilozheniya)

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/rpiFc308r5U0g1d6uc9W/varianty-otobrazheniya-tarifov.png)

### Округлять стоимость доставки

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

### Добавить дни к сроку доставки

Добавляет N-дней к расчетному сроку доставки. Вы можете далее использовать это значение для передачи клиенту ориентировочной даты доставки. Установить передачу сроков доставки в доп. поле документа, можно [в настройках приложения для документов](/nastroika/translyaciya-statusov)

### Скрывать сроки доставки

Скрывает [сроки доставки в виджете](/osnovnye-vozmozhnosti/widget-prilozheniya/raschet-ceny#vybor-tarifa). Исключительно косметическая опция.

### Скрывать название тарифа

Скрывает [название тарифа в виджете](/osnovnye-vozmozhnosti/widget-prilozheniya/raschet-ceny#vybor-tarifa). Исключительно косметическая опция.

### Порядок отображения тарифов

Вы можете выбрать порядок отображения тарифов в [виджете приложения](/osnovnye-vozmozhnosti/widget-prilozheniya/raschet-ceny#vybor-tarifa). По умолчанию тарифы отсортированы по стоимости доставки (сначала самые дешевые). Вы можете выводить все тарифы, оставить только один или только два самых дешевых.


# Уведомления клиента

Данный раздел настроек позволяет вам задать настройки SMS и E-mail шлюзов для отправки уведомлений клиентам.

## Подключение SMS-шлюза Bytehand

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/niHqDByuVkiXUejeShD3/sms_connect.png)

Перед авторизацией, перейдите в [Bytehand.com](https://www.bytehand.com/?r=cd85447513f6368d) и создайте аккаунт.

Для подключения нажмите на кнопку "Авторизоваться в Bytehand" - вы попадете на страницу авторизации / регистрации в сервисе Bytehand.&#x20;

После входа вы увидите окно запроса доступа к аккаунту

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/OlfOZVria9qUMaI7biFA/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202021-03-29%20%D0%B2%2001.39.33.png)

После предоставление доступа приложению, вы можете включить уведомления по SMS и выбрать подпись отправителя. Подробнее читайте в [документации Bytehand](https://bytehand.yooogi.ru/)

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/ZLJjiHMvEp3CNVsW3uKh/sms_connected.png)

### Подключение E-mail шлюза через SMTP

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/m5dEZ9ygWmQ7tcQ59sM1/email_connected.png)

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

Как правило, для настройки достаточно стандартных данных подключения к SMTP-серверу для почтовых программ:

1. Адрес SMTP-сервера
2. Порт подключения (как правило, это 443, 465  995)
3. Тип протокола (SSL или TLS)
4. Логин почтового ящика&#x20;
5. Пароль почтового ящика

[Пример из документации настройки подключения к SMTP-серверу для почтовых ящиков на Яндексе](https://yandex.ru/support/mail/mail-clients/others.html#smtpsetting)

Корректность введенных данных можно проверить, нажав кнопку "Проверить соединение"


# Настройки приложения для документов

### Описание

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

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/X7mIvPL8A58U49gSPBZ8/widget-cdek-in-documents.png)

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

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/ZOJTFEUsNvHAoEJNJMY9/change-document-moy-sklad.gif)

### Имя клиента по умолчанию

Определяет для документа откуда брать имя получателя. Опционально доступно три варианта:&#x20;

* наименование контрагента
* контактное лицо контрагента
* из указанного доп. поля документа

Будет использовано как значение по умолчанию в [виджете приложения](/osnovnye-vozmozhnosti/widget-prilozheniya/dannye-po-zakazu#imya-poluchatelya) и при автоматическом создании накладных.&#x20;

### Телефон клиента по умолчанию

Как и в пункте выше, определяет для документа откуда брать телефон получателя. Опционально доступно четыре варианта:&#x20;

* телефон из карточки контрагента
* контактное лицо контрагента
* из указанного доп. поля документа
* все найденные телефоны

При выборе последней опции в накладную попадут все телефоны из трех предыдущих пунктов.

Будет использовано как значение по умолчанию в [виджете приложения](/osnovnye-vozmozhnosti/widget-prilozheniya/dannye-po-zakazu#imya-poluchatelya) и при автоматическом создании накладных.&#x20;

### Адрес клиента по умолчанию

Определяет для документа откуда брать адрес получателя. Опционально доступно три варианта:&#x20;

* наименование контрагента
* контактное лицо контрагента
* из указанного доп. поля документа

Будет использовано как значение по умолчанию в [виджете приложения](/osnovnye-vozmozhnosti/widget-prilozheniya/dannye-po-zakazu#imya-poluchatelya) и при автоматическом создании накладных.&#x20;

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

{% hint style="warning" %}
Важно заметить, что город определяется из адреса в МоемСкладе и сопоставляется с базой городов СДЭК.  Правильность распознавание города из адреса не гарантируется (хотя и валидируется через сторонние сервисы), поэтому при оформлении стоит уделять отдельное внимание этому полю.
{% endhint %}

### Добавить номер накладной в доп. поле

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

Поле `Накладная СДЭК` автоматически создается для `Заказа покупателя` приложением при установке. При этом, вы можете транслировать номер накладной в любое другое текстовое доп. поле документа на свое усмотрение.

{% hint style="warning" %}
В настоящее время, для корректной работы данной опции, а так же опций описаных ниже, после создания накладной нужно выходить из Заказа покупателя / Отгрузки через кнопку **Закрыть**. При нажатии на кнопку Сохранить, данные записанные в доп. поле приложением **затираются** данными из открытого пользователем документа. В ближайшем будущем, после появления в API МоегоСклада инструмента для обновления данных в открытом документе в режиме реального времени, этот недостаток будет убран. Сейчас эта возможность находится в разработке.
{% endhint %}

### Добавить ссылку на накладную в доп. поле

Опция позволяет транслировать ссылку на накладную СДЭК в доп. поле документа. При повторном создании накладной для одного и того же документа, ссылка будет заменена новой.&#x20;

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

### Добавить статус накладной в доп. поле

Трансляция текущего статуса накладной в доп. поле документа. При установке приложение добавляет в МоемСкладе справочник `Статусы СДЭК` и создает доп. поле документа `Статус СДЭК`

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/5q7ofwaNmmvjmiyDhM8J/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-03%20%D0%B2%2020.20.38.png)

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/Ay58fsva1yACekrLg3QL/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-03%20%D0%B2%2020.22.06.png)

Вы можете транслировать статус в другое доп. поле документа на свое усмотрения, но доп. поле должно представлять собой справочник `Статусы СДЭК`

### Добавить общую стоимость заказа в доп.поле

Приложение может транслировать общую стоимость заказа (стоимость товаров + стоимость доставки) в доп. поле документа МойСклад. Тип доп. поля `строка`

### Добавить наложенную стоимость заказа в доп.поле

Приложение может транслировать наложенную стоимость заказа (наложенная стоимость товаров + стоимость доставки) в доп. поле документа МойСклад. Тип доп. поля `строка`

### Добавить стоимость доставки в доп.поле

Приложение может транслировать стоимость доставки в доп. поле документа МойСклад. Тип доп. поля `строка`

### При статусе накладной "Вручен"

Приложение может изменять статус документа в МоемСкладе при получении статуса **Вручен** от СДЭК по накладной для данного документа. Является конечным статусом, означающим доставку до клиента.

### При статусе накладной "Не вручен"

Приложение может изменять статус документа в МоемСкладе при получении статуса **Не вручен** от СДЭК по накладной для данного документа. Является конечным статусом, означающим возврат от клиента.

### При любом статусе накладной, кроме "Вручен" и "Не вручен"

Приложение может изменять статус документа в МоемСкладе при получении статуса отличного от **Вручен** и **Не Вручен** от СДЭК по накладной для данного документа. Данные статусы являются промежуточными, по факту означают, что заказ **отгружен** в СДЭК и находится в пути.

### При статусе Принят на склад до востребования

Приложение может изменять статус документа в МоемСкладе при получении статуса отличного от **Принят на склад до востребования** от СДЭК по накладной для данного документа. Данные статус означает, что заказ прибыл в ПВЗ и доступен для самовывоза. Можно использовать для дополнительного информирования клиента.

### Комментарий накладной берется из

Определяет способ трансляции комментария в накладную СДЭК.  Возможна трансляция из:

* комментария к документу
* доп. поля документа
* фиксированный статичный текст
* фиксированный статичный текст + комментарий к документу.&#x20;

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


# Автоматическое создание накладных

## Описание

Помимо оформления накладных через [виджет](/osnovnye-vozmozhnosti/widget-prilozheniya), приложение позволяет оформлять накладные в фоновом режиме, без участия человека. Автоматическое создание накладных СДЭК доступно как для `Заказа покупателя` так и для `Отгрузки`

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

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/DlTmtsz0xYLc4xwMf0wn/autozagruzka.png)

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

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/ZOJTFEUsNvHAoEJNJMY9/change-document-moy-sklad.gif)

###

### Автозагрузка накладных

Опция определяет включено ли автоматическое создание накладных для документа.&#x20;

### Установка справочиников в документ

Создает 4 дополнительных поля для документа типа `Справочник`

* тариф СДЭК
* режим доставки СДЭК
* ПВЗ СДЭК
* наложенный платеж СДЭК

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

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

### Тип события

Определяет на какое событие будет создаваться накладная СДЭК. Доступно два варианта:

* **создание документа** (например, создание заказа покупателя/отгрузки)
* **обновление документа** (например, изменение какого-либо поля или доп. поля заказа покупателя/отгрузки)

### Триггер на изменение поля

Для варианта события `Обновление документа` доступен выбор триггера. Пользователю предлагается выбрать тип изменения документа, на которое будет реагировать приложение и создавать накладную СДЭК. В общем случае можно разделить типы триггеров на 3 части:

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

### Тариф по умолчанию

Определяет тариф, по которому будет создана накладная. Возможно 4 варианта:

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

<div align="center"><img src="https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/XOqB6gvYvb2ZHkNnXFhq/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-29%20%D0%B2%2015.57.22.png" alt=""></div>

* **Выбирать из справочника**. Нужно [установить справочники](/nastroika/avtomaticheskoe-sozdanie-nakladnykh#ustanovka-spravochinikov-v-dokument) в документ и указать название справочника "Тарифы СДЭК".&#x20;

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/umUf41pnsf6TuEvwFKTm/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-29%20%D0%B2%2016.01.23.png)

&#x20;        В этом случае пользователь должен выбрать необходимый    тариф в доп. поле документа **заранее**.

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/nV1YSInTflEOym84Oehr/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-29%20%D0%B2%2016.03.56.png)

### Режим доставки по умолчанию

Определяет [режим доставки](/ispolzovanie/untitled), по которому будет создана накладная. Возможно 6 вариантов:

* **До двери**. Накладная будет оформлена строго до двери. Если у контрагента не указан адрес, или в городе доставки нет доставки до двери - создание закончится неудачей.
* **До двери (если адрес не указан, то ПВЗ)**. Накладная будет оформлена до двери, если указан адрес и в городе есть доставка до двери. В противном случае будет оформлена доставка до ПВЗ.
* **До двери (если стоимость доставки меньше, чем ....)**. Накладная будет оформлена до двери, если указан адрес и в городе есть доставка до двери, а стоимость доставки меньше, чем указанная пользователем.
* **До склада**. Накладная будет оформлена строго до склада. Если в городе получателя отсутствует ПВЗ, создание накладной закончится неудачей.
* **До склада (если ПВЗ в городе нет, до двери)**. Накладная будет оформлена до склада, если в городе получателя присутствует ПВЗ, в противном случае - оформляется накладная до двери.
* **Выбирать из справочника**. Нужно [установить справочники](/nastroika/avtomaticheskoe-sozdanie-nakladnykh#ustanovka-spravochinikov-v-dokument) в документ и указать название справочника "Режим доставки СДЭК".&#x20;

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/IyFLz6H7U8YdDR7RnHSJ/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-29%20%D0%B2%2016.24.19.png)

&#x20;       В этом случае пользователь должен выбрать необходимый    режим доставки в доп. поле документа **заранее**.&#x20;

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/pJI3MJ6XldVoYsBzwlPq/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-29%20%D0%B2%2016.23.39.png)

### Выбор ПВЗ по умолчанию

Определяет ПВЗ в который будет создана накладная, если выбран режим доставки До склада. Возможно 2 варианта:

* **Ближайший ПВЗ к адресу получателя**. В этом случае приложение найдет ближайший ПВЗ к адресу контрагента.
* **Выбирать из справочника**. Нужно [установить справочники](/nastroika/avtomaticheskoe-sozdanie-nakladnykh#ustanovka-spravochinikov-v-dokument) в документ и указать название справочника "ПВЗ СДЭК".&#x20;

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/jWNvxoLGSyipIHbbgA2N/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-29%20%D0%B2%2016.47.51.png)

&#x20;        В этом случае пользователь должен выбрать необходимый ПВЗ в доп. поле документа **заранее**.  &#x20;

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/5IWJnxgOXurCPlbpDaV8/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-29%20%D0%B2%2016.47.31.png)

### Наложенный платеж по умолчанию

Определяет будет ли включен наложенный платеж для накладной. Возможно 4 варианта:

* **Всегда включен**. Наложенный платеж будет включен для накладной. Если прием наложенного платежа недоступен в городе получателя, и не включена опция "[Отправлять без Наложенного платежа, если он недоступен в городе получения](/nastroika/avtomaticheskoe-sozdanie-nakladnykh#otpravlyat-bez-nalozhennogo-platezha-esli-on-nedostupen-v-gorode-polucheniya)", создание накладной закончится неудачей.
* **Всегда выключен**. Накладная будет создана без наложенного платежа.
* **Включен, если не оплачен**. Накладная будет создана с наложенным платежом, если сумма входящих платежей по документу меньше суммы документа. Если прием наложенного платежа недоступен в городе получателя, и не включена опция "[Отправлять без Наложенного платежа, если он недоступен в городе получения](/nastroika/avtomaticheskoe-sozdanie-nakladnykh#otpravlyat-bez-nalozhennogo-platezha-esli-on-nedostupen-v-gorode-polucheniya)", создание накладной закончится неудачей.
* **Выбирать из справочника**. Нужно [установить справочники](/nastroika/avtomaticheskoe-sozdanie-nakladnykh#ustanovka-spravochinikov-v-dokument) в документ и указать название справочника "Оплата СДЭК".&#x20;

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/9dF6papdv5GOHPasDuP5/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-29%20%D0%B2%2017.11.18.png)

&#x20;        В этом случае пользователь должен выбрать вариант наложенного платежа в доп. поле документа **заранее**.  &#x20;

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/SkBllIZZa2VcAmtTaeiX/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-29%20%D0%B2%2017.11.43.png)

### Отправлять без Наложенного платежа, если он недоступен в городе получения

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

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/FryrVu3c6vpSugZygsp2/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-09-29%20%D0%B2%2017.14.21.png)


# Правила доставки

### Описание

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

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/Cv5ItC814ToHurPrldV9/pravila-dostavki-cdek.png)

Вы можете задать правила расчета стоимости доставки как для курьерской доставки (до двери), так и до ПВЗ (до склада).


# Термины СДЭК

### Ключи API

Ключи API используются для функционирования приложения и выдаются отдельно на каждый договор со СДЭК. Для работы приложения нужно запросить "боевые ключи" по почте <integrator@cdek.ru> или в личном кабинете СДЭК в разделе Интеграции

{% hint style="warning" %}
Вам необходимо иметь подписанный договор со СДЭК
{% endhint %}

### Тарифы СДЭК

СДЭК предоставляет несколько тарифов для разных категорий пользователей. Самые популярные доступны в приложении, в разделе [Тарифы](/nastroika/tarify). Стоит учитывать, что список тарифов может отличаться от договора к договору, поэтому перед включением тарифов в настройках приложения стоит узнать у менеджера СДЭК или в личном кабинете СДЭК, какие из них доступны конкретно для вас.

### Режим доставки

Существует 4 режима доставки

* склад-склад
* склад-дверь
* дверь-склад
* дверь-дверь

**Дверь** - означает курьерскую доставку или забор от клиента.&#x20;

**Склад** - доставку в ПВЗ или отгрузку от склада СДЭК

В большинстве случаев вам подойдут режимы склад-склад и склад-дверь с [заказом консолидированного забора](/osnovnye-vozmozhnosti/vyzov-kurera) до склада СДЭК.

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

### Наложенный платеж

Наложенный платеж определяет будет ли взыматься оплата с клиента за вложенный товар. Денежные средства в последствии перечисляются СДЭКом на ваш расчетный счет. Стоит учитывать, что расчетно-кассовое обслуживание от СДЭК - платное, в среднем стоит 3% от суммы наложенного платежа. Подробнее уточняйте у ваших менеджеров СДЭК.

### Объемный вес

СДЭК производит расчет по наибольшему из двух весов: физическому или объемному. Объемный вес рассчитывается исходя из значения Д\*Ш\*В/5000. Например, если у вас отправление 1кг 20\*30\*20см - то физический вес будет 1кг, объемный 20\*30\*20/5000 = 2.4кг. СДЭК выставит вам счет из расчета доставки 2.4кг. [Информация на сайте СДЭК](https://global.cdek.ru/faq/vse-o-dostavke)

### Страхование отправлений

СДЭК страхует все отправления с [объявленной стоимостью](/osnovnye-vozmozhnosti/widget-prilozheniya/dannye-po-zakazu#stoimost-zakaza). Регулировать объявленную стоимость можно в [настройках приложения](/nastroika/strakhovka-i-nacenki#strakhovka-ot-summy) и непосредственно в [виджете приложения](/osnovnye-vozmozhnosti/widget-prilozheniya/dannye-po-zakazu#stoimost-zakaza).

Стоимость страхования - 0.75% от объявленной стоимости. Эта сумма включена в стоимость доставки при расчете через приложение. В настройках приложения вы можете [изменить этот процент ](/nastroika/strakhovka-i-nacenki#procent-strakhovki)(например, если хотите поделить с клиентом стоимость страхования).


# Общие схемы работы со СДЭК

Раздел дополняется.


# Частые вопросы

### Номер накладной / Ссылка на накладную не записываются в доп. поле после создания накладной

В настоящее время, для корректной работы данных опций после создания накладной нужно выходить из `Заказа покупателя` / `Отгрузки` через кнопку **Закрыть**. При нажатии на кнопку Сохранить, данные записанные в доп. поле приложением затираются данными из открытого пользователем документа. В ближайшем будущем, после появления в API МоегоСклада инструмента для обновления данных в открытом документе в режиме реального времени, этот недостаток будет убран. Сейчас эта возможность находится в разработке.

### Данные габаритов в виджете отличаются от данных указанных мной в настройках приложения &#x20;

Например в настройках вы указали 35 х 35 х 30 см

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/JCqbYIwXzJwOwHWUaVkj/22.png)

Но в виджете 33.2 х 33.2 х 33.2 см

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/DXz90atcM5vW1ElCYuhq/11.png)

СДЭК производит расчет по наибольшему из двух весов: физическому или объемному. Объемный вес рассчитывается исходя из значения Д\*Ш\*В/5000. Например, если у вас отправление 1кг 20\*30\*20см - то физический вес будет 1кг, объемный 20\*30\*20/5000 = 2.4кг. СДЭК выставит вам счет из расчета доставки 2.4кг. [Информация на сайте СДЭК](https://global.cdek.ru/faq/vse-o-dostavke)<br>

![](https://content.gitbook.com/content/X6DMq1q6Vcg2Ds3aFIFp/blobs/2bu2qKMW2Wv8PFgQ0rXs/%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202020-12-07%20%D0%B2%2000.31.04.png)

\
Так как в МоемСкладе по умолчанию доступно только поле **объем** в карточке (без грануляции до Д\*Ш\*В), все **расчеты производятся с объемами**. Далее из суммы объемов позиций вычисляется грань куба, по которой производится расчет.&#x20;

* 33.2 х 33.2 х 33.2 = 36594 см3  ( 36594 / 5000 = 7.31кг объемный вес)
* 35 х 35 х 30 = 36750 см3  (36750 / 5000 = 7.35кг объемный вес)&#x20;

\
40 гр разницы объемного веса в результате округления не влияют на стоимость отправления.\
Разница получается из-за округления приложением кубического корня до десятых сантиметра (условно при вычислении корня из 36750 см3 грань была бы 33.24, после округления 33.2). Расчет стоимости будет корректным в обоих случаях.


# Поддержка

Информация о разработчике

Полное наименование на русском языке: Индивидуальный предприниматель Потапов Денис Александрович

ОГРН 316501200052321 ИНН 501210739820

Юридический адрес: Московская область, г. Балашиха, мкр. Железнодорожный, улица Пионерская, дом 31, квартира 68

Банковские реквизиты:

р/с 40802810800005358057 в АО "ТИНЬКОФФ БАНК"

БИК 044525974

к/с 30101810145250000974

### Документы <a href="#dokumenty" id="dokumenty"></a>

[Договор оферта](https://cdek-ms.ru/files/oferta.pdf)

[Утвержденные тарифы](https://cdek-ms.ru/files/tarifs.pdf)

[Условия обработки персональных данных](https://cdek-ms.ru/files/privacy.pdf)

### Контакты <a href="#kontakty" id="kontakty"></a>

Сайт: [cdek-ms.ru](https://cdek-ms.ru)

Почта: <apps@cdek-ms.ru>

Телеграм: [@apps\_support](https://t.me/apps_support)


