Обработка «Загрузка поступлений по платежным картам»
Назначение: Обработка предназначена для:
- групповой (за период) или индивидуальной (за день) загрузки информации по платежам, поступившим по кредитным картам. Загрузка данных будет осуществляться из файлов, выгруженных из системы управления гостиницами компании Opera V2.5+ (Fidelio Suite 8);
- автоматического создания, заполнения и проведения документов «Поступления по платежным картам»;
- обработка осуществляет загрузку данных по платежам со следующими ограничениями:
а) загружаются только транзакции в рублях
б) загружаются только транзакции поступления и возврата на карты. Все прочие транзакции (выдачи наличных и т.д.) если они будут указаны в исходном файле – игнорируются.
в) загружаются только транзакции с кодами, для которых установлены параметры в регистре «Параметры платежных систем» (см. п. 1.2.1).
Файл – источник данных
Название файла имеет структуру: yymmddpd.csv (pd = payments daily);
Файл источник содержит структурированные строки с записями о транзакциях (одна строка – 1 транзакция);
Реквизиты транзакции в строке разделены запятыми.
Пример строки: *
MOWPD,2717855,,1675552,"9034","Visa (Micros)","2013-05-20","2013-05-20","21:59:40",620,620,1,"RUB",1,1,1350182,"",,"","","",17923,"","MICROS VISA","D",,1375072,"2013-01-10","16:58:00","","","Z-PM","9606","NRG","HSE",1287107,,001114620130520205849,"",80,2717855,2717855
Структура полей записи: *
-
№
|
код
|
Описание
|
Тип
|
1
|
HOTEL
|
Код гостиницы
|
“varchar2(20)”
|
2
|
TSQID
|
Номер транзакции (внутренний, последовательный, уникальный)
|
number()
|
3
|
TPTID
|
Номер порождающей транзакции
|
number()
|
4
|
TGRID
|
Групповой номер транзакции (внутр., одинаков у каскадных транз.)
|
number()
|
5
|
TCODE
|
Код транзакции
|
“varchar2(20)”
|
6
|
TTEXT
|
Название транзакции
|
“varchar2(80)”
|
7
|
TDACR
|
Календарная дата транзакции
|
“yyyy-mm-dd”
|
8
|
TDABU
|
Системная дата транзакции
|
“yyyy-mm-dd”
|
9
|
TTIME
|
Время транзакции
|
“24:mi:ss”
|
10
|
TAMNT
|
Сумма транзакции
|
number(38,12)
|
11
|
TPRCE
|
Цена транзакции
|
number(38,12)
|
12
|
TQNTY
|
Количество транзакции
|
number(12,3)
|
13
|
TCURR
|
Код валюты транзакции
|
“varchar2(20)”
|
14
|
TEXCH
|
Курс обмена валюты транзакции к базовой валюте
|
number(38,12)
|
15
|
TBWNO
|
Номер окна транзакции (в экранной форме счёта гостя)
|
number(9,0)
|
16
|
FSQID
|
Последовательный номер счёта гостя (внутренний, уникальный)
|
number()
|
17
|
FOLDA
|
Дата печати счёта
|
“yyyy-mm-dd”
|
18
|
PPRID
|
Номер профайла плательщика (внутренний, уникальный)
|
number()
|
19
|
PARNO
|
Номер безналичного дебитора плательщика
|
“varchar2(20)”
|
20
|
PPRNM
|
Имя профайла плательщика (см. Примечание 2)
|
“varchar2(80)”
|
21
|
PPRTP
|
Тип профайла плательщика (см. п. IV)
|
“varchar2(80)”
|
22
|
GPRID
|
Номер профайла гостя (внутренний, уникальный)
|
number()
|
23
|
GARNO
|
Номер безналичного дебитора гостя
|
“varchar2(20)”
|
24
|
GPRNM
|
Имя профайла гостя (см. Примечание 2)
|
“varchar2(80)”
|
25
|
GPRTP
|
Тип профайла гостя (см. п. IV)
|
“varchar2(80)”
|
26
|
XRSID
|
Номер первоначальной брони (внутренний, уникальный)
|
number()
|
27
|
RESID
|
Номер брони (внутренний, уникальный)
|
number()
|
28
|
RARDA
|
Дата заезда гостя
|
“yyyy-mm-dd”
|
29
|
RARTI
|
Время заезда гостя
|
“24:mi:ss”
|
30
|
RDPDA
|
Дата выезда гостя
|
“yyyy-mm-dd”
|
31
|
RDPTI
|
Время выезда гостя
|
“24:mi:ss”
|
32
|
RRATC
|
Код тарифа брони
|
“varchar2(20)”
|
33
|
RRMNO
|
Номер комнаты / постоянного счёта
|
“varchar2(20)”
|
34
|
RMKTC
|
Код рынка брони
|
“varchar2(20)”
|
35
|
RSRCC
|
Код источника брони
|
“varchar2(20)”
|
36
|
RCFNO
|
Номер подтверждения брони (уникальный)
|
number()
|
37
|
URCNO
|
Номер квитанции (уникальный)
|
number()
|
38
|
CHQNO
|
Номер чека
|
“varchar2(20)”
|
*Жирным шрифтом выделены значимые для загрузки поля записи
Командная панель:
- кнопка «Провести документы» - для группового проведения сформированных документов;
- кнопка «Закрыть».
Реквизиты обработки:
- Дата начала периода и Дата окончания периода – для определения пользователем периода загрузки [Дата(только дата). При открытии формы обработки заполняются текущей датой];
- Каталог – для указания пользователем имени каталога в котором размещены файлы загрузки [системное имя папки, сохранять значение для пользователя, восстанавливать значение при открытии];
Табличная часть «Транзакции»
Предназначена для отображения (и возможно – редактирования) загруженных транзакций.
В панели инструментов кнопка – «Загрузить данные».
Реквизиты:
- дата [дата и время];
- КодОперации [Строка, 4 знака, Допустимые значения: значения из соответствующего измерения регистра «Параметры платежных систем»]
- Вид операции [Строка; Допустимые значения: «Гостиница», «Кафе]
- Сумма транзакции [Число, 15.2 >0]
- Процент комиссии [Число, 4.2 >0]
- Сумма комиссии [Число, 15.2 >0]
- Эквайер [Контрагенты]
Алгоритм заполнения:
- Вызывается кнопкой «Загрузить данные»;
- Выдает сообщение об ошибке, если не заполнены реквизиты «Дата начала периода», «Дата окончания периода», «Каталог»;
- Выдает сообщение об ошибке, если в регистре «Параметры платежных систем» нет ни одной записи;
- Выдает сообщение об ошибке, если существуют не помеченные на удаление документы «Поступления по платежным картам» за даты, попадающие в период, загрузки. В сообщении об ошибке указать количество документов попадающих в период. Пользователю предлагаются варианты: {Изменить период загрузки} или {Пометить на удаление ранее загруженные документы}. Если пользователь выбрал {Изменить период загрузки} – то в начало периода устанавливается следующая дата за датой последнего существующего документа загрузки, конец периода – устанавливается текущая дата. Если пользователь выбрал {Пометить на удаление ранее загруженные документы}, то запрашивается подтверждение типа «Вы уверены….» с указанием количества документов, которые будут удалены. Если подтверждение получено, соответствующие документы помечаются на удаление и загрузка продолжается.
- формируется список допустимых значений кодов операций (на основе записей регистра «Параметры платежных систем»);
- в указанном каталоге последовательно (от ранних - к поздним) выбираются файлы;
- после открытия файла в форме обработки выводится информационная строка: «Загружается файл {имя файла}. Загружено {счетчик строк файла} транзакций. Всего загружено {счётчик транзакций} строк. На сумму {Итог по колонке «Сумма транзакции»}». Информационная строка обновляется после каждой загруженной строки и при открытии следующего файла. При открытии файла также обнуляется {счетчик строк файла};
- в файле последовательно считываются строки;
- если код транзакции (5-е поле строки) не найден в списке допустимых кодов или валюта транзакции (13-е поле) не равно "RUB", то такая строка пропускается;
- в табличной части добавляется строка, обновляются счетчики;
- заполняются реквизиты
дата – объединением полей 7 и 9 исходной строки;
код операции – из 5-го поля,
сумма транзакции – из 10-го поля,
вид операции, процент комиссии, эквайер – на основании данных регистра «Параметры платежных систем» (по коду операции)
сумма комиссии – рассчитывается на основании суммы транзакции и процента комиссии.
- после обработки всех файлов пользователю выдается сообщение.
Табличная часть «Документы»
Предназначена для формирования и просмотра документов «Поступления по платёжным картам» созданных на основе загруженных транзакций.
В панели инструментов кнопка – «Сформировать документы».
Реквизиты:
- Документ [Ссылка на документ];
- Дата [Дата документа]
- СуммаДокумента [Итог по реквизиту Сумма транзакций документа].
Алгоритм заполнения:
- Вызывается кнопкой «Сформировать документы»;
- Выдает сообщение об ошибке, если табличная часть «Транзакции» пустая;
- Последовательно отбирает из табличной части «Транзакции» строки с различными датами, формирует из них таблицу значений;
- создает новый документ «Поступления по платёжным картам» и передаёт в него таблицу значений с транзакциями (дальнейшая обработка данных производится процедурами документа);
- записывает заполненный документ;
- заполняет на основе документа строку табличной части;
- после обработки всех дат (которые встречаются в табличной части «Транзакции») выдает сообщение пользователю;
После формирования документов пользователь может просмотреть документы и провести их вручную или кнопкой [Провести документы]. |
