# Associate Orders

Associate Orders allow [Associates](https://docs.commercetools.com/api/projects/business-units.md#associate) to interact with [Orders](https://docs.commercetools.com/api/projects/orders.md) on behalf of a [Business Unit](https://docs.commercetools.com/api/projects/business-units.md).

Associates can view, create, and update Orders on behalf of a Business Unit. The actions a given Associate is allowed to perform depends on the specific [roles and permissions](https://docs.commercetools.com/api/associates-overview.md) they hold within the Business Unit.

## Get Order in BusinessUnit as Associate

The Associate must have the `ViewMyOrders` or `ViewOthersOrders` [Permission](https://docs.commercetools.com/urn?urn=ctp%3Aapi%3Atype%3APermission). If a required [Permission](https://docs.commercetools.com/urn?urn=ctp%3Aapi%3Atype%3APermission) is missing, an [AssociateMissingPermission](https://docs.commercetools.com/urn?urn=ctp%3Aapi%3Atype%3AAssociateMissingPermissionError) error is returned.

### Get Order in BusinessUnit by ID as Associate

See API endpoint definition [GET /\{projectKey}/as-associate/\{associateId}/in-business-unit/key=\{businessUnitKey}/orders/\{id}](https://docs.commercetools.com/api/projects/associate-orders.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fas-associate%2F%7BassociateId%7D%2Fin-business-unit%2Fkey%3D%7BbusinessUnitKey%7D%2Forders%2F%7Bid%7D%3AGET).

### Get Order in BusinessUnit by OrderNumber as Associate

See API endpoint definition [GET /\{projectKey}/as-associate/\{associateId}/in-business-unit/key=\{businessUnitKey}/orders/order-number=\{orderNumber}](https://docs.commercetools.com/api/projects/associate-orders.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fas-associate%2F%7BassociateId%7D%2Fin-business-unit%2Fkey%3D%7BbusinessUnitKey%7D%2Forders%2Forder-number%3D%7BorderNumber%7D%3AGET).

## Query Orders in BusinessUnit as Associate

See API endpoint definition [GET /\{projectKey}/as-associate/\{associateId}/in-business-unit/key=\{businessUnitKey}/orders](https://docs.commercetools.com/api/projects/associate-orders.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fas-associate%2F%7BassociateId%7D%2Fin-business-unit%2Fkey%3D%7BbusinessUnitKey%7D%2Forders%3AGET).

## Check if Order exists in BusinessUnit as Associate

### Check if Order exists in BusinessUnit by ID as Associate

See API endpoint definition [HEAD /\{projectKey}/as-associate/\{associateId}/in-business-unit/key=\{businessUnitKey}/orders/\{id}](https://docs.commercetools.com/api/projects/associate-orders.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fas-associate%2F%7BassociateId%7D%2Fin-business-unit%2Fkey%3D%7BbusinessUnitKey%7D%2Forders%2F%7Bid%7D%3AHEAD).

### Check if Order exists in BusinessUnit by OrderNumber as Associate

See API endpoint definition [HEAD /\{projectKey}/as-associate/\{associateId}/in-business-unit/key=\{businessUnitKey}/orders/order-number=\{orderNumber}](https://docs.commercetools.com/api/projects/associate-orders.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fas-associate%2F%7BassociateId%7D%2Fin-business-unit%2Fkey%3D%7BbusinessUnitKey%7D%2Forders%2Forder-number%3D%7BorderNumber%7D%3AHEAD).

### Check if Order exists in BusinessUnit by Query Predicate as Associate

See API endpoint definition [HEAD /\{projectKey}/as-associate/\{associateId}/in-business-unit/key=\{businessUnitKey}/orders](https://docs.commercetools.com/api/projects/associate-orders.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fas-associate%2F%7BassociateId%7D%2Fin-business-unit%2Fkey%3D%7BbusinessUnitKey%7D%2Forders%3AHEAD).

## Create Order in BusinessUnit as Associate

The Associate must have the `CreateMyOrders` or `CreateOthersOrders` [Permission](https://docs.commercetools.com/urn?urn=ctp%3Aapi%3Atype%3APermission). If a required [Permission](https://docs.commercetools.com/urn?urn=ctp%3Aapi%3Atype%3APermission) is missing, an [AssociateMissingPermission](https://docs.commercetools.com/urn?urn=ctp%3Aapi%3Atype%3AAssociateMissingPermissionError) error is returned.

### Create Order in BusinessUnit from Cart as Associate

See API endpoint definition [POST /\{projectKey}/as-associate/\{associateId}/in-business-unit/key=\{businessUnitKey}/orders](https://docs.commercetools.com/api/projects/associate-orders.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fas-associate%2F%7BassociateId%7D%2Fin-business-unit%2Fkey%3D%7BbusinessUnitKey%7D%2Forders%3APOST).

### Create Order in BusinessUnit from Quote as Associate

See API endpoint definition [POST /\{projectKey}/as-associate/\{associateId}/in-business-unit/key=\{businessUnitKey}/orders/quotes](https://docs.commercetools.com/api/projects/associate-orders.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fas-associate%2F%7BassociateId%7D%2Fin-business-unit%2Fkey%3D%7BbusinessUnitKey%7D%2Forders%2Fquotes%3APOST).

## Update Order in BusinessUnit as Associate

The Associate must have the `UpdateMyOrders` or `UpdateOthersOrders` [Permission](https://docs.commercetools.com/urn?urn=ctp%3Aapi%3Atype%3APermission). If a required [Permission](https://docs.commercetools.com/urn?urn=ctp%3Aapi%3Atype%3APermission) is missing, an [AssociateMissingPermission](https://docs.commercetools.com/urn?urn=ctp%3Aapi%3Atype%3AAssociateMissingPermissionError) error is returned.

### Update Order in BusinessUnit by ID as Associate

See API endpoint definition [POST /\{projectKey}/as-associate/\{associateId}/in-business-unit/key=\{businessUnitKey}/orders/\{id}](https://docs.commercetools.com/api/projects/associate-orders.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fas-associate%2F%7BassociateId%7D%2Fin-business-unit%2Fkey%3D%7BbusinessUnitKey%7D%2Forders%2F%7Bid%7D%3APOST).

### Update Order in BusinessUnit by OrderNumber as Associate

See API endpoint definition [POST /\{projectKey}/as-associate/\{associateId}/in-business-unit/key=\{businessUnitKey}/orders/order-number=\{orderNumber}](https://docs.commercetools.com/api/projects/associate-orders.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fas-associate%2F%7BassociateId%7D%2Fin-business-unit%2Fkey%3D%7BbusinessUnitKey%7D%2Forders%2Forder-number%3D%7BorderNumber%7D%3APOST).

## Related pages

- [Section overview page](https://docs.commercetools.com/api.md)
- [Previous page: Associate Carts](https://docs.commercetools.com/api/projects/associate-carts.md)
- [Next page: Associate Quote Requests](https://docs.commercetools.com/api/projects/associate-quote-requests.md)