createOrder

Создание заказа в хранилище заказов. 🔐 Этот метод требует авторизации.

Описание

Метод добавит язык по умолчанию в тело запроса. Если вы хотите изменить язык, просто передайте его в качестве второго аргумента. Он создает заказ в указанном хранилище заказов. Возвращает Promise, который разрешается в объект IBaseOrdersEntity.

Orders.createOrder(

marker, body, body.formIdentifier, body.paymentAccountIdentifier, body.formData, formData.marker, formData.type, formData.value, body.products, langCode

);

Схема параметров

Схема

marker(обязательно): string
Текстовый идентификатор объекта хранилища заказов
пример: "order_storage_1"

body(обязательно): IOrderData
Объект для создания заказа
пример:

{
  "formIdentifier": "bar-orders-form",
  "paymentAccountIdentifier": "usd-payment",
  "formData": {
    "marker": "name_1",
    "value": "Name",
    "type": "string"
  },
  "products": [
    {
      "productId": 1,
      "quantity": 2
    }
  ]
}

body.formIdentifier(обязательно): string
Текстовый идентификатор объекта формы, связанного с репозиторием заказов.
пример: "bar-orders-form"

body.paymentAccountIdentifier(обязательно): string
Текстовый идентификатор объекта платежа, связанного с репозиторием заказов.
пример: "payment-1"

body.formData(обязательно): IOrdersFormData | IOrdersFormData[]
Данные формы, связанные с репозиторием заказов.
пример:

[
  {
    "marker": "name_1",
    "value": "Name",
    "type": "string"
  }
]

formData.marker(обязательно): string
Маркер поля формы.
пример: "name_1"

formData.type(обязательно): string
Тип значения.
пример: "string"

formData.value(обязательно): string
Значение.
пример: "Name"

body.products(обязательно): IOrderProductData[]
Массив заказанных продуктов.

langCode: String
Код языка. По умолчанию: "en_US"
пример: "en_US"

Примеры

Минимальный пример

const body = {
"formIdentifier": "orderForm",
"paymentAccountIdentifier": "cash",
"formData": {
{
"marker": "order_name",
"type": "string",
"value": "Иван"
}
},
"products": [
{
"productId": 2,
"quantity": 2
}
]
};
const response = await Orders.createOrder("my-order", body);

Пример ответа

{
  "id": 233,
  "formIdentifier": "orderForm",
  "paymentAccountIdentifier": "cash",
  "formData": [
    {
      "marker": "order_name",
      "value": "Иван",
      "type": "string"
    }
  ],
  "products": [
    {
      "productId": 2957,
      "quantity": 2
    }
  ],
  "currency": "",
  "totalSum": 300,
  "createdDate": "2025-07-21T09:40:08.552Z"
}

Схема ответа

Схема: IBaseOrdersEntity

id: number
Идентификатор объекта.
пример: 1

formIdentifier: string
Текстовый идентификатор формы.
пример: "bar-orders-form"

paymentAccountIdentifier: string
Текстовый идентификатор платежа по заказу.
пример: "payment-1"

formData: IOrdersFormData[]
Данные, отправленные формой, связанной с хранилищем заказов.
пример:

[
  {
    "marker": "name_1",
    "value": "Name",
    "type": "string"
  }
]

products: IOrderProducts[]
Массив продуктов, добавленных в заказ.
пример:

[
  {
    "id": 2957,
    "title": "Cosmo",
    "sku": null,
    "previewImage": null,
    "price": 150,
    "quantity": 2
  }
]

currency: string
Валюта, используемая для оплаты заказа.
пример: "USD"

totalSum: number
Общая сумма заказа.
пример: NaN

createdDate: string
Дата создания заказа.
пример: "2023-10-01T12:00:00Z"

statusIdentifier: string
Текстовый идентификатор объекта статуса заказа (если не установлен, будет назначен статус по умолчанию).
пример: "status-1". /

---