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

add_recipient


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

HTTP Метод
POST

Опис
Метод для створення кінцевого клієнта та адреси доставки

Параметри URL
Назва параметра Обов'язковий параметр Опис
SID так ідентифікатор сесії

Параметри POST запиту
Назва параметра Обов'язковий параметр Опис
recipient_type так тип клієнта: 1 - юрособа, 0 - фізособа
name так ПІБ одержувача
legal_name так (для юросіб) юр. назва одержувача
okpo так (для юросіб) код ЄДРПОУ для юр.особи
vat_code так (для юросіб - платників ПДВ) код ІПН для юр.особи
non_payer_vat ні (так - якщо не вказано ІПН) не платник ПДВ (0 - ні, 1 - так; за замовчуванням 0) для юр.особи
legal_address ні юр.адреса для юр.особи
legal_phone ні номер телефону юр.особи у форматі "0000000000"
phone_number так номер телефону одержувача у форматі "0000000000"
email ні адреса електронної пошти
delivery_type так варіант отримання ("self" - склад, "home" - двері)
delivery_service_code так код служби доставки
targetID так (для варіанту отримання "склад") ідентифікатор ПВ для варіанта одержання "склад"
cityID так (для варіанту отримання "двері") ідентифікатор міста для варіанта отримання "двері"
streetID так (для варіанту отримання "двері") ідентифікатор вулиці для варіанта отримання "двері"
building так (для варіанту отримання "двері") номер будинку
flat ні номер квартири
floor ні поверх, тільки для Нової Пошти
lift ні наявність ліфта (0 – немає, 1 – є), тільки для Нової Пошти
comment ні коментар для поштової декларації

Результат
Метод повертає ідентифікатори кінцевого клієнта ("recipientID") та адреси доставки ("addressID").

Приклад
    PHP код для відправки запиту за допомогою CURL:

    $url = "http://api.brain.com.ua/add_recipient/gpkavk4s0aciujg6m698gev040"; // URL адреса API с SID
    $data = array(
        "recipient_type"        => 0,
        "name"                  => "Іванов Іван Іванович",
        "phone_number"          => "0671234567",
        "delivery_type"         => "self",
        "delivery_service_code" => "3",
        "targetID"              => "A1B23C45-6D78-90E1-FGH2-345678I9JKL0"
    );

    $ch = curl_init();

    curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
    curl_setopt( $ch, CURLOPT_POST, 1 );
    curl_setopt( $ch, CURLOPT_POSTFIELDS, $data );
    curl_setopt( $ch, CURLOPT_URL, $url );

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

Приклад відповіді
    {
        "status": 1,
        "recipientID": 23,
        "addressID": 456
    }