Booking API Reference

The Booking API (Azure Functions) handles all dynamic booking operations including cart management, checkout, payment processing, and order placement.

For static program catalog data (build-time only), see the Programs Index API.

Overview

The Booking API provides endpoints for:

• Cart operations - Add/remove services and cross-sale products
• Checkout - Calculate totals, fees, taxes, and installments
• Coupons - Add and remove discount codes
• Orders & Payments - Place orders and handle payment initialization
• Data lookups - Get packages, products, accommodation, and cross-sale items

All endpoints require programId (and often bookingId or serviceId) to operate on specific program bookings.

Base URLs

• Main repository: https://github.com/poslovnimediji/cmt-booking/, api directory
• Production (Azure): https://cmt-booking.azurewebsites.net/api/
• Development (Azure): https://cmt-booking-develop.azurewebsites.net/api/
• Local: http://localhost:7071/api/

Authentication

All endpoints are configured with anonymous access (auth_level=ANONYMOUS). If an external gateway enforces auth, that is outside this codebase.

Content Type

• Request bodies are JSON (application/json) for POST endpoints.
• Most responses are JSON with a shared envelope (see below).

Response Envelope

Most endpoints return:

{
  "success": true,
  "data": <payload>
}

On error (500):

{
  "success": false,
  "error": "<message>"
}

Notes:

• GET /sync-all returns a plain text response ("sync successful") and does not use the JSON envelope.
• Some response payloads are passed through from Salesforce retdata and are not fully described here.

Endpoint Index

Endpoints

GET /keep-warm

Returns a successful response with an empty array.

Response data:

• []

GET /sync-all

Forces cache refresh of active programs.

Response:

• Plain text "sync successful" (not JSON).

GET /packages

Lists packages for a program and date range. Proxies to Salesforce checkavailability.

Query parameters:

• programId (string, required)
• channelId (string, required)
• arrival (string, required) - start date
• departure (string, required) - end date

Response data:

• Array of packages (retdata.wpackages from Salesforce).

GET /products

Returns cached products for a program element.

Query parameters:

• programId (string, required)
• programElement (string, required)

Response data:

• Array of products (cached JSON), or empty array if not found.

GET /accommodation

Returns cached accommodation details plus computed units for the date range.

Query parameters:

• programId (string, required)
• programElement (string, required)
• accommodationSlug (string, required)
• arrival (string, optional) - defaults to program defaultArrivalDate
• departure (string, optional) - defaults to program defaultDepartureDate

Response data:

• Accommodation object from cache with added units field.

GET /cross-sale

Returns cached cross-sale products for a program element and package.

Query parameters:

• programId (string, required)
• programElement (string, required)
• packageId (string, required)

Response data:

• Array of products (base + extension) from cache.

DELETE /cart

Empties the cart in Salesforce for a booking.

Query parameters:

• bookingId (string, required)
• programId (string, required)

Response data:

• null

POST /cart/main

Adds a main service to the cart.

Request body:

• programId (string, required)
• serviceId (string, required)
• arrival (string, required)
• departure (string, required)
• guests (number, required)
• quantity (number, required)
• bookingId (string, optional)
• timeSlotId (string, optional)
• extras (array, optional)
  • Each item:
    • serviceId (string, required)
    • timeSlotId (string, required)

Response data:

• bookingId (string)
• total (number)
• bookingServices (array) - Salesforce retdata.wmservices

POST /cart/cross-sale

Adds a cross-sale service to the cart.

Request body:

• programId (string, required)
• bookingId (string, required)
• serviceId (string, required)
• timeSlotId (string, required)
• guests (number, required)

Response data:

• bookingServiceId (string)
• total (number)

DELETE /cart/cross-sale

Removes a cross-sale service from the cart.

Query parameters:

• bookingServiceId (string, required)
• bookingId (string, required)
• programId (string, required)

Response data:

• total (number)

GET /checkout

Proceeds to checkout and returns totals, fees, installments, and coupons.

Query parameters:

• bookingId (string, required)
• programId (string, required)
• paymentType (string, optional) - defaults to Bank transfer
• cardType (string, optional) - used when paymentType is a card
• insurance (string, optional) - true or false (default false)

Response data:

• total (number)
• bookingFee (number)
• serviceFee (number)
• touristTax (number)
• installments (array)
• insurancePrice (number)
• coupons (array)
• debug (object) - raw Salesforce retdata

POST /coupon

Adds a coupon to the booking.

Request body:

• programId (string, required)
• couponCode (string, required)
• bookingId (string, required)

Response data:

• {}

DELETE /coupon

Removes a coupon from the booking.

Query parameters:

• programId (string, required)
• bookingId (string, required)
• couponCode (string, required)

Response data:

• {}

POST /order

Places an order and handles payment initialization or finalization. When paymentMethod is not Bank transfer, this flow may return a payment URL for the next step.

Request body:

• orderData (object, required) - Salesforce payload for placing order
• paymentMethod (string, required) - Bank transfer, creditcard, or other supported values
• paymentToken (string, optional) - returned from Saferpay initialization
• bookingNumber (string, optional) - required when continuing a payment
• installmentId (string, optional) - required when continuing a payment
• installmentAmount (number, optional) - required for card/PayPal flow
• cardType (string, optional) - required for creditcard
• returnUrl (string, optional) - used for payment redirect
• locale (string, optional) - used for payment page

Response data (one of):

• bookingNumber (string) - when order is finalized or bank transfer
• bookingNumber, installmentId, paymentToken, paymentUrl - when payment page is initialized

Known Gaps

Some field types and allowed enum values are defined by upstream Salesforce or Saferpay APIs and are not validated in this app. If you need strict schemas, confirm the upstream contracts for retdata shapes and supported paymentMethod or cardType values.