Zamówienie

Zamówienie to potwierdzenie transakcji (paragon), które może zawierać wiele pozycji, z których każda jest reprezentowana przez ofertę zaakceptowaną przez klienta.

Przypadki użycia

Podstawowe zamówienie

Minimalny przykład zamówienia

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>

Mikrodane

<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>

Działanie Wyświetl zamówienie

Do zamówień możesz dodać przycisk View Order, ustawiając właściwość url. Aby utworzyć bezpośrednie linki do aplikacji mobilnej, dodaj też 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>

Mikrodane

<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>

Zamówienie z danymi do płatności

Przykładowe zamówienie ze szczegółowymi informacjami rozliczeniowymi

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>

Mikrodane

<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>

Sprawdź znaczniki

Znaczniki możesz sprawdzać za pomocą narzędzia Tester znaczników w e-mailu Email Markup Tester Tool. Wklej kod znaczników i kliknij przycisk Sprawdź , aby przeskanować treść i otrzymać raport o ewentualnych błędach.

Specyfikacja

W tabeli poniżej znajdziesz listę wszystkich dostępnych właściwości tego typu:

Właściwość Typ Opis
merchant Organizacja lub Osoba (wymagane) Strona przyjmująca zamówienie (np. Amazon.com jest sprzedawcą dla wielu sprzedających). Akceptuje też ciąg znaków (np. „Amazon.com”).
merchant.name Tekst (wymagane) Nazwa organizacji.
merchant.sameAs URL URL sprzedawcy w Freebase.
orderNumber Tekst (wymagane) Identyfikator transakcji właściwy dla sprzedawcy.
priceCurrency Tekst (wymagane) Waluta (w trzyliterowym formacie ISO 4217), w której podano cenę zamówienia.
price Liczba lub tekst (wymagane) Łączna cena całej transakcji.
acceptedOffer Oferta (wymagane) Oferty zawarte w zamówieniu. Akceptuje też tablicę obiektów.
acceptedOffer.itemOffered Produkt lub rezerwacja (wymagane) Sprzedawany przedmiot.
acceptedOffer.itemOffered.name Tekst (wymagane) Nazwa produktu.
acceptedOffer.itemOffered.sku Tekst (zalecane w przypadku kart potwierdzenia/odpowiedzi w wyszukiwarce) Jednostka magazynowa (SKU), czyli identyfikator produktu lub usługi właściwy dla sprzedawcy, albo produkt, którego dotyczy oferta.
acceptedOffer.itemOffered.url URL (zalecane w przypadku kart potwierdzenia/odpowiedzi w wyszukiwarce) URL produktu, zwykle strona docelowa produktu w witrynie sprzedawcy.
acceptedOffer.itemOffered.image URL (zalecane w przypadku kart potwierdzenia/odpowiedzi w wyszukiwarce) URL obrazu produktu, zwykle obrazu w witrynie sprzedawcy.
acceptedOffer.itemOffered.color Tekst Kolor produktu.
acceptedOffer.price Liczba lub tekst (wymagane) Cena jednostkowa produktu.
acceptedOffer.priceCurrency Tekst (wymagane) Waluta (w trzyliterowym formacie ISO 4217), w której podano cenę.
acceptedOffer.eligibleQuantity QuantitativeValue (wymagane) Przedział i jednostka miary ilości zamówienia, dla których obowiązuje oferta lub specyfikacja ceny.
acceptedOffer.eligibleQuantity.value Liczba (wymagane) Wartość cechy produktu.
acceptedOffer.priceSpecification PriceSpecification Co najmniej 1 szczegółowa specyfikacja ceny, która wskazuje cenę jednostkową oraz opłaty za dostawę lub płatność.
acceptedOffer.priceSpecification.price Liczba lub tekst Łączna cena całej transakcji.
acceptedOffer.priceSpecification.priceCurrency Tekst Waluta (w trzyliterowym formacie ISO 4217), w której podano cenę zamówienia.
acceptedOffer.itemCondition OfferItemCondition Tekstowy opis stanu produktu lub usługi albo produktów lub usług objętych ofertą.
acceptedOffer.seller Organizacja lub Osoba Strona, u której złożono zamówienie. Akceptuje też ciąg znaków (np. „”).
acceptedOffer.seller.name Tekst Nazwa organizacji.
priceSpecification PriceSpecification (zalecane w przypadku kart potwierdzenia / odpowiedzi w wyszukiwarce) Bardziej szczegółowe alternatywy dla ceny lub waluty. Służy też do określania podatków i opłat za dostawę. Akceptuje też tablicę obiektów.
url URL (zalecane w przypadku kart potwierdzenia/odpowiedzi w wyszukiwarce) URL zamówienia, zwykle link do witryny sprzedawcy, w której użytkownik może uzyskać więcej informacji o zamówieniu.
orderStatus OrderStatus (zalecane w przypadku kart potwierdzenia/odpowiedzi w wyszukiwarce) Bieżący stan zamówienia.
paymentMethod PaymentMethod Nazwa karty kredytowej lub innej formy płatności za zamówienie.
paymentMethodId Tekst Identyfikator użytej formy płatności (np. 4 ostatnie cyfry karty kredytowej).
orderDate DateTime Data złożenia zamówienia.
isGift Wartość logiczna Czy oferta została zaakceptowana jako prezent dla kogoś innego niż kupujący.
discount Liczba lub tekst Zastosowana zniżka.
discountCurrency Tekst Waluta (w trzyliterowym formacie ISO 4217), w której podano zniżkę.
customer Person lub Organization Strona składająca zamówienie.
customer.name Tekst Imię i nazwisko osoby.
billingAddress PostalAddress Adres rozliczeniowy zamówienia.
billingAddress.name Tekst Nazwa adresu pocztowego.
billingAddress.streetAddress Tekst Ulica i numer. Na przykład 1600 Amphitheatre Pkwy.
billingAddress.addressLocality Tekst Miejscowość. Na przykład Mountain View.
billingAddress.addressRegion Tekst Region. Na przykład CA.
billingAddress.addressCountry Tekst lub kraj Kraj. Na przykład USA. Możesz też podać dwuliterowy kod kraju w formacie ISO 3166-1 alfa-2.