Skip to main content

OrderFulfillmentTask

Description

Represents a fulfillment action on a SalesOrder or LineItem. Used by ValkyrAI workflows to track digital delivery, invoice generation, and post-order actions. Links order → fulfillment state → workflow execution. One OrderFulfillmentTask per fulfillable LineItem; may trigger DownloadAccess creation.

Properties

NameTypeDescriptionNotes
salesOrderIdUUIDSalesOrder being fulfilled.
salesOrderSalesOrder[optional]
fulfillmentTypeFulfillmentTypeEnumFulfillment action type.
statusStatusEnumCurrent fulfillment lifecycle state.[optional]
workflowIdUUIDValkyrAI Workflow orchestrating this fulfillment (if async).[optional]
workflowWorkflow[optional]
assignedToUUIDStaff member assigned to this fulfillment task (if manual).[optional]
attemptsIntegerNumber of fulfillment attempts.[optional]
lastErrorStringError message from most recent failed attempt.[optional]
completedAtOffsetDateTimeWhen fulfillment completed successfully.[optional]
metadataStringContext data for the fulfillment (e.g., shipping address, tracking ID, email delivery status, download link validity period).[optional]
idUUIDUnique identifier for object in the system[optional] [readonly]
ownerIdUUIDUUID of owner of the object in the system[optional] [readonly]
createdDateOffsetDateTimeDate of object creation[optional] [readonly]
keyHashStringData, including hash of the key(s) used to encrypt this record.[optional] [readonly]
lastAccessedByIdUUIDLast user to access object[optional] [readonly]
lastAccessedDateOffsetDateTimeTimestamp of last access of object[optional] [readonly]
lastModifiedByIdUUIDUnique identifier for user who last modifed the object in the system[optional] [readonly]
lastModifiedDateOffsetDateTimeDate of last object modification[optional] [readonly]

Enum: FulfillmentTypeEnum

NameValue
DIGITAL_DELIVERY"digital_delivery"
PHYSICAL_SHIPMENT"physical_shipment"
SERVICE_ACTIVATION"service_activation"
INVOICE_GENERATION"invoice_generation"
SUBSCRIPTION_PROVISION"subscription_provision"
ENTITLEMENT_GRANT"entitlement_grant"
OTHER"other"

Enum: StatusEnum

NameValue
PENDING"pending"
IN_PROGRESS"in_progress"
COMPLETED"completed"
FAILED"failed"
CANCELED"canceled"

Implemented Interfaces

  • Serializable

Generated Version Details

~value
GENERATOR VERSIONcom.valkyrlabs:ValkyrAI API 1.0.1-SNAPSHOT
API ARTIFACTcom.valkyrlabs.valkyrai-api.jar
GENERATOR VERSIONorg.openapitools.openapi-generator:7.5.0
GENERATOR CLASSorg.openapitools.codegen.languages.SpringCodegen
GENERATED DATE2025-12-03T11:13:18.492704-08:00[America/Los_Angeles]