Package madden.ingestion.offer

Chỉ mục

ActionType

[START action_type_definition] Biểu thị chế độ thực hiện của mặt hàng. Nếu một mặt hàng có thể được chia sẻ trên nhiều phương thức thực hiện đơn hàng, thì bạn cần tạo các mặt hàng trùng lặp cho từng phương thức thực hiện đơn hàng.

Enum
ACTION_TYPE_UNSPECIFIED
ACTION_TYPE_FOOD_DELIVERY Ưu đãi này áp dụng cho các dịch vụ giao đồ ăn.
ACTION_TYPE_FOOD_TAKEOUT Ưu đãi này áp dụng cho đơn đặt hàng mang đi hoặc đơn đặt hàng tự đến lấy.
ACTION_TYPE_DINING Ưu đãi này dành cho khách dùng bữa tại nhà hàng.
ACTION_TYPE_SHOPPING_IN_STORE Ưu đãi này áp dụng cho các giao dịch mua sắm tại cửa hàng thực tế.

AdditionalFee

[START additional_fee_definition]

Trường
name

string

Tên của phí bổ sung. Ví dụ: phí phụ thu, phí xử lý, v.v. Bắt buộc.
fee

Fee

Phiếu giảm giá

[START coupon_definition]

Trường
text

string

Văn bản phiếu giảm giá mà nhà cung cấp ưu đãi muốn hiển thị cho người dùng.
code

string

Bạn phải có mã giảm giá để sử dụng ưu đãi. Bắt buộc.

Phí

[START fee_definition] Mã nhận dạng tiếp theo: 5

Trường
unit

FeeUnit
type

FeeType

Trường nhóm cost.

cost chỉ có thể là một trong những trạng thái sau:
amount

Money
amount_range

MoneyRange

FeeType

[START fee_type_definition]

Enum
FEE_TYPE_UNSPECIFIED Bạn không nên sử dụng giá trị enum UNSPECIFIED hoặc giá trị mặc định trong nguồn cấp dữ liệu.
FEE_TYPE_FIXED
FEE_TYPE_VARIABLE

FeeUnit

[START fee_unit_definition]

Enum
FEE_UNIT_UNSPECIFIED Không được sử dụng giá trị enum UNSPECIFIED hoặc giá trị enum mặc định trong nguồn cấp dữ liệu.
FEE_UNIT_PER_GUEST
FEE_UNIT_PER_TRANSACTION

FixedDenominations

Trường
amounts[]

Money

Danh sách tất cả các mệnh giá riêng biệt hiện có (ví dụ: [100, 500, 1000]).

FoodOfferRestrictions

[START food_offer_restrictions_definition]

Trường
meal_types[]

MealType

Các loại bữa ăn có thể áp dụng ưu đãi, chẳng hạn như bữa trưa hoặc bữa tối. Nếu bạn không đặt, ưu đãi có thể áp dụng cho tất cả các loại bữa ăn.
restricted_to_certain_courses

bool

Liệu ưu đãi chỉ có thể áp dụng cho một số khoá học nhất định hay không.

GiftCardInfo

[START gift_card_info_definition]

Trường

Trường nhóm denomination_type.

denomination_type chỉ có thể là một trong những trạng thái sau:
fixed_denominations

FixedDenominations

Dùng khi thẻ quà tặng có các mệnh giá cố định, cụ thể.
custom_range

MoneyRange

Được dùng khi thương hiệu cho phép người dùng chọn một mệnh giá tuỳ chỉnh (linh hoạt) trong một phạm vi xác định.

MealType

[START meal_type_definition]

Enum
MEAL_TYPE_UNSPECIFIED Không được sử dụng giá trị enum UNSPECIFIED hoặc giá trị enum mặc định trong nguồn cấp dữ liệu.
MEAL_TYPE_BREAKFAST
MEAL_TYPE_LUNCH
MEAL_TYPE_DINNER

MoneyRange

[START money_range_definition]

Trường
min_amount

Money
max_amount

Money

Ưu đãi

LINT.IfChange(offer_definition) [START offer_definition] Next tag: 26

Trường
offer_id

string

Mã nhận dạng duy nhất của ưu đãi. Bắt buộc.
entity_ids[]

string

Danh sách người bán đang tham gia chương trình ưu đãi này.
add_on_offer_applicable_to_all_entities

bool

Nếu đúng, ưu đãi này sẽ áp dụng cho tất cả các pháp nhân thuộc đơn vị tổng hợp. Chỉ áp dụng cho ưu đãi bổ sung.
offer_source

OfferSource

Ưu đãi có thể do đơn vị tổng hợp, một người bán riêng lẻ hoặc thậm chí là một bên thứ ba cung cấp dưới dạng dịch vụ bổ sung. Bắt buộc.
action_type

ActionType

Dịch vụ cung cấp ưu đãi. Một offer_id chỉ có thể thuộc về một action_type. Nếu một ưu đãi có thể được chia sẻ trên nhiều loại dịch vụ, thì bạn cần tạo các ưu đãi trùng lặp có mã nhận dạng duy nhất cho từng loại dịch vụ. Bắt buộc.
offer_modes[]

OfferMode

Các phương thức mà bạn có thể sử dụng ưu đãi – đến trực tiếp, đặt chỗ, trực tuyến, v.v. Bắt buộc.
offer_category

OfferCategory

Danh mục của ưu đãi. Bắt buộc.
source_assigned_priority

int32

Số nguyên không âm ([1-100], trong đó 1 là mức độ ưu tiên cao nhất) cho biết mức độ ưu tiên của sản phẩm do nguồn chỉ định. Khi có nhiều mặt hàng của cùng một người bán, đây sẽ là một tín hiệu để xếp hạng mặt hàng. 0 có nghĩa là bạn chưa đặt mức độ ưu tiên.
offer_details

OfferDetails

Thông tin chi tiết về ưu đãi, chẳng hạn như chiết khấu, chi phí đặt phòng, v.v. Bắt buộc.
offer_restrictions

OfferRestrictions

Mô tả cách hạn chế ưu đãi, tức là có cần gói thuê bao/phương thức thanh toán hay không, có thể kết hợp ưu đãi này với các ưu đãi khác (và loại nào) hay không, v.v. Bắt buộc.
coupon

Coupon

Thông tin chi tiết về phiếu giảm giá. Bắt buộc đối với offer_category: OFFER_CATEGORY_ADD_ON_COUPON_OFFER.
payment_instrument

PaymentInstrument

Thông tin chi tiết về một phương thức thanh toán. Bắt buộc đối với offer_category: OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER.
subscription

Subscription

Thông tin chi tiết về một gói thuê bao. Bắt buộc đối với offer_category: OFFER_CATEGORY_ADD_ON_SUBSCRIPTION_OFFER.
terms

Terms

Điều khoản và điều kiện của ưu đãi. Bắt buộc.
validity_periods[]

ValidityPeriod

Giai đoạn hiệu lực của ưu đãi. Mô tả khoảng thời gian ưu đãi có hiệu lực, bao gồm cả thời gian bắt đầu và kết thúc, các ngày trong tuần, v.v. Bắt buộc.
offer_url

string

URL đến trang ưu đãi của người bán. Bắt buộc đối với offer_category: OFFER_CATEGORY_BASE_OFFER.
image_url

string

URL đến hình ảnh sản phẩm của người bán.
tags[]

OfferTag

Thẻ đặc biệt liên kết với ưu đãi. Thông tin này được dùng để xác định các ưu đãi đặc biệt như "Lễ hội", "Được xếp hạng cao nhất", "Được đặt nhiều nhất", v.v.
brand_id

string

Xác định thương hiệu được liên kết với mặt hàng. Nếu bạn không đặt, thương hiệu mặc định sẽ được sử dụng.

OfferCategory

[START offer_category_definition] Danh mục của ưu đãi. Ưu đãi cơ bản là ưu đãi tiêu chuẩn dành cho tất cả khách hàng, chẳng hạn như giảm giá 10% khi chi tiêu trên 1.000.000 VND. Một sản phẩm cơ sở bị hạn chế bởi phiếu giảm giá hoặc phương thức thanh toán sẽ có các trường tương ứng được đặt. Chúng tôi cũng có các ưu đãi bổ sung như ADD_ON_PAYMENT_OFFER. Bạn có thể thêm các ưu đãi này vào những ưu đãi khác để được chiết khấu thêm.

Enum
OFFER_CATEGORY_UNSPECIFIED Không được sử dụng giá trị enum UNSPECIFIED hoặc giá trị enum mặc định trong nguồn cấp dữ liệu.
OFFER_CATEGORY_BASE_OFFER
OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER
OFFER_CATEGORY_ADD_ON_COUPON_OFFER
OFFER_CATEGORY_ADD_ON_SUBSCRIPTION_OFFER

OfferCondition

[START offer_condition_definition]

Trường
description

string

OfferDetails

[START offer_details_definition] Next tag: 15

Trường
offer_display_text

string

Văn bản ưu đãi mà nhà cung cấp ưu đãi muốn hiển thị cho khách hàng trên trang kết quả tìm kiếm. Bắt buộc.
max_discount_value

Money

Mức chiết khấu tối đa có thể nhận được. Ví dụ: giảm giá 10% lên đến 100 USD.
min_spend_value

Money

Mức chi tiêu tối thiểu để được hưởng chiết khấu. Ví dụ: giảm 10% khi tổng giá là 100 USD trở lên.
booking_cost

Money

Chi phí để đặt ưu đãi này. Ví dụ: Giảm 1.000.000 VND cho hoá đơn cuối cùng khi đặt bàn với giá 150.000 VND.
booking_cost_unit

FeeUnit

Đơn vị của chi phí đặt phòng. Ví dụ: mỗi người, mỗi giao dịch.
convenience_fee

Fee
booking_cost_adjustable

bool

Liệu chi phí đặt trước có thể điều chỉnh được hay không, tức là chi phí đặt trước được trừ vào hoá đơn cuối cùng. Ví dụ: Giảm 30% cho bữa tối khi đặt chỗ trước. Chi phí đặt trước là 15 USD và sẽ được áp dụng cho hoá đơn cuối cùng. Do đó, hoá đơn cuối cùng: Tổng chi tiêu – 30% – 15 USD
additional_fees[]

AdditionalFee

Các khoản phí bổ sung mà người dùng phải trả. Ví dụ: phí tiện lợi, phí xử lý, phí giao hàng, phí đóng gói, phí dịch vụ, v.v.
gift_card_info

GiftCardInfo

Thông tin chi tiết dành riêng cho ưu đãi về thẻ quà tặng.
Trường nhóm offer_specification. Mức chiết khấu có thể là tỷ lệ phần trăm hoặc giá trị cố định được trừ vào tổng giá trị. Ví dụ: 1. Giảm 10% trên hoá đơn cuối cùng. 2. Giảm 15 đô la Mỹ cho một đơn đặt hàng. Người bán cũng có thể cung cấp các khoản chiết khấu tuỳ chỉnh như "mua một tặng một" thông qua các trường quy cách có liên quan. Bắt buộc. offer_specification chỉ có thể là một trong những trạng thái sau:
discount_percent

float

Tỷ lệ phần trăm hoá đơn được chiết khấu. [0, 100] Đối với ưu đãi mua 1 tặng 1 hoặc giảm giá 50% áp dụng cho toàn bộ bữa ăn (ví dụ: mua 1 tặng 1 cho bữa ăn tự chọn, mua 1 tặng 1 cho toàn bộ hoá đơn, mua 1 tặng 1 cho thực đơn cố định), bạn có thể đặt giá trị này thành 50.
discount_value

Money

Giá trị cố định của khoản chiết khấu.
other_offer_detail_text

string

Văn bản tuỳ ý để mô tả mức chiết khấu. Đối với các ưu đãi mua 1 tặng 1 cụ thể (ví dụ: mua 1 tặng 1 đồ uống, mua 1 tặng 1 món chính, mua 1 tặng 1 món trong thực đơn được chọn), bạn nên mô tả những thông tin này tại đây.

OfferMode

[START offer_mode_definition] Chỉ định phương thức hoặc kênh mà người dùng có thể sử dụng ưu đãi.

Enum
OFFER_MODE_OTHER Sử dụng cho các phương thức thực hiện đơn hàng không thuộc các chế độ cụ thể khác.
OFFER_MODE_WALK_IN Ưu đãi này áp dụng cho khách đến trực tiếp mà không cần đặt trước.
OFFER_MODE_FREE_RESERVATION Ưu đãi này áp dụng khi người dùng đặt chỗ mà không cần trả phí trước.
OFFER_MODE_PAID_RESERVATION Ưu đãi này áp dụng khi người dùng đặt chỗ và phải thanh toán trước.
OFFER_MODE_ONLINE_ORDER Ưu đãi này áp dụng cho các đơn đặt hàng thông qua trang web hoặc nền tảng kỹ thuật số.
OFFER_MODE_GIFT_CARD_PURCHASE Cho biết giao dịch mua thẻ quà tặng là bước chính cần thiết để nhận được ưu đãi.

OfferRestrictions

[START offer_restrictions_definition] Next tag: 11

Trường
combinable_with_other_offers

bool

Liệu ưu đãi này có thể kết hợp với các ưu đãi khác hay không. Khi giá trị là true, đối tác có thể chỉ định những ưu đãi có thể kết hợp với ưu đãi này. Nếu bạn đặt cả combinable_offer_categories và combinable_offer_ids, thì mọi ưu đãi đáp ứng một trong các điều kiện trên đều có thể kết hợp.
combinable_offer_categories[]

OfferCategory

Danh sách các loại mặt hàng mà bạn có thể kết hợp với mặt hàng này. Ví dụ: bạn có thể kết hợp ưu đãi này với các Phiếu giảm giá khác. Nếu combinable_with_other_offers là true và bạn chưa đặt trường này, thì tất cả các loại sẽ có thể kết hợp.
combinable_offer_ids[]

string

Danh sách offer_id mà bạn có thể kết hợp với ưu đãi này. Một số ưu đãi chỉ có thể kết hợp với một số offer_id cụ thể khác (có thể được coi là ưu đãi gốc). Nếu combinable_with_other_offers là true và bạn chưa đặt trường này, thì tất cả mã ưu đãi đều có thể kết hợp.
inclusions[]

OfferCondition

Danh sách các điều kiện phải đáp ứng để ưu đãi có hiệu lực (ví dụ: đồ uống không cồn, thực phẩm).
exclusions[]

OfferCondition

Danh sách các điều kiện khiến ưu đãi không hợp lệ (ví dụ: tiệc tự chọn, ưu đãi kết hợp và cocktail).
min_guest

int32

Số người tối thiểu cần có để sử dụng ưu đãi.
food_offer_restrictions

FoodOfferRestrictions

Các quy định hạn chế dành riêng cho mặt hàng thực phẩm.
special_conditions[]

string

Điều kiện đặc biệt cho ưu đãi này mà bạn phải cho người dùng thấy. Ví dụ: "Chỉ có hiệu lực khi thanh toán ở [khu vực]", "Không áp dụng cho các khoản thanh toán trực tuyến"

OfferSource

[START offer_source_definition]

Enum
OFFER_SOURCE_UNSPECIFIED
OFFER_SOURCE_AGGREGATOR

OfferTag

[START offer_tag_definition]

Enum
OFFER_TAG_UNSPECIFIED Không được sử dụng giá trị enum UNSPECIFIED hoặc giá trị enum mặc định trong nguồn cấp dữ liệu.
OFFER_TAG_NEW_YEAR_SPECIAL
OFFER_TAG_VALENTINES_SPECIAL

PaymentInstrument

[START payment_instrument_definition]

Trường
items[]

PaymentInstrumentItem

Danh sách các phương thức thanh toán có thể dùng để nhận ưu đãi. Bắt buộc.
provider_name

string

Tên của nhà cung cấp phương thức thanh toán. Có thể là đối tác ngân hàng, tên ngân hàng, v.v. Ví dụ: American Express, HDFC, ICICI.

PaymentInstrumentItem

[START payment_instrument_item_definition]

Trường
type

PaymentInstrumentType

Loại phương thức thanh toán. Bắt buộc.
name

string

Tên của mục phương thức thanh toán, chẳng hạn như tên của thẻ tín dụng. Ví dụ: HDFC Infinia, American Express Platinum. Bắt buộc.

PaymentInstrumentType

[START payment_instrument_type_definition]

Enum
PAYMENT_INSTRUMENT_TYPE_UNSPECIFIED Bạn không nên sử dụng giá trị enum UNSPECIFIED hoặc giá trị mặc định trong nguồn cấp dữ liệu.
PAYMENT_INSTRUMENT_CREDIT_CARD
PAYMENT_INSTRUMENT_DEBIT_CARD
PAYMENT_INSTRUMENT_BANK_ACCOUNT
PAYMENT_INSTRUMENT_UPI
PAYMENT_INSTRUMENT_ONLINE_WALLET
PAYMENT_INSTRUMENT_NETBANKING

Gói đăng ký

[START subscription_definition]

Trường
name

string

Tên của gói thuê bao. Bắt buộc.
subscription_auto_added

bool

Gói thuê bao có được tự động thêm khi người dùng sử dụng ưu đãi này hay không
cost

Money

Phí thuê bao. Bắt buộc.
subscription_duration

Duration

Thời hạn của gói thuê bao theo mức phí thuê bao (subscription_cost). Bắt buộc.
terms_and_conditions_url

string

URL đến điều khoản và điều kiện của đối tác liên quan đến gói thuê bao này.

Điều khoản

[START terms_definition]

Trường
url

string

URL dẫn đến điều khoản và điều kiện của đối tác.
restricted_to_certain_users

bool

Liệu ưu đãi có bị giới hạn cho một số người dùng nhất định hay không.
terms_and_conditions

string

Văn bản điều khoản và điều kiện chính do đối tác cung cấp.
additional_terms_and_conditions[]

string

Điều khoản và điều kiện bổ sung cho điều khoản và điều kiện chính của đối tác.