====== Концепции системы ====== В данной статье приведен основные принципы, понятия и подходы, которые стоит понимать, если вы хотите погрузиться в детали работы системы. Значительная часть материалов предназначена для аналитиков, но пользователям тоже стоит "пробежаться глазами по тексту" (например, вы узнаете где в Сатурне марки и почему так). Если вы разработчик - эта страница обязательна к прочтению. ---- ===== Карточки: справочники, документы, журналы ===== В Сатурн, основной объем информации доступный пользователям содержится в Справочниках и Документах. Это, образно говоря - карточки с различными полями и атрибутами; * Справочники описывают какие-то каталожные значения, редко меняющиеся; * Документы описывают факты хозяйственной деятельности; Если вы работали с 1С, то в Сатурне термины "Справочники" и "Документы" понимаются точно так-же как и в 1С. Аналогично, как и в 1С в Сатурн Есть "Журналы", которые отображают списки карточек - документов или элементов справочника. Многие из документов и справочников имеют "шапку" и часто одну или несколько "табличных частей". Тоже как в 1С. ==== Фазы ЖЦ, состояния, операции ==== Все "карточки" (и справочники и документы) в системе имеют свой "жизненный цикл", состоящий из нескольких "фаз". Каждую фазу жизненного цикла документа - можно сравнить со стадией обработки, состоянием. > Например накладные - которые пересылаются между ХС - могут быть "черновиками", "в пути", "принятыми". Фаза ЖЦ отражается в поле "статус". У большинства записей ЖЦ очень простой, и включает 4 состояния : * Черновик * Актуально * Архив * Отменено В зависимости от состояния - меняется и список действий, который можно совершать с этой записью. (например отправленную накладную нельзя отредактировать, можно только "принять", "отправить назад", "отметить утерянным"). **Черновик** - состояние в котором вы создаете запись. Это заготовка, которая "пока ещё ничего не значит". Пока карточка в состоянии черновик - мы можете её свободно редактировать. * __Для справочников - это состояние, в котором вы не можете использовать карточку в документах.__ * Для документов это означает, что документ "не принят к учету", пользователь не закончил егоредактирование, не готов их подтвердить, данные в документе - не отражают полностью ту операцию, о которой вы хотите отчитаться. "Не принят к учету" - означат что документ не отображается в отчетах, не меняет остатки в системе. **Актуально** - состояние в котором запись "используется", содержимое карточки значимо, считается полезным. * __Для справочников - это состояние когда карточку можно использовать в документах.__ Данные справочника актуальны, применимы. * Для Документов - то это означает, что документ принят к учету, он изменил остатки, участвует в отчетах. Проводя параллель с 1С - это "проведенный документ" (некоторая разница всё же есть, но сейчас она не важна. см следующий раздел для подробностей). Как и проведенный документ в 1С, актуальные документы в Сатурн "зафиксированы" - их нельзя отредактировать или изменить. С некоторыми документами можно провести некоторые операции, например добавить примечание, но не более. В будущем станет доступна функция "отменить последнюю операцию", которая может вернуть документ в черновик (это как в 1С - отменить проведение). **Архив** - состояние, в котором карточка переходит по истечении срока использования. Сюда карточка переходит из состояния "актуально". Состояние примерно похоже на перемещение реального документа на "архивное хранение" - "архивная запись" какое-то время ещё будет существовать в системе, прежде чем будет удалена навсегда. * карточки справочников в состоянии "архив" как правило нельзя использовать в документах; исключением является использование ПАТ, которые были переведены в архив по истечении срока гос.регистрации менее чем год назад. **Отменено** - состояние которое присваивается карточке, если её ЖЦ "прерывается"; как правило - выявлено что карточка оформлена с ошибкой, или пользователь отказывается от редактирования "черновика". * __карточки справочников в состоянии "отменено" нельзя использовать в документах__ (за исключением списания в ноль остатков ПАТ через документ Инвентаризация) У некоторых документов ЖЦ может отличаться - быть более простым (//например "записи о возе ПА"//) или более сложен (//например у документа накладная - ЖЦ достаточно сложный и разветвленный (*1) // ). > //Вы видите статусы документов в одной из колонок журнала. При выполнении "операций проведения" документы меняют статус, и вы видите на какой стадии обработки они находятся.// > //Использование в документе карточки справочника не в состоянии "актуально", как правило приведет к тому, что вы не сможете актуализировать документ.// ____________ (*1) //Если "не страшно" - можно посмотреть информацию для разработчиков где приведены диаграммы состояний различных документов [[https://fgis-saturn.ru/api/FGISPPA_Entites_LC.pdf]] - это не то что вам обязательно знать для обычной работы. но как иллюстрация - вы можете посмотреть насколько отличаются ЖЦ разных записей.// ---- ===== "Проведение документов“ (термин) ===== Термин "провести документ" распространился "во времена" массового внедрения 1С и мы не видим особого смысла не потакать этой традиции. Мы используем термин "провести документ" в //почти// том-же смысле, что и в 1С - "//принять документ к учёту и сформировать учётные движения//", за одной разницей: если в 1С операция "провести" как правило является специально выделенной и единственной в своем роде, то в Сатурн операций, которыми вы можете провести документ - признать документ действительным, соответствующим фактам - как правило несколько. В Сатурн, в большинстве случаев, термин провести означает //выполнение операции меняющей статус Документа// (переводящей его на другую фазу ЖЦ). Как правило, это переход из статуса "черновик" в "актуально", но могут быть и другие статусы, если порядок работы с документом (его ЖУ) это предполагает. Т.к. операций проводящих документ в Сатурн может быть больше чем одна, мы рекомендуем говорить "провести такой-то операцией" - с указанием какую операцию вы выполнили над документом. Мы говорим "провести" только в применении к выполнению отдельных операций, которые формируют учетные движения. Операции редактировать, сохранить, отменить - не используются с термином провести, т.к. не формируют учётных движений. К Справочникам термин не применяется, т.к. они не формируют учётных движений, даже при смене статуса ЖЦ. ---- ===== Вещество, Номер Гос.регистрации, Марка, Артикул, Партия - как это соотносится? ===== > //Данный раздел, возможно будет полезен только методистам и разработчикам (аналитикам и программистам). Тем не менее, текст рекомендуется к ознакомлению всем, для того, что бы все понимали приведенные термины одинаково.// Атомарной "единицей учета" в Сатурн является "партия". Не "номенклатурная позиция", не "ПА", а "партия" (или "серия" - небольшая порция товара с одинаковыми характеристиками и одним номером от производителя (см определение партии ниже). Рассмотрим термины с которыми мы сталкиваемся, для того, что бы понять, как сопоставлять Сатурн и вашу учетную систему. На самом верхнем уровне мы имеем дело с "//действующим веществом//" - пестицидом или агрохимикатом. Вещество может производиться одним или несколькими производителями. \\ Этот уровень, с точки зрения системы - абстрактный. Он не существует ни как справочник, ни как реестр ни в какой-либо другой строго формализованной общедоступной единой для всех участников форме. \\ \\ (1) **Свидетельсво о регистрации**. Производители регистрируют свою продукцию в Минсельхоз, и получают "свидетельство о регистрации", которое определяет срок разрешенного использования, номер государственной регистрации, и ряд других характеристик, как разрешенные способы обработки, обрабатываемые культуры и ряд других параметров применения. __Важно понимать, что 2 выданных свидетельства - даже если они регистрируют одно вещество - по формальным признакам никак не связаны друг с другом__. Детали изложены в разделе [[обзор:справочник_пат#каталог_па_-_это_каталог_свидетельств_о_регистрации | "Каталог ПА - это каталог свидетельств о регистрации"]]. В Сатурн, каталог свидетельств о регистрации - это справочник ПАТ.\\ \\ (2) **Марка**. Производимая продукция может иметь несколько "марок", которые "конкретизирует" некоторые потребительские и коммерческие свойства - наименование, концентрацию, детали состава. Все марки перечислены в выданном свидетельстве о регистрации.\\ \\ (3) **Товарная позиция (артикул)**. Определяет конкретный тип продаваемого варианта товара - как правило по сравнению с "маркой" уточняет фасовку или тару. Данный уровень соответствует карточкам "справочника номенклатуры" в 1С.\\ \\ (4) **Партия**; это уже "отдельная порция" товара, выпущенная в одном месте, в одно время и тп. Характеризуется в первую очередь номером партии, датой производства, датой окончания срока годности. (Подробнее что такое "партия" - описано в следующем разделе). В Сатурн, как отдельные структуры, существует только 2 элемента из описанных : * "свидетельсnва о регистрации" - [[обзор:справочник_пат | справочник ПАТ]]. * "партия" - которая реализована как внутренняя учетная структура. Она доступна через API; в АРМ ХС партии доступны косвенно - через отчеты. Атрибуты описывающие "марку" и "товарную позицию" - в Сатурн привязаны к "партии". \\ Отдельный атрибут для Марки в веб-интерфейсе пока не доступен, потому пока он не появится, рекомендуется указывать марку в номере партии, после номера. Например "//1029-281ц-21. марка Б//". > //Не стоит пытаться создать под "марку" отдельный элемент справочника ПАТ. Вы можете создавать в справочнике ПАТ только Тукосмеси. \\ \\ Создание Тукосмеси с наименованиями марок, или создание тукосмесей с единственным компонентом- будут рассматриваться как ошибка, карточки будут "отменяться". \\ См для подробностей [[обзор:справочник_пат | статью о справочнике ПАТ]]// ---- ===== Партии ===== При работе в Сатурн вам необходимо будет понимать что такое "партия". \\ В первую очередь, потому что сведения об операциях с ПА, необходимо предоставлять в разрезе партий. Это требование 109-ФЗ. В данном разделе описывается какие в Сатурне бывают "партии", и чем они отличаются. На "уровне методического обеспечения" - различается **несколько понятий “партия”** : * "Производственная"; * "Учетная" (она же "фрагмент партии"); * "Транспортная"; ==== Производственная партия ==== Самая простая партия, это “**производственная партия”** - это объем ПА, который выпущен производителем и обладает сходными свойствами, потребительскими характеристиками и обстоятельствами производства ( смена, время, цех, сырье, и др.). Данный объем помечается одним, уникальным для каждой партии номером ("номер серии", __"номер партии"__), и __наносится на упаковку ПА, и/или вносится в тарную этикетку__. Понятие "производственная партия" - как структура в Сатурн не отражено, есть только атрибут "номер партии", присутствующий в некоторых документах и свойствах "учетной партии".\\ Атрибут "номер партии" в Сатурн - должен соответствовать номеру партии в тарной этикетке на упаковке ПА. ==== Учетная партия ("фрагмент партии", "дочерняя партия")==== **“Учетная партия”** (или просто партия) - учитываемый в системе объем продукции. \\ Соответствует "ГОСТ 23954-80, "УДОБРЕНИЯ МИНЕРАЛЬНЫЕ, Правила приемки": > "Партией считают количество однородного по своим качественным показателям продукта, не превышающего сменной выработки ИЛИ сменной отгрузки, одновременно направляемого в один адрес и сопровождаемого одним документом о качестве". Соответственно, сразу после производства, понятия "учетная партия" и "производственная партия" соответствуют одному объему. После чего производственная партия начинает дробиться на дочерние партии, направляемые разным получателям, и хранимым на разных складах - порождается множество "дочерних партий" - фрагментов исходной производственной партии. Один фрагмент соответствует одной "учетной партии". **Совокупность всех "учетных партий" с одним "номером партии" (номером партии или серии, нанесенным на упаковке) - соответствуют одной "производственной партии" и образуют "//дерево партий//"**. Учетная партия - реализована в Сатурн как единица учета, имеет отдельную структуру данных, идентифицируется с помощью "Кода партии" - это автоматически генерируемый идентификатор записи, указывающий на очередной "фрагмент производственной партии". Несколько фрагментов одной производственной партии при поступлении на один склад в собственность одному ХС - могут объединяться - новопоступившая партия увеличит остатки уже существующей на складе партии, а сама перестанет существовать. (примечание: данная функциональность будет добавлена в 2023г) ==== Транспортная партия ==== Есть **“транспортная партия”** - объем продукции перевозимый единовременно как одна партия, но которая может содержать несколько производственных партий (партий с разным номеров партии от производителя (номером серии)). В Сатурн, как правило, фигурирует при импорте партий через ИС Аргус, технически не отличима от простой партии, описывает объем ПА, ввозимый по одной “записи о ввозе ПА”. Номер партии у такой партии как правило содержит перечисление через запятую всех "номеров производственных партий", которые входят во ввозимый объем ПА. ==== Разные вопросы ==== === Смешивание нескольких партий без фасовки === Ситуацию, когда несколько партий, перевозимых насыпью или наливом, смешиваются в одной емкости - рекомендуется отражать через производство новой "партии" из 2-х - "существующей" и "вливаемой". === Ограничения операций с партией === По каждой партии отслеживается своя цепочка операций, которые совершаются последовательно в порядке времени. В настоящее время нельзя совершить операции ранее, чем уже совершенная последняя операция по данной партии. Потому если система говорит вам, что вы пытаетесь сделать движение "задними числами" - проверьте даты операций по партиям, операции по которым вы пытаетесь совершить. Обратите ещё внимание, на операции с партиями, по карточкам с ПА, которые находятся не в состоянии "актуально". * операции с ПА перешедшие в архив по истечении срока гос.регистрации [[cases:noreg_pa_usage|описаны тут]] (в течении года ограничений на действие с уже выпущенными партиями нет); * партии, у которых ПА переведены в состояние "отменено" (например это была некорректно заведенная тукосместь, которую тех.поддержка "отменила") - можно только "списать в ноль" актом инвентаризации. ==== Единицы партии, Фасовка ==== см раздел "единицы" ниже. ---- ===== Единицы ===== Существует 2 понятия "единиц" в Сатурн. * единица фасовки партии * учетная единица ("безразмерная базовая единица") ==== Единица партии (единица фасовки) ==== У каждой партии существует 3 важных атрибута описывающих количество и фасовку партии. * **"единица"** - "единица партии по умолчанию", это наименование упаковки используемой в данной партии; 'мешки', 'бутылки', 'бидон', 'ящик', 'паллета', 'еврокуб' и др. * **"кратность"** - это число, количество базовых учетных единиц в этой единице - сколько кг или литров в одной упаковке; кг или литры используются для кратности - зависит от агрегатного состояния вещества или уточняется с помощью типа базовой единицы (см ниже); число может быть дробным, или меньше единицы, точность до 3-х единиц после запятой. * **"тип базовой единицы измерения"** - атрибут, который говорит считать количество данной партии по объему или по весу - в литрах или килограммах соответственно. (данный атрибут станет доступен в веб-интерфейсе до конца 2023 г.) **"Единица партии" и "кратность" описывают "фасовку" партии**, и присваивается при её формировании - производстве, инвентаризации, или выделении "дочерней партии". Примеры для единицы и кратности: ["мешки", 10.000 ], ["мешки", 12.000 ], ["мешки", 15.000 ] или сколько у вас весит один мешок (про мешки обратите внимание на конец статьи, примеры); ["еврокуб", 1000.0 ], ["еврокуб", 1200.0 ] или сколько у вас он весит; ["бутыль", 0.5] ["канистра", 12.500] . Поддерживается дробная кратность и меньше единицы. \\ Кратность может быть только к литрам или килограммам! Нельзя указать кратность к меньшим единицам! Например если у вас имеются паллеты, на которых лежат по 4 мешка, каждый из которых по 10 кг, то для 'паллеты' нельзя указать кратность 4 подразумевая что это 'мешки', для 'паллеты' надо указать кратность 40. Какую единицу указывать - ограничений нет, стоит исходить из содержимого ваших первичных документов : если у вас количество в накладной указано в паллетах, то и в накладной Сатурн стоит указать единицу "паллеты"; только не забудьте корректно рассчитать кратность к кг (или литрам). Если у вас комбипак и наименование единицы типа '1x10л+2х3кг' то кратность должна быть 16. См статью про комбипаки. **Для "налива" или "насыпи"** указывайте //"налив, литры"//, //"насыпь, кг"//, или им подобные единицы - с соответствующей кратностью - 1 (один). \\ Примеры наименования и кратности: ['//насыпь, кг//', 1 ], ['//насыпь, тонны//', 1000 ]. **"Мягкая распаковка"**. При заполнении документов вы можете использовать любые интересующие вас единицы, даже если они не совпадают с единицей партии. Главное, что бы они совпадали с тем, что у ваc указано в первичном документе, и была корректно указана кратность этой единицы к "базовой единице" (кг или литр). > Например, вы приняли партию в "паллетах", но отгружаете в "мешках" (потому что "на паллетах лежат мешки"). Пока вы не нарушаете, скажем так, базовую ("неделимую") упаковку груза - это не будет являться ошибкой, главное корректно указывать кратность всех единиц (паллет к кг и мешков к кг). > Другой пример: вы приняли удобрения в "МКР" по 900 кг, но "высыпали" за раз и внесли скажем 450 кг. В акте применения указываете единицу "кг, насыпь" или "кг", кратность выставляете в "1", и указываете количество 450. Отметим, что **если вы производите "перефасовку" - например ПА поступивший насыпью, вы пакуете в мешки**, то это уже "производство" новой партии, что надо оформлять актом производства. **"Тип базовой единицы"** станет достпен пользователям до конца 2023 года, разработчики клиентских систем через апи уже имеют к нему доступ. Данный атрибут позволяет точно определить базовую удиницу : 'кг' или 'литры'. Может содержать только 2 значения: 'KG' или 'LTR' (или их русскоязычные эквиваленты в веб. интерфейсе). Атрибут определяется при производстве и инвентаризации партии; в том числе и при перефасовке. \\ Это не агрегатное состояние, это именно "тип базовой единицы".\\ Поясним на примере: некоторые виды ПА, например грунты, после фасовки в мешки - декларируются производителями уже по объему - в "литрах" - "мешки 10 литров", хотя сами являются твердыми. для таких мешков, тройка [единица, кратность, тип баз.ед.] будет выглядеть как ['мешки', 10.00, LTR ]. хотя до перефасовки, это будут ['насыпь кг', 1.00, KG ] ==== Учетная единица (безразмерная базовая единица)==== **"Учетная единица"** применяется для подсчета количеств всех ПА внутри системы. Т.е. на уровне внутреннего учета, количества всех ПА измеряются в "безразмерных базовых единицах", которые принимаются равными 1 Кг для твердых веществ и 1 Литр для жидких (или измеряемых по объему) веществ. Как правило, базовые единицы вы можете увидеть только в отчете об остатках, сообщениях об ошибках, или при подсчете агрегированных количеств по разным партиям одного вещества. **"безразмерная базовая учетная единица" в отчетах обозначается как "кг|л", через вертикальную черту**, **"килограммы или литры"**. Именно "ИЛИ", не "килограмм на литр", а именно "килограммы __или__ литры". --- //2023.06.29_0000// ----