ТП5 <- start <- [[ТП5: Web_сервис|Web_сервис]] < [[ТП5:Web_сервис:Обмен_документами|Web-сервис обмена документами]]
==== Настройка «Кассир 5» для работы с WEB-сервисом по обмену документами ====
Обмен документами и номенклатурой товаров между конфигурацией и ПО «Кассир 5» осуществляться осуществляться стандартным образом:
  * по FTP;
  * вручную (через дискеты);
  * по локальной сети;
  * через HTTP сервис ;
  * по электронной почте;
  * через облачный сервис.

Чтобы использовать электронный документооборот через Web-сервис, необходимо выполнить настройку кассового ПО. Для этого используется закладка «**Документы Онлайн**» (позиция «Настройка» → закладка «Дополнительные» → кнопка «Настройка документов» → закладка «Документы Онлайн»). Закладка включена в раздел «Настройка» только в том случае, когда в «Кассир 5» подключен модуль логики «Документы Онлайн» — в папке …DB\ExtFiles\LogicalModules zip-архив «ДокументыОнлайн.zip» распакован.

Закладка «**Документы Онлайн**» содержит группу настроек подключения к WEB-сервису. Она позволяет задать адрес WEB-сервисов по обмену документами и получению на кассе отчётов из товароучетной системы, а также имя и пароль пользователя конфигурации ТП 5, через которого осуществляется контроль доступа к онлайн сервисам.

Поле «**WSDL Doctransfert**» определяет реквизиты WEB-сервиса передачи документов. Составные части адреса следующие:
  * «http:/ /» протокол передачи данных (обязательный реквизит);
  * IP-адрес компьютера на котором опубликованы WEB-сервисы и, через двоеточие, порт для обмена данными. Номер порта определяется в файле конфигурации программы для работы с WEB-сервером. Например, в программе «Apache» - реквизит «Listen» в файле «httpd.conf» папки «conf»;
  * через символ «/» задается имя файла с настройкой публикации WEB-сервера (см. «[[ТП5:Web_сервис:Публикация|Публикация Web-сервисов в ТП 5]]»);
  * через символ «/» задается имя WEB-сервиса «/ws/DocTransfert.1cws?wsdl, где «/ws» – признак того, что выполняется обращение к Web- сервису.

//Например, в строке // \\
**http://101.102.5.7:8080/TP5/ws/DocTransfert.1cws?wsdl** \\
указаны следующие реквизиты:
  * **101.102.5.7:8080** – IP-адрес компьютера, на котором опубликован WEB-сервер, и номер порта для обмена данными с WEB-сервисом. Для удаленного компьютера требуется статический IP-адрес;
  * **TP5** — [[ТП5:Web_сервис:Публикация|имя публикации WEB-сервиса]];
  * **ws** – признак того, что выполняется обращение к Web- сервису;
  * **DocTransfert.1cws?wsdl** – имя WEB-сервиса для обмена данными между конфигурацией ТП 5 и ПО «Кассир 5».

Поле «**WSDL Reports**» определяет реквизиты WEB-сервиса формирования на кассе отчетов из товароучетной системы. Подробнее см. «[[ТП5:Web_сервис:Формирование_на_кассе_отчетов:Настройка_кассы|Настройка конфигурации и ПО «Кассир-5» для WEB-сервиса формирования отчетов]]».

В полях «**Логин**» и «**Пароль**» задаются имя и пароль пользователя ТП 5, которые определены в форме «**[[ТП5:Web_сервис:Задание_пользователя|Пользователь]]**» конфигуратора. Когда кассовое ПО подключается к WEB-сервисам ТП 5, делается штатная авторизация средствами 1C по этому пользователю. Если авторизация прошла успешно, связь с WEB-сервисами устанавливается. Если авторизация не прошла, вернётся ошибка авторизации, и работа с WEB-сервисами на кассе будет не доступна. Этот механизм авторизации реализован для защиты от несанкционированного доступа. __Логин и пароль пользователя должны содержать только буквы латинского алфавита, цифры и знаки препинания__.

Задание флага «**''Проверять секцию подбираемых товаров''**» позволяет подбирать в документы товары только одной фирмы. У каждой фирмы свой список товаров. Принадлежность товара конкретной фирме определяется номером секции. Если в одном магазине касса связана с несколькими фирмами, то настоятельно рекомендуется установить данный флаг, чтобы исключить ошибки при заполнении документа «**Потребность склада**», в котором должны быть указаны товары только одной фирмы.

Номер секции хранится в справочнике товара «Кассир 5» и выгружается из товароучетной системы. В товароучетной системе номер секции, как правило, однозначно определяет фирму и склад, где этот товар числится.

Нажатие кнопки «**//Загрузить настройки//**» осуществляет загрузку в «Кассир 5» предопределённых настроек документов.

Нажатие кнопки «**//Проверка связи//**» позволяет проверить корректность задания реквизитов адреса WEB-сервисов по передаче документов и построению отчетов. Предварительно эта информация должна быть загружена в «Кассир 5» кнопками «**//Применить//**», либо «**//ОК//**». Также, к этому моменту времени, в конфигурации ТП 5 должны быть опубликованы WEB-сервисы, и задан пользователь с ролью «**Администратор**» или «**Пользователь**», реквизиты которого продублированы в полях «**Логин**» и «**Пароль**» данной закладки (имя пользователя и его пароль рекомендуется задавать латиницей).