Субмерчанты

1. Субмерчант Создать API

Описание:
API для создания суб-торговца. Если мерчант хочет создать дочернего мерчанта, используется API.

💡 Примечание: созданный субмерчант активируется сотрудниками.

💡 Примечание: у мерчанта должно быть разрешение на создание субмерчантов. В противном случае возвращается ошибка permission_denied.

Подробности конечной точки

Метод: POST
URL: BASE_URL/merchant/subMerchant/merchant-create/
Заголовок:

Authorization: Bearer <ACCESS_TOKEN>

Тело запроса

Поле	Тип	Требуется	Описание
name	string	Да	Название субмерчанта. 1–128 символов
tin	string	Условно	ИНН организации. Ровно 9 цифр
pinfl	string	Условно	ПИНФЛ физического лица (JSHSHIR). Ровно 14 цифр
external_id	string	Нет	ID субмерчанта в вашей системе. 1–64 символа
create_new_organization	bool	Нет	По умолчанию false. Если true, для субмерчанта создаётся новая организация на основе данных organization. Если false, используется организация родительского мерчанта
organization	object	Условно	Данные организации. Обязательно, если create_new_organization равно true
self_employee_service	bool	Нет	По умолчанию false. Услуга самозанятого (OFD)
ofd_vat_percent	int	Нет	Процент НДС для OFD. От 0 до 100
SPIC	string	Нет	Код ИКПУ (SPIC). До 64 символов. Имя поля пишется заглавными буквами
spic_package_code	string	Нет	Код упаковки ИКПУ. До 20 символов

💡 Примечание: необходимо указать хотя бы одно из полей tin или pinfl. Можно передать оба одновременно.

💡 Примечание: если create_new_organization равно true, поля tin и organization обязательны.

Объект organization

Поле	Тип	Требуется	Описание
name	string	Да	Название организации. До 256 символов
director_pinfl	string	Да	ПИНФЛ директора. Ровно 14 цифр
account_number	string	Да	Номер расчётного счёта. Только цифры, до 32 символов
oked	string	Да	Код ОКЭД. Ровно 5 цифр
legal_name	string	Нет	Юридическое название. До 256 символов
director_fio	string	Нет	Ф.И.О. директора. До 256 символов
director_passport	string	Нет	Серия и номер паспорта директора. До 9 символов
director_passport_valid_to	date	Нет	Срок действия паспорта. YYYY-MM-DD
director_birth_date	date	Нет	Дата рождения директора. YYYY-MM-DD
director_nationality	string	Нет	Гражданство директора. До 2 символов
dr_nationality_for_uzcard	string	Нет	Код гражданства директора для Uzcard. До 3 символов
dr_nationality_for_humo	string	Нет	Код гражданства директора для Humo. До 3 символов
mfo	string	Нет	МФО банка. До 10 символов

Пример запроса

С организацией родительского мерчанта:

{
  "name": "MrBeast",
  "tin": "123654987",
  "pinfl": "12345678901234",
  "external_id": "Someone External Id",
  "self_employee_service": false,
  "ofd_vat_percent": 12,
  "SPIC": "10305008003000000",
  "spic_package_code": "1500988"
}

С созданием новой организации:

{
  "name": "MrBeast",
  "tin": "123654987",
  "external_id": "Someone External Id",
  "create_new_organization": true,
  "organization": {
    "name": "MrBeast LLC",
    "legal_name": "ООО \"MRBEAST\"",
    "director_fio": "Ivanov Ivan Ivanovich",
    "director_passport": "AA1234567",
    "director_pinfl": "12345678901234",
    "director_passport_valid_to": "2030-01-01",
    "director_birth_date": "1990-01-01",
    "director_nationality": "UZ",
    "account_number": "20208000900000000001",
    "mfo": "00000",
    "oked": "47190"
  }
}

Пример ответа

HTTP статус: 201

{
  "result": {
    "id": "c467b929-b850-40ae-9e38-fb2827684bda",
    "name": "MrBeast"
  }
}

Ответ об ошибке

Код	HTTP	Описание
validation_error	400	Некорректное тело запроса
permission_denied	400	У мерчанта нет разрешения на создание субмерчантов
sub_merchant_already_created	400	У этого мерчанта уже есть субмерчант с таким же name, tin, pinfl или external_id
rate_limit_exceeded	429	Более 100 запросов за 60 секунд. Повторите запрос через количество секунд, указанное в заголовке Retry-After

💡 Примечание: дубликаты проверяются только среди субмерчантов одного родительского мерчанта. Если любое из полей name, tin, pinfl или external_id совпадает с существующим субмерчантом, новый не создаётся.

{
  "result": null,
  "error": {
    "code": "sub_merchant_already_created",
    "message": "Sub Merchant Already Created..."
  }
}

Пример ошибки валидации. Ошибки правил tin / pinfl и create_new_organization возвращаются в data.non_field_errors, ошибки полей organization — в data.organization.<field>:

{
  "result": null,
  "error": {
    "code": "validation_error",
    "message": "validation_error",
    "data": {
      "non_field_errors": [
        "At least one of TIN or PINFL must be provided"
      ]
    }
  }
}