[Not Implemented] Create order | Cata API

curl -X POST http://localhost:8080/api/v1/orders \
     -H "X-Tenant-ID: string" \
     -H "X-Store-ID: string" \
     -H "X-Api-Key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "posType": "DELIVERECT",
  "storeId": "string",
  "order": {
    "id": "string",
    "storeId": "string",
    "items": [
      {
        "id": "string",
        "name": "string",
        "quantity": 5839,
        "unitPrice": {
          "amount": 1299,
          "currency": "USD"
        },
        "externalId": "string",
        "description": "string",
        "totalPrice": {
          "amount": 1299,
          "currency": "USD"
        },
        "modifiers": [
          {
            "id": "string",
            "name": "string",
            "price": {
              "amount": 1299,
              "currency": "USD"
            },
            "quantity": 1,
            "externalId": "string",
            "metadata": {
              "key_0": 3429
            }
          },
          {
            "id": "string",
            "name": "string",
            "price": {
              "amount": 1299,
              "currency": "USD"
            },
            "quantity": 1,
            "externalId": "string",
            "metadata": {
              "key_0": 2256
            }
          }
        ],
        "specialInstructions": "string",
        "metadata": {
          "key_0": 6640
        }
      },
      {
        "id": "string",
        "name": "string",
        "quantity": 2274,
        "unitPrice": {
          "amount": 1299,
          "currency": "USD"
        },
        "externalId": "string",
        "description": "string",
        "totalPrice": {
          "amount": 1299,
          "currency": "USD"
        },
        "modifiers": [
          {
            "id": "string",
            "name": "string",
            "price": {
              "amount": 1299,
              "currency": "USD"
            },
            "quantity": 1,
            "externalId": "string",
            "metadata": {
              "key_0": 1,
              "key_1": 7379,
              "key_2": "string"
            }
          },
          {
            "id": "string",
            "name": "string",
            "price": {
              "amount": 1299,
              "currency": "USD"
            },
            "quantity": 1,
            "externalId": "string",
            "metadata": {
              "key_0": 7864,
              "key_1": "string",
              "key_2": 3930.558840761544,
              "key_3": "string",
              "key_4": "string"
            }
          }
        ],
        "specialInstructions": "string",
        "metadata": {
          "key_0": 1,
          "key_1": 4626.262390778475,
          "key_2": true,
          "key_3": "string"
        }
      }
    ],
    "totalAmount": {
      "amount": 1299,
      "currency": "USD"
    },
    "status": "CONFIRMED",
    "externalId": "string",
    "channelOrderId": "string",
    "channelName": "string",
    "customer": {
      "id": "string",
      "name": "string",
      "email": "cZs8@wAHRILMREhMfdxLVVBecpisRHtUv.rje",
      "phone": "string",
      "address": {
        "street": "123 Main St",
        "city": "New York",
        "state": "NY",
        "postalCode": "10001",
        "country": "US",
        "latitude": 3823.7132927288653,
        "longitude": 3858.1866618285308
      }
    },
    "subtotal": {
      "amount": 1299,
      "currency": "USD"
    },
    "tax": {
      "amount": 1299,
      "currency": "USD"
    },
    "tip": {
      "amount": 1299,
      "currency": "USD"
    },
    "deliveryFee": {
      "amount": 1299,
      "currency": "USD"
    },
    "orderType": "PREORDER",
    "scheduledFor": "1984-02-24T17:05:12.508Z",
    "estimatedDeliveryTime": "1971-03-02T15:37:37.022Z",
    "pickupTime": "1980-11-01T08:34:02.898Z",
    "deliveryAddress": {
      "street": "123 Main St",
      "city": "New York",
      "state": "NY",
      "postalCode": "10001",
      "country": "US",
      "latitude": 2628.675700176253,
      "longitude": 2362.338566860771
    },
    "notes": "string",
    "metadata": {
      "key_0": "string"
    },
    "createdAt": "1976-04-06T05:01:15.237Z",
    "updatedAt": "1963-03-09T03:31:37.668Z"
  },
  "tenantId": "string"
}'

Status: Not Implemented — returns 501

Creates a new order in the specified third-party POS system on behalf of Cata.

This is an async operation. The order is queued and sent to the external POS via the appropriate adapter. Processing time varies depending on the POS system and network conditions. The endpoint returns immediately with a jobId.

Retries: Failed attempts are automatically retried with backoff. All attempts are logged.

Tracking: Use GET /api/v1/jobs/{jobId} to poll current status, or register a webhook to be notified automatically when the order is confirmed or fails.

Webhook events fired:

order.created — order successfully accepted by the POS
order.failed — all retry attempts exhausted, order could not be created

Authentication

X-Api-Keystring

API Key authentication via header

Request

This endpoint expects an object.

posTypestringRequired

storeIdstringRequired

orderobjectRequired

tenantIdstringRequired

Response

Accepted

jobIdstring

statusstring

submittedAtdatetime

Errors

400

Bad Request Error

401

Unauthorized Error

422

Unprocessable Entity Error

Authentication

Headers

Request

Response

Errors