Mercado Libre: подключение своего приложения продавца

Mercado Libre подключается через ваше собственное приложение в кабинете разработчика (DevCenter). Мы не посредник: вы создаёте приложение, получаете App ID и Secret Key, вставляете их к нам и разрешаете доступ к своему магазину на странице Mercado Libre. Настройка занимает 10–15 минут один раз. Подключение в статусе «Бета».

Шаг 1. Создайте приложение в DevCenter

1. Откройте DevCenter своей страны (например, developers.mercadolivre.com.br для Бразилии) и войдите основной учётной записью продавца — не учётной записью оператора или сотрудника.
2. Нажмите Criar aplicação («Создать приложение») и заполните:
   • название (до 50 символов);
   • краткое и подробное описание;
   • логотип в формате PNG.
3. В поле Redirect URI вставьте наш адрес возврата. Его показывает форма подключения («Настройки → Маркетплейсы → Подключить → Mercado Libre») с кнопкой «Копировать». Вставьте точно как есть: Mercado Libre требует точного совпадения, любая лишняя буква или пробел — и авторизация не пройдёт.
4. Права (scopes): read, write, offline_access. Последний нужен, чтобы токен продлевался сам.
5. Темы уведомлений (notifications) указывать не обязательно.
6. PKCE можно включить — мы его поддерживаем.
7. Сохраните приложение и скопируйте App ID и Secret Key.

Шаг 2. Вставьте ключи и авторизуйте магазин

1. В форме подключения вставьте App ID и Secret Key.
2. Выберите страну магазина — валюта подставится сама (BR — BRL, MX — MXN и так далее).
3. Нажмите Авторизовать в Mercado Libre. Откроется страница Mercado Libre: разрешите доступ приложению.
4. Вы вернётесь в кабинет, и подключение появится в списке.

Токен продлевается автоматически: доступ действует 6 часов, обновление — 6 месяцев. Если вы сменили Secret Key или отозвали доступ приложению, нажмите Авторизовать заново на карточке подключения.

Что работает

• Заказы: статусы и валюта вашего магазина попадают на канбан.
• «Собрать»: для Mercado Envíos загружается этикетка в PDF; для своей доставки трек-номер уходит в Mercado Libre.
• Остатки и цены объявлений: привяжите объявление (или вариацию) к изделию склада.
• Финансы: комиссия и доставка по каждому заказу попадают в финансовый отчёт.

Данные покупателей (ФИО, адрес) мы не храним.

Чего нет

• Отмена заказа продавцом — делайте её в кабинете Mercado Libre.
• Продавцы с распределённым складом (несколько складов).
• Публикация карточек товаров.

Если что-то не так

• Страница Mercado Libre пишет про несовпадение redirect_uri — адрес в приложении не совпадает с адресом из нашей формы; вставьте заново, точно как есть.
• После возврата видна ошибка «Авторизация не удалась» — прочитайте текст рядом с ней; чаще всего ключи введены с ошибкой или вы вошли не основной учётной записью продавца.
• Подключение в статусе «Ошибка» — нажмите «Авторизовать заново».