Веб-сервис обмена 1С:Предприятие с сайтом

Веб-сервисы — это один из механизмов платформы 1С:Предприятие, используемых для интеграции с другими информационными системами. Он является средством поддержки SOA (Service-Oriented Architecture) — сервис-ориентированной архитектуры, которая является современным стандартом интеграции приложений и информационных систем.

Веб-сервис обмена с веб-сайтом позволяет быстро и просто подключать любой интернет-магазин или сайт принимающий заказы от клиентов к информационной базе прикладного решения 1С:Предприятие:

• 1С: Управление торговлей (версии 10.3, 11.1)
• 1С: Управление небольшой фирмой (версия 1.4)
• 1С: Комплексная автоматизация (версия 1.1)
• 1С: Управление производственным предприятием (версия 1.3)
• 1С: ERP Управление предприятием 2.0

Веб-сервис позволяет сайту одним простым обращением к информационной базе 1С:Предприятие загрузить всю информацию о заказе покупателя, включая:

• Информацию о клиенте (имя, телефон, e-mail)
• Информацию о контактном лице (имя, телефон, e-mail)
• Адрес доставки
• Период доставки
• Информацию о форме оплаты заказа (наличная, банковской картой)
• Данные об оплате платежной картой (зарезервированная сумма)

Идентификация клиентов производится по ИНН (для юридических лиц), а также по телефону и адресу электронной почты, что позволяет подключать информационную базу 1С:Предприятие имеющую клиентскую базу не синхронизированную с веб-сайтом — синхронизация клиентов будет производится по мере загрузки заказов клиентов.

Загрузка заказов с сайта в информационную базу 1С:Предприятие производится напрямую, в режиме реального времени, что позволяет:

1. Веб-сайту сразу же получить всю информацию о результате загрузки каждого из заказов:
• Идентификаторы всех загруженных в 1С:Предприятие объектов (идентификатор заказа, клиента, контактного лица)
• Подробную информацию об ошибках, в случае их возникновения
2. В информационной базе 1С:Предприятие в любой момент времени иметь актуальную информацию о заказах с веб-сайта
3. Полностью контролировать загрузку каждого из заказов с веб-сайта
• Информация о данных полученных от веб-сайта регистрируется для каждого из заказов
• При загрузке заказа с сайта контролируется соответствие цен заказа прайс-листу компании

Для подключения веб-сайта к информационной базе 1С:Предприятие необходимо:

1. Включить поддержку SOAP в PHP (модуль SOAP по-умолчанию включен на большинстве веб-серверов)
2. Веб-разработчику добавить процедуру вызова веб-сервиса на сайте

Для возможности обмена информационной базы 1С:Предприятие с веб-сайтом:

1. Информационная база 1С:Предприятие должна иметь канал связи с сайтом (выделенный IP-адрес или VPN-канал)
2. В информационной базе 1С:Предприятие должен быть включен веб-сервис обмена с веб-сайтом

Стоимость

Загрузка заказов сайта в информационную базу 1С:Предприятие

Веб-сервис позволяет сайту одним обращением к информационной базе 1С:Предприятие загрузить всю информацию о заказе покупателя, включая информацию о клиенте, контактном лице, адресе доставки, периоде доставки, форме оплаты заказа, данные об оплате платежной картой. После успешной загрузки заказа, сайт получает идентификаторы 1С загруженных объектов (заказа покупателя, клиента, контактного лица) для последующей однозначной идентификации объектов при обмене данными между сайтом и информационной базой 1С:Предприятие.

Пример загруженных данных в 1С:Предприятие

Контроль соответствия цен заказа прайс-листу компании

Информация о данных полученных от веб-сайта регистрируется для каждого из заказов, при этом контролируется соответствие цен заказа прайс-листу компании

Пример вызова веб-сервиса 1С:Предприятие для загрузки заказа сайта

<?php

	$WebExchange_SClient =
		new SoapClient(
			"http://localhost/trade/ws/WebExchange.1cws?wsdl", // Адрес wsdl web-сервиса
			array("login"      => "webservice",                // Имя пользователя 1С
			      "password"   => "webservice"));              // Пароль пользователя 1С

	$DocOrder =
		array(
			"WebID"   => "000003",
			"Date"    => "2014-03-27",
			"Comment" => "Просьба доставить заказ до 16:00",

			// Клиент
			"Client" => array(
				"Name"             => "Петров Александр Николаевич",
				"INN"              => "",
				"KPP"              => "",
				"LegalAddress"     => "",
				"ActualAddress"    => "г. Москва, ул. Сретенка, д. 6, кв. 214",
				"TelNumber"        => "+7(900)101-01-01",
				"Email"            => "petrov@mail.ru",
				"IndividualPerson" => "true"),

			// Контактное лицо
			"ContactPerson" => array(
				"Name"             => "Иванова Анна Юрьевна",
				"TelNumber1"       => "+7(900)101-01-02",
				"TelNumber2"       => "",
				"Email"            => "ivanova@mail.ru"),

			// Товары
			"ProductList" => array(

				// Вентилятор JIPONIC (Тайв.)
				array(
					"Product" => array("UUID" => "cbcf4945-55bc-11d9-848a-00112f43529a"),
					"Quantity" => 1,
					"Price"    => 1500),
				// Вентилятор настольный
				array(
					"Product" => array("UUID" => "cbcf4957-55bc-11d9-848a-00112f43529a"),
					"Quantity" => 2,
					"Price"    => 5000)),

			// Доставка
			"Delivery" => array(
				"Address"          => "г. Москва, ул. Сретенка, д. 6, кв. 214",
				"Date"             => "2014-03-28",
				"Period" => array(
					"Start"    => "14:00:00",
					"End"      => "18:00:00")),

			// Оплата
			"Payment" => array(
				"PayType"          => "ByCash"));

	$DocOrder_SoapStruct = new SoapVar($DocOrder, SOAP_ENC_OBJECT, "DocOrder", "http://neokonsalt.ru/WebExchange");

	try {
		$Status = $WebExchange_SClient -> UpdateOrder(Array("DocOrder" => $DocOrder_SoapStruct));
		echo "<pre>"; var_dump($Status); echo "</pre>";
	}
	catch (SoapFault $exception) {
		echo "<pre>" . $exception . "</pre>";
	}

?>

Пример ответа веб-сервиса

Результатом выполнения операции веб-сервиса является ответ, содержащий идентификаторы всех загруженных в информационную базу 1С:Предприятие объектов:

object(stdClass)#3 (1) {
  ["return"]=>
  object(stdClass)#4 (3) {
    ["Successfully"]=>
    bool(true)
    ["Comment"]=>
    string(0) ""
    ["DocOrder"]=>
    object(stdClass)#5 (3) {
      ["UUID"]=>
      string(36) "01d4ce5c-b59b-11e3-4095-0015af86cc91"
      ["Client"]=>
      object(stdClass)#6 (1) {
        ["UUID"]=>
        string(36) "0bc94602-b58e-11e3-3c95-0015af86cc91"
      }
      ["ContactPerson"]=>
      object(stdClass)#7 (1) {
        ["UUID"]=>
        string(36) "0bc94604-b58e-11e3-3c95-0015af86cc91"
      }
    }
  }
}