> For the complete documentation index, see [llms.txt](https://docs.cdek-ms.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cdek-ms.ru/nastroika/translyaciya-statusov.md).

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

### Описание

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

![](/files/-MGJ_R1UEthDFplkoVpE)

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

![](/files/-MGoA71XPq14_b-vc1r9)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

![](/files/-MGJzAGZNdZMYvTwSuvM)

![](/files/-MGJzUS3B6Cv3tiJH7jf)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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