Thông báo Giao dịch (Dữ liệu của cơ sở lưu trú)

Tổng quan

Thông báo Giao dịch ARI (Dữ liệu của cơ sở lưu trú) xác định thông tin về các loại phòng và gói dịch vụ (hoặc gói giá) của từng cơ sở lưu trú. Mỗi dữ liệu loại phòng bao gồm một giá trị nhận dạng duy nhất (RoomID), tên đã bản địa hoá, nội dung mô tả và URL cho ảnh về phòng. Mỗi dữ liệu về gói bao gồm một giá trị nhận dạng duy nhất (PackageID), tên đã bản địa hoá, nội dung mô tả, số người lưu trú và số lượt thêm giá trị.

Bạn có thể dùng thông báo Giao dịch để làm những việc sau:

• Xác định dữ liệu cho một hoặc nhiều thuộc tính.
• Xác định thông tin về loại phòng và gói dịch vụ cho từng cơ sở lưu trú.
• Kiểm soát việc cung cấp sản phẩm.

Ngoài ra, bạn có thể thiết lập các thao tác để thực hiện những việc sau:

• Thêm loại phòng và gói dịch vụ vào cơ sở lưu trú.
• Xoá loại phòng và gói dịch vụ khỏi cơ sở lưu trú.

Để biết ví dụ về thông báo giao dịch, hãy xem bài viết Ví dụ về giao dịch (Dữ liệu của cơ sở lưu trú).

Phần tử bắt buộc và phần tử không bắt buộc

Tài liệu tham khảo XML cung cấp nội dung mô tả về các phần tử bắt buộc và không bắt buộc. Để biết thông tin chi tiết về các thuộc tính và phần tử con, hãy xem bài viết Phần tử và thuộc tính giao dịch (Dữ liệu của cơ sở lưu trú).

Cú pháp và giản đồ

Hãy dùng ví dụ về Cú pháp (Dữ liệu của cơ sở lưu trú) làm tài liệu tham khảo khi tạo thông báo Giao dịch để đảm bảo bạn đang sử dụng đúng định dạng.

Bạn có thể sử dụng công cụ XML của bên thứ ba như xmllint để xác thực nguồn cấp dữ liệu của mình bằng giản đồ đã xuất bản trước khi gửi cho Google. Đối với giản đồ thông báo Giao dịch, hãy xem giản đồ Quảng cáo khách sạn.

Nguyên tắc

Làm theo các nguyên tắc sau đây đối với Thông báo giao dịch:

Việc cần làm:

delta: Dùng để thêm hoặc cập nhật loại phòng và gói dịch vụ mới (gói giá).

overlay: Dùng để thay thế tất cả các loại phòng và gói dịch vụ của cơ sở lưu trú bằng một tập hợp mới. Phải bao gồm thông tin về tất cả các loại phòng và gói giá mà bạn vẫn muốn bán.

Ngôn ngữ được hỗ trợ:

Hãy chỉ định từ 1 đến 2 ngôn ngữ (tiếng Anh và ngôn ngữ địa phương của tài sản, nếu cần) cho các trường Tên, Mô tả và Phụ đề. Bạn có thể thêm nhiều hơn 2 ngôn ngữ nếu cần.

Loại phòng và gói dịch vụ:

Khi cập nhật loại phòng hoặc gói dịch vụ, bạn phải gửi tất cả thông tin liên quan về loại phòng hoặc gói dịch vụ đó. Ví dụ: khi thêm một ảnh, bạn cũng phải thêm tên và nội dung mô tả.

<AllowablePackageIDs> và <AllowableRoomIDs> là không bắt buộc. Nếu không đặt thì người dùng có thể kết hợp loại phòng và gói giá. Bạn vẫn phải gửi tình trạng phòng và giá phòng cùng với mã loại phòng và mã gói giá. Các phần tử này cho phép bạn kiểm soát sản phẩm cũng như huỷ kích hoạt các tổ hợp mà hệ thống của bạn không còn hỗ trợ.

Gửi thông báo cập nhật về Thông báo giao dịch cho Google mỗi khi có thay đổi về loại phòng hoặc gói dịch vụ, hoặc thông tin quan trọng về loại phòng hoặc gói dịch vụ cần bổ sung.

Lưu ý: Vì Google lưu trữ dữ liệu cơ sở lưu trú liên kết với một cơ sở lưu trú "đã so khớp", nên Google không thể chấp nhận dữ liệu này cho đến khi cơ sở lưu trú tương ứng được "so khớp" trong hệ thống. Việc gửi tất cả các cơ sở lưu trú trong nguồn cấp dữ liệu danh sách của bạn có thể giúp tránh lỗi hoặc chậm trễ sau này.

Ví dụ:

Phần này đưa ra ví dụ cơ bản về thông báo Giao dịch ARI bằng các phần tử bắt buộc và không bắt buộc. Để thêm hoặc cập nhật loại phòng và gói dịch vụ, bạn sẽ sử dụng một thao tác cho delta để thêm hoặc cập nhật loại phòng và gói dịch vụ, hoặc overlay để thay thế tất cả định nghĩa về loại phòng và gói dịch vụ (xoá các mục cũ).

Bạn cần chỉ định từ 1 đến 2 ngôn ngữ (tiếng Anh và ngôn ngữ địa phương cho thuộc tính nếu cần) cho các trường Tên, Mô tả và Phụ đề. Sau đó, hãy thêm thông tin dữ liệu thuộc tính, bao gồm cả đường liên kết đến ảnh.

Đối với <PropertyID> và <RoomID>, hãy sử dụng cùng một mã nhận dạng mà bạn dùng trong hệ thống cho các gói giá và loại phòng (tương ứng). Sự nhất quán với hệ thống là yếu tố rất quan trọng để đảm bảo Google hiển thị giá và dữ liệu của bạn chính xác.

Lưu ý: Google dùng "mã" làm giá trị nhận dạng của loại phòng và gói dịch vụ (gói giá). Trong khi đó, XML OTA dùng "mã". Bạn phải sử dụng mã nhận dạng của riêng mình vì Google không tạo các mã đó. Đối với dữ liệu cơ sở lưu trú, mã loại phòng và mã gói giá phải khác nhau cho mỗi cơ sở lưu trú.

Sau khi chuẩn bị tệp, bạn phải gửi tệp đó cho Google qua thông báo POST tới điểm cuối sau: https://www.google.com/travel/hotels/uploads/property_data

Để tìm hiểu thêm về cách đẩy/POST thông báo, hãy xem phần Đẩy thông báo.

Ví dụ sau đây cho biết cách thiết lập thông báo Giao dịch bằng thao tác delta:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="202X-XX-XXT00:00:00-0X:00" id="12345678" partner="partner_key">
  <PropertyDataSet action="delta">
    <Property>PROPERTYID</Property>
      <RoomData>
        <RoomID>ROOMID</RoomID>
        <Name><Text text="ROOM NAME" language="en"/></Name>
        <Description>
          <Text text="ROOM DESCRIPTION TEXT" language="en"/>
        </Description>
        <Capacity>4</Capacity>
        <PhotoURL>
          <Caption><Text text="ROOM PHOTO CAPTION TEXT" language="en"/></Caption>
          <URL>https://LINK TO PHOTO</URL>
        </PhotoURL>
      </RoomData>
      <PackageData>
        <PackageID>BASE</PackageID>
        <Name><Text text="Internet Special" language="en"/></Name>
        <Description><Text text="Direct Booking through Hotel Website" language="en"/></Description>
        <Refundable available="true" refundable_until_days="2" refundable_until_time="12:00"/>
      </PackageData>
  </PropertyDataSet>
</Transaction>

Để biết thêm ví dụ, chẳng hạn như cách sử dụng thao tác overlay, thêm loại phòng và gói dịch vụ vào dữ liệu cơ sở lưu trú hiện có, cũng như xoá các loại phòng và gói dịch vụ hiện có, hãy xem bài viết Ví dụ về giao dịch (Dữ liệu của cơ sở lưu trú).

Hướng dẫn

Phần này đưa ra giải pháp cho các trường hợp bạn có thể gặp phải khi gửi thông báo Giao dịch.

Trường hợp 1: Cách xoá dữ liệu loại phòng

Làm cách nào để xoá dữ liệu về loại phòng và/hoặc gói dịch vụ hiện có?

Nội dung mô tả

Bạn đã gửi nhiều loại phòng, bao gồm cả phòng King và phòng Queen, cho cơ sở lưu trú. Tất cả các loại phòng Giường đôi lớn không được cung cấp trong quá trình tu sửa và hiện chỉ có loại phòng 1m8x2m.

Giải pháp

• Bạn không cần cập nhật tình trạng phòng mỗi đêm, giá phòng hoặc quỹ phòng đối với loại phòng và mã gói đã bị xoá hoặc huỷ kích hoạt.
• Nếu loại phòng hoặc gói dịch vụ đã bị xoá hoặc huỷ kích hoạt, hãy gửi thông báo Giao dịch mới bằng action="overlay". Thông báo này chỉ bao gồm các loại phòng và gói dịch vụ vẫn đang hoạt động, đồng thời không bao gồm loại phòng hoặc gói dịch vụ bị xoá.

Mẫu

Đoạn mã XML này cho biết cách dùng thao tác overlay để xoá một loại phòng.

Lưu ý: Mặc dù mẫu này đề cập đến loại phòng, nhưng bạn cũng có thể dùng cùng một thao tác để xoá dữ liệu gói.

Sau đây là hành động delta gốc, bao gồm các loại phòng 180 cm x 200 cm và 160 cm x 200 cm:

  <PropertyDataSet action="delta">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>King</RoomID>
      <Name>
        <Text text="King" language="en"/>
      </Name>
      <Capacity>2</Capacity>
    </RoomData>
    <PackageData>
      <PackageID>Standard</PackageID>
      <Name>
        <Text text="Standard" language="en"/>
      </Name>
      <Description>
        <Text text="Standard rate" language="en"/>
      </Description>
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>0</BreakfastIncluded>
      </PackageData>
    <RoomData>
      <RoomID>Queen</RoomID>
      <Name>
        <Text text="Queen" language="en"/>
      </Name>
      <Capacity>2</Capacity>
      <!-- Additional RoomData child elements omitted. -->
    </RoomData>
  </PropertyDataSet>

Sau đó, bạn có thể đặt overlay để xoá loại phòng Queen và giữ lại loại phòng King:

  <PropertyDataSet action="overlay">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>King</RoomID>
      <Name>
        <Text text="King" language="en"/>
      </Name>
      <Capacity>2</Capacity>
    </RoomData>
    <PackageData>
      <PackageID>Standard</PackageID>
      <Name>
        <Text text="Standard" language="en"/>
      </Name>
      <Description>
        <Text text="Standard rate" language="en"/>
      </Description>
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>0</BreakfastIncluded>
    </PackageData>
  </PropertyDataSet>

Trường hợp 2: Cách kiểm soát sản phẩm bằng AllowablePackageIDs

Làm cách nào để kiểm soát sản phẩm (tổ hợp loại phòng và gói dịch vụ) khi các gói dịch vụ được nhóm theo loại phòng?

Lưu ý: Nếu các loại phòng được nhóm theo gói dịch vụ, hãy xem Tình huống 3.

Nội dung mô tả

Bạn có một số gói chỉ dành cho một số loại phòng. Ví dụ: nếu cơ sở lưu trú của bạn có 4 loại phòng (bao gồm cả phòng Tổng thống) và 6 gói khác nhau, nhưng chỉ có một vài gói đủ điều kiện xuất hiện trong phòng tổng thống, thì bạn có thể chỉ định điều kiện sử dụng.

Giải pháp

Gửi thông báo Giao dịch đã cập nhật để chỉ định những sản phẩm có trong gói bằng cách sử dụng <AllowablePackageIDs>.

Lưu ý: Sử dụng <AllowablePackageIDs> hoặc <AllowableRoomIDs> chứ không phải cả hai, và phần tử bạn sử dụng phụ thuộc vào việc hệ thống của bạn sử dụng hệ thống phân cấp phòng>gói hay gói>phòng. Nếu không có phần tử nào trong số này được xác định trong thông báo Giao dịch, thì bạn có thể kết hợp các loại phòng với bất kỳ gói dịch vụ nào.

Mẫu

Đoạn mã XML này cho biết cách dùng <AllowablePackageIDs> để chỉ định các gói dùng cho một loại phòng nhất định. Ở đây, loại phòng suite Penthouse chỉ cho phép gói Penthouse trọn gói hoặc gói Bữa sáng miễn phí, còn loại phòng King chỉ cho phép gói trọn gói 1m8x2m hoặc gói dành cho thú cưng.

<RoomData>
  <RoomID>penthouse_suite</RoomID>
  <AllowablePackageIDs>
    <AllowablePackageID>penthouse_all_inclusive</AllowablePackageID>
    <AllowablePackageID>free_breakfast</AllowablePackageID>
  </AllowablePackageIDs>
  <!-- Additional child elements omitted. -->
</RoomData>
<RoomData>
  <RoomID>king_suite</RoomID>
  <AllowablePackageIDs>
    <AllowablePackageID>king_all_inclusive</AllowablePackageID>
    <AllowablePackageID>pet_friendly</AllowablePackageID>
  </AllowablePackageIDs>
  <!-- Additional child elements omitted. -->
</RoomData>
<PackageData>
  <PackageID>penthouse_all_inclusive</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
  <PackageID>free_breakfast</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
  <PackageID>king_all_inclusive</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
  <PackageID>pet_friendly</PackageID>
</PackageData>

Lưu ý: Nếu sử dụng <AllowablePackageIDs> hoặc <AllowableRoomIDs> để huỷ kích hoạt một tổ hợp mà có thể bạn đã sử dụng trước đó nhưng hiện không được cho phép trong hệ thống, thì bạn không cần gửi lại ARI cho tất cả các ngày chỉ để xoá dữ liệu trước đó.

Trường hợp 3: Cách kiểm soát sản phẩm bằng AllowableRoomIDs

Làm cách nào để kiểm soát sản phẩm (tổ hợp loại phòng và gói dịch vụ) khi các loại phòng được nhóm theo gói?

Lưu ý: Nếu các gói dịch vụ được nhóm theo loại phòng, hãy xem Tình huống 2.

Nội dung mô tả

Tổ hợp loại phòng và gói dịch vụ không còn được bán dưới dạng sản phẩm nữa hoặc bạn muốn kiểm soát nội dung có trong gói mới. Ví dụ: bạn chỉ muốn chỉ định một số loại phòng nhất định, chẳng hạn như phòng King và phòng Queen nhìn ra biển, có gói dịch vụ.

Giải pháp

Gửi một thông báo Giao dịch đã cập nhật có nêu chính xác các sản phẩm đi kèm gói bằng phần tử <AllowableRoomIDs>.

Mẫu

Đoạn mã XML này cho biết cách sử dụng <AllowableRoomID> để chỉ định các loại phòng King và phòng Queen nhìn ra biển trong gói dịch vụ.

<PackageID>RO</PackageID>
<AllowableRoomIDs>
  <AllowableRoomID>king_oceanview</AllowableRoomID>
  <AllowableRoomID>queen_oceanview</AllowableRoomID>
</AllowableRoomIDs>