Confirm booking price.

1. Tổng quan

• Action URL: /api/v1/vj/manage/retrieve-pnr
• Đặc tả chi tiết: Swagger UI (opens new window)
• Mô tả: Tính năng này cho phép API lấy thông tin đặt chỗ (PNR) của Vietjet Air bằng mã đặt chỗ và họ khách hàng.
• Điều kiện: Chỉ áp dụng cho tài khoản có quyền truy cập hợp lệ.

---

3. Hướng dẫn

1. Xây dựng request với đầy đủ header và body
2. Gửi request POST tới Action URL
3. Nhận response chứa thông tin đặt chỗ

---

3. Request

3.1 Ví dụ

{
  "locator": "VFW6HD"
}

3.2 Cấu trúc dữ liệu Request

Tên trường	Bắt buộc	Kiểu dữ liệu	Mô tả	Giá trị mẫu
locator	Có	string	Mã đặt chỗ (Booking Reference hoặc PNR) dùng để tra cứu thông tin đặt chỗ	VFW6HD

4. Response

4.1 Ví dụ

{
  "statusCode": 200,
  "timestamp": "2025-10-28T09:38:40.825Z",
  "path": "/api/v1/vj/manage/retrieve-pnr",
  "message": "Lấy thông tin PNR thành công",
  "data": {
    "success": true,
    "data": [
      {
        "key": "AKqlh8tSfnQBx7rF3¥xvOsRTZpotNHRiD2tJB44vrbq48fdnYFWlReUrtlRizYEuVk8iluYPoRhLY0K2gZqWRA==",
        "number": 187857684,
        "locator": "VFW6HD",
        "bookingInformation": {
          "key": "cmeXGƒ1QIE8CvEPsyQVZlƒxfmbHDRazBh8J¥0Nwy5HD70SD29ƒTMQ30XagFctb698xmstlJ5SKpn8iy7SNjlSs5t3dgh4fmyc7HJ¥dc08iTEBZhiQl4R9wPPKIqhbdSP",
          "sessionIdentifier": "apiW8b34c7c6-cdcc-431b-a69f-17bac2a706a5",
          "distributionChannel": {
            "identifier": "W",
            "description": "Web"
          },
          "externalLocators": null,
          "agency": {
            "key": "AzVnjosPcrHsLOeZtGS9XrnE6FHLhlZKkLkw7a5NbAw=",
            "iataNumber": "34101989",
            "name": "APIGW OTA TESTING"
          },
          "company": {
            "key": "AozgTRmbFSmsfRtwtRLfhtfveKseXDpGLFRvaCM7zVE=",
            "identifier": "34101989",
            "name": "APIGW OTA TESTING"
          },
          "currency": {
            "code": "VND",
            "description": "Vietnam Dong"
          },
          "contactInformation": {
            "name": "Business Name",
            "phoneNumber": "+84987654222",
            "extension": "123",
            "email": "abc@gmail.com",
            "language": {
              "code": "en",
              "name": "English"
            },
            "notificationPreferences": null
          },
          "creation": {
            "time": "2025-10-28 09:36:00Z"
          },
          "hold": {
            "overridden": false,
            "expiryTime": "2025-10-28 13:36:00Z"
          },
          "cancellation": null,
          "bookingType": {
            "eticketed": false,
            "groupReserved": false,
            "frequentFlyerRedeemed": false
          },
          "creditExpiryDate": ""
        },
        "reservationSummary": {
          "passenger": {
            "key": "WwXcehUljtnq4kkeHJJtCT18T6U9OBZdUiYwTLrQANxDnKBmT7N19g4w7AYgiyctggZ9BoATr6oyTCBc7Z8hN923z3bJNƒR6nzRPIQjyiUw=",
            "reservationOwner": true,
            "reservationProfile": {
              "lastName": "PHAM",
              "firstName": "QUANG MINH"
            }
          },
          "seatedPassengerCount": 1,
          "charges": {
            "totalAmount": 1808800
          },
          "payments": {
            "totalAmount": 0
          },
          "refunds": {
            "totalAmount": 0
          },
          "itinerary": "Nov 09, 2025 HAN - SGN CONF"
        }
      }
    ],
    "message": null
  },
  "errors": null
}

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

Tên trường	Kiểu dữ liệu	Mô tả	Bắt buộc
statusCode	Number	Mã trạng thái HTTP của phản hồi	Có
timestamp	String	Thời gian phản hồi (định dạng ISO 8601)	Có
path	String	Đường dẫn API được gọi	Có
message	String	Thông báo từ hệ thống	Có
data.success	Boolean	Trạng thái thành công của yêu cầu	Có
data.data[].key	String	Khóa nội bộ của bản ghi đặt chỗ	Có
data.data[].number	Number	Số thứ tự đặt chỗ nội bộ	Có
data.data[].locator	String	Mã đặt chỗ (PNR Locator Code)	Có
data.data[].bookingInformation.key	String	Khóa thông tin đặt chỗ	Có
data.data[].bookingInformation.sessionIdentifier	String	Mã định danh phiên làm việc	Không
data.data[].bookingInformation.distributionChannel.identifier	String	Mã kênh bán	Có
data.data[].bookingInformation.distributionChannel.description	String	Tên kênh bán	Có
data.data[].bookingInformation.agency.iataNumber	String	Mã IATA của đại lý	Có
data.data[].bookingInformation.agency.name	String	Tên đại lý	Có
data.data[].bookingInformation.company.identifier	String	Mã công ty	Có
data.data[].bookingInformation.company.name	String	Tên công ty	Có
data.data[].bookingInformation.currency.code	String	Mã tiền tệ	Có
data.data[].bookingInformation.currency.description	String	Tên tiền tệ	Có
data.data[].bookingInformation.contactInformation.name	String	Tên người liên hệ	Có
data.data[].bookingInformation.contactInformation.phoneNumber	String	Số điện thoại liên hệ	Có
data.data[].bookingInformation.contactInformation.extension	String	Số nội bộ (nếu có)	Không
data.data[].bookingInformation.contactInformation.email	String	Email liên hệ	Có
data.data[].bookingInformation.contactInformation.language.code	String	Mã ngôn ngữ	Có
data.data[].bookingInformation.contactInformation.language.name	String	Tên ngôn ngữ	Có
data.data[].bookingInformation.creation.time	String	Thời gian tạo đặt chỗ	Có
data.data[].bookingInformation.hold.overridden	Boolean	Đặt chỗ có bị ghi đè không	Không
data.data[].bookingInformation.hold.expiryTime	String	Thời gian hết hạn giữ chỗ	Có
data.data[].bookingInformation.cancellation	Object / null	Thông tin hủy đặt chỗ (nếu có)	Không
data.data[].bookingInformation.bookingType.eticketed	Boolean	Có phải vé điện tử không	Có
data.data[].bookingInformation.bookingType.groupReserved	Boolean	Có phải nhóm đặt chỗ không	Có
data.data[].bookingInformation.bookingType.frequentFlyerRedeemed	Boolean	Có sử dụng điểm thưởng không	Có
data.data[].bookingInformation.creditExpiryDate	String	Ngày hết hạn tín dụng (nếu có)	Không
data.data[].reservationSummary.passenger.key	String	Khóa hành khách	Có
data.data[].reservationSummary.passenger.reservationOwner	Boolean	Hành khách là người sở hữu đặt chỗ	Có
data.data[].reservationSummary.passenger.reservationProfile.lastName	String	Họ hành khách	Có
data.data[].reservationSummary.passenger.reservationProfile.firstName	String	Tên hành khách	Có
data.data[].reservationSummary.seatedPassengerCount	Number	Số lượng hành khách có ghế	Có
data.data[].reservationSummary.charges.totalAmount	Number	Tổng tiền phí/giá vé	Có
data.data[].reservationSummary.payments.totalAmount	Number	Tổng tiền thanh toán	Có
data.data[].reservationSummary.refunds.totalAmount	Number	Tổng tiền hoàn	Có
data.data[].reservationSummary.itinerary	String	Hành trình chuyến bay	Có
errors	Object / null	Thông tin lỗi (nếu có)	Không