Unified Order API

One API call instead of many: create Xentral orders with a single request. Customer, items, shipping - all in one call.

Submit requestAll Add-Ons

The Problem with the Xentral API

The Xentral API requires multiple sequential calls to create a single order
The customer must be looked up and possibly created before the order can be placed
Error handling across multiple API calls is complex and error-prone
External systems need to understand and replicate Xentral's internal logic

The Solution: One API for Everything

A single API request creates the complete order
Customer is found or created automatically - you just send the data
Centralised validation and error handling with clear error messages
External systems send only order data - the proxy API takes care of the rest

That's How Easy It Is

One request - one order. No complex logic in your system.

// Vorher: 4+ API-Calls nötig
// 1. Kunde suchen
// 2. Wenn nicht gefunden: Kunde anlegen
// 3. Artikel-IDs ermitteln
// 4. Auftrag erstellen

// Nachher: 1 API-Call
POST /api/orders
{
  "customer": {
    "email": "kunde@example.com",
    "name": "Max Mustermann",
    "street": "Musterstraße 1",
    "zip": "12345",
    "city": "Musterstadt",
    "country": "DE"
  },
  "items": [
    { "sku": "ART-001", "quantity": 2 },
    { "sku": "ART-002", "quantity": 1 }
  ],
  "shipping": "dhl_standard",
  "payment": "paypal",
  "reference": "SHOP-12345"
}

How it Works

From request to finished order in Xentral - fully automated.

1

Request received

External system sends order data to the Unified API.

2

Validation

Data is checked: required fields, item numbers, format.

3

Find or create customer

Customer is looked up by email. If not found: created automatically.

4

Order created

Order is created in Xentral and the order number is returned.

All Features at a Glance

  • One request for everything: customer + order + line items

  • Automatic customer lookup by email or customer number

  • Customer creation if not found (configurable)

  • Item validation before order creation

  • Configurable default values (project, payment method, etc.)

  • Idempotency support for safe retries

  • Detailed error messages with context

  • Webhook callback on order creation (optional)

Typical Use Cases

Shop Integration

WooCommerce, Shopware or a custom shop sends orders directly to Xentral - without complex plugin logic.

Marketplace Connection

Connect Amazon, eBay or other marketplaces via your own middleware - the Unified API handles the Xentral logic.

B2B Portal

A dealer portal or field-sales app creates orders directly in Xentral - via a simple API interface.

Pricing

On request

The price depends on your order volume and the features required. In a free initial consultation we analyse your needs.

Request a quote

Frequently Asked Questions about the Unified Order API

The API first searches for the email address in Xentral. Optionally, it can also search by customer number or other fields. If no customer is found, a new one is created automatically - provided this option is enabled.
On errors a detailed error message is returned that describes exactly what went wrong. For example: "Item SKU-123 not found" or "Required field 'email' is missing". The order is only created if all validations pass successfully.
Yes, that is one of the primary use cases. Shops such as WooCommerce, Shopware or custom shops can send orders directly to Xentral via the Unified API, without having to implement the complex Xentral API logic themselves.
The API supports idempotency. You can include a unique reference (e.g. the shop order number). If an order with that reference already exists, no new one is created - the existing order is returned instead.
All relevant order data: customer data (name, address, email), line items (item number, quantity, optional price), shipping (shipping method), payment (payment method, status), as well as custom fields and internal notes.
The price depends on your order volume and the features required. In an initial consultation we clarify your needs and I will prepare an individual quote.

You Might Also Be Interested In

API Development

Custom API development for Xentral

Learn more

Integrations

Connect shops, marketplaces and more

Learn more

Interested in the Unified Order API?

Let's analyse your needs in a free consultation.

Schedule a call