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

Изменить заказ

PATCH
/api/v1/orders/{id}

Меняет статус, статус оплаты, контакты покупателя, адрес доставки или комментарий. Передайте хотя бы одно поле. Суммы и externalId не меняются. Право: orders:write.

Авторизация

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

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

Где: header

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

id*string

ID заказа в Рефсейлс.

Тело запроса

application/json

Типы TypeScript

Готовый тип для вашего кода.

Ответ

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/api/v1/orders/string" \  -H "Content-Type: application/json" \  -d '{    "status": "delivery",    "paymentStatus": "paid"  }'
{  "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      }    ]  }}

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

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

Список товаров GET

Товары и варианты магазина. Вариант отличается от обычного товара заполненным parentId. Цены в копейках. Право: products:read.