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

|

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

|

&НаСервере

Функция ПространствоИмен()

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

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

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

|

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

|

&НаСервере

Процедура ПроверитьПодключениеНаСервере()

Сообщить(Результат);

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

|

<file xml checkConnect.xml>

</soap-env:Envelope>

</file>

|

<file xml checkConnectResponse.xml>

</soap:Envelope>

</file>

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

|

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

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

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

|

Процедура ВыгрузитьНоменклатуруНаСервере()

Прокси = ПолучитьПрокси();

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

|

<file xml createItem.xml>

</soap-env:Envelope>

</file>

|

<file xml createItemResponse.xml>

</soap:Envelope>

</file>

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

|

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

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

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

|

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

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

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

|

Процедура ВыгрузитьКонтрагентаНаСервере()

Прокси = ПолучитьПрокси();

КонецЦикла;

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

|

<file xml createEnt.xml>

</soap-env:Envelope>

</file>

|

<file xml createEntResponse.xml>

</soap:Envelope>

</file>

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

|

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

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

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

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

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

|

Процедура ГрупповаяОбработкаДокументов()

Прокси = ПолучитьПрокси();

КонецЕсли;

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

|

Процедура РазобратьОтвет(ДанныеОтвета)

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

|

<file xml request.xml>

<soap-env:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/">

   <soap-env:Body>

<ns0:Номер>12345</ns0:Номер>

  <ns0:Транспорт>

<ns0:НомерАвтомобиля>х000хх00</ns0:НомерАвтомобиля>

  <ns0:Товары>

<ns0:ВетДокумент> <!-- Если нужна складская запись, сформированная в определенной день, нужно заполнить и ДатаВыработки и ДатаВыработкиДо -->

<ns0:ДатаВыработки>2017-12-21T00:00:00</ns0:ДатаВыработки>

<ns0:ИмяТовара>ИмяТовара</ns0:ИмяТовара> <!-- В данный момент работает  только в статическом режиме -->

</ns0:Фильтр>

  <ns0:СвязанныеДокументы>

  <ns0:СвязанныеДокументы>

   </soap-env:Body>

</soap-env:Envelope>

</file>

|

<file xml response.xml>

</soap:Envelope>

</file>

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

|

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

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

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

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

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

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

|

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

|

<file xml rq_s.xml>

<soap-env:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/">

   <soap-env:Body>

  <ns0:СвязанныеДокументы>

  <ns0:СвязанныеДокументы>

   </soap-env:Body>

</soap-env:Envelope>

</file>

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

|

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

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

|

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

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

|

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

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

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

|

<file xml getCertificateIdentifiers.xml>

<soap-env:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/">

   <soap-env:Body>

<ns0:ТипДокумента>Реализация</ns0:ТипДокумента>

<ns0:НомерДокумента>ЮГ00-000066</ns0:НомерДокумента>

   </soap-env:Body>

</soap-env:Envelope>

</file>

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

|

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

|

Функция ПолучитьСертификатыДокументов(МассивДокументов)

Для Каждого Док Из МассивДокументов Цикл

Если Сертификаты = "" И ПолучатьИзШлюза Тогда  

СписокДокументов = Фабрика.Создать(Фабрика.Тип(ПространствоИмен(),"СписокДокументов"));

Возврат МассивСертификатов;

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

|

<file xml certificateListRequest.xml>

<soap-env:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/">

   <soap-env:Body>

<ns0:СписокДокументов>

<ns0:Документы>

</ns0:Документы>

</ns0:СписокДокументов>

   </soap-env:Body>

</soap-env:Envelope>

</file>

|

<file xml response.xml>

<m:Дата>2018-03-02T16:12:30</m:Дата>

</m:СертифицируемыйДокумент>

<m:ДатаТТН>2018-03-02T16:12:30</m:ДатаТТН>

<m:ОтправительХозСубъект>ОтправительХозСубъект</m:ОтправительХозСубъект>

<m:КодПодкатегории>1902</m:КодПодкатегории>

<m:Номенклатура/>

<m:ЕдиницаХранения>кг</m:ЕдиницаХранения>

<m:ДатаВыработки>2018-03-01T00:00:00</m:ДатаВыработки>

<m:Дата>2018-03-02T16:13:27</m:Дата>

</m:СертифицируемыйДокумент>

<m:ДатаТТН>2018-03-02T16:13:27</m:ДатаТТН>

<m:ОтправительХозСубъект>ОтправительХозСубъект</m:ОтправительХозСубъект>

<m:КодПодкатегории>1902</m:КодПодкатегории>

<m:Номенклатура/>

<m:ЕдиницаХранения>кг</m:ЕдиницаХранения>

<m:ДатаВыработки>2018-03-01T00:00:00</m:ДатаВыработки>

</soap:Envelope>

</file>

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

|

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

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

|

Процедура ЗапроситьСписокСертификатовМеркурий()

Прокси = ПолучитьПрокси();

КонецЕсли;

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

|

<file xml getVetDocumentList.xml>

<ns0:Параметры>

<ns0:ТипСертификата>Входящий</ns0:ТипСертификата>

<ns0:ДатаОкончания>2019-06-01T23:59:59</ns0:ДатаОкончания>

</ns0:Параметры>

</file>

|

<file xml getVetDocumentListResponse.xml>

<m:КодПодкатегории/>

<m:Номенклатура>Подарок</m:Номенклатура>

<m:ЕдиницаХранения>кг</m:ЕдиницаХранения>

<m:ДатаВыработкиСтр>30.10.2018 0:00:00</m:ДатаВыработкиСтр>

<m:КодПодкатегории>1602</m:КодПодкатегории>

<m:Номенклатура>мясо рубленное по Сибирски</m:Номенклатура>

<m:ЕдиницаХранения>кг</m:ЕдиницаХранения>

<m:ДатаВыработкиСтр>03.03.2019 0:00:00</m:ДатаВыработкиСтр>

</soap:Envelope>

</file>

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

|

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

|

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

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

|

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

Прокси = ПолучитьПрокси();

Результат = Прокси.ПолучитьСкладскиеЗаписиМеркурий("00-000001");

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

|

<file xml stockEntryListRequest.xml>

<soap-env:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/">

   <soap-env:Body>

<ns0:КодПодразделения>00-000001</ns0:КодПодразделения>

   </soap-env:Body>

</soap-env:Envelope>

</file>

|

<file xml response.xml>

<m:Записи>

<m:Номенклатура>

<m:ПолныйКод/>

<m:Наименование>ПОЛУФАБРИКАТ ТВОРОЖНЫЙ ПРОДУКТ</m:Наименование>

<m:Записи>

<m:Номенклатура>

<m:ПолныйКод/>

<m:Наименование/>

<m:Записи>

<m:Номенклатура>

<m:ПолныйКод/>

<m:Наименование/>

<m:Записи>

<m:Номенклатура>

<m:ПолныйКод/>

<m:Наименование/>

</soap:Envelope>

</file>

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

|

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

|

#Область Спецификация

&НаКлиенте

#КонецОбласти

|

<file xml addSpec.xml>

</soap-env:Envelope>

</file>

|

<file xml addSpecResponse.xml>

</soap:Envelope>

</file>

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

|

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

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

|

Процедура ОчиститьОчередьЗаявокНаСервере()

Прокси = ПолучитьПрокси();

КонецЕсли;

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

|

<file xml clearRequestQueue.xml>

<ns0:ВсеПользователи>true</ns0:ВсеПользователи>

</file>

|

<file xml clearRequestQueueResponse.xml>

</soap:Envelope>

</file>

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

|

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

|

Процедура РазобратьОчередьЗаявокНаСервере()

Прокси = ПолучитьПрокси();

КонецЕсли;

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

|

<file xml readRequestQueue.xml>

</file>

|

<file xml readRequestQueueResponse.xml>

</soap:Envelope>

</file>

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

|

|

Процедура ПолучитьРегДанныеНаСервере()

Прокси = ПолучитьПрокси();

Результат = Прокси.ПолучитьДанныеРегистрацииХС(МассивИНН);

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

|

<file xml hsRegistrationData.xml>

<soap-env:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/">

   <soap-env:Body>

<ns0:МассивИНН>

<ns0:ИНН>7712092205</ns0:ИНН>

<ns0:ИНН>5042122899</ns0:ИНН>

</ns0:МассивИНН>

   </soap-env:Body>

</soap-env:Envelope>

</file>

|

<file xml hsRegistrationDataResponse.xml>

</soap:Envelope>

</file>

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

|

|

Процедура ПолучитьГуидыНоменклатурыНаСервере()

Прокси = ПолучитьПрокси();

Сообщить("Результат получен");

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

|

<file xml productGuidListRequest.xml>

<soap-env:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/">

   <soap-env:Body>

<ns0:МассивНоменклатуры>

<ns0:Номенклатура>

</ns0:Номенклатура>

</ns0:МассивНоменклатуры>

   </soap-env:Body>

</soap-env:Envelope>

</file>

|

<file xml productGuidListResponse.xml>

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<m:ДанныеНоменклатуры>

<m:КодЗагрузки/>

<m:Наименование>Моложеное Ассорти</m:Наименование>

</m:ДанныеНоменклатуры>

<m:ДанныеНоменклатуры>

<m:КодЗагрузки/>

<m:Наименование>ПОЛУФАБРИКАТ ТВОРОЖНЫЙ ПРОДУКТ</m:Наименование>

</soap:Envelope>

</file>