Utilisez ce modèle pour décrire l'état de livraison d'un colis.
Cas d'utilisation
Livraison de colis de base
Exemple minimal pour une livraison de colis :
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>
Microdonnées
<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>
Livraison de colis avec informations de livraison
Exemple de livraison de colis avec des informations de livraison détaillées :
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>
Microdonnées
<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>
Tester le balisage
Vous pouvez valider votre balisage à l'aide de l' outil de test de balisage des e-mails. Collez votre code de balisage et cliquez sur le bouton Valider pour analyser le contenu et recevoir un rapport sur les erreurs éventuelles.
Spécification
Le tableau suivant répertorie toutes les propriétés disponibles pour ce type :
| Propriété | Type | Description |
|---|---|---|
| deliveryAddress | PostalAddress | (obligatoire) Adresse de destination. |
| deliveryAddress.name | Texte | Nom de l'adresse postale. |
| deliveryAddress.streetAddress | Texte | (obligatoire) Adresse postale. Par exemple, 1600 Amphitheatre Pkwy. |
| deliveryAddress.addressLocality | Texte | (obligatoire) Localité. Par exemple, Mountain View. |
| deliveryAddress.addressRegion | Texte | (obligatoire) Région. Par exemple, CA. |
| deliveryAddress.addressCountry | Texte ou Pays | (obligatoire) Pays. Par exemple, États-Unis. Vous pouvez également fournir le code pays à deux lettres au format ISO 3166-1 alpha-2. |
| deliveryAddress.postalCode | Texte | (obligatoire) Code postal. Par exemple, 94043. |
| originAddress | PostalAddress | Adresse de l'expéditeur. |
| originAddress.name | Texte | Nom de l'adresse postale. |
| originAddress.streetAddress | Texte | Adresse postale. Par exemple, 1600 Amphitheatre Pkwy. |
| originAddress.addressLocality | Texte | Localité. Par exemple, Mountain View. |
| originAddress.addressRegion | Texte | Région. Par exemple, CA. |
| originAddress.addressCountry | Texte ou Pays | Pays. Par exemple, États-Unis. Vous pouvez également fournir le code pays à deux lettres au format ISO 3166-1 alpha-2. |
| originAddress.postalCode | Texte | Code postal. Par exemple, 94043. |
| expectedArrivalFrom | DateTime | Date d'arrivée prévue la plus proche. |
| expectedArrivalUntil | DateTime | (obligatoire) Date d'arrivée prévue la plus tardive. |
| opérateur | Entreprise | (obligatoire) Partie responsable de la livraison du colis. Accepte également une chaîne (par exemple, "FedEx"). |
| carrier.name | Texte | (obligatoire) Nom de l'entreprise. |
| carrier.url | URL | URL de l'entreprise. |
| itemShipped | Produit ou Réservation | (obligatoire) Produits inclus dans cette expédition. Pour représenter la quantité, répétez un produit de manière appropriée ou n'utilisez pas cet attribut et utilisez plutôt partOfOrder pour indiquer les produits inclus. Accepte également un tableau d'objets. |
| itemShipped.name | Texte | (obligatoire) Nom du produit. |
| itemShipped.url | URL | (recommandé pour les fiches de confirmation/réponses de recherche) URL du produit, généralement la page produit de destination sur le site Web du marchand. |
| itemShipped.image | URL | (recommandé pour les cartes de confirmation/réponses de recherche) URL d'une image du produit, généralement une image sur le site Web du marchand. |
| itemShipped.sku | Texte | (recommandé pour les cartes de confirmation/réponses de recherche) L'unité de gestion des stocks (SKU), c'est-à-dire un identifiant spécifique au marchand pour un produit ou un service, ou le produit auquel l'offre fait référence. |
| itemShipped.description | Texte | Brève description du produit. |
| itemShipped.brand | Marque | Marque associée au produit. |
| itemShipped.brand.name | Texte | Nom de la marque. |
| itemShipped.color | Texte | Couleur du produit. |
| trackingNumber | Texte | (recommandé pour les cartes de confirmation/réponses de recherche) Numéro de suivi de l'expéditeur. |
| trackingUrl | URL | (recommandé pour les cartes de confirmation/réponses de recherche) Page Web sur laquelle le colis peut être suivi. |
| hasDeliveryMethod | DeliveryMethod | Méthode utilisée pour la livraison. |
| deliveryStatus | DeliveryEvent | Nouvelle entrée ajoutée à mesure que le colis passe par chaque étape de son parcours (de l'expédition à la livraison finale). Particulièrement utile pour les livraisons de type retrait (en magasin, dans un casier, etc.). |
| partOfOrder | Commander | (obligatoire) Détails de la commande en cours d'expédition. Lorsque les détails sur les produits inclus dans l'expédition ne peuvent pas être exprimés par itemShipped (par exemple, la quantité expédiée), utilisez plutôt cette commande pour exprimer les produits. |
| partOfOrder.orderNumber | Texte | (obligatoire) Identifiant de la transaction spécifique au marchand. |
| partOfOrder.merchant | Organization ou Person | (obligatoire) Partie qui prend la commande (par exemple, Amazon.com est un marchand pour de nombreux vendeurs). Accepte également une chaîne (par exemple, "Bob Dole"). |
| partOfOrder.merchant.name | Texte | (obligatoire) Nom de l'entreprise. |
| partOfOrder.merchant.sameAs | URL | URL Freebase du marchand. |
| partOfOrder.orderStatus | OrderStatus | (recommandé pour les cartes de confirmation/réponses de recherche) État actuel de la commande. |