Обмен файлами
Обмен данными между партнером и Cardsmobile
Документация перемещена
Информация на этой странице не обновляется и может быть устаревшей. Наиболее полная и актуальная версия документации для разработчиков доступна по новому адресу:
Общие принципы обмена данными
Последовательность взаимодействия представлена на диаграмме ниже.
где:
ИС партнера — информационная система партнера, организовавшего выпуск своих карт лояльности через приложение «Кошелёк»;
Файловое хранилище — хранилище файлов для обмена данными и сервер sFTP, организованные на стороне Cardsmobile;
Сервер Кошелька — компонент платформы Cardsmobile, обеспечивающий взаимодействие с партнерами, выпуск карт лояльности в приложении «Кошелёк», и осуществляющий подготовку отчетов и реестров выпущенных карт.
Партнер загружает свои файлы реестров в папку in. Файл реестра, формируемый Кошельком, партнер выгружает из папки out.
Форматы файлов, участвующих в файловом обмене
1. Реестр выпущенных карт лояльности
Реестр передается партнером с установленной периодичностью (рекомендуемая периодичность передачи реестра — не реже одного раза в сутки). Схема именования файла:
где:
<имя партнера> — согласованное с Cardsmobile имя партнера (без пробелов);
<дата> — дата формирования реестра в формате ГГГГММДД.
Пример имени файла реестра выпущенных карт лояльности:
В файле передаются следующие поля в указанном порядке:
card_number
— номер карты (текстовое, до 50 символов);barcode
— номер штрихкода (текстовое, до 50 символов);date
— дата выдачи карты (строка в формате ГГГГММДД);first_name
— имя держателя карты (текстовое, до 50 символов);last_name
— фамилия держателя карты (текстовое, до 50 символов);patronymic_name
— отчество держателя карты (текстовое, до 50 символов);phone
— номер телефона держателя карты в формате MSISDN (без префикса+
, например: 79111111111);email
— адрес электронной почты держателя карты (текстовое, до 50 символов);sex
— пол держателя карты (текстовое, один символ: м или ж);birthday
— день рождения держателя карты (строка в формате ГГГГММДД);bonus_balance
— текущий баланс бонусов на карте (целое число);discount
— текущий размер скидки по карте (целое число);sum
— сумма накоплений на карте (целое число);status
— текущий статус карты (текстовое, возможные значения: active или blocked).
Если поле status
отсутствует, содержит пустое значение, или значение, отличное от active или blocked, по умолчанию платформа Cardsmobile присвоит карте статус active.
Пример:
2. Реестр свободных номеров карт лояльности
Реестр передается партнером по мере необходимости для предотвращения исчерпания набора свободных номеров карт для выпуска. Схема именования файла:
где:
<имя партнера> — согласованное с Cardsmobile имя партнера (без пробелов);
<дата> — дата формирования реестра в формате ГГГГММДД.
Пример имени файла реестра свободных номеров карт лояльности:
В файле передаются следующие поля:
card_number
— номер карты (текстовое, до 50 символов);barcode
— номер штрихкода (текстовое, до 50 символов).
Пример:
3. Реестр карт лояльности, выпущенных Cardsmobile
Реестр выгружается сервером Кошелька на файловое хранилище ежедневно. Дата выгрузки файла в точности совпадает с датой выпуска карт лояльности, сведения о которых содержатся в файле. Схема именования файла:
где:
<дата> — дата формирования реестра в формате ГГГГ-ММ-ДД.
Пример имени файла реестра карт лояльности, выпущенных Cardsmobile:
В файле передаются следующие поля в указанном порядке:
card_number
— номер карты (текстовое, до 50 символов);barcode
— номер штрихкода (текстовое, до 50 символов);first_name
— имя держателя карты (текстовое, до 50 символов);last_name
— фамилия держателя карты (текстовое, до 50 символов);patronymic_name
— отчество держателя карты (текстовое, до 50 символов);phone
— номер телефона держателя карты в формате MSISDN (без префикса+
, например: 79111111111);email
— адрес электронной почты держателя карты (текстовое, до 50 символов);sex
— пол держателя карты (текстовое, один символ: м или ж);birthday
— день рождения держателя карты (строка в формате ГГГГММДД).
Пример:
При необходимости (по согласованию с партнером) в конец списка полей могут быть добавлены дополнительные поля.
Чтобы обеспечить актуальность сведений о картах лояльности, выпущенных для партнера в Кошельке, рекомендуется загружать реестр карт, выпущенных Cardsmobile, не реже одного раза в сутки.
Last updated