Обмен файлами

Предоставление сервиса по выпуску подарочных сертификатов в Кошельке приостановлено. 
Напишите нам, чтобы первыми узнать о запуске: 
​[email protected]​
Общие принципы обмена данными
Последовательность взаимодействия партнера и 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, не реже одного раза в сутки.

Cardsmobile Gift Cards Offline Service - Previous

Обзор сценариев сертификата (подарочной карты)

Next - Бизнес-сценарии приложения «Кошелёк»

Базовые сценарии работы пользователя в «Кошельке»

Last modified 4mo ago

Copy link

Contents

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

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