Обязательные параметры:
Дополнительные параметры:
Важно, если общение с внешним протоколом происходит через протокол HTTP, то символ +, в номере телефона, должен быть указан по стандарту http, вида %2B, а символ @ - %40 (пример: test%40test.ru)
Параметр PlacesAccessCodes должен быть вида: [s=X1;l=Y1;f=Z1;r=R1;p=P1;eac=E1;t=T1]..[s=Xn;l=Yn;f=Zn;r=Rn;p=Pn;eac=En;t=Tn], где:
Параметр PayByBonus может равняться одному из двух вариантов:
Параметр PayByCard заполняется в случае оплаты по Пушкинским картам вида [type=pushkin;terminal_id=XXX;terminal_owner=YYY;rrn=ZZZ], где
Вмете с PayByCard требуется специфичное заполнение параметра PayByBonus (описание выше). Пример: &PayByBonus=pushkin_card&PayByCard=[type=pushkin;terminal_id=12345;terminal_owner=test;rrn=98765]&...
Дополнительные обязательные параметры для центрального бэкофиса:
В случае ошибочного ввода параметра PlacesAccessCodes в ответе добавляется тэг AccessCodesWarnings, содержащий 0..n вложенных тэгов WarningItem — итем по конкретному коду билета.
Тэг AccessCodesWarnings содержит атрибуты:
Пример запроса
ServiceID=1&QueryCode=SaleApproved&CardCode=101009&Sessions=605&ReservationID=271035&CustomerContact=+79031234567&Encoding=Windows-1251
Пример ответа
<?xml version='1.0' encoding='Windows-1251' standalone='yes'?>
<XML>
<Result>Ok</Result><Error></Error><Remark></Remark>
<Data>
<Reservation ID='271035'>
<Places OrderCode='ORDERCODE_5555549755325527'>
<Place Level='1' Fragment='0' Row='1' Place='1' Session='605' SessionSymbols='RN' Code='100000000785' Type_name='Стандарт' Type='1' TicketID='1' Price='1000' OriginalPrice='1000' OriginalAddPrice=1000' TicketNumber='0' ODID='785' PrintPrice='1000' AddPrice='1000' PrintAddPrice='1000' AddName='ДопСтандарт' ComissionSum='100' PrintComissionSum='100' TaxID='1' FiscalPercent='1000'>
<Organization ID='1' INN=''><Name><![CDATA[ООО "Теsт1"]]></Name></Organization>
<Theatre ID='2'><Name><![CDATA[Кинотеатр "Тест1"]]></Name></Theatre>
<Hall ID='1'><Name><![CDATA[Большой зал]]></Name></Hall>
<Level><Name><![CDATA[Большой зал]]></Name></Level>
<Session Date='05.12.2014' CalendarDate='05.12.2014' Time='22:30' Duration='124'>
<Movie ID='1' AgeRestriction=''>
<Name><![CDATA[Dracula Untold]]></Name>
<OtherName><![CDATA[]]></OtherName>
<SubName><![CDATA[]]></SubName>
<UpName><![CDATA[]]></UpName>
</Movie>
</Session>
<Format ID=''><![CDATA[]]></Format>
<Currency ID='4'><Name><![CDATA[Платежный документ]]></Name></Currency>
<TicketName><![CDATA[Полный]]></TicketName>
</Place>
<Place Level='1' Fragment='0' Row='1' Place='2' Session='605' SessionSymbols='RN' Code='120000078700' Type_name='Стандарт' Type='1' TicketID='1' Price='1000' OriginalPrice='1000' OriginalAddPrice=1000' TicketNumber='0' ODID='787' PrintPrice='1000' AddPrice='1000' PrintAddPrice='1000' AddName='ДопСтандарт' ComissionSum='100' PrintComissionSum='100' TaxID='1' FiscalPercent='1000'>
<Organization ID='1' INN=''><Name><![CDATA[ООО "Теsт1"]]></Name></Organization>
<Theatre ID='2'><Name><![CDATA[Кинотеатр "Тест1"]]></Name></Theatre>
<Hall ID='1'><Name><![CDATA[Большой зал]]></Name></Hall>
<Level><Name><![CDATA[Большой зал]]></Name></Level>
<Session Date='05.12.2014' CalendarDate='05.12.2014' Time='22:30' Duration='124'>
<Movie ID='1' AgeRestriction=''><Name><![CDATA[Dracula Untold]]></Name>
<OtherName><![CDATA[]]></OtherName>
<SubName><![CDATA[]]></SubName>
<UpName><![CDATA[]]></UpName>
</Movie>
</Session>
<Format ID=''><![CDATA[]]></Format>
<Currency ID='4'><Name><![CDATA[Платежный документ]]></Name></Currency>
<TicketName><![CDATA[Полный]]></TicketName>
</Place>
</Places>
</Reservation>
<Pay Val='4000'>На карту 101 (05.00002.00000102.0001) начислено 40.00 потраченных средств</Pay>
</Data>
</XML>Пример запроса
ServiceID=1&QueryCode=SaleApproved&ReservationID=x015&CustomerContact=+79031234567&Encoding=Windows-1251
Пример ответа
<?xml version='1.0' encoding='Windows-1251' standalone='yes'?>
<XML>
<Result>Ok</Result><Error></Error><Remark></Remark>
<Data>
<Reservation ID='x015'>
<Places OrderCode='ORDERCODE_0755555555426732'>
<Place Level='1' Fragment='0' Row='1' Place='11' Session='868' SessionSymbols='RP' Code='190000000027' Type_name='Стандарт' Type='3' TicketID='1' Price='4000' OriginalPrice='4000' OriginalAddPrice='0' TicketNumber='0' ODID='270' PrintPrice='0' AddPrice='0' PrintAddPrice='0' AddName='' ComissionSum='0' PrintComissionSum='0' TaxID='-1'>
<Organization ID='1' INN=''>
<Name><![CDATA[Компания Юсиэс]]></Name>
</Organization>
<Theatre ID='2'><Name><![CDATA[Главный Объект]]></Name></Theatre>
<Hall ID='1'><Name><![CDATA[Большой зал]]></Name></Hall>
<Level><Name><![CDATA[Большой зал]]></Name></Level>
<Session Date='10.05.2015' Time='04:10' Duration='20'>
<Movie ID='3' AgeRestriction=''>
<Name><![CDATA[Мероприятие Номер 3]]></Name>
<OtherName><![CDATA[]]></OtherName>
<SubName><![CDATA[]]></SubName>
<UpName><![CDATA[]]></UpName>
</Movie>
</Session>
<Format ID='1'><![CDATA[3Д]]></Format>
<Currency ID='4'>
<Name><![CDATA[Платежный документ]]></Name>
</Currency>
<TicketName><![CDATA[Полный]]></TicketName>
</Place>
<Place Product='3' Price='15000' OriginalPrice='15000' OriginalAddPrice='0' ODID='271' PrintPrice='0' ComissionSum='0' PrintComissionSum='0' TaxID='-1'>
<Organization ID='1' INN='кыепрй25ныврпцфурн'>
<Name><![CDATA[ООО "UCS"]]></Name>
</Organization>
<Theatre ID='2'><Name><![CDATA[Главный Объект]]></Name></Theatre>
<Product ID='3' Weight='0'><Name><![CDATA[3Д очки]]></Name>
<Article><![CDATA[46нвапртц35нвер]]></Article>
<Measure ID='3'>
<Name><![CDATA[штук]]></Name>
</Measure>
</Product>
<Currency ID='4'>
<Name><![CDATA[Платежный документ]]></Name>
</Currency>
</Place>
</Places>
</Reservation>
</Data>
</XML>Пример запроса
ServiceID=1&QueryCode=SaleApproved&CardCode=101&Sessions=&ReservationID=20150220_6&Seasons=&Encoding=Windows-1251&Version=3&Archive=0&Expect=
Пример ответа
<?xml version='1.0' encoding='Windows-1251' standalone='yes'?>
<XML>
<Result>Ok</Result><Error></Error><Remark></Remark>
<Data>
<Reservation ID='20150220_6'>
<Places OrderCode='ORDERCODE_5545549755325527'>
<Place Exhibition='5' ExhibitionDate='24.02.2015' Code='130000238000' Type_name='Entrance ticket 2' Type='5' Price='5400' TicketID='2' ODID='238' PrintPrice='0' ComissionSum='0' PrintComissionSum='0' TaxID='-1' Repeated='1'>
<Organization ID='1' INN='12312312'>
<Name><![CDATA[Рога и копыта]]></Name>
</Organization>
<Theatre ID='2'>
<Name><![CDATA[Cinema "Premiera"]]></Name>
</Theatre>
<Halls>
<Hall ID='1'><Name><![CDATA[Hall "Great"]]></Name></Hall>
</Halls>
<Exhibition ID='5'>
<Name><![CDATA[Выставка 2]]></Name>
<PrintName><![CDATA[Выставка Тест 2]]></PrintName>
</Exhibition>
<Currency ID='1'>
<Name><![CDATA[Ruble]]></Name>
</Currency>
<TicketName><![CDATA[10% discount]]></TicketName>
</Place>
</Places>
</Reservation>
</Data>
</XML>Пример запроса
ServiceID=1&QueryCode=SaleApproved&CardCode=&Sessions=&ReservationID=00332&Seasons=&Encoding=Windows-1251&Version=3&Archive=0&Expect=
Пример ответа
<?xml version='1.0' encoding='Windows-1251' standalone='yes'?>
<XML>
<Result>Ok</Result><Error></Error><Remark></Remark>
<Data>
<Reservation ID='00332'>
<Places OrderCode='ORDERCODE_2755555556428477'>
<Place Exhibition='1' ExhibitionDate='30.04.2015' Code='196000000021' Type_name='Входной 1' Type='6' TicketID='3' Price='9000' OriginalPrice='10000' TicketNumber='0' ODID='216' PrintPrice='0' ComissionSum='0' PrintComissionSum='0' TaxID='-1'>
<Organization ID='1' INN=''>
<Name><![CDATA[Компания Юсиэс]]></Name>
</Organization>
<Theatre ID='2'><Name><![CDATA[Главный Объект]]></Name></Theatre>
<Halls>
<Hall ID='3'>
<Name><![CDATA[Выставки/Экскурсии]]></Name>
</Hall>
</Halls>
<Exhibition ID='1'>
<Name><![CDATA[Выставка 1]]></Name>
<PrintName><![CDATA[Выставка Тест 1]]></PrintName>
</Exhibition>
<Currency ID='1'><Name><![CDATA[Наличные]]></Name></Currency>
<TicketName><![CDATA[10% дисконт]]></TicketName>
</Place>
<Place Product='3' Price='15000' OriginalPrice='15000' ODID='217' PrintPrice='0' ComissionSum='0' PrintComissionSum='0' TaxID='-1'>
<Organization ID='1' INN='кыепрй25ныврпцфурн'>
<Name><![CDATA[ООО "UCS"]]></Name>
</Organization>
<Theatre ID='2'><Name><![CDATA[Главный Объект]]></Name></Theatre>
<Product ID='3' Weight='0'>
<Name><![CDATA[3Д очки]]></Name>
<Article><![CDATA[46нвапртц35нвер]]></Article>
<Measure ID='3'>
<Name><![CDATA[штук]]></Name>
</Measure>
</Product>
<Currency ID='1'><Name><![CDATA[Наличные]]></Name></Currency>
</Place>
</Places>
</Reservation>
</Data>
</XML>Пример запроса
ServiceID=1&QueryCode=SaleApproved&CardCode=101&ReservationID=kk005&CustomerContact=+79031234567&Encoding=Windows-1251&PayByBonus=[payan=01.00004.00000615.0001;]Пример ответа
<?xml version='1.0' encoding='Windows-1251' standalone='yes'?>
<XML>
<Result>Ok</Result><Error></Error><Remark></Remark>
<Data>
<Reservation ID='kk005'>
<Places OrderCode='ORDERCODE_5555555681027169'>
<Place Level='1' Fragment='0' Row='1' Place='1' Session='2249' Code='173860000000' Type_name='Стандарт' Type='1' TicketID='1' Price='2500' OriginalPrice='2500' TicketNumber='0' ODID='386' PrintPrice='0' AddPrice='0' PrintAddPrice='0' AddName='' ComissionSum='0' PrintComissionSum='0' TaxID='-1'>
<Organization ID='1' INN='ае6н216ц4екн276унг'>
<Name><![CDATA[UCS]]></Name>
</Organization>
<Theatre ID='2'>
<Name><![CDATA[Объект Номер 1]]></Name>
</Theatre>
<Hall ID='1'>
<Name><![CDATA[Большой зал]]></Name>
</Hall>
<Level>
<Name><![CDATA[Большой зал]]></Name>
</Level>
<Session Date='25.06.2015' Time='01:10' Duration='40'>
<Movie ID='2' AgeRestriction=''>
<Name><![CDATA[Мероприятие Номер 2]]></Name>
<OtherName><![CDATA[]]></OtherName>
<SubName><![CDATA[]]></SubName>
<UpName><![CDATA[]]></UpName>
</Movie>
</Session>
<Format ID='1'><![CDATA[2д]]></Format>
<Currency ID='3'><Name><![CDATA[Платежный документ]]></Name></Currency>
<TicketName><![CDATA[Полный]]></TicketName>
</Place>
</Places>
</Reservation>
<Pay Val='2500'>На карту 101 (05.00002.00000102.0001) начислено 25.00 потраченных средств</Pay>
<PayBonus Val='-2500'>С карты 101 (01.00004.00000615.0001) списано -25.00 средств</PayBonus>
</Data>
</XML>Пример запроса
ServiceID=1&QueryCode=SaleApproved&ReservationID=kk005&CustomerContact=+79031234567&Encoding=Windows-1251&PayByBonus=pushkin_card&PayByCard=[type=pushkin;terminal_id=12345;terminal_owner=test;rrn=98765]Пример запроса
ServiceID=1&QueryCode=SaleApproved&CardCode=&Sessions=&ReservationID=1111&Seasons=&Encoding=Windows-1251&Version=3&Archive=0&Expect=
Пример ответа
<?xml version='1.0' encoding='Windows-1251' standalone='yes'?>
<XML>
<Result>Ok</Result>
<Error></Error>
<Remark></Remark>
<Data>
<Reservation ID='1111'>
<Places OrderCode='ORDERCODE_5556915555128206'>
<Place ComplexTicket='1' Code='175200000000' Type_name='' Type='0' TicketID='0' Price='12000' OriginalPrice='12000' OriginalAddPrice='0' TicketNumber='0' ODID='520' PrintPrice='12000' ComissionSum='0' PrintComissionSum='0' TaxID='-1' Repeated='1'></Place>
</Places>
</Reservation>
</Data>
</XML>История версий запроса SaleApproved Развернуть исходный код
4.0.R4.1 [+] Добавлен параметр CustomerContact 4.0.R3.10 [+] Частичная оплата бонусами, параметр PayByBonus с дополнительным указанием sum 3.22.R7 [+] Комплексные билеты 3.22.R4 [+] Добавлен флаг IgnoreCSDiscount [*] Центральный протокол теперь пробрасывает флаг IgnoreCSError в локал, который также понимает этот параметр [+] Оплата билетов через бонусы