DispatchReceipt

Part of Tasks in the Python API reference.

Related guidance: concepts/tasks, how-to/receive-local-tasks, how-to/dispatch-local-tasks, quickstarts/effector-handler.

Runnable examples: receive_task.py, dispatch_task.py, receive_mesh_task.py, dispatch_mesh_task.py.

from picogrid_ecn_client import DispatchReceipt

Confirm broker acceptance of a fire-and-forget task dispatch.

DispatchReceipt(
    *,
    task_id: str,
    qos: Literal[1] = 1,
    delivery_phase: DeliveryPhase = DeliveryPhase.BROKER_ACCEPTED,
    accepted_at: datetime,
)

Source · models/diagnostics.py

Fields

Name	Type	Required	Default	Constraints	Description
task_id	str	yes	—	min_length=1, max_length=128	Task correlation identifier, from 1 through 128 characters.
qos	Literal[1]	no	1	—	MQTT QoS used for fire-and-forget task publication; always one.
delivery_phase	DeliveryPhase	no	DeliveryPhase.BROKER_ACCEPTED	—	Broker-accepted delivery phase established by PUBACK.
accepted_at	datetime	yes	—	—	Timezone-aware UTC client-clock observation recorded after the task publish completed with a non-failure PUBACK.