DeliveryLine extends StructuredValue uses DeliveryLineTrait, HasPhysicalMeasures
A single line of a {@see DeliveryNote} : how much of a given {@see BusinessDocumentLine} (identified by `position`) was actually delivered, as opposed to ordered or left in backorder.
This is the gap confirmed across every reference checked for this
namespace (UBL's DespatchLine, Odoo's stock.move, SAP's delivery
item) : a bare orderDelivery (a single ParcelDelivery)
can say a parcel was shipped, but not how much of what was ordered it
actually contains — a blind spot the moment a delivery is only partial.
batchNumber/serialNumbers cover the traceability a line may need
(food, pharma, warranty, product recalls) — both optional, since most
goods need neither.
🔑 Everything this line measures describes what actually left, never what
was ordered : deliveredQuantity against orderedQuantity, and the
weight/volume it takes from HasPhysicalMeasures. A line delivering
84 of the 120 square meters ordered weighs the 84, which is why those figures
belong to the delivery line and not to the order's line — and why the lines
sum to BusinessDocument::$weight and BusinessDocument::$volume
on the note itself.
Tags
Table of Contents
Constants
- BACKORDER_QUANTITY : string = 'backorderQuantity'
- BACKORDER_REASON : string = 'backorderReason'
- BATCH_NUMBER : string = 'batchNumber'
- CONTEXT : string = \xyz\oihana\schema\constants\Oihana::SCHEMA
- The @context of the json-ld representation of the thing.
- DELIVERED_QUANTITY : string = 'deliveredQuantity'
- ITEM : string = 'item'
- JSON_PRIORITY_KEYS : array<string|int, mixed> = [\org\schema\constants\Schema::AT_TYPE, \org\sc...
- Defines the priority order of keys when serializing the object to JSON-LD.
- ORDERED_QUANTITY : string = 'orderedQuantity'
- POSITION : string = 'position'
- REFERENCES_INVOICE : string = 'referencesInvoice'
- REFERENCES_ORDER : string = 'referencesOrder'
- SERIAL_NUMBERS : string = 'serialNumbers'
- VOLUME : string = 'volume'
- WEIGHT : string = 'weight'
Properties
- $_from : string|null
- The metadata to indicates the edge 'from' identifier.
- $_id : null|string
- The metadata identifier of the item.
- $_key : null|string
- The metadata unique key identifier of the thing.
- $_rev : null|string
- The metadata revision value of the thing.
- $_to : string|null
- The metadata to indicates the edge 'to' identifier.
- $active : bool|null
- The visibility flag.
- $additionalType : array<string|int, mixed>|string|null|object
- An additionalType for the item.
- $alternateName : string|object|array<string|int, mixed>|null
- An alias for the item.
- $backorderQuantity : int|float|QuantitativeValue|array<string|int, mixed>|null
- The quantity of this line still in backorder (ordered but not yet delivered).
- $backorderReason : string|null
- Why the backorder quantity could not be delivered (e.g. "out of stock").
- $batchNumber : string|null
- The batch/lot number of the delivered goods, when traceability applies.
- $created : null|string
- Date of creation of the resource.
- $deliveredQuantity : int|float|QuantitativeValue|array<string|int, mixed>|null
- The quantity actually delivered on this line.
- $description : string|object|array<string|int, mixed>|null
- A short description of the item.
- $disambiguatingDescription : string|null
- 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.
- $hasPart : string|Thing|array<string|int, Thing>|null
- Indicates an item that this part of this item.
- $id : null|int|string
- The unique identifier of the item.
- $identifier : string|null
- The identifier of the item.
- $image : string|ImageObject|array<string|int, ImageObject|string>|null
- The image reference of this resource.
- $isPartOf : string|Thing|array<string|int, Thing>|null
- Indicates an item that this item is part of.
- $item : null|array<string|int, mixed>|Product|Service
- The product or service this line concerns.
- $license : string|object|null
- A legal document giving official permission to do something with the resource.
- $mainEntityOfPage : string|null
- Indicates a page (or other CreativeWork) for which this thing is the main entity being described.
- $modified : null|string
- Date on which the resource was changed.
- $name : int|string|null
- The name of the item.
- $orderedQuantity : int|float|QuantitativeValue|array<string|int, mixed>|null
- The quantity originally ordered on this line.
- $owner : null|string|Thing
- The owner of this Thing.
- $position : int|string|null
- The position of the originating {@see BusinessDocumentLine} this delivery line reconciles against (e.g. the purchase order's line 1, 2, 3...).
- $potentialAction : array<string|int, mixed>|Action|null
- Indicates a potential Action, which describes an idealized action in which this thing would play an 'object' role.
- $publisher : string|array<string|int, string|Person|Organization>|Person|Organization|null
- The publisher of the resource.
- $referencesInvoice : null|array<string|int, mixed>|string|Invoice
- The invoice that bills this line.
- $referencesOrder : null|array<string|int, mixed>|string|PurchaseOrder
- The purchase order this line comes from.
- $sameAs : string|array<string|int, mixed>|null
- URL of a reference Web page that unambiguously indicates the item's identity.
- $serialNumbers : null|array<string|int, mixed>|string
- The serial numbers of the delivered items, when the goods are serialized.
- $subjectOf : null|string|array<string|int, mixed>|CreativeWork|Event
- A CreativeWork or Event about this Thing.
- $url : int|string|null
- URL of the item.
- $volume : null|array<string|int, mixed>|int|float|QuantitativeValue
- The space this entry takes up.
- $weight : null|array<string|int, mixed>|int|float|QuantitativeValue|Mass
- What this entry weighs.
- $atContext : string|null
- The JSON-LD `@context` value.
- $atType : string|null
- The JSON-LD `@type` value.
- $DEFAULT_JSON_SERIALIZE_OPTIONS : array<string|int, mixed>
- The default static jsonSerialize options (class-level configuration).
- $schemaTypeCache : array<string, string>
- Internal cache for resolved schema types.
Methods
- __construct() : mixed
- Constructor to hydrate public properties from an array or stdClass.
- getJsonSerializeOptions() : array<string|int, mixed>
- Returns the default JSON serialization options.
- getSchemaType() : string
- Returns the fully qualified URI of the schema type.
- jsonSerialize() : array<string|int, mixed>
- Serializes the current object into a JSON-LD array.
- withAtContext() : $this
- Sets the internal JSON-LD `@context` attribute.
- withAtType() : $this
- Sets the internal JSON-LD `@type` attribute.
- withJSONLDMeta() : $this
- Initializes both JSON-LD metadata: `@type` and `@context`.
Constants
BACKORDER_QUANTITY
public
string
BACKORDER_QUANTITY
= 'backorderQuantity'
BACKORDER_REASON
public
string
BACKORDER_REASON
= 'backorderReason'
BATCH_NUMBER
public
string
BATCH_NUMBER
= 'batchNumber'
CONTEXT
The @context of the json-ld representation of the thing.
public
string
CONTEXT
= \xyz\oihana\schema\constants\Oihana::SCHEMA
DELIVERED_QUANTITY
public
string
DELIVERED_QUANTITY
= 'deliveredQuantity'
ITEM
public
string
ITEM
= 'item'
JSON_PRIORITY_KEYS
Defines the priority order of keys when serializing the object to JSON-LD.
public
array<string|int, mixed>
JSON_PRIORITY_KEYS
= [\org\schema\constants\Schema::AT_TYPE, \org\schema\constants\Schema::AT_CONTEXT, \org\schema\constants\Schema::_KEY, \org\schema\constants\Schema::_FROM, \org\schema\constants\Schema::_TO, \org\schema\constants\Schema::ID, \org\schema\constants\Schema::NAME, \org\schema\constants\Schema::URL, \org\schema\constants\Schema::CREATED, \org\schema\constants\Schema::MODIFIED]
Keys listed here will always appear first in the serialized array, in the order specified. All remaining public properties will be sorted alphabetically after these priority keys.
This ensures that important JSON-LD metadata and system fields
(like @type, @context, _key, id, url, created, modified, etc.)
appear at the top of the output for consistency and readability.
Usage:
$orderedKeys = self::JSON_PRIORITY_KEYS;
Notes:
- Can be overridden in a subclass by redefining the constant.
- Late static binding (
static::JSON_PRIORITY_KEYS) allows child classes to modify the serialization order.
List of JSON-LD keys in priority order.
ORDERED_QUANTITY
public
string
ORDERED_QUANTITY
= 'orderedQuantity'
POSITION
public
string
POSITION
= 'position'
REFERENCES_INVOICE
public
string
REFERENCES_INVOICE
= 'referencesInvoice'
REFERENCES_ORDER
public
string
REFERENCES_ORDER
= 'referencesOrder'
SERIAL_NUMBERS
public
string
SERIAL_NUMBERS
= 'serialNumbers'
VOLUME
public
string
VOLUME
= 'volume'
WEIGHT
public
string
WEIGHT
= 'weight'
Properties
$_from
The metadata to indicates the edge 'from' identifier.
public
string|null
$_from
$_id
The metadata identifier of the item.
public
null|string
$_id
$_key
The metadata unique key identifier of the thing.
public
null|string
$_key
$_rev
The metadata revision value of the thing.
public
null|string
$_rev
$_to
The metadata to indicates the edge 'to' identifier.
public
string|null
$_to
$active
The visibility flag.
public
bool|null
$active
$additionalType
An additionalType for the item.
public
array<string|int, mixed>|string|null|object
$additionalType
$alternateName
An alias for the item.
public
string|object|array<string|int, mixed>|null
$alternateName
$backorderQuantity
The quantity of this line still in backorder (ordered but not yet delivered).
public
int|float|QuantitativeValue|array<string|int, mixed>|null
$backorderQuantity
Attributes
- #[HydrateAs]
- \org\schema\QuantitativeValue::class
$backorderReason
Why the backorder quantity could not be delivered (e.g. "out of stock").
public
string|null
$backorderReason
$batchNumber
The batch/lot number of the delivered goods, when traceability applies.
public
string|null
$batchNumber
$created
Date of creation of the resource.
public
null|string
$created
$deliveredQuantity
The quantity actually delivered on this line.
public
int|float|QuantitativeValue|array<string|int, mixed>|null
$deliveredQuantity
Attributes
- #[HydrateAs]
- \org\schema\QuantitativeValue::class
$description
A short description of the item.
public
string|object|array<string|int, mixed>|null
$description
$disambiguatingDescription
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.
public
string|null
$disambiguatingDescription
$hasPart
Indicates an item that this part of this item.
public
string|Thing|array<string|int, Thing>|null
$hasPart
$id
The unique identifier of the item.
public
null|int|string
$id
$identifier
The identifier of the item.
public
string|null
$identifier
$image
The image reference of this resource.
public
string|ImageObject|array<string|int, ImageObject|string>|null
$image
$isPartOf
Indicates an item that this item is part of.
public
string|Thing|array<string|int, Thing>|null
$isPartOf
$item
The product or service this line concerns.
public
null|array<string|int, mixed>|Product|Service
$item
The Product|Service union is resolved from the payload's @type : a raw
item hydrates into a Service when it says so, and into the
commerce-enriched Product (a org\schema\Product) otherwise.
Attributes
- #[HydrateWith]
- \xyz\oihana\schema\products\Product::class
- \org\schema\Service::class
$license
A legal document giving official permission to do something with the resource.
public
string|object|null
$license
$mainEntityOfPage
Indicates a page (or other CreativeWork) for which this thing is the main entity being described.
public
string|null
$mainEntityOfPage
$modified
Date on which the resource was changed.
public
null|string
$modified
$name
The name of the item.
public
int|string|null
$name
$orderedQuantity
The quantity originally ordered on this line.
public
int|float|QuantitativeValue|array<string|int, mixed>|null
$orderedQuantity
Attributes
- #[HydrateAs]
- \org\schema\QuantitativeValue::class
$owner
The owner of this Thing.
public
null|string|Thing
$owner
Represents any entity (person, organization, system, or other object) that can be considered the possessor of this Thing.
$position
The position of the originating {@see BusinessDocumentLine} this delivery line reconciles against (e.g. the purchase order's line 1, 2, 3...).
public
int|string|null
$position
⚠️ Read relative to DeliveryLine::$referencesOrder. As soon as a note delivers more than one order, a position on its own names nothing — line 325 of which order ?
$potentialAction
Indicates a potential Action, which describes an idealized action in which this thing would play an 'object' role.
public
array<string|int, mixed>|Action|null
$potentialAction
$publisher
The publisher of the resource.
public
string|array<string|int, string|Person|Organization>|Person|Organization|null
$publisher
$referencesInvoice
The invoice that bills this line.
public
null|array<string|int, mixed>|string|Invoice
$referencesInvoice
🔑 The link lives here and not on the note. A note can be billed by more than one invoice — it delivers several orders, and each is invoiced on its own — so an invoice reference on the header would have to choose between them. At the line grain the question does not arise : a line belongs to one order, hence to one invoice.
The sibling of DeliveryLine::$referencesOrder, and it follows the same rule : the union names a single class, so Reflection::hydrate() resolves a joined row on its own, while a bare key is left as read.
Tags
$referencesOrder
The purchase order this line comes from.
public
null|array<string|int, mixed>|string|PurchaseOrder
$referencesOrder
A delivery line is a fact of its own, not a copy of the order's line and not a pointer to it : it says what left on this note, of that line, on that day. The quantity belongs to the delivery — which is why a line can be delivered in halves, and why a document that merely pointed at the order's lines could not express it.
🔑 Without it, orderedQuantity cannot even be filled. A source that
leaves the ordered quantity off the delivery only states it on the order,
and there is no way back to it from a position alone.
Holds the raw order reference as read from the source, or the resolved
PurchaseOrder. No #[HydrateAs] is needed : the union names a
single class, so Reflection::hydrate() resolves a
joined row on its own, while a bare key is left as read — and array
is what lets that row sit here until it is resolved.
Tags
$sameAs
URL of a reference Web page that unambiguously indicates the item's identity.
public
string|array<string|int, mixed>|null
$sameAs
E.g. the URL of the item's Wikipedia page, Wikidata entry, or official website.
$serialNumbers
The serial numbers of the delivered items, when the goods are serialized.
public
null|array<string|int, mixed>|string
$serialNumbers
$subjectOf
A CreativeWork or Event about this Thing.
public
null|string|array<string|int, mixed>|CreativeWork|Event
$subjectOf
$url
URL of the item.
public
int|string|null
$url
$volume
The space this entry takes up.
public
null|array<string|int, mixed>|int|float|QuantitativeValue
$volume
The twin of HasPhysicalMeasures::$weight, and read the same way : a
plain number when the unit is implicit, a QuantitativeValue when it
is stated ({ value: 1.403, unitCode: "MTQ" }) ; an array is hydrated as
the latter and sits there until it is.
On a line, the quantity multiplied by what the unit it is counted in occupies. Summed over the lines, it gives the document's own volume.
Tags
Attributes
- #[HydrateAs]
- \org\schema\QuantitativeValue::class
$weight
What this entry weighs.
public
null|array<string|int, mixed>|int|float|QuantitativeValue|Mass
$weight
On a line, the quantity multiplied by what the unit it is counted in weighs. Summed over the lines, it gives the document's own weight.
A plain number carries it when the unit is implicit, a
QuantitativeValue when the unit is stated
({ value: 537.6, unitCode: "KGM" }) ; an array is hydrated as the
latter. The same union as
BusinessDocument::$weight, so
a weight reads the same wherever it is met.
Deliberately neutral about gross and net. Should the distinction ever be
needed, it belongs to the additionalType of a QuantitativeValue, never
to a second property — two weights held in parallel eventually disagree.
Tags
Attributes
- #[HydrateAs]
- \org\schema\QuantitativeValue::class
$atContext
The JSON-LD `@context` value.
protected
string|null
$atContext
= null
Default is https://schema.org.
$atType
The JSON-LD `@type` value.
protected
string|null
$atType
= null
This can be manually set or automatically inferred from the class name.
$DEFAULT_JSON_SERIALIZE_OPTIONS
The default static jsonSerialize options (class-level configuration).
protected
static array<string|int, mixed>
$DEFAULT_JSON_SERIALIZE_OPTIONS
= []
$schemaTypeCache
Internal cache for resolved schema types.
private
static array<string, string>
$schemaTypeCache
= []
Methods
__construct()
Constructor to hydrate public properties from an array or stdClass.
public
__construct([array<string|int, mixed>|object|null $init = null ]) : mixed
This allows objects to be quickly populated with associative data without manually setting each property.
Parameters
- $init : array<string|int, mixed>|object|null = null
-
A data array or object used to initialize the instance. Keys must match public property names.
Tags
getJsonSerializeOptions()
Returns the default JSON serialization options.
public
getJsonSerializeOptions() : array<string|int, mixed>
This method determines how the jsonSerialize() output is reduced or compressed, etc.
It can be overridden in child classes to customize serialization behavior.
Return values
array<string|int, mixed> —Returns the reduction/compression options for JSON serialization.
getSchemaType()
Returns the fully qualified URI of the schema type.
public
static getSchemaType() : string
This method combines the class's CONTEXT constant with its short name
to produce a globally unique identifier for the entity type.
- It uses Late Static Binding to ensure the correct context is retrieved even when called from an inherited class (e.g., Corporation vs. Affiliate).
- Performance Optimization:
Results are stored in a static cache (
$schemaTypeCache) to avoid redundant Reflection calls during the same execution lifecycle.
Return values
string —The absolute URI of the type (e.g., "https://schema.org/Thing"). ** @example
echo Thing::getSchemaType(); // https://schema.org/Thing
echo Affiliate::getSchemaType(); // https://schema.oihana.xyz/Pagination
jsonSerialize()
Serializes the current object into a JSON-LD array.
public
jsonSerialize() : array<string|int, mixed>
Includes public properties, the JSON-LD @context and @type.
Null values are automatically removed.
Tags
Return values
array<string|int, mixed> —JSON-LD representation of the object.
withAtContext()
Sets the internal JSON-LD `@context` attribute.
public
withAtContext(string $context) : $this
Useful if you need a custom JSON-LD context.
Parameters
- $context : string
-
Optional JSON-LD context.
Return values
$thiswithAtType()
Sets the internal JSON-LD `@type` attribute.
public
withAtType(string $type) : $this
Allows overriding the default type inferred from the class.
Parameters
- $type : string
-
Optional JSON-LD type
Return values
$thiswithJSONLDMeta()
Initializes both JSON-LD metadata: `@type` and `@context`.
public
withJSONLDMeta([string|null $atType = null ][, string|null $atContext = null ]) : $this
Can be called from constructor or later to override default values.
Parameters
- $atType : string|null = null
-
Optional JSON-LD type
- $atContext : string|null = null
-
Optional JSON-LD context