Skip to main content

Workers & Tasks

Workers are people who fulfill orders. Tasks are the discrete jobs assigned to them.

Workers

A worker belongs to a merchant and has:

  • RoleDELIVERY, PICKUP, SERVICE, INVENTORY, CLEANUP
  • StatusACTIVE, INACTIVE, SUSPENDED
  • Schedule — weekly availability
  • Earnings — tracked per task and aggregated
query {
listProviderWorkers(providerId: "mer_42") {
id
name
role
status
earnings
}
}

Tasks

A task is a fulfillment job tied to an order and a worker:

ASSIGNED → IN_PROGRESS → COMPLETED
→ BLOCKED
→ CANCELLED
FieldMeaning
typeDELIVERY, PICKUP, SERVICE, INVENTORY, CLEANUP
statusASSIGNED, IN_PROGRESS, BLOCKED, COMPLETED, CANCELLED
priorityLOW, MEDIUM, HIGH, URGENT
dueAtExpected completion time
completedAtActual completion time
query {
listWorkerTasks(providerId: "mer_42") {
id
type
status
priority
orderId
workerId
dueAt
}
}

Next steps