wiki:1c:kalinka:dalion_mp_integration:1c_dorabotka:document_schet [База знаний IT Мастер Сервис]

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
==== Документ Счет ====
=== Условия смены статуса ===
**К сборке (резерв)** \\ 
  * Контроль
    * Возможность поставить товар из ТЧ Товары в резерв.
**Собран (подтвержден)** \\ 
  * Контроль
    * Количества штучных. Количество собранных штучных (тч собранный товар) = количество в заказе
    * Количества весового. Количество собранного весового товара (тч собранный товар) <= количество весового товара в заказе
    * Отмененных строк. Количество в отмененных строках не контролируется


=== Особенности заполнения реквизитов документа ===
== СуммаДокумента и итмс_СуммаДокументаСобрано ==
  * Сумма
    * Является итогом по полю Сумма ТЧ Товары, 
    * Итог по сумме первоначального заказа из МП до любых корректировок (скидки, отмены, сборка весового товара)
  * итмс_СуммаДокументаСобрано 
    * Является итогом по полю СуммаСобрано ТЧ СобранныйТовар
    * Итог по фактической сумме, которая будет отгружена  
== Б_Идентификатор,  Б_ДатаДокумента, Б_НомерВерсии ==
  * Б_Идентификатор 
    * Тип Строка 80
    * Назначение - хранить ид заказа из мобильного приложения, для поиска заказа в базе и обмена с МП.
    * Если документ создан локально итмс_СозданВМП = Ложь. Тогда Поле не заполняется
  * Б_ДатаДокумента
    * Тип Дата и время
    * Назначение - хранить дату время создания заказа в мобильном приложении
    * Если документ создан локально итмс_СозданВМП = Ложь. Тогда Поле не заполняется
  * Б_НомерВерсии
    * Тип Строка 50
    * Назначение - хранить номер версии документа. При создании в МП номер версии по умолчанию 1
    * Номер версии нужен для случаев обновления документа из мобильного приложения МП, у нас такой случай может быть только один - отмена заказа клиентом.
== Работа с НДС ==
  * Калинка, является плательщиком НДС, поэтому учет НДС необходим
  * Метод расчета НДС - Сумма, включает НДС
    * реквизит документа СуммаВключаетНДС всегда Истина
    * реквизит документа УчитыватьНДС всегда Истина
    * У Калинки общий режим, т.е. ставки НДС общие (20 и 10) реквизит документа ТипНалогообложенияНДС (ПеречислениеСсылка.ТипыНалогообложенияНДС) всегда ПрименяютсяОбщиеСтавкиНДС
=== Значения реквизитов Шапки по-умолчанию, включая НДС ===
Если РегистрСведений.итмс_НастройкиСозданияДокументов не заполнен при создании счета будет вызвано Исключение с ошибкой. \\ 
  * Реквизиты заполняемые по данным: РегистрСведений.итмс_НастройкиСозданияДокументов (итмс_ОбщиеФункцииСервер.ПолучитьНастройкиСозданияДокументов())
    * Фирма
    * Контрагент
    * ДоговорКонтрагента
    * ВалютаДокумента
    * БанковскийСчетКасса
    * КатегорияЦен
  * ВидОперации ПеречислениеСсылка.ВидыОперацийСчет = Web
  * Автор = ТекущийПользователь
    * НДС
      * СуммаВключаетНДС = Истина
      * УчитыватьНДС = Истина
      * ТипНалогообложенияНДС = ПрименяютсяОбщиеСтавкиНДС
  * КурсВзаиморасчетов = 1
  * КратностьВзаиморасчетов = 1

=== Особенности использования тч документа ===
После создания документа и фиксации первоначального заказа в тч Товары. Основной становится ТЧ СобранныйТовар, \\ 
где проводится сборка, сканирование марок, изменение цен товаров и отмена строк заказа.
  * Создание документа на основании заказа из МП
    * Заполняется ТЧ Товары, далее сведения в этой ТЧ не меняются.
  * Переход в статус "К сборке".
    * Содержимое ТЧ Товары копируется в ТЧ СобранныйТовар. КоличествоСобрано = 0, ЦенаСобрано = Цена, СуммаСобрано = 0 (КоличествоСобрано * ЦенаСобрано)
  * Обмен с МП. 
    * Если статус New или Processing 
      * ТЧ СобранныйТовар не заполнена, то Поле документа СуммаСобрано = 0, Поля ТЧ Товары КоличествоСобрано = 0, ЦенаСобрано = Цена, СуммаСобрано = 0
    * Если статус Assembled, Awaiting, Courier, Done
      * ТЧ СобранныйТовар заполнена, то Поле документа СуммаСобрано = СуммаСобрано, Поля ТЧ Товары КоличествоСобрано = КоличествоСобрано, ЦенаСобрано = ЦенаСобрано, СуммаСобрано = СуммаСобрано, Отменена = Отменена.
  * Печать чека
    * Данные из ТЧ СобранныйТовар и ТЧ Штрихкоды, синхронизация тч ведется на основе поля ИдентификаторСтроки, строки где Отменена = Истина и соотвествующие им шк в тч Штрихкоды игнорируются
=== Реквизиты, добавленные ===
    * итмс_ТипДоставкиМП 
      * тип ПеречислениеСсылка.итмс_ТипыДоставкиМП Хранит вариант доставки товара (Самовывоз или доставка)
    * итмс_ТипОплатыМП 
      * тип ПеречислениеСсылка.итмс_ТипыОплатыМП Тип оплаты (МП - оплата в мобильном приложении (безнал) или оплата на месте)
    * итмс_СтатусСчетаМП 
      * тип ПеречислениеСсылка.итмс_СтатусыСчетаМП	Статус счета в мобильном приложении (Новый, В cборке, Ждет вас, Собран, У курьера, У вас, Отменен)
    * итмс_СозданВМП 
      * тип Булево Тип заказа - онлайн или локальный заказ без участия мобильного приложения
    * итмс_Клиент 
      * тип СправочникСсылка.Клиенты Клиент по заказу.
    * итмс_СуммаДокументаСобрано 
      * тип Число 15,2  итог по полю СуммаСобрано ТЧ СобранныйТовар
      * сохраняется в модуле документа процедура ПриЗаписи, без учета строк с флагом Отменена.

=== ТЧ Услуги===
  * Не используется.
=== ТЧ ИзменениеСтатуса ===
Штатная тч, доработана. Добавлен реквизит СтатусМП \\ 
Реквизиты:
  * Статус ПеречислениеСсылка.СтатусыСчетов
  * СтатусМП ПеречислениеСсылка.СтатусыСчетов
  * АвторИзменения СправочникСсылка.Пользователи
  * ДатаИзменения Дата и время


=== ТЧ Товары ===
Назначение ТЧ Товары: \\ 
Используется для загрузки заказанных товаров из МП. В МП не используются коэффициенты для единиц измерения и нет понятия места. \\  
Следующие реквизиты ТЧ Товары не будут использоваться. Удалять не будем - т.к. многие штатные алгоритмы на них завязаны:
  * ХарактеристикаНоменклатуры
    * Характеристики в принципе в работе не используются. 
  * Коэффициент
    * Нужен для конвертации различных единиц измерения в базовые шт и кг. Для розницы не актуален.
  * КоличествоМест
    * Для розницы не акутально
  * ЕдиницаИзмеренияМест
    * Для розницы не актуально
  * ПроцентСкидки
    * Не используется
  * СуммаСкидки
    * Не используется
=== ТЧ.СобранныйТовар ===
Товар к сборке по заказу. Товар, который должен быть собран для отгрузки покупателю. Копируется из ТЧ.Товары при переходе в статус Сборка. \\ Основание для печати чека по счету. Поле коэффициент не используется (не предполагается использование упаковок, только штучный либо весовой товар в кг и шт).
      * ИдентификаторСтроки - тип строка для связи строк с ТЧ.Штрихкоды
      * Номенклатура
      * ХарактеристикаНоменклатуры
      * ЕдиницаИзмерения
      * Количество
      * КоличествоСобрано - тип Число (15,3) Контроль собранного количества.
      * Цена
      * ЦенаСобрано - тип Число - возможность изменения цены товара в заказе, например для реализации скидок
      * Сумма
      * СуммаСобрано - тип Число - СуммаСобрано по конкретной позиции товара
      * СтавкаНДС
      * СуммаНДС
      * СуммаНДССобрано - тип Число - СуммаНДССобрано по конкретной позиции товара
      * ПроцентСкидки
      * СуммаСкидки
      * Отменена - тип Булево - признак отмены строки заказа
===ТЧ.Штрихкоды ===
для хранения информации по сканированию маркированных товаров \\ 
        * ИдентификаторСтроки 
          * тип строка для связи строк с ТЧ.СобранныйТовар
        * Считана 
          * тип булево. Штрихкод считан сканером шк
        * ДобавленаВручную 
          * тип булево. Штрихкод введен вручную
        * GTIN 
          * тип Строка 14, GTIN не используется в алгоритмах - нужен для визуализации
        * СерийныйНомер 
          * тип Строка 10, не используется в алгоритмах - нужен для визуализации
        * Штрихкод 
          * тип Строка 200, Результат разбора маркировки Далионом (gtin + серийный номер + криптохвост) не используется в алгоритмах - нужен для визуализации
        * РезультатПроверкиЧЗ 
          * тип ХранилищеЗначения, храним общие результаты проверки в ЧЗ. Назначение - анализ ошибок, решение проблем
        * МаркировкаBase64 
          * тип Строка 200, код маркировки в Base64. Для использования при печати чека. Код маркировки использует нечитаемые символы, поэтому для хранения нужен Base64
        * СтруктураПроверкиЧЗ 
          * тип ХранилищеЗначения Структура (ИдентификаторЗапроса, ВременнаяМетка, ИдентификаторЭкземпляра, ВерсияБазы) для передачи в чек ккт
=== Вкладка Обмен с МП важный функционал ===
        * итмс_СозданВМП тип Булево Тип заказа - онлайн или локальный заказ без участия мобильного приложения \\ При создании заказа в МП - блокируется изменение цены и количества товара в тч товары \\ Если заказ не отмечен, как созданный в МП - изменения по данному заказу, не будут отправлены в МП
        * Б_Идентификатор - идентификатор заказа из мп, тип строка 80
        * Б_ДатаДокумента - дата заказа из МП

=== Резервирование товара в счете: ===
Документ заточен под работу с заказами из МП считается, что других заказов быть не может. \\ 
  * Общее условие - СозданВМП = Истина, иначе никаких резервов
  * Чек не пробит - ДелатьДвиженияПоРезервам = Истина
  * Чек пробит Смена не закрыта - ДелатьДвиженияПоРезервам = Истина
  * Чек пробит Смена закрыта ДелатьДвиженияПоРезервам = Ложь \\ т.е. если док создан в мп и не отменен - он резервирует товар, основание, для снятия резерва - пробит чек и закрыта смена (товар списан окс) \\ Пробит чек или нет, определяется наличием в системе чека (Справочники.Чеки) с реквизитом Счет равным текущему документу.

=== Форма документа ===
== Всего скидка ==
Отображает итог по полю СуммаСкидки ТЧ СобранныйТовар \\ 


=== Шапка документа ===
    * пр колонка
      * Номер
      * Дата
      * Фирма заполняется по данным рег св итмс_НастройкиСозданияДокументов Ресурс Фирма
      * б/счет касса	заполняется по данным рег св итмс_НастройкиСозданияДокументов Ресурс Касса
      * Склад
    * лв колонка
      * Контрагент заполняется по данным рег св итмс_НастройкиСозданияДокументов Ресурс Контрагент
      * Договор заполняется по данным рег св итмс_НастройкиСозданияДокументов Ресурс ДоговорКонтрагента
      * Дата оплаты
      * Фирма, Контрагент, Договор, Касса - заполняются стандартными данными по настройке. Номер и дата - заполняются 1с автоматически при создании документа. \\ Склад - заполняется либо вручную (создано не в МП) либо автоматически при загрузке документа из МП (поиск по ссылке)
    * Вкладка Основная
      * Клиент поле ввода - справочник Клиенты. Для хранения информации о заказчике товара из МП (ФИО, адрес доставки, телефон, e-mail). \\ при загрузке документа из МП заполняется автоматически, поиск в базе по реквизиту справочника Клиенты "итмс_мп_ид", если \\ клиент не найден будет автоматически создан новый клиент.
      * Телефон	- заполняется автоматически по данным справочника Клиенты
      * Адрес доставки	- заполняется по данным заказа при загрузке из МП.
      * Контактное лицо - пока никак не заполняется. Можно использовать если клиент указал, что за него заказ получит другой человек (контактное лицо0