Робота з бізнесом (Business)

Бізнес — це автоматично створена угода між покупцем і продавцем після успішного завершення торгів за ордером. Бізнес включає підписання контракту, організацію доставки, номінування транспорту та відстеження виконання замовлення.

🆕 Створення бізнесу

Як це працює?

Коли покупець і продавець домовляються про умови в ордері (прийняття пропозиції або контрпропозиції), система автоматично створює сутність “Бізнес”.

Що відбувається автоматично:

• ✅ Створюється новий бізнес з унікальним ID
• 📄 Генерується контракт на основі узгоджених умов
• 📬 Обом сторонам надходить сповіщення про створення бізнесу
• 🔔 З’являється нотифікація у вкладці “Documents”

Інформація в картці бізнесу:

📋 Заголовок:

• 🌾 Назва товару (наприклад, Corn Class 1)
• 💰 Ціна за тонну (наприклад, 4 200 ₴/MT)
• ⚖️ Обсяг з допуском (наприклад, 300±10% SO)

📊 Прогрес виконання:

• 🚚 0 MT Delivered — скільки доставлено
• 📦 300 MT — загальний обсяг контракту
• 🧾 0 ₴ Invoiced — скільки виставлено рахунків
• 💵 0 ₴ Paid — скільки оплачено
• 💰 1 260 000 ₴ — загальна сума контракту

🚛 Умови доставки:

• 📝 Тип контракту по ІНКОТЕРМС 2020 (наприклад, DAP)
• 📍 Місце доставки (наприклад, Terminal Trans Logistic, Uznyi, Liprel)
• 📅 Період доставки (наприклад, Mar 15, 2025 - Apr 22, 2025)

✍️ Крок 1: Підписання контракту

Як це працює?

Після створення бізнесу система автоматично генерує контракт, який мають підписати обидві сторони.

Крок 1. Перейдіть до вкладки “Documents”

1. У картці бізнесу натисніть вкладку “Documents”
2. Біля вкладки з’явиться 🔔 нотифікація про новий документ
3. Ви побачите згенерований контракт

Крок 2. Перегляньте контракт

Відкрийте документ контракту та перевірте всі умови:

• 🌾 Товар і якісні показники
• 💰 Ціна та загальна сума
• ⚖️ Обсяг поставки
• 📅 Період виконання
• 🚛 Умови доставки (DAP, FCA, тощо)
• 💵 Умови оплати
• 🏢 Реквізити сторін

Крок 3. Підпишіть контракт

1. Натисніть кнопку “Підписати”
2. Підтвердіть підписання (можлива електронна підпис або інший механізм)
3. ✅ Ваш підпис зафіксовано в системі

Крок 4. Очікуйте підпису другої сторони

1. Друга сторона отримає сповіщення про необхідність підписання
2. Після підписання обома сторонами контракт набуває чинності
3. Статус контракту змінюється на Підписано
4. 📥 Ви можете завантажити підписаний контракт у форматі PDF

🚚 Крок 2: Організація доставки (Delivery)

Як це працює?

Після підписання контракту починається флоу доставки. Залежно від типу контракту (DAP, FCA, тощо) відповідальність за логістику лежить на різних сторонах.

Типи контрактів і відповідальність:

📦 DAP (Delivered at Place):

• 👤 Хто відповідає за логістику: Продавець
• ✅ Що заповнено: Точка Б (місце доставки)
• ➕ Що треба додати: Точку А (звідки забирати товар)

🚛 FCA (Free Carrier):

• 👤 Хто відповідає за логістику: Покупець
• ✅ Що заповнено: Точка А (звідки забирати товар)
• ➕ Що треба додати: Точку Б (куди доставити)

Крок 1. Перейдіть до вкладки “Delivery”

1. У картці бізнесу натисніть вкладку “Delivery”
2. Ви побачите інформацію про період доставки
3. З’явиться кнопка ”+ Add Point”

Крок 2. Додайте точку доставки

1. Натисніть ”+ Add Point”
2. Заповніть інформацію:
   • 🏢 Тип точки: Склад (Warehouse) або інше
   • 📝 Назва: наприклад, “Warehouse Chernihiv, Chernihiv Region”
   • 📍 Адреса: повна адреса точки
   • 🗺️ Координати: (за потреби)
3. Збережіть точку

⚠️ Важливо:

• Якщо контракт DAP — додайте Точку А (звідки забирати)
• Якщо контракт FCA — додайте Точку Б (куди доставити)
• Без заповненої точки неможливо номінувати транспорт

Крок 3. Перевірте маршрут

Після додавання точки ви побачите:

• 📍 Точка А: адреса відправлення
• 📍 Точка Б: адреса доставки
• 🛣️ Відстань: автоматично розрахована
• 📊 Статус: Очікується номінування транспорту

🚛 Крок 3: Номінування транспорту

Хто номінує транспорт?

Транспорт номінує та сторона, яка відповідає за логістику:

• 📦 DAP: продавець номінує транспорт
• 🚛 FCA: покупець номінує транспорт

Крок 1. Відкрийте форму номінування

1. У вкладці “Delivery” з’явиться кнопка “Номінувати транспорт”
2. Натисніть на кнопку
3. Відкриється форма додавання транспорту

Крок 2. Заповніть дані транспорту

🚗 Інформація про автомобіль:

• Номер автомобіля: державний номерний знак (наприклад, ВН5903ІС12212131)
• Тип автомобіля: вантажівка, тягач, тощо
• Вантажопідйомність: (за потреби)

🚚 Інформація про причіп/причепи:

• Номер причепа 1: (наприклад, ВН5534ХІ)
• Номер причепа 2: (якщо є, наприклад, ВН5535ХІ)

👨‍✈️ Інформація про водія:

• Ім’я: ім’я водія
• Прізвище: прізвище водія
• Номер телефону: контактний номер водія (формат +380XXXXXXXXX)

Крок 3. Збережіть номінування

1. Перевірте всі введені дані
2. Натисніть “Номінувати”
3. ✅ Система збереже інформацію про транспорт

Крок 4. Автоматична реєстрація водія

✅ Якщо водій вже зареєстрований у системі:

• Водій одразу отримає повідомлення в Telegram-бот
• 📱 Повідомлення: “Вас номіновано на новий рейс [ID рейсу]. Переглянути деталі”
• Водій може підтвердити або відхилити номінування

📱 Якщо водій НЕ зареєстрований:

• Водій отримає SMS на вказаний номер телефону
• SMS містить посилання на Telegram-бот для реєстрації
• Після реєстрації водій отримає інформацію про рейс

Крок 5. Створення вояжу (рейсу)

Після номінування транспорту:

• ✅ Автоматично створюється вояж (voyage/рейс)
• 📄 Генерується ТТН (товарно-транспортна накладна)
• 📱 Водій бачить рейс у своєму Telegram-боті
• 📊 Статус рейсу: Номіновано або Очікує підтвердження водія

Крок 6. Завантаження документів

📄 ТТН (Товарно-транспортна накладна):

• Автоматично генерується для кожного вояжу
• Містить інформацію про вантаж, маршрут, транспорт, водія
• Доступна для завантаження у вкладці “Documents”
• Обидві сторони можуть завантажити ТТН у форматі PDF

Як завантажити ТТН:

1. Перейдіть до вкладці “Documents”
2. Знайдіть документ “ТТН [номер вояжу]”
3. Натисніть “Завантажити”
4. Роздрукуйте або надішліть водію

📊 Крок 4: Відстеження виконання доставки

Як це працює?

Після номінування транспорту та підтвердження водієм рейсу, система автоматично відстежує статуси виконання на стороні водія.

Статуси рейсу (відображаються в бізнесі):

Як відстежувати статус:

Крок 1. Перейдіть до вкладки “Delivery” у картці бізнесу

Крок 2. Ви побачите список усіх номінованих рейсів із статусами:

• 🚛 Рейс #1 — [поточний статус]
• 🚛 Рейс #2 — [поточний статус]

Крок 3. Натисніть на рейс для деталей:

• 🚗 Інформація про транспорт
• 👨‍✈️ Ім’я та контакт водія
• 📍 Поточна геолокація (якщо підтримується)
• 📜 Історія зміни статусів
• ⚖️ Введені дані зважування

Прогрес виконання бізнесу:

У верхній частині картки бізнесу відображається загальний прогрес:

• 🚚 0 MT Delivered → 150 MT Delivered (оновлюється після кожного завершеного рейсу)
• 📦 Загальний обсяг: 300 MT
• ⏳ Залишилось доставити: 150 MT

💡 Поради та можливі помилки

Поради:

• ✓ Підписуйте контракт швидко — доставка не почнеться без підпису обох сторін
• ✓ Додавайте точки доставки одразу після підписання контракту
• ✓ Перевіряйте номер телефону водія перед номінуванням — від цього залежить реєстрація
• ✓ Номінуйте транспорт заздалегідь, щоб водій встиг підготуватися
• ✓ Завантажуйте ТТН і тримайте копію для звірки
• ✓ Слідкуйте за статусами рейсів у реальному часі
• ✓ Якщо водій затримується — зв’яжіться з ним напряму для уточнення

⚠️ Можливі помилки:

❌ Не можу підписати контракт:

• Переконайтеся, що ви авторизовані та маєте права на підписання
• Перевірте, чи не підписала вже одна сторона — можливо, очікується ваш підпис
• Оновіть сторінку та спробуйте знову
• Зв’яжіться з технічною підтримкою, якщо помилка повторюється

❌ Не з’являється кнопка “Add Point”:

• Переконайтеся, що контракт підписано обома сторонами
• Перевірте, чи маєте ви відповідальність за логістику в цьому контракті
• Якщо контракт DAP і ви продавець — кнопка має з’явитися
• Якщо контракт FCA і ви покупець — кнопка має з’явитися

❌ Повідомлення: “Delivery point A is missing”:

• Ви ще не додали необхідну точку доставки
• Натисніть ”+ Add Point” і заповніть інформацію
• Переконайтеся, що додали правильну точку (А або Б) згідно з типом контракту

❌ Не можу номінувати транспорт:

• Перевірте, чи додано всі необхідні точки доставки (А і Б)
• Переконайтеся, що контракт підписано обома сторонами
• Перевірте, чи маєте ви відповідальність за логістику
• Заповніть всі обов’язкові поля: номер авто, номер причепа, ім’я та телефон водія

❌ Водій не отримав SMS/повідомлення:

• Перевірте правильність номера телефону (формат +380XXXXXXXXX)
• Переконайтеся, що у водія є мобільний зв’язок
• Якщо водій зареєстрований — перевірте, чи не заблокував він бота
• Спробуйте зв’язатися з водієм напряму і надішліть посилання на бота вручну

❌ Статус рейсу не оновлюється:

• Статус оновлюється на стороні водія через Telegram-бот
• Переконайтеся, що водій підтвердив рейс і змінює статуси
• Оновіть сторінку для отримання останніх даних
• Якщо водій не змінює статуси — зв’яжіться з ним для уточнення

❌ Не можу завантажити ТТН:

• Переконайтеся, що вояж створено (транспорт номіновано)
• Перейдіть до вкладки “Documents” і знайдіть ТТН
• Якщо документа немає — зв’яжіться з технічною підтримкою
• Спробуйте оновити сторінку

🔄 Схема флоу бізнесу

Покроковий флоу:

1. ✅ Завершення ордера → Створення бізнесу
2. 📄 Генерація контракту → Підписання обома сторонами
3. 📍 Додавання точок доставки → Заповнення точки А або Б
4. 🚛 Номінування транспорту → Реєстрація/сповіщення водія
5. 🚢 Створення вояжу → Генерація ТТН
6. 🚗 Виконання рейсу → Зміна статусів через Telegram-бот
7. ✅ Завершення доставки → Оновлення прогресу в бізнесі
8. 💰 Оплата та закриття → Завершення бізнесу

🎯 Що ви отримали

Тепер ви знаєте повний цикл роботи з бізнесом: від створення після завершення ордера до підписання контракту, організації доставки, номінування транспорту та відстеження виконання рейсів.

✨ Система автоматизує більшість процесів, включаючи:

• 📄 Генерацію документів (контракти, ТТН)
• 📱 Реєстрацію водіїв через SMS та Telegram
• 📊 Оновлення статусів у реальному часі
• 🔔 Сповіщення для всіх учасників
• 📈 Відстеження прогресу виконання