Marketplace stores

Завести магазин Ламоды

Создаёт магазин Ламоды по паре lamoda_client_id и lamoda_client_secret. Ключ сначала проверяется у Ламоды (не принят — 422 marketplace.store_key_rejected, Ламода не ответила — 503 marketplace.store_key_unchecked). Магазин хранится только в кабинете — сборщику не передаётся, external_id назначает кабинет (отрицательный). Секрет шифруется и в ответ не попадает; тот же client_id второй раз не заводится.

post/api/v1/marketplace/lamoda/stores

Request

  • Base URL: https://erp.akeda.ru
  • URL: https://erp.akeda.ru/api/v1/marketplace/lamoda/stores
  • Auth: one of:
    • HTTP bearer
    • API key in header X-Api-Key
    • OAuth 2 (authorization code, authorization URL https://erp.akeda.ru/oauth2/authorize, token URL https://erp.akeda.ru/oauth2/token, scopes: akeda:delegate)
    • HTTP bearer

Headers

X-Tenantstring required

Slug выбранного кабинета; кабинет не является юрлицом

Idempotency-Keystring required

Стабильный ключ одной попытки создания; повтор с тем же ключом обращается к тому же магазину.

Request body

namestring required
tax_source'policy' | 'store'

Источник налога магазина: policy — из учётной политики юрлица магазина (tax_percent не нужен и не сохраняется), store — ставка tax_percent вручную. Без поля: store, если передан tax_percent (прежний контракт), иначе policy. Иное значение — 400 marketplace.store_tax_source_invalid

tax_percentstring

Ручная ставка налога в процентах при источнике store; пустая строка сохраняется как ноль

is_activeboolean
has_fbsboolean
has_jamboolean

Используется для Wildberries

article_size_separator'' | '-' | '/' | '_'

Правило именования артикула Ozon: «БАЗА<разделитель>РАЗМЕР». Список закрыт; пустая строка означает «правила нет». Официальные поля размера площадки всегда старше этого правила

ozon_client_idstring
ozon_api_keystring
ozon_pf_client_idstring
ozon_pf_client_secretstring
wb_tokenstring

Рекомендуется персональный токен класса personal; значение не возвращается

ym_business_idstring

Необязателен: без него кабинет берёт Business ID из магазинов, видных ключу. Строкой; ERP проверяет числовой идентификатор и преобразует его для MPTrack

ym_api_keystring
lamoda_client_idstring

client_id Ламоды; он же отпечаток аккаунта — второй магазин с тем же client_id не заводится

lamoda_client_secretstring
proxystring

Необязательный адрес proxy; значение не возвращается

business_idstring uuid

Response

Сохранённый магазин

idstring uuid required
platform'ozon' | 'wildberries' | 'yandex' | 'lamoda' required

Платформа задаётся маршрутом, а не телом запроса

namestring required
external_idinteger

Внутренний идентификатор MPTrack; назначается после передачи настройки и не вводится пользователем. У магазина Ламоды (сборщик её не грузит) номер назначает кабинет — он отрицательный и не меньше −2^53

tax_percentstring required

Процент налога с того, что заплатил покупатель, на сегодня — им считают ОПиУ, декомпозиция, воронка и цены; decimal строкой. При источнике policy выводится из учётной политики юрлица магазина, при store — ручная ставка магазина

tax_source'policy' | 'store' required

Источник налога на сегодня: policy — система налогообложения юрлица магазина из учётной политики, store — ставка, заданная в магазине вручную (переопределение)

is_activeboolean required
has_fbsboolean required

Для подключения включена загрузка схемы FBS

has_jamboolean required

Для подключения Wildberries включена аналитика «Джем»

credentials_configuredboolean required

Есть хотя бы один сохранённый API-реквизит

ozon_client_id_setboolean required
ozon_api_key_setboolean required
ozon_pf_client_id_setboolean required
ozon_pf_client_secret_setboolean required
wb_token_setboolean required
ym_business_id_setboolean required
ym_api_key_setboolean required
lamoda_client_id_setboolean required
lamoda_client_secret_setboolean required
proxy_setboolean required
config_sync_status'not_configured' | 'synced' | 'error' required

Состояние передачи настройки в MPTrack

config_synced_atstring date-time
collector_local_onlyboolean

Стенд не боевой: магазин у сборщика общий с боевым стендом, поэтому выключение и удаление меняют только этот кабинет, а загрузки у сборщика продолжаются

credentials_withheldboolean

Реквизиты магазина сняты при копии кабинета с другого стенда: шифроблоб не переносится, на этом стенде реквизиты не заданы. Номер магазина у сборщика сохранён; признак уходит, когда ключ введут здесь заново

token_class'basic' | 'personal' | 'test' | 'service' | 'unknown'

Безопасная классификация токена Wildberries без раскрытия токена: basic — ограниченный базовый, personal — персональный, test — тестовый, service — сервисный, unknown — тип не определён

connection_status'not_checked' | 'pending' | 'disabled' | 'ok' | 'warning' | 'error' required

Безопасное состояние подключения в ERP: not_checked — проверка ещё не запускалась, pending — MPTrack проверяет реквизиты или запускает первую загрузку, disabled — загрузки отключены, ok — подключение работает, warning — требуется внимание, error — подключение не работает. Сырые статусы и тексты MPTrack не публикуются

connection_error_codestring

Безопасный стабильный код состояния подключения; сырой текст ошибки не публикуется

last_etl_atstring date-time

Момент последней успешной загрузки этого подключения

initial_load_ready_atstring date-time nullable

Когда первичная загрузка магазина подтвердилась журналом сборщика. null — карточки, остатки или заказы ещё не загружены, и решения разбора и ввод начального остатка закрыты; подробности — marketplaceGetStoreInitialLoad

article_size_separator'' | '-' | '/' | '_'

Разделитель базы и размера в артикуле продавца, объявленный владельцем магазина. Пустая строка — правило не объявлено, и размер берётся только из полей площадки. Применяется на Ozon, где каждый размер продаётся своим артикулом

catalog_auto_createboolean nullable

Новые карточки площадки без единого совпадения загрузка каталога заводит товарами сама (true) или оставляет новыми до решения человека (false). null — решение ещё не принято: первая загрузка включит автосоздание только в кабинете без активных товаров и запишет решение. Применяется к Ozon и Wildberries

business_idstring uuid

Changes

No recorded changes to this operation across all 1 revision of this API.