PublicationReceipt

Part of Diagnostics & preflight in the Python API reference.

Related guidance: getting-started/preflight, how-to/troubleshooting.

Runnable examples: preflight.py.

from picogrid_ecn_client import PublicationReceipt

Confirm the strongest safe MQTT delivery fact for one publication.

PublicationReceipt(
    *,
    operation_id: UUID,
    kind: PublicationKind,
    entity_id: UUID,
    qos: Literal[0, 1],
    delivery_phase: DeliveryPhase,
    accepted_at: datetime,
)

Source · models/diagnostics.py

Fields

Name	Type	Required	Default	Constraints	Description
operation_id	UUID	yes	—	—	Client-generated UUID correlating the local publication operation.
kind	PublicationKind	yes	—	—	Whether the completed publication carried an entity or location.
entity_id	UUID	yes	—	—	UUID of the published entity.
qos	Literal[0, 1]	yes	—	—	MQTT QoS used for this publication: zero or one.
delivery_phase	DeliveryPhase	yes	—	—	Strongest safe delivery fact established before returning the receipt.
accepted_at	datetime	yes	—	—	UTC local-send completion time for QoS 0 or PUBACK receipt time for QoS 1.