Prom

Модуль без жодного реєстру: три налаштування й п'ять служб. Це чиста інтеграція з маркетплейсом Prom.ua, і власних даних вона не заводить — усе, що приїжджає з торгового майданчика, лягає у звичайні об'єкти системи. Замовлення покупця стає рахунком клієнту, сам покупець — контактом.

Сенс модуля простий: вітрина живе на Prom, а облік — у вас, і між ними мають ходити чотири речі. Туди — ціни й залишки. Звідти — замовлення й статуси (а статус, змінений у замовленні, система відправляє назад на Prom).

Маршрут: від підключення до замовлення в системі

Prom Налаштування (ключ доступу, склад для залишків, прейскурант для цін)
        ↓
Prom Оновити ключі товарів — зшивка каталогів: наш товар ↔ товар Prom
        ↓
   ┌── туди ──────────────┐        ┌── звідти ─────────────────┐
   │ Оновити ціни         │        │ Оновити замовлення        │
   │ Оновити баланс       │        │ Завантажити статуси       │
   └──────────────────────┘        └───────────────────────────┘
        ↓                                   ↓
   вітрина показує актуальне        рахунок клієнту + контакт
                                     (вкладка «Prom» у рахунку)

Prom Налаштування — точка підключення: токен і адреса API, а також відповіді на питання «що і звідки вигружати»: з якого складу (чи кількох) брати залишки, з якого прейскуранта — ціни.
Prom Оновити ключі товарів — зшивка каталогів. Служба тягне список товарів магазину, знаходить для кожного картку в системі за артикулом (артикул Prom = код товару) й записує в неї ідентифікатор Prom.
Prom Оновити ціни і Prom Оновити баланс — вигрузка на вітрину: щоб покупець бачив ціну з обліку, а не те, що колись вписали в кабінеті руками.
Prom Оновити замовлення — головна служба: приносить замовлення покупців у систему з клієнтом, товарними рядками і статусом. Далі з ними працюють як зі звичайними — відвантаження, рахунок, оплата.
Prom Створення нових клієнтів — правила, за якими з покупця народжується картка контакту, якщо його ще немає в базі.
Prom Завантажити статуси наповнює довідник Prom Статуси — той самий словник, що бачить покупець.

Що важливо розуміти

Зшивка каталогів — перше, що роблять після підключення. Поки в картках товарів немає ідентифікаторів Prom, ціни й залишки нема куди вигружати: система не знає, який ваш товар відповідає якому товару на вітрині.

Ціни й залишки йдуть лише з увімкненими прапорцями. У «Налаштуваннях товарів» має стояти «Ввімкнути синхронізацію з Prom.ua» — знятий, і служби цін і залишків нічого не відправляють. Крім того, кожен товар іде лише з позначкою «Синхронізувати з Prom.ua» у своїй картці; зшивка ставить її сама, коли прив'язує товар уперше.

Напрямок обміну має значення. Ціни й залишки система виштовхує на маркетплейс; замовлення й статуси забирає. Виняток — статус замовлення: змінили його на вкладці «Prom» у рахунку клієнту — система відправить його на Prom. Спроба поправити ціну в кабінеті Prom руками живе рівно до наступного запуску служби.

Нульовий залишок означає «немає в наявності». Саме тому оновлення балансу ставлять у розклад частіше за решту: воно захищає від замовлень на товар, якого на складі давно немає.

Новий покупець стає контактом сам. Але з якими реквізитами — вирішує налаштування «Prom Створення нових клієнтів». Незаповнене, воно дає базу з безликими картками, які потім важко звести з реальними людьми.

Статуси — словник маркетплейса, а не ваш. Їх не вигадують: список тягнеться з кабінету, і в рахунку клієнту на вкладці «Prom» вибирають саме з нього.

Модуль нічого не рахує. Він не робить проводок, не рухає склад і не веде окремих продажів. Уся економіка живе там, куди приїхали замовлення, — у розрахунках з клієнтами.

З чого почати в новій базі

Prom Налаштування — ключ доступу, склад залишків, прейскурант цін; у «Налаштуваннях товарів» — «Ввімкнути синхронізацію з Prom.ua».
Prom Оновити ключі товарів — зшити каталоги.
Prom Завантажити статуси — наповнити довідник статусів.
Prom Створення нових клієнтів — задати, якими будуть картки покупців.
Поставити в розклад (кнопка «За розкладом» у вікні служби) ціни, баланс і замовлення — далі модуль працює сам.

Часті задачі

Треба	Куди йти
підключити магазин на Prom	Prom Налаштування
зв'язати товари з вітриною	Prom Оновити ключі товарів
оновити ціни на вітрині	Prom Оновити ціни
прибрати з продажу те, чого немає	Prom Оновити баланс
забрати замовлення покупців	Prom Оновити замовлення
налаштувати картки нових покупців	Prom Створення нових клієнтів
оновити перелік статусів	Prom Завантажити статуси · Prom Статуси

Усі об'єкти модуля

Налаштування: Prom Налаштування · Prom Створення нових клієнтів · Prom Статуси

Служби: Prom Оновити ключі товарів · Prom Оновити ціни · Prom Оновити замовлення · Prom Оновити баланс · Prom Завантажити статуси

Куди дивитися далі

Рахунки клієнтам — куди приїжджають замовлення з маркетплейса.
Ціни — прейскурант, з якого беруться ціни вітрини.
Розетка — другий маркетплейс, влаштований інакше.
Нова Пошта — доставка замовлень покупцям.