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

Постачальники затрат

Постачальники затрат - це гнучка система управління контрагентами для затрат об'єкта. Система підтримує 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)