Đơn đặt hàng là xác nhận của một giao dịch (biên lai), có thể chứa nhiều mặt hàng, mỗi mặt hàng được biểu thị bằng một Offer đã được khách hàng chấp nhận.
Trường hợp sử dụng
Đơn đặt hàng cơ bản
Ví dụ tối thiểu về một đơn đặt hàng:
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "Order",
"merchant": {
"@type": "Organization",
"name": "Amazon.com"
},
"orderNumber": "123-4567890-1234567",
"priceCurrency": "USD",
"price": "29.99",
"acceptedOffer": {
"@type": "Offer",
"itemOffered": {
"@type": "Product",
"name": "Google Chromecast"
},
"price": "29.99",
"priceCurrency": "USD",
"eligibleQuantity": {
"@type": "QuantitativeValue",
"value": "1"
}
}
}
</script>
Vi dữ liệu
<div itemscope itemtype="http://schema.org/Order">
<div itemprop="merchant" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="Amazon.com"/>
</div>
<meta itemprop="orderNumber" content="123-4567890-1234567"/>
<meta itemprop="priceCurrency" content="USD"/>
<meta itemprop="price" content="29.99"/>
<div itemprop="acceptedOffer" itemscope itemtype="http://schema.org/Offer">
<div itemprop="itemOffered" itemscope itemtype="http://schema.org/Product">
<meta itemprop="name" content="Google Chromecast"/>
</div>
<meta itemprop="price" content="29.99"/>
<meta itemprop="priceCurrency" content="USD"/>
<div itemprop="eligibleQuantity" itemscope itemtype="http://schema.org/QuantitativeValue">
<meta itemprop="value" content="1"/>
</div>
</div>
</div>
Xem hành động đặt hàng
Bạn có thể thêm nút Xem đơn hàng vào đơn hàng của mình bằng cách thiết lập thuộc tính url. Để liên kết trực tiếp đến ứng dụng di động, hãy thêm cả ViewAction:
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "Order",
"merchant": {
"@type": "Organization",
"name": "Amazon.com"
},
"orderNumber": "123-4567890-1234567",
"orderStatus": "http://schema.org/OrderProcessing",
"priceCurrency": "USD",
"price": "29.99",
"priceSpecification": {
"@type": "PriceSpecification",
"validFrom": "2027-12-07T23:30:00-08:00"
},
"acceptedOffer": {
"@type": "Offer",
"itemOffered": {
"@type": "Product",
"name": "Google Chromecast",
"sku": "B00DR0PDNE",
"url": "http://www.amazon.com/Google-Chromecast-Streaming-Media-Player/dp/B00DR0PDNE/",
"image": "http://ecx.images-amazon.com/images/I/811nvG%2BLgML._SY550_.jpg"
},
"price": "29.99",
"priceCurrency": "USD",
"eligibleQuantity": {
"@type": "QuantitativeValue",
"value": "1"
}
},
"url": "https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567",
"potentialAction": {
"@type": "ViewAction",
"url": "https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567"
}
}
</script>
Vi dữ liệu
<div itemscope itemtype="http://schema.org/Order">
<div itemprop="merchant" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="Amazon.com"/>
</div>
<link itemprop="orderStatus" href="http://schema.org/OrderProcessing"/>
<meta itemprop="orderNumber" content="123-4567890-1234567"/>
<meta itemprop="priceCurrency" content="USD"/>
<meta itemprop="price" content="29.99"/>
<div itemprop="acceptedOffer" itemscope itemtype="http://schema.org/Offer">
<div itemprop="itemOffered" itemscope itemtype="http://schema.org/Product">
<meta itemprop="name" content="Google Chromecast"/>
<link itemprop="url" href="http://www.amazon.com/Google-Chromecast-Streaming-Media-Player/dp/B00DR0PDNE/"/>
<link itemprop="image" href="http://ecx.images-amazon.com/images/I/811nvG%2BLgML._SY550_.jpg"/>
<meta itemprop="sku" content="B00DR0PDNE"/>
</div>
<meta itemprop="price" content="29.99"/>
<meta itemprop="priceCurrency" content="USD"/>
<div itemprop="eligibleQuantity" itemscope itemtype="http://schema.org/QuantitativeValue">
<meta itemprop="value" content="1"/>
</div>
</div>
<link itemprop="url" href="https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567"/>
<div itemprop="potentialAction" itemscope itemtype="http://schema.org/ViewAction">
<link itemprop="url" href="https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567"/>
</div>
<div itemprop="priceSpecification" itemscope itemtype="http://schema.org/PriceSpecification">
<meta itemprop="validFrom" content="2027-12-07T23:30:00-08:00"/>
</div>
</div>
Đơn hàng kèm thông tin thanh toán
Ví dụ về đơn đặt hàng kèm thông tin thanh toán chi tiết:
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "Order",
"merchant": {
"@type": "Organization",
"name": "Amazon.com"
},
"orderNumber": "123-4567890-1234567",
"priceCurrency": "USD",
"price": "539.00",
"priceSpecification": {
"@type": "PriceSpecification",
"validFrom": "2027-12-07T23:30:00-08:00"
},
"acceptedOffer": [
{
"@type": "Offer",
"itemOffered": {
"@type": "Product",
"name": "Samsung Chromebook",
"sku": "B009LL9VDG",
"url": "http://www.amazon.com/Samsung-XE303C12-A01US-Chromebook-Wi-Fi-11-6-Inch/dp/B009LL9VDG/",
"image": "http://ecx.images-amazon.com/images/I/81H-DO3qX0L._SX522_.jpg"
},
"price": "249.99",
"priceCurrency": "USD",
"eligibleQuantity": {
"@type": "QuantitativeValue",
"value": "2"
},
"seller": {
"@type": "Organization",
"name": "Samsung Marketplace Store"
}
},
{
"@type": "Offer",
"itemOffered": {
"@type": "Product",
"name": "Google Chromecast",
"sku": "B00DR0PDNE",
"url": "http://www.amazon.com/Google-Chromecast-Streaming-Media-Player/dp/B00DR0PDNE/",
"image": "http://ecx.images-amazon.com/images/I/811nvG%2BLgML._SY550_.jpg"
},
"price": "29.99",
"priceCurrency": "USD",
"eligibleQuantity": {
"@type": "QuantitativeValue",
"value": "1"
},
"seller": {
"@type": "Organization",
"name": "Google Store @ Amazon"
}
}
],
"url": "https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567",
"potentialAction": {
"@type": "ViewAction",
"url": "https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567"
},
"orderStatus": "http://schema.org/OrderProcessing",
"paymentMethod": {
"@type": "PaymentMethod",
"name": "http://schema.org/CreditCard"
},
"paymentMethodId": "**** **** **** 1234",
"orderDate": "2027-11-07T23:30:00-08:00",
"isGift": "false",
"discount": "0.97",
"discountCurrency": "USD",
"customer": {
"@type": "Person",
"name": "John Smith"
},
"billingAddress": {
"@type": "PostalAddress",
"name": "Google",
"streetAddress": "1600 Amphitheatre Pkwy",
"addressLocality": "Mountain View",
"addressRegion": "CA",
"addressCountry": "USA"
}
}
</script>
Vi dữ liệu
<div itemscope itemtype="http://schema.org/Order">
<div itemprop="merchant" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="Amazon.com"/>
</div>
<meta itemprop="orderNumber" content="123-4567890-1234567"/>
<meta itemprop="priceCurrency" content="USD"/>
<meta itemprop="price" content="539.00"/>
<div itemprop="acceptedOffer" itemscope itemtype="http://schema.org/Offer">
<div itemprop="itemOffered" itemscope itemtype="http://schema.org/Product">
<meta itemprop="name" content="Samsung Chromebook"/>
<meta itemprop="sku" content="B009LL9VDG"/>
<link itemprop="url" href="http://www.amazon.com/Samsung-XE303C12-A01US-Chromebook-Wi-Fi-11-6-Inch/dp/B009LL9VDG/"/>
<link itemprop="image" href="http://ecx.images-amazon.com/images/I/81H-DO3qX0L._SX522_.jpg"/>
</div>
<meta itemprop="price" content="249.99"/>
<meta itemprop="priceCurrency" content="USD"/>
<div itemprop="eligibleQuantity" itemscope itemtype="http://schema.org/QuantitativeValue">
<meta itemprop="value" content="2"/>
</div>
<div itemprop="seller" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="Samsung Marketplace Store"/>
</div>
</div>
<div itemprop="acceptedOffer" itemscope itemtype="http://schema.org/Offer">
<div itemprop="itemOffered" itemscope itemtype="http://schema.org/Product">
<meta itemprop="name" content="Google Chromecast"/>
<meta itemprop="sku" content="B00DR0PDNE"/>
<link itemprop="url" href="http://www.amazon.com/Google-Chromecast-Streaming-Media-Player/dp/B00DR0PDNE/"/>
<link itemprop="image" href="http://ecx.images-amazon.com/images/I/811nvG%2BLgML._SY550_.jpg"/>
</div>
<meta itemprop="price" content="29.99"/>
<meta itemprop="priceCurrency" content="USD"/>
<div itemprop="eligibleQuantity" itemscope itemtype="http://schema.org/QuantitativeValue">
<meta itemprop="value" content="1"/>
</div>
<div itemprop="seller" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="Google Store @ Amazon"/>
</div>
</div>
<link itemprop="url" href="https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567"/>
<div itemprop="potentialAction" itemscope itemtype="http://schema.org/ViewAction">
<link itemprop="url" href="https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567"/>
</div>
<link itemprop="orderStatus" href="http://schema.org/OrderProcessing"/>
<div itemprop="paymentMethod" itemscope itemtype="http://schema.org/PaymentMethod">
<meta itemprop="name" content="http://schema.org/CreditCard"/>
</div>
<meta itemprop="paymentMethodId" content="**** **** **** 1234"/>
<meta itemprop="orderDate" content="2027-11-07T23:30:00-08:00"/>
<meta itemprop="isGift" content="false"/>
<meta itemprop="discount" content="0.97"/>
<meta itemprop="discountCurrency" content="USD"/>
<div itemprop="customer" itemscope itemtype="http://schema.org/Person">
<meta itemprop="name" content="John Smith"/>
</div>
<div itemprop="billingAddress" itemscope itemtype="http://schema.org/PostalAddress">
<meta itemprop="name" content="Google"/>
<meta itemprop="streetAddress" content="1600 Amphitheatre Pkwy"/>
<meta itemprop="addressLocality" content="Mountain View"/>
<meta itemprop="addressRegion" content="CA"/>
<meta itemprop="addressCountry" content="USA"/>
</div>
<div itemprop="priceSpecification" itemscope itemtype="http://schema.org/PriceSpecification">
<meta itemprop="validFrom" content="2027-12-07T23:30:00-08:00"/>
</div>
</div>
Kiểm tra mục đánh dấu của bạn
Bạn có thể xác thực mã đánh dấu bằng Trình kiểm tra đánh dấu email. Dán mã đánh dấu vào và nhấp vào nút Xác thực để quét nội dung và nhận báo cáo về mọi lỗi hiện có.
Thông số kỹ thuật
Bảng sau liệt kê tất cả các thuộc tính có sẵn cho loại này:
| Thuộc tính | Loại | Mô tả |
|---|---|---|
| người bán | Organization (Tổ chức) hoặc Person (Người) | (bắt buộc) Bên nhận đơn đặt hàng (ví dụ: Amazon.com là nhà cung cấp cho nhiều người bán). Cũng chấp nhận một chuỗi ký tự (ví dụ: "Amazon.com"). |
| thương nhân.tên | Văn bản | (bắt buộc) Tên tổ chức. |
| thương nhân.giống như | URL | URL Freebase của người bán. |
| orderNumber | Văn bản | (bắt buộc) Mã định danh dành riêng cho người bán trong giao dịch. |
| priceCurrency | Văn bản | (bắt buộc) Loại tiền tệ (ở định dạng ISO 4217 gồm 3 chữ cái) của giá đơn hàng. |
| price | Số hoặc tin nhắn | (bắt buộc) Tổng giá trị của toàn bộ giao dịch. |
| acceptedOffer | Ưu đãi | (bắt buộc) Các ưu đãi được bao gồm trong đơn đặt hàng. Cũng chấp nhận một mảng đối tượng. |
| acceptedOffer.itemOffered | Sản phẩm hoặc Đặt chỗ | (bắt buộc) Mặt hàng đang được bán. |
| acceptedOffer.itemOffered.name | Văn bản | (bắt buộc) Tên sản phẩm. |
| acceptedOffer.itemOffered.sku | Văn bản | (được đề xuất cho thẻ xác nhận/Câu trả lời tìm kiếm) Mã số hàng tồn kho (SKU), tức là mã định danh dành riêng cho người bán đối với một sản phẩm hoặc dịch vụ, hoặc sản phẩm mà ưu đãi đề cập đến. |
| acceptedOffer.itemOffered.url | URL | (được khuyến nghị cho thẻ xác nhận/Câu trả lời tìm kiếm) URL của Sản phẩm, thường là trang đích của sản phẩm trên trang web của người bán. |
| acceptedOffer.itemOffered.image | URL | (được khuyến nghị cho thẻ xác nhận/Câu trả lời tìm kiếm) URL của hình ảnh Sản phẩm, thường là hình ảnh trên trang web của người bán. |
| acceptedOffer.itemOffered.color | Văn bản | Màu sắc của sản phẩm. |
| Đề nghị đã được chấp nhận.giá | Số hoặc tin nhắn | (bắt buộc) Đơn giá của Sản phẩm. |
| Đề nghị đã chấp nhận.Giá tiền tệ | Văn bản | (bắt buộc) Đơn vị tiền tệ (ở định dạng ISO 4217 gồm 3 chữ cái) của giá. |
| Đề nghị đã được chấp nhận.Số lượng đủ điều kiện | QuantitativeValue | (bắt buộc) Khoảng và đơn vị đo lường của số lượng đặt hàng mà giá chào bán hoặc giá niêm yết có hiệu lực. |
| acceptedOffer.eligibleQuantity.value | Số | (bắt buộc) Giá trị của đặc tính sản phẩm. |
| Đề nghị đã được chấp nhận.Thông số giá | PriceSpecification | Một hoặc nhiều bảng giá chi tiết, ghi rõ đơn giá và phí giao hàng hoặc thanh toán. |
| acceptedOffer.priceSpecification.price | Số hoặc tin nhắn | Tổng giá trị của toàn bộ giao dịch. |
| acceptedOffer.priceSpecification.priceCurrency | Văn bản | Đơn vị tiền tệ (theo định dạng ISO 4217 gồm 3 chữ cái) của giá đơn hàng. |
| acceptedOffer.itemCondition | OfferItemCondition | Nội dung mô tả bằng văn bản về tình trạng của sản phẩm hoặc dịch vụ, hoặc các sản phẩm hoặc dịch vụ có trong mặt hàng. |
| acceptedOffer.seller | Organization (Tổ chức) hoặc Person (Người) | Bên mà đơn đặt hàng được đặt. Cũng chấp nhận một chuỗi (ví dụ: ""). |
| acceptedOffer.seller.name | Văn bản | Tên tổ chức. |
| priceSpecification | PriceSpecification | (nên dùng cho thẻ xác nhận/Câu trả lời trên Tìm kiếm) Mọi lựa chọn thay thế chi tiết hơn cho price/priceCurrency. Cũng được dùng để chỉ định thuế và phí giao hàng. Cũng chấp nhận một mảng đối tượng. |
| url | URL | (nên dùng cho thẻ xác nhận/Câu trả lời trên Tìm kiếm) URL của Đơn đặt hàng, thường là đường liên kết đến trang web của người bán nơi người dùng có thể truy xuất thêm thông tin chi tiết về đơn đặt hàng. |
| orderStatus | OrderStatus | (nên dùng cho thẻ xác nhận/Câu trả lời trên Tìm kiếm) Trạng thái hiện tại của đơn đặt hàng. |
| paymentMethod | PaymentMethod | Tên của thẻ tín dụng hoặc phương thức thanh toán khác cho đơn đặt hàng. |
| paymentMethodId | Văn bản | Giá trị nhận dạng cho phương thức thanh toán được sử dụng (ví dụ: 4 chữ số cuối của thẻ tín dụng). |
| orderDate | DateTime | Ngày đặt hàng. |
| isGift | Boolean | Liệu lời đề nghị đó có được chấp nhận như một món quà dành cho người khác ngoài người mua hay không? |
| discount | Số hoặc tin nhắn | Đã áp dụng mọi mức giảm giá. |
| discountCurrency | Văn bản | Đơn vị tiền tệ (theo định dạng ISO 4217 gồm 3 chữ cái) của khoản giảm giá. |
| khách hàng | Person (Người) hoặc Organization (Tổ chức) | Bên đặt hàng. |
| khách hàng.tên | Văn bản | Tên của người liên quan. |
| billingAddress | PostalAddress | Địa chỉ thanh toán cho đơn hàng. |
| Địa chỉ thanh toán.tên | Văn bản | Tên của PostalAddress. |
| Địa chỉ thanh toán.Địa chỉ đường phố | Văn bản | Địa chỉ đường phố. Ví dụ: 1600 Amphitheatre Pkwy. |
| Địa chỉ thanh toán.Địa chỉ | Văn bản | Thành phố. Ví dụ: Mountain View. |
| billingAddress.addressRegion | Văn bản | Khu vực. Ví dụ: CA. |
| billingAddress.addressCountry | Văn bản hoặc Quốc gia | Quốc gia. Ví dụ: Hoa Kỳ. Bạn cũng có thể cung cấp mã quốc gia gồm 2 chữ cái theo tiêu chuẩn ISO 3166-1 alpha-2. |