# Трансляция данных из сделки

### Описание

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

![](https://892407583-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpOR0CF3KS0jJQ8okRZEx%2Fuploads%2FNxbsdrcEejPSTeBbGwvf%2F%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%202023-06-20%20%D0%B2%2016.56.14.png?alt=media\&token=a0f7ce56-4d0a-4fc1-947e-46172b0312bd)

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

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

* имя основного контакта из сделки
* имена всех контактов
* название компании из сделки
* из указанного доп. поля&#x20;

Будет использовано как значение по умолчанию в [виджете приложения](https://cdek-bitrix24.yooogi.org/nastroiki/broken-reference) и при автоматическом создании накладных.&#x20;

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

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

* название компании из сделки
* имя основного контакта из сделки
* не указывать
* из указанного доп. поля&#x20;

Будет использовано как значение по умолчанию в [виджете приложения](https://cdek-bitrix24.yooogi.org/nastroiki/broken-reference) и при автоматическом создании накладных.&#x20;

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

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

* телефон основного контакта из сделки
* телефон основного контакта контакта и компании из сделки
* телефон компании из сделки
* телефоны всех контактов из сделки
* все найденные телефоны (компании и контактов)
* из указанного доп. поля

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

Будет использовано как значение по умолчанию в [виджете приложения](https://cdek-bitrix24.yooogi.org/nastroiki/broken-reference) и при автоматическом создании накладных.&#x20;

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

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

Доступны варианты:&#x20;

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

Будет использовано как значение по умолчанию в [виджете приложения](https://cdek-bitrix24.yooogi.org/nastroiki/broken-reference) и при автоматическом создании накладных.&#x20;

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

<figure><img src="https://892407583-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpOR0CF3KS0jJQ8okRZEx%2Fuploads%2FTvyUxj4lpaSqXg68S1Ag%2Fchrome-capture-2023-5-21.gif?alt=media&#x26;token=fc039757-f3f5-4beb-82ec-35e0b48d6054" alt=""><figcaption></figcaption></figure>

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

### База наложенного платежа

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

Доступны варианты:

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

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

Статус наложенного платежа, который будет [предустановлен в виджете](https://cdek-bitrix24.yooogi.org/osnovnye-vozmozhnosti/vidzhet-prilozheniya/parametry-zakaza-i-sozdanie-nakladnoi#nalozhennyi-platezh) приложения по умолчанию. Наложенный платеж всегда можно переключить непосредственно в виджете. Доступные варианты:

* **включен, если не оплачен**. Если сумма оплаченных счетов по сделке меньше [базы наложенного платежа](#baza-nalozhennogo-platezha), то автоматически включается наложенный платеж в виде **полной суммы** базы наложенного платежа
* **всегда включен**. Наложенный платеж всегда включен в полной сумме [базы наложенного платежа](#baza-nalozhennogo-platezha).
* **всегда выключен**. Наложенный платеж будет всегда выключен для документа
* **включен в части доплаты (сумма предоплаты из доп. поля)**. Приложение устанавливает наложенный платеж в виде разницы суммы [базы наложенного платежа](#baza-nalozhennogo-platezha) и суммы указанной в выбранном доп. поле.
* **включен в части доплаты (сумма доплаты из доп. поля)**. Приложение устанавливает наложенный платеж в виде суммы из доп. поля
* **включен в части доплаты (сумма предоплаты из оплаченных счетов Битрикс24)**. Приложение устанавливает наложенный платеж в виде разницы суммы [базы наложенного платежа](#baza-nalozhennogo-platezha) и суммы **оплаченных счетов** сделки.

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

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

Сбор за доставку - стоимость которую берет СДЭК с вашего клиента за доставку (помимо наложенного платежа за товар). По факту - поле `Стоимость доставки` в накладной.

![](https://892407583-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Md1Qhk8LsWCv2qQdcjQ%2F-MeJpoMQsvhACtgxpt6F%2F-MeJrkt81lp11Txxa7CT%2F%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-07-11%20%D0%B2%2012.19.25.png?alt=media\&token=f444cef3-5711-42ff-b3f5-2f0577eaa108)

Статус сбора за доставку, который будет [предустановлен в виджете](https://cdek-bitrix24.yooogi.org/osnovnye-vozmozhnosti/vidzhet-prilozheniya/parametry-zakaza-i-sozdanie-nakladnoi#nalozhennyi-platezh) приложения по умолчанию. Сбор за доставку всегда можно переключить непосредственно в виджете. Доступные варианты:

* Всегда включен, т.е. клиент платит за доставку при получении
* Всегда выключен, т.е. клиент не оплачивает доставку, вы оплачиваете сами
* В зависимости от статуса наложенного платежа. Т.е. если наложенный платеж включен, сбор за доставку тоже включен и наоборот.

Если вы оказываете бесплатную доставку до клиента (т.е. оплачиваете ее сами) сбор за доставку должен быть выключен.

### Номер заказа СДЭК

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

* номер сделки из Битрикс24
* данные из выбранного доп. поля заказа

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

### Артикул товара

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

* генерировать артикул автоматически на стороне приложения
* код товара из Битрикс24
* доп. поле товара

### Предустановка ПВЗ

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

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

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

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

* не предустанавливать
* из значения доп. поля сделки. В этом случае в виджете будет автоматически указана [стоимость сбора за доставку](#dopolnitelnyi-sbor-za-dostavku) из доп. поля сделки&#x20;
* из стоимости услуги. Если в списке товаров сделки имеется выбранная услуга, приложение автоматически назначит стоимость сбора за доставку из стоимости данной услуги&#x20;

<figure><img src="https://892407583-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpOR0CF3KS0jJQ8okRZEx%2Fuploads%2FcXEWGliqNxmpYUwPcFoW%2F%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%202023-06-20%20%D0%B2%2017.42.15.png?alt=media&#x26;token=5fcbf790-a3ae-45e5-8b00-fcfed083ef87" alt=""><figcaption></figcaption></figure>

<div><figure><img src="https://892407583-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpOR0CF3KS0jJQ8okRZEx%2Fuploads%2F5mSaKfR3dAla9suuSW5z%2F%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%202023-06-20%20%D0%B2%2017.43.19.png?alt=media&#x26;token=317aaab5-587a-4f71-8ae7-627dd2ca1ee2" alt="" width="563"><figcaption></figcaption></figure> <figure><img src="https://892407583-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpOR0CF3KS0jJQ8okRZEx%2Fuploads%2F21VkRbcVYE4oUw68oOmY%2Fchrome-capture-2023-5-22.gif?alt=media&#x26;token=ee5e8ddb-a8f5-4a8d-931a-2f035d4ceecd" alt=""><figcaption></figcaption></figure></div>

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

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

Опция позволяет транслировать номер созданной накладной в доп. поле сделки. При повторном создании накладной для одного и того же документа, номер затирается новым. Предыдущий номер накладной будет доступен только в [виджете приложения](https://cdek-bitrix24.yooogi.org/osnovnye-vozmozhnosti/vidzhet-prilozheniya/sozdannye-nakladnye).

Если подходящее поле отсутствует, его можно создать прямо из настроек

<figure><img src="https://892407583-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpOR0CF3KS0jJQ8okRZEx%2Fuploads%2FuFzXre29f7Te0vRXF3Uv%2Fchrome-capture-2023-5-25.gif?alt=media&#x26;token=9c207a4f-8a1d-4fe7-bf6e-dc31f26ff83a" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Если после создания доп. поля оно не отображается в сделке, нужно нажать **Выбрать** и нажать на созданное доп. поле
{% endhint %}

<figure><img src="https://892407583-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpOR0CF3KS0jJQ8okRZEx%2Fuploads%2Fkpv4giJbq2jsLGOi0r80%2F2023-07-07_11-49-35.png?alt=media&#x26;token=98593229-b87a-4d89-8dc2-de0c8f04d875" alt=""><figcaption></figcaption></figure>

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

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

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

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

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

Трансляция текущего статуса накладной в доп. поле сделки.&#x20;

### Добавить выбранный ПВЗ в доп. поле

Если сделка оформлена до ПВЗ приложение автоматически добавит адрес ПВЗ в доп. поле после создания накладной.

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

Приложение добавит ориентировочную дату доставки в доп. поле сделки (тип доп. поля - дата). Ориентировочная дата доставки - это `текущая дата+расчетный срок доставки до получателя`. Эту опцию удобно использовать для контроля сроков доставки, настроив отдельный вид в списке сделок в Битрикс24.&#x20;

![Контроль доставки по расчетным датам](https://892407583-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpOR0CF3KS0jJQ8okRZEx%2Fuploads%2FTVxuctpC09GnirVApBb2%2F%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%202023-06-20%20%D0%B2%2018.21.25.png?alt=media\&token=699f099e-be61-4dd3-a675-6c80953f7b15)

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

Приложение добавит фактическую дату доставки в доп. поле сделки.

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

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

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

Приложение может транслировать общую стоимость заказа (стоимость товаров + стоимость доставки) в доп. поле заказа Битрикс24.

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

Приложение может транслировать наложенную стоимость заказа (наложенная стоимость товаров + стоимость доставки) в доп. поле заказа Битрикс24.&#x20;

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

Приложение может транслировать стоимость доставки в доп. поле заказа Битрикс24.

### Действие при выплате наложки

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

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

### Тип события для действий по наложенному платежу

В данной опции указывается тип события, который будет служить триггером для [предыдущего шага](#deistvie-pri-vyplate-nalozhki). Возможно два варианта:

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

### Сумма созданного документа по наложенному платежу

При [создании счета по выплате наложки](#deistvie-pri-vyplate-nalozhki) можно указать сумму этого счета. Возможны варианты:

* сумма сделки&#x20;
* сумма наложенного платежа по накладной
* расчетная величина - сумма наложенного платежа - сумма услуг СДЭК
* расчетная величина - фактически оплаченная получателем сумма - сумма услуг СДЭК

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

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

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

&#x20;Возможна трансляция из:

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

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