Описание сервисов: различия между версиями

|

Для использования Web-сервисов шлюза, рекомендуется использовать объект WSПрокси.  

|

<1c>

Фабрика = Прокси.ФабрикаXDTO;

</1c>

===== Возможные операции =====

==== ПроверитьПодключение ====

|

* Если подключение прошло успешно, возвращает значение "Подключено".

|

<1c>

КонецПроцедуры

</1c>

|

<file xml checkConnect.xml>

</soap-env:Envelope>

</file>

|

<file xml checkConnectResponse.xml>

</soap:Envelope>

</file>

==== СоздатьНоменклатуру ====

|

В случае если выгружаемая номенклатура уже есть в шлюзе, она будет обновлена. Если нет возможности выгрузить некоторые поля из учетной системы, их можно заполнить в шлюзе. При редактировании номенклатуры в шлюзе может возникнуть диалоговое окно, предлагающее запретить редактирование номенклатуры из учетной системы. С момента подтверждения запрета редактирования номенклатуре присваивается статус "РучнаяКорректировка" и редактирование номенклатуры при выгрузке в Шлюз будет заблокировано. Для того чтобы обратно включить редактирование необходимо нажать кнопку "Редактировать из учетной базы" в карточке номенклатуры.

При выгрузке документов новая номенклатура будет создаваться автоматически, однако, если не передавать при выгрузке ГУИД подкатегории и единицу хранения, перед регистрацией документа нужно сопоставить номенклатуру в Шлюзе.  

* Номенклатура (Тип: [[асп.шлюз_выгрузка:описание_типов#номенклатура|Номенклатура]])

* Строка, описывающая результат загрузки. В случае успешной загрузки будет выведено сообщение: "Номенклатура загружена: {Наименование номенклатуры}". Иначе, в ответе будет указана причина отказа.

|

<1c>

КонецПроцедуры

</1c>

|

<file xml createItem.xml>

</soap-env:Envelope>

</file>

|

<file xml createItemResponse.xml>

</soap:Envelope>

</file>

==== СоздатьХозСубъект ====

|

* ХозяйствующийСубъект (Тип: [[асп.шлюз_выгрузка:описание_типов#ХозяйствующийСубъект|ХозяйствующийСубъект]]);

* Обновить (Тип: boolean) - параметр указывает на необходимость обновления уже существующих хоз. субъектов.

Строка, описывающая результат загрузки. В случае успешной загрузки будет выведено сообщение: "Хоз.субъект загружен: {Наименование хоз. субъекта}". Иначе, в ответе будет указана причина отказа.

==== СоздатьПоднадзорного ====

|

В случае если при выгрузке не указан ХозСубъект, поднадзорный создан не будет. Шлюз вернет сообщение: "Не указан хозяйствующий субъект подразделения". Если указанных Хозяйствующий субъект не найден в Шлюзе по ИНН, он будет создан автоматически (в случае, если заполнены все необходимые поля). Если Шлюз не сумеет создать Хозяйствующий субъект, поднадзорный также не будет выгружен в Шлюз.  

* ПоднадзорныйОбъект (Тип: [[асп.шлюз_выгрузка:описание_типов#ПоднадзорныйОбъект|ПоднадзорныйОбъект]]);

* Обновить (Тип: boolean) - параметр указывает на необходимость обновления уже существующих поднадзорных объектов.

* Строка, описывающая результат загрузки. В случае успешной загрузки будет выведено сообщение: "Поднадзорный объект загружен: {Наименование поднадзорного} ({Код поднадзорного})". Иначе, в ответе будет указана причина отказа.

|

<1c>

КонецПроцедуры

</1c>

|

<file xml createEnt.xml>

</soap-env:Envelope>

</file>

|

<file xml createEntResponse.xml>

</soap:Envelope>

</file>

==== ОбработатьМассивДокументов ====

|

* ДанныеЗагрузки (Тип: [[асп.шлюз_выгрузка:описание_типов#ДанныеЗагрузки|ДанныеЗагрузки]]) - структура, содержащая массив обрабатываемых документов и параметры загрузки;

* ВозвращатьСертификаты (Тип: boolean) - если параметр принимает значение Истина, функция будет возвращать массив сертификатов, закрепленных за каждым выгружаемым документом.

* [[асп.шлюз_выгрузка:описание_типов#ДанныеОтвета|ДанныеОтвета]] - структура, содержащая массив результатов загрузки/регистрации документов.

* Для обновления контрагентов при выгрузке/регистрации документов необходимо в параметр ДанныеЗагрузки.ОбновитьКонтрагента передать значение Истина.

* Параметр ДанныеЗагрузки.Регистрировать отвечает за то, какая именно операция будет выполнена: Истина - регистрация в системе Меркурий, Ложь - загрузка документов в шлюз.

* Для выгрузи каких-либо сведений о создаваемой на остатке продукции (срок годности, дата выработки и т.д.) ВХОДИЩИМИ или ПРОИЗВОДСТВЕННЫМИ документами используется поле "ВетДокумент" табличной части "Товары". Таким образом, поле "Фильтр" устанавливает критерии отбора складской записи, а поле "ВетДокумент" - критерии создания.

* Для выгрузки розничной реалзации (розничного списания) нужно указать ДокументХ.ТипДокумента = "Инвентаризация" и ДокументХ.РозничнаяРеализация = Истина. В табличной части "Товары" указывается список списываемой в розницу продукции.  

|

<1c>

КонецПроцедуры

</1c>

|

<1c>

</1c>

|

<file xml request.xml>

</soap-env:Envelope>

</file>

|

<file xml response.xml>

</soap:Envelope>

</file>

==== ЗарегистрироватьДокументыПоСценарию ====

|

   - перемещение  

   - производство(производство-реализация)

   - перемещение - реализация

   - инвентаризация (создание остатков) - реализация

* ДанныеЗагрузки (Тип: [[асп.шлюз_выгрузка:описание_типов#ДанныеЗагрузки|ДанныеЗагрузки]]) - структура, содержащая массив обрабатываемых документов и параметры загрузки;

* ВозвращатьСертификаты (Тип: boolean) - если параметр принимает значение Истина, функция будет возвращать массив сертификатов, закрепленных за каждым выгружаемым документом.

* Сценарий (Тип: byte) - порядковый номер сценария.

[[асп.шлюз_выгрузка:описание_типов#ДанныеОтвета|ДанныеОтвета]] - структура, содержащая массив результатов загрузки/регистрации документов.  

* Для обновления контрагентов при выгрузке/регистрации документов необходимо в параметр ДанныеЗагрузки.ОбновитьКонтрагента передать значение Истина.

* Вызов сервиса и разбор ответа аналогичен "Обработать массив документов".

* Основой для групповой операции являются документы с типом "Реализация". (все документы загружаемые в шлюз должны иметь тип "Реализация")  

* При выгрузке документов групповой операцией, каждому создаваемому документу устанавливается определенный префикс в зависимости от выбранного сценария. Например, для операции производство + реализация будет добавлен префикс "ПР_",  для операции инвентаризация + реализация - "ИР_" и т.д.. При разборе ответа от шлюза нужно обрезать эти префиксы в номере документа перед поиском документа в учетной системе.

|

<1c>

ДанныеОтвета = Прокси.ЗарегистрироватьДокументыПоСценарию(ДанныеЗагрузки, ВозвращатьСертификаты, 1, Неопределено);

</1c>

|

<file xml rq_s.xml>

</soap-env:Envelope>

</file>

==== ЗагрузитьДокумент (устарел)====

|

* Документ (Тип: [[асп.шлюз_выгрузка:описание_типов#Документ|Документ]])

* ОбновитьКонтрагента (Тип: boolean) - параметр указывает на необходимость обновления уже существующих хоз. субъектов и поднадзорных объектов.

[[асп.шлюз_выгрузка:описание_типов#РезультатТранзакции|РезультатТранзакции]] - структура, содержащая результат загрузки документа в шлюз, а также список сертификатов и их УУИДы (если таковые имеются).  

==== ЗарегистрироватьДокумент ====

|

* Документ (Тип: [[асп.шлюз_выгрузка:описание_типов#Документ|Документ]])

* ОбновитьКонтрагента (Тип: boolean) - параметр указывает на необходимость обновления уже существующих хоз. субъектов и поднадзорных объектов.

[[асп.шлюз_выгрузка:описание_типов#РезультатТранзакции|РезультатТранзакции]] - структура, содержащая результат загрузки документа и регистрации его в системе Меркурий, а также список сертификатов и их УУИДы (если таковые имеются).  

==== ПолучитьИдентификаторыСертификатов ====

|

* НомерДокумента (Тип: string)

* ТипДокумента (Тип: string) - имя типа документа в шлюзе, или имя типа из учетной системы, занесенное в справочник СоответствияДокументов.

Строка, содержащая УУИДы сертификатов, закрепленных за документом. Разделителем является символ ";".  

|

<file xml getCertificateIdentifiers.xml>

</soap-env:Envelope>

</file>

==== ПолучитьСписокСертификатов ====

|

Операция предназначена для запроса списка сертификатов в Шлюзе, выписанных по определенному документу (список исходящих сертификатов по реализации товаров и услуг, список производственных сертификатов на по отчету производства за смену и т.д.).

*СписокДокументов (Тип: [[асп.шлюз_выгрузка:описание_типов#СписокДокументов|СписокДокументов]]) - структура, содержащая масив документов. Обязательные поля для заполнения передаваемых документов: ТипДокумента, Номер, Дата.

* СписокДокументов (Тип: [[асп.шлюз_выгрузка:описание_типов#СписокДокументов|СписокДокументов]]) - структура, содержащая массив сертификатов. Определить, к какому документу относится сертификат, можно по полю Сертификат.СертифицируемыйДокумент (Тип: [[асп.шлюз_выгрузка:описание_типов#Документ|Документ]]).

|

<1c>

КонецФункции

</1c>

|

<file xml certificateListRequest.xml>

</soap-env:Envelope>

</file>

|

<file xml response.xml>

</soap:Envelope>

</file>

==== ПолучитьСписокСертификатовМеркурий====

|

Результатом выполнения данной операции являются сведения о запрашиваемых ВСД.  

* КодПодразделения (Тип: string) - код поднадзорного объекта организации, по которому будут запрашиваться список сертификатов. Если а Шлюзе используется только одно подразделение, можно передавать пустую строку.

* Параметры (Тип: [[асп.шлюз_выгрузка:описание_типов#ПараметрыСписка|ПараметрыСписка]]) - параметры запрашиваемого списка ветеринарных сопроводительных документов (ВСД) предприятия.   

* СписокДокументов (Тип: [[асп.шлюз_выгрузка:описание_типов#СписокДокументов|СписокДокументов]]) - Структура, в которой поле СписокДокументов.Сертификаты будет содержать список запрашиваемых ВСД предприятия.   

|

<1c>

КонецПроцедуры

</1c>

|

<file xml getVetDocumentList.xml>

     </soap-env:Envelope>

</file>

|

<file xml getVetDocumentListResponse.xml>

</soap:Envelope>

</file>

==== ПолучитьСкладскиеЗаписиМеркурий====

|

Результатом выполнения данной операции являются сведения о всех актуальных записях складского журнала для запрашиваемого предприятия.

|

*КодПодразделения (Тип: string) - код поднадзорного объекта организации, по которому будут запрашиваться остатки. Если а Шлюзе используется только одно подразделение, можно передавать пустую строку.

* СкладскиеЗаписи(Тип: [[асп.шлюз_выгрузка:описание_типов#СкладскиеЗаписи|СкладскиеЗаписи]]) - структура, таблицу остатков по подразделению в системе Меркурий и общее количество позиций.

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

|

<1c>

КонецПроцедуры

</1c>

|

<file xml stockEntryListRequest.xml>

</soap-env:Envelope>

</file>

|

<file xml response.xml>

</soap:Envelope>

</file>

==== ЗагрузитьСпецификацию ====

|

* Спецификация (Тип: [[асп.шлюз_выгрузка:описание_типов#СпецификацияНоменклатуры|СпецификацияНоменклатуры]]) - структура, содержащая массив спецификаций. Для каждой конкретной спецификации происходит поиск номенклатуры и материала, из которого она производится, в справочнике Номенклатура. Если номенклатура или материал не найдены в справочнике, они будут созданы в момент выгрузки спецификации, или будет возвращена причина, по которой это сделать не удалось.  

* Строка, описывающая результат загрузки и имеющая следующую структуру: {РезультатЗагрузки} + "Загружено связей: " + {Количество загруженных связей}, где {РезультатЗагрузки} будет содержать информацию о том, почему не создалась та или иная спецификация.

|

<1c>

</1c>

|

<file xml addSpec.xml>

</soap-env:Envelope>

</file>

|

<file xml addSpecResponse.xml>

</soap:Envelope>

</file>

==== ОчиститьОчередьЗаявокПодПользователем====

|

* ВсеПользователи (Тип: boolean). Если передается значение Истина - очишается очередь заявок всех пользователей, иначе - только пользователя, от имени которого выполняется данная операция.

boolean, возвращает статус очистки очереди заявок. Истина - операция прошла успешно.

|

<1c>

КонецПроцедуры

</1c>

|

<file xml clearRequestQueue.xml>

     </soap-env:Envelope>

</file>

|

<file xml clearRequestQueueResponse.xml>

</soap:Envelope>

</file>

==== РазобратьОчередьЗаявок ====

|

boolean, возвращает статус разбора очереди заявок. Истина - операция прошла успешно.

|

<1c>

КонецПроцедуры

</1c>

|

<file xml readRequestQueue.xml>

     </soap-env:Envelope>

</file>

|

<file xml readRequestQueueResponse.xml>

</soap:Envelope>

</file>

==== ПолучитьДанныеРегистрацииХС====

|

* МассивИНН (Тип: [[асп.шлюз_выгрузка:описание_типов#МассивИНН|МассивИНН]] - объект, содержащий массив ИНН контрагентов (хоз. субъектов), данные по которым необходимо получить.  

[[асп.шлюз_выгрузка:описание_типов#ДанныеРегистрацииХС|ДанныеРегистрацииХС]].

|

<1c>

КонецПроцедуры

</1c>

|

<file xml hsRegistrationData.xml>

</soap-env:Envelope>

</file>

|

<file xml hsRegistrationDataResponse.xml>

</soap:Envelope>

</file>

==== ПолучитьГуидыНоменклатуры====

|

* МассивНоменклатуры (Тип: [[асп.шлюз_выгрузка:описание_типов#МассивНоменклатуры|МассивНоменклатуры]]   

[[асп.шлюз_выгрузка:описание_типов#ДанныеРегистрацииНоменклатуры|ДанныеРегистрацииНоменклатуры]].

|

<1c>

КонецПроцедуры

</1c>

|

<file xml productGuidListRequest.xml>

</soap-env:Envelope>

</file>

|

<file xml productGuidListResponse.xml>

</soap:Envelope>

</file>

==== ЗагрузитьГуидыНоменклатуры====

|

* ДанныеНоменклатуры (Тип: [[асп.шлюз_выгрузка:описание_типов#ДанныеРегистрацииНоменклатуры|ДанныеРегистрацииНоменклатуры]])   

Строка.

|

<1c>

</1c>

|

<file xml setProductGuid.xml>

</soap-env:Envelope>

</file>

|

<file xml setProductGuidResponse.xml>

</soap:Envelope>

</file>

====ПолучитьОшибкиАвторегистрации====

|

* ПериодОт (Тип: dateTime) - начало периода запроса списка ошибок;

* ПериодДо (Тип: dateTime) - конец периода запроса списка ошибок;  

* КодПодразделения (Тип: string)  - код подразделения организации;

* СписокДокументов (Тип: [[асп.шлюз_выгрузка:описание_типов#СписокДокументов|СписокДокументов]]) - список документов, по которым будет выполняться запрос ошибок.  

* ДанныеОтвета (Тип: [[асп.шлюз_выгрузка:описание_типов#ДанныеОтвета|ДанныеОтвета]]) - список документов и ошибок. Формат аналогичен результату выполнения операции ОбработатьМассивДокументов.

Разбор ответа аналогичен ОбработатьМассивДокументов.

|

<1c>

КонецПроцедуры

</1c>

|

<file xml request.xml>

</file>

|

<file xml Response.xml>

</file>

====АннулироватьМассивДокументов====

|

* ДанныеЗагрузки(Тип: [[асп.шлюз_выгрузка:описание_типов#ДанныеЗагрузки|ДанныеЗагрузки]]) - структура, содержащая массив обрабатываемых документов.

* Причина (Тип: string)  - причина аннулирования сертификатов;  

* ДанныеОтвета (Тип: [[асп.шлюз_выгрузка:описание_типов#ДанныеОтвета|ДанныеОтвета]]) - список документов и ошибок. Формат аналогичен результату выполнения операции ОбработатьМассивДокументов.

Разбор ответа аналогичен ОбработатьМассивДокументов.

|

<1c>

КонецПроцедуры

</1c>

|

<file xml request.xml>

</file>

|

<file xml Response.xml>

</file>

====АннулироватьМассивСертификатов====

|

* СписокДокументов(Тип: [[асп.шлюз_выгрузка:описание_типов#СписокДокументов|СписокДокументов]]) - структура, содержащая массив обрабатываемых сертификатов.

* Причина (Тип: string)  - причина аннулирования сертификатов;  

* Строка, содержащая информацию о результатах аннулирования.

|

<1c>

КонецПроцедуры

</1c>

|

<file xml request.xml>

</file>

|

<file xml Response.xml>

</file>

[[Category:Асп.шлюз выгрузка]]

<vote type=1 />