Перейти до змісту

Модуль «Авто-транспорт» (Fleet) — інструкція менеджера-впроваджувача

Серія: інструкції для менеджера-продавця та впроваджувача модулів DOP. Документ 2 з ланцюга. Сусіди: 01 — Облік зерна · 03 — Логістика та консолідація (готується). Навігація — README.

Кому: менеджеру, що продає та впроваджує DOP. Приклади — на демо-даних ТОВ «Зерноплюс» (анонімізований НІБУЛОН); інженерний опис даних — blueprint засіювання.

Backend-код: fleet / shipcore_auto (vertical-модуль; ЖД-сестра — shipcore_rail). Розділ в UI: «Авто».

1. Що це за модуль і навіщо

Авто-транспорт (Fleet) — вертикальний модуль DOP для автопарку та вантажних перевезень: транспортні компанії, логістичні відділи виробників, агрохолдинги з власним парком, експедитори з власними авто. Веде ТЗ і водіїв, замовлення на перевезення, подорожні листи (з розрахунком пального й зарплати), ТТН (товарно-транспортні накладні), пальне, обслуговування та амортизацію.

Зерновий контекст серії: коли зерно відвантажується з елеватора в порт автотранспортом, саме цей модуль формує ТТН і веде рейс. Поряд працює залізнична сестра shipcore_rail (зерно в порт Миколаїв їде і вагонами, і авто).

Болі клієнта, які закриває модуль

Біль Як закриває DOP
Подорожній лист, пальне і зарплата водія рахуються в трьох місцях Один документ «Подорожній лист» рахує пальне за нормами + відрядну зарплату + KPI
ТТН друкуються в Word, не зв'язані з рейсом і складом ТТН (TransportInvoice) зв'язана з рейсом, відправником/отримувачем, вантажем; генерується з відвантаження
Тариф «домовились по телефону», немає прозорості Тарифний рушій: за тонно-км / км / шкалою відстаней (ContractSpecification + TariffCalculator)
Не видно, де зараз авто GPS-трекінг (Wialon, платний плагін) + e-ТТН з електронним підписом
Витрати на пальне й ремонт «розмиті» Журнали пального/ремонту/амортизації агрегатів, прив'язані до ТЗ
Собівартість км невідома CPM-аналітика (cost-per-km), бенчмарк ставок, конструктор котирувань (плагін shipcore_pricing)

Орієнтири

1С:Управління автотранспортом, Wialon (GPS), Samsara/Motive (fleet telematics), TMS-системи (Transporeon, Alpega). DOP дає парк + рейси + тарифи + ТТП/еТТН + пальне + зарплата водіїв + CPM в одному модулі, зшитому зі складом, зерном і бухобліком.

2. Ключові поняття (словник для менеджера)

  • ТЗ (Vehicle) — транспортний засіб (вантажівка / напівпричіп / причіп). Ієрархія (тягач + причіп), вантажопідйомність, норма пального, прив'язка до основного засобу (амортизація через CPM).
  • Водій (Driver) — з посвідченням, ставками, графіком.
  • Маршрут (Route) — пункти + відстань (км), використовується тарифним рушієм.
  • Замовлення (Order) — заявка клієнта на перевезення.
  • Подорожній лист (Waybill) — основний документ рейсу: завдання (WaybillTask), результати з тарифом (WaybillWorkResult), пальне, нарахування водію. Проводить пальне/ KPI/відрядну зарплату.
  • ТТН (TransportInvoice) — товарно-транспортна накладна; первинний документ на вантаж. N ТТН : 1 подорожній лист. Не робить бухпроводок (операційний документ).
  • Тариф (ContractSpecification) — ставка перевезення: фіксована / за км / за тонно-км / за шкалою відстаней.

3. Що налаштувати перед стартом (довідники)

Група Довідники Призначення
Парк ТЗ, Водії, Маршрути, Пункти (LocationPoint), Країни основа операцій
Пальне Типи пального, Норми витрати, Умови роботи, Сезонність розрахунок пального у подорожньому листі
Обслуговування Типи ТО, Вузли/агрегати, Моделі агрегатів ремонт + амортизація шин/АКБ
Зарплата Типи нарахувань, Ставки водіїв відрядно-преміальна зарплата
Тарифи ContractSpecification (підтаблиця контракту) ставки per_ton_km / per_km / шкала

Поза модулем: контрагенти (клієнт/перевізник/відправник/отримувач), організація, для CPM — основні засоби (FixedAsset) на ТЗ.

4. Документообіг (повна схема)

   ЗАМОВЛЕННЯ ──────▶ ПОДОРОЖНІЙ ЛИСТ ──────▶ ТТН (товар на борту)
   Order              Waybill                 TransportInvoice
   (клієнт, маршрут,  (завдання + результати  (відправник/отримувач/
    вантаж, ціна)      + тариф + пальне +       перевізник, вантаж,
        │              зарплата водія)          вага, місця)
        │                  │  ▲                      ▲
        │                  │  │ TariffCalculator      │ create_ttn_from_dispatch
        │                  │  └─ ContractSpecification │ (з відвантаження зерна)
        ▼                  ▼                           │
   (із Shop /         ПРОВОДКИ: пальне / KPI /     ◀───┘  GrainDispatch (модуль зерна)
    TransportRequest)  відрядна зарплата                  GoodsShipment (Essentials)
                       (FuelLedger / Piecework)

   Супутні: Заправка (VehicleRefueling→FuelLedger) · Злив пального (FuelDrain) ·
            Ремонт (MaintenanceRecord) · Початкові залишки · Нарахування ЗП водіям ·
            e-ТТН (ETTNDocument, Ed25519-підпис)

Документи

  • Замовлення на перевезення (Order) — заявка: клієнт, маршрут, вантаж, вага, ціна, дати. Може приходити з клієнтського кабінету (shop.TransportRequest).
  • Подорожній лист (Waybill) — рейс: завдання (пункт→пункт, вантаж, вага, відстань) → тарифний рушій рахує вартість → пальне за нормами → відрядна зарплата. Проводить пальне/ KPI/зарплату.
  • ТТН (TransportInvoice) — первинка на вантаж; генерується з відвантаження зерна (create_ttn_from_dispatch) або з відвантаження товару (GoodsShipment). Не робить бухпроводок.
  • Заправка / Злив / Ремонт / Нарахування ЗП / Початкові залишки — супутні документи парку.

Аналітика (плагін shipcore_pricing)

CPM-звіт (собівартість км), бенчмарк ставок по лейнах, Конструктор котирувань (Quote Builder — break-even + ринкова ставка), плани паливних надбавок (FSC), аксесоріали.

5. Потоки інформації (звідки/куди)

На вході: замовлення з клієнтського кабінету; відвантаження зерна (GrainDispatch) → ТТН; норми пального й тарифи з довідників.

Усередині: подорожній лист агрегує завдання → тариф (з ContractSpecification) → пальне → зарплата; журнали пального/зарплати/KPI.

На виході: - ТТН → первинка для відвантаження зерна/товару (зв'язок із модулем зерна та складом); - CPM/тарифи → живлять least-cost оптимізатор логістики (документ 03) road-ставкою за тонно-км; - бухоблік: пальне/зарплата/амортизація — у відповідні журнали/проводки.

ЖД-сестра shipcore_rail (накладні на hopper-вагони, дислокація вагонів) працює симетрично для залізничного плеча в порт — деталі рейкового плеча у документі 03.

6. Наскрізний демо-сценарій (на даних Зерноплюс)

У сценарії експорту (100 000 т пшениці + 40 000 т ячменю, Миколаїв → Єгипет) зерно їде в порт двома плечима. Авто-плече засівається разом із транспортними legs (seed_railway_waybills лінкує і авто-ТТН):

  1. Парк — на демо-тенанті ~20 ТЗ + 55 водіїв (Master Data → ТЗ / Водії).
  2. ТТН із відвантаження — для авто-відвантажень зерна з близьких до порту елеваторів (ELV-MY1, 15 км) create_ttn_from_dispatch згенерував товарно-транспортні накладні: відправник = організація-як-клієнт, отримувач = покупець, вага = тоннаж відвантаження. Показати ТТН, зв'язану з відвантаженням зерна (GrainDispatch).
  3. Подорожній лист — рейс із завданням, тарифом (за тонно-км), пальним і зарплатою водія; показати, як тариф підтягнувся з тарифного рушія.
  4. Тарифний рушій — ContractSpecification (per_ton_km) → TariffCalculator рахує вартість плеча; це ж число живить оптимізатор логістики (док 03).
  5. CPM-аналітика (плагін shipcore_pricing) — собівартість км, бенчмарк ставок, конструктор котирувань.

Зв'язок із серією: оптимізатор логістики (док 03) обирає для близьких елеваторів саме авто-плече (≤~73 км — авто дешевше), для далеких — вагони. Авто-модуль виконує це рішення: формує ТТН і веде рейс.

7. Чек-лист впровадження

  1. ☐ Парк: ТЗ (з вантажопідйомністю + норма пального) + причепи + водії.
  2. ☐ Маршрути + пункти (з відстанями — критично для тарифів).
  3. ☐ Норми пального + умови роботи + сезонність.
  4. ☐ Тарифи: ContractSpecification під контракти клієнта (per_ton_km / per_km / шкала).
  5. ☐ Ставки й типи нарахувань водіям.
  6. ☐ (опц.) Основні засоби на ТЗ для CPM-амортизації.
  7. ☐ (опц.) GPS Wialon + e-ТТН (платні плагіни).
  8. ☐ Пробний цикл: замовлення → подорожній лист → ТТН → проводки пального/зарплати.
  9. ☐ Зв'язок із зерном: ТТН із відвантаження (create_ttn_from_dispatch).

8. Точки інтеграції та зв'язок із серією

Сусідній модуль Зв'язок Документ серії
Облік зерна (shipcore_grain) Відвантаження → ТТН; вхідні рейси → приймання 01 — Облік зерна
Логістика / консолідація (logistic) CPM/тариф → least-cost план; рішення авто vs ЖД 03 — Логістика та консолідація
Залізниця (shipcore_rail) Симетричне рейкове плече в порт (hopper-вагони) у складі документа 03
Склад / Essentials ТТН ← GoodsShipment; пальне/зарплата → журнали базовий модуль
Клієнтський кабінет (shop) TransportRequest → замовлення окремий документ серії
Pricing (shipcore_pricing) CPM / бенчмарк / котирування у складі цього документа (Аналітика)

9. Інтеграція у F1-довідку (план)

Розрізання на статті при інтеграції (skill add-help-article, фреймворк frontend/core/.../Help): - Документи: замовлення, подорожній лист, ТТН, заправка, злив, ремонт, нарахування ЗП, початкові залишки. - Довідники: ТЗ, водії, маршрути, пункти, типи/норми пального, тарифи, ставки. - Аналітика: CPM-звіт, бенчмарк ставок, конструктор котирувань. - Оглядова стаття модуля = §1–§5.

Двомовні *.md + *.ua.md; ланцюгові посилання на зерно/логістику → internal-links F1.

Сусіди в серії: 01 — Облік зерна · 03 — Логістика. Інженерний опис даних: blueprint засіювання Зерноплюс.