Открыть главное меню

Dataexchange.view finance: различия между версиями

(Удалено перенаправление на Main)
Метка: удалено перенаправление
 
(не показана 1 промежуточная версия этого же участника)
Строка 1: Строка 1:
== Пример интерфейса для просмотра финансовой информации в личном кабинете ==
+
==Пример интерфейса для просмотра финансовой информации в личном кабинете==
  
 
Обращаем ваше внимание, что в зависимости от ваших возможностей (наличию данных в вашей 1С), данный интерфейс может реализован со следующими ограничениями:
 
Обращаем ваше внимание, что в зависимости от ваших возможностей (наличию данных в вашей 1С), данный интерфейс может реализован со следующими ограничениями:
# Без платёжного календаря
+
 
# Без информации о стоп-листе и(или) отсрочке платежа
+
#Без платёжного календаря
# Без информации о просроченной задолженности
+
#Без информации о стоп-листе и(или) отсрочке платежа
# Без информации о прогнозируемой задолженности
+
#Без информации о просроченной задолженности
# И т.д.
+
#Без информации о прогнозируемой задолженности
 +
#И т.д.
  
 
{| border="0" cellpadding="10" cellspacing="0"
 
{| border="0" cellpadding="10" cellspacing="0"
 
  |-
 
  |-
  ! valign="top" | [[Файл:Finance-1.png|600px|thumb|left| Просмотр финансовой информации в личном кабинете]]
+
  ! valign="top" |[[Файл:Finance-1.png|600px|thumb|left| Просмотр финансовой информации в личном кабинете]]
 
  |}
 
  |}
  
== Методы ==
+
==Методы==
Портал может обращаться к вашей 1С через специальный веб-интерфейс (подробнее смотрите тут: http://v8.1c.ru/overview/Term_000000273.htm#1).
+
Портал может обращаться к вашей 1С через специальный веб-интерфейс (подробнее смотрите тут: [http://v8.1c.ru/overview/Term_000000273.htm#1 https://v8.1c.ru/overview/Term_000000273.htm#1]).
 
Для организации online-доступа портала к данным финансовой информации, вам необходимо реализовать в своей системе учета следующие SOAP-методы.
 
Для организации online-доступа портала к данным финансовой информации, вам необходимо реализовать в своей системе учета следующие SOAP-методы.
=== Общий вид ===
+
===Общий вид===
 
{| class="wikitable"
 
{| class="wikitable"
 
  |-
 
  |-
  ! '''Название функции'''
+
  !'''Название функции'''
  ! width=200 | '''Назначение функции'''
+
  ! width="200" |'''Назначение функции'''
  ! '''Входящие параметры'''
+
  !'''Входящие параметры'''
 
  !'''Возвращаемые данные'''
 
  !'''Возвращаемые данные'''
 
  |-
 
  |-
  ! GetFinanceBase
+
  !GetFinanceBase
  | Получение основной информации по финансам
+
  |Получение основной информации по финансам
  | Параметры запроса:
+
  |Параметры запроса:
* CodeClient - код клиента
+
 
  | Результатом работы должны быть данные финансовой информации:
+
*CodeClient - код клиента
* creditLimit - лимит кредита,
+
  |Результатом работы должны быть данные финансовой информации:
* postponement - отсрочка платежа,
+
 
* resultDebt - итоговая задолженность,
+
*creditLimit - лимит кредита,
* currentOverdue - просроченная задолженность на сегодня,
+
*postponement - отсрочка платежа,
* projectedOverdue - прогнозируемая просроченная задолженность через 7 дней,
+
*resultDebt - итоговая задолженность,
* stopList - флаг "в стоп-листе" (значения 0 или 1),
+
*currentOverdue - просроченная задолженность на сегодня,
* prepaymentRequired - флаг "требуется предоплата". Если включен, то будет заблокирована отправка заказа в случае (saldo + blocked) * -1 < суммы заказа.
+
*projectedOverdue - прогнозируемая просроченная задолженность через 7 дней,
 +
*stopList - флаг "в стоп-листе" (значения 0 или 1),
 +
*prepaymentRequired - флаг "требуется предоплата". Если включен, то будет заблокирована отправка заказа в случае (saldo + blocked) * -1 < суммы заказа.
 +
 
 
информацию о карточках клиента - элемент contracts, содержащий массив объектов типа contract следующего вида:
 
информацию о карточках клиента - элемент contracts, содержащий массив объектов типа contract следующего вида:
* code - код карточки клиента,
+
 
* name - наименование клиента,
+
*code - код карточки клиента,
* fullName - полное наименование клиента,
+
*name - наименование клиента,
* saldo - сальдо текущей карточки,
+
*fullName - полное наименование клиента,
* blocked - заблокированные средства (например, сумма заказанного, но не отгруженного),
+
*saldo - сальдо текущей карточки,
 +
*blocked - заблокированные средства (например, сумма заказанного, но не отгруженного),
 +
 
 
и информацию об объемах закупок - элемент purchases, содержащий массив объектов типа purchase следующего вида:
 
и информацию об объемах закупок - элемент purchases, содержащий массив объектов типа purchase следующего вида:
* period - период (например, "Март", "Июнь", "2014 год", "Текущий объем закупок"),
+
 
* value - значение объема закупок в валюте сайта,
+
*period - период (например, "Март", "Июнь", "2014 год", "Текущий объем закупок"),
 +
*value - значение объема закупок в валюте сайта,
 
  |-
 
  |-
  ! GetFinanceCalendar
+
  !GetFinanceCalendar
  | Получение календаря платежей для клиента
+
  |Получение календаря платежей для клиента
  | Параметры запроса:
+
  |Параметры запроса:
* CodeClient - код клиента
+
 
  | Результатом работы должен быть узел orders, содержащий набор объектов типа order следующего вида:
+
*CodeClient - код клиента
* contractCode - карточка клиента,
+
  |Результатом работы должен быть узел orders, содержащий набор объектов типа order следующего вида:
* orderNumber - номер заказа,
+
 
* shippingDate - дата отгрузки,
+
*contractCode - карточка клиента,
* paymentDate - максимальная дата поступления платежа,
+
*orderNumber - номер заказа,
* summ - сумма заказа,
+
*shippingDate - дата отгрузки,
* debt - долг по заказу,
+
*paymentDate - максимальная дата поступления платежа,
* isOverdue - флаг "Просрочено" (может принимать значения 0 или 1).
+
*summ - сумма заказа,
 +
*debt - долг по заказу,
 +
*isOverdue - флаг "Просрочено" (может принимать значения 0 или 1).
 
  |}
 
  |}
  
=== Техническая информация ===
+
===Техническая информация===
 
Все входящие параметры - текстового типа.
 
Все входящие параметры - текстового типа.
  
В целях безопасности рекомендуется ограничить доступность сервиса по IP-адресу и/или закрыть его простой HTTP-авторизацией.
+
В целях безопасности рекомендуется ограничить доступность сервиса по IP-адресу и/или закрыть его простой HTTPS-авторизацией.
  
 
Создать [http://v8.1c.ru/overview/xdto.htm XDTO-пакеты] в 1С можно с помощью импорта следующих схем:
 
Создать [http://v8.1c.ru/overview/xdto.htm XDTO-пакеты] в 1С можно с помощью импорта следующих схем:
  
==== GetFinanceBase ====
+
====GetFinanceBase====
<source lang=xml>
+
<source lang="xml">
<xs:schema xmlns:tns="GetFinanceBaseResult" xmlns:xs="http://www.w3.org/2001/XMLSchema" targetNamespace="GetFinanceBaseResult" attributeFormDefault="unqualified" elementFormDefault="qualified">
+
<xs:schema xmlns:tns="GetFinanceBaseResult" xmlns:xs="https://www.w3.org/2001/XMLSchema" targetNamespace="GetFinanceBaseResult" attributeFormDefault="unqualified" elementFormDefault="qualified">
 
<xs:element name="GetFinanceBaseResult" type="tns:GetFinanceBaseResult"/>
 
<xs:element name="GetFinanceBaseResult" type="tns:GetFinanceBaseResult"/>
 
<xs:complexType name="GetFinanceBaseResult">
 
<xs:complexType name="GetFinanceBaseResult">
Строка 120: Строка 129:
 
</source>
 
</source>
  
==== GetFinanceCalendar ====
+
====GetFinanceCalendar====
<source lang=xml>
+
<source lang="xml">
<xs:schema xmlns:tns="GetFinanceCalendarResult" xmlns:xs="http://www.w3.org/2001/XMLSchema" targetNamespace="GetFinanceCalendarResult" attributeFormDefault="unqualified" elementFormDefault="qualified">
+
<xs:schema xmlns:tns="GetFinanceCalendarResult" xmlns:xs="https://www.w3.org/2001/XMLSchema" targetNamespace="GetFinanceCalendarResult" attributeFormDefault="unqualified" elementFormDefault="qualified">
 
<xs:element name="GetFinanceCalendarResult" type="tns:GetFinanceCalendarResult"/>
 
<xs:element name="GetFinanceCalendarResult" type="tns:GetFinanceCalendarResult"/>
 
<xs:complexType name="GetFinanceCalendarResult">
 
<xs:complexType name="GetFinanceCalendarResult">
Строка 155: Строка 164:
 
</source>
 
</source>
  
== Как самостоятельно тестировать разработанные функции? ==
+
==Как самостоятельно тестировать разработанные функции?==
  
 
[[Dataexchange.testing|Инструкция по тестированию]]
 
[[Dataexchange.testing|Инструкция по тестированию]]
  
 
[[Category:Dataexchange]]
 
[[Category:Dataexchange]]

Текущая версия на 18:28, 28 мая 2025

Пример интерфейса для просмотра финансовой информации в личном кабинете

Обращаем ваше внимание, что в зависимости от ваших возможностей (наличию данных в вашей 1С), данный интерфейс может реализован со следующими ограничениями:

  1. Без платёжного календаря
  2. Без информации о стоп-листе и(или) отсрочке платежа
  3. Без информации о просроченной задолженности
  4. Без информации о прогнозируемой задолженности
  5. И т.д.
Просмотр финансовой информации в личном кабинете

Методы

Портал может обращаться к вашей 1С через специальный веб-интерфейс (подробнее смотрите тут: https://v8.1c.ru/overview/Term_000000273.htm#1). Для организации online-доступа портала к данным финансовой информации, вам необходимо реализовать в своей системе учета следующие SOAP-методы.

Общий вид

Название функции Назначение функции Входящие параметры Возвращаемые данные
GetFinanceBase Получение основной информации по финансам Параметры запроса:
  • CodeClient - код клиента
Результатом работы должны быть данные финансовой информации:
  • creditLimit - лимит кредита,
  • postponement - отсрочка платежа,
  • resultDebt - итоговая задолженность,
  • currentOverdue - просроченная задолженность на сегодня,
  • projectedOverdue - прогнозируемая просроченная задолженность через 7 дней,
  • stopList - флаг "в стоп-листе" (значения 0 или 1),
  • prepaymentRequired - флаг "требуется предоплата". Если включен, то будет заблокирована отправка заказа в случае (saldo + blocked) * -1 < суммы заказа.

информацию о карточках клиента - элемент contracts, содержащий массив объектов типа contract следующего вида:

  • code - код карточки клиента,
  • name - наименование клиента,
  • fullName - полное наименование клиента,
  • saldo - сальдо текущей карточки,
  • blocked - заблокированные средства (например, сумма заказанного, но не отгруженного),

и информацию об объемах закупок - элемент purchases, содержащий массив объектов типа purchase следующего вида:

  • period - период (например, "Март", "Июнь", "2014 год", "Текущий объем закупок"),
  • value - значение объема закупок в валюте сайта,
GetFinanceCalendar Получение календаря платежей для клиента Параметры запроса:
  • CodeClient - код клиента
Результатом работы должен быть узел orders, содержащий набор объектов типа order следующего вида:
  • contractCode - карточка клиента,
  • orderNumber - номер заказа,
  • shippingDate - дата отгрузки,
  • paymentDate - максимальная дата поступления платежа,
  • summ - сумма заказа,
  • debt - долг по заказу,
  • isOverdue - флаг "Просрочено" (может принимать значения 0 или 1).

Техническая информация

Все входящие параметры - текстового типа.

В целях безопасности рекомендуется ограничить доступность сервиса по IP-адресу и/или закрыть его простой HTTPS-авторизацией.

Создать XDTO-пакеты в 1С можно с помощью импорта следующих схем:

GetFinanceBase

<xs:schema xmlns:tns="GetFinanceBaseResult" xmlns:xs="https://www.w3.org/2001/XMLSchema" targetNamespace="GetFinanceBaseResult" attributeFormDefault="unqualified" elementFormDefault="qualified">
	<xs:element name="GetFinanceBaseResult" type="tns:GetFinanceBaseResult"/>
	<xs:complexType name="GetFinanceBaseResult">
		<xs:complexContent>
			<xs:extension base="xs:complexType">
				<xs:choice>
					<xs:element name="postponement" type="xs:string"/>
					<xs:element name="stopList" type="xs:string"/>
					<xs:element name="creditLimit" type="xs:string"/>
					<xs:element name="resultDebt" type="xs:string"/>
					<xs:element name="currentOverdue" type="xs:string"/>
					<xs:element name="projectedOverdue" type="xs:string"/>
					<xs:element name="prepaymentRequired" type="xs:string"/>
					<xs:element name="purchases" type="tns:purchase" minOccurs="0" maxOccurs="unbounded"/>
					<xs:element name="contracts" type="tns:contract" minOccurs="0" maxOccurs="unbounded"/>
					<xs:any namespace="##any" processContents="lax" minOccurs="0" maxOccurs="unbounded"/>
				</xs:choice>
				<xs:anyAttribute namespace="##any" processContents="lax"/>
			</xs:extension>
		</xs:complexContent>
	</xs:complexType>
	<xs:complexType name="contract">
		<xs:complexContent>
			<xs:extension base="xs:complexRestrictionType">
				<xs:all>
					<xs:element name="code" type="xs:string"/>
					<xs:element name="name" type="xs:string"/>
					<xs:element name="fullName" type="xs:string"/>
					<xs:element name="saldo" type="xs:string"/>
					<xs:element name="blocked" type="xs:string"/>
					<xs:any namespace="##any" processContents="lax" minOccurs="0" maxOccurs="unbounded"/>
				</xs:all>
				<xs:anyAttribute namespace="##any" processContents="lax"/>
			</xs:extension>
		</xs:complexContent>
	</xs:complexType>
	<xs:complexType name="purchase">
		<xs:complexContent>
			<xs:extension base="xs:complexRestrictionType">
				<xs:all>
					<xs:element name="period" type="xs:string"/>
					<xs:element name="value" type="xs:string"/>
					<xs:any namespace="##any" processContents="lax" minOccurs="0" maxOccurs="unbounded"/>
				</xs:all>
				<xs:anyAttribute namespace="##any" processContents="lax"/>
			</xs:extension>
		</xs:complexContent>
	</xs:complexType>
</xs:schema>

GetFinanceCalendar

<xs:schema xmlns:tns="GetFinanceCalendarResult" xmlns:xs="https://www.w3.org/2001/XMLSchema" targetNamespace="GetFinanceCalendarResult" attributeFormDefault="unqualified" elementFormDefault="qualified">
	<xs:element name="GetFinanceCalendarResult" type="tns:GetFinanceCalendarResult"/>
	<xs:complexType name="GetFinanceCalendarResult">
		<xs:complexContent>
			<xs:extension base="xs:complexType">
				<xs:choice>
					<xs:element name="orders" type="tns:order" minOccurs="0" maxOccurs="unbounded"/>
					<xs:any namespace="##any" processContents="lax" minOccurs="0" maxOccurs="unbounded"/>
				</xs:choice>
				<xs:anyAttribute namespace="##any" processContents="lax"/>
			</xs:extension>
		</xs:complexContent>
	</xs:complexType>
	<xs:complexType name="order">
		<xs:complexContent>
			<xs:extension base="xs:complexRestrictionType">
				<xs:all>
					<xs:element name="contractCode" type="xs:string"/>
					<xs:element name="orderNumber" type="xs:string"/>
					<xs:element name="shippingDate" type="xs:string"/>
					<xs:element name="paymentDate" type="xs:string"/>
					<xs:element name="summ" type="xs:string"/>
					<xs:element name="debt" type="xs:string"/>
					<xs:element name="isOverdue" type="xs:string"/>
					<xs:any namespace="##any" processContents="lax" minOccurs="0" maxOccurs="unbounded"/>
				</xs:all>
				<xs:anyAttribute namespace="##any" processContents="lax"/>
			</xs:extension>
		</xs:complexContent>
	</xs:complexType>
</xs:schema>

Как самостоятельно тестировать разработанные функции?

Инструкция по тестированию