Добавление организации

Организация — юридическое лицо или индивидуальный предприниматель со своим ИНН. Организации объединяются в клиента — это бизнес одного владельца: у клиента может быть несколько организаций, у организации — несколько филиалов.

клиент (владелец бизнеса)
 └─ организация — ЮЛ или ИП, ИНН
     └─ филиал

1. Первая организация. Пользователь, который зарегистрировался сам, вызывает POST /v1/orgs без clientId. API создаёт нового клиента и организацию в нём, а пользователь получает роль «Владелец» на весь клиент.

2. Реквизиты и проверка. Владелец дополняет реквизиты и отправляет организацию на проверку сотрудникам reKassa.

3. Следующие организации того же бизнеса добавляются с clientId существующего клиента.

Автозаполнение по ИНН

GET/v1/orgs/lookup/{tin}

Реквизиты из Didox, чтобы не вводить их вручную: название, адрес, директор, МФО и название банка, расчётный счёт. tin — ИНН (9 цифр) или ПИНФЛ (14 цифр). Доступно любому пользователю, который может добавить организацию, и сотрудникам reKassa. Поля fullName, bankName, oked, vatRegCode и alreadyRegistered — справочные, в POST /v1/orgs их не передают.

curl https://api.rekassa.uz/v1/orgs/lookup/302936161 \
  -H 'Authorization: Bearer <accessToken>'

{
  "kind": "legal",
  "tin": "302936161",
  "name": "\"CLIENT\" MCHJ",
  "fullName": "\"CLIENT\" MAS'ULIYATI CHEKLANGAN JAMIYAT",
  "address": "Toshkent, Yangi Olmazor 10",
  "directorName": "MIRZAYEV AHRORBEK",
  "bankMfo": "01158",
  "bankName": "КАПИТАЛБАНК",
  "bankAccount": "20208000900123456001",
  "oked": "62090",
  "vatRegCode": null,
  "alreadyRegistered": false
}

alreadyRegistered: true — организация с этим ИНН уже есть в reKassa, добавить её ещё раз нельзя (409 tin_taken). Ошибки: 404 company_not_found — Didox не знает этот ИНН; 502 didox_unavailable — Didox не ответил; 400 — ИНН не из 9 или 14 цифр.

Добавить организацию

POST/v1/orgs

Поле	Тип	Обязательное	Ограничения
kind	string	да	legal — юридическое лицо, individual — ИП
tin	string	да	ЮЛ — ИНН, 9 цифр; ИП — ИНН (9 цифр) или ПИНФЛ (14 цифр)
name	string	да	1–300 символов
clientId	string (UUID)	нет	клиент, в который добавить организацию; без него создаётся новый
address	string	нет	1–500 символов
directorName	string	нет	руководитель, 1–200 символов
phone	string	нет	телефон организации, см. Телефоны
bankName	string	нет	название банка, 1–200 символов
bankMfo	string	нет	МФО банка, ровно 5 цифр
bankAccount	string	нет	расчётный счёт, ровно 20 цифр

Сразу создать организацию можно с одними kind, tin и name — остальные реквизиты понадобятся перед проверкой, их можно добавить позже через PATCH /v1/orgs/{id}.

curl

curl -X POST https://api.rekassa.uz/v1/orgs \
  -H 'Authorization: Bearer <accessToken>' \
  -H 'Content-Type: application/json' \
  -d '{
    "kind": "legal",
    "tin": "301234567",
    "name": "ООО «Навруз Савдо»",
    "address": "г. Ташкент, Юнусабадский р-н, ул. Амира Темура, 108",
    "directorName": "Каримов Азиз Рустамович"
  }'

JavaScript

const response = await fetch('https://api.rekassa.uz/v1/orgs', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${accessToken}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    kind: 'legal',
    tin: '301234567',
    name: 'ООО «Навруз Савдо»',
    address: 'г. Ташкент, Юнусабадский р-н, ул. Амира Темура, 108',
    directorName: 'Каримов Азиз Рустамович',
  }),
})
const organization = await response.json()

Ответ 201:

{
  "id": "8c1e4a27-5d3b-4f60-9a82-1b7e0c3d9f45",
  "clientId": "e2b7c915-0a4d-4e38-b6f1-7d9a2c5e8b03",
  "kind": "legal",
  "tin": "301234567",
  "name": "ООО «Навруз Савдо»",
  "address": "г. Ташкент, Юнусабадский р-н, ул. Амира Темура, 108",
  "directorName": "Каримов Азиз Рустамович",
  "phone": null,
  "bankName": null,
  "bankMfo": null,
  "bankAccount": null,
  "verificationStatus": "not_started",
  "contractStatus": "contract_required",
  "verificationNote": null,
  "submittedAt": null,
  "verifiedAt": null,
  "createdAt": "2026-09-24T09:10:00.000Z"
}

Поле	Описание
clientId	клиент, к которому относится организация; нужен, чтобы добавить следующие
verificationStatus	статус проверки, см. Проверка организации
contractStatus	договор с reKassa: contract_required — «Требуется договор», contract_in_progress — «Договор на подписании», contract_signed — «Договор заключён», см. Договоры
verificationNote	комментарий сотрудника reKassa, если проверка не пройдена
submittedAt	когда организацию последний раз отправили на проверку
verifiedAt	когда проверка пройдена

ИНН уникален во всей системе

Одну организацию нельзя зарегистрировать дважды — даже разными клиентами. Если ИНН уже занят, ответ 409 tin_taken: пользователю нужно попросить владельца этой организации добавить его сотрудником.

Кто может добавить организацию

Сценарий	Нужно
без clientId — новый клиент	роль «Пользователь» — её получает каждый, кто зарегистрировался сам
с clientId — в существующий клиент	доступ orgs.create в этом клиенте: из системных ролей он есть только у «Владельца»

Название нового клиента совпадает с названием первой организации.

Ошибки

Статус	Код	Когда
400	validation_failed	неизвестный kind, ИНН не из 9 или 14 цифр, у ЮЛ ИНН не из 9 цифр, МФО не из 5 цифр, счёт не из 20
403	forbidden	нет доступа orgs.create (в details.permission)
404	not_found	клиента с таким clientId нет
409	tin_taken	организация с таким ИНН уже зарегистрирована

Мои организации

GET/v1/orgs

Организации, в которых у пользователя есть роль: на весь клиент (например, «Владелец»), на организацию или на один из её филиалов. Массив без пагинации, по алфавиту. Роли сотрудников reKassa сюда не попадают — для них список всех организаций в портале.

curl

curl https://api.rekassa.uz/v1/orgs \
  -H 'Authorization: Bearer <accessToken>'

JavaScript

const response = await fetch('https://api.rekassa.uz/v1/orgs', {
  headers: { Authorization: `Bearer ${accessToken}` },
})
const organizations = await response.json()

Элементы — в том же виде, что в ответе на создание. Пустой массив значит, что пользователь пока не работает ни в одной организации: предложите добавить свою.

Организация

GET/v1/orgs/{id}

Организация по id. Доступна всем, у кого есть роль в ней самой, в её клиенте или в одном из её филиалов, — кассир филиала тоже видит, в какой организации работает.

Статус	Код	Когда
403	forbidden	у пользователя нет роли в этой организации
404	organization_not_found	организации с таким id нет

Доступ к организациям

Все методы /v1/orgs/{id} и /v1/orgs/{id}/... проверяют роль пользователя в этой организации. Если роли нет — ни на весь клиент, ни на организацию, ни на её филиал, — любой из них отвечает 403 forbidden с нужным доступом в details.permission. Раньше 403 приходит только 404, если не найден сам объект запроса: организация, филиал или сотрудник. Сотрудники reKassa проходят проверку своими ролями платформы.

Что именно разрешено, решают доступы роли:

Доступ	Что открывает
orgs.read	организация и её филиалы
orgs.manage	изменение реквизитов и отправка на проверку
branches.manage	создание и изменение филиалов
users.read	список сотрудников
users.manage	добавление, смена роли и удаление сотрудников, чужие PIN
roles.assign	выдача ролей при добавлении сотрудника и смене роли

Какие доступы у каких ролей — в разделе Роли и доступы.