Как интегрировать Aqsi с 1С

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

Интеграция Aqsi с 1С решает три задачи: синхронизация номенклатуры и цен, автоматическая выгрузка продаж и возвратов в учётную систему, актуализация складских остатков. В зависимости от конфигурации 1С и объёма ассортимента это можно сделать штатными средствами обмена, через готовые модули-коннекторы или через открытый API Aqsi силами своего разработчика.

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

Что передавать между Aqsi и 1С

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

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

Три способа подключения: модуль, файлы, API

Первый способ — готовый модуль интеграции. Для популярных конфигураций (1С:Розница, Управление торговлей, Комплексная автоматизация) существуют сторонние обработки и расширения, которые подключаются к API Aqsi и выполняют обмен по расписанию. Это самый быстрый путь: настройка занимает от нескольких часов до пары дней, но модуль нужно адаптировать под конкретную конфигурацию и её доработки.

Второй способ — файловый обмен. Из 1С выгружается номенклатура в CSV или Excel и загружается в личный кабинет Aqsi, а продажи выгружаются из Aqsi и загружаются в 1С обработкой. Способ подходит для точек с небольшим ассортиментом и редкими изменениями цен, но требует ручных действий и плохо масштабируется.

Третий способ — собственная интеграция через API. Aqsi предоставляет REST API для работы с товарами, чеками и магазинами. Разработчик на стороне 1С пишет обмен: регламентные задания опрашивают API или принимают события, данные преобразуются в документы 1С. Это самый гибкий, но и самый трудоёмкий вариант.

Сравнение способов интеграции

Готовый модуль

Быстрый старт, обмен по расписанию. Ограничение: зависимость от разработчика модуля и совместимости с конфигурацией.

Файловый обмен CSV/Excel

Не требует разработки, подходит для малого ассортимента. Ограничение: ручные операции, риск устаревших цен и остатков.

Собственная разработка на API

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

Подготовка: что проверить до начала настройки

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

Проверьте версию конфигурации 1С и наличие лицензии на нужный уровень тарифа Aqsi: доступ к API и выгрузкам может зависеть от тарифного плана. Убедитесь, что у вас есть доступ администратора в личный кабинет Aqsi и возможность получить API-ключ (токен) в настройках интеграций.

Настройка обмена номенклатурой и ценами

Обмен начинается с сопоставления товаров. Ключ синхронизации — штрихкод или внешний код (externalId), который записывается в карточку товара в Aqsi и хранится в 1С. Если сопоставлять по наименованию, любая правка названия разорвёт связь и создаст дубликат.

Типовая последовательность выглядит так: в 1С формируется выгрузка товаров с кодами, штрихкодами, ценами и группами; данные передаются в Aqsi через модуль или API; в личном кабинете проверяется, что товары попали в нужные категории и доступны на кассе. После этого изменения цен и новые товары выгружаются по расписанию — например, каждый час или при записи карточки.

1. 1
   Получите API-ключ в личном кабинете Aqsi (раздел интеграций или настройки магазина).
2. 2
   Установите и настройте модуль обмена в 1С либо подготовьте обработку выгрузки.
3. 3
   Задайте правило сопоставления: штрихкод или внешний код как ключ синхронизации.
4. 4
   Выполните первую полную выгрузку товаров в тестовом режиме и сверьте 10–20 позиций вручную.
5. 5
   Включите регулярную синхронизацию по расписанию и проверьте, что новые товары появляются на кассе.

Загрузка продаж и возвратов в 1С

Продажи выгружаются из Aqsi в виде чеков: позиции, количество, суммы, типы оплаты, применённые скидки. В 1С на их основании создаётся «Отчёт о розничных продажах» (в Рознице и УТ) за каждую кассовую смену. Важно, чтобы обмен учитывал возвраты и чеки коррекции — иначе выручка в 1С будет завышена.

Настройте соответствие типов оплат: наличные, безналичные, смешанная оплата должны попадать в правильные статьи движения денежных средств. Если используется несколько магазинов в Aqsi, каждый магазин должен быть связан со своим складом и кассой в 1С — это критично для корректных остатков.

Синхронизация остатков и инвентаризация

Остатки — самая чувствительная часть интеграции. Базовый сценарий: 1С списывает остатки по загруженным чекам, а Aqsi получает из 1С текущие остатки для отображения на кассе. Расхождения неизбежны из-за недостач, пересортицы и ошибок приёмки, поэтому инвентаризации нужно проводить регулярно и вводить их результаты в 1С.

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

Контрольные точки

Как проверить результат

Остаток по 5–10 ходовым товарам

Норма

Количество в 1С и в Aqsi совпадает

Тревожный признак

Расхождение растёт от дня к дню — продажи или оприходования не доходят

Отчёт о розничных продажах за смену

Норма

Сумма документа равна Z-отчёту кассы

Тревожный признак

Разница по наличным или безналу — не настроены типы оплат или возвраты

Новый товар

Норма

После выгрузки виден на кассе с верной ценой

Тревожный признак

Дубль карточки или устаревшая цена — нарушено сопоставление по коду

Типичные ошибки и их последствия

Большинство проблем интеграции связано не с технической частью, а с данными и регламентом. Дубли номенклатуры возникают при сопоставлении по наименованию, «потерянные» чеки — при смене кассирами магазина в приложении или при обрывах обмена без контроля загруженных смен.

Когда нужен разработчик и как контролировать его работу

Если у вас типовая конфигурация без доработок и один-два магазина, готового модуля обычно достаточно. Разработчик нужен, когда конфигурация сильно изменена, есть нестандартные документы, несколько юрлиц, сложные схемы скидок или требования по маркировке, которые модуль не покрывает.

При заказе разработки фиксируйте в задании: состав передаваемых данных, ключи сопоставления, поведение при ошибках (повторная отправка, журнал ошибок), расписание обмена и способ контроля — сверку сумм продаж и остатков. Приёмку выполняйте на копии базы с реальными данными за прошедший месяц: прогоните обмен и сравните итоги с фактическими отчётами кассы.

Частые вопросы

Можно ли интегрировать Aqsi с 1С:Бухгалтерией?

Да, но с ограничениями. В Бухгалтерии нет полноценного оперативного учёта розницы, поэтому обычно загружают сводные данные по выручке и оплатам для отражения в учёте, а товарный учёт ведут в Aqsi или в отдельной торговой конфигурации. Для полноценного учёта продаж лучше подходят Розница или Управление торговлей.

Как часто должна проходить синхронизация?

Продажи разумно загружать после закрытия каждой кассовой смены или несколько раз в день. Номенклатуру и цены — по расписанию (раз в час или при изменении). Слишком частый опрос API без необходимости создаёт лишнюю нагрузку и может упираться в ограничения тарифа.

Что делать, если в 1С и Aqsi разошлись остатки?

Сначала локализуйте период: сверьте остатки по дням, начиная с последней даты, когда они совпадали. Затем проверьте, все ли смены загружены, нет ли непроведённых документов и ручных корректировок на кассе. Расхождение закрывается инвентаризацией в 1С с последующей выгрузкой остатков в Aqsi.

Поддерживается ли передача данных по маркированным товарам?

Коды маркировки фиксируются в чеках Aqsi и могут передаваться в 1С вместе с продажами, если это предусмотрено модулем или доработано через API. Проверьте заранее, что выбранный способ обмена переносит коды, иначе отчётность по маркировке придётся вести отдельно.

Нужен ли постоянный интернет на кассе для работы интеграции?

Касса Aqsi умеет работать офлайн и отправляет данные при появлении связи. Для интеграции это означает, что чеки могут доходить до 1С с задержкой. Учитывайте это при сверке: отсутствие смены в 1С утром не всегда означает сбой — возможно, касса просто ещё не синхронизировалась.

Можно ли настроить обмен без программиста?

Для файлового обмена и базовой настройки готового модуля достаточно опытного пользователя или специалиста по внедрению 1С. Собственная разработка через API, доработка нестандартных сценариев и исправление конфликтов с доработанной конфигурацией требуют программиста 1С.