Issue Ticket

1. Tổng quan

• Action url: /api/v1/bamboo/manager/issue-ticket
• Đặc tả chi tiết: Swagger Link (opens new window)
• Tính năng này cho phép xuất vé Bamboo Airways.

2. Hướng dẫn sử dụng

1. Thực hiện request từ thông tin mã máy bay để xuất vé máy bay
2. Gửi POST tới API action URL để nhận về kết quả xuất vé
3. Nhận về response và xử lý dữ liệu ở phía ứng dụng của đại lý.

---

3. Parameters

Bảng mô tả Parameters

Thuộc tính	Bắt buộc	Kiểu dữ liệu	Mô tả
'x-api-token'	Có	String	Token API (F10)
'x-api-password'	Có	String	Mật khẩu API (F10)
'x-api-account'	Có	String	Tài khoản API (F10)

4. Request body

4.1 Ví dụ Request body

{
  "air_booking_id": "FLN202510241008161761275296301614684"
}

4.2 Cấu trúc dữ liệu

Thuộc tính	Kiểu dữ liệu	Mô tả	Ví dụ
'Air_booking_id'	String	ID đặt chỗ từ bamboo airways

5. Response

5.1 Ví dụ Response

{
  "statusCode": 200,
  "timestamp": "2025-10-24T03:27:42.516Z",
  "path": "/api/v1/bamboo/manager/issue-ticket",
  "message": "Xuất vé Bamboo Airways thành công",
  "data": {
    "error": null,
    "user_book": "baobao100383@gmail.com",
    "user_issue": "baobao100383@gmail.com",
    "source": "API",
    "pnr_number": "EKA0BZ",
    "pnr_status": "Active",
    "pnr_on_hold": false,
    "creation_datetime": "2025-10-24 03:27:00",
    "last_modified_datetime": "",
    "number_of_seats": 1,
    "itinerary": [
      {
        "flight_segment_group_id": 1,
        "segment_id": 1,
        "carrier_code": "QH",
        "flight_number": "201",
        "flight_date": "2025-10-25",
        "board_point": "HAN",
        "off_point": "SGN",
        "scheduled_departure_datetime": "2025-10-25 05:35:00",
        "scheduled_arrival_time": "2025-10-25 07:45:00",
        "departure_terminal": "1",
        "arrival_terminal": "3",
        "cabin_class": "ECONOMY",
        "flight_status": "HK",
        "aircraft_type": "321",
        "booking_class": "N",
        "is_international": false
      }
    ],
    "guest_details": [
      {
        "given_name": "NAM",
        "sur_name": "KHANH",
        "name_prefix": "MR",
        "type": "ADULT",
        "guest_id": 2,
        "ticket_detail": {
          "number": "9262412896847"
        },
        "ticket_details": [
          {
            "number": "9262412896847",
            "coupon_details": [
              {
                "number": "1",
                "status": "I",
                "baggage_allowance_weight": "0",
                "baggage_allowance_unit": "K",
                "segment_id": 1
              }
            ]
          }
        ]
      }
    ],
    "ssr_details": [
      {
        "code": "LOUG",
        "status": "HK",
        "guest_id": 2,
        "segment_id": 1,
        "amount": 290000,
        "currency": "VND",
        "ticket_detail": {
          "number": "9264560329388"
        }
      }
    ],
    "seat_details": [
      {
        "number": "15A",
        "status": "HK",
        "guest_id": 2,
        "segment_id": 1,
        "amount": 75000,
        "currency": "VND",
        "ticket_detail": {
          "number": "9264560329387"
        }
      }
    ],
    "fee_details": null,
    "emd_deposits": [],
    "pnr_contact": {
      "address": {
        "email": "HOC22100@GMAIL.COM",
        "phone_number": "+84969573782"
      },
      "name_prefix": "",
      "language": "EN",
      "sur_name": "CHUA TUNG",
      "given_name": ""
    },
    "itin_price": {
      "guest_price_break_down": [
        {
          "price_break_down": [
            {
              "applied_fare_detail_type": {
                "base_fare": 1249000,
                "base_fare_currency": "VND",
                "applied_fare": 1249000,
                "display_fare_amount": 1249000,
                "currency": "VND"
              },
              "fare_detail_for_guest_type": [
                {
                  "fare_basis": "NES0F",
                  "fare_type": "EconomySmart",
                  "segment_id": [
                    1
                  ],
                  "fare_component_id": 1
                }
              ],
              "total_tax": {},
              "tax": [
                {
                  "code": "YR",
                  "amount": 446000,
                  "currency": "VND",
                  "iata_code": "YR"
                },
                {
                  "code": "AX",
                  "amount": 99000,
                  "currency": "VND",
                  "iata_code": "AX"
                },
                {
                  "code": "C4",
                  "amount": 20000,
                  "currency": "VND",
                  "iata_code": "C4"
                },
                {
                  "code": "UE",
                  "amount": 100000,
                  "currency": "VND",
                  "iata_code": "UE"
                },
                {
                  "code": "UE",
                  "amount": 36000,
                  "currency": "VND",
                  "iata_code": "UE"
                }
              ],
              "guest_type": "ADULT"
            }
          ]
        }
      ],
      "total_amount_paid": {
        "currency": "VND",
        "amount": 2309000,
        "form_of_payment": "AGP",
        "guest_amount": [
          {
            "guest_id": 2,
            "amount": 2309000,
            "currency": "VND",
            "guest_type": "ADULT"
          }
        ]
      },
      "total_amount_tobe_paid": {},
      "time_limit_detail": {},
      "refund_amount": {},
      "remarks": [
        "BOOKED BY: BAOBAO100383@GMAIL.COM - 2025-10-24T10:09:00.000Z",
        "ISSUED BY: BAOBAO100383@GMAIL.COM - 2025-10-24T10:27:30.000Z"
      ],
      "id": "FLN202510241008161761275296301614684",
      "success": true,
      "errors": null
    }
  }
}

5.2 Response (top-level)

Thuộc tính	Kiểu dữ liệu	Mô tả	Ví dụ
'statusCode'	number (integer)	Mã trạng thái HTTP.
'timestamp'	string (ISO 8601)	Thời điểm phản hồi.
'path'	string	Đường dẫn API.
'message'	string	Thông báo chung.
'data'	object	Khối dữ liệu chi tiết.
'id'	string	ID truy vết/yêu cầu.
'success'	boolean	Trạng thái thành công của thao tác.
'errors'	array<object> \| null	Danh sách lỗi nếu có.

data

Thuộc tính	Kiểu dữ liệu	Mô tả	Ví dụ
error	string \| null	Lỗi nếu có.
user_book	string (email)	Người tạo booking.
user_issue	string (email)	Người xuất vé.
source	string	Nguồn thao tác (API/WEB/AGENT…).
pnr_number	string	Mã đặt chỗ (PNR).
pnr_status	string	Trạng thái PNR.
pnr_on_hold	boolean	PNR đang giữ chỗ hay không.
creation_datetime	string (YYYY-MM-DD HH:mm:ss)	Thời điểm tạo PNR.
last_modified_datetime	string	Thời điểm cập nhật gần nhất (nếu có).
number_of_seats	number (integer)	Số ghế.
itinerary	array<object>	Danh sách chặng bay.
guest_details	array<object>	Danh sách khách.
ssr_details	array<object>	Dịch vụ bổ sung (SSR).
seat_details	array<object>	Dịch vụ chọn ghế.
fee_details	object \| null	Chi tiết phí bổ sung (nếu có).
emd_deposits	array<object>	Các EMD/phiếu thu kèm theo (nếu có).
pnr_contact	object	Thông tin liên hệ PNR.
itin_price	object	Thông tin giá hành trình.
total_amount_paid	object	Tổng đã thanh toán.
total_amount_tobe_paid	object	Tổng tiền còn phải trả.
time_limit_detail	object	Hạn giữ chỗ/ra vé (nếu có).
refund_amount	object	Thông tin hoàn tiền (nếu có).
remarks	array<string>	Ghi chú/remark hệ thống.

data.itinerary[]

Thuộc tính	Kiểu dữ liệu	Mô tả	Ví dụ
flight_segment_group_id	number (integer)	ID nhóm chặng.
segment_id	number (integer)	ID chặng.
carrier_code	string (IATA-2)	Mã hãng.
flight_number	number \| string	Số hiệu chuyến bay.
flight_date	string (YYYY-MM-DD)	Ngày bay.
board_point	string (IATA-3)	Sân bay khởi hành.
off_point	string (IATA-3)	Sân bay đến.
scheduled_departure_datetime	string (YYYY-MM-DD HH:mm:ss)	Giờ cất cánh dự kiến.
scheduled_arrival_time	string (YYYY-MM-DD HH:mm:ss)	Giờ hạ cánh dự kiến.
departure_terminal	string	Nhà ga đi.
arrival_terminal	string	Nhà ga đến.
cabin_class	string (enum)	Hạng khoang.
flight_status	string	Tình trạng segment.
aircraft_type	string	Loại tàu bay.
booking_class	string	Hạng đặt chỗ.
is_international	boolean	Chặng quốc tế hay nội địa.

data.guest_details[]

Thuộc tính	Kiểu dữ liệu	Mô tả	Ví dụ
given_name	string	Tên khách.
sur_name	string	Họ khách.
name_prefix	string	Xưng hô.
type	string (enum)	Loại khách: ADULT/CHILD/INFANT.
guest_id	number (integer)	ID khách.
ticket_detail	object	Số vé chính (nếu có).
ticket_details	array<object>	Danh sách vé & coupon chi tiết.

data.guest_details[].ticket_detail

Thuộc tính	Kiểu dữ liệu	Mô tả	Ví dụ
number	string	Số vé điện tử (ETKT).

data.guest_details[].ticket_details[]

Thuộc tính	Kiểu dữ liệu	Mô tả	Ví dụ
number	string	Số vé điện tử (ETKT).
coupon_details	array<object>	Chi tiết coupon.

data.guest_details[].ticket_details[].coupon_details[]

Thuộc tính	Kiểu dữ liệu	Mô tả	Ví dụ
number	string	Số thứ tự coupon (1..4).
status	string	Trạng thái coupon (O/I/C/F…).
baggage_allowance_weight	string	Khối lượng hành lý.
baggage_allowance_unit	string	Đơn vị khối lượng (K = kilogram).
segment_id	number (integer)	ID chặng áp dụng.

data.ssr_details[]

Thuộc tính	Kiểu dữ liệu	Mô tả	Ví dụ
code	string	Mã dịch vụ bổ sung (SSR code).
status	string	Trạng thái (HK/HL/UC…).
guest_id	number (integer)	ID khách áp dụng.
segment_id	number (integer)	ID chặng áp dụng.
amount	number	Giá dịch vụ.
currency	string (ISO-4217)	Tiền tệ.
ticket_detail	object	Thông tin vé phát hành cho SSR.

data.ssr_details[].ticket_detail

Thuộc tính	Kiểu dữ liệu	Mô tả	Ví dụ
number	string	Số vé điện tử (ETKT).

data.seat_details[]

Thuộc tính	Kiểu dữ liệu	Mô tả	Ví dụ
number	string	Số ghế (seat number).
status	string	Trạng thái (HK…).
guest_id	number (integer)	ID khách áp dụng.
segment_id	number (integer)	ID chặng áp dụng.
amount	number	Giá chọn ghế.
currency	string (ISO-4217)	Tiền tệ.
ticket_detail	object	Thông tin vé phát hành cho seat fee.

data.seat_details[].ticket_detail

Thuộc tính	Kiểu dữ liệu	Mô tả	Ví dụ
number	string	Số vé điện tử (ETKT).

data.pnr_contact

Thuộc tính	Kiểu dữ liệu	Mô tả	Ví dụ
address	object	Địa chỉ liên hệ.
name_prefix	string	Xưng hô người liên hệ.
language	string	Ngôn ngữ.
sur_name	string	Họ người liên hệ.
given_name	string	Tên người liên hệ.

data.pnr_contact.address

Thuộc tính	Kiểu dữ liệu	Mô tả	Ví dụ
email	string (email)	Email liên hệ.
phone_number	string	Số điện thoại liên hệ.

data.itin_price

Thuộc tính	Kiểu dữ liệu	Mô tả	Ví dụ
guest_price_break_down	array<object>	Chi tiết giá theo từng khách.

data.itin_price.guest_price_break_down[]

Thuộc tính	Kiểu dữ liệu	Mô tả	Ví dụ
price_break_down	array<object>	Thành phần giá.
tax	array<object>	Thuế/phụ phí theo khách.
guest_type	string (enum)	Loại khách.

data.itin_price.guest_price_break_down[].price_break_down[]

Thuộc tính	Kiểu dữ liệu	Mô tả	Ví dụ
applied_fare_detail_type	object	Nhóm giá & tiền tệ.
fare_detail_for_guest_type	array<object>	Thông tin hạng vé theo loại khách.
total_tax	object	Tổng thuế (nếu có).

data.itin_price.guest_price_break_down[].price_break_down[].applied_fare_detail_type

Thuộc tính	Kiểu dữ liệu	Mô tả	Ví dụ
base_fare	number	Giá cước gốc.
base_fare_currency	string (ISO-4217)	Tiền tệ của base_fare.
applied_fare	number	Giá cước đã áp dụng.
display_fare_amount	number	Giá hiển thị.
currency	string (ISO-4217)	Tiền tệ hiển thị.

data.itin_price.guest_price_break_down[].price_break_down[].fare_detail_for_guest_type[]

Thuộc tính	Kiểu dữ liệu	Mô tả	Ví dụ
fare_basis	string	Fare basis code.
fare_type	string	Brand/loại giá.
segment_id	array<number> \| number	Danh sách/ID chặng áp dụng.
fare_component_id	number (integer)	ID thành phần giá.

data.itin_price.guest_price_break_down[].tax[]

Thuộc tính	Kiểu dữ liệu	Mô tả	Ví dụ
code	string	Mã thuế/phụ phí.
amount	number	Số tiền.
currency	string (ISO-4217)	Tiền tệ.
iata_code	string	Mã IATA (nếu có).

data.total_amount_paid

Thuộc tính	Kiểu dữ liệu	Mô tả	Ví dụ
currency	string (ISO-4217)	Tiền tệ.
amount	number	Tổng tiền đã trả.
form_of_payment	string	Hình thức thanh toán (AGP/CC/CA...).
guest_amount	array<object>	Tổng theo từng khách.

data.total_amount_paid.guest_amount[]

Thuộc tính	Kiểu dữ liệu	Mô tả	Ví dụ
guest_id	number (integer)	ID khách.
amount	number	Số tiền đã trả của khách.
currency	string (ISO-4217)	Tiền tệ.
guest_type	string (enum)	Loại khách.

data.total_amount_tobe_paid

Thuộc tính	Kiểu dữ liệu	Mô tả	Ví dụ
currency	string (ISO-4217)	Tiền tệ tổng thanh toán.
amount	number	Tổng tiền phải trả.
guest_amount	array<object>	Tổng theo từng khách.

data.total_amount_tobe_paid.guest_amount[]

Thuộc tính	Kiểu dữ liệu	Mô tả	Ví dụ
guest_id	number (integer)	ID khách.
amount	number	Số tiền phải trả của khách.
currency	string (ISO-4217)	Tiền tệ.
guest_type	string (enum)	Loại khách.