Sử dụng mẫu này để mô tả trạng thái giao hàng.
Trường hợp sử dụng
Dịch vụ giao bưu kiện cơ bản
Ví dụ tối giản về dịch vụ giao hàng
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "ParcelDelivery",
"deliveryAddress": {
"@type": "PostalAddress",
"name": "Pickup Corner",
"streetAddress": "24 Willie Mays Plaza",
"addressLocality": "San Francisco",
"addressRegion": "CA",
"addressCountry": "US",
"postalCode": "94107"
},
"expectedArrivalUntil": "2027-03-12T12:00:00-08:00",
"carrier": {
"@type": "Organization",
"name": "FedEx"
},
"itemShipped": {
"@type": "Product",
"name": "Google Chromecast"
},
"partOfOrder": {
"@type": "Order",
"orderNumber": "176057",
"merchant": {
"@type": "Organization",
"name": "Bob Dole"
}
}
}
</script>
Vi dữ liệu
<div itemscope itemtype="http://schema.org/ParcelDelivery">
<div itemprop="deliveryAddress" itemscope itemtype="http://schema.org/PostalAddress">
<meta itemprop="name" content="Pickup Corner"/>
<meta itemprop="streetAddress" content="24 Willie Mays Plaza"/>
<meta itemprop="addressLocality" content="San Francisco"/>
<meta itemprop="addressRegion" content="CA"/>
<meta itemprop="addressCountry" content="US"/>
<meta itemprop="postalCode" content="94107"/>
</div>
<meta itemprop="expectedArrivalUntil" content="2027-03-12T12:00:00-08:00"/>
<div itemprop="carrier" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="FedEx"/>
</div>
<div itemprop="itemShipped" itemscope itemtype="http://schema.org/Product">
<meta itemprop="name" content="Google Chromecast"/>
</div>
<div itemprop="partOfOrder" itemscope itemtype="http://schema.org/Order">
<meta itemprop="orderNumber" content="176057"/>
<div itemprop="merchant" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="Bob Dole"/>
</div>
</div>
</div>
Chuyển phát bưu kiện kèm thông tin vận chuyển
Ví dụ về việc giao gói hàng có thông tin vận chuyển chi tiết
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "ParcelDelivery",
"deliveryAddress": {
"@type": "PostalAddress",
"name": "John Frank",
"streetAddress": "24 Willie Mays Plaza",
"addressLocality": "San Francisco",
"addressRegion": "CA",
"addressCountry": "US",
"postalCode": "94107"
},
"originAddress": {
"@type": "PostalAddress",
"name": "John Frank",
"streetAddress": "25 Willie Mays Plaza",
"addressLocality": "San Francisco",
"addressRegion": "CA",
"addressCountry": "US",
"postalCode": "94107"
},
"expectedArrivalFrom": "2027-03-10T12:00:00-08:00",
"expectedArrivalUntil": "2027-03-12T12:00:00-08:00",
"carrier": {
"@type": "Organization",
"name": "FedEx",
"url": "http://fedex.com/"
},
"itemShipped": {
"@type": "Product",
"name": "iPod Mini",
"url": "http://apple.com/ipad32gb",
"image": "http://apple.com/images/ipad32gb.jpg",
"sku": "B00DR0PDNE",
"description": "iPod Mini 32Gb White",
"brand": {
"@type": "Brand",
"name": "Apple"
},
"color": "white"
},
"trackingNumber": "3453291231",
"trackingUrl": "http://fedex.com/track/3453291231",
"potentialAction": {
"@type": "TrackAction",
"url": "http://fedex.com/track/3453291231"
},
"hasDeliveryMethod": {
"@type": "ParcelService",
"name": "http://schema.org/ParcelService"
},
"partOfOrder": {
"@type": "Order",
"orderNumber": "176057",
"merchant": {
"@type": "Organization",
"name": "Bob Dole",
"sameAs": "http://www.freebase.com/m/0fhkx"
},
"orderStatus": "http://schema.org/OrderInTransit"
}
}
</script>
Vi dữ liệu
<div itemscope itemtype="http://schema.org/ParcelDelivery">
<div itemprop="deliveryAddress" itemscope itemtype="http://schema.org/PostalAddress">
<meta itemprop="name" content="John Frank"/>
<meta itemprop="streetAddress" content="24 Willie Mays Plaza"/>
<meta itemprop="addressLocality" content="San Francisco"/>
<meta itemprop="addressRegion" content="CA"/>
<meta itemprop="addressCountry" content="US"/>
<meta itemprop="postalCode" content="94107"/>
</div>
<div itemprop="originAddress" itemscope itemtype="http://schema.org/PostalAddress">
<meta itemprop="name" content="John Frank"/>
<meta itemprop="streetAddress" content="25 Willie Mays Plaza"/>
<meta itemprop="addressLocality" content="San Francisco"/>
<meta itemprop="addressRegion" content="CA"/>
<meta itemprop="addressCountry" content="US"/>
<meta itemprop="postalCode" content="94107"/>
</div>
<meta itemprop="expectedArrivalFrom" content="2027-03-10T12:00:00-08:00"/>
<meta itemprop="expectedArrivalUntil" content="2027-03-12T12:00:00-08:00"/>
<div itemprop="carrier" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="FedEx"/>
<link itemprop="url" href="http://fedex.com/"/>
</div>
<div itemprop="itemShipped" itemscope itemtype="http://schema.org/Product">
<meta itemprop="name" content="iPod Mini"/>
<link itemprop="url" href="http://apple.com/ipad32gb"/>
<link itemprop="image" href="http://apple.com/images/ipad32gb.jpg"/>
<meta itemprop="sku" content="B00DR0PDNE"/>
<meta itemprop="description" content="iPod Mini 32Gb White"/>
<div itemprop="brand" itemscope itemtype="http://schema.org/Brand">
<meta itemprop="name" content="Apple"/>
</div>
<meta itemprop="color" content="white"/>
</div>
<meta itemprop="trackingNumber" content="3453291231"/>
<link itemprop="trackingUrl" href="http://fedex.com/track/3453291231"/>
<div itemprop="potentialAction" itemscope itemtype="http://schema.org/TrackAction">
<link itemprop="url" href="http://fedex.com/track/3453291231"/>
</div>
<div itemprop="hasDeliveryMethod" itemscope itemtype="http://schema.org/ParcelService">
<meta itemprop="name" content="http://schema.org/ParcelService"/>
</div>
<div itemprop="partOfOrder" itemscope itemtype="http://schema.org/Order">
<meta itemprop="orderNumber" content="176057"/>
<div itemprop="merchant" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="Bob Dole"/>
<link itemprop="sameAs" href="http://www.freebase.com/m/0fhkx"/>
</div>
<link itemprop="orderStatus" href="http://schema.org/OrderInTransit"/>
</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 đâ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ả |
|---|---|---|
| deliveryAddress | PostalAddress | (bắt buộc) Địa chỉ điểm đến. |
| deliveryAddress.name | Văn bản | Tên của PostalAddress. |
| deliveryAddress.streetAddress | Văn bản | (bắt buộc) Địa chỉ đường phố. Ví dụ: 1600 Amphitheatre Pkwy. |
| deliveryAddress.addressLocality | Văn bản | (bắt buộc) Địa phương. Ví dụ: Mountain View. |
| deliveryAddress.addressRegion | Văn bản | (bắt buộc) Khu vực. Ví dụ: CA. |
| deliveryAddress.addressCountry | Văn bản hoặc Quốc gia | (bắt buộc) 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. |
| deliveryAddress.postalCode | Văn bản | (bắt buộc) Mã bưu chính. Ví dụ: 94043. |
| originAddress | PostalAddress | Địa chỉ của người vận chuyển. |
| originAddress.name | Văn bản | Tên của PostalAddress. |
| originAddress.streetAddress | Văn bản | Địa chỉ đường phố. Ví dụ: 1600 Amphitheatre Pkwy. |
| originAddress.addressLocality | Văn bản | Thành phố. Ví dụ: Mountain View. |
| originAddress.addressRegion | Văn bản | Khu vực. Ví dụ: CA. |
| originAddress.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. |
| originAddress.postalCode | Văn bản | Mã bưu chính. Ví dụ: 94043. |
| expectedArrivalFrom | DateTime | Ngày sớm nhất mà gói hàng dự kiến sẽ đến. |
| expectedArrivalUntil | DateTime | (bắt buộc) Ngày muộn nhất mà gói hàng dự kiến sẽ đến. |
| nhà mạng | Tổ chức | (bắt buộc) Bên chịu trách nhiệm giao bưu kiện. Cũng chấp nhận một chuỗi (ví dụ: "FedEx"). |
| carrier.name | Văn bản | (bắt buộc) Tên tổ chức. |
| carrier.url | URL | URL của tổ chức. |
| itemShipped | Sản phẩm hoặc Đặt trước | (bắt buộc) Sản phẩm có trong lô hàng này. Để biểu thị số lượng, hãy lặp lại một Sản phẩm một cách thích hợp hoặc không sử dụng thuộc tính này và thay vào đó, hãy sử dụng partOfOrder để thể hiện những Sản phẩm được đưa vào. Cũng chấp nhận một mảng đối tượng. |
| itemShipped.name | Văn bản | (bắt buộc) Tên sản phẩm. |
| itemShipped.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 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. |
| itemShipped.image | 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 hình ảnh về Sản phẩm, thường là hình ảnh trên trang web của người bán. |
| itemShipped.sku | Văn bản | (nên dùng cho thẻ xác nhận/Câu trả lời trên Tìm kiếm) Đơn vị lưu kho (SKU), tức là giá trị nhận dạng dành riêng cho người bán của một sản phẩm hoặc dịch vụ, hoặc sản phẩm mà ưu đãi đề cập đến. |
| itemShipped.description | Văn bản | Nội dung mô tả ngắn về Sản phẩm. |
| itemShipped.brand | Thương hiệu | Thương hiệu có liên quan đến Sản phẩm. |
| itemShipped.brand.name | Văn bản | Tên thương hiệu. |
| itemShipped.color | Văn bản | Màu sắc của sản phẩm. |
| trackingNumber | Văn bản | (nên dùng cho thẻ xác nhận/Câu trả lời trên Tìm kiếm) Số vận đơn của hãng vận chuyển. |
| trackingUrl | URL | (nên dùng cho thẻ xác nhận/Câu trả lời trên Tìm kiếm) Trang web nơi bạn có thể theo dõi gói hàng. |
| hasDeliveryMethod | DeliveryMethod | Phương thức được dùng để phân phối. |
| deliveryStatus | DeliveryEvent | Mục nhập mới được thêm vào khi gói hàng đi qua từng chặng của hành trình (từ khi vận chuyển đến khi giao hàng lần cuối). Đặc biệt hữu ích cho các dịch vụ giao hàng kiểu đến lấy hàng (ví dụ: tại cửa hàng, tại tủ khoá). |
| partOfOrder | Đặt món | (bắt buộc) Thông tin chi tiết về đơn đặt hàng đang được vận chuyển. Khi bạn không thể trình bày chi tiết về Sản phẩm có trong lô hàng bằng itemShipped (ví dụ: số lượng đã vận chuyển), hãy sử dụng Đơn đặt hàng này để trình bày Sản phẩm. |
| partOfOrder.orderNumber | Văn bản | (bắt buộc) Giá trị nhận dạng riêng biệt của giao dịch theo từng người bán. |
| partOfOrder.merchant | 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à người bán cho nhiều người bán). Cũng chấp nhận một chuỗi (ví dụ: "Bob Dole"). |
| partOfOrder.merchant.name | Văn bản | (bắt buộc) Tên tổ chức. |
| partOfOrder.merchant.sameAs | URL | URL Freebase của người bán. |
| partOfOrder.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. |