Supplier
INFO
Каждый ответ приходит в общем конверте — code, message, messages, status_code, time — а полезная нагрузка лежит в data. Таблицы ниже описывают содержимое data.
GET /supplier/get-by-id/{id}
Get supplier using its _id
Параметры пути
| Параметр | Тип | Обязательно | Описание |
|---|---|---|---|
id | string | Да |
Тело запроса
Тело запроса не требуется.
Ответ
| Поле | Тип | Описание |
|---|---|---|
name | string | |
number | number | |
type | string | |
parent_id | string |
json
{
"code": 0,
"message": "Success",
"status_code": 200,
"data": {
"name": "string",
"number": 0,
"type": "string",
"parent_id": "string"
},
"time": "2025-05-01T12:00:00Z"
}POST /supplier/get-paging
Get suppliers by paging
Тело запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
page | number | Да | По умолчанию: 1 |
limit | number | Да | По умолчанию: 20 |
search | string | Нет | |
category_id | string | Нет | |
updated_at | string (date-time) | Нет |
json
{
"page": 1,
"limit": 20,
"search": "string",
"category_id": "63f8b0c4e4b0d3a2f8e4b0c4",
"updated_at": "2024-07-20T10:30:00Z"
}Ответ
data.total — общее количество записей, data.data[] — записи текущей страницы. Таблица ниже описывает одну запись.
| Поле | Тип | Описание |
|---|---|---|
completely_deleted | boolean | |
is_deleted | boolean | |
created_at | string (date-time) | |
director_name | string | |
name | string | |
phone_number | string | |
refund_count | number | |
sale_count | number | |
total_sale | number | |
first_sale_at | string (date-time) | |
last_sale_at | string (date-time) | |
type | string | |
updatedAt | string (date-time) | |
updated_at | string (date-time) | |
total_balance | number | |
balance | number | |
balance_currency_id | string | |
address | string | |
inn | string | |
comment | string | |
avg_product | number | |
avg_sale | number | |
total_spent | number | |
category | object | |
category._id | string | |
category.name | string | |
note | string |
json
{
"code": 0,
"message": "Success",
"status_code": 200,
"data": {
"total": 0,
"data": [
{
"completely_deleted": false,
"is_deleted": false,
"created_at": "2025-05-01T12:00:00Z",
"director_name": "string",
"name": "string",
"phone_number": "string",
"refund_count": 0,
"sale_count": 0,
"total_sale": 0,
"first_sale_at": "2025-05-01T12:00:00Z",
"last_sale_at": "2025-05-01T12:00:00Z",
"type": "string",
"updatedAt": "2025-05-01T12:00:00Z",
"updated_at": "2025-05-01T12:00:00Z",
"total_balance": 0,
"balance": 0,
"balance_currency_id": "string",
"address": "string",
"inn": "string",
"comment": "string",
"avg_product": 0,
"avg_sale": 0,
"total_spent": 0,
"category": {
"_id": "string",
"name": "string"
},
"note": "string"
}
]
},
"time": "2025-05-01T12:00:00Z"
}POST /supplier/update
Update a supplier.
Тело запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
_id | string | Да | |
name | string | Нет | |
type | string | Нет | Допустимые значения: legal, natural |
phone_number | string | Нет | |
phone_numbers | string[] | Нет | |
email | string | Нет | |
inn | string | Нет | |
address | string | Нет | |
note | string | Нет | |
category_id | string | Нет | |
responsible_id | string | Нет | |
organization_ids | string[] | Нет |
json
{
"_id": "64b7f4d9e2b3b6a0b7c5d80a",
"name": "string",
"type": "legal",
"phone_number": "string",
"phone_numbers": [
"string"
],
"email": "string",
"inn": "string",
"address": "string",
"note": "string",
"category_id": "string",
"responsible_id": "string",
"organization_ids": [
"string"
]
}Ответ
Структура ответа совпадает с GET /supplier/get-by-id/{id}.
GET /supplier/get-by-phone/{phone_number}
Find a supplier by phone number.
Параметры пути
| Параметр | Тип | Обязательно | Описание |
|---|---|---|---|
phone_number | string | Да |
Тело запроса
Тело запроса не требуется.
Ответ
Структура ответа совпадает с GET /supplier/get-by-id/{id}.
POST /supplier/create
Create a supplier. name and organization_ids (at least one) are required. Conditional fields depend on type: legal persons use short_name / web_site / code / postal_code / owner_id / manager_id, natural persons use last_name / middle_name / birth_date / gender / legal_person_id. Returns the created supplier.
Тело запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
name | string | Да | Supplier name (required). For a legal person this is the company name; for a natural person the display name. |
type | string | Нет | Person type. Drives which of the conditional field groups below apply. Defaults to the backend default when omitted.. Допустимые значения: legal, natural |
organization_ids | string[] | Да | Organizations the supplier is available in (required, at least one). |
first_name | string | Нет | |
last_name | string | Нет | Natural persons only. |
middle_name | string | Нет | Natural persons only. |
birth_date | string (date-time) | Нет | Natural persons only. |
gender | string | Нет | Natural persons only.. Допустимые значения: male, female |
short_name | string | Нет | Legal persons only. |
web_site | string | Нет | Legal persons only. |
code | string | Нет | Legal persons only. |
postal_code | string | Нет | Legal persons only. |
owner_id | string | Нет | Legal persons only — owning person ObjectId. |
manager_id | string | Нет | Legal persons only — manager person ObjectId. |
phone_number | string | Нет | Primary phone number in international format. |
phone_numbers | string[] | Нет | Additional phone numbers. Must be unique. |
fax | string | Нет | |
email | string | Нет | |
telegram_link | string | Нет | |
inn | string | Нет | Taxpayer INN. Validated for format. |
qqs_number | string | Нет | VAT registration number. |
oked | string | Нет | |
director_name | string | Нет | |
bank_name | string | Нет | |
mfo | string | Нет | |
card_number | string | Нет | Validated as a credit-card number. |
address | string | Нет | |
delivery_address | object | Нет | Location object (lat/lng + address). |
category_id | string | Нет | |
person_id | string | Нет | Link to an existing person record instead of creating a new one. |
responsible_id | string | Нет | |
legal_person_id | string | Нет | Natural persons only — the legal person they represent. |
status | string | Нет | Допустимые значения: active, inactive |
is_customer | boolean | Нет | Also register this person as a customer. |
locale | string | Нет | Допустимые значения: uz, ru, en, kk, ky, tg |
comment | string | Нет | |
note | string | Нет | |
image | string | Нет | |
tag_ids | string[] | Нет | |
attachments | object[] | Нет | Attached files: { name, path, size, note }. |
json
{
"name": "string",
"type": "legal",
"organization_ids": [
"64b7f4d9e2b3b6a0b7c5d80a"
],
"first_name": "string",
"last_name": "string",
"middle_name": "string",
"birth_date": "2025-05-01T12:00:00Z",
"gender": "male",
"short_name": "string",
"web_site": "string",
"code": "string",
"postal_code": "string",
"owner_id": "string",
"manager_id": "string",
"phone_number": "string",
"phone_numbers": [
"string"
],
"fax": "string",
"email": "string",
"telegram_link": "string",
"inn": "string",
"qqs_number": "string",
"oked": "string",
"director_name": "string",
"bank_name": "string",
"mfo": "string",
"card_number": "string",
"address": "string",
"delivery_address": {},
"category_id": "string",
"person_id": "string",
"responsible_id": "string",
"legal_person_id": "string",
"status": "active",
"is_customer": false,
"locale": "uz",
"comment": "string",
"note": "string",
"image": "string",
"tag_ids": [
"string"
],
"attachments": [
{}
]
}Ответ
Структура ответа совпадает с GET /supplier/get-by-id/{id}.
Эта страница сгенерирована из спецификации OpenAPI.