MercuryG2B:ModifyProducerStockList:v3.0: различия между версиями

Материал из Справочная система Россельхознадзора
Перейти к навигации Перейти к поиску
← Предыдущая правкаСледующая правка →
ВизуальныйВики-текст
Строка 6: Строка 6:
## удаление существующей позиции из справочника номенклатуры.
## удаление существующей позиции из справочника номенклатуры.
# Сформированный справочник номенклатуры можно получить с помощью методов сервиса [[MercuryG2B:Services:v3.0#ProductService_.28.D1.80.D0.B5.D0.B5.D1.81.D1.82.D1.80_.D0.BA.D0.B0.D1.82.D0.B5.D0.B3.D0.BE.D1.80.D0.B8.D0.B9_.D0.BF.D1.80.D0.BE.D0.B4.D1.83.D0.BA.D1.86.D0.B8.D0.B8.29|ProductService]].
# Сформированный справочник номенклатуры можно получить с помощью методов сервиса [[MercuryG2B:Services:v3.0#ProductService_.28.D1.80.D0.B5.D0.B5.D1.81.D1.82.D1.80_.D0.BA.D0.B0.D1.82.D0.B5.D0.B3.D0.BE.D1.80.D0.B8.D0.B9_.D0.BF.D1.80.D0.BE.D0.B4.D1.83.D0.BA.D1.86.D0.B8.D0.B8.29|ProductService]].
== Полезные ссылки ==
{| class="wikitable"
|-
! № !! Ссылка !! Описание
|-
| style="text-align:center;" |1
|| [[Ведение_справочника_номенклатуры_предприятия_в_Меркурий.ХС|Ведение справочника номенклатуры предприятия в Меркурий.ХС]]
|| Описание работы со справочником номенклатуры в подсистеме Меркурий.ХС
|-
| style="text-align:center;" |2
|| [[Ведение_справочника_номенклатуры_предприятия_в_Меркурий.ГВЭ|Ведение справочника номенклатуры предприятия в Меркурий.ГВЭ]]
|| Описание работы со справочником номенклатуры в подсистеме Меркурий.ГВЭ
|-
|}


== Спецификация запроса ==  
== Спецификация запроса ==  

Версия от 00:59, 7 декабря 2023

Общие сведения

  1. Операция ModifyProducerStockList предназначена для ведения справочника наименований продукции в соответствии с номенклатурой производителя.
  2. В рамках операции доступны следующие действия:
    1. добавление новой позиции в справочник номенклатуры;
    2. изменение существующей позиции в справочнике номенклатуры;
    3. удаление существующей позиции из справочника номенклатуры.
  3. Сформированный справочник номенклатуры можно получить с помощью методов сервиса ProductService.

Спецификация запроса

# Название XML-элемента Тип Обязат. Описание (нажмите [...] для отображения дополнительного описания)
001 <merc:modifyProducerStockListRequest>
002 ···<merc:localTransactionId>?</merc:localTransactionId> bs:Identifier [1..1] Идентификатор заявки в клиентской системе
003 ···<merc:initiator> vd:User [1..1]

Пользователь, зарегистрированный в системе Меркурий и инициирующий запрос

  • является ответственным за выполнение бизнес-операции
  • здесь потребуется логин ветврача или пользователя ХС, логин для базовой аутентификации не подойдёт.
004 ······<vd:login>?</vd:login> xs:NCName [1..1] Логин пользователя
005 ···</merc:initiator>
006 ···<merc:modificationOperation> vd:PSLModificationOperation [1..1] Операция внесения изменений в реестр наименований продукции
007 ······<vd:type>?</vd:type> bs:RegisterModificationType [1..1]

Тип операции

  • CREATE - создание новой записи в реестре;
  • UPDATE - обновление записи о продукции в реестре;
  • DELETE - удаление записи о продукции из реестра.
008 ······<vd:affectedList> dt:ProductItemList [0..1]

Входящие записи для операции удаления

  • используется только при удалении позиции (type == DELETE)
  • возможно удалять только по одной позиции
009 ·········<dt:productItem> dt:ProductItem [1..1] Сведения о наименовании продукции (номенклатуре)
010 ············<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор версии записи
011 ·········</dt:productItem>
012 ······</vd:affectedList>
013 ······<vd:resultingList> dt:ProductItemList [0..1]

Входящие записи для операций добавления / изменения

  • используется только при добавлении или изменении записи (type == CREATE или type == UPDATE)
  • возможно добавлять или изменять только по одной записи
014 ·········<dt:productItem> dt:ProductItem [1..1] Сведения о наименовании продукции (номенклатуре)
015 ············<bs:uuid>?</bs:uuid> bs:UUID [0..1]

Идентификатор версии записи

  • указывается при изменении записи
016 ············<dt:globalID>?</dt:globalID> dt:GTINType [0..1]

Trade Identification Number (GTIN)

  • по задумке создателей GTIN должен быть уникален для продукции всех производителей, но на практике встречаются случаи недокументированного использования GTIN внутри компаний, что не обеспечивает уникальность GTIN, поэтому уникальность поля не проверяется
017 ············<dt:name>?</dt:name> bs:String255 [0..1] Наименование номенклатуры
018 ············<dt:code>?</dt:code> bs:String255 [0..1]

Артикул

  • артикул продукции должен быть уникальным в пределах одного производителя
019 ············<dt:productType>?</dt:productType> dt:ProductType [1..1] Тип продукции
020 ············<dt:product> dt:Product [1..1]

Продукция

  • обязательно должен быть указан один из идентификаторов: UUID или GUID
  • при указании двух идентификаторов приоритет у UUID
021 ···············<bs:uuid>?</bs:uuid> bs:UUID [0..1] Идентификатор версии записи
022 ···············<bs:guid>?</bs:guid> bs:UUID [0..1] Глобальный идентификатор записи
023 ············</dt:product>
024 ············<dt:subProduct> dt:SubProduct [1..1]

Вид продукции

  • обязательно должен быть указан один из идентификаторов: UUID или GUID
  • при указании двух идентификаторов приоритет у UUID
025 ···············<bs:uuid>?</bs:uuid> bs:UUID [0..1] Идентификатор версии записи
026 ···············<bs:guid>?</bs:guid> bs:UUID [0..1] Глобальный идентификатор записи
027 ············</dt:subProduct>
028 ············<dt:correspondsToGost>?</dt:correspondsToGost> xs:boolean [0..1]

Соответствие ГОСТ

  • true - соответствует (в этом случае должно быть указано значение gost)
  • false или параметр отсутствует - не соответствует
029 ············<dt:gost>?</dt:gost> bs:String255 [0..1]

ГОСТ

  • обязательно, если correspondsToGost == true
030 ············<dt:producer> dt:BusinessEntity [0..1]

Хозяйствующий субъект (ХС) производитель продукции

  • обязательно должен быть указан один из идентификаторов: UUID или GUID
  • при указании двух идентификаторов приоритет у UUID
031 ···············<bs:uuid>?</bs:uuid> bs:UUID [0..1] Идентификатор версии ХС
032 ···············<bs:guid>?</bs:guid> bs:UUID [0..1] Глобальный идентификатор ХС
033 ············</dt:producer>
034 ············<dt:tmOwner> dt:BusinessEntity [0..1]

ХС-собственник торговой марки

  • обязательно должен быть указан один из идентификаторов: UUID или GUID
  • при указании двух идентификаторов приоритет у UUID
035 ···············<bs:uuid>?</bs:uuid> bs:UUID [0..1] Идентификатор версии ХС
036 ···············<bs:guid>?</bs:guid> bs:UUID [0..1] Глобальный идентификатор ХС
037 ············</dt:tmOwner>
038 ············<dt:producing> dt:ProductItemProducing [0..*] Список площадок, на которых выпускается данная продукция
039 ··············<dt:location> dt:Enterprise [1..1]

Площадка, осуществляющая выпуск продукции

  • обязательно должен быть указан один из идентификаторов: UUID или GUID
  • при указании двух идентификаторов приоритет у UUID
040 ··················<bs:uuid>?</bs:uuid> bs:UUID [0..1] Идентификатор версии площадки
041 ··················<bs:guid>?</bs:guid> bs:UUID [0..1] Глобальный идентификатор площадки
042 ···············</dt:location>
043 ············</dt:producing>
044 ············<dt:packaging> dt:Packaging [0..1] Фасовка
045 ···············<dt:packagingType> dt:PackingType [1..1]

Тип упаковки

  • упаковку может идентифицировать один из идентификаторов: uuid, guid или globalID - достаточно указать один из них
  • при указании нескольких идентификаторов приоритет у uuid, потом у guid и globalID
046 ··················<bs:uuid>?</bs:uuid> bs:UUID [0..1] Идентификатор версии типа упаковки
047 ··················<bs:guid>?</bs:guid> bs:UUID [0..1] Глобальный идентификатор упаковки
048 ··················<dt:globalID>?</dt:globalID> dt:PackingCodeType [0..1] Уникальный идентификатор упаковки
049 ···············</dt:packagingType>
050 ···············<dt:quantity>?</dt:quantity> xs:integer [0..1] Количество единиц упаковки
051 ···············<dt:volume>?</dt:volume> bs:Decimal [0..1] Объём единицы упаковки товара
052 ···············<dt:unit> dt:Unit [0..1] Единица измерения объёма единицы упаковки товара
053 ··················<bs:uuid>?</bs:uuid> bs:UUID [0..1] Идентификатор версии единицы измерения
054 ··················<bs:guid>?</bs:guid> bs:UUID [0..1] Глобальный идентификатор единицы измерения
055 ···············</dt:unit>
056 ············</dt:packaging>
057 ············<dt:additionalCharacteristics> dt:ProductItemCharacterictics [0..1] Дополнительные характеристики продукции
058 ···············<dt:classification> dt:ClassificationAttribute [0..1] Классификация продукции
059 ··················<dt:attrCode>PRODUCT_CATEGORY</dt:attrCode> dt:CodeType [1..1]

Код атрибута - Категория продукции

  • Категория продукции может быть задана для типов продукции:
    • Мясо и мясопродукты
    • Пищевые продукты
    • Рыба и морепродукты
  • Для молока и молочной продукции указание категории является обязательным для возможности дальнейшего учета качественных характеристик молочной продукции (массовая доля жира, массовая доля белка и плотность)
060 ··················<dt:attrName>Категория продукции</dt:attrName> bs:Ntext [0..1] Наименование атрибута
061 ··················<dt:classCode>?</dt:classCode> dt:CodeType [1..1]

Код значения атрибута "Категория продукции"

  • Возможные значения:
    • UNCLASSIFIED – не классифицировано
    • RAW – сырец, исходное сырьё
    • INTERMEDIATE – полуфабрикат
    • CONSUMER_PACKAGED – готовая продукция (в потреб. упаковке)
062 ··················<dt:className>?</dt:className> bs:Text [0..1]

Наименование значения атрибута

  • Текстовое представление значения classCode:
    • Категория не определена
    • Не классифицировано
    • Сырец, исходное сырьё
    • Полуфабрикат
    • Готовая продукция (в потребительской упаковке)
063 ···············</dt:classification>
064 ···············<dt:classification> dt:ClassificationAttribute [0..1] Классификация продукции
065 ··················<dt:attrCode>INTENDED_USE</dt:attrCode> dt:CodeType [1..1] Код атрибута - Предназначение партии подконтрольной продукции
066 ··················<dt:attrName>Предназначение партии подконтрольной продукции</dt:attrName> bs:Ntext [0..1] Наименование атрибута
067 ··················<dt:classCode>?</dt:classCode> dt:CodeType [1..1]

Код значения атрибута "Предназначение партии подконтрольной продукции"

  • Возможные значения:
    • HUMAN_CONSUMPTION - в пищу людям
    • MANUFACTURING_HUMAN_CONSUMPTION - для переработки с целью получения подконтрольных товаров, предназначенных в пищу людям
    • DECONTAMINATION_HUMAN_CONSUMPTION - для переработки с обеззараживанием с целью получения подконтрольных товаров, предназначенных в пищу людям
    • ANIMAL_FEED - в корм животным
    • MANUFACTURING_ANIMAL_FEED - для переработки с целью получения подконтрольных товаров, предназначенных в корм животным
    • MEDICAL_USE - для медицинских целей
    • MANUFACTURING_MEDICAL_USE - для переработки с целью получения подконтрольных товаров, предназначенных для медицинских целей
    • SCIENTIFIC_PURPOSES - для биологических, ветеринарных и биотехнологических целей
    • MANUFACTURING_SCIENTIFIC_PURPOSES - для переработки с целью получения подконтрольных товаров, предназначенных для биологических, ветеринарных и биотехнологических целей
    • LABORATORY_TESTS - для диагностических и иных лабораторных исследований
    • TECHNICAL_PURPOSES - для технических целей
    • DISPOSAL - для утилизации
    • DESTRUCTION - для уничтожения
    • EXAMINATION - для проведения ветеринарно-санитарной экспертизы
068 ··················<dt:className>?</dt:className> bs:Text [0..1]

Наименование значения атрибута

  • Текстовое представление значения classCode:
    • В пищу людям
    • Для переработки с целью получения подконтрольных товаров, предназначенных в пищу людям
    • Для переработки с обеззараживанием с целью получения подконтрольных товаров, предназначенных в пищу людям
    • В корм животным
    • Для переработки с целью получения подконтрольных товаров, предназначенных в корм животным
    • Для медицинских целей
    • Для переработки с целью получения подконтрольных товаров, предназначенных для медицинских целей
    • Для биологических, ветеринарных и биотехнологических целей
    • Для переработки с целью получения подконтрольных товаров, предназначенных для биологических, ветеринарных и биотехнологических целей
    • Для диагностических и иных лабораторных исследований
    • Для технических целей
    • Для утилизации
    • Для уничтожения
    • Для проведения ветеринарно-санитарной экспертизы
069 ···············</dt:classification>
070 ···············<dt:attribute> dt:MeasuredAttribute [0..1] Дополнительный атрибут продукции
071 ··················<dt:attrCode>MILK_FAT_MASS_FRACTION</dt:attrCode> dt:CodeType [1..1]

Код атрибута - Массовая доля жира

  • атрибут может быть указан только для молока и молочной продукции
072 ··················<dt:attrName>Массовая доля жира</dt:attrName> bs:Ntext [0..1] Наименование атрибута
073 ··················<dt:attrValue> dt:ComplexMeasure [1..1]

Значение атрибута

  • Значение атрибута должно быть задано одним из следующих способов:
    • указано value - точное значение атрибута
    • указано minValue и maxValue - интервал значений атрибута
    • указано minValue - нижнее предельное значение (не ниже)
    • указано maxValue - верхнее предельное значение (не выше)
074 ·····················<dt:value>?</dt:value> bs:Decimal [0..1]

Точное значение (%)

  • точность до 3-х знаков после запятой
075 ·····················<dt:minValue>?</dt:minValue> bs:Decimal [0..1]

Минимальное значение (%)

  • точность до 3-х знаков после запятой
076 ·····················<dt:maxValue>?</dt:maxValue> bs:Decimal [0..1]

Максимальное значение (%)

  • точность до 3-х знаков после запятой
077 ··················</dt:attrValue>
078 ···············</dt:attribute>
079 ···············<dt:attribute> dt:MeasuredAttribute [0..1] Дополнительный атрибут продукции
080 ··················<dt:attrCode>MILK_PROTEIN_MASS_FRACTION</dt:attrCode> dt:CodeType [1..1]

Код атрибута - Массовая доля белка

  • атрибут может быть указан только для молока и молочной продукции
081 ··················<dt:attrName>Массовая доля белка</dt:attrName> bs:Ntext [0..1] Наименование атрибута
082 ··················<dt:attrValue> dt:ComplexMeasure [1..1]

Значение атрибута

  • Значение атрибута должно быть задано одним из следующих способов:
    • указано value - точное значение атрибута
    • указано minValue и maxValue - интервал значений атрибута
    • указано minValue - нижнее предельное значение (не ниже)
    • указано maxValue - верхнее предельное значение (не выше)
083 ·····················<dt:value>?</dt:value> bs:Decimal [0..1]

Точное значение (%)

  • точность до 3-х знаков после запятой
084 ·····················<dt:minValue>?</dt:minValue> bs:Decimal [0..1]

Минимальное значение (%)

  • точность до 3-х знаков после запятой
085 ·····················<dt:maxValue>?</dt:maxValue> bs:Decimal [0..1]

Максимальное значение (%)

  • точность до 3-х знаков после запятой
086 ··················</dt:attrValue>
087 ···············</dt:attribute>
088 ···············<dt:attribute> dt:MeasuredAttribute [0..1] Дополнительный атрибут продукции
089 ··················<dt:attrCode>DENSITY</dt:attrCode> dt:CodeType [1..1]

Код атрибута - Плотность

  • атрибут может быть указан только для молока и молочной продукции
090 ··················<dt:attrName>Плотность</dt:attrName> bs:Ntext [0..1] Наименование атрибута
091 ··················<dt:attrValue> dt:ComplexMeasure [1..1]

Значение атрибута

  • Значение атрибута должно быть задано одним из следующих способов:
    • указано value - точное значение атрибута
    • указано minValue и maxValue - интервал значений атрибута
092 ·····················<dt:value>?</dt:value> bs:Decimal [0..1]

Точное значение (г/см3)

  • точность до 3-х знаков после запятой
093 ·····················<dt:minValue>?</dt:minValue> bs:Decimal [0..1]

Минимальное значение (г/см3)

  • точность до 3-х знаков после запятой
094 ·····················<dt:maxValue>?</dt:maxValue> bs:Decimal [0..1]

Максимальное значение (г/см3)

  • точность до 3-х знаков после запятой
095 ··················</dt:attrValue>
096 ···············</dt:attribute>
097 ············</dt:additionalCharacteristics>
098 ·········</dt:productItem>
099 ······</vd:resultingList>
100 ···</merc:modificationOperation>
101 </merc:modifyProducerStockListRequest>

Спецификация ответа

# Название XML-элемента Тип Обязат. Описание (нажмите [...] для отображения дополнительного описания)
001 <merc:modifyProducerStockListResponse>
002 ···<merc:productItemList> dt:ProductItemList [1..1]

Список продукции, в которую внесены изменения

  • в случае изменения номенклатуры возвращаются последняя и предыдущая версии
003 ······<dt:productItem> dt:ProductItem [1..*] Сведения о наименовании продукции (номенклатуре)
004 ·········<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор версии записи
005 ·········<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор записи
006 ·········<bs:active>?</bs:active> xs:boolean [1..1]

Флаг активности записи

  • true - запись активна;
  • false - запись не активна.
007 ·········<bs:last>?</bs:last> xs:boolean [1..1]

Флаг, указывающий на то, что запись является последней в истории

  • true - да;
  • false - нет.
008 ·········<bs:status>?</bs:status> bs:VersionStatus [1..1] Статус записи
009 ·········<bs:createDate>?</bs:createDate> xs:DateTime [1..1] Дата создания записи
010 ·········<bs:updateDate>?</bs:updateDate> xs:DateTime [1..1] Дата последнего изменения записи
011 ·········<bs:previous>?</bs:previous> bs:UUID [0..1] Идентификатор предыдущей версии записи
012 ·········<bs:next>?</bs:next> bs:UUID [0..1] Идентификатор следующей версии записи
013 ·········<dt:globalID>?</dt:globalID> dt:GTINType [0..1]

Trade Identification Number (GTIN)

  • идентификационный номер продукции производителя
014 ·········<dt:name>?</dt:name> bs:String255 [0..1] Наименование номенклатуры
015 ·········<dt:code>?</dt:code> bs:String255 [0..1]

Артикул

  • код продукции в соответствии с внутренним кодификатором производителя
016 ·········<dt:productType>?</dt:productType> dt:ProductType [1..1]

Тип продукции

  • первый уровень иерархического справочника продукции ИС Меркурий
017 ·········<dt:product> dt:Product [1..1]

Продукция

  • второй уровень иерархического справочника продукции ИС Меркурий
018 ············<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор версии записи
019 ············<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор записи
020 ············<dt:name>?</dt:name> bs:String255 [0..1] Наименование продукции
021 ············<dt:code>?</dt:code> bs:String256 [0..1] Код ТН ВЭД
022 ·········</dt:product>
023 ·········<dt:subProduct> dt:SubProduct [1..1]

Вид продукции

  • третий уровень иерархического справочника продукции ИС Меркурий
024 ············<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор версии записи
025 ············<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор записи
026 ············<dt:name>?</dt:name> bs:String255 [0..1] Наименование вида продукции
027 ············<dt:code>?</dt:code> bs:String256 [0..1] Код ТН ВЭД
028 ·········</dt:subProduct>
029 ·········<dt:correspondsToGost>?</dt:correspondsToGost> xs:boolean [1..1] Соответствие ГОСТ
030 ·········<dt:gost>?</dt:gost> bs:String255 [0..1] ГОСТ
031 ·········<dt:producer> dt:BusinessEntity [0..1] Хозяйствующий субъект (ХС) производитель продукции
032 ············<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор версии ХС
033 ············<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор ХС
034 ············<dt:fullName>?</dt:fullName> bs:String255 [0..1] Наименование ХС
035 ············<dt:fio>?</dt:fio> bs:String255 [0..1] ФИО ХС
036 ·········</dt:producer>
037 ·········<dt:tmOwner> dt:BusinessEntity [0..1] ХС-собственник торговой марки
038 ············<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор версии ХС
039 ············<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор ХС
040 ············<dt:fullName>?</dt:fullName> bs:String255 [0..1] Наименование ХС
041 ············<dt:fio>?</dt:fio> bs:String255 [0..1] ФИО ХС
042 ·········</dt:tmOwner>
043 ·········<dt:producing> dt:ProductItemProducing [0..*] Список площадок, на которых выпускается данная продукция
044 ···········<dt:location> dt:Enterprise [1..1] Площадка, осуществляющая выпуск продукции
045 ···············<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор версии площадки
046 ···············<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор площадки
047 ···············<dt:name>?</dt:name> bs:String255 [0..1] Наименование площадки
048 ············</dt:location>
049 ·········</dt:producing>
050 ·········<dt:packaging> dt:Packaging [0..1] Фасовка
051 ············<dt:packagingType> dt:PackingType [1..1] Тип упаковки
052 ···············<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор версии типа упаковки
053 ···············<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор упаковки
054 ···············<dt:globalID>?</dt:globalID> dt:PackingCodeType [1..1] Уникальный идентификатор упаковки
055 ···············<dt:name>?</dt:name> bs:String255 [1..1] Наименование упаковки
056 ············</dt:packagingType>
057 ············<dt:quantity>?</dt:quantity> xs:integer [0..1] Количество единиц упаковки
058 ············<dt:volume>?</dt:volume> bs:Decimal [0..1] Объём единицы упаковки товара
059 ············<dt:unit> dt:Unit [0..1] Единица измерения объёма единицы упаковки товара
060 ···············<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор версии единицы измерения
061 ···············<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор единицы измерения
062 ···············<dt:name>?</dt:name> bs:String255 [1..1] Наименование единицы измерения
063 ············</dt:unit>
064 ·········</dt:packaging>
065 ·········<dt:additionalCharacteristics> dt:ProductItemCharacterictics [0..1] Дополнительные характеристики продукции
066 ············<dt:classification> dt:ClassificationAttribute [0..1] Классификация продукции
067 ···············<dt:attrCode>PRODUCT_CATEGORY</dt:attrCode> dt:CodeType [1..1] Код атрибута - Категория продукции
068 ···············<dt:attrName>Категория продукции</dt:attrName> bs:Ntext [1..1] Наименование атрибута
069 ···············<dt:classCode>?</dt:classCode> dt:CodeType [1..1]

Код значения атрибута "Категория продукции"

  • Возможные значения:
    • UNDEFINED - категория не определена
    • UNCLASSIFIED – не классифицировано
    • RAW – сырец, исходное сырьё
    • INTERMEDIATE – полуфабрикат
    • CONSUMER_PACKAGED – готовая продукция (в потреб. упаковке)
070 ···············<dt:className>?</dt:className> bs:Text [1..1]

Наименование значения атрибута

  • Текстовое представление значения classCode:
    • Категория не определена
    • Не классифицировано
    • Сырец, исходное сырьё
    • Полуфабрикат
    • Готовая продукция (в потребительской упаковке)
071 ············</dt:classification>
072 ············<dt:classification> dt:ClassificationAttribute [0..1] Классификация продукции
073 ···············<dt:attrCode>INTENDED_USE</dt:attrCode> dt:CodeType [1..1] Код атрибута - Предназначение партии подконтрольной продукции
074 ···············<dt:attrName>Предназначение партии подконтрольной продукции</dt:attrName> bs:Ntext [1..1] Наименование атрибута
075 ···············<dt:classCode>?</dt:classCode> dt:CodeType [1..1]

Код значения атрибута "Предназначение партии подконтрольной продукции"

  • Возможные значения:
    • HUMAN_CONSUMPTION - в пищу людям
    • MANUFACTURING_HUMAN_CONSUMPTION - для переработки с целью получения подконтрольных товаров, предназначенных в пищу людям
    • DECONTAMINATION_HUMAN_CONSUMPTION - для переработки с обеззараживанием с целью получения подконтрольных товаров, предназначенных в пищу людям
    • ANIMAL_FEED - в корм животным
    • MANUFACTURING_ANIMAL_FEED - для переработки с целью получения подконтрольных товаров, предназначенных в корм животным
    • MEDICAL_USE - для медицинских целей
    • MANUFACTURING_MEDICAL_USE - для переработки с целью получения подконтрольных товаров, предназначенных для медицинских целей
    • SCIENTIFIC_PURPOSES - для биологических, ветеринарных и биотехнологических целей
    • MANUFACTURING_SCIENTIFIC_PURPOSES - для переработки с целью получения подконтрольных товаров, предназначенных для биологических, ветеринарных и биотехнологических целей
    • LABORATORY_TESTS - для диагностических и иных лабораторных исследований
    • TECHNICAL_PURPOSES - для технических целей
    • DISPOSAL - для утилизации
    • DESTRUCTION - для уничтожения
    • EXAMINATION - для проведения ветеринарно-санитарной экспертизы
076 ···············<dt:className>?</dt:className> bs:Text [1..1]

Наименование значения атрибута

  • Текстовое представление значения classCode:
    • В пищу людям
    • Для переработки с целью получения подконтрольных товаров, предназначенных в пищу людям
    • Для переработки с обеззараживанием с целью получения подконтрольных товаров, предназначенных в пищу людям
    • В корм животным
    • Для переработки с целью получения подконтрольных товаров, предназначенных в корм животным
    • Для медицинских целей
    • Для переработки с целью получения подконтрольных товаров, предназначенных для медицинских целей
    • Для биологических, ветеринарных и биотехнологических целей
    • Для переработки с целью получения подконтрольных товаров, предназначенных для биологических, ветеринарных и биотехнологических целей
    • Для диагностических и иных лабораторных исследований
    • Для технических целей
    • Для утилизации
    • Для уничтожения
    • Для проведения ветеринарно-санитарной экспертизы
077 ············</dt:classification>
078 ············<dt:attribute> dt:MeasuredAttribute [0..1] Дополнительный атрибут продукции
079 ···············<dt:attrCode>MILK_FAT_MASS_FRACTION</dt:attrCode> dt:CodeType [1..1] Код атрибута - Массовая доля жира
080 ···············<dt:attrName>Массовая доля жира</dt:attrName> bs:Ntext [1..1] Наименование атрибута
081 ···············<dt:attrValue> dt:ComplexMeasure [1..1]

Значение атрибута

  • Значение атрибута должно быть задано одним из следующих способов:
    • указано value - точное значение атрибута
    • указано minValue и maxValue - интервал значений атрибута
    • указано minValue - нижнее предельное значение (не ниже)
    • указано maxValue - верхнее предельное значение (не выше)
082 ··················<dt:value>?</dt:value> bs:Decimal [0..1]

Точное значение (%)

  • точность до 3-х знаков после запятой
083 ··················<dt:minValue>?</dt:minValue> bs:Decimal [0..1]

Минимальное значение (%)

  • точность до 3-х знаков после запятой
084 ··················<dt:maxValue>?</dt:maxValue> bs:Decimal [0..1]

Максимальное значение (%)

  • точность до 3-х знаков после запятой
085 ···············</dt:attrValue>
086 ············</dt:attribute>
087 ············<dt:attribute> dt:MeasuredAttribute [0..1] Дополнительный атрибут продукции
088 ···············<dt:attrCode>MILK_PROTEIN_MASS_FRACTION</dt:attrCode> dt:CodeType [1..1] Код атрибута - Массовая доля белка
089 ···············<dt:attrName>Массовая доля белка</dt:attrName> bs:Ntext [1..1] Наименование атрибута
090 ···············<dt:attrValue> dt:ComplexMeasure [1..1]

Значение атрибута

  • Значение атрибута должно быть задано одним из следующих способов:
    • указано value - точное значение атрибута
    • указано minValue и maxValue - интервал значений атрибута
    • указано minValue - нижнее предельное значение (не ниже)
    • указано maxValue - верхнее предельное значение (не выше)
091 ··················<dt:value>?</dt:value> bs:Decimal [0..1]

Точное значение (%)

  • точность до 3-х знаков после запятой
092 ··················<dt:minValue>?</dt:minValue> bs:Decimal [0..1]

Минимальное значение (%)

  • точность до 3-х знаков после запятой
093 ··················<dt:maxValue>?</dt:maxValue> bs:Decimal [0..1]

Максимальное значение (%)

  • точность до 3-х знаков после запятой
094 ···············</dt:attrValue>
095 ············</dt:attribute>
096 ············<dt:attribute> dt:MeasuredAttribute [0..1] Дополнительный атрибут продукции
097 ···············<dt:attrCode>DENSITY</dt:attrCode> dt:CodeType [1..1] Код атрибута - Плотность
098 ···············<dt:attrName>Плотность</dt:attrName> bs:Ntext [1..1] Наименование атрибута
099 ···············<dt:attrValue> dt:ComplexMeasure [1..1]

Значение атрибута

  • Значение атрибута должно быть задано одним из следующих способов:
    • указано value - точное значение атрибута
    • указано minValue и maxValue - интервал значений атрибута
100 ··················<dt:value>?</dt:value> bs:Decimal [0..1]

Точное значение (г/см3)

  • точность до 3-х знаков после запятой
101 ··················<dt:minValue>?</dt:minValue> bs:Decimal [0..1]

Минимальное значение (г/см3)

  • точность до 3-х знаков после запятой
102 ··················<dt:maxValue>?</dt:maxValue> bs:Decimal [0..1]

Максимальное значение (г/см3)

  • точность до 3-х знаков после запятой
103 ···············</dt:attrValue>
104 ············</dt:attribute>
105 ·········</dt:additionalCharacteristics>
106 ······</dt:productItem>
107 ···</merc:productItemList>
108 </merc:modifyProducerStockListResponse>

Классификатор справочников и перечислений Codelist

Описание классификатора приведено на странице: MercuryG2B:Codelist:v2.4r1

Дополнительные сведения об операции

Категория продукции

  1. Категория продукции может быть задана для типов продукции:
    1. мясо и мясопродукты;
    2. пищевые продукты;
    3. рыба и морепродукты.
  2. Для всей продукции кроме молока и молочных продуктов указанная категория справочно отображается в записи номенклатуры и не влияет на дальнейший учёт.
  3. При изменении номенклатуры для категории продукции действуют следующие правила:
    1. если категория отсутствует (UNDEFINED), то её можно изменить на: CONSUMER_PACKAGED (готовая продукция), INTERMEDIATE (полуфабрикат), RAW (сырьё), UNCLASSIFIED (не классифицировано);
    2. если ранее была указана категория UNCLASSIFIED (не классифицировано), то её можно изменить на: CONSUMER_PACKAGED (готовая продукция), INTERMEDIATE (полуфабрикат), RAW (сырье);
    3. если ранее были указаны категории CONSUMER_PACKAGED (готовая продукция), INTERMEDIATE (полуфабрикат), RAW (сырьё), то изменить категорию невозможно.
  4. Работа с качественными характеристиками молока и молочной продукции возможна только после указания для номенклатуры одной из категорий: CONSUMER_PACKAGED (готовая продукция), INTERMEDIATE (полуфабрикат), RAW (сырьё), UNCLASSIFIED (не классифицировано).


Категория задаётся с помощью блока classification дополнительных характеристик номенклатуры:

Пример фрагмента запроса 

...
<dt:classification>
	<dt:attrCode>PRODUCT_CATEGORY</dt:attrCode>    <!-- должно быть передано значение PRODUCT_CATEGORY - код задаваемого атрибута -->
	<dt:attrName>Категория продукции</dt:attrName> <!-- опционально -->
	<dt:classCode>CONSUMER_PACKAGED</dt:classCode> <!-- должно быть передано одно из значений для указанного кода атрибута: CONSUMER_PACKAGED, INTERMEDIATE, RAW, UNCLASSIFIED -->
	<dt:className>Готовая продукция</dt:className> <!-- опционально -->
</dt:classification>
...


Предназначение продукции

  1. В соответствии с 862 приказом в производственном ВСД должны быть указаны сведения о предназначении партии подконтрольной продукции. Под предназначением в данном случае понимается цель производства продукции. Эту цель определяет производитель.
  2. Предназначение может быть задано для номенклатурной позиции. В этом случае оно по умолчанию наследуется в производственную партию при оформлении пВСД, если в запросе на производство не указано иное значение.
  3. Список предназначений фиксирован и имеет перечислимый тип IntendedUseContentType, заданный в классификаторе MercuryG2B:Codelist:v2.4r1.


Предназначение для номенклатурной позиции задаётся с помощью блока classification дополнительных характеристик номенклатуры:

Пример фрагмента запроса с указанием предназначения 

...
<dt:classification>
	<dt:attrCode>INTENDED_USE</dt:attrCode>    <!-- должно быть передано значение INTENDED_USE - код задаваемого атрибута -->
	<dt:attrName>Предназначение партии подконтрольной продукции</dt:attrName> <!-- опционально -->
	<dt:classCode>HUMAN_CONSUMPTION</dt:classCode> <!-- должно быть передано одно из значений перечисления IntendedUseContentType для указанного кода атрибута -->
	<dt:className>В пищу людям</dt:className> <!-- опционально -->
</dt:classification>
...


Качественные характеристики молока и молочной продукции

  1. Под термином «Качественные характеристики молока и молочной продукции» понимается набор следующих атрибутов:
    1. массовая доля белка - задается в процентах с точностью до 3 знаков после запятой (включая 0% для точного значения и от 0% до N% для диапазона значений);
    2. массовая доля жира - задается в процентах с точностью до 3 знаков после запятой (включая 0% для точного значения и от 0% до N% для диапазона значений);
    3. плотность - задается в г/см3 с точностью до 3 знаков после запятой (больше нуля).
  2. Для атрибутов массовая доля белка и массовая доля жира доступен один из следующих вариантов указания:
    1. точное значение (пример: 3,2%);
    2. интервал значений (пример: от 2,8% до 3%);
    3. верхнее предельное значение (пример: не выше 10%);
    4. нижнее предельное значение (пример: не ниже 3,6%).
  3. Для атрибута плотность доступен один из следующих вариантов указания:
    1. точное значение (пример: 1,027 г/см3);
    2. интервал значений (пример: от 1,027 г/см3 до 1,033 г/см3).


Качественные характеристики задаются с помощью блоков attribute дополнительных характеристик номенклатуры:

Пример разных вариантов указания характеристик 

<!-- точное значение массовой доли жира (3,2%) -->
<dt:attribute>
	<dt:attrCode>MILK_FAT_MASS_FRACTION</dt:attrCode>
	<dt:attrName>Массовая доля жира</dt:attrName> 
	<dt:attrValue>
		<dt:value>3.2</dt:value>
	</dt:attrValue>
</dt:attribute>

<!-- диапазон значений массовой доли белка (от 2,8% до 3%) -->
<dt:attribute>
	<dt:attrCode>MILK_PROTEIN_MASS_FRACTION</dt:attrCode>
	<dt:attrName>Массовая доля белка</dt:attrName>
	<dt:attrValue>
		<dt:minValue>2.8</dt:minValue>
		<dt:maxValue>3.0</dt:maxValue>
	</dt:attrValue>
</dt:attribute>

<!-- верхнее предельное значение массовой доли белка (не выше 10%) -->
<dt:attribute>
	<dt:attrCode>MILK_PROTEIN_MASS_FRACTION</dt:attrCode>
	<dt:attrName>Массовая доля белка</dt:attrName>
	<dt:attrValue>
		<dt:maxValue>10.0</dt:maxValue>
	</dt:attrValue>
</dt:attribute>

<!-- нижнее предельное значение массовой доли жира (не ниже 3,6%) -->
<dt:attribute>
	<dt:attrCode>MILK_FAT_MASS_FRACTION</dt:attrCode>
	<dt:attrName>Массовая доля жира</dt:attrName>
	<dt:attrValue>
		<dt:minValue>3.6</dt:minValue>
	</dt:attrValue>
</dt:attribute>

<!-- диапазон значений плотности от 1,027 г/см3 до 1,033 г/см3 -->
<dt:attribute>
	<dt:attrCode>DENSITY</dt:attrCode>
	<dt:attrName>Плотность</dt:attrName>
	<dt:attrValue>
		<dt:minValue>1.027</dt:minValue>
		<dt:maxValue>1.033</dt:maxValue>
	</dt:attrValue>
</dt:attribute>


Примеры запросов

TODO

См. также

Вернуться к началу ↑
Вернуться на страницу профиля API MercuryG2B:Services:v3.0

Источник — http://help.vetrf.ru/index.php?title=MercuryG2B:ModifyProducerStockList:v3.0&oldid=38561