Оглавление
Что делает приложениеПеред началомМини-словарьКак получить API-ключиПервая настройка ГлавнаяПроблемыКак заказ попадает в МойСкладОбъявления и товары Готовность«Компания»«Заказы»Справочник настроекЖизненный цикл кабинета Ошибки подключенияЧего нетЧастые вопросыПоддержкаСправка SkladSync для Авито
Как подключить кабинет Авито к МоемуСкладу, что делает приложение и что остаётся за вами. Страницу можно читать с начала или открыть нужный раздел из оглавления. Если чего-то не хватает — напишите в чат приложения или на support@skladsync.ru.
Что делает приложение
«SkladSync для Авито» — приложение для МоегоСклада. Оно берёт заказы Авито Доставки и создаёт по ним документы «Заказ покупателя» в МоёмСкладе. Так проданный на Авито товар сразу попадает в резерв, и вы не продадите его второй раз в другом месте.
Что приложение делает:
- подключает ваш кабинет Авито по ключам API («client_id» и «client_secret»);
- получает ваши объявления и помогает связать их с товарами МоегоСклада;
- создаёт в МоёмСкладе «Заказ покупателя» по каждому заказу Авито Доставки со связанным объявлением; заказ проводится и ставит резерв;
- обновляет статус заказа в МоёмСкладе по статусу Авито;
- показывает в «Проблемах» то, что требует вашего решения: заказ, который нужно подтвердить до срока, отменённый или спорный заказ, невыбранный склад.
Подтверждаете заказы вы в кабинете Авито. Отгружаете товар — в МоёмСкладе. Резерв отменённого заказа по умолчанию снимаете вы в МоёмСкладе; если включить настройку «Снимать резерв отменённого заказа, когда вы нажмёте «Возврат принят» или «Товар у меня»», его снимет SkladSync по вашему нажатию в «Проблемах». Подробнее — в разделе «Как заказ попадает в МойСклад», а то, чего приложение не делает, собрано в разделе «Чего приложение не делает».
Перед началом — что подготовить
- Права администратора организации в МоёмСкладе — чтобы установить приложение и подтвердить ему права.
- Аккаунт Авито с доступом к API. По правилам Авито, ключи API выдаются при подключённом тарифе Авито. Подробности — в разделе «Как получить API-ключи».
- «Авито Доставка для бизнеса». API заказов Авито работает только с ней (по документации Авито). Без неё приложение не получит заказы — при проверке вы увидите отдельную ошибку, см. «Ошибки подключения».
- Склад МоегоСклада, под который будут резервироваться заказы Авито. Без выбранного склада обмен не включить.
- Для связи объявлений с товарами — артикулы, коды или штрихкоды товаров в МоёмСкладе: у объявления Авито артикула нет, связи вы задаёте сами.
Мини-словарь
- Кабинет — одно подключение вашего аккаунта Авито: ключи, объявления, настройки и журнал. Один кабинет — один пользователь Авито.
- client_id (идентификатор клиента) и client_secret (секрет) — пара ключей API. Это «логин и пароль» не для вас, а для программы: по ним Авито понимает, что приложению можно читать ваши данные. Выдаёт их Авито.
- Объявление — объявление на Авито. У него есть номер, но нет артикула.
- Связь (в интерфейсе — «связать», «Привязать») — соответствие «объявление Авито ↔ товар МоегоСклада». Заказ создаётся только по связанным объявлениям. Вкладка с такими объявлениями называется «СОПОСТАВЛЕНО» — это то же самое.
- Склад заказа — склад МоегоСклада, который проставляется в «Заказ покупателя» и за которым резервируется товар.
- Резерв — отметка в МоёмСкладе «этот товар уже продан и ждёт отгрузки».
- Проведение — когда документ «Заказ покупателя» проведён, он учитывает резерв и уменьшает доступный остаток.
- Срок подтверждения — время, до которого заказ нужно подтвердить в кабинете Авито. Если не подтвердить, Авито отменяет заказ сам.
- Кабинет «выключен» — подключён, но обмен не идёт: заказы в МойСклад не передаются. Все кабинеты сначала сохраняются выключенными.
Как получить API-ключи
Чтобы подключить кабинет, нужны два значения: «client_id» и «client_secret». Их выдаёт Авито, а не SkladSync.
Что это такое
«client_id» и «client_secret» — как логин и пароль, только для программы. С их помощью приложение получает у Авито временный ключ доступа и читает ваши объявления и заказы. Секрет — это пароль: он никому не показывается.
SkladSync работает в режиме персональной авторизации Авито (в документации он называется «client_credentials»). По документации Авито, в этом режиме отдельные права доступа (scopes) выбирать не нужно.
Где искать
Откройте в личном кабинете Авито страницу «Интеграции и API»: avito.ru/professionals/api. В меню кабинета: «Профиль и настройки» → «Интеграции и API». Ключи выдаются на этой странице, в блоке «Собственная разработка»: там написано, что нужно подключить любой тариф и получить ключи доступа. Ниже на странице появятся поля «Client_id» и «Client_secret» — это и есть два значения для SkladSync.
Официальные страницы Авито:
- developers.avito.ru/about-api — как устроен API Авито и как получить доступ;
- правила использования API Авито.
Если страницы нет или ключей нет
- Проверьте, что вы вошли в тот аккаунт Авито, на котором размещены объявления и подключена доставка.
- Проверьте пункт «Тариф» в левом меню: у аккаунта должен быть подключён тариф Авито, без него ключи на странице «Интеграции и API» не выдаются.
- Если страница «Интеграции и API» недоступна или ключи не появились, напишите в поддержку Авито: ключи выдаёт Авито.
Как вставить ключи в SkladSync
- Откройте приложение в МоёмСкладе: «Решения» → «SkladSync для Авито». Откроется форма «Подключить кабинет Авито».
- В поле «client_id» вставьте идентификатор клиента.
- В поле «client_secret» вставьте секрет. Копируйте целиком, без пробелов в начале и в конце.
- Нажмите «Проверить ключи». Если всё в порядке, появится «✓ Ключи работают».
- Нажмите «Подключить Авито».
Дальше — первая настройка по шагам.
Безопасность
- Секрет — как пароль. Не отправляйте его в чаты и письма, в том числе нам.
- Ключи хранятся на нашем сервере. Сохранённый «client_secret» приложение не показывает: вместо него видно «Ключ сохранён». «client_id» виден в настройках кабинета.
- Если секрет мог попасть не туда, получите новый ключ у Авито (по правилам Авито, меры для получения нового ключа вы принимаете сами) и замените его на вкладке «API» кабинета: «Заменить» → «Новый client_secret» → «Сохранить ключи».
- Временный ключ доступа, который Авито выдаёт по вашим ключам, живёт сутки. Приложение получает новый само — от вас ничего не нужно.
Первая настройка — от установки до «обмен идёт»
Порядок такой же, как подсказывает блок «Следующий шаг» на «Главной». Каждый шаг — одно действие.
- Установите приложение в МоёмСкладе и откройте его: «Решения» → «SkladSync для Авито». Вход происходит автоматически, отдельный логин и пароль не нужны.
- Получите ключи Авито — по инструкции выше.
- Заполните форму «Подключить кабинет Авито». В поле «Название кабинета» уже стоит «Мой кабинет Авито» — можно оставить или написать своё. Вставьте «client_id» и «client_secret».
- Нажмите «Проверить ключи» — по желанию. Приложение проверит ключи, аккаунт, объявления и заказы и ответит «✓ Ключи работают» или назовёт причину отказа (см. «Ошибки подключения»). Ничего не сохраняется.
- Нажмите «Подключить Авито». Приложение ещё раз проверит ключи и сохранит кабинет выключенным. Обмен не идёт, заказы не создаются — так вы не получите обмен случайно. Откроется вкладка «API» нового кабинета.
- Выберите склад заказа. Откройте «Настройка» → «Компания» и выберите «Склад заказа». Это обязательно: без склада кабинет не включить. Остальные поля («Организация», «Контрагент», «Канал продаж», «Проект», «Договор») можно не заполнять — подробности в разделе «Вкладка «Компания»». Когда склад выбран, шаг «выберите склад заказа» на «Главной» должен пропасть.
- Получите объявления. Откройте «Товары» и нажмите «Получить объявления». Приложение прочитает объявления всех статусов; на Авито и в МоёмСкладе ничего не меняется. Результат: «Получено объявлений: N.»
- Свяжите объявления с товарами. По одному или списком — см. «Объявления и товары». Заказ по несвязанному объявлению не создаётся.
- Проверьте дату начала заказов. Откройте «Настройка» → «Заказы» и посмотрите «Дату начала синхронизации заказов». Заказы, созданные раньше этой даты, в МойСклад не попадут. Если дата не задана, при первом включении встанет момент включения. День считается по московскому времени.
- Включите обмен. Включите переключатель «Кабинет активен» в шапке кабинета (кнопка «Включить» на «Главной» только открывает вкладку «API» кабинета — переключатель всё равно нужно нажать). Приложение спросит подтверждение: «Включить обмен в кабинете «имя»?» В нём сказано, что SkladSync начнёт автоматически читать заказы, что обрабатываются заказы, оформленные с момента включения, а более ранние автоматически не создаются (граница — «Дата начала синхронизации заказов», см. шаг выше), и перечислены незакрытые обязательные шаги «Готовности».
- Убедитесь, что всё работает. После включения появится сообщение «Обмен включён в <время МСК>. Заказы — с этой минуты: оформленные раньше SkladSync не создаёт.» На «Главной» в карточке кабинета будет строка «Заказы: …», а в «Готовности» — «всё обязательное настроено» или число оставшихся шагов.
Что дальше. Открывайте «Главную» и «Проблемы», подтверждайте заказы в кабинете Авито, отгружайте товар в МоёмСкладе, по отменённым заказам отвечайте в «Проблемах». Остальное приложение делает само.
Как устроена главная
«Главная» — первый экран. Он отвечает на вопрос «что мне сделать сейчас?». Боковое меню приложения: «Главная», «Проблемы», «Заказы», «Товары», «Состояние обмена», «Журнал», «Что нового», «Инструкция». Настройки кабинета открываются из самого кабинета.
Блок «Следующий шаг»
Пока кабинет выключен, блок ведёт вас по порядку. У каждого шага — заголовок, пояснение и кнопка:
| Заголовок шага | Что значит | Кнопка |
|---|---|---|
| Кабинет «имя»: выберите склад заказа | Без склада заказа обмен не включается: резерв заказов Авито привязывается к этому складу. Организация и контрагент выбираются там же. | «Открыть «Компанию»» |
| Кабинет «имя»: получите объявления Авито | Объявления нужны, чтобы связать их с товарами МоегоСклада: заказ Авито создаётся по связанным объявлениям. | «Открыть объявления» |
| Кабинет «имя»: свяжите объявления с товарами МоегоСклада | «Связано 0 из N объявлений. Заказ по несвязанному объявлению не создаётся.» | «Связать объявления» |
| Кабинет «имя» готов — включите обмен | Заказы Авито создаются в МоёмСкладе, пока кабинет включён. Настройки сохранены. | «Включить кабинет» |
| Авито не принимает ключ кабинета «имя» | Обмен по этому кабинету остановлен. Замените ключ — остальные настройки сохранятся. | «Заменить ключ» |
Если шагов несколько, под блоком есть строка «Ещё N шагов».
Карточка кабинета
- Выключен: «Выключен — настройки сохранены.» и кнопка «Включить».
- Включён:
- «Заказы: …» — когда был последний заказ, сколько пришло за сутки и сколько из них создано в МоёмСкладе; пока заказов не было — «заказов пока не было»;
- «Остатки: на Авито не передаются» — это не ошибка и не сбой: так устроено приложение, см. «Чего приложение не делает»;
- «Нужно ваше действие: …» — причины, которые ждут вашего решения, со ссылкой на «Проблемы»;
- «Готовность: осталось N обязательных шагов» или «всё обязательное настроено» и кнопка «Открыть».
- Бейдж «Обмен не идёт» появляется, если обмен остановился. Причину ищите в «Проблемах» и в «Состоянии обмена».
Плашка «… заказов Авито ждут вашего ответа больше 14 дней»
Появляется по заказам, которые SkladSync отметил при включённой настройке «Снимать резерв отменённого заказа, когда вы нажмёте «Возврат принят» или «Товар у меня»». Значит: заказ отменили или вернули больше 14 дней назад, а товар по-прежнему отложен в резерве МоегоСклада и не продаётся. Откройте «Проблемы» и у каждого такого заказа нажмите «Возврат принят», когда товар вернулся, или «Товар у меня», если он не уезжал. После нажатия резерв снимется и товар снова пойдёт в продажу.
Кнопка «Открыть «Проблемы»» ведёт к записям. Кнопка «Скрыть на сутки» убирает плашку на этом устройстве; она вернётся через сутки или раньше, если таких заказов станет больше.
Если данные не загрузились, на экране написано «данные не получены — обновите страницу».
Что значат группы и кнопки в «Проблемах»
В «Проблемах» собрано всё, что требует внимания. Записи разложены по тому, кто должен действовать:
- «Нужно ваше действие» — открыта по умолчанию, выделена жёлтой рамкой. Здесь то, что может решить только вы.
- «Ждём площадку» — ответа ждём от Авито.
- «Разбирается SkladSync» — этим занимаемся мы.
- «Так и задумано» — сведения, не требующие действий.
Внутри группы записи делятся на разделы: «Заказы», «Остатки», «Цены», «Ключи и доступ», «Товары», «Другое». Если проблем нет, написано «Проблем нет».
Записи по заказам Авито
Все записи ниже относятся к группе «Нужно ваше действие». Какие записи будут у отменённого заказа, зависит от настройки «Снимать резерв отменённого заказа, когда вы нажмёте «Возврат принят» или «Товар у меня»» на вкладке «Заказы». По умолчанию она выключена.
| Что вы видите | Что значит | Что делать |
|---|---|---|
| «заказ Авито ждёт подтверждения — иначе Авито его отменит» | Заказ нужно подтвердить в Авито до срока. Запись появляется за 12 часов до срока. Если срок прошёл, текст меняется на «Срок подтверждения заказа Авито <номер> истёк <время>: …»: если заказ не подтверждён, Авито его отменит. | Откройте заказ в кабинете Авито и подтвердите его: для курьерской доставки укажите интервал, для самовывоза — данные выдачи. Кнопки у записи нет: после подтверждения или отмены она закроется сама. |
| «заказ Авито отменён или спорный — резерв и отгрузку решаете вы» | Заказ в споре или в статусе, которого нет в документации Авито. Если настройка выключена — ещё и любой отменённый или возвращаемый заказ; если включена — отменённый заказ, который SkladSync впервые увидел уже отменённым. По этой записи SkladSync не снимает резерв и не создаёт отгрузку. | Проверьте заказ в МоёмСкладе: снимите резерв или оформите отгрузку. Затем нажмите «Разобрался» (подтверждение: «Разобрались с заказом?»). Кнопку нажимает администратор. Если Авито потом сообщит о другом статусе заказа, появится новая запись. |
| «Товар у меня» (только при включённой настройке) | Авито отменил заказ, который ещё не был отправлен покупателю. Авито не сообщает, успел ли товар уехать, поэтому SkladSync держит резерв, чтобы товар не продался второй раз. | Если товар у вас на складе (или вернулся к вам), нажмите «Товар у меня» — резерв снимется, и товар снова пойдёт в продажу. |
| «Возврат принят» (только при включённой настройке) | Заказ отменили, когда он уже был в пути, доставлен, на возврате или в споре, или Авито перевёл заказ «на возврат». Товар возвращается к вам. Сигнала «возврат получен» у Авито нет, поэтому резерв держится до вашего нажатия. | Когда товар будет у вас на складе, нажмите «Возврат принят» — резерв снимется. Если товар к вам не вернётся, сначала уберите его из остатка МоегоСклада отгрузкой или списанием, затем нажмите «Возврат принят». Если товар вернулся, а отгрузка по заказу у вас есть, оформите «Возврат покупателя» на основании этой отгрузки и нажмите «Возврат принят». |
| «склад заказа Авито не выбран — резерв не привязан к складу» | Обмен уже включён, а склад заказа не выбран: после включения в списке «Склад заказа» выбрали «НЕ ЗАДАН» или там написано «ВЫБРАН НЕВЕРНО». Обмен не останавливается: заказы создаются и резервируются, но резерв не привязан ни к одному складу МоегоСклада. | Выберите склад: «Настройка» → «Компания» → «Склад заказа». Запись закроется сама. |
Если Авито не принимает ключи, на экране появляется карточка «Ключи API Авито не работают» с кнопками «Открыть Авито», «Заменить ключи» и «Проверить подключение». Порядок действий — в разделе «Ошибки подключения».
Если у вас много записей, внизу списка есть «Показать ещё N». Раздел «Исключено вами» — это товары и склады, которые вы решили не вести.
Как заказ Авито Доставки попадает в МойСклад
- Покупатель оформляет заказ на Авито с Авито Доставкой.
- Приложение читает заказ у Авито, пока кабинет включён.
- Если объявление из заказа связано с товаром МоегоСклада, в МоёмСкладе создаётся «Заказ покупателя»: со складом из «Склада заказа», с вашей организацией («по умолчанию», если вы не выбрали другую), с контрагентом (создаётся автоматически, если вы не выбрали своего) и с каналом продаж, проектом и договором, если они заданы.
- Заказ проводится и ставит резерв. Это нельзя выключить: иначе проданный на Авито товар остался бы в свободном остатке МоегоСклада и мог бы продаться ещё раз.
- Если объявление не связано, заказ по нему не создаётся. Поэтому связывайте все объявления, по которым продаёте.
- Дальше статус заказа в МоёмСкладе обновляется по статусу Авито, если включена «Передача статусов».
Что делаете вы
- подтверждаете заказ в кабинете Авито;
- отгружаете товар в МоёмСкладе — SkladSync этого не делает;
- отменённый, спорный или возвращаемый заказ проверяете в «Проблемах». Если настройка «Снимать резерв отменённого заказа, когда вы нажмёте «Возврат принят» или «Товар у меня»» выключена (так по умолчанию), резерв снимаете сами в МоёмСкладе и нажимаете «Разобрался». Если включена — нажимаете «Возврат принят» (товар вернулся) или «Товар у меня» (не уезжал), и резерв снимет SkladSync; до нажатия резерв держится.
Как статус Авито отражается в SkladSync
| Что у Авито | Что покажет SkladSync |
|---|---|
| заказ ждёт подтверждения | ожидает сборки |
| готов к отгрузке | ожидает отгрузки |
| в пути | в доставке |
| доставлен или закрыт | доставлен |
| отменён | отменён (и запись в «Проблемах») |
| на возврате | «На возврате» (и запись в «Проблемах») |
| в споре | «В споре» (и запись в «Проблемах») |
| статус, которого нет в документации Авито | «Статус не из документации Авито» (и запись в «Проблемах») |
В МоёмСкладе статус заказа ставится по этому соответствию, если включена «Передача статусов». Соответствие можно посмотреть и изменить на вкладке «Заказы» в блоке «Сопоставление статусов заказов».
Объявления и товары
Экран «Товары» показывает объявления Авито и товары МоегоСклада. У объявления Авито нет артикула, поэтому приложение не связывает их само: связи вы задаёте вручную. По этим связям создаются заказы.
Получить объявления
Нажмите «Получить объявления» (потом кнопка называется «Обновить объявления»). Читаются объявления всех статусов, в том числе истёкшие и снятые. На Авито ничего не меняется. Список товаров МоегоСклада при этом тоже обновляется.
Статусы объявлений: «активно», «истёк срок», «удалено», «заблокировано», «отклонено», «статус неизвестен». Пометка «нет в последнем списке Авито» означает, что объявление пропало из последнего полученного списка.
Вкладки
- «НЕ СОПОСТАВЛЕНО» — объявления без связи (открыта по умолчанию);
- «СОПОСТАВЛЕНО» — связанные объявления;
- «ВСЕ» — все объявления.
Связать одно объявление
- Найдите строку объявления: «№ <номер> · <статус>».
- В поле «Привязать: артикул или название…» начните вводить артикул или название товара МоегоСклада.
- Выберите нужный товар из списка.
У связанного объявления видны название товара, «артикул · код» и кнопка «Сбросить связь». Если выбранный товар уже связан с другим объявлением, вы увидите «Связь не изменилась: этот товар МоегоСклада уже связан с объявлением …».
Связать много объявлений — «Привязать списком»
На вкладке «НЕ СОПОСТАВЛЕНО» после получения объявлений есть блок «Привязать списком». Источники связей:
- «Из файла (CSV или XLSX)». Две колонки: номер объявления (или ссылка на него) и артикул, код или штрихкод товара МоегоСклада. Первая строка может быть заголовком. До 2000 строк, файл до 700 КБ.
- «Из доп. поля МоегоСклада». У товаров должно быть дополнительное поле со словом «Авито» в названии, а в нём — номер объявления (несколько номеров — через запятую). Тип поля — строка, текст или целое число.
- «По похожим названиям». Приложение подбирает товар с похожим названием для объявлений без связи. Названия совпадают не всегда, поэтому проверьте каждую строку и отметьте только верные.
- Выберите источник.
- Нажмите «Показать, что будет связано». Предпросмотр ничего не меняет.
- Проверьте статусы строк. «будет связано» — связь создастся, «заменит связь» — у объявления уже была другая связь, она заменится, «уже связано» — ничего не изменится. Строки с другими статусами («нет объявления», «товар не найден», «несколько товаров», «нельзя связать» и т. п.) проверьте вручную.
- Отметьте нужные строки или нажмите «Отметить все подходящие (N)». Лишние отметки снимает «Снять отметки».
- Нажмите «Применить отмеченные (N)».
Предпросмотр доступен всем ролям, применять связи может оператор и выше.
Готовность
«Готовность» — блок вверху «Настройки» кабинета. Он проверяет, всё ли настроено для обмена. Это проверка настроек, а не самого обмена: идёт ли обмен, видно на «Главной» и в «Состоянии обмена».
Статус кабинета: «Выключен», «Требует действия владельца» (Авито не принимает ключи), «Ошибка настройки», «Нужна настройка», «Настроен».
У каждого шага своя отметка: «настроено», «обязательно», «блокирует», «по желанию», «не поддерживается». Внизу — итог: «не закрыто обязательных шагов: N» или «обязательные шаги закрыты». У блока есть «Подробнее» (раскрывает объяснения), у некоторых шагов — «Открыть раздел».
| Шаг | Что проверяется |
|---|---|
| Ключи API площадки | Ключи сохранены. Без ключей кабинет не работает. |
| Организация | Если не выбрана, документы создаются с организацией по умолчанию. |
| Сопоставление товаров | Сколько объявлений связано: «Сопоставлено карточек: N из M». Если товары из заказов не связаны, заказы с ними не создаются. |
| Склад заказа | Склад выбран. Если не задан — «Склад заказа не задан — без него обмен не включается: резерв заказов Авито привязывается к этому складу. Выберите склад.» |
| Синхронизация заказов | Включён ли кабинет для получения заказов: «Кабинет включён для получения заказов; результат обработки проверяйте в журнале» или «Кабинет выключен — заказы не синхронизируются». |
| Проведение заказов | Подтверждено ли приложению право проводить заказы. Если да — «право проведения подтверждено МоимСкладом» или «подтвердится первым проведённым заказом». Если нет, шаг говорит, что делать: открыть карточку SkladSync в МоёмСкладе и подтвердить запрошенные права; обновить права по инструкции поддержки SkladSync (обе карточки — в разделе «Состояние обмена»); или «действий не требуется», когда право ещё не опубликовано или мы уточняем порядок у МоегоСклада. |
| Резервирование | Резервирование включено; уменьшение доступного остатка зависит от создания и проведения заказа. |
| Передача статусов | Включена ли «Передача статусов» на вкладке «Заказы». |
| Почта для уведомлений | Указан ли адрес. Без адреса ответы поддержки приходят только в чат приложения, а письма о событиях отправлять некуда. |
Есть и шаг «Уведомления и доп. поля МоегоСклада»: у него та же кнопка «Открыть раздел» с подсказкой, что сделать. Если данные не загрузились, написано «Готовность пока неизвестна: данные не загрузились. Обновите страницу.»
Вкладка «Компания»
«Настройка» → «Компания», блок «НАСТРОЙКИ ОРГАНИЗАЦИИ». Здесь вы решаете, с какими данными создаются заказы в МоёмСкладе.
| Поле | Что это | Обязательно? |
|---|---|---|
| «Организация» | Ваше юрлицо — подставляется в заказы и документы. Если пусто — «по умолчанию». | нет |
| «Контрагент» | Контрагент-покупатель (площадка). Если пусто — «авто»: создаётся автоматически. Чтобы выбрать своего, введите название в «Найти контрагента» и нажмите «Найти». | нет |
| «Канал продаж» | Подставляется в новые заказы. По умолчанию «не задан». | нет |
| «Проект» | Подставляется в новые заказы. По умолчанию «не задан». | нет |
| «Договор» | Подставляется в новые заказы. По умолчанию «не задан». | нет |
| «Склад заказа» | Склад, который проставляется в документ «Заказ покупателя». Резерв заказов Авито привязывается к этому складу. | да |
«Склад заказа» — единственное обязательное поле. Пока склад не выбран, в списке стоит «НЕ ЗАДАН (без склада заказа обмен не включается)», а обмен не включается: «Чтобы включить обмен кабинета Авито, выберите склад заказа». Если выбранный склад больше недоступен, написано «ВЫБРАН НЕВЕРНО — выберите склад заново».
Если что-то непонятно, напишите в чат — поможем настроить по шагам.
Вкладка «Заказы»
«Настройка» → «Заказы». Заказ Авито Доставки создаётся в МоёмСкладе как заказ покупателя по связанным объявлениям.
Что делаете вы
На вкладке три напоминания: подтверждаете заказ в кабинете Авито; отгружаете заказ в МоёмСкладе — SkladSync этого не делает; третье — про отменённый или возвращаемый заказ и зависит от настройки снятия резерва (ниже). Выключена — «снимаете резерв сами в МоёмСкладе и нажимаете в «Проблемах» «Разобрался»». Включена — «нажимаете в «Проблемах» «Возврат принят» (товар вернулся) или «Товар у меня» (не уезжал) — до этого резерв держится».
Переключатели
- «Передача статусов» — статус заказа МоегоСклада меняется по статусу Авито, по карте ниже. Включается и выключается.
- Снимать резерв отменённого заказа, когда вы нажмёте «Возврат принят» или «Товар у меня» — по умолчанию выключено. Если включить, отменённый или возвращаемый заказ Авито держит резерв, а в «Проблемах» появляется запись с кнопкой «Возврат принят» или «Товар у меня»; по нажатию SkladSync снимает резерв. Сам по себе резерв не снимается: Авито не сообщает, где товар после отмены. Если выключено, в «Проблемах» запись с кнопкой «Разобрался», и резерв вы снимаете сами в МоёмСкладе.
- «Резервировать товары до отгрузки» — у Авито всегда включено, переключатель заблокирован.
- «Автоматически проводить заказы в МойСклад» — у Авито всегда включено, переключатель заблокирован. Проведённый заказ учитывает резерв и уменьшает доступный остаток. Право проведения выдаёт установка приложения в МоёмСкладе.
Резерв и проведение не выключаются: SkladSync не отгружает заказы Авито, и без резерва проведённого заказа проданный товар остаётся в свободном остатке МоегоСклада и продаётся ещё раз.
Дата начала синхронизации заказов
Подпись «Дата начала синхронизации заказов:». Заказы, созданные раньше этой даты, в МойСклад не попадут. Если дата не задана, при первом включении обмена встанет момент включения, и тогда сказано: «Заказы — созданные с <точный момент>». День считается по московскому времени.
Сопоставление статусов заказов
Показывает, как статусы Авито превращаются в статусы заказа в МоёмСкладе: «используется сопоставление по умолчанию» или «настроено вручную». Кнопка «Изменить» открывает карту. Кнопка «Проверить уведомления МоегоСклада» проверяет, что МойСклад присылает приложению уведомления.
Справочник настроек
Все настройки, которые видит продавец Авито. Настройки кабинета находятся в «Настройке» на вкладках «API», «Компания» и «Заказы».
| Настройка | Где | Что делает |
|---|---|---|
| «Кабинет активен» | шапка кабинета (кнопка «Включить» на «Главной» ведёт на вкладку «API» этого кабинета) | Включает и выключает обмен по кабинету. Подробнее — «Жизненный цикл кабинета». |
| «Название кабинета» | «API» → «Переименовать» | Как кабинет называется в приложении. Видно только вам. |
| «client_id» и «client_secret» | «API» | Ключи API Авито. Секрет не показывается; чтобы заменить, нажмите «Заменить» и «Сохранить ключи». Новые ключи принимаются, только если они того же пользователя Авито. |
| «Удалить кабинет» | «API» → «Опасная зона» | Стирает товары, связки и историю заказов кабинета в SkladSync. Документы в МоёмСкладе остаются. Действие необратимо. |
| «Организация» | «Компания» | Юрлицо в заказах и документах. |
| «Контрагент» | «Компания» | Контрагент-покупатель; пусто — создаётся автоматически. |
| «Канал продаж», «Проект», «Договор» | «Компания» | Подставляются в новые заказы. |
| «Склад заказа» | «Компания» | Склад в «Заказе покупателя»; обязателен. |
| «Передача статусов» | «Заказы» | Меняет статус заказа в МоёмСкладе по статусу Авито. |
| «Резервировать товары до отгрузки» | «Заказы» | Всегда включено. |
| «Автоматически проводить заказы в МойСклад» | «Заказы» | Всегда включено. |
| «Дата начала синхронизации заказов» | «Заказы» | Заказы, созданные раньше даты, не попадут в МойСклад. |
| «Сопоставление статусов заказов» | «Заказы» | Карта «статус Авито → статус заказа в МоёмСкладе». |
Рядом с настройками есть значки ⓘ с подсказками. Часть подсказок написана для других площадок. Для кабинета Авито действует то, что написано в этой справке.
Жизненный цикл кабинета
1. Подключён, выключен
После «Подключить Авито» кабинет всегда сохраняется выключенным: «Кабинет подключён, обмен выключен». Заказы в МойСклад не создаются. Настройки доступны. Следующий шаг: на вкладке «Компания» выбрать склад, затем включить «Кабинет активен».
2. Включён
Включается переключателем «Кабинет активен» (кнопка «Включить» на «Главной» открывает вкладку «API» кабинета, где этот переключатель). При первом включении приложение спрашивает подтверждение и показывает незакрытые обязательные шаги. После включения вы увидите время включения (МСК). Приложение начинает читать заказы Авито и создавать их в МоёмСкладе по связанным объявлениям. Заказы, созданные раньше «Даты начала синхронизации заказов», в МойСклад не попадают; если дата не была задана, границей станет момент первого включения.
Если при включении приложение пишет, что другая система создаёт заказы, и просит подтвердить, значит, оно нашло признаки этого. Включайте, только если другая система действительно отключена: иначе заказы задвоятся.
3. Выключен вами
Переключатель «Кабинет активен» при выключении спрашивает: «Выключить кабинет «имя»?» Обмен по кабинету остановится: заказы не будут передаваться, пока вы не включите кабинет снова. Настройки и история сохранятся. Пока кабинет выключен, действия, которым нужен обмен, недоступны — об этом подскажет «Кабинет выключен — включите его переключателем «Кабинет активен», чтобы выполнить это действие».
Документы «Заказ покупателя», уже созданные в МоёмСкладе, остаются там: SkladSync по заказам Авито ничего не отгружает и сам не удаляет. Перед повторным включением проверьте «Дату начала синхронизации заказов» на вкладке «Заказы»: заказы, созданные раньше этой даты, в МойСклад не попадут.
4. Обмен остановлен из-за ключей
Если Авито перестал принимать ключи, обмен по этому кабинету останавливается, кабинет получает статус «Требует действия владельца». Замените ключи на вкладке «API» и нажмите «Проверить подключение»: обмен возобновится сам. Настройки кабинета сохраняются. См. «Ошибки подключения».
5. Приложение приостановлено в МоёмСкладе
Если МойСклад приостанавливает приложение, обмен с Авито останавливается. Настройки, связи объявлений с товарами и история сохраняются, и после возобновления работы приложения всё продолжает работать без повторной настройки. Условия — на странице приложения в каталоге МоегоСклада.
6. Кабинет удалён
«Удалить кабинет» стирает товары, связки и историю заказов кабинета в SkladSync. Документы, уже созданные в МоёмСкладе, остаются. Действие необратимо.
Ошибки подключения
Эти тексты вы можете увидеть в форме подключения, на вкладке «API», в «Проблемах» и на «Главной». Слова в первой колонке взяты из приложения; длинные сообщения сокращены многоточием.
| Что вы видите | Что это значит | Что делать |
|---|---|---|
| «Авито не принял ключи API: client_id или client_secret неверны, скопированы не полностью или эта пара ключей удалена в кабинете. …Записи не выполнялись.» | Авито отклонил пару ключей. Ничего не записано. | Проверьте ключи в Авито («Для профессионалов» → «API»). Скопируйте заново целиком. Если пара удалена, получите новую и вставьте её. |
| Карточка «Ключи API Авито не работают» | Авито не выдаёт доступ по сохранённым ключам: они неверны или пара удалена. Обмен с этим кабинетом остановлен. | Нажмите «Открыть Авито», получите новые ключи, нажмите «Заменить ключи», затем «Проверить подключение». После успеха: «Подключение к Авито восстановлено. Синхронизация продолжена.» Если Авито снова отказал: «Авито снова не принял ключи …» — убедитесь, что ключи скопированы полностью и относятся к этому аккаунту Авито, и повторите. |
| «Авито закрыл ключам доступ к методу. …» | Работа по API у Авито возможна только при действующей платной услуге. Текст ошибки называет, какие услуги подходят. | Проверьте услугу в аккаунте Авито, чьи ключи сохранены в кабинете. |
| «Авито закрыл доступ к заказам: API заказов работает только с «Авито Доставкой для бизнеса» …» | Заказы Авито по API доступны только с этой услугой. | Подключите «Авито Доставку для бизнеса» (реквизиты компании) в Авито и повторите проверку. |
| «Авито отклонил временный ключ доступа — получим новый и повторим автоматически.» | Временный ключ (он живёт сутки) устарел. | Ничего: приложение получит новый и повторит само. |
| «Авито дважды отклонил ключ доступа, выданный по этим ключам. Ключи не объявлены неверными — повторите проверку через несколько минут.» | Ключи не признаны неверными, но доступ не подтвердился. | Повторите проверку через несколько минут. |
| «Авито временно недоступен — сбой на стороне площадки, повторим автоматически»; при проверке — «…ключи не отклонены, повторите проверку через пару минут.» | Сбой на стороне Авито. | Подождите. Рабочий обмен повторится сам, проверку повторите через пару минут. |
| «Авито ограничивает частоту запросов — повторим автоматически» | Авито ограничил число запросов. | Ничего. |
| «Авито не ответил (сеть или таймаут) — ключи не отклонены, повторите проверку через пару минут.» | Ответа от Авито не было. | Повторите проверку через пару минут. |
| «Авито прислал ответ, который не удалось разобрать …» | Ответ Авито не распознан, доступ не подтверждён. Ключи не объявлены неверными. | Повторите проверку позже. |
| «…доступ не подтверждён. Ключи не объявлены неверными; повторите проверку позже или напишите в поддержку.» | Авито ответил отказом, причина неясна. | Повторите позже; если повторяется — напишите в чат. |
| «Авито не нашёл метод или объявление — запрос не выполнен» или «Авито отклонил запрос как некорректный …» | Запрос к Авито не выполнен. | Повторите. Если повторяется — напишите в чат и приложите текст ошибки. |
| «Эти ключи принадлежат другому пользователю Авито — для него подключите отдельный кабинет. Ключи не сохранены.» | Вы заменяете ключи кабинета ключами другого пользователя Авито. | Для другого пользователя подключите отдельный кабинет. Прежние ключи остаются. |
| «Идёт синхронизация. Настройка не сохранена — повторите после завершения» | Кабинет занят. | Повторите чуть позже. |
| «Ключи кабинета заменили, пока шла проверка …» | Итог проверки относится к прежним ключам. | Нажмите «Проверить подключение» ещё раз. |
| «Кабинет занят другой операцией. Повторите проверку вручную.» | Одновременно идёт другая операция. | Повторите проверку. |
| «ключи Авито не прошли проверку аккаунта — повторите подключение» | Подключение прервалось на проверке аккаунта. | Повторите «Подключить Авито». |
| «Чтобы включить обмен кабинета Авито, выберите склад заказа: «Настройка → Компания» → «Склад заказа» …» | Без склада заказа обмен не включается. | Выберите склад заказа. |
| «У кабинета Авито резерв и проведение заказов не выключаются …» | Переключатели заблокированы намеренно. | Ничего: так защищён остаток. |
| «У приложения нет права проведения …» | МойСклад не подтвердил приложению право проводить заказы. | Если в сообщении сказано открыть карточку SkladSync — откройте её в МоёмСкладе и подтвердите запрошенные права; если сказано «по инструкции поддержки» или «действий не требуется» — следуйте сообщению. |
В сообщениях о сбое на стороне Авито в конце может быть служебная приписка: номер ответа Авито и путь. Её полезно приложить, если пишете в поддержку.
Чего приложение не делает
- Остатки и цены на Авито приложение не передаёт — только заказы. Поэтому на «Главной» стоит «Остатки: на Авито не передаются», а при проверке ключей остатки не проверяются.
- Не подтверждает заказы в Авито. Подтверждаете вы: приложение лишь напоминает в «Проблемах».
- Не отгружает заказы Авито и не создаёт отгрузку. Это делаете вы в МоёмСкладе.
- Не связывает объявления с товарами само. У объявления нет артикула: вы связываете вручную или списком.
- Не создаёт заказы, оформленные до даты начала синхронизации, и заказы по несвязанным объявлениям.
Частые вопросы
Что такое client_id и client_secret?
Это пара ключей API — «логин и пароль» для программы. Их выдаёт Авито. Подробнее — «Как получить API-ключи».
После «Подключить Авито» кабинет «выключен». Это ошибка?
Нет. Все кабинеты сначала сохраняются выключенными. Выбранные ключи проверены, но обмен не идёт, пока вы сами не включите «Кабинет активен». Что сделать до этого — в разделе «Первая настройка».
Зачем нужен «Склад заказа»?
Резерв заказа в МоёмСкладе должен быть привязан к какому-то складу. Без него обмен не включается.
Придут ли в МойСклад заказы, оформленные до подключения?
Зависит от «Даты начала синхронизации заказов»: заказы, созданные раньше этой даты, в МойСклад не попадут, а созданные позже — попадут, даже если оформлены до включения. Если дата не задана, при первом включении встанет момент включения. Чтобы старые заказы не пришли, проверьте дату до включения.
Заказ на Авито есть, а в МоёмСкладе его нет. Почему?
- Кабинет включён? Выключенный кабинет заказы не передаёт.
- Объявление из заказа связано с товаром? Заказ по несвязанному объявлению не создаётся.
- Заказ создан после «Даты начала синхронизации заказов»?
- Это заказ Авито Доставки? Приложение получает заказы только с «Авито Доставкой для бизнеса».
- Нет ли ошибки на «Главной» и в «Проблемах»? Проверьте «Готовность».
Если ничего не нашли, напишите в чат.
Нужно ли подтверждать заказ в SkladSync?
Нет. Заказ подтверждается в кабинете Авито до срока. Если срок подходит, в «Проблемах» появится напоминание.
Можно ли выключить резерв или проведение заказов?
Нет. Эти переключатели у Авито всегда включены: иначе проданный товар оставался бы в свободном остатке.
Остатки не уходят на Авито. Что-то сломалось?
Нет. Приложение передаёт в МойСклад только заказы. См. «Чего приложение не делает».
Я заменил ключи — настройки пропадут?
Нет. Настройки кабинета сохранятся. Новые ключи принимаются, только если они того же пользователя Авито.
Можно ли подключить второй кабинет Авито?
Да, для другого пользователя Авито. Для него нужны свои ключи. Ту же пару ключей, что уже подключена, повторно принять нельзя.
Что будет, если удалить кабинет?
Приложение сотрёт товары, связки и историю заказов кабинета у себя. Документы в МоёмСкладе останутся. Действие необратимо.
Поддержка
Проще всего написать в чат приложения: поможем настроить кабинет по шагам, перепиской, без звонков. Можно написать и на support@skladsync.ru. В письме укажите название кабинета, время и текст ошибки.
Не отправляйте в чат и письма секрет «client_secret».