BizMap

Створює РЕАЛЬНУ ТТН (експрес-накладну) Нової Пошти — фактичне відправлення, яке потрібно буде занести на відділення. Використовуй лише коли користувач явно просить створити накладну чи оформити відправлення — ніколи для простого розрахунку вартості (для цього є calculate_delivery_cost). Повторний виклик з тим самим orderId поверне вже створену раніше накладну, а не створить другу — це навмисно безпечно повторювати.

Зведені довідники каталогу BaseLinker: список каталогів (inventories), цінові групи, склади, виробники і категорії (для першого каталогу, якщо inventoryId не вказано). Потрібен для мапінгу людських назв на числові id перед роботою із залишками чи товарами.

Облікові записи мерчанта для конкретного кур'єра — мерчант може мати кілька акаунтів одного кур'єра (напр. різні договірні тарифи); якщо не вказати accountId при майбутньому створенні відправлення, використовується перший.

Повний список полів динамічної форми для створення відправлення у конкретного кур'єра — id/name/type (select/checkbox/text/date)/desc/options (варіанти для select/checkbox) — і чи підтримує кур'єр кілька відправлень одразу (multiPackages). Форма залежить від конкретного кур'єра, як він підключений саме в цього мерчанта — ОБОВ'ЯЗКОВО викликай перед тим, як питати мерчанта про дані відправлення, щоб знати, що саме питати, а не вгадувати за загальною документацією.

Список кур'єрів, підключених у мерчанта в BaseLinker (DHL, DPD, UPS тощо — залежить від того, що сам мерчант налаштував у своєму кабінеті). Обов'язковий перший виклик перед get_baselinker_courier_accounts і get_baselinker_courier_fields — courierCode для них береться звідси.

Шукає клієнта(ів) CRM BaseLinker за email/телефоном (частковий збіг), логіном, ПІБ чи назвою компанії. Повертає лише ПІБ, email, телефон і ID клієнта в CRM — без адрес, без реквізитів і без приміток.

Довідник категорій зі сторони конкретного зовнішнього магазину, підключеного до BaseLinker.

Деталі ОДНОГО товару зовнішнього магазину з повним списком варіантів (variantId, назва, sku, актуальний залишок кожного — звірено окремим живим запитом, не з кешованого поля BaseLinker). Використовуй ОБОВ'ЯЗКОВО перед update_baselinker_external_storage_stock, якщо не впевнений, чи товар має варіанти (розмір/об'єм/колір) — інакше є ризик записати залишок в variantId 0, який для товару з варіантами не відповідає жодному реальному варіанту.

Список і деталі товарів САМЕ зі сторони конкретного підключеного зовнішнього магазину (як їх бачить BaseLinker) — ціна, залишок, категорія, опис. storageId ЗАВЖДИ обов'язковий і береться з get_baselinker_storages_list — якщо мерчант не уточнив, який саме магазин, і підключено більше одного, перепитай, а не вгадуй перший з списку.

Залишки товарів САМЕ в конкретному зовнішньому магазині (окремо від залишків каталогу Inventory BaseLinker), з розбивкою по товарах і варіантах.

Залишки товарів з каталогу (Inventory) BaseLinker для конкретного каталогу. inventoryId бери з get_baselinker_catalog_reference_data.

Повні деталі одного замовлення BaseLinker за orderId — товари, статус, покупець, суми.

Довідник статусів ПОВЕРНЕНЬ BaseLinker — ОКРЕМИЙ довідник від статусів замовлень (get_baselinker_order_statuses). Використовуй перед create_baselinker_order_return, щоб передати правильний statusId самого повернення.

Довідник джерел замовлень BaseLinker (власний магазин, маркетплейси — eBay/Amazon/Allegro/Ceneo тощо) з їхніми id.

Довідник статусів замовлень BaseLinker з їхніми id. Використовуй перед тим, як передати назву статусу в інший інструмент.

Зведення продажів BaseLinker за період: кількість замовлень, сума, розбивка за статусами й джерелами. Рахується агрегацією поверх реальних замовлень (окремого статистичного методу в BaseLinker немає) — сам пагінує понад 100 замовлень, якщо треба. Сума показується ОКРЕМО по кожній валюті (мерчант може продавати на кількох маркетплейсах у різних валютах — одна цифра з однією валютою була б оманливою). За замовчуванням враховує лише підтверджені замовлення (confirmed:true — офіційна рекомендація, неперевірені можуть бути неповними); includeUnconfirmed — для діагностики чи акаунтів, де реальні замовлення довго лишаються unconfirmed (напр. ручні особисті замовлення).

Список УСІХ підключених зовнішніх магазинів BaseLinker (Shopify, WooCommerce тощо — мерчант може мати кілька одночасно) з їхніми storage_id (формат «shop_<id>»). Обов'язковий перший виклик перед рештою external-storage-інструментів — storage_id ніколи не мається на увазі за замовчуванням, лише явний параметр.

Показує хто відвідувачі сайту — розбивка за пристроєм (десктоп/мобільний) і країною — з Microsoft Clarity за останню 1-3 доби. Використовуй, коли питають хто відвідувачі сайту, з яких країн, з яких пристроїв заходять.

Показує сторінки сайту, де відвідувачі клікають марно або злляться — dead clicks, rage clicks, помилки кліків і скриптів (Microsoft Clarity), топ-10 за сумою проблем. Використовуй, коли питають де на сайті проблеми з UX, де люди клікають і нічого не відбувається, де злість/фрустрація користувачів.

Показує звідки приходять відвідувачі сайту (джерело переходу) з Microsoft Clarity за останню 1-3 доби. Використовуй, коли питають звідки люди приходять на сайт.

Показує загальний трафік сайту з Microsoft Clarity за останню 1-3 доби — сесії, унікальні відвідувачі, сторінок за сесію, час взаємодії. Використовуй, коли питають скільки людей було на сайті за добу/2/3 дні. Дані оновлюються не частіше ніж раз на кілька годин (кеш) — відповідь завжди вказує, станом на коли вони отримані.

Показує кількість покупок і суму доходу з Google Analytics 4 за період. Потребує увімкненого ecommerce-трекінгу на сайті — якщо його немає або дані порожні, інструмент прямо про це повідомляє, а не видає нулі за факт відсутності продажів. Використовуй, коли питають скільки продажів/замовлень чи доходу принесла реклама/сайт.

Показує кількість людей, що перебувають на сайті прямо зараз (дані Google Analytics 4 за останні ~30 хвилин, без вибору періоду). Використовуй, коли питають скільки людей на сайті зараз/онлайн.

Показує найпопулярніші сторінки сайту за кількістю переглядів з Google Analytics 4 за період. Використовуй, коли питають які сторінки/товари найбільше переглядають.

Показує розбивку трафіку сайту за каналом (Organic Search, Paid Social, Direct, Referral тощо) з Google Analytics 4 за період — кількість сесій і ключових подій (конверсій) на кожен канал. Використовуй, коли питають звідки приходять відвідувачі чи покупці.

Показує загальний трафік сайту з Google Analytics 4 за період — сесії, унікальні користувачі, перегляди сторінок. Використовуй, коли питають скільки людей заходило на сайт, скільки було сесій чи переглядів за тиждень/місяць тощо.

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

Отримує поточні дані товару Хорошоп за артикулом (SKU) — ціну, наявність, характеристики. Використовуй перед import_horoshop_product, щоб звірити реальні ключі характеристик цього магазину.

Шукає покупця в KeyCRM за ID, телефоном або email.

Отримує повні деталі одного замовлення KeyCRM — покупця, товари, статус.

Повертає довідники KeyCRM: статуси замовлень, джерела, способи оплати, служби доставки, теги і типи витрат — з їхніми id. Використовуй перед тим, як передати назву статусу/джерела/способу оплати/тегу в інший інструмент, якщо не впевнений, що назва існує в системі клієнта.

Отримує повні деталі одного замовлення Prom.ua — дані покупця, адресу, товари. Використовуй перед створенням накладної Нової Пошти, щоб узяти дані отримувача без ручного передруку.

Отримує поточну ціну та залишок товару на Prom.ua за його ID або зовнішнім артикулом. Використовуй для звірки цін/залишків між каналами продажу.

Отримує повні деталі одного замовлення Rozetka — дані покупця, адресу доставки, службу доставки. Використовуй перед створенням накладної Нової Пошти, щоб узяти дані отримувача без ручного передруку.

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

Отримує список складів/точок видачі Shopify (locations) із їхніми ідентифікаторами. Потрібно перед операціями із залишками товару по конкретному складу.

Отримує повні деталі одного замовлення Shopify — товари, адресу доставки, дані покупця. Використовуй orderId зі списку list_shopify_orders (повний ідентифікатор виду gid://shopify/Order/...).

Отримує деталі товару Shopify — варіанти, артикули (SKU), ціни, залишки по кожному варіанту. Використовуй productId зі списку list_shopify_products.

Деталі одного замовлення Sitniks за id — покупець, товари, сума, статус.

Список повернень BaseLinker з фільтрами — по конкретному замовленню (orderId), по даті, по статусу. Максимум 100 за виклик.