Тема
Как подключить 1С:Розницу 3.0
Подключение рассчитано на одну базу 1С:Розницы 3.0, один тип цены в рублях и физические товары, продаваемые целыми единицами. Остатки берутся с выбранного склада или из общего остатка, переданного вашей базой.
Проверка совместимости
Инструкция описывает подготовленное подключение. Полная проверка на реальной базе 1С:Розницы 3.0 ещё не завершена, подтверждённые релизы пока не указаны. Названия разделов и возможности обмена могут отличаться в вашей версии 1С.
Настройки обмена — в 1С
В Appiko вы подтверждаете подключение и получаете данные доступа. Товары, цены, остатки и выполнение заказов настраиваются в 1С. После получения готовых данных товары появляются в магазине автоматически.
1. Подключите 1С в Appiko
- Откройте магазин в Appiko и перейдите в Настройки → 1С:Розница 3.0.
- Нажмите Подключить 1С. В окне Подключить 1С? прочитайте условия и подтвердите кнопкой Подключить 1С: каталог будет обновляться из 1С, а выполнение заказов — обрабатываться в 1С.
- Скопируйте Адрес обмена, Логин и Пароль — они понадобятся в 1С.
Если в магазине уже есть товары, они останутся на витрине до получения готовых данных из 1С. После начала публикации каталог 1С заменит прежний каталог. История заказов сохранится; автоматического объединения товаров по названию или артикулу нет. Покупателям может потребоваться заново собрать корзину.
Данные обмена не заменяют логин и пароль пользователя вашей базы 1С. Пароль показывается только после создания. Если он потерян, раскройте Данные подключения, нажмите Заменить пароль и замените его в 1С: старый сразу перестанет работать.
Если уже подключён МойСклад
В магазине может работать только одна учётная интеграция: 1С или МойСклад. Сначала отключите обмен с МоимСкладом:
- При подключении через решение в каталоге МоегоСклада откройте окно решения и нажмите Отключить магазин.
- При прежнем подключении с API-токеном откройте Настройки → МойСклад, нажмите Отключить МойСклад и перейти на каталог Appiko и подтвердите действие.
Товары сохранятся в каталоге Appiko. После этого можно подключать 1С. Подробнее об отключении МоегоСклада.
2. Отправьте первый полный каталог из 1С
В 1С:Рознице найдите Интернет-магазин. Расположение раздела зависит от версии и настроек интерфейса: при необходимости воспользуйтесь поиском команд 1С.
Настройте обмен с интернет-магазином по CommerceML через HTTP и укажите адрес, логин и пароль из Appiko. Адрес нужно скопировать целиком.
В разделе Авторизация выберите Тип сайта → 1С-Битрикс и сохраните настройку. Appiko поддерживает этот протокол обмена. При выборе Другой загрузка списка статусов может не работать, даже если товары и изменения заказов передаются успешно.
Какой обмен выбрать
Для Appiko используется Интернет-магазин. Настройка Синхронизация данных через универсальный формат предназначена для другого механизма обмена. Если 1С сообщает об ошибке WSDL или InterfaceVersion, проверьте, что адрес Appiko указан именно в подключении интернет-магазина по HTTP.
Перед первым запуском проверьте состав выгрузки:
| Данные | Что передавать |
|---|---|
| Товары | Нужные товары и их категории; проверьте отбор товаров для этого интернет-магазина |
| Остатки | Свободные остатки с учётом резервов: по одному складу или общий остаток для магазина |
| Цены | Цены товаров одного вида в рублях |
| Фотографии | Включите выгрузку изображений, если они нужны на витрине |
| Заказы | Загрузка заказов в 1С и передача их состояний обратно в Appiko |
Запустите полную выгрузку выбранных товаров, чтобы Appiko получил карточки, цены и остатки. Передачи только изменений или проверки соединения для первого подключения недостаточно. Дождитесь завершения обмена в 1С, включая фотографии.
Форматы и ограничения загрузки
Поддерживаются физические товары, продаваемые целыми единицами, и цены в рублях. Изображения — JPEG, PNG и WebP.
За одну выгрузку можно передать до 5 000 товарных позиций, до 16 МБ на XML-файл и до 128 МБ за сеанс обмена. Варианты товаров также учитываются как отдельные товарные позиции. Выгрузка, превышающая лимит, отклоняется.
Подключение рассчитано на штатный обмен. Не устанавливайте дополнительный модуль только ради этой инструкции: необходимость и совместимость модуля проверяются для конкретной базы.
3. Дождитесь появления товаров
Вернитесь в Настройки → 1С:Розница 3.0 в Appiko. Открытая страница сама обновляет состояние обмена. Когда товары появятся в магазине, здесь будет показано их количество. Отдельно публиковать каталог в Appiko не нужно.
Товары появятся автоматически, когда Appiko получит и проверит их карточки, цены, остатки и передаваемые изображения. Если данные приходят частями, каталог может появляться постепенно. Сообщение об успешной передаче одного файла в 1С ещё не означает, что все товары готовы к продаже.
После начала публикации появится состояние Каталог обновляется из 1С. Откройте магазин и проверьте товары, цены, фотографии и доступное количество. Следующие обновления также применяются автоматически.
Если выгружаются цены нескольких видов или остатки нескольких складов, Appiko покажет причину остановки. Исправьте состав выгрузки в 1С: оставьте один нужный вид цены и один склад либо передавайте общий остаток. Затем повторите полную выгрузку. Назначать произвольный вариант Appiko не будет.
Если товары пока не готовы, состояние подскажет следующий шаг:
| Состояние | Что делать |
|---|---|
| Ожидаем подключения 1С | Сохраните адрес, логин и пароль в 1С и запустите обмен |
| Ожидаем товары из 1С | Соединение уже установлено; отправьте первый полный каталог |
| Получаем товары из 1С | Дождитесь передачи карточек, цен, остатков и изображений |
| Проверьте настройки выгрузки в 1С | Исправьте указанную причину в 1С и повторите полную выгрузку |
| В выгрузке нет товаров | Проверьте состав и отбор товаров в 1С, затем отправьте полный каталог |
Как обновляется уже опубликованный каталог
Товары, категории, цены и остатки активного каталога изменяйте в 1С. Если выгрузка приходит несколькими частями, Appiko обновляет явно переданные товары. Отсутствие товара в отдельной части не означает удаление: позиции, которых нет в полной выгрузке, убираются только после подтверждения завершения всего набора со стороны 1С. Если такого сигнала нет, пропущенные позиции сохраняются; для удаления передайте явную пометку удаления товара.
Включите расписание и проверьте заказы
Включите обмен по расписанию в 1С. Начальный рекомендуемый интервал — 5 минут. База должна работать и иметь доступ к адресу обмена: выключенный компьютер с единственной локальной базой не сможет отправить обновления. В облаке проверьте, что провайдер разрешает внешние HTTPS-соединения и автоматические задания для вашей базы.
Оформите пробный заказ в магазине, дождитесь обмена и проверьте в 1С товары, покупателя и доставку. Проверьте, что повторный обмен не создаёт новый заказ вместо ранее полученного.
При новом подключении выполнение заказов ведётся в 1С. Appiko получает поддерживаемые состояния из учётной базы; кнопки изменения выполнения таких заказов в Appiko скрыты. После отключения 1С управление выполнением возвращается в Appiko. Оплата учитывается отдельно от выполнения заказа.
Для ранее созданных подключений прежний порядок работы сохраняется. Чтобы включить автоматическую публикацию и обработку заказов в 1С, нажмите Перейти на управление из 1С и подтвердите условия подключения. Создавать новый пароль для этого не нужно.
Свободные остатки и резервы
Настройте в 1С передачу свободных остатков с учётом принятых заказов. После получения заказа из Appiko база должна учесть его в доступном количестве, например зарезервировать товары. Следующая выгрузка должна передать остаток, уже уменьшенный на занятые этим заказом товары.
Проверьте это на пробном заказе. Успешное получение заказа в 1С само по себе не подтверждает резервирование. Передача общего количества без учёта заказов может привести к продаже товара, который уже занят другим покупателем.
Настройте соответствие статусов в 1С
Перед загрузкой проверьте: в разделе Авторизация выбран тип сайта 1С-Битрикс, настройка сохранена. Если кнопка загрузки статусов сообщает «Не удалось загрузить список платежных систем с сайта», сначала проверьте тип сайта: это сообщение может появляться и при ошибке загрузки статусов.
Если соответствия уже заполнены
Кнопка Загрузить статусы заказов с сайта заново заполняет таблицу и сбрасывает состояния документов, резервирование и склад резерва. Перед повторной загрузкой сохраните снимок всех колонок текущих строк, чтобы затем восстановить соответствия и параметры резервирования.
- В настройке Интеграция с интернет-магазином откройте Статусы и включите Обмениваться статусами заказа.
- Нажмите Загрузить статусы заказов с сайта. Appiko передаст названия и коды статусов в таблицу — вводить их вручную не нужно.
- Удалите строки с этапами, которые вы не используете. Для каждой оставленной строки выберите соответствующее состояние вашей базы в колонке Состояние документа — 1С требует заполнить её перед сохранением. Коды сайта оставьте без изменений. Для разных этапов выбирайте разные состояния 1С, чтобы обратный обмен однозначно определял статус Appiko.
- Сохраните настройку. В разделе Заказы проверьте, что включена выгрузка изменений заказов из 1С на сайт.
Соответствие настраивается только в 1С. Appiko передаёт следующий список:
| Этап | Код сайта (заполняется автоматически) |
|---|---|
| Новый | pending |
| Собирается | preparing |
| Готов к выдаче | ready_for_pickup |
| Доставляется | delivering |
| Доставлен | delivered |
| Завершён | completed |
| Отменён | cancelled |
Для проверки измените в 1С состояние полученного из Appiko пробного заказа, например с нового на сопоставленное этапу Собирается, сохраните документ и запустите синхронизацию вручную. В Appiko должны измениться этап заказа и появиться запись в истории. Повторный обмен не должен добавлять такую же запись. После этого изменения будут приходить по вашему расписанию обмена.
Если статус не изменился, проверьте соответствие состояний, сохранение заказа и выгрузку изменений заказов на сайт. Затем посмотрите сообщение последнего обмена в Appiko. Завершённый заказ нельзя вернуть на предыдущий этап через обмен.
Для прежних подключений без кода распознаются названия из таблицы и значения В работе и К выполнению (сборка); Выполнен и Закрыт (завершён); Отменен и Отменён. При наличии кода используется именно он.
Оплата из 1С
Оформите и проведите в 1С платёжный документ, привязанный к заказу из Appiko. При полной оплате проведённого заказа 1С передаёт признак Оплачен во время обмена. Appiko принимает его и для заказа, который уже Завершён: отметка оплаты меняется, а этап выполнения остаётся завершённым. В истории заказа сохраняется подтверждение оплаты из 1С. Повторный обмен не создаёт повторного подтверждения.
Для проверки завершите неоплаченный пробный заказ в Appiko через обмен из 1С. Затем оформите в 1С полную оплату этого заказа и снова запустите обмен. В Appiko должны отображаться одновременно Завершён и Оплачен. Платёжный документ должен относиться именно к этому заказу.
Частичная оплата не считается полной. Возврат или отмена оплаты в 1С автоматически не снимают отметку Оплачен в Appiko. Для отменённого заказа новое подтверждение оплаты не принимается.
Оплата учитывается отдельно от сборки и доставки. Передача признака оплаты не означает создание платёжного документа, кассового чека или документа бухгалтерского учёта. Такое оформление в эту интеграцию не входит.
Если обмен остановился
В настройках Appiko отображаются состояние обмена, время последнего обновления и сообщение об ошибке. После исправления запустите обмен из 1С. Открытая страница Appiko обновится сама.
Частоту обмена вы задаёте в 1С. Перерыв между выгрузками не блокирует оформление заказов: Appiko использует последние полученные остатки с учётом заказов магазина. Время последнего получения остатков видно в настройках интеграции. Успешный обмен без данных об остатках не меняет это время.
Если обмен остановился, новые заказы сохраняются в Appiko и передаются в 1С после возобновления обмена.
Отключение и переход на МойСклад
В Настройках → 1С:Розница 3.0 нажмите Отключить 1С и подтвердите действие. Если использовался каталог 1С, магазин перейдёт на каталог Appiko: товары и последние полученные цены и остатки сохранятся, их можно будет редактировать вручную. Обмен каталогом и заказами остановится, в том числе для ранее созданных заказов. Проверьте незавершённые заказы в вашей базе.
Теперь можно открыть Настройки → МойСклад и подключить его. Одновременно включить обе интеграции нельзя, даже если первая загрузка 1С ещё не активирована.
Данные подключения 1С сохраняются. Для возврата сначала отключите МойСклад, затем откройте настройки 1С и нажмите Включить 1С. Подтвердите условия подключения и выполните полную выгрузку. Для автоматического режима товары снова появятся после получения готовых данных.
Что проверить при ошибке
| Ситуация | Что проверить |
|---|---|
| Нет складов или типов цен | Дождитесь полной выгрузки; для общего остатка сведения о складах не нужны, а цены товаров должны быть переданы |
| Несколько видов цен или складов | В настройках выгрузки 1С оставьте один вид цены в рублях и один склад либо общий остаток |
| Не подходит тип цены | Для магазина требуется цена с валютой RUB |
| Не удаётся войти при обмене | Адрес, логин и пароль совпадают с данными Appiko; после замены пароля обновлены настройки 1С |
| В 1С выгрузка успешна, а товаров в магазине нет | В Appiko проверьте состояние обмена: получены ли карточки, цены, остатки и изображения; для прежнего подключения воспользуйтесь кнопкой Перейти на управление из 1С, если хотите включить автоматический режим |
| Ошибка WSDL или InterfaceVersion | Используется Интернет-магазин с обменом по HTTP, а не синхронизация через универсальный формат |
| Новые заказы недоступны | Интеграция включена, первая выгрузка остатков получена и товара достаточно для заказа |
| Расписание не выполняется | База 1С работает, фоновые задания разрешены, внешний адрес доступен |
| Подключение заблокировано МоимСкладом | Сначала отключите МойСклад в его настройках |