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

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

Версия 17:33, 14 декабря 2015

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


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

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

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

Параметр Обязательный Описание
salearea Да Идентификатор точки продаж мерчанта
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>