Як користуватися ФОМОЮ

Що це: ревізор рахунків перевізників. За кожну посилку ми планували заплатити суму за контрактом (її рахує Mira в момент відправки) — ФОМА звіряє її з тим, що перевізник реально зняв у рахунку, і пояснює кожну різницю.

Робочий цикл (як користуватись)

1. «Рахунки» — головний екран. Вкладки перевізників показують к-сть рахунків і сумарну різницю (червона = переплата). У списку по кожному рахунку: Netto / План / Факт / Різниця. Червоний рядок = переплата понад 1 €.
2. Клік по рахунку — всі його посилки: факт по рядках розшифровки, факт з розкиданими надбавками, наш план, різниця і причина. Фільтр «тільки розбіжності», сортування по будь-якій колонці, кожна посилка клікається в Odoo (delivery).
3. «Посилки» — Kanban як у старої ФОМИ: колонки-стани (Проблемні / Все ОК / Повернення / План не рахувався / Нема в Odoo), причина написана на картці; фільтри причина/перевізник/місяць/пошук звужують усі колонки.
4. «Штрафи» — всі сервісні донарахування по місяцях: графік перевізник × тип збору, з drill-down до посилки і виходом в Odoo. Невідомі послуги показуються поіменно («додаткові послуги: …»).
5. «Тарифи» — контрактні ставки з підтвердженням (КОНТРАКТ ✓ / рахунки ✓) і документи-першоджерела, які відкриваються прямо тут.
6. «Покриття» — службова: де ще нема розшифровок і на яку суму.

На що звертати увагу (пріоритет згори вниз)

1. 🔴 «відправки нема в Odoo — можливо чужа посилка» (червоний рядок) — перевізник зняв гроші за трекінг, якого нема в наших відправках. Перевірити руками; якщо чужа — Widerspruch.
2. 🟠 «негабарит / Sperrgut / ручна обробка» — доплати 35–56 € за розмір. Ставка контрактна, але ЧИ правомірно посилку визнали негабаритом — питання до упаковки (задача Стаса про оптимізацію) або до рекламації.
3. 🟡 «тариф/вага відрізняється» — системний дрейф (плаваючі надбавки, застарілий план). Малі суми поштучно, великі в масі.
4. «нез'ясовано» — те, що правила ще не пояснюють: розбирати руками, знахідки перетворюємо на нові правила.
5. «повернення (Retoure)», «план не рахувався» (дропшипи) — нормальні кейси без плану, не тривога.

Що покрито, а що ні (чесна карта)

• DHL Paket: груд.2025–сьогодні — 100% рахунків, різниця ≈0 (еталон коректності методики). Старіше 365 днів портал DHL не віддає.
• DPD: всі рахунки 2025–2026 (CSV де є, решта з PDF — та сама точність). CSV за лют–лип 2026 дозапитані в DPD (тікет #549258).
• GLS: лют.2026+ повністю; «переплата» тут переважно через те, що до липня наш план не містив надбавок GLS (див. Тарифи) — це дірка плану, не грабіж GLS.
• DHL Freight — палети: зонні тарифи є, але per-посилка розшифровок не існує — звірка по палетах у беклозі. DHL Hauptvogel виведений з ФОМИ (2026-08-11): тарифів не існує ніде, свідомо ручний потік (Оксана перевіряє кожен рахунок руками).

Модель розрахунку

• Рядки розшифровки (CSV/XLSX/PDF) агрегуються до посилки; відсоткові надбавки, які перевізник веде окремими позиціями (Energie/EFS), розкидаються пропорційно — коефіцієнт видно в картці рахунку (×1.249 = +24,9% надбавок).
• План = stock.picking.x_studio_expected_delivery_price (Mira, момент відправки). Матчинг: трекінг → референс з розшифровки (ім'я відправки) → для GLS номер+контрольна цифра.
• Дані оновлюються самі щодня ~08:10 Києва (sync нових рахунків + парсинг). Кнопково: POST /api/sync, POST /api/parse (Bearer).

Словник сервіс-кодів (з розшифровок)

• DPD: EFZ — енергонадбавка (сам % — агрегатною позицією, у нас контрактні −50%); SG — збір за безпеку (0,15 €); UE — негабарит (35,00 €); SPZ — Sperrgut; NC/NCV/NCM — ручна обробка (6,00 €); Speditionszuschlag — 55,00 € (>40 кг / >250 см).
• GLS: Nicht sortierfähiges Gut — несортовна посилка (ручна обробка, головний GLS-збір) — рахуємо як «негабарит»; LimitedQuantitiesService — небезпечні вантажі (LQ); Verzollung EFTA/GB — митне оформлення.

Changelog

• 2026-08-12 — дашборд «Штрафи»; доп. послуги поіменно; GLS «Nicht sortierfähiges Gut» і DPD «Übergröße/Sped» рахуються як негабарит, BusinessParcel — як базовий продукт (дрейф тарифу, не збір).
• 2026-08-11 — тарифи з першоджерелами і вбудованим переглядачем; повернення й «чужі посилки» розділені; щоденний авто-прогін; липкі заголовки таблиць.
• 2026-08-10 — фаза 1–2: sync, покриття, парсери PDF/CSV/XLSX, звірка план/факт.