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

POST order


URL
http://api.brain.com.ua/order/SID

HTTP Метод
POST

Описание
Метод для добавления товаров в корзину. Если товар уже присутствует в корзине, он обновляется в соответствии с указанными данными.
Для добавления товаров нужно отправить POST запрос с переменной "data", в которой содержится валидная JSON строка (см. спецификацию JSON) - список товаров в приведенном ниже формате.

Параметры URL
Название параметра Обязательный параметр Описание
SID да идентификатор сессии

Параметры 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"}