Отчет по оборотам карты — различия между версиями

Материал из Wiki
Перейти к: навигация, поиск
 
 
(не показаны 4 промежуточные версии этого же участника)
Строка 1: Строка 1:
 
[[Category:API для взаимодействия с системой начисления и списания бонусных баллов]]
 
[[Category:API для взаимодействия с системой начисления и списания бонусных баллов]]
 
[[API для взаимодействия с системой начисления и списания бонусных баллов]]
 
[[API для взаимодействия с системой начисления и списания бонусных баллов]]
 +
 +
 +
Запрос возвращает последние 10 операций
 
== Запрос на сервер провайдера ==
 
== Запрос на сервер провайдера ==
 
<nowiki>http://serverhost:8024</nowiki>/api/card_operations?login=SHOP&password=SHOP&salearea=SHOP&barcode=147AE2CF
 
<nowiki>http://serverhost:8024</nowiki>/api/card_operations?login=SHOP&password=SHOP&salearea=SHOP&barcode=147AE2CF
Строка 8: Строка 11:
 
|<b>Обязательный</b>
 
|<b>Обязательный</b>
 
|<b>Описание</b>
 
|<b>Описание</b>
−
|-
 
−
|salearea
 
−
|Да
 
−
|Идентификатор точки продаж мерчанта
 
 
|-
 
|-
 
|barcode
 
|barcode
Строка 18: Строка 17:
 
|}
 
|}
 
== Ответ сервиса провайдера ==
 
== Ответ сервиса провайдера ==
 +
<syntaxhighlight lang="xml">
 
<response>
 
<response>
 
     <body code="0" message="">
 
     <body code="0" message="">
−
       <!-- «deposit» - пополнение баланса
+
       <!-- info - Содержит атрибуты карты -->
−
            Атрибуты у обоих команд аналогичные:
+
      <info card="31231"
 +
            phone="1928309812"
 +
            customer="Ivanov I.I."/>
 +
      <!-- Узел "operations" - содержит список операций  -->
 +
      <operations>
 +
        <!--description - Описание операции.(Тип операции,способ оплаты,место)
 
             datetime — Дата/Время операции (в формате yyyy-mm-dd hh:nn:ss)
 
             datetime — Дата/Время операции (в формате yyyy-mm-dd hh:nn:ss)
−
            card – код карты
+
             value – величина изменения личных средств (пополнение - положительное число, списание - отрицательное)
−
            phone – телефон
+
             bonus - величина изменения бонусных средств (пополнение - положительное число, списание - отрицательное)
−
            customer – ФИО клиента
+
             balance - Величина личных средств после операции
−
             value – величина операции в копейках
+
             bonus_balance - Величина бонусных средств после операции
−
            payment_type - Тип оплаты пополнения. 0 - Наличные; 1 - Банковская карта
+
        -->  
−
             bonus - Сгенерированные бонусы
+
        <operation description="Пополнение через ИНКАССУ"
−
      -->       
+
                    datetime="2010-10-10 00:00:00"  
−
      <deposit datetime="2010-10-10 00:00:00"
+
                    value="50"
−
                card="31231"
+
                    bonus="0"
−
                phone="1928309812"
+
                    balance="50"
−
                customer="Ivanov I.I."
+
                    bonus_balance="1"/>
−
                value="50"
+
        <operation description="Списание на кассе №2"
−
                payment_type="1"
+
                    datetime="2010-10-10 00:00:00"  
−
                bonus="0"/>
+
                    value="-50"
−
      <!-- payment - оплата (списание средств) со счета внешней системы.
+
                    bonus="0"
−
            Атрибуты у обоих команд аналогичные:
+
                    balance="0"
−
            datetime — Дата/Время операции (в формате yyyy-mm-dd hh:nn:ss)
+
                    bonus_balance="1"/>  
−
             card – код карты
+
       </operations>
−
            phone – телефон
+
−
            customer – ФИО клиента
+
−
            value – Величина списания с личного счета
+
−
             bonus - Величина списания с бонусного счета-->
+
−
      <payment datetime="2010-10-10 10:00:00"  
+
−
                card="31231"
+
−
                phone="1928309812"
+
−
                customer="Ivanov I.I."
+
−
                value="50"
+
−
                bonus="0"
+
−
                />
+
−
      <deposit datetime="2010-10-11 00:00:00"  
+
−
                card="31231"
+
−
                phone="1928309812"
+
−
                customer="Петров А.С."  
+
−
                value="50"
+
−
                payment_type="0"/>  
+
−
       <payment datetime="2010-10-11 10:00:00"
+
−
                card="31231"
+
−
                phone="1928309812"
+
−
                customer="Петров А.С."
+
−
                value="50"/>  
+
 
     </body>
 
     </body>
 
</response>
 
</response>
−
{| class="wikitable"
+
</syntaxhighlight>
−
|-
+
−
|<b>Параметр</b>
+
−
|<b>Обязательный</b>
+
−
|<b>Описание</b>
+
−
|-
+
−
|active
+
−
|Да
+
−
|Флаг активности карты
+
−
|-
+
−
|begin
+
−
|Да
+
−
|Дата начала действия карты в формате (yyyy-mm-dd hh:nn:ss)
+
−
|-
+
−
|end
+
−
|Нет
+
−
|Дата окончания действия карты
+
−
|-
+
−
|typeid
+
−
|Да
+
−
|Тип карты
+
−
|-
+
−
|typename
+
−
|Да
+
−
|Расшифровка типа карты
+
−
|-
+
−
|costbonus
+
−
|Да
+
−
|Сумма бонусов клиента
+
−
|-
+
−
|costaccount
+
−
|Да
+
−
|Величина лицевого счета
+
−
|}
+

Текущая версия на 17:26, 23 декабря 2015

API для взаимодействия с системой начисления и списания бонусных баллов


Запрос возвращает последние 10 операций

Запрос на сервер провайдера

http://serverhost:8024/api/card_operations?login=SHOP&password=SHOP&salearea=SHOP&barcode=147AE2CF

Параметр Обязательный Описание
barcode Да Идентификатор (штрих-код) с карты

Ответ сервиса провайдера

<response>
    <body code="0" message="">
       <!-- info - Содержит атрибуты карты -->
       <info card="31231"
             phone="1928309812"
             customer="Ivanov I.I."/>
       <!-- Узел "operations" - содержит список операций  -->
       <operations> 
         <!--description - Описание операции.(Тип операции,способ оплаты,место)
             datetime — Дата/Время операции (в формате yyyy-mm-dd hh:nn:ss)
             value – величина изменения личных средств (пополнение - положительное число, списание - отрицательное)
             bonus - величина изменения бонусных средств (пополнение - положительное число, списание - отрицательное)
             balance - Величина личных средств после операции
             bonus_balance - Величина бонусных средств после операции
         --> 
         <operation description="Пополнение через ИНКАССУ"
                    datetime="2010-10-10 00:00:00" 
                    value="50"
                    bonus="0"
                    balance="50"
                    bonus_balance="1"/> 
         <operation description="Списание на кассе №2"
                    datetime="2010-10-10 00:00:00" 
                    value="-50"
                    bonus="0"
                    balance="0"
                    bonus_balance="1"/> 
       </operations>
    </body>
</response>
Источник — «https://wiki.wgear.online/index.php?title=Отчет_по_оборотам_карты&oldid=742»