> Усі статті WIKI Helomi: /wiki/llms.txt

# Доставка

«Доставка» — усі ТТН з угод одним списком, як розділ «Доставка» у KeepinCRM. Тут видно, де кожна посилка, хто її одержувач, яка післяплата й вартість доставки, на якому етапі угода і коли почнеться платне зберігання. Звідси масово оновлюють статуси й друкують стікери, а відкрити угоду можна одним кліком. Вигляд «Статистика» показує, на який день після прибуття клієнти забирають посилки і скільки відсотків повертається — окремо по кожній службі.

## Можливості
- Усі ТТН з усіх угод: Нова Пошта, Укрпошта, Meest, Rozetka Delivery, Kasta.
- Колонки як у KeepinCRM: «Створено», «Адреса», «Відправник», «Головний відповідальний», «Клієнт», «Угода», «ТТН», «Післяплата», «Вартість доставки», «Статус», «Етап угоди», «Прибуло», «Платне зберігання», «Планована дата доставки», «Список відправлень». Додатково: «Дата отримання», «Контроль оплати», «Філія», «Телефон одержувача».
- Фільтри: «Створено», «Дата отримання», «Філія», «Тип доставки», «Етап», «Сплачено», «Статус», «Відправник», «Головний відповідальний», «Контроль оплати», «Список відправлень».
- Пошук за ТТН, телефоном, клієнтом, номером угоди, адресою.
- Сортування кліком по назві колонки.
- Масові дії: «Оновити статуси», «Скопіювати ТТН».
- «Статистика»: по кожній службі — % повернень, на який день після прибуття забирають посилку (1-й, 2-й… день, наростом), медіана, частка в межах безкоштовних днів, по місяцях.
- Внизу — суми післяплати й вартості доставки за всіма знайденими ТТН, «Рядків на сторінці» і «Всього».

## 1. Налаштування
Окремо налаштовувати нічого не потрібно: ТТН з'являються тут, коли їх створюють в угоді («Доставка» → «Створити ТТН»), записують вручну або вони приходять з маркетплейсів.

Доступ дає адміністратор: «Налаштування» → «Розділи» → «Доставка» (типово відкрито всім). Людина бачить лише ТТН угод тих воронок і брендів, які їй відкриті (як в «Угодах»).

«Платне зберігання» рахується від дня, коли посилка прибула у відділення, плюс безкоштовні дні з налаштувань ШІ Ростіка («Інтеграції» → «ШІ» → «Ростік»). Дата червона — платне зберігання вже йде.

## 2. Знайти посилку
1. Головне меню → «Доставка».
2. У полі пошуку вгорі введіть номер ТТН, телефон, ім'я клієнта, номер угоди або частину адреси → Enter.
3. Клієнт і угода в рядку — посилання: картка клієнта чи угоди відкриється одразу.

Типово список показує ТТН, створені за останні 30 днів. Щоб побачити старіші, змініть «Створено» у фільтрах або очистіть його хрестиком.

На телефоні кожна ТТН — картка: служба, номер, статус, етап, клієнт, угода й адреса. Фільтри відкриваються кнопкою «Фільтри».

## 3. Фільтри
Кнопка «Фільтри» поруч із пошуком відкриває чи ховає панель. Число на кнопці — скільки фільтрів вибрано.
- «Створено» і «Дата отримання» — період: дата «від» і «до» (включно).
- «Тип доставки» — служба.
- «Статус» — «Створено», «В дорозі», «У відділенні», «Отримано», «Повернення», «Скасовано».
- «Етап» — етап угоди (за воронками).
- «Сплачено» — «Сплачено», «Частково», «Не сплачено» (за оплатами угоди).
- «Контроль оплати» і «Список відправлень» — як їх вибрали у формі «Створити ТТН». Для ТТН, створених раніше (до 15.10.2026) чи вручну, ці поля порожні.
- «Скинути» повертає типовий вигляд: останні 30 днів, без інших фільтрів.

## 4. Колонки
«⋮» праворуч від «Фільтрів» → «Колонки». Поставте чи зніміть галочки. «Як було» повертає типовий набір. Вибір зберігається на цьому пристрої.

## 5. Дії з ТТН
«⋮» на початку рядка:
- «Відкрити угоду».
- «Скопіювати ТТН». Номер копіюється й кнопкою поруч із ним.
- «Роздрукувати стікер» — PDF 100×100, як у блоці «Доставка» угоди. Значок принтера біля номера означає, що стікер уже друкували.
- «Оновити статус» — запит до перевізника. Етап угоди змінюється за «Пов'язаними статусами» налаштувань перевізника.
- «Відкрити на сайті служби».

Створити, змінити чи видалити ТТН можна в угоді, у блоці «Доставка».

## 6. Оновити статуси кількох ТТН
1. Поставте галочки в рядках. Галочка в шапці таблиці вибирає всю сторінку.
2. На чорній панелі виберіть «Оновити статуси» (до 100 ТТН за раз) або «Скопіювати ТТН» (номери стовпчиком).
3. Скасовані ТТН і ТТН без номера пропускаються, під панеллю видно, скільки оновлено.

Те саме для всієї сторінки — «⋮» → «Оновити статуси на сторінці». Статуси відкритих угод і так оновлюються самі кожні 5 хвилин.

## 7. Статистика: на який день забирають і % повернень
1. У шапці перемкніть «Список | Статистика» на «Статистика» (або «⋮» → «Статистика»). Вибір запам'ятовується на цьому пристрої.
2. Над картками виберіть період: «30 днів», «3 місяці», «Пів року», «Рік». Це той самий фільтр «Створено»: свої дати можна задати в панелі «Фільтри».
3. Угорі — підсумок по всіх службах: скільки відправлень, % повернень, скільки забрали в 1-й день, медіана.
4. Нижче — картка на кожну службу (Нова Пошта, Укрпошта, Meest, Rozetka Delivery, Kasta):
   - «Повернення» — % повернень із завершених посилок (отримано + повернення); ті, що ще в дорозі чи у відділенні, не рахуються.
   - «Медіана» — день, до якого забирають половину посилок.
   - «До N-го дня» — скільки посилок забрали за безкоштовні дні зберігання.
   - Таблиця днів: «Забрали» — скільки посилок забрали саме цього дня (% і кількість), «Наростом» — скільки вже забрали до кінця цього дня включно. Дні після безкоштовних позначені червоним — там уже платне зберігання.
   - «По місяцях» — отримано, повернення і % повернень за місяцями створення ТТН.
5. Усі фільтри панелі діють і на статистику: служба, етап, філія, відправник, відповідальний, пошук.

Як рахується:
- 1-й день — день, коли посилка прибула у відділення (за київським часом). Забрали того ж дня — 1-й день, наступного — 2-й.
- Дати «Прибуло» і «Дата отримання» записує трекінг служби: Нова Пошта віддає обидві, Укрпошта, Meest і Rozetka Delivery — дату тієї події, яку трекінг побачив (статуси оновлюються кожні 5 хвилин). Якщо служба не дала дати прибуття, береться мить, коли посилку вперше побачили у відділенні.
- Посилки без цих дат у днях не враховуються (видно «без дат N» під карткою). Коли посилок з датами менше 10, розподіл не показується: один-два випадки дають неправдиву картину.
- Безкоштовні дні зберігання беруться з налаштувань ШІ Ростіка («Інтеграції» → «ШІ» → «Ростік»), окремо для кожної служби. Змінили там — статистика одразу рахує за новими днями.

## Можливі помилки
| Що ви бачите | Чому | Що зробити |
| --- | --- | --- |
| «ТТН за цими фільтрами нема» | Період «Створено» або інші фільтри відсікли все | «Скинути» або розширте період |
| «Серед вибраних нема активних ТТН (скасовані й без номера не трекаються)» | Вибрано лише скасовані ТТН | Виберіть інші |
| «Перевізник не відповів: …» | Сервіс перевізника недоступний | Повторіть пізніше |
| Розділу «Доставка» нема в меню | Адміністратор не відкрив розділ або ви сховали його в «Моєму меню» | Попросіть адміністратора або увімкніть у «Моє меню» |
| У картці служби «Служба не дала дат прибуття й отримання» | Служба не віддає ці дати (Rozetka Delivery — лише дату отримання; Meest — лише свої ТТН) або посилки старші, ніж трекінг почав їх записувати (19.10.2026) | Нічого: нові посилки з'являться в розподілі самі; % повернень рахується й без дат |
| «За цей період ТТН нема» у статистиці | Період чи фільтри відсікли все | Виберіть довший період або «Скинути» у фільтрах |

## Для ШІ-співробітників
Розділ у каталозі — `describe_section("deliveries")`.
- `deliveries_list` — список з тими самими фільтрами й пошуком: `q`, `date_from`, `date_to`, `received_from`, `received_to`, `office`, `service`, `stage_id`, `paid`, `status` (`created`, `in_transit`, `at_branch`, `received`, `return`, `cancelled`), `sender`, `responsible_id`, `pay_control` (`yes`/`no`), `shipment_list`, `deal_id`, `sort`, `order`, `page`, `per_page`.
- `deliveries_refs` — довідники для фільтрів.
- `deliveries_track` — оновити статуси вибраних ТТН (`values: {ids: [...]}`, до 100).
- `deliveries_stats` — статистика по службах з тими самими фільтрами (`date_from` — період, `days_max` — скільки днів окремо, типово 10): `carriers[]` і `total` з `outcomes`, `return_pct`, `days.hist` (`day`, `pct`, `cum_pct`, `count`), `days.median`, `days.within_free_pct`, `months[]`. Лише читання.

Створити ТТН, надрукувати стікер чи оновити одну ТТН — інструментами угоди `shipping_*`. Створення ТТН відправляє дані назовні, тому спершу треба запитати людину.

## Додаткова інформація
- Пов'язані статті: [Доставки і ТТН в угоді](shipping.md), [Угоди](deals.md), [Нова Пошта](int-nova-poshta.md), [Укрпошта](int-ukrposhta.md).