TicketGate, Book
Click here for a complete list of operations.
Description
The purpose of this method is to book seats to a specific arrangement. Before this method is called a previous call to PreBook should have been made as well. Furthermore a money transaction should have been authorized through a financial gateway (DIBS or ReePay). The result of that (BuyCode ect.) should be handled over as parameter in order for the Book procedure the check the transaction at the financial gateway. The method returns all relevant informations requiered for composing a reciept.
Parameter
TransactionID | Identifies the transaction. Retrived from the payment gateway response. |
Reference | This is the Reference number returned på the financial gateway (DIBS). Set to "undefined" when using ReePay. |
Amount | This is the Amount of the pernding transaction. This Amount should be the one returned by the financial gateway in order to make a 100% test of the transaction. |
BuyCode | This is the OrderId of the pernding transaction. The BuyCode should be the one returned by the financial gateway in order to make a 100% test of the transaction. |
Return value
<?xml version="1.0" encoding="utf-8"?>
<Message Session="ftpkk5awn4fvnjydhccmhx45" xmlns="">
<Answer Result="True" Code="0" Error="0" Message="" />
<Transaction RefNo="193403" OrgNo="2" No="234629" Type="Sale">
<ShowDetails No="130535" Numbered="True">
<MovieID>5228</MovieID>
<MovieName>Public Enemies</MovieName>
<LanguageVersion>Orig. vers. med danske undertekster</LanguageVersion>
<AuditoriumID>5</AuditoriumID>
<AuditoriumName>Sal 3</AuditoriumName>
<CinemaID>2</CinemaID>
<CinemaName>Hans's Biograf</CinemaName>
<Time Date="149876" Time="57600">07-05-2010 16:00:00</Time>
<AnnouncementDate />
</ShowDetails>
<Tickets Price="200">
<Ticket No="122680" Name="Normal billettype" Count="2" />
<Ticket No="122696" Name="50% Rabat" Count="1" />
</Tickets>
<Concessions Price="132,64">
<Item No="8" Exclusive="False" Name="Kage" Count="2" />
</Concessions>
<Vouchers Points="200">
<Item No="9" Name="Koncession pakke" Count="1" Points="200" />
</Vouchers>
<Seats Location="Sal 3">
<Seat Name="8" Row="5" />
<Seat Name="10" Row="5" />
<Seat Name="12" Row="5" />
</Seats>
<Amounts Total="342,25">
<Tickets>200,00</Tickets>
<Concessions>132,64</Concessions>
<BonusPoints>740</BonusPoints>
<Fees Total="9,61">
<Ticket>8,00</Ticket>
<EbilletCard>0,00</EbilletCard>
<CreditCard>1,61</CreditCard>
</Fees>
</Amounts>
<OrderId>280410SFB100210</OrderId>
<Reference>12345656</Reference>
<CreditCardType>DK</CreditCardType>
<BarCode>
<Code>7703692581468037</Code>
<Url>http://www.secure.ebillet.dk/bpw/barcode.asp?code=7703692581468037&height=25</Url>
</BarCode>
<Customer>
<UserId>{22DF088C-EFB6-42B9-AA59-1D16D9E6AE3A}</UserId>
<Name>Anders And</Name>
<Phone>00000000</Phone>
<Password>[external password]</Password>
<EMail>hlh@ebillet.dk</EMail>
<CardHolder No="109483">
<FirstName>mille fabricius</FirstName>
<LastName>jensen</LastName>
<Address>tulipanvej 36</Address>
<Card No="111090">7703692581468037</Card>
</CardHolder>
<QuickUser />
</Customer>
</Transaction>
</Message>
Return value, Code
-1 | Suspicious error |
0 | No code |
1 | Cardholder or user exist |
2 | External error |
3 | Unable to login |
4 | Login is required for access |
5 | Unsupported protocol |
6 | Cardholder or user does not exist |
7 | Internal exception |
8 | Insufficient email. |
9 | Key is not matching existing data of the cardholder |
10 | Unable to load cardholder data |
11 | Unable to initialize internal object with arrangement |
12 | Unable to load organizer specific data |
13 | Internal error. The service failed to load club profile entries for cardholder |
14 | Session has timed out |
15 | To many sublocations, system can only handle one |
16 | Inconsistent transactionid. The transactionid must match the one retrieved from the previous call |
17 | Unable to preplace the reservation/purchase |
18 | Inconsistent organizer and/or arrangement. Numbers must match the numbeers from previous calls |
19 | Invalid phone number. The number does no observe the rules dictated by the organizer |
20 | Invalid user name. The name contains invalid characters |
21 | Invalid password. The password may only consist of following characters: a-z, A-Z and 0-9 |
22 | Suspicious hostaddress |
23 | To many ticket has been selected |
24 | Suspicius attempt to delete reservation |
25 | Unable to delete reservation |
26 | Wrong country format. Country must have following syntax: "<2 ch country code> - |
27 | The transaction has already been booked/bought |
28 | This buy method is not supported by the organizer |
29 | Unable to prebuy pending transaction |
30 | Unable to buy pending transaction |
31 | Unable to cancel pending transaction |
32 | Check af transaktionen hos betalingsgateway rapporterer mistænksomhed |
33 | Unable to load cardholders data |
34 | Unknown creditcard type |
35 | Unable to perform the reservation |
36 | Unable to authorize the transaction in the local database |
37 | Inconsistent session data. Some of the parameter does not match parameters in the previous call |
38 | Unable to get history (reservations and purchases) |
39 | Authorized amount does not match the complete price |
40 | Unable to activate reservation |
41 | Unable to load card |
42 | Unable to insert bonus history |
43 | No bonus profile found for the specific organizer |
44 | To many pbonus profiles has been found |
45 | The specific cardholder is not member of the this group |
46 | Cardholder doesn't possess any profiles/memberships |
47 | The cardnumber is not valid |
48 | Customer has selected to many exclusive/bonus tickets that available |
49 | Customer has been given signon-bonus previously |
50 | More that 1 user exist with that id |
51 | Invalid email. Didn't pass the syntax check |
52 | Suspicius attept to change data of an user |
53 | Access to arrangement is not allowed |
54 | Missing Nordisk Film account or password |
Return value, Error
-1 | Suspicious error |
0 | No error |
32 | Du har været for længe om at indtaste data, eller vælge sæder. Den midlertidig reservation af billetterne er derfor forældet. Gå tilbage og prøv igen |
33 | Du har været for længe om at indtaste data, eller vælge sæder. Den midlertidig reservation af billetterne er derfor forældet. Gå tilbage og prøv igen |
52 | Det ønskede antal pladser er desværre ikke ledige til denne forestilling |
53 | Move seats error |
60 | På grund af forbindelses-nedbrug er billetterne blevet købt til anden side |
68 | Det ønskede antal pladser er desværre ikke ledige til denne forestilling |
279 | Buy web reservation error |
445 | Den øvre grænse for speciel billetter er overskredet for dette område |
446 | Den øvre grænse for internet salg er overskredet |
472 | Det er ikke muligt at reservere/købe til dette arrangement |
473 | Det er ikke muligt at have flere reservationer til samme arrangement med det samme telefon nummer. Slet eventuelt den eksisterende reservation og opret en ny med det ønskede antal |
474 | Det er ikke muligt at købe og reservere til dette arrangement. Arrangøren har låst for denne mulighed. Kontakt evt. arrangøren for yderlige informationer |
475 | Det er ikke muligt at købe til dette arrangement. Arrangøren har låst for denne mulighed. Kontakt evt. arrangøren for yderlige informationer |
476 | Det er ikke muligt at reservere til dette arrangement. Arrangøren har låst for denne mulighed. Kontakt evt. arrangøren for yderlige informationer |
479 | Du har allerede én reservation til denne film. Hvis du vil foretage anden reservationer til samme film, skal den eksisterende først slettes |
480 | Intern databasefejl |
10001 | Unable to connect to organizer |
10004 | Det er ikke muligt, at kontakte billet-udbyderens billet system. Prøv igen lidt senere |
10006 | Du har brugt alle dine eksklusiv billetter |
10007 | Dit køb er allerede blevet sat i værk. Kontrollér indholdet af dit ebillet-kort på www.ebillet.dk hvis der hersker nogen tvivl om hvorvidt købet er gennemført |
2000 | Adgang nægtet |
2001 | Kupon er ikke oprettet |
2002 | Kupon er låst af anden bruger |
2003 | Kuponen er udløbet |
2004 | Kupon er allerede brugt |
2005 | Gavekortet/voucheren med den pågældende Stregkode eksisterer allerede |
2006 | Der er fundet multible gavekort/vouchere med den pågældende barcode |
2008 | Gavekortet med den pågældende stregkode eksisterer allerede |
2009 | Der er fundet multible gavekort med den pågældende barcode |
2010 | Det er ikke tilladt at indløse kuponen hos den pågældende arrangør |
2010 | Gavekortet ({0}) er ikke oprettet |
2011 | Gavekort er udløbet |
2012 | Gavekort er allerede brugt |
2013 | Kuponen stemmer ikke overens med tilknyttede film |
2014 | Kuponen kan ikke benyttes til den valgte film. Kontakt eventuelt supervisor, hvis dette er en fejl |
2007 | Der er ikke nok penge tilbage på kortet |
800 | Kupondata er returneret, men kuponen er ikke aktiv |
920 | Kupon er ikke aktiv |
921 | Gavekortet er ikke aktivt |
922 | Kuponen er taget ud af salg og derfor ikke gyldig |
950 | Kupon er ikke fundet |
3000 | Du har ikke nok rettigheder til at udføre denne handling |
801 | XML feed'et er ikke som forventet |
802 | Voucher rod. Muligvis stemmer stregkode ikke overens med indløsningsmulighederne |
803 | Ugyldig stregkode |
3001 | Det var ikke muligt at refundere voucheren |
3002 | Det var ikke muligt at logge ind |
3003 | Denne type er ikke supporteret |
3004 | Der mangler configurationdata |