Главная › Библиотека

Поставщики расходов

Поставщики расходов - это гибкая система управления контрагентами для расходов объекта. Система поддерживает 4 типа поставщиков.

Что такое поставщик расходов?

Поставщик расходов - это промежуточная сущность, которая указывает на источник предоставления услуг или товаров. Вместо прямой привязки к официальным компаниям, система позволяет выбирать из разных типов поставщиков, включая личный справочник контрагентов.

Типы поставщиков

1. Поставщик услуг

Официальные компании с ЕГРПОУ, находящиеся в общем справочнике компаний.

Содержит полную информацию о компании
Проверенный ЕГРПОУ / налоговый номер
Общий справочник для всех пользователей

2. Пользователь системы

Пользователи системы, которые могут предоставлять услуги для объекта.

Например, технический специалист, обслуживающий объект
Уже зарегистрирован в системе
Имеет профиль и email

3. Приглашенный партнер

Приглашенные люди, которые не зарегистрировались, но их данные сохранены.

Содержит имя и email
Пользователь не хочет регистрироваться, но данные нужно сохранить

4. Личный справочник

Личный справочник контрагентов пользователя. Самый гибкий вариант.

Обязательно только поле "Название"
Все остальные поля опциональны (налоговые, банковские, контактные)
Без проверки ЕГРПОУ - можно вводить любые данные
Привязан к объекту и пользователю

Как использовать

Создание расхода с поставщиком

Откройте форму создания расхода
Нажмите "Выбрать поставщика" - откроется модальное окно
Выберите тип поставщика (фирма, пользователь, приглашение или личный контрагент)
Выберите конкретного поставщика из списка и подтвердите

Личный справочник контрагентов

Для управления личными контрагентами перейдите в раздел "Личный справочник" на странице объекта.

Обязательные поля

Название - только это поле обязательно

Опциональные поля

Основная информация: Сокращенное название, Организационно-правовая форма
Налоговая информация: ЕГРПОУ / ИНН, Номер плательщика НДС, Система налогообложения
Банковские реквизиты: IBAN, Название банка, МФО банка, SWIFT
Контактная информация: Email, Телефон, Веб-сайт, Юридический адрес, Фактический адрес
Юридическая информация: ФИО директора, Контактное лицо, Дата регистрации
Прочее: Примечания

API Endpoints

GET /api/v1/properties/{propertyId}/expense-providers/available

Получить всех доступных поставщиков по типам

POST /api/v1/properties/{propertyId}/expense-providers/create-by-email

Создает ExpenseProvider, используя email для типов "user" или "partner_invitation". Выполняет валидацию email и автоматически отправляет приглашение партнеру.

Параметры:

provider_type - Тип провайдера: "user" (существующий пользователь) или "partner_invitation" (приглашение партнера)
email - Email пользователя или партнера для приглашения
name - Имя для приглашения партнера (обязательно для типа partner_invitation)
locale - Язык приглашения: uk, en, ru, pl, de (по умолчанию: uk)

Валидация:

Для типа "user": проверяется, что email не принадлежит текущему пользователю и принадлежит активному пользователю в системе
Для типа "partner_invitation": валидируется формат email, проверяются существующие приглашения
Если приглашение уже существует со статусом "invited", оно обновляется и отправляется повторно
Все ошибки валидации возвращаются с соответствующими ключами перевода (error_key)

POST /api/v1/properties/{propertyId}/expense-providers/create-or-get

Создать или получить ExpenseProvider для конкретного поставщика

GET /api/v1/properties/{propertyId}/custom-contragents

Получить список личных контрагентов для объекта

POST /api/v1/properties/{propertyId}/custom-contragents

Создать нового личного контрагента

Примечание: Детальная документация API доступна в Swagger (/api/doc)