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). The result of that (refference number ect.) should be handled over as parameter in order to give the Book procedure the change of checked the transaction out. The method returns all relevant informations requiered for composing a reciept.
The complete price also depends on whether a specified cardholder has payed for the ebillet-card.
This Reference parameter will be used together with the OrderId and the Amount to check up whether the monetary transaction has been authorized.
The customer has the possibility to make purchases as:
External user: | The user must be identified by external users ID. Use the UserId parameter. The Phone parameter must be specified as well in order to identify the purchase in the local ticket system. The password parameter will be ignored in this situation. Cardholder is optional if an external user is specified. If a purchase has been made only by identifying the user as an external user, then the customer will not be able to look up the purchase from en ebillet site. |
Anonymous user: | The user must be identified by phone number and password. Use the Phone- and the Password parameters. Anonymous user compound with the external user ID or the ebillet cardholder ID makes no sense |
ebillet cardholder: | The user must be identified by a cardholder ID. Use the Cardholder parameter. |
Quick user: | The user must be identified by QuickUserNo. Use the UserId parameter. The Phone parameter must be specified as well in order to identify the purchase in the local ticket system. The password parameter will be ignored in this situation. Cardholder is not supported if a quick user is specified. |
Parameter
TransactionID | Identifies the ongoing transaction/prereservation. |
UserID | Identify - and links to - the user in an external system. |
Phone | Phone number entered by the user. |
Password | Password selected by the user. |
EMail selected by the user. | |
CardHolder | If this parameter is different from 0, the purchase will be attached to the card of the cardholder. |
Reference | This is the Reference number returned på the financial gateway (DIBS). |
OrderId | This is the OrderId of the pernding transaction. The OrderId should be the one returned by the financial gateway in order to make a 100% test of the transaction. |
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. |
QuickUser | Identify - and links to - the user identified by a phone number. |
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 |