Содержание

Концепции системы

В данной статье приведен основные принципы, понятия и подходы, которые стоит понимать, если вы хотите погрузиться в детали работы системы. Значительная часть материалов предназначена для аналитиков, но пользователям тоже стоит «пробежаться глазами по тексту» (например, вы узнаете где в Сатурне марки и почему так).

Если вы разработчик - эта страница обязательна к прочтению.


Карточки: справочники, документы, журналы

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

Если вы работали с 1С, то в Сатурне термины «Справочники» и «Документы» понимаются точно так-же как и в 1С.

Аналогично, как и в 1С в Сатурн Есть «Журналы», которые отображают списки карточек - документов или элементов справочника.

Многие из документов и справочников имеют «шапку» и часто одну или несколько «табличных частей». Тоже как в 1С.

Фазы ЖЦ, состояния, операции

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

Каждую фазу жизненного цикла документа - можно сравнить со стадией обработки, состоянием.

Например накладные - которые пересылаются между ХС - могут быть «черновиками», «в пути», «принятыми». Фаза ЖЦ отражается в поле «статус».

У большинства записей ЖЦ очень простой, и включает 4 состояния :

В зависимости от состояния - меняется и список действий, который можно совершать с этой записью. (например отправленную накладную нельзя отредактировать, можно только «принять», «отправить назад», «отметить утерянным»).

Черновик - состояние в котором вы создаете запись. Это заготовка, которая «пока ещё ничего не значит». Пока карточка в состоянии черновик - мы можете её свободно редактировать.

Актуально - состояние в котором запись «используется», содержимое карточки значимо, считается полезным.

Архив - состояние, в котором карточка переходит по истечении срока использования. Сюда карточка переходит из состояния «актуально». Состояние примерно похоже на перемещение реального документа на «архивное хранение» - «архивная запись» какое-то время ещё будет существовать в системе, прежде чем будет удалена навсегда.

Отменено - состояние которое присваивается карточке, если её ЖЦ «прерывается»; как правило - выявлено что карточка оформлена с ошибкой, или пользователь отказывается от редактирования «черновика».

У некоторых документов ЖЦ может отличаться - быть более простым (например «записи о возе ПА») или более сложен (например у документа накладная - ЖЦ достаточно сложный и разветвленный (*1) ).

Вы видите статусы документов в одной из колонок журнала. При выполнении «операций проведения» документы меняют статус, и вы видите на какой стадии обработки они находятся.
Использование в документе карточки справочника не в состоянии «актуально», как правило приведет к тому, что вы не сможете актуализировать документ.

(*1) Если «не страшно» - можно посмотреть информацию для разработчиков где приведены диаграммы состояний различных документов https://fgis-saturn.ru/api/FGISPPA_Entites_LC.pdf - это не то что вам обязательно знать для обычной работы. но как иллюстрация - вы можете посмотреть насколько отличаются ЖЦ разных записей.


"Проведение документов“ (термин)

Термин «провести документ» распространился «во времена» массового внедрения 1С и мы не видим особого смысла не потакать этой традиции.

Мы используем термин «провести документ» в почти том-же смысле, что и в 1С - «принять документ к учёту и сформировать учётные движения», за одной разницей: если в 1С операция «провести» как правило является специально выделенной и единственной в своем роде, то в Сатурн операций, которыми вы можете провести документ - признать документ действительным, соответствующим фактам - как правило несколько.

В Сатурн, в большинстве случаев, термин провести означает выполнение операции меняющей статус Документа (переводящей его на другую фазу ЖЦ). Как правило, это переход из статуса «черновик» в «актуально», но могут быть и другие статусы, если порядок работы с документом (его ЖУ) это предполагает.

Т.к. операций проводящих документ в Сатурн может быть больше чем одна, мы рекомендуем говорить «провести такой-то операцией» - с указанием какую операцию вы выполнили над документом.

Мы говорим «провести» только в применении к выполнению отдельных операций, которые формируют учетные движения.

Операции редактировать, сохранить, отменить - не используются с термином провести, т.к. не формируют учётных движений.

К Справочникам термин не применяется, т.к. они не формируют учётных движений, даже при смене статуса ЖЦ.


Вещество, Номер Гос.регистрации, Марка, Артикул, Партия - как это соотносится?

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

Атомарной «единицей учета» в Сатурн является «партия». Не «номенклатурная позиция», не «ПА», а «партия» (или «серия» - небольшая порция товара с одинаковыми характеристиками и одним номером от производителя (см определение партии ниже).

Рассмотрим термины с которыми мы сталкиваемся, для того, что бы понять, как сопоставлять Сатурн и вашу учетную систему.

На самом верхнем уровне мы имеем дело с «действующим веществом» - пестицидом или агрохимикатом. Вещество может производиться одним или несколькими производителями.
Этот уровень, с точки зрения системы - абстрактный. Он не существует ни как справочник, ни как реестр ни в какой-либо другой строго формализованной общедоступной единой для всех участников форме.

(1) Свидетельсво о регистрации. Производители регистрируют свою продукцию в Минсельхоз, и получают «свидетельство о регистрации», которое определяет срок разрешенного использования, номер государственной регистрации, и ряд других характеристик, как разрешенные способы обработки, обрабатываемые культуры и ряд других параметров применения. Важно понимать, что 2 выданных свидетельства - даже если они регистрируют одно вещество - по формальным признакам никак не связаны друг с другом. Детали изложены в разделе "Каталог ПА - это каталог свидетельств о регистрации". В Сатурн, каталог свидетельств о регистрации - это справочник ПАТ.

(2) Марка. Производимая продукция может иметь несколько «марок», которые «конкретизирует» некоторые потребительские и коммерческие свойства - наименование, концентрацию, детали состава. Все марки перечислены в выданном свидетельстве о регистрации.

(3) Товарная позиция (артикул). Определяет конкретный тип продаваемого варианта товара - как правило по сравнению с «маркой» уточняет фасовку или тару. Данный уровень соответствует карточкам «справочника номенклатуры» в 1С.

(4) Партия; это уже «отдельная порция» товара, выпущенная в одном месте, в одно время и тп. Характеризуется в первую очередь номером партии, датой производства, датой окончания срока годности. (Подробнее что такое «партия» - описано в следующем разделе).

В Сатурн, как отдельные структуры, существует только 2 элемента из описанных :

Атрибуты описывающие «марку» и «товарную позицию» - в Сатурн привязаны к «партии».
Отдельный атрибут для Марки в веб-интерфейсе пока не доступен, потому пока он не появится, рекомендуется указывать марку в номере партии, после номера. Например «1029-281ц-21. марка Б».

Не стоит пытаться создать под «марку» отдельный элемент справочника ПАТ. Вы можете создавать в справочнике ПАТ только Тукосмеси.

Создание Тукосмеси с наименованиями марок, или создание тукосмесей с единственным компонентом- будут рассматриваться как ошибка, карточки будут «отменяться».
См для подробностей статью о справочнике ПАТ

Партии

При работе в Сатурн вам необходимо будет понимать что такое «партия».
В первую очередь, потому что сведения об операциях с ПА, необходимо предоставлять в разрезе партий. Это требование 109-ФЗ. В данном разделе описывается какие в Сатурне бывают «партии», и чем они отличаются.

На «уровне методического обеспечения» - различается несколько понятий “партия” :

Производственная партия

Самая простая партия, это “производственная партия” - это объем ПА, который выпущен производителем и обладает сходными свойствами, потребительскими характеристиками и обстоятельствами производства ( смена, время, цех, сырье, и др.).

Данный объем помечается одним, уникальным для каждой партии номером («номер серии», «номер партии»), и наносится на упаковку ПА, и/или вносится в тарную этикетку.

Понятие «производственная партия» - как структура в Сатурн не отражено, есть только атрибут «номер партии», присутствующий в некоторых документах и свойствах «учетной партии».
Атрибут «номер партии» в Сатурн - должен соответствовать номеру партии в тарной этикетке на упаковке ПА.

Учетная партия ("фрагмент партии", "дочерняя партия")

“Учетная партия” (или просто партия) - учитываемый в системе объем продукции.

Соответствует «ГОСТ 23954-80, «УДОБРЕНИЯ МИНЕРАЛЬНЫЕ, Правила приемки»:

«Партией считают количество однородного по своим качественным показателям продукта, не превышающего сменной выработки ИЛИ сменной отгрузки, одновременно направляемого в один адрес и сопровождаемого одним документом о качестве».

Соответственно, сразу после производства, понятия «учетная партия» и «производственная партия» соответствуют одному объему.

После чего производственная партия начинает дробиться на дочерние партии, направляемые разным получателям, и хранимым на разных складах - порождается множество «дочерних партий» - фрагментов исходной производственной партии. Один фрагмент соответствует одной «учетной партии». Совокупность всех «учетных партий» с одним «номером партии» (номером партии или серии, нанесенным на упаковке) - соответствуют одной «производственной партии» и образуют »дерево партий«.

Учетная партия - реализована в Сатурн как единица учета, имеет отдельную структуру данных, идентифицируется с помощью «Кода партии» - это автоматически генерируемый идентификатор записи, указывающий на очередной «фрагмент производственной партии».

Несколько фрагментов одной производственной партии при поступлении на один склад в собственность одному ХС - могут объединяться - новопоступившая партия увеличит остатки уже существующей на складе партии, а сама перестанет существовать. (примечание: данная функциональность будет добавлена в 2023г)

Транспортная партия

Есть “транспортная партия” - объем продукции перевозимый единовременно как одна партия, но которая может содержать несколько производственных партий (партий с разным номеров партии от производителя (номером серии)). В Сатурн, как правило, фигурирует при импорте партий через ИС Аргус, технически не отличима от простой партии, описывает объем ПА, ввозимый по одной “записи о ввозе ПА”. Номер партии у такой партии как правило содержит перечисление через запятую всех «номеров производственных партий», которые входят во ввозимый объем ПА.

Разные вопросы

Смешивание нескольких партий без фасовки

Ситуацию, когда несколько партий, перевозимых насыпью или наливом, смешиваются в одной емкости - рекомендуется отражать через производство новой «партии» из 2-х - «существующей» и «вливаемой».

Ограничения операций с партией

По каждой партии отслеживается своя цепочка операций, которые совершаются последовательно в порядке времени. В настоящее время нельзя совершить операции ранее, чем уже совершенная последняя операция по данной партии. Потому если система говорит вам, что вы пытаетесь сделать движение «задними числами» - проверьте даты операций по партиям, операции по которым вы пытаетесь совершить.

Обратите ещё внимание, на операции с партиями, по карточкам с ПА, которые находятся не в состоянии «актуально».

Единицы партии, Фасовка

см раздел «единицы» ниже.


Единицы

Существует 2 понятия «единиц» в Сатурн.

Единица партии (единица фасовки)

У каждой партии существует 3 важных атрибута описывающих количество и фасовку партии.

«Единица партии» и «кратность» описывают «фасовку» партии, и присваивается при её формировании - производстве, инвентаризации, или выделении «дочерней партии». Примеры для единицы и кратности: [«мешки», 10.000 ], [«мешки», 12.000 ], [«мешки», 15.000 ] или сколько у вас весит один мешок (про мешки обратите внимание на конец статьи, примеры); [«еврокуб», 1000.0 ], [«еврокуб», 1200.0 ] или сколько у вас он весит; [«бутыль», 0.5] [«канистра», 12.500] . Поддерживается дробная кратность и меньше единицы.

Кратность может быть только к литрам или килограммам! Нельзя указать кратность к меньшим единицам! Например если у вас имеются паллеты, на которых лежат по 4 мешка, каждый из которых по 10 кг, то для 'паллеты' нельзя указать кратность 4 подразумевая что это 'мешки', для 'паллеты' надо указать кратность 40.

Какую единицу указывать - ограничений нет, стоит исходить из содержимого ваших первичных документов : если у вас количество в накладной указано в паллетах, то и в накладной Сатурн стоит указать единицу «паллеты»; только не забудьте корректно рассчитать кратность к кг (или литрам).

Если у вас комбипак и наименование единицы типа '1×10л+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