Документація »

orders


URL
http://api.brain.com.ua/orders/SID [?type=type] [&ordererID=ordererID] [&date_start=date_start] [&date_finish=date_finish] [&limit=limit] [&offset=offset] [&lang=lang]

HTTP Метод
GET

Опис
Метод отримання списку замовлень

Параметри
Назва параметра Обов'язковий параметр Опис
SID так ідентифікатор сесії
type ні тип замовлення
ordererID ні ідентифікатор замовника
orderID ні ідентифікатор замовлення
date_start ні початкова дата
date_finish ні кінцева дата
limit ні кількість замовлень, що повертаються (максимальна кількість - 100)
offset ні усунення (кількість замовлень, що пропускаються перед виведенням результатів; за замовчуванням - 0)
lang ні мова, можливі значення - ua та ru
за замовчуванням ua

Типи замовлень
Тип замовлення Опис
new Чернетка
invoice Рахунок
quotation Рахунок
reserved Бронь
ordered Відвантаження
preordered Попереднє замовлення
prepaid Відвантаження по передоплаті


Використовуваний формат дати - DD.MM.YYYY

Якщо буде передано лише одну дату - вона буде проігнорована, і буде використаний діапазон дат за замовчуванням (початкова дата - перше число поточного місяця, кінцева дата дорівнює поточній даті).

Результат
Метод повертає список замовлень.

Якщо у запиті є необов'язкові параметри, список замовлень фільтрується відповідно до них.

Параметр "count" результату показує кількість замовлень без урахування значень параметрів offset та limit.

Параметр "delivery_time": "blocked" інформує про заборону купівлі цієї групи товарів; для вирішення питання, будь ласка, зверніться до свого менеджера.

Приклад
    Запит:
    http://api.brain.com.ua/orders/gpkavk4s0aciujg6m698gev040

    Відповідь:
    {
    "status":1,
    "result":
        {
        "list":
            [
            {
            "orderID":"297487",
            "ordererID":"1",
            "type":"Відвантаження",
            "status":"Обробка",
            "currency":"USD",
            "quantity":5,
            "amount":259.77,
            "actual_amount":259.77,
            "volume":0.35,
            "delivery_type":"home",
            "addressID":"0",
            "subsidiaryID":null,
            "targetID":"65",
            "reserveddate":"25.12.2013",
            "reservedquantity":0,
            "shipingdate":"30.12.2013 13:03",
            "accounting":"0",
            "closed":null,
            "clientID":null,
            "add_time":"2013-12-18 17:19:44",
            "update_time":"2013-12-24 10:32:31",
            "items":
                [
                {
                "productID":"1155",
                "quantity":"2",
                "price":"38.01",
                "actual_price":"38.01",
                "invoice_price":"0.00",
                "delivery_time":"30.12.2013 13:03",
                "reservedquantity":"0"
                },
                {
                "productID":"1154",
                "quantity":"3",
                "price":"61.25",
                "actual_price":"61.25",
                "invoice_price":"0.00",
                "delivery_time":"30.12.2013 13:03",
                "reservedquantity":"0"
                }
                ],
            "comments":
                [
                {
                "publication_time": "2013-12-24 10:32:31",
                "author": "Веб-автомат",
                "text": "Враховано вартість доставки 200.00 грн\n------------------------\n"
                }
                ]
            },
            {
            "orderID":"214375",
            "ordererID":"1",
            "type":"Чернетка",
            "status":"Нове",
            "currency":"USD",
            "quantity":12,
            "amount":1269,
            "actual_amount":1242.12,
            "volume":0.24,
            "delivery_type":"home",
            "addressID":"269",
            "subsidiaryID":null,
            "targetID":"65",
            "reserveddate":"",
            "reservedquantity":0,
            "shipingdate":"30.12.2013 13:03",
            "accounting":"0",
            "closed":null,
            "clientID":null,
            "add_time":"2013-12-06 17:32:10",
            "update_time":"2013-12-06 17:32:10",
            "items":
                [
                {
                "productID":"2",
                "quantity":"12",
                "price":"105.75",
                "actual_price":"103.51",
                "invoice_price":"0.00",
                "delivery_time":"30.12.2013 13:03",
                "reservedquantity":"0"
                }
                ],
            "comments":
                [
                {
                "publication_time": "2013-12-06 17:32:10",
                "author": "Іваненко Іван Іванович",
                "text": "Коментар до замовлення"
                }
                ]
            }
            ],
        "count":2
        }
    }