Russian
Обмен файлами
Обмен данными между партнером и Cardsmobile
Предоставление сервиса по выпуску подарочных сертификатов в Кошельке приостановлено.
Напишите нам, чтобы первыми узнать о запуске:

Общие принципы обмена данными

Последовательность взаимодействия партнера и Cardsmobile представлена на диаграмме ниже.
где:
  • ИС партнера — информационная система партнера, организовавшего выпуск подарочных сертификатов (карт) через приложение «Кошелёк»;
  • Файловое хранилище — хранилище файлов для обмена данными и сервер sFTP, организованные на стороне Cardsmobile;
  • Сервер Кошелька — компонент платформы Cardsmobile, обеспечивающий взаимодействие с партнерами, выпуск подарочных сертификатов (карт) в приложении «Кошелёк», осуществляющий подготовку отчетов и реестров выпущенных карт.
Партнер загружает свои файлы реестров в папку in, файл реестра, формируемый Кошельком, партнер выгружает из папки out.

Форматы файлов, участвующих в файловом обмене

1. Реестр предактивированных сертификатов (подарочных карт)

Реестр передается партнером с установленной периодичностью (рекомендуемая периодичность передачи реестра – не реже одного раза в сутки). Схема именования файла:
1
NewCertificate_<имя партнера>_<номинал>_<дата>.csv.zip
Copied!
где:
  • <имя партнера> – согласованное с Cardsмobile имя Партнера (без пробелов);
  • <номинал> – номинал сертификатов, находящихся в файле реестра;
  • <дата> – дата формирования реестра в формате ГГГГММДД.
Пример имени файла реестра предактивированных сертификатов (подарочных карт):
1
NewCertificate_PartnerName_500_20180131.csv.zip
Copied!
В файле передаются следующие поля в указанном порядке:
  • number – Номер (код) сертификата (подарочной карты). Обязательный параметр;
  • barcode – Номер сертификата, из которого генерируется штрих-код либо QR-код сертификата (подарочной карты);
  • startDate – Дата начала действия сертификата (подарочной карты);
  • expireDate – Дата окончания действия сертификата (подарочной карты).
Пример:
1
<заголовок, игнорируется>
2
ID111218300541871830;X51BA30AFB526AC1E0;;2018-09-20T07:00:33
3
ID111218300541871111;X51BA30AFB526AC111;;2018-09-20T07:00:33
Copied!
Примеры заполнения полей типа «дата»:
  • Дата: 2018-11-27;
  • Дата и время: 2018-09-20T07:00:33;
  • Дата и время с временной зоной: 2018-09-20T07:00:33.123+0300.
Основным идентификатором сертификата (подарочной карты) является поле number, а дополнительным – поле barcode.

Реестр обновлений сертификатов (подарочных карт)

Реестр передается партнером с установленной периодичностью (рекомендуемая периодичность передачи реестра – не реже одного раза в сутки). Схема именования файла:
1
UpdIssuedCertificate_<имя партнера>_<номинал>_<дата>.csv.zip
Copied!
где:
  • <имя партнера> – согласованное с Cardsмobile имя Партнера (без пробелов);
  • <номинал> – номинал сертификатов, находящихся в файле реестра;
  • <дата> – дата формирования реестра в формате ГГГГММДД.
Пример имени файла реестра обновлений сертификатов (подарочных карт):
1
UpdIssuedCertificate_PartnerName_500_20180131.csv.zip
Copied!
В файле передаются следующие поля (в указанном порядке):
  • number – Номер (код) сертификата (подарочной карты). Обязательный параметр;
  • startDate – Дата начала действия сертификата (подарочной карты);
  • expireDate – Дата окончания действия сертификата (подарочной карты);
  • useDate – Дата использования сертификата (подарочной карты);
  • status – Статус сертификата (если установлено blocked, то сертификат досрочно блокируется).
Пример:
1
<заголовок, игнорируется>
2
ID111218300541871830;;;;
3
ID111218300541871111;;;;
Copied!
Примеры заполнения полей типа «дата»:
  • Дата: 2018-11-27;
  • Дата и время: 2018-09-20T07:00:33;
  • Дата и время с временной зоной: 2018-09-20T07:00:33.123+0300.

Реестр сертификатов (подарочных карт), выпущенных Cardsmobile

Реестр выпущенных сертификатов (подарочных карт) выгружается сервером Кошелька на файловое хранилище ежедневно. Дата выгрузки файла в точности совпадает с датой выдачи сертификатов (подарочных карт). Схема именования файла:
1
IssuedCertificate_<имя партнера>_<номинал>_<дата>.csv.zip
Copied!
где:
  • <имя партнера> – согласованное с Cardsмobile имя Партнера (без пробелов);
  • <номинал> – номинал сертификатов, находящихся в файле реестра;
  • <дата> – дата формирования реестра в формате ГГГГММДД.
Пример имени файла реестра сертификатов (подарочных карт), выпущенных Cardsmobile
1
IssuedCertificate_PartnerName_500_20180131.csv.zip
Copied!
Для каждого номинала сертификатов (подарочных карт) формируется собственный файл.
В файле передаются следующие поля:
  • number – Номер (код) сертификата (подарочной карты). Обязательный параметр.
Пример:
1
<заголовок, игнорируется>
2
ID111218300541871830
3
ID111218300541871831
Copied!
С целью оперативного попадания сведений о сертификатах (подарочных картах), выпущенных для партнера в Кошельке, рекомендуется загружать реестр сертификатов, выпущенных Cardsmobile, не реже одного раза в сутки.
Last modified 4mo ago