External Order Creation

The External Order Creation feature allows tenants and integrators to create fully-processed orders in SCAYLE Order Management System (OMS) that originate from external systems such as marketplaces (e.g., Zalando, Amazon) or in-store systems.

The API was designed to unify order flows across external sales channels while ensuring data consistency, scalability, and analytics visibility.

Key Features

1. Unified External Order Creation

A single, secure API endpoint for ingesting external orders (marketplace, in-store, third-party).
Supports complete order lifecycles: creation → confirmation → delegation → fulfillment.
Orders appear in the SCAYLE Panel and downstream APIs (Admin API, Cloud API, Webhooks).

2. Channel Management

Each order is associated with a Channel Key representing its origin (e.g., marketplace_zalando_de, store_hamburg) which is configured via Channel Configuration on SCAYLE Panel
This allow users to group orders, generate reports and perform downstream operations depending on channel.

3. Customer Creation & Assignment

Flexible customer resolution during order creation:
Orders seamlessly linked to customers, ensuring they appear in the Customer Account Area alongside regular online orders.
Guest checkout: Automatically create guest customers when no pre-existing customer record exists.

4. Price Override Support

External systems can submit final customer-paid prices (unit prices, taxes, totals).
This feature can be controlled on the SCAYLE Panel
External prices flow consistently into all downstream integrations like Admin API, Webhooks, etc.

5. Robust Error Handling

Order creation aborts with clear error codes and message if:
- Invalid/missing customer data.
- No available items remain in stock.
Partial acceptance supported: if at least one item is valid, the order is created.

6. SCAYLE Panel & Analytics Integration

Orders created via External Order Creation API are fully visible in the SCAYLE Panel:
- Order overview lists.
- Order detail pages.
- Analytics dashboards segmented by Channel Type and Channel Name.
Enables administrators to monitor cross-channel performance.

Typical Use Cases

Marketplaces: Import fully-paid orders from Tradebyte into SCAYLE OMS.
In-store systems: Sync physical store purchases with SCAYLE OMS and customer accounts.

Getting Started

Setup new Shop Country

Create a new Shop Country via SCAYLE Panel.

Configure the shop by adding Payment Methods, Collection points, Carriers, Shipping options, Email Templates etc..

Configure Channels

Create channels via SCAYLE Panel

Assign channel keys (e.g., amazon_pl, zalando_de, store_1142) to shop countries.

Enable features like price override, emails, invoices.

Create Orders via API

Call the External Order Creation endpoint with:

Order items

Customer data

Payment data

Channel reference

Optional external prices

Maintain Orders

Retrieve orders via Admin API with Channel Reference

Listen to web-hooks events and perform actions based on Channel Reference

View In-store/marketplace orders on SCAYLE Panel

FAQs

Q: Can I create an order without a channel?
No. Every order must be linked to a valid channel (channel.id or channel.key). Orders without channels are rejected.

Q: Can I use both SCAYLE-calculated prices and external override prices in the same order?
No. An order must use one method consistently. Mixing calculated and external prices leads to validation errors.

Q: Do external orders trigger emails and invoices?
Yes, but behavior depends on the channel settings:

If Disable Customer Email is checked → no customer emails sent.
If Disable Invoice is checked → no invoices are generated.

Q: Can I delete a channel that was used for an order?
No. Channels linked to orders cannot be deleted (API returns 409 Conflict).

Q: Are collection points supported as a fulfillment option?
Not in the current release. Orders support Home delivery only, but future iterations may introduce pickup/collection point handling.