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

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

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

• Справочники описывают какие-то каталожные значения, редко меняющиеся;
• Документы описывают факты хозяйственной деятельности;

Если вы работали с 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-х - «существующей» и «вливаемой».

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

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

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

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

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

• единица фасовки партии
• учетная единица («безразмерная базовая единица»)

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

• «единица» - «единица партии по умолчанию», это наименование упаковки используемой в данной партии; 'мешки', 'бутылки', 'бидон', 'ящик', 'паллета', 'еврокуб' и др.
• «кратность» - это число, количество базовых учетных единиц в этой единице - сколько кг или литров в одной упаковке; кг или литры используются для кратности - зависит от агрегатного состояния вещества или уточняется с помощью типа базовой единицы (см ниже); число может быть дробным, или меньше единицы, точность до 3-х единиц после запятой.
• «тип базовой единицы измерения» - атрибут, который говорит считать количество данной партии по объему или по весу - в литрах или килограммах соответственно. (данный атрибут станет доступен в веб-интерфейсе до конца 2023 г.)

«Единица партии» и «кратность» описывают «фасовку» партии, и присваивается при её формировании - производстве, инвентаризации, или выделении «дочерней партии». Примеры для единицы и кратности: [«мешки», 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