Integration API · Замовлення

Список замовлень

GEThttps://{store}/api/v1/integrations/orders

Оформлені замовлення в порядку id з усім, що потрібно для обліку: суми, товари з артикулом і ціною, покупець, доставка (перевізник, місто, відділення чи адреса), спосіб оплати й коментар покупця. Сторінки — курсором: передавайте next_cursor попередньої відповіді, доки він не стане null. Щоб забрати зміни, передайте updated_since — час останньої синхронізації.

Щоб отримувати зміни одразу, підпишіться на вебхуки (order.created, order.status_changed) в адмінці замість опитування.

Ключ інтеграції з правом orders:read: Authorization: Bearer {key}.

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

updated_sincestring

Лише замовлення, змінені в цей час або пізніше (YYYY-MM-DD HH:MM:SS, часовий пояс магазину).

cursorinteger

Замовлення з id, більшим за цей (next_cursor попередньої сторінки).

limitinteger

Розмір сторінки: за замовчуванням 15, максимум 50.

Відповіді

200Сторінка замовлень і курсор наступної.

{
    "data": [
        {
            "id": 1044,
            "reference": "2026-001044",
            "status": "payment-received",
            "total": 214000,
            "currency_code": "UAH",
            "placed_at": "2026-10-12 14:03:11",
            "updated_at": "2026-10-12 16:20:45",
            "customer": {
                "name": "Олена Коваль",
                "email": "[email protected]",
                "phone": "+380671234567",
                "first_name": "Олена",
                "last_name": "Коваль",
                "customer_id": 318
            },
            "subtotal": 214000,
            "shipping_total": 0,
            "discount_total": 0,
            "tax_total": 0,
            "lines": [
                {
                    "id": 5012,
                    "product_id": 12,
                    "variant_id": 15,
                    "sku": "SONAR-ANC-BLK",
                    "name": "Навушники Sonar ANC повнорозмірні",
                    "option": "Чорний · Гравіювання: Для Ані",
                    "quantity": 1,
                    "unit_price": 199000,
                    "total": 199000
                },
                {
                    "id": 5013,
                    "product_id": 31,
                    "variant_id": 40,
                    "sku": "CASE-01",
                    "name": "Чохол для навушників",
                    "option": null,
                    "quantity": 1,
                    "unit_price": 15000,
                    "total": 15000
                }
            ],
            "shipping": {
                "method": "Нова пошта",
                "carrier": "nova_poshta",
                "service_type": "branch",
                "city_name": "Київ",
                "city_ref": "8d5a980d-391c-11dd-90d9-001a92567626",
                "delivery_point_name": "Відділення №12",
                "delivery_point_ref": "1ec09d88-e1c2-11e3-8c4a-0050568002cf",
                "address": {
                    "line_one": "Відділення №12",
                    "line_two": null,
                    "city": "Київ",
                    "postcode": null,
                    "country": "UA"
                },
                "method_code": "NOVA_POSHTA"
            },
            "payment": {
                "method": "app:com.storeforma.wayforpay"
            },
            "notes": "Подзвоніть перед відправкою"
        }
    ],
    "next_cursor": null
}

401Ключа немає, він невідомий або відкликаний.

{
    "code": "unauthenticated",
    "message": "Integration key is inactive.",
    "field": null
}

403У ключа немає права orders:read, або тариф магазину без доступу до API.

{
    "code": "forbidden",
    "message": "Integration key cannot orders:read.",
    "field": null
}

422Поле має помилку; його назва — у field.

{
    "code": "validation_error",
    "message": "name is required.",
    "field": "name"
}

429Понад 60 запитів за хвилину для цього ключа. Зачекайте Retry-After секунд.

{
    "code": "rate_limited",
    "message": "Too many integration requests.",
    "field": null
}