http://api.brain.com.ua/add_recipient/
SID
POST
Метод для створення кінцевого клієнта та адреси доставки
Назва параметра |
Обов'язковий параметр |
Опис |
SID |
так |
ідентифікатор сесії |
Назва параметра |
Обов'язковий параметр |
Опис |
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
}