DeliveryChargeSpecification - schema.org

# schema.org

- Documentation
- Schemas
- Home

# DeliveryChargeSpecification

#### Thing > Intangible > StructuredValue > PriceSpecification > DeliveryChargeSpecification

The price for the delivery of an offer using a particular delivery method.
Usage: Between 100 and 1000 domains

Property | Expected Type | Description
--- | --- | ---
[more...]

- Leave public feedback on this term 💬
- Check for open issues.
- 'DeliveryChargeSpecification' is mentioned in layer: core

Properties from DeliveryChargeSpecification
`appliesToDeliveryMethod` | DeliveryMethod | The delivery method(s) to which the delivery charge or payment charge specification applies.
`areaServed` | AdministrativeArea or GeoShape or Place or Text | The geographic area where a service or offered item is provided. Supersedes serviceArea.
`eligibleRegion` | GeoShape or Place or Text | The ISO 3166-1 (ISO 3166-1 alpha-2) or ISO 3166-2 code, the place, or the GeoShape for the geo-political region(s) for which the offer or delivery charge specification is valid. See also ineligibleRegion.
`ineligibleRegion` | GeoShape or Place or Text | The ISO 3166-1 (ISO 3166-1 alpha-2) or ISO 3166-2 code, the place, or the GeoShape for the geo-political region(s) for which the offer or delivery charge specification is not valid, e.g. a region where the transaction is not allowed. See also eligibleRegion.
Properties from PriceSpecification
`eligibleQuantity` | QuantitativeValue | The interval and unit of measurement of ordering quantities for which the offer or price specification is valid. This allows e.g. specifying that a certain freight charge is valid only for a certain quantity.
`eligibleTransactionVolume` | PriceSpecification | The transaction volume, in a monetary unit, for which the offer or price specification is valid, e.g. for indicating a minimal purchasing volume, to express free shipping above a certain order volume, or to limit the acceptance of credit cards to purchases to a certain minimal amount.
`maxPrice` | Number | The highest price if the price is a range.
`minPrice` | Number | The lowest price if the price is a range.

`price`

Number or
Text

The offer price of a product, or of a price component when attached to PriceSpecification and its subtypes.
Usage guidelines:

- Use the priceCurrency property (with ISO 4217 codes e.g. "USD") instead of including ambiguous symbols such as '$' in the value.
- Use '.' (Unicode 'FULL STOP' (U+002E)) rather than ',' to indicate a decimal point. Avoid using these symbols as a readability separator.
- Note that both RDFa and Microdata syntax allow the use of a "content=" attribute for publishing simple machine-readable values alongside more human-friendly formatting.
- Use values from 0123456789 (Unicode 'DIGIT ZERO' (U+0030) to 'DIGIT NINE' (U+0039)) rather than superficially similiar Unicode symbols.

`priceCurrency` | Text | The currency (in 3-letter ISO 4217 format) of the price or a price component, when attached to PriceSpecification and its subtypes.
`validFrom` | DateTime | The date when the item becomes valid.
`validThrough` | DateTime | The date after when the item is not valid. For example the end of an offer, salary period, or a period of opening hours.
`valueAddedTaxIncluded` | Boolean | Specifies whether the applicable value-added tax (VAT) is included in the price specification or not.
Properties from Thing
`additionalType` | URL | An additional type for the item, typically used for adding more specific types from external vocabularies in microdata syntax. This is a relationship between something and a class that the thing is in. In RDFa syntax, it is better to use the native RDFa syntax - the 'typeof' attribute - for multiple types. Schema.org tools may have only weaker understanding of extra types, in particular those defined externally.
`alternateName` | Text | An alias for the item.
`description` | Text | A description of the item.
`disambiguatingDescription` | Text | A sub property of description. A short description of the item used to disambiguate from other, similar items. Information from other properties (in particular, name) may be necessary for the description to be useful for disambiguation.
`image` | ImageObject or URL | An image of the item. This can be a URL or a fully described ImageObject.
`mainEntityOfPage` | CreativeWork or URL | Indicates a page (or other CreativeWork) for which this thing is the main entity being described. See background notes for details. Inverse property: mainEntity.
`name` | Text | The name of the item.
`potentialAction` | Action | Indicates a potential Action, which describes an idealized action in which this thing would play an 'object' role.
`sameAs` | URL | URL of a reference Web page that unambiguously indicates the item's identity. E.g. the URL of the item's Wikipedia page, Freebase page, or official website.
`url` | URL | URL of the item.

#### Acknowledgement

This class is derived from the GoodRelations Vocabulary for E-Commerce, created by Martin Hepp. GoodRelations is a data model for sharing e-commerce data on the Web that can be expressed in a variety of syntaxes, including RDFa and HTML5 Microdata. More information about GoodRelations can be found at http://purl.org/goodrelations/.

Examples
Example 1
Without Markup Microdata RDFa JSON-LD

    Joes' Pizza
    123 Main Street
    Cambridge, MA 02142
    delivers within 5 km of its store with a minimum order of $20.

    <div itemscope itemtype="http://schema.org/FoodEstablishment">
      <span itemprop="name">Joe's Pizza</span>
      <div itemprop="location" itemscope itemtype="http://schema.org/PostalAddress">
        <span itemprop="streetAddress">123 Main Street</span>
        <span itemprop="addressLocality">Cambridge</span>
        <span itemprop="addressRegion">MA</span>
        <span itemprop="postalCode">02142</span>
      </div>
      delivers within 5 km of its store
      <div itemprop="makesOffer" itemscope itemtype="http://schema.org/Offer">
        <div itemprop="availableAtOrFrom" itemscope itemtype="http://schema.org/GeoCircle">
          <div itemprop="address" itemscope itemtype="http://schema.org/PostalAddress">
            <meta itemprop="streetAddress" content="123 Main Street" />
            <meta itemprop="addressLocality" content="Cambridge" />
            <meta itemprop="addressRegion" content="MA" />
            <meta itemprop="postalCode" content="02142" />
          </div>
          <meta itemprop="geoRadius" content="5000" />
        </div>
        with a minium order of $20.
        <div itemprop="priceSpecification" itemscope itemtype="http://schema.org/DeliveryChargeSpecification">
          <meta itemprop="appliesToDeliveryMethod" link="http://purl.org/goodrelations/v1#DeliveryModeOwnFleet">
          <div itemprop="eligibleTransactionVolume" itemscope itemtype="http://schema.org/PriceSpecification">
            <meta itemprop="price" content="20.00" />
            <meta itemprop="priceCurrency" content="USD" />
          </div>
        </div>
      </div>
    </div>

    <div vocab="http://schema.org/" typeof="FoodEstablishment">
      <span property="name">Joe's Pizza</span>
      <div property="location" typeof="PostalAddress">
        <span property="streetAddress">123 Main Street</span>
        <span property="addressLocality">Cambridge</span>
        <span property="addressRegion">MA</span>
        <span property="postalCode">02142</span>
      </div>
      delivers within 5 km of its store with a minium order of $20.
      <div property="makesOffer" typeof="Offer">
        <div property="priceSpecification" typeof="DeliveryChargeSpecification">
          <meta property="appliesToDeliveryMethod" link="http://purl.org/goodrelations/v1#DeliveryModeOwnFleet">
          <div property="eligibleTransactionVolume" typeof="PriceSpecification">
            <meta property="price" content="20.00" />
            <meta property="priceCurrency" content="USD" />
          </div>
          <div property="eligibleRegion" typeof="GeoCircle">
            <div property="address" typeof="PostalAddress">
              <meta property="streetAddress" content="123 Main Street" />
              <meta property="addressLocality" content="Cambridge" />
              <meta property="addressRegion" content="MA" />
              <meta property="postalCode" content="02142" />
            </div>
            <meta property="geoRadius" content="5000" />
          </div>
        </div>
      </div>
    </div>

    <script type="application/ld+json">
      {
        "@context": "http://schema.org/",
        "@type": "FoodEstablishment",
        "name": "Joe's Pizza",
        "location": {
          "@type": "PostalAddress",
          "@id": "http://example.com/address",
          "streetAddress": "123 Main Street",
          "addressLocality": "Cambridge",
          "addressRegion": "MA",
          "postalCode": "02142"
        },
        "makesOffer": {
          "@type": "Offer",
          "priceSpecification": {
            "@type": "DeliveryChargeSpecification",
            "appliesToDeliveryMethod": "http://purl.org/goodrelations/v1#DeliveryModeOwnFleet",
            "eligibleTransactionVolume": {
              "@type": "PriceSpecification",
              "price": "20.00",
              "priceCurrency": "USD"
            },
            "eligibleRegion": {
              "@type": "GeoCircle",
              "address": {
                "@id": "http://www.example.com/address"
              },
              "geoRadius": "5000"
            }
          }
        }
      }
    </script>

Schema Version 3.0