DAPI One-Click Booking

Search, create cart, add traveler, checkout, and pay — all in one click

Bearer Token

Office ID

Corporate Code

Interactive mode

Search Options

Commercial Fare Families

International BP International MF Domestic Intl Eco/Prm + Rewards Intl Bus/Fir + Rewards Dom + Rewards

Itinerary

Traveler

Title

First Name

Last Name

Type

Phone

QFF Number

Extra Bags (Optional) Add extra bag(s)

Bags / flight (non-interactive)

Runs after seats, before payment. Fetches /shopping/services/by-order and picks the cheapest bag (filter: tags:BAGGAGE / atpcoCategory.code:BG) per flight. Interactive mode: a form lists each flight's cheapest bag + price and asks for a quantity (0 = skip). Non-interactive: uses the Bags/flight field as the qty for every flight. No inline payment — Step 5b settles alongside air + seats.

Seats (Optional) Auto-assign first available seat on each flight

Runs post-order, pre-payment. First clears any QFF-pushed NSST SSR by passing its id to DELETE /seats (the workaround from SeatErrorHandler.java), then picks firstAvailableSeat per flight and batches in POST /purchase/orders/{id}/seats without paymentRequests — the seat cost is settled by the single air payment at Step 5b.

Payment Card

Card Type

Card Number

Expiry

CVV

Holder Name

▼ Air bounds search orchestration QBR Proxy

How AirBoundsSearchHandler fans out to Amadeus with different Commercial Fare Families (CFFs), merges results, and handles the anchor search for inbound legs.

Routing Outbound fan-out Inbound + anchor Merge & response

flowchart TD classDef route fill:#e3f2fd,stroke:#90caf9,color:#1565c0 classDef outbound fill:#e8f5e9,stroke:#a5d6a7,color:#2e7d32 classDef inbound fill:#f3e5f5,stroke:#ce93d8,color:#7b1fa2 classDef merge fill:#fff3e0,stroke:#ffcc80,color:#e65100 classDef amadeus fill:#fce4e8,stroke:#f48fb1,color:#e0002a classDef nz fill:#e0f2f1,stroke:#80cbc4,color:#00695c SN([Spotnana]):::route -->|"POST /offers/search/air-bounds"| CTRL[CommerceOffersController
resolve officeId + itinerary type]:::route CTRL --> HANDLER{"AirBoundsSearchHandler
selectedBoundId == null?"}:::route %% ── OUTBOUND ── HANDLER -->|"null → outbound"| POS{"Office ID /
itinerary type?"}:::outbound POS -->|"SYD domestic"| DOM["2 parallel calls"]:::outbound POS -->|"SYD international"| INTL["3 parallel calls"]:::outbound POS -->|"Ex-Row POS"| EXROW["3 parallel calls
(country CFFs from enum)"]:::outbound POS -->|"NZ domestic"| NZDOM["1 call
NZDOM CFF"]:::nz DOM -->|"req₁"| D1["Commercial
AUDOML"]:::outbound DOM -->|"req₂"| D2["Classic / Rewards
ACEMECO, ACEMPRM, ACEMBUS"]:::outbound D1 & D2 --> AMA1 INTL -->|"req₁"| I1["Eco / Pre-eco
AUINTECO"]:::outbound INTL -->|"req₂"| I2["Business
AUINTBUS"]:::outbound INTL -->|"req₃"| I3["First
AUINTFIR"]:::outbound I1 & I2 & I3 --> AMA1 EXROW --> AMA1 NZDOM --> AMA1 AMA1["✈️ Amadeus DAPI
airBoundsShopping
(CompletableFuture.allOf)"]:::amadeus --> MERGE %% ── INBOUND ── HANDLER -->|"present → inbound"| ICFF["Apply inbound CFFs
based on user's outbound selection"]:::inbound ICFF --> ANCHOR{"prepareAnchorSearch()
flip isRequestedBound
inverse CFFs
findMatchingAirBoundId()"}:::inbound ANCHOR -->|"match found"| PAR["2 parallel calls"]:::inbound ANCHOR -->|"no match"| SOLO["1 call
(inbound only)"]:::inbound PAR -->|"anchor req"| ANC["Anchor search
(inverse CFF of selected)"]:::inbound PAR -->|"inbound req"| IBR["Inbound search
(same CFF as selected)"]:::inbound ANC & IBR --> AMA2 SOLO --> AMA2 AMA2["✈️ Amadeus DAPI
airBoundsShopping"]:::amadeus --> MERGE %% ── MERGE ── MERGE["Merge + Dedup
• group by flight-signature
• dedup by cabin + class
• filter bad CFF combos
• combine dictionaries (ConcurrentHashMap)"]:::merge MERGE --> SORT["Sort
ranking > 0 → Amadeus rank
else → Domestic / Intl comparator"]:::merge SORT --> RESP(["AirBoundsListReply
airBoundGroups[] + dictionaries"]):::merge RESP --> SN2([Spotnana]):::route

▼ API sequence (happy path) Amadeus DAPI v2

Order of calls this page fires. opt blocks only run when the matching feature is enabled above.

Search Cart build-up Order creation Ancillaries (seats / bags) Payment & finalise

sequenceDiagram autonumber participant T as 🧑‍💻 Tester participant A as ✈️ Amadeus DAPI rect rgb(227, 242, 253) Note over T,A: 1 · Search T->>+A: POST /v2/search/air-offers A-->>-T: offers[ ] + flights end rect rgb(232, 245, 233) Note over T,A: 2 · Cart build-up T->>+A: POST /v2/shopping/carts (air-offer) A-->>-T: cartId opt FF cards provided T->>A: POST /shopping/carts/{cartId}/frequent-flyer-cards A-->>T: FF associated end end rect rgb(243, 229, 245) Note over T,A: 3 · Order creation T->>+A: POST /purchase/orders?cartId= A-->>-T: orderId (PNR) T->>A: POST /purchase/orders/{orderId}/special-keywords (QSME) A-->>T: ok end rect rgb(255, 243, 224) Note over T,A: 4 · Ancillaries opt Seats enabled Note right of T: Clear QFF-pushed NSST SSR
via /seats (not /SSR) T->>A: DELETE /purchase/orders/{orderId}/seats?seatIds= A-->>T: NSST removed loop per flight T->>A: GET /shopping/seatmaps/by-cart A-->>T: seatmap end T->>A: POST /purchase/orders/{orderId}/seats (batch, no paymentRequests) A-->>T: seats reserved end opt Extra bags enabled T->>A: GET /shopping/services/by-order A-->>T: services catalog T->>A: POST /purchase/orders/{orderId}/services A-->>T: bags added end end rect rgb(252, 228, 232) Note over T,A: 5 · Payment & finalise T->>A: POST /v2/purchase/payment-methods A-->>T: payment method token Note right of T: Single air payment settles
air + seats + bags T->>A: POST /purchase/orders/{orderId}/payment-records A-->>T: payment recorded T->>A: POST /purchase/orders/{orderId}/remarks A-->>T: remarks added T->>A: POST /purchase/orders/{orderId}/queue-placement A-->>T: PNR queued end