[Not Implemented] Create order

View as MarkdownOpen in Claude
> **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

Headers

X-Tenant-IDstringOptional
Tenant identifier
X-Store-IDstringOptional
Store identifier

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