Создает покупателя.
v1/customers/add.php
Параметры
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| name | string | Да | Наименование юрлица или имя ИП и физлица |
| type | int | Нет | Тип: 1 юрлицо, 2 ИП, 3 физлицо. По умолчанию 3 |
| string | Нет | Электронная почта | |
| phone | string | Нет | Телефон |
| address_legal | string | Нет | Юридический адрес |
| address_real | string | Нет | Адрес доставки |
| inn | string | Нет | ИНН |
| kpp | string | Нет | КПП |
| ogrn | string | Нет | ОГРН |
| agreement | string | Нет | Договор |
| manager_name | string | Нет | Руководитель |
| manager_post | string | Нет | Должность руководителя |
| notes | string | Нет | Заметки |
Формат реквизитов и уникальность имени не проверяются: повторный запрос с тем же именем создаст еще одного покупателя. Подробнее о типах и реквизитах в статье Покупатели.
Покупателя можно создать и вместе с заказом, см. v1/orders/add.
Пример запроса
{
"name": "ООО Мебельный двор",
"type": 1,
"email": "zakaz@mebdvor.ru",
"phone": "+7 495 123-45-67",
"address_legal": "г. Москва, ул. Лесная, д. 5",
"address_real": "г. Москва, ул. Складская, д. 12",
"inn": "7701234567",
"kpp": "770101001",
"ogrn": "1027700123456",
"agreement": "№ 15 от 10.01.2026",
"manager_name": "Иванов Петр Сергеевич",
"manager_post": "Генеральный директор"
}
Пример ответа
{
"success": true,
"customer_id": 512
}
Ошибки
| Ошибка | Причина |
|---|---|
| No name in input | Не передан name или передан null |
| Name must not be empty | Пустое имя |
| Name must be a string | В name передан массив или объект |
| Invalid type value. Must be one of: 1, 2, 3 | Неверный тип |