Đặt hàng

Đơn đặt hàng là thông báo xác nhận giao dịch (biên nhận), có thể chứa nhiều mục hàng, mỗi mục hàng được thể hiện bằng một Ưu đãi đã được khách hàng chấp nhận.

Trường hợp sử dụng

Thứ tự cơ bản

Ví dụ tối giản cho đơ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 đối với đơn đặt hàng

Bạn có thể thêm nút View Order vào đơn đặt hàng bằng cách đặt thuộc tính url. Để liên kết trực tiếp đến một ứng dụng dành cho thiết bị 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 đặt hàng có thông tin thanh toán

Đơn đặt hàng mẫu có 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 Công cụ kiểm tra đánh dấu qua email. Dán mã đánh dấu 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 có.

Thông số kỹ thuật

Bảng sau đây 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ả
nhà bán hàng 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à một người bán đối với nhiều người bán). Cũng chấp nhận một chuỗi (ví dụ: "Amazon.com").
merchant.name Văn bản (bắt buộc) Tên tổ chức.
merchant.sameAs URL URL Freebase cho người bán.
orderNumber Văn bản (bắt buộc) Mã nhận dạng của người bán cụ thể của giao dịch.
priceCurrency 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á đơn đặt hàng.
price Số hoặc văn bản (bắt buộc) Tổng giá của toàn bộ giao dịch.
acceptedOffer Ưu đãi (bắt buộc) Các ưu đãi có 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 trước (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 (nên dùng cho thẻ xác nhận/Câu trả lời tìm kiếm) Đơn vị lưu kho (SKU), tức là mã nhận dạng của riêng người bán của một sản phẩm hoặc dịch vụ, hoặc của sản phẩm mà mặt hàng đề cập đến.
acceptedOffer.itemOffered.url URL (nên dùng 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 (nên dùng cho thẻ xác nhận/Câu trả lời tìm kiếm) URL hình ảnh của 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.
acceptedOffer.price Số hoặc văn bản (bắt buộc) Đơn giá của Sản phẩm.
acceptedOffer.priceCurrency 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á.
acceptedOffer.eligibleQuantity QuantitativeValue (bắt buộc) Khoảng thời gian và đơn vị đo lường số lượng đặt hàng mà mặt hàng hoặc quy cách giá là hợp lệ.
acceptedOffer.eligibleQuantity.value Số (bắt buộc) Giá trị của đặc điểm sản phẩm.
acceptedOffer.priceSpecification PriceSpecification Một hoặc nhiều quy cách giá chi tiết, cho biết đơn giá và phí giao hàng hoặc thanh toán.
acceptedOffer.priceSpecification.price Số hoặc văn bản Tổng giá của toàn bộ giao dịch.
acceptedOffer.priceSpecification.priceCurrency Văn bản Đơn vị tiền tệ (ở định dạng ISO 4217 gồm 3 chữ cái) của giá đơn đặt 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/dịch vụ, sản phẩm/dịch vụ có trong ưu đãi.
acceptedOffer.seller Organization (Tổ chức) hoặc Person (Người) Bên đã đặt đơn hàng. 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 của kết quả tìm kiếm) Mọi lựa chọn thay thế chi tiết hơn cho giá/priceCurrency. Thuộc tính này cũng được dùng để xác đị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 của Google Tìm kiếm) URL của Đơn đặt hàng, thường là một đường liên kết đến trang web của người bán nơi người dùng có thể lấy thêm thông tin về đơn đặt hàng.
orderStatus OrderStatus (nên dùng cho thẻ xác nhận/Câu trả lời của Google 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 Ưu đãi có được chấp nhận làm quà tặng cho một người nào đó không phải là người mua không.
discount Số hoặc văn bản Mọi khoản chiết khấu được áp dụng.
discountCurrency Văn bản Đơn vị tiền tệ (ở định dạng ISO 4217 gồm 3 chữ cái) của khoản chiết khấu.
khách hàng Person (Người) hoặc Organization (Tổ chức) Bên đặt hàng.
customer.name Văn bản Tên của người đó.
billingAddress PostalAddress Địa chỉ thanh toán cho đơn đặt hàng.
billingAddress.name Văn bản Tên của PostalAddress.
billingAddress.streetAddress Văn bản Địa chỉ đường phố. Ví dụ: 1600 Amphitheatre Pkwy.
billingAddress.addressLocality 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 hai chữ cái theo ISO 3166-1 alpha-2.