Как настроить интеграцию с 1С для учета на площадке услуг
Многие владельцы площадок услуг уже используют 1С для бухгалтерского и управленческого учёта. Ручной перенос заказов, оплат и данных об исполнителях из сайта в 1С — это потеря времени и риск ошибок. Интеграция сайта с 1С автоматизирует обмен: заказы с площадки автоматически попадают в 1С, а остатки товаров или статусы отгрузки передаются обратно. В этой статье — как настроить такую интеграцию для Falcon Space, используя универсальный API.
В кейсах Falcon Space есть примеры интеграции с 1С: товарный маркетплейс для розничных магазинов (синхронизация товаров) и сервис для фулфилмента (передача заказов на склад). Расскажу общие принципы.
Когда нужна интеграция с 1С
- Вы продаёте физические товары через площадку (каталог товаров с остатками).
- Вам нужно выгружать заказы в бухгалтерию для выставления счетов.
- Вы хотите отслеживать взаиморасчёты с исполнителями в 1С.
- У вас уже есть учётная система на базе 1С, и вы не хотите её менять.
Способы интеграции Falcon Space с 1С
- Через API (HTTP/HTTPS). 1С умеет отправлять и принимать HTTP-запросы в формате JSON или XML. В Falcon Space есть встроенный универсальный API. Вы можете создать внешнее действие, которое при создании нового заказа отправляет POST-запрос в 1С. Там заказ создаётся автоматически. Обратно, 1С может присылать обновления (статус оплаты, номер накладной) на ваш вебхук. Это наиболее современный и гибкий способ.
- Через Linked Server (MS SQL). Если 1С работает на SQL Server, можно настроить Linked Server между базой данных Falcon Space и базой 1С, и напрямую писать хранимые процедуры, которые обмениваются данными. Это сложнее, но работает быстрее при больших объёмах.
- Обмен файлами (CSV, XML). Самый простой, но не оперативный. Раз в час выгружать заказы в файл, который 1С забирает с FTP. Не подходит для реального времени.
Что синхронизировать в первую очередь
- Каталог товаров/услуг (из 1С в сайт).
- Заказы (из сайта в 1С).
- Статусы заказов (из 1С в сайт: «Отгружен», «Оплачен», «Доставлен»).
- Взаиморасчёты с исполнителями (начисления, выплаты).
Пример: товарный маркетплейс для розничных магазинов (кейс на Falcon Space)
В этом проекте поставщики загружают товары вручную или через 1С. Товары синхронизируются: если в 1С изменилась цена или остаток, через API обновление приходит на сайт. Заказ, оформленный покупателем, автоматически передаётся в 1С поставщика. Это исключило двойной ввод и ошибки.
Технически: в 1С создали обработку, которая раз в минуту отправляет GET-запрос к API Falcon Space: «дай все заказы с флагом new». Забирает их, создаёт документы в 1С, и возвращает POST-запросом статус «Принят к обработке».
Как настроить интеграцию на Falcon Space (шаги)
- Создайте API-ключ. В административной панели Falcon Space есть раздел «API», где вы генерируете ключ для внешнего доступа.
- Реализуйте эндпоинты. Напишите хранимые процедуры, которые возвращают новые заказы в формате JSON, и процедуры, которые обновляют статус заказа. Пример:
EXEC GetNewOrdersFor1C.
- Настройте вызовы из 1С. В 1С напишите обработку на встроенном языке, которая использует HTTP-соединение для вызова этих процедур. Это может сделать 1С-программист за 1–2 дня.
- Обработка входящих вебхуков от 1С. В Falcon Space создайте внешнее действие, которое слушает POST-запросы на определённый URL. При получении данных вызывает процедуру обновления статуса заказа.
Сложности и как их избежать
- Дублирование заказов. Добавьте в процедуру проверку: не был ли уже передан этот заказ (по ID).
- Таймауты при большой загрузке. Используйте асинхронную обработку: сначала 1С получает список ID, а затем запрашивает каждый детально.
- Безопасность. Используйте HTTPS и API-ключи, не забывайте проверять подпись запроса.
Готовые решения для интеграции Falcon Space
Falcon Space не имеет встроенного модуля 1С, но мы можем помочь с разработкой кастомной интеграции на вашем проекте. В арсенале уже есть типовые скрипты для популярных задач (выгрузка заказов, синхронизация остатков).
Если вы планируете интеграцию с 1С, закладывайте бюджет от 50 000 до 150 000 руб в зависимости от сложности. Это окупится экономией на ручном вводе данных за 2–3 месяца. И помните: интеграция с 1С не нужна на старте. Начните с ручного учёта, а когда заказов станет 200+ в месяц — тогда автоматизируйте.