Обзор

База данных MySQL 8.0 содержит две таблицы:

Подключение настраивается через env-переменные. Локально — Docker Compose (docker-compose.yml). На Railway — встроенный MySQL plugin с переменными MYSQLHOST, MYSQLPORT, MYSQLUSER, MYSQLPASSWORD, MYSQLDATABASE. Поддерживается также MYSQL_URL / DATABASE_URL как connection string.

Таблица orders

Хранит все заказы. Индексированные колонки позволяют быстро фильтровать по источнику, статусу и дате. Полный JSON объекта заказа хранится в колонке data.

Структура JSON объекта заказа (data)

Структура items[]

Структура extras[]

Пример строки таблицы orders

order_id   : "abc123xyz"
status     : "fulfilled"
webflow    : "SONR Music"
shop       : "SONR Music Shop"
accepted_on: "2026-03-15T10:42:00"
data       : {"orderId":"abc123xyz","status":"fulfilled","webflow":"SONR Music",
              "acceptedOn":"2026-03-15T10:42:00Z","customerPaid":{"value":19900},
              "items":[{"variantId":"abc","product":"SONR Music x2",
              "variant":"Color: Coral","price":16800,"count":1}],
              "extras":[{"type":"shipping","price":3100}],...}

Таблица app_data

Key-value хранилище. Ключ — строка, значение — JSON сериализованный в TEXT. Все операции через ON DUPLICATE KEY UPDATE — безопасный upsert.

Ключи app_data

Пример строки таблицы app_data

key_name: "regions"
value   : [{"name":"Europe","countries":["Austria","Belgium","Bulgaria",...]},
           {"name":"North America","countries":["United States","Mexico",...]},
           ...]

Операции с базой данных

Все операции реализованы в db.js через пул соединений (mysql2/promise, лимит 10 соединений).

Endpoints API

Структура страницы

В шапке — hero-баннер с выбором периода (From / To + кнопка Apply). Под баннером — переключатель вкладок. Apply применяет выбранный период к активной вкладке.

Подробная документация — в отдельных статьях:

• Dashboard · Webflow SONR Music →
• Dashboard · Webflow SONR Coach →
• Dashboard · Shopify →
• Dashboard · Amazon →

Источники данных

Выбор периода

Поля From и To в hero-баннере. По умолчанию — 2026-03-01 → 2026-03-31. После изменения нажмите Apply — все блоки пересчитываются.

Фильтрация по UTC-дате: из acceptedOn берётся slice(0, 10). Базовый фильтр: webflow === "SONR Music" и shop === "SONR Music Shop".

KPI-карточки

Четыре карточки — сводка по всем заказам SONR Music Shop за период.

Расчёт блоков 1–4 · item-by-item с пропорциональным распределением

Блоки SONR Music, SONR Music 2, SONR Music Multisport, SONR Accessories используют единую формулу, реализованную в computeMusicBlockMetrics(orders, mainType):

• Quaiifying orders — заказы где есть хотя бы один SKU нужного типа (Music / Music 2 / Multisport / Accessories соответственно)
• In-block items для блоков 1–3 = items типа mainType + items типа "Accessories". Для блока 4 (Mix) — items любого из 3 main-типов + "Accessories". Для блока 5 — только "Accessories"
• Block share для каждого заказа = (Σ price in-block items) / (Σ price всех items). Если все items в заказе принадлежат блоку — share=1, иначе меньше
• Product / Accessories revenue, q-ty — только in-block items
• Shipping / Discount Shipping / Tax / Discounts — соответствующий extras[].price × share для каждого заказа
• Gross Revenue = Product + Accessories + Shipping + (−Discounts) + (−Discount Shipping) — Tax не включается
• «{type} revenue» (нетто) = productRevenueNet = productRevenue + discount + discountShipping — выручка товара минус прораченные на блок скидка и скидка на доставку (обе отрицательные). Именно это значение показывает плитка «SONR Music revenue» и аналоги; отдельные плитки Discount / Discount Shipping остаются для справки

Заказы с двумя и более main-типами (например SONR Music + SONR Music Multisport) НЕ попадают в Блоки 1–3 — они идут только в Block 4 (Mix). Items без типа в каталоге попадут в Block 6 (Other Orders).

Секция 1 · Product SONR Music

Включает заказы с хотя бы одним SKU типа "SONR Music". Связь: items[].variantId = skus[].skuId в каталоге.

Прогресс-бар

Процент fulfilled. Справа — абсолютные значения fulfilled и unfulfilled.

Подписи тайлов на странице (UI)

Подписи метрик на странице уточнены, чтобы было понятно, что входит в каждое число. Применяются ко всем 6 блокам Webflow SONR Music — продукт в подписи меняется по блоку (SONR Music / SONR Music 2 / Multisport / Mix / Accessories / Coach-Music).

Блок 5 (Accessories) — тайл «Accessories revenue» там показывает основную выручку блока (продукт = аксессуары), поэтому без «from … order».

Секция 2 · Product SONR Music 2

Заказы с хотя бы одним SKU типа "SONR Music 2". Логика метрик идентична Секции 1. SKU x2/x3 имеют skuid_main_product_qty = 2 или 3.

Секция 3 · Product SONR Music Multisport

Заказы с хотя бы одним SKU типа "SONR Music Multisport". Логика идентична Секциям 1 и 2 — в т.ч. tile SONR Music Multisport revenue показывает Σ item.price минус блочные Discount и Discount Shipping.

Mix-исключение: если заказ одновременно содержит items нескольких main-типов (например SONR Music + SONR Music Multisport), он исключается из Блоков 1–3 и попадает только в новый Block 4 "SONR Music Mix". Это применяется к Блокам 1, 2, 3 одинаково.

Секция 4 · SONR Music Mix

Заказы, в которых одновременно представлены SKU двух или более main-типов из множества {"SONR Music", "SONR Music 2", "SONR Music Multisport"}. Цель — иметь отдельный счёт для cross-product покупок, не "размазывая" их по блокам 1–3.

Фильтр:

distinct main-types in items[] ≥ 2
&& (acceptedOn в выбранном диапазоне)

Реализован в [app.js renderDashboard] через хелпер isMusicMixOrder(o). Эта же функция используется как negative-фильтр для блоков 1–3.

Метрики: вызов computeMusicBlockMetrics(mixOrders, ["SONR Music", "SONR Music 2", "SONR Music Multisport"]) — функция принимает массив типов и трактует все их как "main". productRevenue = Σ item.price для items любого из 3 main-типов. productQty учитывает skuid_main_product_qty как обычно. Tile "Products revenue" показывает productRevenue минус блочные Discount и Discount Shipping (нетто), плитка Discount остаётся.

SKU breakdown: две группы — "SONR Music + Music 2 + Multisport (mix)" (предикат сматчит любой main-тип) и "SONR Accessories (from Music orders)" (если есть). Уникальные groupId = mix / accmix и offsets 11000/12000 чтобы не было коллизий с другими блоками.

Export-chip: в Block 8 (form) добавлен chip data-type="__mix__" с лейблом "Mix". musicOrderPrimaryType возвращает "__mix__" для заказов с distinct main-types ≥ 2 — этот код используется и в filtering, и в CSV-Type-колонке.

Секция 5 · SONR Accessories

Заказы с типом "Accessories" и без SONR Music / Music 2 / Multisport SKU — чисто аксессуарные заказы.

Секция 6 · B2B

Источник: Music-заказы, которым на под-вкладке Orders Channels вручную выставлен Channel = B2B (хранится в поле order_type === "B2B"). Такие заказы исключаются из блоков 1–5 (фильтры блоков работают по autoMusicOrders = musicShopOrders.filter(o => o.order_type !== "B2B")), чтобы не было двойного учёта, и показываются здесь отдельным блоком.

Метрики: computeMusicBlockMetrics(b2bOrders, ["SONR Music","SONR Music 2","SONR Music Multisport"]) — как у блока Mix: в Product revenue / q-ty идут все Music-товары, аксессуары — отдельным тайлом, order-level shipping/tax/discount/discount-shipping проратируются по доле in-block items. Тайлы и SKU-разбивка — те же, что у других блоков. KPI-карточки вверху страницы по-прежнему считают B2B-заказы (B2B — под-классификация, а не отдельный storefront).

Перевести заказ обратно в Auto — выбрать Channel = Auto в списке (поле order_type очищается).

Секция 7 · Other Orders

Все items из autoMusicOrders (Auto-заказы, без B2B), чей тип не входит в блоки 1–5 ("SONR Music", "SONR Music 2", "SONR Music Multisport", "Accessories"). Сюда попадают незатегованные SKU и SKU других линеек.

Клик по строке раскрывает полные детали заказа (items, customer, shipping, extras).

Секция 8 · Products Webflow SONR Coach

Источник: Coach-storefront заказы у которых на странице Coach → Orders Channels вручную выставлено Products In Order = SONR Music. Фильтр в коде:

o.webflow === "SONR Coach"
&& o.shop === "SONR Coach Shop"
&& o.order_products_in_type === "SONR Music"
&& (acceptedOn в выбранном диапазоне)

Зачем: это музыкальные продажи, которые физически прошли через Coach storefront. Видеть их хочется на Music-дашборде вместе с обычными Music-продажами.

Метрики: переиспользуют тот же computeMusicBlockMetrics(coachMusicOrders, "SONR Music") что и Секция 1 — то есть в Product Revenue / Product q-ty попадают только items с skuid_product_type === "SONR Music" (Coach- / Mix- / прочие SKU в этих заказах игнорируются). Tile Accessories revenue / q-ty учитывает аксессуары пришедшие в тех же заказах. Shipping / tax / discount / discount-shipping проратируются по доле Music-items в заказе.

PIO=Mix заказы намеренно исключены — попадают только заказы с PIO ровно равным "SONR Music".

SKU breakdown: две группы — "SONR Music (from Coach orders)" и "SONR Accessories (from Coach orders)". Уникальные groupId и offset чтобы не было коллизий с Секцией 1.

Секция 9 · SONR Orders export

CSV-экспорт по типу заказа. Диапазон дат берётся из top-of-page dashboard-хедера (dashDateFrom / dashDateTo) — отдельных date-input'ов в форме нет, чтобы пользоваться одним общим источником истины и не дублировать UI. Если в хедере не выбран период — кнопка возвращает status-ошибку.

Параметры формы:

• Types — 6 chip-чекбоксов (SONR Music / Music 2 / Multisport / Accessories / Other / Coach (Music)) + мастер All

Источники заказов:

• webflow="SONR Music" && shop="SONR Music Shop" — основная Music-storefront выборка (первые 5 типов)
• webflow="SONR Coach" && shop="SONR Coach Shop" && order_products_in_type="SONR Music" — попадают в выборку только когда активен chip Coach (Music) (data-type=__coach_music__)

Тип заказа = синтетический __coach_music__ для Coach-PIO=Music, иначе тип первого counted item, иначе __other__. В CSV-колонке Type: "Coach (Music)" / "Other" / "SONR Music" и т.д. Колонки: Order ID, Date, Status, Type, Customer, Email, Items, Promo, Subtotal, Total, Shipping, Tax, Discount, Payment. Имя файла: sonr-music-orders-{from}-{to}.csv.

Блок SKU — структура

После каждой секции метрик — два сворачиваемых списка SKU (основной продукт + аксессуары из тех же заказов). Кликните на заголовок группы чтобы раскрыть, на строку SKU — чтобы развернуть таблицу заказов.

SKU summary row (7 tile'ов справа от названия): Units · Total paid · Price (product) · Discount · Disc. Shipping · Tax · Shipping. Каждое значение — сумма соответствующего поля по всем item-rows этого SKU (та же логика что у detail-rows). Discount/Disc. Shipping показывают "—" если сумма ≥ 0.

Таблица заказов (12 колонок): Order ID · Customer · Variant · Status · Date · Units · Total paid · Price (product) · Discount · Discount Shipping · Tax · Shipping. Семантика:

• Units — item.count × (skuid_main_product_qty ?? 1)
• Total paid — order-level customerPaid.value (одно значение на весь заказ — для всех item-rows одно)
• Price (product) — item.price + prorated_discount (нетто после прорированной доли order-level discount по `item.price / Σ item.price`)
• Discount / Discount Shipping — order-level суммы из extras[type=discount] / extras[type=discount-shipping]
• Tax / Shipping — order-level (Σ extras[type=tax] / Σ extras[type.includes(shipping)], последнее уже net — включает discount-shipping)

Tax / Shipping / Discount / Discount Shipping — — если 0 (или не отрицательные для скидок).

Под-вкладка: Orders Channels

Страница Music имеет два sub-tab'а (как Coach): Overview (KPI + блоки выше) и Orders Channels. Переключение — pill-tabs #music-sub-tabs (data-music-sub), функции рендера renderDashboard() (Overview) и renderMusicChannels() (Channels). Список фильтруется по тому же диапазону дат из dashboard-хедера.

Каждому Music-заказу назначается Channel одним dropdown'ом (одно поле, по аналогии с Coach):

Сохранение — немедленно при выборе через POST /orders/set-order-type (то же поле и эндпоинт, что у каналов Coach; Music- и Coach-классификаторы не пересекаются, т.к. каждый фильтрует по webflow). Список разбит на сворачиваемые блоки: B2B Orders, Auto Orders (раскрыт по умолчанию — рабочий список), From Webflow SONR Coach.

From Webflow SONR Coach — Coach-storefront заказы с order_products_in_type === "SONR Music" (помеченные на Coach → Orders Channels). Показаны здесь для видимости с бейджем «from Webflow SONR Coach», только для просмотра — канал задаётся на Coach-странице (текущая логика блока «Products Webflow SONR Coach» на Overview сохранена). Клик по строке раскрывает SKU/детали заказа (переиспользуется renderCoachChDetails).

Источники данных

Выбор периода

Поля From и To в hero-баннере общие для обоих под-вкладок. По умолчанию — 2026-03-01 → 2026-03-31. После изменения нажмите Apply — все блоки и список Orders Channels пересчитываются.

Фильтрация по UTC-дате: acceptedOn.slice(0, 10). Базовый фильтр всех блоков: webflow === "SONR Coach" AND shop === "SONR Coach Shop".

Под-вкладки

Страница Coach разделена на 2 под-вкладки (pill-tabs) с общим date-range header'ом:

Как работает переключение: клик по pill-tab меняет CSS hidden у контейнеров #coach-sub-overview и #coach-sub-channels. При переключении на Overview вызывается renderDashboardCoach() — это перечитывает весь в-памяти массив orders и пересчитывает все метрики с текущим date-range. При переключении на Orders Channels вызывается renderCoachChannels() — та же дата-фильтрация, но список для ручного редактирования.

Общие данные: оба sub-tab работают над одним orders массивом (загруженным при старте страницы). Изменение канала через Orders Channels мутирует объект заказа в orders[] in-place (поле order_type) — при следующем переключении на Overview новая классификация отразится сразу без reload.

Sub-tab: Overview — KPI-карточки

Четыре карточки — сводка по всем Coach-заказам за период.

Sub-tab: Overview — Классификация в 8 блоков

Каждый Coach-заказ попадает ровно в один обычный блок (1–6 и 8). Блок 7 — агрегированный Combined view, заказы в нём не классифицируются отдельно. Алгоритм classifyCoachOrder(order):

1. Если все items в заказе имеют skuid_product_type === "Accessories" → блок 6 SONR Accessories (приоритет над order_type)
2. Иначе если order_type ∈ {"Direct", "Direct Customers", "B2B", "B2B Customers", "Dealers"} → соответствующий блок 1–5
3. Иначе → блок 8 Other Orders (нет order_type или значение вне 5 каналов)

Сумма заказов блоков 1, 2, 3, 4, 5, 6, 8 = Total Orders из KPI-карточек.

Блок 7 — Combined view: read-only агрегация. def.combinedFrom = ["Direct Customers", "__accessories__"] — заказы из блоков 2 и 6 собираются через flatMap и считаются через тот же computeCoachBlockMetrics. Заказы остаются в исходных блоках 2 и 6. SKU-разбивка режим "all" — показывает все SKU (Coach + Accessories вместе). Tile "SONR Coach revenue only" во всех блоках (включая combined) показывает нетто coachOnlyRevenueNet.

Метрики каждого блока

В каждом блоке отображается единый набор тайлов (некоторые скрыты в блоках 6 и 7 — см. ниже). Расчёт реализован в computeCoachBlockMetrics(blockOrders).

Скрытые тайлы в блоках 6 и 7

Прогресс-бар

Внизу каждого блока — процент fulfilled. Справа абсолютные значения fulfilled и unfulfilled.

SKU-разбивка

Под прогресс-баром — сворачиваемый список SKU из заказов блока. Для блока 6 SONR Accessories — только Accessory SKU. Для блоков 1–5 и 7 — non-Accessory SKU. Клик на строку SKU разворачивает список заказов с Order ID, Customer, Variant, Status, Date, Price.

SONR Orders export

Под 8 блоками — секция для выгрузки CSV-отчёта по Coach-заказам. Диапазон дат берётся из top-of-page dashboard-хедера (dashDateFrom / dashDateTo) — отдельных date-input'ов в форме нет, чтобы не дублировать UI и иметь один источник истины. Если в хедере не выбран период — кнопка возвращает status-ошибку.

Параметры формы

• Channels — 7 chip-чекбоксов (Direct / Direct Customers / B2B / B2B Customers / Dealers / SONR Accessories / Other Orders) + мастер All
• All — заполненный navy-чип, переключает все 7 chip'ов разом. Если отжать любой chip — All автоматически отжимается

Логика фильтра

Заказ попадает в выгрузку если: webflow === "SONR Coach" AND shop === "SONR Coach Shop" AND acceptedOn в диапазоне AND classifyCoachOrder(order) ∈ выбранные каналы.

CSV-колонки

Имя файла: sonr-coach-orders-{from}-{to}.csv. Если фильтры не дали результатов — статус "No orders match the selected filters", файл не скачивается.

Sub-tab: Orders Channels

Позволяет вручную присвоить каждому Coach-заказу два ортогональных поля: Channel (order_type) и Products In Order (order_products_in_type). Функция рендера: renderCoachChannels(). Список фильтруется по дате из Dashboard-хедера (те же From/To что и в Overview).

Персистентность: оба поля входят в PRESERVED_ORDER_FIELDS — при Quick/Auto Sync с Webflow они автоматически re-attach'атся к incoming payload. Поля не перезаписываются синком.

Возможные значения order_type

Блок 1 · Unassigned Orders

Фильтр: !order_type && !order_products_in_type — заказы где не задано ни одно из двух полей. Колонки: Order ID · Date · Status · Customer · Promo · Amount · Channel · Products In Order. Promo извлекается из extras[].name (regex \(([^)]+)\)).

Batch-режим: правки накапливаются в pending state — строка подсвечивается тёплым жёлтым, в тулбаре появляется счётчик "N pending changes". Кнопка Submit changes сохраняет всё параллельно (Promise.all) через POST /orders/set-order-type и POST /orders/set-products-in-type. После submit вызывается renderCoachChannels() — заказы автоматически переезжают в нужные блоки 2/3/4.

Если задан Channel → заказ появится в Блоке 2. Если задан Products In Order (SONR Music или Mix) → в Блоке 3 или 4. Если задано оба — в обоих блоках одновременно (ортогональные классификации). Заказ исчезает из Блока 1 только когда заполнены оба поля или когда только первое поле становится отличным от пустого — по факту исчезает как только любое из двух полей установлено.

Блок 2 · Assigned Orders Coach

Фильтр: !!order_type — заказы с любым заданным каналом. Свёрнут по умолчанию. В dropdown можно изменить канал или сбросить ("— select —" → поле удаляется через db.setOrderField, заказ уходит обратно в Блок 1 если и PIO не задан). В отличие от Блока 1, изменение сохраняется немедленно при выборе значения в dropdown (нет Submit).

Блок 3 · Assigned Orders SONR Music

Фильтр: order_products_in_type === "SONR Music". Свёрнут по умолчанию. Заказ может одновременно быть в Блоке 2 (если задан order_type) и здесь — это независимые поля. Dropdown "Products In Order" тоже доступен здесь (немедленное сохранение).

Блок 4 · Assigned Orders SONR Mix

Фильтр: order_products_in_type === "Mix". Логика аналогична Блоку 3. Заказ с order_type + order_products_in_type = "Mix" присутствует в Блоках 2 и 4 одновременно.

Products In Order — допустимые значения

Row expand · детали заказа

Клик по строке (вне dropdown) разворачивает панель с деталями:

• Items — все SKU (product name, variant, variantSKU, qty × count, price)
• Customer — имя, email
• Shipping — полный адрес (line1, city, state, postalCode, country), метод доставки
• Promo code — извлекается из extras[].name (формат Discount (CODE))
• Subtotal · Total — суммы по заказу
• Extras — все записи extras[] (shipping / tax / discount / discount-shipping) с ценами; отрицательные — красным

Повторный клик на строку сворачивает панель. Доступно с клавиатуры: Enter / Space на сфокусированной строке.

API

Источник данных

Заказы с webflow === "SONR Shopify" AND shop === "SONR Shopify Store". Дата заказа: acceptedOn.slice(0,10). По умолчанию открывается за текущий месяц.

Важно: новые поля variantId и extras[] в Shopify заказах появились вместе с этой страницей. Существующие заказы получат их только после Quick Sync через Sync → Shopify → 2. Quick Sync.

KPI-карточки

Четыре карточки — сводка по всем Shopify-заказам за период.

Блоки 1–5 · по типу продукта

Каждый блок использует общий computeMusicBlockMetrics(orders, mainType) — тот же что для Music: per-item revenue + extras prorated by block share. Gross Revenue = Product + Accessories + Shipping + (−Discounts) + (−Discount Shipping) — Tax не включается. Плитка «{mainType} revenue» показывает нетто — productRevenueNet = productRevenue + discount + discountShipping (выручка товара минус прораченные на блок скидка и скидка на доставку); отдельные плитки Discount / Discount Shipping остаются для справки.

Для блоков 1–4 in-block items = {mainType, "Accessories"} — accessories из тех же заказов учитываются в этих блоках. Для блока 5 — только Accessories. Items, не попавшие ни в один блок, идут в Block 6 Other Orders.

Тайлы каждого блока: Gross Revenue (hero), Orders, {mainType} revenue, {mainType} q-ty, Shipping, Discount Shipping, Tax, Discounts, Accessories revenue, Accessories q-ty + прогресс-бар + collapsible SKU-разбивка. Для блока 5 (Acc Only) скрыты product-tiles и Accessories-tiles (там Product = Accessories).

Блок 6 · Other Orders

Items из Shopify-заказов, чей skuid_product_type не входит в {SONR Music, SONR Music 2, SONR Music Multisport, SONR Coach, Accessories} или вообще отсутствует в каталоге. Колонки: Order ID · Date · Status · Product · Variant · Type · Qty · Revenue. Клик по строке раскрывает полные детали заказа.

Чтобы убрать item из Block 6 — задай ему skuid_product_type в Settings → Products Settings → Shopify. Если SKU вообще нет в каталоге — сначала Sync → Shopify → 4. Sync Products чтобы подтянуть его в raw_products, потом Settings → Products Settings → Sync Shopify products.

Блок 7 · SONR Orders export

CSV-экспорт по типу продукта. Диапазон дат — из top-of-page dashboard-хедера (dashDateFrom / dashDateTo); отдельных date-input'ов в форме нет.

• Types — 6 chip-чекбоксов (SONR Music / Music 2 / Multisport / Coach / Accessories / Other) + мастер All

Канал заказа определяется как тип первого counted item (или "Other" если такого нет). CSV-колонки: Order ID, Date, Status, Type, Customer, Email, Items, Subtotal, Total, Shipping, Tax, Discount, Payment. Имя файла: sonr-shopify-orders-{from}-{to}.csv.

Источники данных

Все 7 блоков работают над одним базовым набором: orders в MySQL, отфильтрованные по:

o.webflow === "SONR Amazon"
&& o.shop === "SONR Amazon Store"
&& o.acceptedOn в диапазоне дат из top-of-page header'а

Этот набор передаётся в renderAmazonBlocks(amzOrders), который строит все 6 блоков с метриками и SKU breakdown.

Items в Amazon-заказах

Amazon SP-API возвращает orders и orderItems отдельно. При Quick Sync для каждого заказа дополнительно вызывается /orders/v0/orders/{AmazonOrderId}/orderItems (rate-limit 0.5 req/sec, burst 30). Items маппятся в наш формат через transformAmazonOrder:

Замены (Replacement Orders): transformAmazonOrder сохраняет поле isReplacement: raw.IsReplacementOrder === "true". Поле проставляется только если Amazon вернул его явно (список заказов его не включает — только single-order endpoint). Значение сохраняется в PRESERVED_ORDER_FIELDS в db.js — sync не перезаписывает его. Для исторических fulfilled-заказов с total=0 — endpoint POST /orders/amazon-backfill-replacements re-fetches /orders/v0/orders/{id} и заполняет поле. Replacement-заказы исключены из всех блоков: не входят в revenue, fulfilled-count и progress bar.

Скидки (Promotional Rebates): при маппинге items суммируется PromotionDiscount.Amount по всем items заказа. Если сумма > 0 — в order.extras[] добавляется запись {type:"discount", name:"Promotional Rebates", price: -total}. Именно этот extras-discount используется во всех блоках для тайла Discounts и для вычисления net revenue.

Backfill items для исторических заказов с пустым items[] — endpoint POST /orders/amazon-backfill-items. Идемпотентный, incremental persist каждые 25 заказов, retry с экспоненциальным backoff'ом.

Backfill discounts для заказов у которых уже есть items[] но пустой extras[] — endpoint POST /orders/amazon-backfill-discounts. Перезапрашивает /orderItems и заполняет PromotionDiscount для исторических заказов. Идемпотентный.

Каталог продуктов

Амазон-листинги хранятся в app_data['products'] с source: "Amazon". skuId в каталоге равен variantId в order items, что позволяет dashboard'у через skuMap[item.variantId]?.skuid_product_type определить тип продукта. Если у каталог-SKU не задан skuid_product_type — item уйдёт в Block 6 "Other Orders".

Блок 1 · SONR Music

Фильтр заказа: заказ попадает в блок если в его items[] есть хотя бы один item чей skuMap[item.variantId]?.skuid_product_type === "SONR Music".

amzOrders.filter((o) =>
  (o.items || []).some((it) =>
    skuMap[it.variantId]?.skuid_product_type === "SONR Music"
  )
)

Один заказ может одновременно попасть в несколько блоков (если у него items разных типов).

Метрики

Финансовые метрики считаются только по fulfilled заказам. Pending и Cancelled видны отдельными счётчиками, но в суммы не входят.

Progress bar

Под метриками — % fulfilled по всем заказам блока с цветными счётчиками N fulfilled / N unfulfilled.

SKU breakdown

Под progress-bar — два сворачиваемых списка SKU по всем заказам блока (включая unfulfilled):

• SONR Music — все items типа "SONR Music" из заказов блока
• Accessories — все Accessories items из заказов блока

Блок 2 · SONR Music 2

Идентичная Блоку 1 логика для type = "SONR Music 2". Те же тайлы: Gross Revenue (Product Revenue − Promotional Rebates, accessories не входят), Orders, Orders Fulfilled, revenue (net), q-ty, Accessories, Discounts, Pending, Cancelled, Replacements. Финансовые метрики — только fulfilled (без replacements).

Блок 3 · SONR Music Multisport

То же что Блоки 1/2 для type = "SONR Music Multisport". Те же тайлы: Orders, Orders Fulfilled, revenue (net), q-ty, Accessories, Discounts, Pending, Cancelled, Replacements.

Блок 4 · SONR Accessories

Этот блок ведёт себя иначе — он показывает заказы где аксессуары пришли сами по себе, без основного продукта.

amzOrders.filter((o) => {
  const items = o.items || [];
  const hasAcc = items.some((it) =>
    skuMap[it.variantId]?.skuid_product_type === "Accessories");
  const hasMain = items.some((it) =>
    AMAZON_PRODUCT_MAIN_TYPES.has(skuMap[it.variantId]?.skuid_product_type));
  return hasAcc && !hasMain;
})

Где AMAZON_PRODUCT_MAIN_TYPES = {"SONR Music", "SONR Music 2", "SONR Music Multisport", "SONR Coach"}.

Зачем такой фильтр

Аксессуары которые приехали с основным продуктом (Music/Coach/etc) уже учитываются в блоке этого продукта (tile "Accessories revenue/q-ty"). Block 4 показывает только чистые accessory-only заказы — кто-то купил исключительно аксессуар.

Метрики

Финансовые метрики — только fulfilled. computeMusicBlockMetrics(fulfilledOrders, "Accessories") с isAccBlock = true:

• Product revenue / q-ty и Accessories revenue / q-ty tiles скрыты — для accessory-only блока они бессмысленны
• Gross Revenue — Product Revenue − Promotional Rebates (для Acc-only блока Product = Accessories, поэтому значение не меняется), только fulfilled (без replacements)
• Orders — все заказы блока = Fulfilled + Pending + Cancelled + Replacements
• Discounts — Σ PromotionDiscount из extras[{type:"discount"}], только fulfilled
• Pending / Cancelled — счётчики по всем заказам блока (без replacements), всегда видны (0 если нет)
• Replacements — warranty replacements, всегда виден; исключены из revenue

SKU breakdown показывает все заказы (включая unfulfilled).

Блок 5 · SONR Coach

Заказ попадает если ≥1 item с skuid_product_type === "SONR Coach". Метрики через computeAmazonMixedMetrics(fulfilledOrders).

Блок 6 · Other Orders

Это item-level dump — не агрегированные заказы, а конкретные позиции которые "потерялись".

Что туда попадает

Items из всех Amazon-заказов где:

const type = skuMap[item.variantId]?.skuid_product_type;
if (!type || !AMAZON_COUNTED_TYPES.has(type)) {
  uncountedItems.push({ order, item, type: type || "—" });
}

То есть item попадает если:

• SKU нет в каталоге (skuMap[item.variantId] = undefined) — typically значит что нужно сделать Sync → Amazon → Sync Products чтобы подтянуть свежие листинги, потом Settings → Products → Sync Amazon products
• SKU есть, но без типа (skuid_product_type = пусто) — нужно зайти в Settings → Products → Amazon и проставить тип
• SKU с типом вне 5 counted-types (например "Music Streaming" или "Others") — будет в Block 6 пока не переклассифицирован

AMAZON_COUNTED_TYPES = {"SONR Music", "SONR Music 2", "SONR Music Multisport", "SONR Coach", "Accessories"}.

Отображение

Используется тот же helper renderDashOtherSkus что у Music Block 5. Это таблица с колонками: Order ID · Date · Status · Product · Variant · Type · Qty · Revenue. Клик по строке раскрывает полные детали заказа (items, customer, shipping, extras).

Как "очистить" Block 6

1. Sync → Amazon → 4. Sync Products — подтянуть свежий каталог в raw_products
2. Settings → Products Settings → Sync Amazon products — перенести в рабочий products
3. Settings → Products → Amazon — выбрать skuid_product_type для каждого ASIN. После save — заказы автоматически переедут в нужный блок 1–5 при следующем рендере dashboard'а

Блок 7 · Mixed Orders

Заказ попадает если в его items[] есть товары 2+ различных основных типов (не считая Accessories). Например SONR Music + SONR Coach в одном заказе. Такие заказы также остаются в своих блоках 1–5.

const types = new Set(items.map(it => skuMap[it.variantId]?.skuid_product_type).filter(t => t && t !== "Accessories"));
types.size >= 2

Блок 8 · SONR Orders export

CSV-экспорт по типу продукта. Диапазон дат — из top-of-page dashboard-хедера (dashDateFrom / dashDateTo); отдельных date-input'ов в форме нет.

• Types — 6 chip-чекбоксов (SONR Music / SONR Music 2 / SONR Music Multisport / SONR Accessories / SONR Coach / Other) + мастер All (заполненный navy при активности)

Логика фильтра экспорта

Заказ попадает в выгрузку если выполняется ОБА условия:

1. Источник: webflow === "SONR Amazon" && shop === "SONR Amazon Store"
2. Дата в диапазоне
3. И один из двух матчей: (а) хотя бы один item имеет skuid_product_type ∈ выбранные chip'ы, ИЛИ (б) primary type заказа (тип первого counted item, иначе __other__) ∈ выбранные chip'ы

CSV-колонки: Order ID, Date, Status, Type, Customer, Email, Items, Subtotal, Total, Shipping, Tax, Discount, Payment. Type = primary type заказа (или "Other" для __other__). Items = склейка "Product (variant) ×count" через "; ". Filename: sonr-amazon-orders-{from}-{to}.csv.

Per-block Export-кнопки

В шапке каждого блока 1–6 — outlined-navy Export кнопка с download-иконкой (рядом с Wiki-кнопкой). Клик скачивает CSV только этого блока за период из dashboard-header'а. Реализована через delegated event handler с уникальными data-amazon-export-type / data-amazon-export-slug атрибутами (не конфликтует с Music dashboard'ом который использует data-export-type).

Filename: sonr-amazon-{slug}-{from}-{to}.csv. Feedback — toast (success/error).

Workflow при настройке

Чтобы блоки 1–5 заполнились данными:

1. Sync → Amazon → 1. Import / 2. Quick Sync — заказы попадут в orders
2. Sync → Amazon → 4. Sync Products — листинги уйдут в raw_products
3. Settings → Products Settings → Sync Amazon products — raw_products → products
4. Settings → Products → Amazon tab — для каждого ASIN dropdown'ом проставить skuid_product_type: SONR Music / SONR Music 2 / Multisport / Accessories / SONR Coach
5. Save changes
6. Открыть Dashboard → Amazon — все заказы автоматически распределены по блокам

Если в БД уже есть Amazon-заказы с пустым items[] (импорт делался до фикса import flow), нужно дополнительно дёрнуть POST /orders/amazon-backfill-items — иначе заказы попадут в Block 6 (нет items для матчинга). Backfill идемпотентный, безопасно повторно запускать.

Обзор

Страница Sync управляет импортом и синхронизацией заказов из всех подключённых источников данных. Состоит из четырёх вкладок:

Подробное описание каждой вкладки — в отдельных статьях (см. боковое меню).

Статистика (Stats Bar)

В верхней части — 4 KPI-карточки по всем источникам (Coach excluded не применяется — учитываются все):

Ниже — карточки по каждому источнику: SONR Music, SONR Coach, SONR Shopify, SONR Amazon. Каждая карточка показывает Revenue, Orders, прогресс-бар fulfilled % и счётчики fulfilled/unfulfilled.

Таблица заказов

Основной контент вкладки — таблица всех заказов с колонками:

Фильтры и поиск

Экспорт CSV

Кнопка Export CSV доступна только администраторам (role === "admin"). Экспортирует все заказы с применёнными фильтрами. Имя файла включает диапазон дат. Валюта в CSV записывается без пробелов (formatCurrencyRaw()).

Источники

Вкладка содержит два блока — по одному на каждый Webflow сайт:

1. Quick Sync

Забирает заказы из Webflow API за выбранный период, трансформирует в унифицированный формат и сохраняет в MySQL через upsert.

Статус операции отображается под toolbar. При успехе показывается количество добавленных/обновлённых заказов.

2. Auto Sync

Серверный фоновый синк — работает без участия пользователя по расписанию. Управляется через toggle-переключатель.

3. Sync Products

Забирает каталог продуктов из Webflow API и сохраняет в app_data['raw_products']. Доступно для обоих сайтов (SONR Music и SONR Coach). Это сырые данные без пользовательских настроек.

После выполнения — перейдите в Settings → Products Settings и нажмите соответствующую кнопку Sync (SONR Music или SONR Coach), чтобы обновить рабочий каталог app_data['products']. Пользовательские поля (skuid_product_type, skuid_product_color, skuid_main_product_qty, skuid_receivers_count, skuid_radio_count) при этом сохраняются.

Подключение (OAuth)

При первом входе отображается блок Connect Shopify с кнопкой «Connect Shopify Account». Поток авторизации:

1. Кнопка → GET /shopify/auth → редирект на Shopify OAuth.
2. После подтверждения Shopify редиректит на /shopify/callback.
3. Сервер обменивает code на access token, сохраняет в памяти.
4. Страница-подтверждение показывает токен с кнопкой Copy.
5. На Railway токен нужно вставить вручную в Railway Variables → SHOPIFY_ACCESS_TOKEN.

После подключения блок Connect скрывается и появляется блок синхронизации.

1. Import from Shopify

Первичный импорт — загружает сырые заказы из Shopify Admin API (2025-07) в app_data['raw_shopify']. Использует cursor-based пагинацию через Link header. Параметр — дата From.

2. Quick Sync

Загружает свежие заказы из Shopify Admin API напрямую, трансформирует в унифицированный формат и делает upsert в MySQL. Параметры — From (дата, передаётся как created_at_min) и Count. Использует cursor-based пагинацию через Link header.

3. Auto Sync

Фоновый серверный синк по расписанию (1 или 2 часа). Управляется toggle-переключателем. Настройки сохраняются в MySQL (app_data['auto_sync']) и восстанавливаются автоматически при перезапуске сервера или деплое на Railway.

4. Sync Products

Пулит все продукты из Shopify Admin API (GET /admin/api/2025-07/products.json?limit=250) с cursor-based пагинацией (Link header) и сохраняет в raw_products с source: "Shopify".

Трансформация transformShopifyProduct:

Импорт — только в raw_products. Чтобы применить в каталог — используйте Settings → Products Settings → Sync from Shopify.

Конфигурация

Подключение

Amazon SP-API не использует OAuth flow из браузера. Credentials задаются вручную через ENV переменные (локально в .env, на Railway — в Variables).

Если credentials не заданы — отображается блок-заглушка «Add your Amazon credentials to .env». После добавления и перезапуска появляется блок синхронизации.

Access token кешируется в памяти сервера и автоматически обновляется за 5 минут до истечения.

1. Import from Amazon

Загружает сырые заказы из Amazon Orders API (/orders/v0/orders) в app_data['raw_amazon']. Items каждого заказа загружаются отдельно через /orders/v0/orders/{orderId}/orderItems с rate limiting. Параметр — дата From (обязательная для SP-API, CreatedAfter).

2. Quick Sync

Забирает заказы напрямую из Amazon SP-API (GET /orders/v0/orders), трансформирует и делает upsert в MySQL. Параметры — From (дата) и фильтр статуса.

После сохранения заказов автоматически запускает backfill items (POST /orders/amazon-backfill-items) — новые заказы сразу получают информацию о продуктах и отображаются в Dashboard блоках без ожидания следующего Auto Sync.

3. Auto Sync

Фоновый серверный синк по расписанию (1 или 2 часа). Управляется toggle-переключателем. Настройки сохраняются в MySQL (app_data['auto_sync']) и восстанавливаются автоматически при перезапуске или деплое на Railway.

4. Sync Products

Тянет все listings продавца через SP-API GET /listings/2021-08-01/items/{sellerId} и сохраняет в app_data['raw_products'] с source: "Amazon". Постранично через pagination.nextToken (pageSize=20). Каждый listing маппится в product-record c одним SKU внутри (Amazon не моделирует варианты как Webflow/Shopify — каждый ASIN/SKU отдельный листинг). Поля product: productId: "amazon-{sku}", name (из summaries[].itemName), один SKU с sku, asin, image (summaries[].mainImage.link), price (если в offers[] есть запись для текущего marketplace).

Merge в raw_products идёт по ключу productId:source — повторный sync обновляет записи in-place, не дублирует. Endpoint: POST /sync-products-amazon.

Конвертация валюты в USD

Amazon-маркетплейсы могут присылать заказы в разных валютах. Amazon.com — USD, Amazon.com.mx — MXN. Валюта берётся из OrderTotal.CurrencyCode (fallback по маркетплейсу). Чтобы вся аналитика была в одной валюте, не-USD заказы конвертируются в USD при синке.

• Курс — из Settings → Exchange (1 USD = курс × валюта); конвертация: USD = сумма / курс
• Что конвертируется: total, subtotal, items[].price, extras[].price (скидка), shipping.cost
• Сохраняется оригинал: currency:"USD", originalCurrency (напр. MXN), originalTotal, exchangeRate
• Когда: при Auto Sync / Quick Sync / Import и в бэкфилле позиций. Если курса для валюты нет — заказ остаётся в исходной валюте (тег currency ставится, конвертация не делается)
• Существующие заказы: разовый POST /orders/amazon-convert-currency конвертирует уже загруженные не-USD заказы (идемпотентно — пропускает уже сконвертированные по originalCurrency)

Курс «замораживается» на момент синка (exchangeRate в заказе). Если поменять курс в Settings — пересчёт существующих заказов делается повторным запуском конвертации/синка.

Что это

Страница Notifications позволяет настроить автоматическую отправку ежедневного отчёта о заказах в Telegram-группы. Сервер каждый день в настроенное время (по умолчанию 9:00 GMT+2) собирает статистику за вчера и рассылает сообщение во все настроенные чаты.

Содержимое daily-отчёта

Сообщение содержит заказы за вчерашний день (UTC), каждый канал отдельным блоком с разбивкой по продуктам. Для Amazon дополнительно показываются статусы:

📦 SONR Orders — 9 июня

🎵 Webflow Music — 4 заказа · $549
  SONR Music × 3
  SONR Music 2 × 1

🎓 Webflow Coach — 2 заказа · $1 672
  SONR Coach Communicator × 3

📦 Amazon — 7 заказов · $505
  ✅ Shipped: 3 · $505
    SONR Music Waterproof MP3 Player… × 2
  ⏳ Pending: 4

🛍 Shopify — нет заказов

━━━━━━━━━━━━━━━━
Итого: 13 заказов · $2 726

Все каналы всегда присутствуют в сообщении (даже с "нет заказов"). Названия продуктов обрезаются до 35–40 символов. Выручка из поля data.total (центы → доллары).

Настройка

Telegram Bot Token

1. Создайте бота через @BotFather → /newbot → токен вида 123456:ABC-DEF...
2. Добавьте бота в группу
3. Задайте токен через переменную окружения TELEGRAM_BOT_TOKEN (локально в .env, на Railway — в Variables)

Токен не хранится в БД и не отображается в UI — только через env var.

Telegram Chats

Каждый чат отображается карточкой с именем группы и Chat ID. Как узнать Chat ID:

• Добавьте бота в группу и напишите /start
• Откройте https://api.telegram.org/bot{TOKEN}/getUpdates — найдите message.chat.id (для групп — отрицательное число)

Кнопка + Add Chat открывает inline-форму (Name + Chat ID). Кнопка Send Report у каждой карточки — немедленно отправляет вчерашний отчёт в этот конкретный чат.

Send Time

Выберите час (0–23) и минуту (00/15/30/45) в GMT+2. После нажатия Save Settings cron-задача перепланируется автоматически — без перезапуска сервера.

Enable / Disable

Тумблер включает/выключает автоматическую ежедневную отправку.

Send to All

Кнопка Send to All немедленно отправляет вчерашний отчёт во все настроенные чаты — независимо от статуса Enable.

Backend

Cron динамический: при старте сервера загружается из app_data['notifications_config'] (send_hour, send_minute в GMT+2). Конвертируется в UTC автоматически.

Product scope (переключатель)

В шапке страницы — 3 pill-кнопки над hero-плашкой, переключающие набор данных для всех 7 отчётов. По умолчанию выбран All.

Source (переключатель)

Второй ряд под Product scope — 3 pill-кнопки для фильтра по источнику заказа. Применяется AND с Product scope: оба условия должны выполняться одновременно. По умолчанию — Webflow.

Кнопки General (все источники вместе) и OKR убраны. OKR вынесен в отдельную страницу (пункт меню после Statistics).

Hero-sublabel динамически отражает оба фильтра: {scope} · {source} · Sales reports for the selected period.

Источники данных

Страница работает с заказами из MySQL (endpoint /api/orders) + продуктовым каталогом /products для определения skuid_product_type. Источник заказа (webflow, shop) не используется в фильтре — выборка идёт по типу SKU из каталога.

Фильтр по дате

В верхней части страницы — поля From и To + кнопка Apply. По умолчанию выставляется первый день текущего месяца → сегодня (UTC). Все отчёты пересчитываются при нажатии Apply.

KPI карточки

Фильтр по статусу

Перед таблицами — строка chip-фильтров: Unfulfilled, Fulfilled, Refunded, Disputed, Dispute-lost. Можно выбрать несколько. Все активные чипы применяются к отчётам одновременно. Если ни один не выбран — показываются все статусы.

Как считается Revenue (нетто)

На вкладках Orders и Products выручка (Revenue) считается нетто — за вычетом скидок, распределённых по позициям заказа. Для каждой позиции:

• itemShare = item.price / Σ(цены всех позиций заказа) — доля позиции в товарной сумме заказа
• netRevenue позиции = item.price + (orderDiscount + orderDiscountShipping) × itemShare

Здесь orderDiscount (extras[type="discount"]) и orderDiscountShipping (extras[type="discount-shipping"]) — суммы уровня заказа, обе отрицательные, поэтому уменьшают выручку. Доставка (положительная) и налог в Revenue не входят.

Revenue на всех уровнях (группа типа → продукт → SKU) — это сумма netRevenue входящих позиций, поэтому суммы строк точно сходятся с итогом блока. В раскрытом списке заказов колонка Revenue показывает item.price позиции (gross), а скидки вынесены в отдельные колонки Discount / Disc. Ship.

Примечание: на дашбордах (Dashboard) проращивание идёт по доле блока в заказе (blockItemValue / totalItemValue), а в Statistics — по доле каждой позиции. Результат на уровне типа продукта совпадает.

Вкладки отчётов

Статус

Страница в разработке — пока показывает только hero-баннер и заглушку «Страница в разработке». Контейнер page-okr зарегистрирован в switchPage() (app.js).

Контекст

Ранее OKR был placeholder-кнопкой в фильтре Source на странице Statistics (всегда пустая выборка). Теперь вынесен в отдельную страницу — кнопка из Source убрана. Назначение страницы — цели и ключевые результаты (Objectives & Key Results); метрики и формулы будут добавлены позже.

Обзор

Страница Settings доступна только администраторам. По умолчанию открывается вкладка Overview с карточками-навигаторами к четырём разделам:

Таблица пользователей

По умолчанию отображается список всех пользователей. Нажмите + Add User в правом углу заголовка — форма создания раскроется ниже. Нажмите Cancel или снова «+ Add User» чтобы свернуть.

Все поля в таблице редактируемые — кнопка Edit справа. Правила безопасности:

• Нельзя удалить себя
• Нельзя удалить последнего администратора
• Нельзя понизить роль последнего администратора

Форма Add New User

Раскрывается по кнопке + Add User. Обязательные поля — Username и Password. После создания форма автоматически сворачивается.

Хранение

Пользователи хранятся в app_data['users'] (таблица app_data, ключ users). Пароли хранятся в открытом виде в JSON — не используйте критичные пароли.

Назначение

Регионы используются на странице Statistics в отчёте Country — страны группируются по регионам для отображения на SVG-чарте.

Управление регионами

Кнопка + Add Region создаёт новый регион. Клик по названию региона — переименование. Под каждым регионом список стран с возможностью добавления (+ Add Country) и удаления (×).

Данные хранятся в app_data['regions'].

Sync from Webflow / Shopify / Amazon

Четыре кнопки для импорта продуктов из app_data['raw_products'] в app_data['products']:

Все четыре сохраняют пользовательские настройки SKU (skuid_product_type, skuid_product_color, skuid_main_product_qty и пр.) при обновлении.

Перед sync нужно сначала получить сырые данные — через Sync → Webflow → Sync Products для Music/Coach, Sync → Shopify → Sync Products для Shopify, или Sync → Amazon → Sync Products для Amazon.

Переключение источника

Над списком продуктов расположены четыре переключателя — SONR Music, SONR Coach, Shopify, Amazon. Они фильтруют список по полю product.source на клиенте. Все продукты хранятся в одной таблице app_data['products'], переключение не меняет данные.

Список продуктов

Список всех SKU выбранного источника, сгруппированных по skuid_product_type. Набор полей зависит от активного источника.

SONR Music:

SONR Coach:

Изменения не сохраняются автоматически. После редактирования одного или нескольких SKU появляется кнопка Save changes — нажмите её чтобы сохранить все изменения разом. Данные отправляются одним запросом POST /products/save-skus, который обновляет только явно изменённые поля, не трогая остальные.

Sync from Webflow — сохранение настроек

При повторной синхронизации SONR Music продуктов из Webflow все три поля (skuid_product_type, skuid_product_color, skuid_main_product_qty) сохраняются — они не затираются сырыми данными из Webflow.

Связь с Dashboard

При загрузке страницы Dashboard строится skuMap — словарь variantId → { skuid_product_type, skuid_product_color, skuid_main_product_qty }. Все блоки Dashboard используют этот словарь для классификации товаров в заказах. После изменения настроек SKU нужно перезагрузить страницу Dashboard для применения изменений.

Назначение

Вкладка Settings → Exchange позволяет задать курсы обмена валют. Базовая валюта всегда USD. Курс задаётся в формате 1 USD = курс × валюта (например, 1 USD = 17.5 MXN, 1 USD = 0.92 EUR).

Форма

Список валют, каждая строка — одна валюта:

+ Add Currency — добавить строку; ✕ — удалить; Save changes — сохранить весь список. Строки без кода при сохранении отбрасываются.

Хранение

Данные лежат в MySQL app_data['exchange_rates'] как массив [{ code, name, rate }]. API: GET /exchange-rates (чтение), POST /save-exchange-rates (запись всего массива). Синхронизируется между local и Railway через db-sync.

Использование — конвертация Amazon

Эти курсы используются для приведения заказов Amazon с не-USD валютой к USD. Например, Amazon Mexico присылает заказы в MXN — при синке они конвертируются в USD по курсу MXN (USD = сумма / курс), чтобы вся аналитика была в одной валюте. Подробнее — в статье Sync · Amazon.