--- name: 1c-exchange description: Обмен с 1С — приём каталога POST /api/catalog/1c-import под неизменную обработку заказчика, туннель Cloudflare с прибора, проверка через Postman и из 1С, мок рабочих данных на время теста. Использовать при правке import_1c.py, схем Import1C*, туннеля и при вопросах «1С не видит весы». --- # Обмен с 1С ## Контракт диктует обработка `integrations/1c/original-Libra.bsl` — внешняя обработка 1С 8.2, уже работает у заказчика и **не правится без явной просьбы владельца**. Наш приёмник `backend/app/api/import_1c.py` подстроен под неё, а не наоборот: | Обработка шлёт | Приёмник | | --- | --- | | заголовок `X-API-Key` | основной способ; `Authorization: Bearer` оставлен для curl. Пробелы по краям токена срезаются — его копируют руками | | `article` (числовой артикул) | это и есть `plu`: в схеме `validation_alias=AliasChoices("plu","article")`, поле необязательное | | позиции без артикула / длиннее 5 цифр | не 422 на весь пакет, а пропуск с записью в `errors[]` (`plu: 0`, `name`) — 1С печатает их в своём логе | | `GET /health` («Проверить связь») | явный маршрут в `main.py` вместе с `/healthz`; без него SPA-заглушка отвечала 200 при любом состоянии | | `in_stock` всегда `true` | отбор «только в наличии» делает 1С; чего нет в пакете — гасится (`active=0`) | | `replace_images` | снимок существующему товару кладётся только с ним; новым — всегда | На время записи киоск закрыт экраном «Оновлення»: бэкенд шлёт `live.notify` «catalog_busy» до записи и «catalog» после — в `finally`, поэтому сорвавшаяся выгрузка не оставит прибор за экраном ожидания (плюс минутная страховка в киоске). Без этого покупатель успевал нажать карточку посреди выгрузки и получить этикетку со старой ценой. После снятия экрана киоск возвращается к началу каталога, но не тогда, когда взвешенное ещё не забрали. Полная синхронизация опасна при сбое выгрузки: пустой пакет и пакет без единого пригодного артикула отклоняются (400) до того, как что-то погаснет. После приёма — `live.notify("catalog")`. Поля настройки `SMK_HTTP_Настройки` и формат тела — `integrations/1c/README.md`; менять контракт можно только с обеих сторон разом. ## Как 1С достаёт до прибора Сервер 1С доступен только по RDP, приборы — за NAT провайдера без белого IP (проверено: WAN роутера — приватный `192.168.12.x`, проброс снаружи не отвечает). Поэтому прибор сам держит исходящий туннель Cloudflare (сервис `tunnel` в `deploy/docker/compose.yml`, скилл `deployment`), а 1С ходит на имя `vesy-N.<домен>`, `SSL = Истина`. Tailscale отпал: на сервер 1С клиента ставить нельзя. Если 8.2 не договорится по TLS — `SSL = Ложь` через порт 80 работает (Cloudflare принимает HTTP), но у домена должно быть выключено «Always Use HTTPS». ## Постоянный адрес Домен `smk-retail.com` в аккаунте Cloudflare владельца. Туннель `vesy-dev` (ID `ef35cc5d-…`) с маршрутом `vesy-dev.smk-retail.com` → `http://127.0.0.1:8000` — это машина разработчика: `cloudflared tunnel run --token <из backend/.env, CLOUDFLARE_TUNNEL_TOKEN>`. Токен надстройка Claude в Chrome не отдаёт (и правильно) — его копирует владелец руками. Снаружи проверено: `/health` 200 из Кипра и Германии, `/admin` 401 без пароля и 200 с ним, приём 1С отвечает своим 401/400. HTTP без TLS через туннель тоже проходит — запасной путь для 1С 8.2 без OpenSSL. ## Проверка на машине разработчика 1. Бэкенд слушает `0.0.0.0` (`tools/dev.py` так и запускает); в `backend/.env` задан `S2L_IMPORT_TOKEN`. 2. Быстрый туннель без домена: `cloudflared tunnel --no-autoupdate --url http://127.0.0.1:8000` печатает имя `*.trycloudflare.com`; живёт, пока идёт команда, меняется при каждом старте. Убедиться снаружи: `curl https://<имя>/health` и, если есть сомнения в сети, check-host.net (TCP/DNS с чужих узлов). 3. Postman: вкладка **Authorization → No Auth**, заголовок `X-API-Key` во вкладке Headers. Первая ловушка теста: в Authorization стоял Bearer с другим значением — 401, хотя curl с тем же токеном проходил. 4. Пакет — ровно как у обработки (`article`, не `plu`), плюс позиция без артикула и с шестизначным — проверить `errors[]`. Отрицательные: без ключа 401, пустой пакет 400. 5. Из 1С: сначала «Проверить связь» (то же поле `Сервер`, без тела), потом «Заполнить» → «ВыгрузитьВВесы». `Couldn't resolve host name` — в поле `Сервер` лишний `https://`, путь или пробел, либо DNS на RDP-сервере не отдаёт `trycloudflare.com` (`nslookup` там же). Именованный туннель со своим доменом такие фильтры не трогают. Результат первого прогона 2026-09-15: 415 позиций, 290 со снимками, 4 группы — киоск перерисовался сам. ## Мок рабочих данных Выгрузка гасит всё, чего нет в пакете, поэтому демо-каталог на время теста уезжает в `backend/data/mock/` (гитигнор): cd backend && .venv/Scripts/python tools/mock_data.py stash # база в мок cd backend && .venv/Scripts/python tools/mock_data.py restore # вернуть Снимки мок не трогает: присланные из 1С лежат в `backend/data/photos/` и перекрывают демо-набор из сборки по коду товара (скилл `product-photos`). Оба — при остановленном бэкенде: SQLite занят, на Windows файл не переименовать. `S2L_SEED_DEMO=0` в `backend/.env`, иначе пустая база на старте снова засеется демо. Ловушка Windows: после убийства родителя `uvicorn --reload` дочерние воркеры (`--multiprocessing-fork` в командной строке) живут дальше и держат базу — добивать их отдельно. Проверять приём одной позицией через curl нельзя: это полная синхронизация, и такой запрос погасил 415 боевых товаров — восстанавливать пришлось повторной отправкой всего каталога из базы. Тестовую позицию слать только внутри полного пакета или на пустой базе.