Рефсейлс API
Заказы

Получить заказ

GET
/api/v1/orders/{id}

Один заказ с позициями. Ищет по ID Рефсейлс, а с by=externalId по ID из вашей системы. Право: orders:read.

Авторизация

bearerApiKey
АвторизацияBearer <ключ>

Ключ API в заголовке Authorization: Bearer rsk_live_…. Ключ создаёт владелец магазина: Настройки → Интеграции → API.

Где: header

Параметры пути

id*string

ID заказа в Рефсейлс или, с by=externalId, ID во внешней системе.

Параметры запроса

by?string

По какому ID искать. По умолчанию id.

Value in

  • "id"
  • "externalId"
with?"items"

Что вложить в ответ. Сейчас доступно только items, позиции заказа.

Value in

  • "items"

Ответ

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/orders/string"
{  "data": {    "id": "3f0e6c5a-2b7d-4e21-9a0f-6d1c8b4e7a52",    "externalId": "A-1001",    "createdAt": "2026-09-12T09:41:07.000Z",    "updatedAt": "2026-09-12T14:03:55.000Z",    "status": {      "code": "new",      "name": "Новый"    },    "paymentStatus": {      "code": "paid",      "name": "Оплачен",      "isPaid": true    },    "totalAmount": 327000,    "discountTotal": 15000,    "promoCode": "OSEN10",    "currency": "RUB",    "customer": {      "name": "Анна Смирнова",      "phone": "+79161234567",      "email": "anna@example.ru"    },    "delivery": {      "type": "СДЭК до пункта выдачи",      "cost": 35000,      "discount": 0,      "address": "Москва, ул. Лесная, 5, кв. 12",      "city": "Москва",      "region": "Москва",      "street": "ул. Лесная",      "house": "5",      "flat": "12",      "postalCode": "125047"    },    "source": "api",    "notes": "Позвонить за час до доставки",    "items": [      {        "id": "b91d2f6e-0c4a-4f8e-8d3b-27a5e1c9f604",        "productId": "dcd53ddb-8104-4e48-8cc0-5df1c5a0d1e2",        "externalProductId": "MS-00124",        "name": "Свеча ароматическая «Хвоя», 200 г",        "sku": "CNDL-200-PINE",        "quantity": 2,        "unitPrice": 120000,        "discount": 12000,        "lineTotal": 228000      },      {        "id": "5e8a1b3c-7d2f-4a6e-9c0b-81f4d2e6a9c7",        "productId": "a4c7e2b9-3f1d-4c8a-b6e0-9d2f5a1c7e38",        "externalProductId": "MS-00311",        "name": "Подставка из бетона",        "sku": "HLDR-CONC",        "quantity": 1,        "unitPrice": 67000,        "discount": 3000,        "lineTotal": 64000      }    ]  }}

Список заказов GET

Заказы магазина, по умолчанию новые сверху. Страницы листаются курсором: передайте page.nextCursor в параметр cursor. Для синхронизации запрашивайте order=updatedAt:asc с filter[updatedAt][from]. Суммы в копейках. Право: orders:read.

Создать заказ POST

Создаёт заказ в магазине. externalId обязателен и служит ключом идемпотентности: повтор с тем же значением вернёт уже созданный заказ с кодом 200. Товар в позиции указывается через productId, sku или externalProductId, без unitPrice берётся цена из каталога. Итог API считает сам. Суммы в копейках. Право: orders:write.