Dimitros (обсуждение | вклад) (Удалено перенаправление на Main) Метка: удалено перенаправление |
Dymchenko (обсуждение | вклад) |
||
| Строка 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). | ||
|} | |} | ||
| − | === Техническая информация === | + | ===Техническая информация=== |
Все входящие параметры - текстового типа. | Все входящие параметры - текстового типа. | ||
| Строка 67: | Строка 76: | ||
Создать [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=" | + | <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=" | + | <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С через специальный веб-интерфейс (подробнее смотрите тут: https://v8.1c.ru/overview/Term_000000273.htm#1). Для организации online-доступа портала к данным финансовой информации, вам необходимо реализовать в своей системе учета следующие SOAP-методы.
Общий вид
| Название функции | Назначение функции | Входящие параметры | Возвращаемые данные |
|---|---|---|---|
| GetFinanceBase | Получение основной информации по финансам | Параметры запроса:
|
Результатом работы должны быть данные финансовой информации:
информацию о карточках клиента - элемент contracts, содержащий массив объектов типа contract следующего вида:
и информацию об объемах закупок - элемент purchases, содержащий массив объектов типа purchase следующего вида:
|
| GetFinanceCalendar | Получение календаря платежей для клиента | Параметры запроса:
|
Результатом работы должен быть узел orders, содержащий набор объектов типа order следующего вида:
|
Техническая информация
Все входящие параметры - текстового типа.
В целях безопасности рекомендуется ограничить доступность сервиса по IP-адресу и/или закрыть его простой HTTP-авторизацией.
Создать 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>