Часто шукають

↑↓ вибрати ↵ відкрити Усі результати →

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

Одне замовлення

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

Оформлене замовлення за його номером — у тій самій формі, що й у списку: суми, товари, покупець, доставка, оплата й коментар.

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

Параметри шляху

referencestringобов'язковий
Номер замовлення.

Відповіді

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": "Подзвоніть перед відправкою"
    }
}
404Оформленого замовлення з таким номером немає. 
{
    "code": "not_found",
    "message": "not_found",
    "field": 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
}