> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Process ACP order asynchronously as a background job

> ACP order queued for asynchronous processing

### Path parameters

<ParamField path="tenant_id" type="string" required>
  Tenant identifier
</ParamField>

### Request body

`object`

<ParamField body="orderId" type="string" required>
  Unique order identifier from the source system
</ParamField>

<ParamField body="orderNumber" type="string" required>
  Order number for display
</ParamField>

<ParamField body="source" type="string">
  Source system identifier (e.g., 'shopify', 'manual', 'agent'). Default `agent`
</ParamField>

<ParamField body="customer" type="object" required />

<ParamField body="shippingAddress" type="object" required />

<ParamField body="billingAddress" type="object" />

<ParamField body="lineItems" type="object[]" required>
  Order line items
</ParamField>

<ParamField body="createdAt" type="string (date-time)">
  Order creation timestamp (defaults to now)
</ParamField>

<ParamField body="tags" type="string[]">
  Order tags for categorization
</ParamField>

<ParamField body="shippingMethod" type="string">
  Shipping method
</ParamField>

<ParamField body="notes" type="string">
  Special instructions or notes
</ParamField>

<ParamField body="routing" type="object">
  Routing configuration - which systems to send the order to
</ParamField>

<ParamField body="metadata" type="object">
  Additional metadata
</ParamField>

### Response

`object`

<ResponseField name="jobId" type="string (uuid)" required>
  Job ID to track progress
</ResponseField>

<ResponseField name="status" type="string" required>
  Current job status
</ResponseField>

<ResponseField name="message" type="string" required>
  Message
</ResponseField>

### Status codes

| Code  | Meaning                                      |
| ----- | -------------------------------------------- |
| `202` | ACP order queued for asynchronous processing |
| `401` | Unauthorized                                 |
| `422` | Validation error                             |

<RequestExample>
  ```bash cURL theme={null}
  curl --request POST \
    --url 'https://api.sync.stateset.com/v1/tenants/{tenant_id}/acp/orders/async' \
    --header 'x-stateset-api-key: YOUR_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{
    "orderId": "string",
    "orderNumber": "ORD-10042",
    "source": "string",
    "customer": {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "email": "ada.lovelace@example.com",
      "firstName": "Ada",
      "lastName": "Lovelace",
      "phone": "+1 415 555 0142",
      "netsuiteId": "string"
    },
    "shippingAddress": {
      "name": "Two-Person Tent",
      "company": "Acme Outdoors",
      "address1": "548 Market St",
      "address2": "Suite 400",
      "city": "San Francisco",
      "state": "CA",
      "postalCode": "94107",
      "countryCode": "US",
      "phone": "+1 415 555 0142"
    },
    "billingAddress": {
      "name": "Two-Person Tent",
      "company": "Acme Outdoors",
      "address1": "548 Market St",
      "address2": "Suite 400",
      "city": "San Francisco",
      "state": "CA",
      "postalCode": "94107",
      "countryCode": "US",
      "phone": "+1 415 555 0142"
    },
    "lineItems": [
      {
        "sku": "SKU-TENT-2P-GRN",
        "title": "Replacement tent pole set",
        "quantity": 2,
        "price": 49,
        "variantId": "string",
        "netsuiteItemId": "string",
        "weight": 1.2
      }
    ],
    "createdAt": "2026-08-31T14:22:05Z",
    "tags": [
      "priority"
    ],
    "shippingMethod": "ground",
    "notes": "Two-person tent, green — replacement for damaged pole set.",
    "routing": {
      "sendToFulfillment": true,
      "sendToErp": true,
      "createInStateset": true,
      "fulfillmentProvider": "string",
      "dclLocation": "string"
    },
    "metadata": {}
  }'
  ```
</RequestExample>

<ResponseExample>
  ```json 202 theme={null}
  {
    "jobId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "status": "queued",
    "message": "Two-person tent, green — replacement for damaged pole set."
  }
  ```
</ResponseExample>