MAIN_20170501.dep.csvMAIN_20170501.day.csv
Стандартная выгрузка осуществляется ежедневно, время выгрузки настраивается в конфигурационном файле сервера (см. Инструкцию по настройке Логус).
Выгрузка формируется в два CSV файла - «<Код гостиницы>_20090824.day.csv» и «<Код гостиницы>_20090824.dep.csv». В названии файла присутствует дата за которую происходит выгрузка, а так же суффикс «day» или «dep».
- Day-файл содержит транзакции (т.е. все платежи и доходы), проведенные в выгружаемую дату (со всех типов счетов)
- Dep-файл содержит:
- все транзакции со счетов индивидуальных броней, уехавших в выгружаемую дату (перешедших в статус OUT, CANCEL или NOSHOW)
- все транзакции со счетов индивидуальных броней, проведенные в выгружаемую дату, при условии, что дата начисления транзакции позже даты выезда брони.
- все транзакции со счетов групп, завершенных в выгружаемую дату (перешедших в статус CLOSED или CANCEL),
- все транзакции со счетов групп, проведенные в выгружаемую дату, при условии, что дата начисления транзакции позже даты окончания группы
- все транзакции со счетов профайлов гостей и компаний, проведенных в выгружаемую дату.
Как правило загружать следует только один из этих файлов, согласно выбранной в гостинице учетной политике. Возможна раздельная загрузка платежных и доходных транзакций из разных файлов.
Существует вариант выгрузки Dep-файла, при котором осуществляется "резка" выгружаемых данных в последнюю дату месяца.
Пример отдельной строки выгрузки:
MAIN,RUB,100021,RES,Ципочкина Лада Зиновьевна,IN,12.08.2014 14:00:00,01.09.2014 12:00:00,112,,396,24.08.2014 12:00:00,25.08.2014 0:00:00,200,,Проживание,A/R,True,300005,,ООО Корпорация,"1300,00","1300,00","198,31",НДСВКЛ,"1300,00",RUB,True,1,100
Описание полей в файле выгрузки
| Поле | Пример | Коментарии |
|---|---|---|
PropertyCode | MAIN | Код гостиницы. Используется для идентификации гостиницы при работе в цепочке гостиниц. |
LocalCurrencyCode | RUB | Код локальной валюты гостиницы |
FolioGenericNo | 100021 | Номер счета. |
FolioTypeCode | RES | Тип счета: RES - Бронь GROUP - Группа, GP - Профайл гостя CP - Профайл компании |
OwnerName | Ципочкина Лада Зиновьевна | Для броней - ФИО основного гостя Для групповых броней - Название групповой брони Для профайлов компаний - Название компании Для профайлов гостей - ФИО гостя |
OwnerStatus | IN | Статус записи (бронь, групповая бронь, профайл гостя или компании), которой принадлежит счет |
ReservationArrivalDate | 12.08.2014 14:00:00 | Дата заезда гостя в гостиницу (только для обычных броней) если транзакция на счете группы, то дата начала группы |
ReservationDepartureDate | 01.09.2014 12:00:00 | Дата выезда гостя из гостиницы (для обычных броней), если транзакция на счете группы, то дата окончания группы |
ReservationRoomCode | 64 | Номер комнаты гостя (только для обычных броней) |
GroupGenericNo |
| Номер группы гостя, если есть. Индивидуальный уникальный номер группы |
TransactionId | 1 | Идентификатор транзакции в системе Logus |
TransactionScheduledDate | 24.08.2014 12:00:00 | Плановая дата начисления транзакции (по календарю гостиницы) |
TransactionPostedDate | 12/09/09 | Дата начисления транзакции на счет гостя (по календарю гостиницы). |
TransactionCode | 200 | Код начисления. Идентификационный уникальный код транзакции. |
ServiceItemCode | 001 | Код услуги, для транзакций, начисленных за услуги (например, код позиции из минибара) |
TransactionName | ПРОЖИВАНИЕ | Фактическое название транзакции |
FolioPocketCode | A/R | Код кармана |
IsNonCashFolioPocket | True | Признак «Безналичный карман» - True/False |
PocketPayerGenericNo | 300005 | Номер счета плательщика по карману (для безналичных карманов) |
PocketPayerTaxIdentificationNumber | 7730633954/773001001 | Для безналичных услуг ИНН/КПП Юридического лица (формат поля зависит от заполнения) |
PocketPayerCompanyName | Корпорация | Для безналичных услуг название Юридического лица в ситеме Logus |
LocalCurrencyAmount | "1300,00" | Сумма транзакции в валюте гостиницы |
LocalCurrencyAmountBeforeDiscount | "1300,00" | Сумма транзакции до применения скидки |
IncludedTaxAmount | "198,31" | Сумма включенного налога если есть (в локальной валюте гостиницы) |
IncludedTaxCode | НДСВКЛ | Код налога. |
TransactionAmount | "1300,00" | Сумма транзакции в валюте транзакции |
TransactionCurrencyCode | RUB | Код валюты транзакции |
IsRevenue | True | Признак платежная/доходная. True - Доходная (услуги, оказанные гостю), False - платежная (платежи от гостя, включая безнал и перенос баланса) |
GroupTransactionId | 1 | ID родительской транзакции для группы транзакций, начисленных с детализацией |
GeneralAccountCode |
| Значение поля «Код в бухгалтерии» из справочника кодов транзакции для кода TransactionCode |
MainGuestProfileGenericNo | 5275212 | Код профиля гостя (для броней с профилем) |
Quantity | 1,00 | Количество |
| InvoiceId | 1 | Идентификатор фин. документа, в который включена данная транзакция |
| InvoiceGenericNo | 0001 | Номер бланка фин. документа (или суррогатного идентификатора, например №231231-1) |
| InvoiceTypeCode | ПУТ | Код типа фин. документа или БСО |
| ReservationRoomTypeCode | Код типа комнаты | |
| FiscalDocumentNo | Номер фискального документа (если транзакция была фискализирована) | |
| RateCode | Код тарифа для транзакций проживания | |
| OpenCode | Код открытого кода | |
| TransactionCodeName | Название кода транзакции (по справочнику) | |
| ServiceItemCodeName | Название кода услуги (по справочнику) | |
| TerminalSerialNo | 10020112 | Серийный номер фискального регистратора, на котором была фискализирована оплата (для платёжных транзакций) |
Состав полей может расширятся в новых версиях Logus. Как правило, поля добавляются в конец строки. Но при разработке процедур загрузки данных в 1С (или другие системы) не следует полагаться на неизменность порядкового номера поля. Порядок поля следует вычислять согласно первой строки в файле выгрузки, где перечислены имена полей.
Описание параметров конфигурации
Настройка параметров форматирования CSV-файла задается в секции CsvConfiguration в Logus.HMS.Service.exe.config.
Параметр | Значение по умолчанию | Описание |
|---|---|---|
Delimiter | , | Разделитель между полями (по-умолчанию запятая) |
CsvCulture | ru-ru | Код культуры, в соответствии с которой производится форматирование дат и чисел.
Перечень возможных кодов: https://msdn.microsoft.com/en-us/library/system.globalization.cultureinfo%28vs.71%29.aspx |
Quote | " | Какой символ используется в качестве кавычек (по-умолчанию - " |
Encoding | windows-1251 | Кодировка, в которой записываются CSV-файлы |
| QuoteAllFields | True | Заключать в кавычки значения полей или нет |