Интеграция с Золотым Яблоком: API и автоматизация остатков и цен

Коротко: публичного API для продавцов у Золотого Яблока нет, готовых интеграций с сервисами управления маркетплейсами тоже. Автоматизировать можно два контура — документооборот по EDI и массовую загрузку каталога файлами. Остатки и цены обновляются вручную, поэтому их источником истины должна быть ваша учётная система.

Запрос «золотое яблоко api» почти всегда означает одно и то же. Продавец уже торгует на Wildberries и Ozon через сервис или собственный коннектор, собирается добавить новую площадку и хочет подключить её тем же способом. С Золотым Яблоком так не выйдет, и лучше узнать это до того, как интеграция попадёт в план работ.

Ниже — что площадка описывает публично, что придётся делать файлами, сколько стоит вход в электронный документооборот и какие восемь вопросов задать менеджеру, чтобы не строить догадки.

Публичной документации по API для продавцов нет

Портал для партнёров seller.goldapple.ru описывает работу четырьмя шагами: заявка, регистрация с документами и принятием оферты, создание товаров, первая поставка на склад. Третий шаг сформулирован дословно так: «ознакомьтесь с инструкциями и гайдами, загрузите сертификаты и создайте первые товары». Сами гайды лежат в личном кабинете — страница seller.goldapple.ru/instructions без авторизации отдаёт пустой документ.

В официальном разделе частых вопросов площадка отвечает про документы, тарифы, продвижение, минимальные объёмы, офлайн, логистику и самозанятых. Слова «API» там нет ни разу. Тарифы площадка тоже не публикует: «зависят от категории и условий сотрудничества, детали обсудим после заявки». Логика одна для всего — коммерческая и техническая часть раскрываются после того, как вас взяли.

Отдельно про находку, которая всплывает в поиске по этому запросу. У витрины goldapple.ru есть внутренний адрес вида goldapple.ru/front/api/…, через который сайт получает данные карточки товара. Это API магазина, а не кабинета продавца: он отдаёт ровно то, что видит покупатель, записать в него ничего нельзя, а внешние запросы площадка блокирует. Строить на нём обмен остатками нельзя, и обсуждать его с менеджером бесполезно.

Два контура, которые постоянно путают

У Золотого Яблока два разных сценария для бизнеса — розничная поставка в сеть и продажи на витрине по комиссионной модели. Автоматизация в них устроена по-разному, и половина путаницы в статьях про интеграцию идёт именно отсюда.

Разница принципиальная: первый контур описан публично и стандартизован, второй — нет. Контур не выбирают: его задаёт схема сотрудничества. Об этом есть разбор двух входов на площадку и статья про модели работы.

EDI: единственный формально описанный канал

Электронный документооборот — условие входа. На портале для партнёров он стоит четвёртым пунктом требований, рядом с юрлицом, товарным знаком и документами качества.

Операторы описывают обмен так. Сеть отправляет ORDERS — заказ на поставку. Поставщик отвечает ORDRSP и уточняет фактурную часть и время поставки. В момент отгрузки уходит DESADV, после приёмки сеть присылает RECADV. Юридически значимая часть — УПД с функциями СЧФДОП и ДОП (второй вариант для неплательщиков НДС) и корректировочный УКД.

Здесь первое расхождение. Контур и Ediweb перечисляют четыре EDI-сообщения, Saby и партнёрские страницы СБИС — три, без RECADV. Значит, набор согласуется индивидуально, и опираться нужно на договор с сетью, а не на страницу оператора.

Второе расхождение — контрагент. Контур указывает ООО «Екатеринбург Яблоко», ИНН 6670381056; Ediweb на своей странице — ООО «Ритейл Консалтинг Компани». В правилах продажи товаров на самом goldapple.ru продавцом названо ООО «Екатеринбург Яблоко». Уточняйте юрлицо до настройки обмена: от него зависит, на чей GLN вы настраиваете маршрутизацию.

Насколько буквально стоит читать страницы операторов, показывает мелочь: на партнёрской странице СБИС о Золотом Яблоке первый абзац рассказывает про «ВсеИнструменты.ру» — шаблон не поправили при копировании.

Деньги на входе. Это прайс операторов, а не площадки, и он у всех разный.

• GLN: 4 000 ₽ на год или 9 000 ₽ на три года.
• Пакет на 1 000 документов у партнёра «Тензора»: 5 000 ₽ в год без акции, по акции вдвое дешевле.
• Расширение «Маркировка», без которого не передать коды по маркированным товарам: от 4 000 ₽ в год.
• Настройка обмена под требования сети с обучением: 5 000 ₽ разово.

Для расчёта возьмите свой ожидаемый объём документов: тарифы у операторов пакетные, а не помесячные.

Кабинет: массовая загрузка вместо обмена

На витрине массовая работа с каталогом устроена через файлы. PIM-система MarketProvider описывает свою интеграцию с площадкой так: сервис конвертирует карточки товаров в спецификацию Золотого Яблока, а фотографии продавец отправляет отдельным архивом. Иначе говоря, это таблица плюс zip, а не обмен по расписанию. Что именно должно быть внутри карточки, разобрано в статье про контент и модерацию.

Цены и остатки в такой схеме живут отдельной жизнью. Это и есть главный операционный риск площадки: канал, который обновляется руками, всегда отстаёт от остальных. Один пропущенный день — и вы либо продаёте то, чего нет на складе, либо держите товар в резерве под канал, который его не заказывает.

Что делать, пока обмена нет

Правило одно: источник истины по остаткам и себестоимости — учётная система, а не кабинет площадки. Дальше это разворачивается в пять решений.

• Завести Золотое Яблоко отдельным каналом и отдельным складом в учёте, а не строкой в общей таблице. Иначе канал не отделить в отчётах.
• Резервировать под него физический остаток, а не выгружать весь доступный. Ручное обновление не успевает за скоростью продаж на других площадках.
• Назначить частоту обновления и ответственного. Ежедневно в одно и то же время работает лучше, чем «по мере необходимости».
• Заводить удержания площадки как расходы канала. Ставок в открытом доступе нет: они появятся в отчётах после первых продаж. Подробнее об этом — в разборе комиссии и юнит-экономики.
• Держать сроки и правила обмена в одном документе. У площадки нет публичного регламента, поэтому ваш внутренний регламент — единственный.

Восемь вопросов менеджеру до старта

1. Документация по обмену данными: выдаётся ли она после подписания оферты и в каком виде.
2. В каком формате принимается спецификация товаров и архив фотографий, есть ли ограничение на размер партии.
3. Как передаются остатки и с какой периодичностью площадка их перечитывает.
4. Кто меняет цену на витрине и как продавец узнаёт об изменении.
5. Какой набор EDI-сообщений включён именно в ваш договор.
6. С каким юрлицом заключается договор и на чей GLN настраивать маршрутизацию.
7. Как передаются коды маркировки и нужно ли расширение оператора.
8. В каком виде выгружается отчёт о продажах и удержаниях — это основа вашего отчёта о прибыли.

Цифры из чужих статей, которые не подтверждаются

По этому запросу выдача устроена так, что обзоры площадки и рекламные страницы сервисов перемешаны. В результате возможности сервисов приписываются площадке. Вот что стоит перепроверять.

Учёт, который работает и без интеграции

Готовой интеграции с Золотым Яблоком в SelSup нет — как и у других сервисов. Но задача, ради которой обычно ищут API, решается и без него: увидеть прибыль по каждому товару, когда каналов несколько и один из них ведётся руками.

Заведите Золотое Яблоко отдельным каналом: себестоимость и складской остаток возьмите из общей номенклатуры, удержания и логистику — из отчётов площадки. Результат встанет в общий отчёт о прибыли рядом с Wildberries, Ozon и Яндекс Маркетом. Схема та же, что при работе с несколькими магазинами и юрлицами; если вы ведёте учёт в 1С, помогает разбор того, как устроена интеграция 1С с маркетплейсами. Общий контекст площадки — в обзоре Золотого Яблока для селлеров.

Если хотите посмотреть, как это выглядит на ваших данных, запишитесь на демонстрацию SelSup: покажем, как свести несколько каналов в один отчёт о прибыли и что делать с каналом, по которому нет автоматического обмена.

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

Есть ли у Золотого Яблока API для продавцов?

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

Можно ли использовать API сайта goldapple.ru?

Нет. Внутренний адрес витрины отдаёт данные карточки для покупателя, записывать в него ничего нельзя, а внешние запросы блокируются. К кабинету продавца он отношения не имеет.

Обязателен ли ЭДО для работы с площадкой?

Да. Подключение к электронному документообороту стоит среди четырёх условий партнёрства на портале seller.goldapple.ru наравне с юрлицом, товарным знаком и документами качества.

Какие EDI-сообщения использует сеть?

Операторы называют ORDERS, ORDRSP, DESADV и RECADV плюс УПД и УКД, но часть из них перечисляет только три сообщения без RECADV. Точный набор фиксируется в договоре с сетью, поэтому сверяйтесь с ним, а не со страницей оператора.

Сколько стоит подключение к EDI?

Расходы складываются из GLN (4 000 ₽ на год или 9 000 ₽ на три года), пакета документов у оператора (порядка 5 000 ₽ в год за 1 000 документов) и расширения для маркировки от 4 000 ₽ в год. Настройка обмена под требования сети у части операторов стоит 5 000 ₽ разово. Это цены операторов, площадка за подключение денег не берёт.

Как обновлять остатки и цены, пока нет обмена?

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