Назначение

Метод позволяет получить информацию по подарочным картам.

В качестве входных параметров принимает фильтр, по которому и будут отобраны карты.

Фильтры

№	Наименование	Тип	Описание

№	Наименование	Тип	Описание
1	cardNumber	Строка	Номер карты
2	startDateFrom	Дата	Дата начала действия карты, начало диапазона
3	startDateTo	Дата	Дата начала действия карты, конец диапазона
4	endDateFrom	Дата	Дата окончания действия карты, начало диапазона
5	endDateTo	Дата	Дата окончания действия карты, конец диапазона
6	status	Перечисление	Статус карты: Возможные варианты: Create Activate Blocked Inactive Used
7	saleDate	Дата	Календарный день продажи Формат: yyyy-MM-dd
8	paymentDate	Дата	Календарный день оплаты по карте Формат: yyyy-MM-dd hh:mm:ss.mmm
9	operationDateFrom	Дата	Дата и время операции, начало диапазона Формат: yyyy-MM-dd hh:mm:ss.mmm
10	operationDateTo	Дата	Дата и время операции, конец диапазона Формат: yyyy-MM-dd hh:mm:ss.mmm

Наименование адресации веб-методов

URL: http://{host}:{port}/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager
WSDL: http://{host}:{port}/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager?wsdl
Наименование метода: getPresentCardsInfoByFilter

Результат вызова метода

presentCards/presentCard

Наименование атрибута	Тип данных	Обязательно	Описание
cardNumber	String	Да	Номер карты
amount	Long	Да	Номинал
status	String	Да	Статус
startDate	Date	Да	Дата начала действия карты
endDate	Date	Да	Дата окончания действия карты
replacedCardNumber	String	Да	Номер карты замены
actions	Collection	Да	Набор действий с картой
type	String	Да	Тип действия
date	Date	Да	Дата совершения действия
login	String	Нет	Логин совершившего действие
source	String	Да	Место совершения действия
cash	String	Нет	Номер кассы
shop	String	Нет	Номер магазина
blockingCause	String	Да	Причина блокировки/замены карты
prolongationCause	String	Да	Причина продления срока действия

Результатом метода является массив байт в котором закодирован xml.

Максимальный объем по картам = 30000

Если результат будет превышать заявленное число, клиент получит соответствующее предупреждение.

Если элемент не заполнен, то в теге присутствуют атрибуты: xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"

Пример XML:

<?xml version="1.0" encoding="UTF-8"?>
<presentCards xmlns="http://crystals.ru/cards/presentcards/report">
   <presentCard>
      <cardNumber>300999</cardNumber>
      <amount>50000</amount>
      <status>Blocked</status>
      <startDate>2018-10-15+03:00</startDate> 
      <endDate xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true" />
      <replacedCardNumber xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true" />
      <actions> 
         <action type="Blocked" date="2018-10-16+03:00" login="manager" source="SERVER" /> 
         <action type="Activate" date="2018-10-15+03:00" login="" source="CASH" cash="-1" shop="-1" />
         <action type="Create" date="2018-10-15+03:00" login="" source="CASH" cash="-1" shop="-1" />
      </actions>
      <blockingCause>Потерял</blockingCause> 
      <prolongationCause xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true" />
   </presentCard>
</presentCards>

Сервис для выгрузки всех данных по подарочным картам одним запросом

https://crystals.atlassian.net/browse/SR-2514

Данные выгружаются через HTTP-запрос методом GET в формате JSON.

Пример запроса инструментом curl:

curl -X GET "http://172.29.16.112:8090/SetXRMI/ReportsProcessorServlet?Action=PRESENT_CARDS&FILE_TYPE=json"

Пример ответа:

Пример JSON:

[
  {
    "cardNumber": "300998",
    "amount": 50000,
    "status": "ACTIVE",
    "startDate": "2018-57-25 02:57:54",
    "endDate": null,
    "replacedCardNumber": "",
    "actions": {
      "action": [
        {
          "type": "ACTIVATE",
          "date": "2018-57-25 02:57:54",
          "login": "",
          "source": "CASH",
          "cash": "-1",
          "shop": "-1"
        },
        {
          "type": "CREATE",
          "date": "2018-57-25 02:57:54",
          "login": "",
          "source": "CASH",
          "cash": "-1",
          "shop": "-1"
        }
      ]
    }
  },
  {
    "cardNumber": "300999",
    "amount": 50000,
    "status": "ACTIVE",
    "startDate": "2018-57-25 02:57:54",
    "endDate": null,
    "replacedCardNumber": "",
    "actions": {
      "action": [
        {
          "type": "ACTIVATE",
          "date": "2018-57-25 02:57:54",
          "login": "",
          "source": "CASH",
          "cash": "-1",
          "shop": "-1"
        },
        {
          "type": "CREATE",
          "date": "2018-57-25 02:57:54",
          "login": "",
          "source": "CASH",
          "cash": "-1",
          "shop": "-1"
        }
      ]
    }
  }
]