> For the complete documentation index, see [llms.txt](https://docs.pochta-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.pochta-ms.ru/nastroiki/nastroiki-prilozheniya-dlya-dokumentov.md). # Настройки приложения для документов ### Описание Этот раздел позволяет настроить работу приложения (трансляцию статусов из Почты, передачу данных накладных в доп. поля) с различными видами документов (заказ покупателя, отгрузка) ![](/files/-MWv6SkNPumEC1eLJvmf) Чтобы переключиться между настройками для различных документов, нужно нажать на необходимую вкладку. ![](/files/-MWv6_IpqwnxBQ2Re7Fr) ### Имя клиента по умолчанию Определяет для документа откуда брать имя получателя. Опционально доступно три варианта: * наименование контрагента * контактное лицо контрагента * из указанного доп. поля документа Будет использовано как значение по умолчанию в [виджете приложения](/vidzhet-prilozheniya/dannye-zakaza.md#imya-poluchatelya) и при [автоматическом создании накладных](/avtosozdanie-nakladnykh.md). ### Телефон клиента по умолчанию Как и в пункте выше, определяет для документа откуда брать телефон получателя. Опционально доступно четыре варианта: * телефон из карточки контрагента * контактное лицо контрагента * из указанного доп. поля документа * все найденные телефоны При выборе последней опции в накладную попадут все телефоны из трех предыдущих пунктов. Будет использовано как значение по умолчанию в [виджете приложения](/vidzhet-prilozheniya/dannye-zakaza.md#imya-poluchatelya) и при [автоматическом создании накладных](/avtosozdanie-nakladnykh.md). ### Адрес клиента по умолчанию Определяет для документа откуда брать адрес получателя. Опционально доступно три варианта: * наименование контрагента * контактное лицо контрагента * из указанного доп. поля документа Будет использовано как значение по умолчанию в [виджете приложения](/vidzhet-prilozheniya/dannye-zakaza.md#imya-poluchatelya) и при [автоматическом создании накладных](/avtosozdanie-nakladnykh.md). На основании адреса приложение автоматически определяет город получателя. {% hint style="warning" %} Важно заметить, что страна, индекс, город, улица, дом и квартира валидируется через сервис Dadata (для России) и Google Maps API (для международных). Правильность распознавание этих данных не гарантируется, поэтому при оформлении стоит уделять отдельное внимание полям адреса. {% endhint %} ### Вес товаров берется из доп. поля Задает вес отправления для накладной из доп. поля. Используется с [опций передачи веса и габаритов через доп. поля](/nastroiki/ves-i-gabarity.md) документа. ### Объем товаров берется из доп. поля Задает объем отправления для накладной из доп. поля. Используется с [опций передачи веса и габаритов через доп. поля](/nastroiki/ves-i-gabarity.md) документа. ### Наложенный платеж Опция определяет статус наложенного платежа для документа. Доступно 6 вариантов: 1. **Включен, если не оплачен**. В этом варианте приложение проверяет сумму оплат по документу в МоемСкладе (входящие платежи и приходные ордера). Если сумма оплат меньше суммы документа, наложенный платеж по умолчанию включен в полной сумме документа. 2. **Всегда включен**. Наложенный платеж всегда включен в полной сумме документа. 3. **Всегда выключен**. Наложенный платеж будет всегда выключен для документа. 4. **Включен в части неоплаты (сумма оплаты в МС)**. Приложение установит сумму наложенного платежа в размере разницы суммы оплат по документу (входящие платежи и приходные ордера) и суммой документа. 5. **Включен в части неоплаты (сумма оплаты в доп. поле)**. Приложение устанавливает наложенный платеж в виде разницы суммы документа и суммы указанной в выбранном доп. поле. 6. **Включен в части неоплаты (сумма неоплаты в доп. поле)**. Приложение устанавливает наложенный платеж в виде суммы из доп. поля ### Доп. сбор за доставку Опция определяет будет ли включаться в сумму наложенного платежа сумма доставки. Доступно 3 варианта: 1. **В зависимости от наложенного платежа**. В этом варианте доп. сбор будет включаться в зависимости от того, есть ли наложенный платеж по документу. 2. **Всегда включен**. Доп. сбор всегда включается в наложенный платеж (ваш клиент всегда оплачивает доставку). 3. **Всегда выключен**. Доп. сбор не включется в наложенный платеж (ваш клиент не оплачивает доставку). ### Предустановка **Т**арифа из справочника Возможность выбирать в виджете тариф по умолчанию. Доп. поле должно являться справочником Тарифы Почты России, установленным приложением. Для установки доп. полей в документ нажмите [**Установить справочники**](/nastroiki/nastroiki-prilozheniya-dlya-dokumentov.md#ustanovka-dop-polei-spravochnikov-v-dokument)**.** ### Предустановка Режима доставки из справочника Возможность выбирать в виджете режим доставки по умолчанию. Доп. поле должно являться справочником Режимы доставки Почты России, установленным приложением (Стандартный или До востребования). Для установки доп. полей в документ нажмите [**Установить справочники**](/nastroiki/nastroiki-prilozheniya-dlya-dokumentov.md#ustanovka-dop-polei-spravochnikov-v-dokument)**.** ### Предустановка стоимости доставки Возможность предустановить расчетную стоимость доставки в виджете. Доступно 4 варианта: 1. **Не предустанавливать**. В виджете будет указана расчетная стоимость из калькулятора. 2. **Из значения доп. поля**. В виджет подставится сумма доставки из указанного доп. поля докумениа 3. **Из стоимости услуги**. В виджет подставится сумма доставки из стоимости указанной услуги. Услуга должна фигурировать в документе. 4. **Из стоимости товара**. В виджет подставится сумма доставки из стоимости указанного товара. Товар должна фигурировать в документе. ### Добавить номер накладной в доп. поле Опция позволяет транслировать номер созданной накладной в доп. поле документа. При повторном создании накладной для одного и того же документа, номер затирается новым. Предыдущий номер накладной будет доступен только в виджете приложения. Поле `Накладная Почты России` автоматически создается для `Заказа покупателя` приложением при установке. При этом, вы можете транслировать номер накладной в любое другое текстовое доп. поле документа на свое усмотрение. {% hint style="warning" %} В настоящее время, для корректной работы данной опции, а так же опций описаных ниже, после создания накладной нужно выходить из Заказа покупателя / Отгрузки через кнопку **Закрыть**. При нажатии на кнопку Сохранить, данные записанные в доп. поле приложением **затираются** данными из открытого пользователем документа. В ближайшем будущем, после появления в API МоегоСклада инструмента для обновления данных в открытом документе в режиме реального времени, этот недостаток будет убран. Сейчас эта возможность находится в разработке. {% endhint %} ### Добавить ссылку на накладную в доп. поле Опция позволяет транслировать ссылку на накладную Почты в доп. поле документа. При повторном создании накладной для одного и того же документа, ссылка будет заменена новой. Поле `Ссылка на накладную Почты России` автоматически создается приложением при установке для `Заказа покупателя`. При этом, вы можете транслировать ссылку в любое другое доп. поле документа на свое усмотрения. ### Добавить статус накладной в доп. поле Трансляция текущего статуса накладной в доп. поле документа. При установке приложение добавляет в МоемСкладе справочник `Статусы Почты России` и создает доп. поле документа `Статусы Почты` ![](/files/-MWxSqzHD-X5rOPFbQq9) ![](/files/-MWxStbZwjfve_av0OtR) Вы можете транслировать статус в другое доп. поле документа на свое усмотрения, но доп. поле должно представлять собой справочник `Статусы Почты России` ### Добавить общую стоимость заказа в доп.поле Приложение может транслировать общую стоимость заказа (стоимость товаров + стоимость доставки) в доп. поле документа МойСклад. Тип доп. поля `строка` ### Добавить наложенную стоимость заказа в доп.поле Приложение может транслировать наложенную стоимость заказа (наложенная стоимость товаров + стоимость доставки) в доп. поле документа МойСклад. Тип доп. поля `строка` ### Добавить стоимость доставки в доп.поле Приложение может транслировать стоимость доставки в доп. поле документа МойСклад. Тип доп. поля `строка` ### Добавить выбранный ОПС в доп.поле Приложение может транслировать адрес ОПС по накладной (как при доставке по адресу, так и до востребования) в доп. поле документа МойСклад. Тип доп. поля `строка` ### Добавить ориентировочную дату доставки в доп.поле Приложение может транслировать ориентировочную дату доставки по накладной в доп. поле документа МойСклад. Тип доп. поля `дата` ![](/files/-MWxUJcPxelfFRG6Y0mU) ### Транслировать статусы накладной Опционально приложение имеет возможность трансляции статусов как в выбранный документ, так и связанный документ (отгрузка или заказ покупателя). ### При статусе накладной "Создан" Приложение может изменять статус документа в МоемСкладе при создании накладной Почты для данного документа. Является начальным статусом. ### При статусе накладной "Принят в отделении связи" Приложение может изменять статус документа в МоемСкладе при сдаче накладной Почты для данного документа в отделение ОПС. ### При статусе накладной "В пути" Приложение может изменять статус документа в МоемСкладе при получении статуса любого промежуточного статуса обработки от Почты по накладной для данного документа. По факту означает, что заказ **отгружен** в Почту и находится в пути. ### При статусе накладной "В пути" (возврат) Приложение может изменять статус документа в МоемСкладе при получении статуса любого промежуточного статуса после окончания срока хранения или отказа в ОПС. По факту означает, что заказ **в пути в ОПС отправителя** ### При статусе накладной "Прибыло в место вручения" Приложение может изменять статус документа в МоемСкладе при получении статуса **Прибыло в место вручения** от Почты по накладной для данного документа. Данные статус означает, что заказ прибыл в ОПС клиента и доступен для забора. Можно использовать для дополнительного информирования клиента. ### При статусе накладной "Прибыло в место вручения" (возврат) Приложение может изменять статус документа в МоемСкладе при получении статуса **Прибыло в место вручения** от Почты по накладной для данного документа. Данные статус означает, что заказ прибыл в ОПС отправителя и доступен для забора. Не конечный статус. ### При статусе накладной "Вручен получателю" Приложение может изменять статус документа в МоемСкладе при получении статуса **Вручен получателю** от Почты по накладной для данного документа. Является конечным статусом, означающим доставку до клиента. ### При статусе накладной "Вручен отправителю" Приложение может изменять статус документа в МоемСкладе при получении статуса **Вручен отправителю** от Почты по накладной для данного документа. Является конечным статусом, означающим получение посылки отправителем (возврат). ### Комментарий накладной берется из Определяет способ трансляции комментария в накладную Почты России. Возможна трансляция из: * комментария к документу * доп. поля документа * фиксированный статичный текст * фиксированный статичный текст + комментарий к документу. В комментарий к накладной обычно передаются пожелания по доставки (например, договоренность по времени доставки, дополнительная информация по адресу доставки). ### Установка доп. полей справочников в документ Чтобы установить доп. поля со справочниками приложения в документ нажмите "Установить справочники" ![](/files/-MWxNT4kat0rF33hjTPl) Приложение установить в выбранный документ доп. поля справочников: 1. Тарифы Почты России 2. Режим доставки Почты России 3. Наложенный платеж Почты России 4. Доп. сбор за доставку Почты России. Данные доп. поля можно использовать для предустановки тарифов, режимов доставки и наложенного платежа при работе с виджетом. Также установка справочников необходима, если перед [автоматическим созданием накладной](/nastroiki/avtomaticheskoe-sozdanie-nakladnykh.md) вы хотите установить конкретный параметр доставки (например, тариф Посылка, до востребования, наложенный платеж включен).