Как подключить 1С

1С подключается не ключом, а HTTP-сервисом на её стороне: Зантор ВМС ходит к нему как обычный клиент. У каждой внедрённой 1С свои доработки, поэтому разговор идёт не с конфигурацией, а с тремя методами простого JSON, описанными ниже. Сервис публикует тот, кто ведёт вашу 1С, — у нас доступа к ней нет.

Что понадобится

Значение	Что это	Зачем системе
Адрес HTTP-сервиса	Адрес публикации базы	Куда ходить: к нему дописываются `/items`, `/orders` и `/shipments`
Логин	Пользователь 1С	Учётная запись, от имени которой идёт обмен
Пароль	Пароль этого пользователя	Хранится шифрованным и наружу не отдаётся

Учётную запись заводят отдельную, под обмен: по журналу 1С должно быть видно, что сделал склад, а что человек. Прав ей нужно ровно столько, сколько перечислено ниже.

Что пойдёт после подключения

Заказы покупателей забираются из 1С и становятся заказами склада.
Номенклатура забирается оттуда же: артикул, название, штрихкод, срок годности и единица — заводить её руками не нужно. Единица ставится новому товару; у знакомого она уже посчитана в остатках и не меняется.
Отгрузка уходит обратно в 1С фактом: что и сколько уехало и под каким номером у склада.

Остатки в 1С мы не пишем: учёт остатка ведёт склад, и две системы, пишущие один остаток, расходятся на первой же ошибке связи.

Что отдаёт и принимает HTTP-сервис

Вход — Basic-авторизацией пользователя обмена. since — время прошлого удачного обмена: сервис отдаёт то, что изменилось после него, а без параметра — всё.

GET /items?since=…
{ "items": [{ "sku": "КОФ-001", "name": "Кофе в зёрнах 1 кг", "barcode": "4601234567890",
              "shelfLifeDays": 365, "unit": "шт" }] }

GET /orders?since=…
{ "orders": [{ "id": "ЗП-00017", "number": "ЗП-00017", "customer": "ООО «Кофейня»",
               "shipBy": "2026-10-01T09:00:00Z", "lines": [{ "sku": "КОФ-001", "qty": 4 }] }] }

POST /shipments
{ "orderId": "ЗП-00017", "orderNumber": "ЗК-0042", "shippedAt": "2026-10-01T08:40:00Z",
  "packages": 1, "lines": [{ "sku": "КОФ-001", "qty": 4 }] }

Вместо sku сервис может отдавать code. Единица — словом из справочника: «шт», «кг», «м», «упак»; незнакомая встаёт штуками.

Отгрузка приходит с заголовком Idempotency-Key: один ключ на заказ. Если связь оборвалась после того, как 1С провела отгрузку, склад пришлёт её ещё раз с тем же ключом — такую 1С второй раз не проводит и отвечает 200 или 409.

Если не работает

Состояние канала считается по обменам, а не по галочке «включён»: на «Каналах» видно, когда он отвечал в последний раз и чем. Каждый обмен — строка в «Журнале обменов»: что шло — заказы, остатки, отгрузка — и чем кончилось. Частые отказы панель называет словами: что случилось и что проверить.

Что видно	Что это значит
«1С отказала в доступе»	Логин или пароль не подходят
«1С ответила „не найдено“»	Адрес HTTP-сервиса указан неверно или база не опубликована
«1С не ответила»	База недоступна снаружи: проверьте, что адрес открыт нашему серверу
Заказ из 1С не появился	У заказа в 1С нет состава или он закрыт правами пользователя: заказ без строк склад не заводит

Неудавшийся обмен повторяется сам — со следующим обменом по расписанию канала; когда будет попытка, видно в строке журнала. «Повторить сейчас» запускает шаг, не дожидаясь расписания, — когда причина уже исправлена.