Zamówienie

Zamówienie to potwierdzenie transakcji (paragon), które może zawierać wiele pozycji, z których każda jest reprezentowana przez Offer 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 Wyświetl zamówienie , 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ład zamówienia 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 . 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
sprzedawca	Organizacja lub Osoba	(wymagane) Strona przyjmująca zamówienie (np. Amazon.com jest sprzedawcą dla wielu sprzedawców). Akceptuje też ciąg znaków (np. „Amazon.com”).
sprzedawca.name	Tekst	(wymagane) Nazwa organizacji.
sprzedawca.sameAs	URL	URL sprzedawcy w Freebase.
orderNumber	Tekst	(wymagane) Identyfikator transakcji właściwy dla konkretnego sprzedawcy.
priceCurrency	Tekst	(wymagane) Waluta (w trzyliterowym formacie ISO 4217), w której podano cenę zamówienia.
cena	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 konkretnego 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/waluty. Służy też do określania podatku 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 znaleźć więcej informacji o zamówieniu.
orderStatus	OrderStatus	(zalecane w przypadku kart potwierdzenia/odpowiedzi w wyszukiwarce) Aktualny 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ę.
Klient	Person lub Organization	Strona składająca zamówienie.
Klient.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 alpha-2.