Sales Order Phases
Sales Order Phases define the workflow stages for Sales Orders. Use this endpoint to query the available phases and their IDs, which are needed to update the phase of a sales order.
Use the Datastore_Phase_ActivitySalesOrder endpoint to query phases for this activity type.
Endpoints
List Sales Order Phases
GET
/v1/odata/Datastore_Phase_ActivitySalesOrderSingle Phase
GET
/v1/odata/Datastore_Phase_ActivitySalesOrder({id})Fields
Inherited Fields (from Phase)
See Phase Fields for all inherited fields including Name, Code, Icon, ActionName, IsAssignable, and IsTerminal.
Relationships
| Relationship | Target Entity | Cardinality | Description |
|---|---|---|---|
| SalesOrder | Activity_SalesOrder | 1:N | SalesOrder |
Expanding Relationships
GET
/v1/odata/Datastore_Phase_ActivitySalesOrder({id})?$expand=SalesOrderNavigating Relationships
GET
/v1/odata/Datastore_Phase_ActivitySalesOrder({id})/SalesOrderUsage
Query Available Phases
GET /v1/odata/Datastore_Phase_ActivitySalesOrder?$select=Name,Code,IsTerminal
Update Phase on Sales Order
POST /v1/odata/ActivitySalesOrder
{
"ID": "{activity-id}",
"Phase": {
"ID": "{phase-id}"
}
}
Filtering Examples
GET
/v1/odata/Datastore_Phase_ActivitySalesOrder?$filter=Name eq '{Name}'&$top={top}GET
/v1/odata/Datastore_Phase_ActivitySalesOrder?$filter=Code eq '{Code}'&$top={top}GET
/v1/odata/Datastore_Phase_ActivitySalesOrder?$filter=IsTerminal eq {IsTerminal}&$top={top}GET
/v1/odata/Datastore_Phase_ActivitySalesOrder?$filter=IsAssignable eq {IsAssignable}&$top={top}GET
/v1/odata/Datastore_Phase_ActivitySalesOrder?$filter=IsDefault eq {IsDefault}&$top={top}