GetStockEntryListOperationForVetControl: различия между версиями
| Строка 56: | Строка 56: | ||
** [[VetDocument|vetd:VetDocument]] | ** [[VetDocument|vetd:VetDocument]] | ||
** [[StockEntry|vetd:StockEntry]] | ** [[StockEntry|vetd:StockEntry]] | ||
** [[StockEntryNumber|vetd:StockEntryNumber]] | |||
{{столбец}} | {{столбец}} | ||
* [[NameSpaces#http://www.w3.org/2001/XMLSchema|xs]] (<nowiki>http://www.w3.org/2001/XMLSchema</nowiki>) | * [[NameSpaces#http://www.w3.org/2001/XMLSchema|xs]] (<nowiki>http://www.w3.org/2001/XMLSchema</nowiki>) | ||
| Строка 97: | Строка 98: | ||
| '''localTransactionId''' || Идентификатор заявки в клиентской системе. || [http://www.w3.org/TR/xmlschema-2/#NCName xs:NCName] || 1 | | '''localTransactionId''' || Идентификатор заявки в клиентской системе. || [http://www.w3.org/TR/xmlschema-2/#NCName xs:NCName] || 1 | ||
|- | |- | ||
| [[ | | [[getStockEntryListOperationForVetControl#Объект ..Request/initiator|'''initiator''']] || Пользователь, инициирующий запрос к шлюзу. Ответственный за выполнение бизнес-операции. Должен быть указан или идентификатор, или логин. || [[User|argc:User]] || 1 | ||
|- | |- | ||
| [[ | | [[getStockEntryListOperationForVetControl#Объект ..Request/listOptions|'''listOptions''']] || Параметры запрашиваемого списка. || [[ListOptions|bs:ListOptions]] || 0..1 | ||
|- | |- | ||
| '''enterpriseGuid''' || Идентификатор предприятия, по которому производится поиск записей складского журнала. || [[UUID|bs:UUID]] || 1 | | '''enterpriseGuid''' || Идентификатор предприятия, по которому производится поиск записей складского журнала. || [[UUID|bs:UUID]] || 1 | ||
|} | |} | ||
=== Объект [[ | === Объект [[getStockEntryListOperationForVetControl#Объект getStockEntryListRequest|..Request]]/'''initiator''' === | ||
Объект содержит сведения о пользователе, инициирующем запрос к шлюзу. | Объект содержит сведения о пользователе, инициирующем запрос к шлюзу. | ||
{| class="wikitable" | {| class="wikitable" | ||
| Строка 121: | Строка 122: | ||
|} | |} | ||
=== Объект [[ | === Объект [[getStockEntryListOperationForVetControl#Объект getStockEntryListRequest|..Request]]/'''listOptions'''=== | ||
Объект содержит сведения о параметрах запрашиваемого списка записей складского журнала. | Объект содержит сведения о параметрах запрашиваемого списка записей складского журнала. | ||
{| class="wikitable" | {| class="wikitable" | ||
| Строка 159: | Строка 160: | ||
<bs:previous>{bs:UUID}</bs:previous> | <bs:previous>{bs:UUID}</bs:previous> | ||
<bs:next>{bs:UUID}</bs:next> | <bs:next>{bs:UUID}</bs:next> | ||
<vetd:entryNumber>{xs:string}</vetd:entryNumber> | |||
<vetd:batch> | <vetd:batch> | ||
<vetd:productType>{argpr:ProductType}</vetd:productType> | <vetd:productType>{argpr:ProductType}</vetd:productType> | ||
| Строка 234: | Строка 236: | ||
! Поле !! Описание !! Тип !! Обязательность | ! Поле !! Описание !! Тип !! Обязательность | ||
|- | |- | ||
|[[ | |[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList |'''stockEntryList''']]|| Список записей складского журнала продукции.|| [[StockEntry|vetd:StockEntry]] || 1 | ||
|} | |} | ||
===Объект [[ | ===Объект [[GetStockEntryListOperationForVetControl#Объект GetStockEntryListResponse|..Response]]/'''stockEntryList'''=== | ||
Объект содержит сведения о списке записей складского журнала продукции. | Объект содержит сведения о списке записей складского журнала продукции. | ||
{| class="wikitable" | {| class="wikitable" | ||
| Строка 243: | Строка 245: | ||
! Поле !! Описание !! Тип !! Обязательность | ! Поле !! Описание !! Тип !! Обязательность | ||
|- | |- | ||
|[[ | |[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry |'''stockEntry''']]|| Запись складского журнала продукции.|| [[StockEntry|vetd:StockEntry]] || 0..* | ||
|} | |} | ||
===Объект [[ | ===Объект [[GetStockEntryListOperationForVetControl#Объект GetStockEntryListResponse|..Response]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList|stockEntryList]]/'''stockEntry''' === | ||
Объект содержит сведения о записи складского журнала продукции. | Объект содержит сведения о записи складского журнала продукции. | ||
{| class="wikitable" | {| class="wikitable" | ||
| Строка 280: | Строка 282: | ||
|| [[StockEntryNumber|vetd:StockEntryNumber]] || 1 | || [[StockEntryNumber|vetd:StockEntryNumber]] || 1 | ||
|- | |- | ||
| [[ | | [[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry/batch|'''batch''']]|| Сведения о партии продукции. || [[Batch|vetd:Batch]] || 1 | ||
|} | |} | ||
===Объект [[ | ===Объект [[GetStockEntryListOperationForVetControl#Объект GetStockEntryListResponse|..Response]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList|stockEntryList]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/'''batch'''=== | ||
Объект содержит сведения о партии продукции. | Объект содержит сведения о партии продукции. | ||
{| class="wikitable" | {| class="wikitable" | ||
| Строка 291: | Строка 293: | ||
|'''productType'''|| Тип продукции. Первый уровень иерархического справочника продукции ИС Меркурий. || [[ProductType|argpr:ProductType]] || 1 | |'''productType'''|| Тип продукции. Первый уровень иерархического справочника продукции ИС Меркурий. || [[ProductType|argpr:ProductType]] || 1 | ||
|- | |- | ||
| [[ | | [[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry/batch/product|'''product''']]|| Продукция. Второй уровень иерархического справочника продукции ИС Меркурий. || [[Product|argpr:Product]] || 1 | ||
|- | |- | ||
| [[ | | [[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry/batch/subProduct|'''subProduct''']]||Вид продукции. Третий уровень иерархического справочника продукции ИС Меркурий. || [[SubProduct|argpr:SubProduct]] || 1 | ||
|- | |- | ||
| [[ | | [[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry/batch/productItem|'''productItem''']]||Наименование продукции в номенклатуре производителя. || [[ProductItem|argpr:ProductItem]] || 0..1 | ||
|- | |- | ||
| '''volume'''|| Объем продукции. | | '''volume'''|| Объем продукции. | ||
| Строка 301: | Строка 303: | ||
|| [[Decimal|bs:Decimal]] || 1 | || [[Decimal|bs:Decimal]] || 1 | ||
|- | |- | ||
| [[ | | [[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry/batch/unit|'''unit''']]|| Единица измерения объема партии продукции. || [[Unitl|argc:Unit]] || 1 | ||
|- | |- | ||
|[[ | |[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry/batch/packingList|'''packingList''']]|| Список видов упаковки. || [[PackingFormList|argc:PackingFormList]] || 0..1 | ||
|- | |- | ||
| '''packingAmount'''|| Общее количество единиц упаковки. || [http://www.w3.org/TR/xmlschema-2/#int xs:int] || 0..1 | | '''packingAmount'''|| Общее количество единиц упаковки. || [http://www.w3.org/TR/xmlschema-2/#int xs:int] || 0..1 | ||
| Строка 316: | Строка 318: | ||
|| [http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean] || 1 | || [http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean] || 1 | ||
|- | |- | ||
| [[ | | [[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry/batch/countryOfOrigin |'''countryOfOrigin''']] || Страна происхождения партии продукции. ||[[Country|ikar:Country]] || 1 | ||
|- | |- | ||
| [[ | | [[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry/batch/producerList | '''producerList''']] || Список производителей продукции.|| [[ProducerList|ent:ProducerList]] || 1 | ||
|- | |- | ||
| [[ | | [[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry/batch/productMarkingList | '''productMarkingList''']] || Список маркировки, доступный для данного производителя.|| [[ProductMarkingList|vetd:ProductMarkingList]] || 0..1 | ||
|- | |- | ||
|'''lowGradeCargo'''|| Является ли продукция некачественной. | |'''lowGradeCargo'''|| Является ли продукция некачественной. | ||
| Строка 327: | Строка 329: | ||
|| [http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean] || 1 | || [http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean] || 1 | ||
|- | |- | ||
| [[ | | [[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry/batch/owner | '''owner''' ]] || Хозяйствующий субъект-владелец продукции. || [[businessEntity|ent:BusinessEntity]] || 1 | ||
|} | |} | ||
===Объект [[ | ===Объект [[GetStockEntryListOperationForVetControl#Объект GetStockEntryListResponse|..Response]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList|stockEntryList]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry/batch|batch]]/'''product'''=== | ||
Объект содержит сведения о продукции; второй уровень иерархического справочника продукции ИС Меркурий. | Объект содержит сведения о продукции; второй уровень иерархического справочника продукции ИС Меркурий. | ||
{| class="wikitable" | {| class="wikitable" | ||
| Строка 341: | Строка 343: | ||
|} | |} | ||
===Объект [[ | ===Объект [[GetStockEntryListOperationForVetControl#Объект GetStockEntryListResponse|..Response]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList|stockEntryList]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry/batch|batch]]/'''subProduct'''=== | ||
Объект содержит сведения о видах продукции; третий уровень иерархического справочника продукции ИС Меркурий. | Объект содержит сведения о видах продукции; третий уровень иерархического справочника продукции ИС Меркурий. | ||
{| class="wikitable" | {| class="wikitable" | ||
| Строка 352: | Строка 354: | ||
|} | |} | ||
===Объект [[ | ===Объект [[GetStockEntryListOperationForVetControl#Объект GetStockEntryListResponse|..Response]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList|stockEntryList]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry/batch|batch]]/'''productItem'''=== | ||
Объект содержит сведения о наименовании продукции. | Объект содержит сведения о наименовании продукции. | ||
{| class="wikitable" | {| class="wikitable" | ||
| Строка 368: | Строка 370: | ||
|} | |} | ||
===Объект [[ | ===Объект [[GetStockEntryListOperationForVetControl#Объект GetStockEntryListResponse|..Response]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList|stockEntryList]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry/batch|batch]]/'''unit'''=== | ||
Объект содержит сведения о единице измерения объема партии продукции. | Объект содержит сведения о единице измерения объема партии продукции. | ||
{| class="wikitable" | {| class="wikitable" | ||
| Строка 379: | Строка 381: | ||
|} | |} | ||
===Объект [[ | ===Объект [[GetStockEntryListOperationForVetControl#Объект GetStockEntryListResponse|..Response]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList|stockEntryList]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry/batch|batch]]/'''packingList'''=== | ||
Объект содержит сведения о списке видов упаковки, которые используются для партии продукции. | Объект содержит сведения о списке видов упаковки, которые используются для партии продукции. | ||
{| class="wikitable" | {| class="wikitable" | ||
| Строка 385: | Строка 387: | ||
! Поле !! Описание !! Тип !! Обязательность | ! Поле !! Описание !! Тип !! Обязательность | ||
|- | |- | ||
| [[ | | [[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry/batch/packingList/packingForm|'''packingForm''']] || Вид упаковки. || [[PackingForm|vetd:PackingForm]] || 0..* | ||
|} | |} | ||
===Объект [[ | ===Объект [[GetStockEntryListOperationForVetControl#Объект GetStockEntryListResponse|..Response]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList|stockEntryList]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry/batch|batch]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry/batch/packingList|packingList]]/'''packingForm'''=== | ||
Объект содержит сведения о виде упаковки, которая используются для партии продукции. | Объект содержит сведения о виде упаковки, которая используются для партии продукции. | ||
{| class="wikitable" | {| class="wikitable" | ||
| Строка 399: | Строка 401: | ||
|} | |} | ||
===Объект [[ | ===Объект [[GetStockEntryListOperationForVetControl#Объект GetStockEntryListResponse|..Response]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList|stockEntryList]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry/batch|batch]]/'''countryOfOrigin'''=== | ||
Объект содержит сведения о стране-происхождения продукции. | Объект содержит сведения о стране-происхождения продукции. | ||
{| class="wikitable" | {| class="wikitable" | ||
| Строка 410: | Строка 412: | ||
|} | |} | ||
===Объект [[ | ===Объект [[GetStockEntryListOperationForVetControl#Объект GetStockEntryListResponse|..Response]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList|stockEntryList]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry/batch|batch]]/'''producerList'''=== | ||
Объект содержит сведения о списке производителей продукции. | Объект содержит сведения о списке производителей продукции. | ||
{| class="wikitable" | {| class="wikitable" | ||
| Строка 416: | Строка 418: | ||
! Поле !! Описание !! Тип !! Обязательность | ! Поле !! Описание !! Тип !! Обязательность | ||
|- | |- | ||
|[[ | |[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry/batch/producerList/producer|'''producer''' ]] || Производитель продукции.|| [[Producer|vetd:Producer]] || 0..* | ||
|} | |} | ||
===Объект [[ | ===Объект [[GetStockEntryListOperationForVetControl#Объект GetStockEntryListResponse|..Response]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList|stockEntryList]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry/batch|batch]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry/batch/producerList|producerList]]/'''producer'''=== | ||
Объект содержит сведения о производителе продукции. | Объект содержит сведения о производителе продукции. | ||
{| class="wikitable" | {| class="wikitable" | ||
| Строка 425: | Строка 427: | ||
! Поле !! Описание !! Тип !! Обязательность | ! Поле !! Описание !! Тип !! Обязательность | ||
|- | |- | ||
| [[ | | [[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry/batch/producerList/producer/enterprise | '''enterprise''']] || Информация о предприятие-производителе продукции.|| [[Enterprise|ent:Enterprise]] || 1 | ||
|- | |- | ||
| '''role''' ||Роль предприятия-производителя продукции.|| [[EnterpriseRole|ent:EnterpriseRole]] || 1 | | '''role''' ||Роль предприятия-производителя продукции.|| [[EnterpriseRole|ent:EnterpriseRole]] || 1 | ||
|} | |} | ||
===Объект [[ | ===Объект [[GetStockEntryListOperationForVetControl#Объект GetStockEntryListResponse|..Response]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList|stockEntryList]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry/batch|batch]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry/batch/producerList|producerList]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry/batch/producerList/producer|producer]]/'''enterprise'''=== | ||
Объект содержит сведение о предприятие-производителе продукции. | Объект содержит сведение о предприятие-производителе продукции. | ||
{| class="wikitable" | {| class="wikitable" | ||
| Строка 441: | Строка 443: | ||
|} | |} | ||
===Объект [[ | ===Объект [[GetStockEntryListOperationForVetControl#Объект GetStockEntryListResponse|..Response]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList|stockEntryList]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry/batch|batch]]/'''productMarkingList'''=== | ||
Объект содержит сведения о списке маркировки. | Объект содержит сведения о списке маркировки. | ||
{| class="wikitable" | {| class="wikitable" | ||
| Строка 450: | Строка 452: | ||
|} | |} | ||
===Объект [[ | ===Объект [[GetStockEntryListOperationForVetControl#Объект GetStockEntryListResponse|..Response]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList|stockEntryList]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/[[GetStockEntryListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry/batch|batch]]/'''owner'''=== | ||
Объект содержит сведения о хозяйствующем субъекте-владельце продукции. | Объект содержит сведения о хозяйствующем субъекте-владельце продукции. | ||
{| class="wikitable" | {| class="wikitable" | ||
Версия 22:57, 12 мая 2016
Общие сведения
Операция GetStockEntryListOperation предназначена для получения актуального списка записей складского журнала.
Складской журнал продукции в системе Меркурий ведется с применением версионирования, это означает, что при каждом изменении записи складского журнала создается новая версия этой записи.
- GUID - глобальный идентификатор записи складского журнала. Данный идентификатор остается неизменным для всех версий записи складского журнала.
- UUID - идентификатор версии записи складского журнала. Данный идентификатор изменяется для каждой новой версии записи складского журнала.
Так же следует различать актуальную и неактуальную версию записи складского журнала. Для одной записи журнала может существовать только одна актуальная версия.
При выполнении операции GetStockEntryListOperation на вход системы передаются следующие сведения:
- информация о пользователе - инициаторе запроса;
- информация о предприятии, на котором осуществляется поиск записей складского журнала;
Результатом выполнения данной операции является:
- пользователю передаются сведения о всех актуальных записях складского журнала.
Запрашиваться могут только те записи складского журнала продукции, где хозяйствующий-субъект инициатор запроса является владельцем продукции.
Возможные сценарии
При обработке запроса возможны следующие сценарии:
- Запрос успешно обработан.
- Произошла ошибка при обработке запроса.
- Некорректный запрос.
- Внутренняя ошибка системы.
Используемые пространства имён и типы
Данные запроса
Структура данных запроса в формате ХML.
<merc:getStockEntryListRequest xmlns:merc="http://api.vetrf.ru/schema/cdm/mercury/applications"
xmlns:base="http://api.vetrf.ru/schema/cdm/base"
xmlns:com="http://api.vetrf.ru/schema/cdm/argus/common"
xmlns:ent="http://api.vetrf.ru/schema/cdm/cerberus/enterprise">
<merc:localTransactionId>{xs:NCName}</merc:localTransactionId>
<merc:initiator>
<base:uuid>{bs:UUID}</base:uuid>
<com:login>{xs:NCName}</com:login>
</merc:initiator>
<base:listOptions>
<base:count>{xs:nonNegativeInteger}</base:count>
<base:offset>{xs:nonNegativeInteger}</base:offset>
</base:listOptions>
<ent:enterpriseGuid>{bs:UUID}</ent:enterpriseGuid>
</merc:getStockEntryListRequest>
Объект getStockEntryListRequest
Корневой элемент содержимого заявки на получение актуального списка записей складского журнала.
| Поле | Описание | Тип | Обязательность |
|---|---|---|---|
| localTransactionId | Идентификатор заявки в клиентской системе. | xs:NCName | 1 |
| initiator | Пользователь, инициирующий запрос к шлюзу. Ответственный за выполнение бизнес-операции. Должен быть указан или идентификатор, или логин. | argc:User | 1 |
| listOptions | Параметры запрашиваемого списка. | bs:ListOptions | 0..1 |
| enterpriseGuid | Идентификатор предприятия, по которому производится поиск записей складского журнала. | bs:UUID | 1 |
Объект ..Request/initiator
Объект содержит сведения о пользователе, инициирующем запрос к шлюзу.
| Поле | Описание | Тип | Обязательность |
|---|---|---|---|
| UUID | Идентификатор пользователя, зарегистрированного в системе Меркурий. | bs:UUID | 1 - обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо login. При указании обоих полей, приоритет у UUID. |
| login | Логин пользователя. | xs:NCName |
Объект ..Request/listOptions
Объект содержит сведения о параметрах запрашиваемого списка записей складского журнала.
| Поле | Описание | Тип | Обязательность |
|---|---|---|---|
| count | Максимальное запрашиваемое количество объектов в списке.
|
xs:nonNegativeInteger | 0..1 |
| offset | Номер элемента, по которому осуществляется смещение первого элемента списка.
|
xs:nonNegativeInteger | 0..1 |
Данные ответа
Структура данных ответа в формате ХML.
<merc:getStockEntryListResponse xmlns:merc="http://api.vetrf.ru/schema/cdm/mercury/applications"
xmlns:vetd="http://api.vetrf.ru/schema/cdm/mercury/vet-document"
xmlns:bs="http://api.vetrf.ru/schema/cdm/base"
xmlns:prod="http://api.vetrf.ru/schema/cdm/argus/production"
xmlns:argc="http://api.vetrf.ru/schema/cdm/argus/common"
xmlns:ent="http://api.vetrf.ru/schema/cdm/cerberus/enterprise">
<vetd:stockEntryList>
<vetd:stockEntry>
<bs:uuid>{bs:UUID}</bs:uuid>
<bs:guid>{bs:UUID}</bs:guid>
<bs:active>{xs:boolean}</bs:active>
<bs:last>{xs:boolean}</bs:last>
<bs:status>{bs:VersionStatus}</bs:status>
<bs:createDate>{xs:dateTime}</bs:createDate>
<bs:updateDate>{xs:dateTime}</bs:updateDate>
<bs:previous>{bs:UUID}</bs:previous>
<bs:next>{bs:UUID}</bs:next>
<vetd:entryNumber>{xs:string}</vetd:entryNumber>
<vetd:batch>
<vetd:productType>{argpr:ProductType}</vetd:productType>
<vetd:product>
<bs:uuid>{bs:UUID}</bs:uuid>
<bs:guid>{bs:UUID}</bs:guid>
</vetd:product>
<vetd:subProduct>
<bs:uuid>{bs:UUID}</bs:uuid>
<bs:guid>{bs:UUID}</bs:guid>
</vetd:subProduct>
<vetd:productItem>
<prod:name>{bs:String255}</prod:name>
</vetd:productItem>
<vetd:volume>{bs:Decimal}</vetd:volume>
<vetd:unit>
<bs:uuid>{bs:UUID}</bs:uuid>
<bs:guid>{bs:UUID}</bs:guid>
</vetd:unit>
<vetd:packingList>
<argc:packingForm>
<bs:uuid>{bs:UUID}</bs:uuid>
<argc:name>{bs:String255}</argc:name>
</argc:packingForm>
</vetd:packingList>
<vetd:packingAmount>{xs:int}</vetd:packingAmount>
<vetd:dateOfProduction>
<vetd:firstDate>
<bs:year>{bs:Year}</bs:year>
<bs:month>{bs:Month}</bs:month>
<bs:day>{bs:Day}</bs:day>
</vetd:firstDate>
</vetd:dateOfProduction>
<vetd:expiryDate>
<vetd:firstDate>
<bs:year>{bs:Year}</bs:year>
<bs:month>{bs:Month}</bs:month>
<bs:day>{bs:Day}</bs:day>
</vetd:firstDate>
</vetd:expiryDate>
<vetd:perishable>{xs:boolean}</vetd:perishable>
<vetd:countryOfOrigin>
<bs:uuid>{bs:UUID}</bs:uuid>
<bs:guid>{bs:UUID}</bs:guid>
</vetd:countryOfOrigin>
<vetd:producerList>
<ent:producer>
<ent:enterprise>
<bs:uuid>{bs:UUID}</bs:uuid>
<bs:guid>{bs:UUID}</bs:guid>
</ent:enterprise>
<ent:role>{ent:EnterpriseRole}</ent:role>
</ent:producer>
</vetd:producerList>
<vetd:productMarkingList>
<vetd:productMarking>{bs:String255}</vetd:productMarking>
</vetd:productMarkingList>
<vetd:lowGradeCargo>{xs:boolean}</vetd:lowGradeCargo>
<vetd:owner>
<bs:uuid>{bs:UUID}</bs:uuid>
<bs:guid>{bs:UUID}</bs:guid>
</vetd:owner>
</vetd:batch>
</vetd:stockEntry>
</vetd:stockEntryList>
</merc:getStockEntryListResponse>
Объект GetStockEntryListResponse
Объект содержит сведения о результатах обработки запроса на получение актуального списка записей складского журнала.
| Поле | Описание | Тип | Обязательность |
|---|---|---|---|
| stockEntryList | Список записей складского журнала продукции. | vetd:StockEntry | 1 |
Объект ..Response/stockEntryList
Объект содержит сведения о списке записей складского журнала продукции.
| Поле | Описание | Тип | Обязательность |
|---|---|---|---|
| stockEntry | Запись складского журнала продукции. | vetd:StockEntry | 0..* |
Объект ..Response/stockEntryList/stockEntry
Объект содержит сведения о записи складского журнала продукции.
| Поле | Описание | Тип | Обязательность |
|---|---|---|---|
| UUID | Идентификатор версии записи журнала. | bs:UUID | 1 |
| GUID | Глобальный идентификатор записи журнала. | bs:UUID | 1 |
| active | Является ли запись журнала активной:
|
xs:boolean | 1 |
| last | Последняя версия записи журнала:
|
xs:boolean | 1 |
| status | Статус версии записи журнала. | bs:VersionStatus | 1 |
| createDate | Дата создания записи журнала. | xs:DateTime | 1 |
| updateDate | Дата изменения записи журнала. | xs:DateTime | 1 |
| previous | Идентификатор предыдущей версии записи журнала. | bs:UUID | 0..1 |
| next | Идентификатор следующей версии записи журнала. | bs:UUID | 0..1 |
| entryNumber | Номер записи в складском журнале Меркурия.
|
vetd:StockEntryNumber | 1 |
| batch | Сведения о партии продукции. | vetd:Batch | 1 |
Объект ..Response/stockEntryList/stockEntry/batch
Объект содержит сведения о партии продукции.
| Поле | Описание | Тип | Обязательность |
|---|---|---|---|
| productType | Тип продукции. Первый уровень иерархического справочника продукции ИС Меркурий. | argpr:ProductType | 1 |
| product | Продукция. Второй уровень иерархического справочника продукции ИС Меркурий. | argpr:Product | 1 |
| subProduct | Вид продукции. Третий уровень иерархического справочника продукции ИС Меркурий. | argpr:SubProduct | 1 |
| productItem | Наименование продукции в номенклатуре производителя. | argpr:ProductItem | 0..1 |
| volume | Объем продукции.
|
bs:Decimal | 1 |
| unit | Единица измерения объема партии продукции. | argc:Unit | 1 |
| packingList | Список видов упаковки. | argc:PackingFormList | 0..1 |
| packingAmount | Общее количество единиц упаковки. | xs:int | 0..1 |
| dateOfProduction | Дата выработки продукции. Может быть указана тремя способами: датой, диапазоном дат, строкой. В случае точной даты выработки указывается только первая компонента - firstDate. | vetd:GoodsDate | 1 |
| expiryDate | Дата окончания срока годности продукции. Может быть указана тремя способами: датой, диапазоном дат, строкой. В случае точной даты выработки указывается только первая компонента - firstDate. | vetd:GoodsDate | 1 |
| perishable | Описывает, является ли продукция скоропортящейся:
|
xs:boolean | 1 |
| countryOfOrigin | Страна происхождения партии продукции. | ikar:Country | 1 |
| producerList | Список производителей продукции. | ent:ProducerList | 1 |
| productMarkingList | Список маркировки, доступный для данного производителя. | vetd:ProductMarkingList | 0..1 |
| lowGradeCargo | Является ли продукция некачественной.
|
xs:boolean | 1 |
| owner | Хозяйствующий субъект-владелец продукции. | ent:BusinessEntity | 1 |
Объект ..Response/stockEntryList/stockEntry/batch/product
Объект содержит сведения о продукции; второй уровень иерархического справочника продукции ИС Меркурий.
| Поле | Описание | Тип | Обязательность |
|---|---|---|---|
| UUID | Идентификатор версии продукции. | bs:UUID | 1 |
| GUID | Глобальный идентификатор продукции. | bs:UUID | 1 |
Объект ..Response/stockEntryList/stockEntry/batch/subProduct
Объект содержит сведения о видах продукции; третий уровень иерархического справочника продукции ИС Меркурий.
| Поле | Описание | Тип | Обязательность |
|---|---|---|---|
| UUID | Идентификатор версии вида продукции. | bs:UUID | 1 |
| GUID | Глобальный идентификатор продукции. | bs:UUID | 1 |
Объект ..Response/stockEntryList/stockEntry/batch/productItem
Объект содержит сведения о наименовании продукции.
| Поле | Описание | Тип | Обязательность |
|---|---|---|---|
| UUID | Идентификатор версии наименования продукции. | bs:UUID | 1 - возвращается или UUID или name, либо оба значения. |
| name | Наименование продукции в соответствии с номенклатурой производителя. | xs:string |
Объект ..Response/stockEntryList/stockEntry/batch/unit
Объект содержит сведения о единице измерения объема партии продукции.
| Поле | Описание | Тип | Обязательность |
|---|---|---|---|
| UUID | Идентификатор версии единицы измерения. | bs:UUID | 1 |
| GUID | Глобальный идентификатор единицы измерения. | bs:UUID | 1 |
Объект ..Response/stockEntryList/stockEntry/batch/packingList
Объект содержит сведения о списке видов упаковки, которые используются для партии продукции.
| Поле | Описание | Тип | Обязательность |
|---|---|---|---|
| packingForm | Вид упаковки. | vetd:PackingForm | 0..* |
Объект ..Response/stockEntryList/stockEntry/batch/packingList/packingForm
Объект содержит сведения о виде упаковки, которая используются для партии продукции.
| Поле | Описание | Тип | Обязательность |
|---|---|---|---|
| UUID | Идентификатор упаковки. | bs:UUID | 1 |
| name | Наименование конкретного вида упаковки. | xs:string | 0..1 |
Объект ..Response/stockEntryList/stockEntry/batch/countryOfOrigin
Объект содержит сведения о стране-происхождения продукции.
| Поле | Описание | Тип | Обязательность |
|---|---|---|---|
| UUID | Идентификатор версии страны происхождения. | bs:UUID | 1 |
| GUID | Глобальный идентификатор страны происхождения. | bs:UUID | 1 |
Объект ..Response/stockEntryList/stockEntry/batch/producerList
Объект содержит сведения о списке производителей продукции.
| Поле | Описание | Тип | Обязательность |
|---|---|---|---|
| producer | Производитель продукции. | vetd:Producer | 0..* |
Объект ..Response/stockEntryList/stockEntry/batch/producerList/producer
Объект содержит сведения о производителе продукции.
| Поле | Описание | Тип | Обязательность |
|---|---|---|---|
| enterprise | Информация о предприятие-производителе продукции. | ent:Enterprise | 1 |
| role | Роль предприятия-производителя продукции. | ent:EnterpriseRole | 1 |
Объект ..Response/stockEntryList/stockEntry/batch/producerList/producer/enterprise
Объект содержит сведение о предприятие-производителе продукции.
| Поле | Описание | Тип | Обязательность |
|---|---|---|---|
| UUID | Идентификатор версии предприятия-производителя продукции. | bs:UUID | 1 |
| GUID | Глобальный идентификатор предприятия-производителя продукции. | bs:UUID | 1 |
Объект ..Response/stockEntryList/stockEntry/batch/productMarkingList
Объект содержит сведения о списке маркировки.
| Поле | Описание | Тип | Обязательность |
|---|---|---|---|
| productMarking | Строка с маркировкой продукции. | bs:String255 | 0..* |
Объект ..Response/stockEntryList/stockEntry/batch/owner
Объект содержит сведения о хозяйствующем субъекте-владельце продукции.
| Поле | Описание | Тип | Обязательность |
|---|---|---|---|
| UUID | Идентификатор версии хозяйствующего субъекта - владельца продукции. | bs:UUID | 1 |
| GUID | Глобальный идентификатор хозяйствующего субъекта - владельца продукции. | bs:UUID | 1 |
Пример запроса
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ws="http://api.vetrf.ru/schema/cdm/application/ws-definitions"
xmlns:app="http://api.vetrf.ru/schema/cdm/application"
xmlns:merc="http://api.vetrf.ru/schema/cdm/mercury/applications"
xmlns:base="http://api.vetrf.ru/schema/cdm/base"
xmlns:com="http://api.vetrf.ru/schema/cdm/argus/common"
xmlns:ent="http://api.vetrf.ru/schema/cdm/cerberus/enterprise"
xmlns:ikar="http://api.vetrf.ru/schema/cdm/ikar"
xmlns:vet="http://api.vetrf.ru/schema/cdm/mercury/vet-document"
xmlns:prod="http://api.vetrf.ru/schema/cdm/argus/production"
xmlns:shp="http://api.vetrf.ru/schema/cdm/argus/shipment">
<soapenv:Header/>
<soapenv:Body>
<ws:submitApplicationRequest>
<ws:apiKey>apiKey</ws:apiKey>
<app:application>
<app:serviceId>mercury-g2b.service</app:serviceId>
<app:issuerId>issuerId</app:issuerId>
<app:issueDate>2016-01-07T17:03:00</app:issueDate>
<app:data>
<merc:getStockEntryListRequest>
<merc:localTransactionId>abc</merc:localTransactionId>
<merc:initiator>
<com:login>user</com:login>
</merc:initiator>
<base:listOptions>
<base:count>10</base:count>
</base:listOptions>
<ent:enterpriseGuid>entGuid</ent:enterpriseGuid>
</merc:getStockEntryListRequest>
</app:data>
</app:application>
</ws:submitApplicationRequest>
</soapenv:Body>
</soapenv:Envelope>
Коды ошибок
В таблице содержатся коды ошибок, которые могут возникать при обращении к приложению.
| Код ошибки | Описание |
|---|---|
| MERC37180 | Предприятие с указанным идентификатором не найдено в реестре РСХН, либо идентификатор не соответствует установленному формату. |
