Создать заказ
Создаёт заказ в магазине. externalId обязателен и служит ключом идемпотентности: повтор с тем же значением вернёт уже созданный заказ с кодом 200. Товар в позиции указывается через productId, sku или externalProductId, без unitPrice берётся цена из каталога. Итог API считает сам. Суммы в копейках. Право: orders:write.
Авторизация
bearerApiKey Ключ API в заголовке Authorization: Bearer rsk_live_…. Ключ создаёт владелец магазина: Настройки → Интеграции → API.
Где: header
Тело запроса
application/json
Типы TypeScript
Готовый тип для вашего кода.
Ответ
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/api/v1/orders" \ -H "Content-Type: application/json" \ -d '{ "externalId": "A-1001", "customer": { "name": "Анна Смирнова", "phone": "+79161234567", "email": "anna@example.ru" }, "items": [ { "productId": "dcd53ddb-8104-4e48-8cc0-5df1c5a0d1e2", "quantity": 2, "unitPrice": 114000 }, { "sku": "HLDR-CONC", "quantity": 1 } ], "delivery": { "address": "Москва, ул. Лесная, 5, кв. 12", "cost": 35000 }, "paymentStatus": "paid", "notes": "Позвонить за час до доставки" }'{ "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
Один заказ с позициями. Ищет по ID Рефсейлс, а с by=externalId по ID из вашей системы. Право: orders:read.
Изменить заказ PATCH
Меняет статус, статус оплаты, контакты покупателя, адрес доставки или комментарий. Передайте хотя бы одно поле. Суммы и externalId не меняются. Право: orders:write.