TABooking API
API for retrieving, creating, updating and listing of reservations/bookings.
| TABookingGet | Get reservation by number. |
| TABookingCreate | Create a new reservation. |
| TABookingUpdate | Update an existing reservation. |
| TABookingDelete | Delete a desired reservation. |
| TABookingList | Get a list of reservations for the specified criteria. |
TABookingGet
Get travel agency booking by document number, or by combination of document number and date.
Parameters
| number | Document number. Can use sequential document number (example: 2), or formated number (example: 2016-00002) |
| date | Document date |
Example request and response
POST /WebServicesSI/API HTTP/1.1
Host: eurofaktura.com
User-Agent: Mozilla/4.0
Content-Length: 410
Content-Type: application/octet-stream
<?xml version="1.0" encoding="utf-8"?>
<request>
<login username="micka" md5pass="ddb43e9f119c6805f4770ecc4f6466ba" token="E7DF3E6E94FB4579BBA8F54979010B5C" />
<method name="TABookingGet">
<parameter name="number" value="2016-00005" />
</method>
</request>
Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
<TABooking>
<accommodationDescription>Otok Velidhu</accommodationDescription>
<bookingPayerCity>Ljutomer</bookingPayerCity>
<bookingPayerCountry>SI</bookingPayerCountry>
<bookingPayerName>HABJANI STANKO</bookingPayerName>
<bookingPayerPostalCode>9240</bookingPayerPostalCode>
<bookingPayerStreet>VE ICA 38 VE ICA 38</bookingPayerStreet>
<bookingPayerEMail>booking.payer@gmail.com</bookingPayerEMail>
<bookingPayerPhone>026725352</bookingPayerPhone>
<bookingPayerMobilePhone>070306612</bookingPayerMobilePhone>
<businessYear>2016</businessYear>
<cancellationRiskEnsurance>true</cancellationRiskEnsurance>
<cancellationRiskEnsuranceAmount>250.000</cancellationRiskEnsuranceAmount>
<commissionAmount>0.000</commissionAmount>
<commissionPercent>2.000</commissionPercent>
<costPosition>02</costPosition>
<dateFrom>2016-05-23</dateFrom>
<dateOfIssue>2016-06-06</dateOfIssue>
<dateOfMarkedAsPersonal>2011-06-06</dateOfMarkedAsPersonal>
<dateTo>2016-06-06</dateTo>
<destinationDescription>Maldivi</destinationDescription>
<documentDate>2016-04-15</documentDate>
<firstService>DINNER</firstService>
<lastService>BREAKFAST</lastService>
<number>2016-00008</number>
<numberOfDays>14</numberOfDays>
<numberOfParticipients>2</numberOfParticipients>
<organizer>Test e-racuni d.o.o.</organizer>
<services>2xALL</services>
<status>Request</status>
<totalCurrency>EUR</totalCurrency>
<transportation>Plane</transportation>
<Services>
<Service>
<amount>1689.00</amount>
<baseForCommission>0</baseForCommission>
<description>sadsd</description>
<discount>0.00</discount>
<discountAmount>0.00</discountAmount>
<position>1</position>
<quantity>4</quantity>
<totalAmount>6756.00</totalAmount>
</Service>
</Services>
<Participants>
<Participant>
<dateOfBirth>1989-05-12</dateOfBirth>
<position>2</position>
<surnameAndName>STANKA HABJANIC</surnameAndName>
</Participant>
<Participant>
<dateOfBirth>1987-04-12</dateOfBirth>
<position>1</position>
<surnameAndName>STANKO HABJANIC</surnameAndName>
</Participant>
</Participants>
<OtherCosts>
<OtherCost>
<amount>100.00</amount>
<amountCurrency>EUR</amountCurrency>
<date>2016-04-11</date>
<remarks>other costs</remarks>
</OtherCost>
</OtherCosts>
</TABooking>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
<error description=""><error/> <!-- Possible errors: Access denied. User account does not have sufficient privileges for the given request, Parameter named "number" is required, Can not find TABooking for number: 2015-000065,
</response>
TABookingCreate
Create new travel agency booking.
Parameters
| TABooking | Travel agency bookings's data in xml substructure. |
Example request and response
POST /WebServicesSI/API HTTP/1.1
Host: eurofaktura.com
User-Agent: Mozilla/4.0
Content-Length: 410
Content-Type: application/octet-stream
<?xml version="1.0" encoding="utf-8"?>
<request>
<login username="micka" md5pass="ddb43e9f119c6805f4770ecc4f6466ba" token="E7DF3E6E94FB4579BBA8F54979010B5C" />
<method name="TABookingCreate">
<parameter name="TABooking">
<accommodationDescription>Otok Velidhu</accommodationDescription>
<bookingPayerCity>Ljutomer</bookingPayerCity>
<bookingPayerCountry>SI</bookingPayerCountry>
<bookingPayerName>HABJANI STANKO</bookingPayerName>
<bookingPayerPostalCode>9240</bookingPayerPostalCode>
<bookingPayerStreet>VE ICA 38 VE ICA 38</bookingPayerStreet>
<bookingPayerEMail>booking.payer@gmail.com</bookingPayerEMail>
<bookingPayerPhone>026725352</bookingPayerPhone>
<bookingPayerMobilePhone>070306612</bookingPayerMobilePhone>
<businessYear>2016</businessYear>
<cancellationRiskEnsurance>true</cancellationRiskEnsurance>
<cancellationRiskEnsuranceAmount>250.000</cancellationRiskEnsuranceAmount>
<commissionAmount>0.000</commissionAmount>
<commissionPercent>2.000</commissionPercent>
<costPosition>02</costPosition>
<dateFrom>2016-05-23</dateFrom>
<dateOfIssue>2016-06-06</dateOfIssue>
<dateOfMarkedAsPersonal>2011-06-06</dateOfMarkedAsPersonal>
<dateTo>2016-06-06</dateTo>
<destinationDescription>Maldivi</destinationDescription>
<documentDate>2016-04-15</documentDate>
<firstService>DINNER</firstService>
<lastService>BREAKFAST</lastService>
<number>2016-00008</number>
<numberOfDays>14</numberOfDays>
<numberOfParticipients>2</numberOfParticipients>
<organizer>Test e-racuni d.o.o.</organizer>
<services>2xALL</services>
<status>Request</status> <!-- Possible status values: Option, Request, Confirm, Personally, Cancelled, Ready, Coupon, Finished
<totalCurrency>EUR</totalCurrency>
<transportation>Bus</transportation> <!-- Possible transportation values: OwnTransport, Bus, Plane, Ship
<Services>
<Service>
<amount>1689.00</amount>
<baseForCommission>0</baseForCommission>
<description>sadsd</description>
<discount>0.00</discount>
<discountAmount>0.00</discountAmount>
<position>1</position>
<quantity>4</quantity>
<totalAmount>6756.00</totalAmount>
</Service>
</Services>
<Participants>
<Participant>
<dateOfBirth>1989-05-12</dateOfBirth>
<position>2</position>
<surnameAndName>STANKA HABJANIC</surnameAndName>
</Participant>
<Participant>
<dateOfBirth>1987-04-12</dateOfBirth>
<position>1</position>
<surnameAndName>STANKO HABJANIC</surnameAndName>
</Participant>
</Participants>
</parameter>
</method>
</request>
Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
<number>PG2521U</number>
<date>2016-05-23<<date>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
<error description=""><error/> <!-- Possible errors: Access denied. User account does not have sufficient privileges for the given request, Parameter named <TABooking> must be specified., missing mandatory attributes, invalid values, no privileges, Error creating TABooking
</response>
TABookingUpdate
Update existing travel agency booking. Data must contain booking number to be able to identify document which is to be updated.
Parameters
| number | Product group's data in xml substructure |
Example request and response
POST /WebServicesSI/API HTTP/1.1
Host: eurofaktura.com
User-Agent: Mozilla/4.0
Content-Length: 410
Content-Type: application/octet-stream
<?xml version="1.0" encoding="utf-8"?>
<request>
<login username="micka" md5pass="ddb43e9f119c6805f4770ecc4f6466ba" token="E7DF3E6E94FB4579BBA8F54979010B5C" />
<method name="TABookingUpdate">
<parameter name="TABooking">
<number>2016-000010</number> <!-- (Mandatory and Unique)
<!-- Parameters are identical to the parameters in TABookingCreate api
</parameter>
</method>
</request>
Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
<number>2016-000010</number>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
<error description=""><error/> <!-- Possible errors: Access denied. User account does not have sufficient privileges for the given request, Parameter named "TABooking" needed, TABooking's property <number> is required, Can not find TABooking for number: 2016-000010, missing mandatory attributes, invalid values, no privileges,
</response>
TABookingDelete
Delete travel agency booking.
Parameters
| number | Unique identifier for booking. |
Example request and response
POST /WebServicesSI/API HTTP/1.1
Host: eurofaktura.com
User-Agent: Mozilla/4.0
Content-Length: 410
Content-Type: application/octet-stream
<?xml version="1.0" encoding="utf-8"?>
<request>
<login username="micka" md5pass="ddb43e9f119c6805f4770ecc4f6466ba" token="E7DF3E6E94FB4579BBA8F54979010B5C" />
<method name="TABookingDelete">
<parameter name="number" value="2016-000011" />
</method>
</request>
Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
<error description=""><error/> <! Possible errors: Access denied. User account does not have sufficient privileges for the given request, Parameter named <TABooking> is required, Can not find TABooking for number: 2016-000004, Can not delete. Found 3 TABookings with number: 2016-000003,
</response>
TABookingList
Get list of travel agency bookings for specified criteria.
Parameters
| number | Document number |
| status | Status (Option, Request, Confirm, Personally, Cancelled, Ready, Coupon, Finished) |
| dateFrom | Date of departure from. |
| dateTo | Date of departure to. |
| documentDateFrom | Date od document from. |
| documentDateTo | Date od document to. |
| organizer | Search by organizer. |
| subagent | Search by subagent. |
| salesService | Search by sales service. |
| bookingPayer | Search by booking payer. |
| participants | Search by participients. |
| address | Search by booking payer address. |
| subscriber | Search by subscriber. |
Example request and response
POST /WebServicesSI/API HTTP/1.1
Host: eurofaktura.com
User-Agent: Mozilla/4.0
Content-Length: 410
Content-Type: application/octet-stream
<?xml version="1.0" encoding="utf-8"?>
<request>
<login username="micka" md5pass="ddb43e9f119c6805f4770ecc4f6466ba" token="E7DF3E6E94FB4579BBA8F54979010B5C" />
<method name="TABookingList">
<parameter name="number" value="2016-0001*" />
<parameter name="costPosition" value="0001" />
<parameter name="status" value="Request"/>
</method>
</request>
Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
<TABooking>
<!-- structure of TABooking data is the same as in TABookingGet
</TABooking>
<TABooking>
<!-- structure of TABooking data is the same as in TABookingGet
</TABooking>
...
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
<error description=""><error/> <!-- Access denied. User account does not have sufficient privileges for the given request, Invalid search keys, invalid values, no privileges,
</response>
