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

Материал из Wiki
Перейти к: навигация, поиск
 
(не показана одна промежуточная версия этого же участника)
Строка 11: Строка 11:
 
|<b>Обязательный</b>
 
|<b>Обязательный</b>
 
|<b>Описание</b>
 
|<b>Описание</b>
|-
 
|salearea
 
|Да
 
|Идентификатор точки продаж мерчанта
 
 
|-
 
|-
 
|barcode
 
|barcode
Строка 24: Строка 20:
 
<response>
 
<response>
 
     <body code="0" message="">
 
     <body code="0" message="">
       <!-- «deposit» - пополнение баланса
+
       <!-- info - Содержит атрибуты карты -->
            datetime — Дата/Время операции (в формате yyyy-mm-dd hh:nn:ss)
+
       <info card="31231"
            value – величина операции в копейках
+
            phone="1928309812"
            payment_type - Тип оплаты пополнения. 0 - Наличные; 1 - Банковская карта
+
            customer="Ivanov I.I."/>
            bonus - Сгенерированные бонусы
+
      <!-- Узел "operations" - содержит список операций  -->
            balance - Величина личных средств после операции
+
       <operations>
            bonus_balance - Ведичина бонусов после операции
+
        <!--description - Описание операции.(Тип операции,способ оплаты,место)
      -->      
+
       <deposit datetime="2010-10-10 00:00:00"
+
                card="31231"
+
                phone="1928309812"
+
                customer="Ivanov I.I."  
+
                value="50"
+
                payment_type="1"
+
                bonus="0"
+
                balance="50"
+
                bonus_balance="1"/>  
+
       <!-- payment - оплата (списание средств) со счета внешней системы.
+
 
             datetime — Дата/Время операции (в формате yyyy-mm-dd hh:nn:ss)
 
             datetime — Дата/Время операции (в формате yyyy-mm-dd hh:nn:ss)
             value – Величина списания с личного счета
+
             value – величина изменения личных средств (пополнение - положительное число, списание - отрицательное)
             bonus - Величина списания с бонусного счета
+
             bonus - величина изменения бонусных средств (пополнение - положительное число, списание - отрицательное)
 
             balance - Величина личных средств после операции
 
             balance - Величина личных средств после операции
             bonus_balance - Ведичина бонусов после операции-->
+
             bonus_balance - Величина бонусных средств после операции
      <payment datetime="2010-10-10 10:00:00"  
+
        -->  
                card="31231"
+
        <operation description="Пополнение через ИНКАССУ"
                phone="1928309812"
+
                    datetime="2010-10-10 00:00:00"  
                customer="Ivanov I.I."
+
                    value="50"
                value="50"
+
                    bonus="0"
                bonus="0"
+
                    balance="50"
                balance="0"
+
                    bonus_balance="1"/>
                bonus_balance="1"/>  
+
        <operation description="Списание на кассе №2"
 +
                    datetime="2010-10-10 00:00:00"  
 +
                    value="-50"
 +
                    bonus="0"
 +
                    balance="0"
 +
                    bonus_balance="1"/>
 +
      </operations>
 
     </body>
 
     </body>
 
</response>
 
</response>
 
</syntaxhighlight>
 
</syntaxhighlight>

Текущая версия на 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>