Інтернет-магазин Shop-Express: замовлення і товари в обліку
Замовлення з Shop-Express самі стають замовленнями клієнта і видатковими за вашою таблицею статусів, товари з сайту - картками з варіантами, цінами, штрихкодами і фото. Безпечний режим без запису на сайт, залишки і ціни на сайт загалом або по складах, статуси на сайт, звірка після кожного запису.
Конектор Shop-Express переносить замовлення і товари з інтернет-магазину на Shop-Express в облік без ручного передруку. Система читає замовлення з сайту, створює замовлення клієнта, резервує товар і списує його при відправці, а товари з сайту стають картками разом із варіантами, цінами, штрихкодами і фото. Далі замовлення живуть у воронці, ТТН створюються з документа. Логіка та сама, що в конекторі Horoshop.
Що потрібно від магазину
API у Shop-Express є лише на тарифі PRO і вище. В адмінці магазину: Налаштування → API → створіть користувача API. Його e-mail і пароль знадобляться для підключення.
Підключення
Де: Робочий стіл → «CRM» → у лівій панелі «Налаштування» → «Підключення Shop-Express» → «Створити» (або через пошук Ctrl+K: «Підключення Shop-Express»). Що заповнити: назву, код магазину (короткий префікс латиницею, напр. SE: з нього починаються номери замовлень і коди товарів без артикула), домен сайту, логін API (e-mail) і пароль API, компанію, склад (з нього резервуємо і списуємо), прайс-лист, групу й територію для нових покупців, групу товарів за замовчуванням, одиницю «шт».
Що зробити далі, по черзі (усі кнопки - у меню «Дії»):
- «Перевірити з'єднання» - система покаже останнє замовлення на сайті і режим «тільки читання».
- «Підтягнути статуси сайту» - статуси вашого магазину з'являться в таблиці «Статуси сайту → дія в ERP» з уже підібраною дією. Перевірте колонку «Дія в ERP».
- «Підтягнути склади сайту» - якщо в магазині кілька складів, оберіть для кожного склад в обліку.
- «Підтягнути з сайту» - картки товарів з каталогу сайту.
- «Синхронізувати зараз» - перший прохід замовлень. Якщо все гаразд, поставте «Увімкнено (синхронізація за розкладом)».
Прохід іде кожні 10 хвилин, і щоразу перечитуються всі замовлення за період «Днів назад», тож зміни заднім числом теж підхоплюються.
Прапорець «Емуляція (демо-магазин без мережі)» підключає вбудований навчальний магазин із замовленнями, статусами і каталогом. Реальний сайт при цьому не викликається - зручно, щоб показати менеджерам увесь ланцюжок до підключення справжнього магазину. На бойовому підключенні прапорець має бути вимкнений.

Що відбувається із замовленням
Статуси в Shop-Express кожен магазин налаштовує сам, тому що робити з кожним статусом, задає таблиця «Статуси сайту → дія в ERP»:
| Дія в ERP | Що робить система |
|---|---|
| Резерв | Створює проведене замовлення клієнта - товар у резерві на складі підключення |
| Відвантаження | Створює видаткову накладну - товар списано |
| Скасування | Скасовує видаткову (товар повертається на склад), замовлення закривається |
| Ігнорувати | Замовлення лише записується в список, документів немає |

Для статусу, якого немає в таблиці (додали на сайті пізніше), діє поле «Дія для незіставлених статусів». Покупець шукається за номером телефону, без телефону - за e-mail; якщо нікого немає - створюється новий клієнт. Знижка із замовлення на сайті переноситься в документ, рядок товару бере склад за складом сайту.
Дзеркало замовлень
Кожне замовлення з сайту має свій запис у списку «Замовлення Shop-Express»: статус на сайті, етап в обліку, покупець, сума, посилання на замовлення клієнта і видаткову (група кнопок «Відкрити»), остання помилка. Список відкривається з підключення: «Відкрити» → «Замовлення з сайту». Якщо щось розійшлось - у картці замовлення «Дії» → «Перечитати з сайту». Історія проходів - «Журнал синхронізації Shop-Express» (CRM → ліва панель «Налаштування» або «Відкрити» → «Журнал синхронізації» у підключенні).
Товари
Модель з модифікаціями стає шаблоном, модифікації - варіантами. Атрибутами стають характеристики, якими модифікації відрізняються (розмір, колір), назви беруться з сайту. Код товару - артикул із сайту; якщо артикула немає, код складається з коду магазину і номера товару на сайті. Разом з карткою приходять штрихкод, ціна в прайс-лист, група за категорією сайту і перше фото.
Каталог синхронізується раз на дві години (прапорець «Синхронізація каталогу»), а кнопка «Дії» → «Підтягнути з сайту» забирає новинки одразу. Картка з сайту - лише довідник, залишок з'являється після надходження.
Безпека: запис вимкнено
За замовчуванням система лише читає сайт. Жоден запис на сайт неможливий, поки в підключенні не поставлено прапорець «Дозволити ЗАПИС у Shop-Express». Пароль API зберігається у захищеному полі.
Зворотний напрям: залишки, ціни і статуси
Вмикається окремо і лише після перевірки.
Залишки. «Звірка залишків (сухий прогін)» показує розбіжності між сайтом і вільним залишком в обліку (наявний мінус резерв) без жодної зміни на сайті. Реальна відправка кожні 30 хвилин - прапорці «Дозволити ЗАПИС» і «Вивантажувати залишки на сайт». Поле «Як писати залишок»: «Загальний залишок» - одне число на товар, «По складах сайту» - окремо по кожному складу з таблиці «Склади сайту → склади ERP». У режимі «По складах сайту» прапорець «Обнуляти інші склади сайту перед записом» спершу скидає на сайті залишок складів, не зіставлених у таблиці. Прапорець «Вивантажувати ціни з прайс-листа» передає ціну тим самим запитом.
Статуси. У таблиці статусів колонка «Ставити на сайті, коли» каже, який статус поставити на сайті: коли замовлення підхоплено в облік, коли проведена видаткова, коли замовлення закрито. «Статуси на сайт (сухий прогін)» показує, що змінилося б. Реальна передача - прапорець «Передавати статуси на сайт». Коли запис дозволено, з'являється група кнопок «Запис на сайт» → «Вивантажити залишки зараз» і «Передати статуси зараз», щоб не чекати розкладу. Статус рухається лише вперед і не відкочує того, що менеджер уже поставив на сайті.
Перевірка після запису. Після кожного запису система перечитує сайт і порівнює з тим, що відправила. Якщо сайт не прийняв зміну, у журналі з'являється рядок «ЗВІРКА» зі статусом «Помилка», а наступний прохід повторює запис.
Що API Shop-Express не дозволяє
- Номер ТТН на сайт не передається - у API Shop-Express немає такого поля. ТТН створюється і відстежується в обліку.
- Оплату система бачить, але позначити замовлення оплаченим на сайті через API не можна.
Питання
«Перевірити з'єднання» дає помилку авторизації
Перевірте, що магазин на тарифі PRO, а логін і пароль - саме користувача API з розділу Налаштування → API, а не вашого входу в адмінку.
Замовлення з сайту не з'явилось
У шапці підключення видно останній успішний запуск і помилку. Перевірте, яку дію має статус замовлення в таблиці статусів: при «Ігнорувати» документа не буде. Далі «Відкрити» → «Замовлення з сайту» - знайдіть номер, відкрийте його і натисніть «Дії» → «Перечитати з сайту».
Товар створився без залишку
Так і задумано: картка з сайту - лише довідник. Залишок з'являється після надходження, як у циклі закупівель.