/bff/order/create

Creates a new order from admin panel (POS mode). By default creates a draft/cart that can be edited before confirmation. Set startAsCart=false to create a confirmed order immediately.

OrderpostBffOrderCreate

Parameters

15 body

15 total

Body · 15

orderGroupIdstring

Order group code (e.g., "default", "eshop").

customerobject11 fields

Customer information for the order.

itemsobject[]10 fields

List of order items.

localestring

Communication locale code used to filter content.

Supported locales: cs, en, fr, it, pl, de, sk, sv, es, zh, ja, uk, da.

Length: 2–2

currencystring

Currency code (e.g., "CZK", "EUR"). Defaults to organisation currency.

salenumber

Global discount amount for the entire order.

paymentMethodstring | string

Payment method: "credits" for credit balance, "money" for standard payment.

deliveryPricenumber

Delivery/shipping price.

paymentPricenumber

Payment processing fee.

internalNoticestring

Internal note visible only to staff.

publicNoticestring

Public note visible to customer.

tagsobject

Tags to attach to the order.

ignoreNotificationboolean

Skip sending order confirmation email. Defaults to true.

startAsCartboolean

Create order as draft/cart (true) or as new order (false). Defaults to false.

preventAutoPaymentboolean

Prevent automatic marking as paid when order price is 0. Defaults to true.

Request

POST /bff/order/create

post

curl -X POST "https://api.bizkithub.com/bff/order/create" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "orderGroupId": "example_orderGroupId",
  "customer": {
    "email": "jan@barasek.com",
    "firstName": "example_firstName",
    "lastName": "example_lastName",
    "phone": "example_phone",
    "companyName": "example_companyName",
    "companyRegistrationNumber": "example_companyRegistrationNumber",
    "taxIdentificationNumber": "example_taxIdentificationNumber",
    "streetAddress": "example_streetAddress",
    "city": "example_city",
    "postalCode": "example_postalCode",
    "country": "example_country"
  },
  "items": [
    {
      "label": "example_label",
      "price": 0,
      "vat": 0,
      "count": 0,
      "sale": 0,
      "unit": "example_unit",
      "productCode": "example_productCode",
      "variantCode": "example_variantCode",
      "eventCode": "example_eventCode",
      "creditAmount": 0
    }
  ],
  "locale": "cs",
  "currency": "example_currency",
  "sale": 0,
  "deliveryPrice": 0,
  "paymentPrice": 0,
  "internalNotice": "example_internalNotice",
  "publicNotice": "example_publicNotice",
  "tags": {},
  "ignoreNotification": false,
  "startAsCart": false,
  "preventAutoPayment": false
}'

Response

Order created successfully.

{
  "success": true,
  "hash": "example_hash",
  "orderNumber": "example_orderNumber"
}

All response codes

1 status code documented

Need an API key?

All BizKitHub API endpoints require authentication via API key.

Get API Key