NAME

SemanticWeb::Schema::PriceSpecification - A structured value representing a price or price range

VERSION

version v22.0.0

DESCRIPTION

A structured value representing a price or price range. Typically, only the subclasses of this type are used for markup. It is recommended to use SemanticWeb::Schema::MonetaryAmount to describe independent amounts of money such as a salary, credit card limits, etc.

ATTRIBUTES

eligible_quantity

eligibleQuantity

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.

A eligible_quantity should be one of the following types:

InstanceOf['SemanticWeb::Schema::QuantitativeValue']

_has_eligible_quantity

A predicate for the "eligible_quantity" attribute.

eligible_transaction_volume

eligibleTransactionVolume

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.

A eligible_transaction_volume should be one of the following types:

InstanceOf['SemanticWeb::Schema::PriceSpecification']

_has_eligible_transaction_volume

A predicate for the "eligible_transaction_volume" attribute.

max_price

maxPrice

The highest price if the price is a range.

A max_price should be one of the following types:

Num

_has_max_price

A predicate for the "max_price" attribute.

min_price

minPrice

The lowest price if the price is a range.

A min_price should be one of the following types:

Num

_has_min_price

A predicate for the "min_price" attribute.

price

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 standard formats: ISO 4217 currency format, e.g. "USD"; Ticker symbol for cryptocurrencies, e.g. "BTC"; well known names for Local Exchange Trading Systems (LETS) and other currency types, e.g. "Ithaca HOUR") 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 similar Unicode symbols.

A price should be one of the following types:

Num
Str

_has_price

A predicate for the "price" attribute.

price_currency

priceCurrency

The currency of the price, or a price component when attached to SemanticWeb::Schema::PriceSpecification and its subtypes.

Use standard formats: ISO 4217 currency format, e.g. "USD"; Ticker symbol for cryptocurrencies, e.g. "BTC"; well known names for Local Exchange Trading Systems (LETS) and other currency types, e.g. "Ithaca HOUR".

A price_currency should be one of the following types:

Str

_has_price_currency

A predicate for the "price_currency" attribute.

valid_from

validFrom

The date when the item becomes valid.

A valid_from should be one of the following types:

Str

_has_valid_from

A predicate for the "valid_from" attribute.

valid_through

validThrough

The date after when the item is not valid. For example the end of an offer, salary period, or a period of opening hours.

A valid_through should be one of the following types:

Str

_has_valid_through

A predicate for the "valid_through" attribute.

value_added_tax_included

valueAddedTaxIncluded

Specifies whether the applicable value-added tax (VAT) is included in the price specification or not.

A value_added_tax_included should be one of the following types:

Bool

_has_value_added_tax_included

A predicate for the "value_added_tax_included" attribute.

SEE ALSO

SemanticWeb::Schema::StructuredValue

SOURCE

The development version is on github at https://github.com/robrwo/SemanticWeb-Schema and may be cloned from git://github.com/robrwo/SemanticWeb-Schema.git

BUGS

Please report any bugs or feature requests on the bugtracker website https://github.com/robrwo/SemanticWeb-Schema/issues

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

AUTHOR

Robert Rothenberg <rrwo@cpan.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2018-2023 by Robert Rothenberg.

This is free software, licensed under:

The Artistic License 2.0 (GPL Compatible)