Tester Helper: Flight Flows

1. Input SearchResponse

Dán toàn bộ body response của hàm Search Flight (dạng mảng itinerary, mỗi phần tử chứa trips) vào đây và nhấn Phân tích.

Tool sẽ tự tách chặng trực tiếp từ mảng response (mỗi phần tử là 1 leg).

2. Chọn Chuyến Bay

Chưa có dữ liệu. Vui lòng phân tích JSON trước.

3. Giỏ Hàng & Result Payload

Kịch bản Test (FlightType)

ADT

CHD

INF

Đã chọn 0 chặng

Giỏ hàng đang trống. Click chọn vé ở cột bên trái để đưa vào giỏ.

Ancillary SSR Builder

Paste response của list-ancillary, parse token từ ssrValue, rồi gán offer cho từng pax.

No parsed booking response context.

No parsed confirm response context.

Seat Map Builder

Paste response của seat-map, parse token từ seatValue, rồi gán ghế cho từng pax.

Generated Request Payloads

Include payments block in /reservations payload (use parsed confirm-price when available)

Hệ thống có 3 luồng booking chính, phân biệt theo loại provider và chiến lược thanh toán. Hãy chọn 1 luồng bên dưới để xem hướng dẫn thực hiện bằng Postman và Easy Air Tool.

1️⃣ Instant Pay (NDC Only) Đơn giản nhất

Search ⟶ Confirm Price 1 ⟶ Create Booking (with payment) ⟶ Retrieve Booking

Thanh toán được truyền trực tiếp ngay trong request tạo booking ban đầu. E-ticket trả về trả về ngay nếu thành công.

Search chuyến bay bằng API Postman /search, lấy kết quả trips gắn vào ô "Paste SearchResponse JSON...".
Chọn chuyến bay vào Giỏ hàng bên phải (ko chọn Addons).
Qua tab Payload "Confirm Price", COPY body. Lên Postman gọi Request /reservations/prices (CP1). Đảm bảo giá rổ đã chuẩn.
Qua tab Payload "Book", COPY body Book.
Mở request /reservations trên Postman. Dán Payload vào body. Lưu ý: Bạn phải tự thêm block payment vào JSON payload trên Postman.
Send Request. Nếu tiền đủ, vé (xuất PNR + E-Ticket) sẽ được tạo và isPaid: true.

2️⃣ Hold & Pay (NDC) Đầy đủ các bước / Ancillary

Search ⟶ Create Draft ⟶ Confirm Price 1 ⟶ Get Seat + Ancillary ⟶ Confirm Price 2 ⟶ Create Booking (no payment) ⟶ Confirm Price 3 (Pay) ⟶ Retrieve

Luồng phức tạp nhất — cho phép giữ chỗ chuyến bay NDC, chọn thêm các dịch vụ bổ sung, rồi mới thành toán xuất vé thật.

Search & Chọn vé: Run API /search trên Postman → Copy trips dán vào ô "Paste SearchResponse JSON..." → Click "➕ Thêm" vào giỏ.
Confirm Price 1 (CP1): Sang tab Payload "Confirm Price", click Copy Payload → Run API /reservations/prices.
🌟 QUAN TRỌNG: Load CP1 Context: Để sử dụng đc Addon NDC, Copy kết quả Response CP1 (JSON), dán đè vào ô "Paste Confirm Price Response context..." trong tool.
Thêm Ancillary / Seat: Qua tab Payload "Addons", chọn /flights/ancillaries hoặc /flights/seat-maps → Copy payload → Run API tương ứng bằng Postman → Dán Response tương ứng về lại tool. Sau đó click thao tác ghim Seat/Hành lý vào Pax.
Confirm Price 2 (Gom Giá): Về lại tab Payload "Confirm Price", tool lúc này đã gắn paxSsr và paxSeat vào rồi. Copy Payload CP2 → Run lại API /reservations/prices.
🌟 QUAN TRỌNG: Cập nhật CP2 Tokens: API CP2 sẽ trả về ID mới từ Provider NDC. Copy toàn bộ KQ CP2 dán vào hộp "Paste Confirm Price Response context..." một lần nữa!
Hold Booking: Tới tab Payload "Book", Copy Payload → Run API /reservations trên Postman (không có block payment). Nhận PNR, chưa có E-Ticket.
Payment: Tiến hành gọi API /reservations/prices (lần 3) với thông tin Payment đính kèm để xuất vé.

3️⃣ Hold & Pay (GDS) Đơn giản hoá

Search ⟶ Confirm Price 1 ⟶ Create Booking (no payment) ⟶ Confirm Price 2 (Payment) ⟶ Retrieve Booking

Luồng GDS đơn giản hơn NDC — không có bản nháp, hệ thống không hỗ trợ shop Addons lẻ trước khi Book. Chỉ tạo PNR rồi Pay.

Search chuyến bay GDS bằng API Postman /search, dán trips vào tool để chọn vé.
Lấy Payload tab "Confirm Price". Chạy API /reservations/prices trên Postman. Khách đồng ý giá rổ!
Bỏ qua hoàn toàn việc chọn Addons/Seat bằng API rẻ nhánh. Lấy thẻ tab Payload "Book".
Gọi request /reservations tạo PNR cho GDS. Lúc này, PNR có trên hãng (1G) nhưng vé chưa thanh toán (chưa có Ticket).
Lấy PNR, đi gọi Confirm Price lần 2 (Đính kèm Payment) trên Postman để hệ thống Issue Ticket GDS!

Luồng cấu trúc thay đổi hành trình (Exchange) hỗ trợ cho cả GDS và NDC.

🟢 Exchange Flow (NDC) Trực tiếp

Book ⟶ Exchange Search ⟶ Reprice ⟶ Execute ⟶ Payment

Nguồn dữ liệu duy nhất cần dùng là Booking REQUEST — chứa đầy đủ fareValue JWT và segmentValue JWT. Nhập PNR nhận được sau khi book thành công.

Book vé NDC thành công. Lưu lại PNR từ booking response (ví dụ: GBNZDT).
Dán Booking REQUEST JSON (book-rq.json, body đã gửi lên POST /reservations) vào ô Input trong tab Exchange.
Điền PNR vào ô PNR Number, chọn hành trình mới (From → To, Ngày), bấm Generate Exchange Search Payload.
Tool tự bóc tách paxId, fareValue từ fareBreakdowns[], segmentValue từ segments[] và giữ lại pricingRuleValue nếu có.
Bấm Copy Exchange Payload, dán vào Postman POST /reservations/exchanges/searches, sau đó dùng POST /reservations/exchanges/reprice trước khi POST /reservations/exchanges/execute.
Sau khi execute giữ booking ở trạng thái hold, dùng tiếp POST /reservations/exchanges/payments để issue ticket nếu có add-collect.

🔵 Exchange Flow (GDS) Qua Workbench

Book / Retrieve ⟶ Eligibility Check ⟶ Workbench ⟶ Exchange Search

Với GDS, API yêu cầu mã định danh PNR và ID của vé cũ từ phiên làm việc (Workbench) ẩn trong hệ thống.

Book một vé GDS (bảo đảm đã issue ticket). Lấy Booking Response GDS dán vào ô Input Booking Response.
Nhập tham số ngày, giờ, chặng bay mới và bấm Generate Exchange Search.
Khác với NDC, khi gọi API POST /reservations/exchanges/searches, hệ thống backend Hub sẽ tự động mở Post-Commit Workbench bằng pnrNumber để trích xuất travelerId và offerId trước khi push vào Search. Tool chỉ set cờ và map PNR, TicketNumber.
Dán Payload copy từ Tool vào Postman và kiểm tra options. (Chú ý hệ thống Sandbox GDS có thể timeout nếu server chậm).
Khi chọn trip và chạy POST /reservations/exchanges/execute, payload hiện tại luôn kèm payments[] cho GDS để khớp schema/service, kể cả even exchange hoặc refund.

1 Exchange Search POST /reservations/exchanges/searches

🟢 NDC Flow: Book NDC → lấy PNR → paste Booking REQUEST JSON → generate search → gọi API.
Bỏ qua Eligibility Check. fareValue/segmentValue lấy từ book-rq.json.

Dán Booking REQUEST JSON (book-rq.json). Tool tự trích fareValue, segmentValue và pricingRuleValue nếu có. Nhập PNR nhận được sau khi book.

PNR Number *

Flight Type

From

➔

Depart Date

2 Parse Response & Select Trip extract fareValue

Paste Exchange Search Response JSON. Click trip card để chọn → auto-sinh Reprice + Execute, giữ nguyên pricingRuleValue từ selected fare nếu có.
Tip: Hỗ trợ cả {"status":200,"body":{...}} và body trực tiếp.

3 Exchange Reprice POST /reservations/exchanges/reprice

4 Exchange Execute POST /reservations/exchanges/execute

Execute payload tự sinh khi chọn trip. Với GDS, payments[] được giữ để khớp schema/service hiện tại; với NDC, payment là bước riêng. Paste Reprice Response (tuỳ chọn) để cập nhật pricing.

Pax ID: Include payments

NDC Flow: Search → chọn trip → Reprice API → Execute API → Payment API
GDS Flow: Eligibility → Search → chọn trip → Execute API (bỏ qua Reprice, vẫn gửi payments[])

1 Cancel + Search Payloads

GDS held booking flow: cancel segments first via cancel API, then search replacement offer. Paste Retrieve Booking RESPONSE JSON to map pax/itinerary/segment data.

PNR Number *

From

Depart Date

2 Parse Search Response extract fareValue

3 Modify Booking (Add Offer) POST /reservations/exchanges/execute

Build payload to add new segment/offer after cancel step. This uses source + selected fareValue.

Cancel Booking Payload Builder

Dán Booking REQUEST JSON (file book-rq.json) vào bên dưới. Tool sẽ tự bóc tách thông tin để build payload cho các API huỷ vé.
Refund Quote → POST /reservations/refund-quotes (chỉ dùng cho void ticket NDC)
Cancel Booking → POST /reservations/cancellations (void NDC / held NDC / held GDS / void GDS)

PNR Number *

Booking ID (workbench)

Content Source

✈️ Flight Flows Tool

1. Input SearchResponse

2. Chọn Chuyến Bay

3. Giỏ Hàng & Result Payload

Ancillary SSR Builder

Seat Map Builder

Generated Request Payloads

1 Exchange Search POST /reservations/exchanges/searches

0 Eligibility Check GET /reservations/exchanges/eligibility

2 Parse Response & Select Trip extract fareValue

3 Exchange Reprice POST /reservations/exchanges/reprice

4 Exchange Execute POST /reservations/exchanges/execute

5 Exchange Payment (NDC) POST /reservations/exchanges/payments

1 Cancel + Search Payloads

2 Parse Search Response extract fareValue

3 Modify Booking (Add Offer) POST /reservations/exchanges/execute

Cancel Booking Payload Builder

✈️ Flight Flows Tool

1. Input SearchResponse

2. Chọn Chuyến Bay

3. Giỏ Hàng & Result Payload

Ancillary SSR Builder

Seat Map Builder

Generated Request Payloads

Tài Liệu Booking Flows

1 Exchange Search POST /reservations/exchanges/searches

0 Eligibility Check GET /reservations/exchanges/eligibility

2 Parse Response & Select Trip extract fareValue

3 Exchange Reprice POST /reservations/exchanges/reprice

4 Exchange Execute POST /reservations/exchanges/execute

5 Exchange Payment (NDC) POST /reservations/exchanges/payments

1 Cancel + Search Payloads

2 Parse Search Response extract fareValue

3 Modify Booking (Add Offer) POST /reservations/exchanges/execute

Cancel Booking Payload Builder