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

POST order

URL

http://api.brain.com.ua/order/SID [?overprice=1]

HTTP Метод

POST

Опис

Метод додавання товарів у кошик. Якщо товар вже присутній у кошику, він оновлюється відповідно до зазначених даних.
Для додавання товарів потрібно відправити POST запит зі змінною "data", в якій міститься валідний JSON рядок (див. специфікацію JSON) - список товарів у наведеному нижче форматі.

Параметри URL

Назва параметра	Обов'язковий параметр	Опис
SID	так	ідентифікатор сесії
overprice	ні	1 - не перевіряти ціну отримувача за діапазоном дилерської та роздрібної ціни, 0 - перевіряти. Доступно лише компаніям, яким це дозволено, інакше повертається помилка 116. Інші значення - помилка 117.

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

Назва параметра	Обов'язковий параметр	Опис
data	так	змінна, яка містить рядок JSON зі списком замовлень
recipient_type	ні (так - для комісійного продажу)	тип кінцевого клієнта (0 - фіз.особа, 1 - юр.особа; за замовчуванням 0)

Параметри списку товарів у JSON

Назва параметра	Обов'язковий параметр	Опис
productID	ні (якщо вказано product_code або articul)	ID товару, який потрібно додати до замовлення
product_code	ні (якщо вказано productID або articul)	код товару, який потрібно додати до замовлення
articul	ні (якщо вказано productID або product_code)	артикул товару, який потрібно додати до замовлення
quantity	так	кількість одиниць товару
recipient_price	ні (так - для комісійного продажу)	ціна товару для рахунку
comment	ні	коментар до товару

Товар може бути ідентифікований за productID, product_code, articul або будь-якому їх поєднанню.Тобто, обов'язково має бути зазначений хоча б один із цих параметрів.

Результат

Повертає JSON об'єкт із статусом виконання операції (1 якщо успішно)

Приклад даних, що надсилаються

    data=[
        {"productID":"15949","quantity":"12","recipient_price":"1299.00","comment":"thank for service"},
        {"product_code":"B0015377","quantity":"1","recipient_price":"513.00"}
    ]

Формат даних у JSON для надсилання

    [{
        "productID":"15949",
        "quantity":"12",
        "recipient_price":"1299.00",
        "comment":"thank for service"
    }, {
        "product_code":"B0015377",
        "quantity":"1",
        "recipient_price":"513.00"
    }]

Приклад PHP коду для надсилання з використанням CURL


    $url; // URL адреса API с SID
    $data = json_encode( array(
        array(
            'productID'       => '15949',
            'quantity'        => '12',
            'recipient_price' => '1299.00',
            'comment'         => 'thank for service'
        ),
        array(
            'product_code'    => 'B0015377',
            'quantity'        => '1',
            'recipient_price' => '513.00'
        )
    ) );

    $ch = curl_init();

    curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );

    curl_setopt( $ch, CURLOPT_POST, 1 );

    curl_setopt( $ch, CURLOPT_POSTFIELDS, array(
        'data' => $data
    ));

    curl_setopt( $ch, CURLOPT_URL, $url );

    $result = curl_exec($ch); // JSON зі статусом

Приклад відповіді

    {"status":"1","result":"1"}