Пользовательская инструкция для оформления заказа с помощью api/v3

Введение

В инструкции описан процесс запроса остатков по товарам, оформление заказа и создание резерва товаров с помощью api/v3.

API предоставляет возможность быстрой и безошибочной передачи данных о заказах непосредственно в систему компании, что существенно ускоряет их обработку и дальнейшую отправку товаров клиентам.

Основные понятия

  • Заявка - упрощенная форма заказа, которая резервирует товары на складе Сима-ленд. Содержит контактные данные и перечень товаров. Имеет свои статусы.
  • Общий заказ - заказ в компанию Сима-ленд, состоящий из набора заявок. Оформлять общий заказ нужно в момент, когда сформирован окончательный список заявок, которые вы хотите оформить и выкупить.
  • Закупка - сущность, содержащая в себе набор заявок. Рекомендуется использовать 1 закупку для каждой отгрузки товаров со склада Сима-ленд. Например, вы отгружаете заказы в понедельник и четверг. Соответственно, в определенное время в эти дни вы должны сформировать общий заказ и после этого закрыть закупку и открыть новую. Одновременно может быть открыта только 1 закупка.

Положение о работе с API

Предупреждения:

  • Вся получаемая информация через API должна проходить предварительную модерацию перед публичной демонстрацией на соответствие законодательству, принятому в вашем регионе.
  • Все данные, получаемые через API, носят сугубо информационный характер и не являются исчерпывающими. Для более подробной информации следует обращаться к менеджерам компании по указанным на сайте телефонам. Вся представленная в API информация, касающаяся комплектации, технических характеристик, цветовых сочетаний, а также стоимости продукции носит информационный характер и ни при каких условиях не является публичной офертой, определяемой положениями пункта 2 статьи 437 Гражданского Кодекса Российской Федерации. Указанные цены являются рекомендованными и могут отличаться от действительных цен.
  • Компания ООО «Сима-ленд» оставляет за собой право в одностороннем порядке устанавливать лимиты (ограничение) на количество запросов к API, вплоть до полного запрета доступа к ресурсам.

Запрет на использование:

  • Недопустимо использование предоставленных компанией информационных материалов в целях, не предназначенных для демонстрации конечному потребителю.
  • Запрещены любые попытки продажи предоставленных информационных материалов.
  • Запрещено использование информационных материалов для разработки собственной продукции.
  • Логотип, название, дизайн сайта, фотографии, баннеры, макеты продукции, видеоматериалы, разработанные Компанией, являются объектами авторского права в соответствии с действующим российским законодательством (ГК РФ ч.4 ст.1515), принадлежат Компании, права по ним не передаются Клиенту.
  • Предоставленные Клиенту информационные материалы должны использоваться таким образом, чтобы исключить любое копирование товарных знаков, макетов продукции, логотипов и/или сходных с ним изображений, дизайн сайта www.sima-land.ru, названия и/или сходного с ним названия сайтов, а также сходного с ним оформления.

Шаг 1. Регистрация

Окно формы регистрации

Для регистрации необходимо заполнить все поля в форме.

Если вы являетесь юр.лицом, то при необходимо поставить "галочку" в поле "Покупаю для бизнеса". После постановки галочки отобразятся два дополнительных поля обязательных для заполнения.

Регистрация организатора

Если вы планируете оформлять более одного заказа в день, то рекомендуем воспользоваться сервисом резервирования заказов. Сервис позволяет управлять заявками и объединять их в общий заказ.

Для пользования сервисом необходимо зарегистрироваться, как организатор по ссылке: https://goo.gl/mC6hgP

В открывшейся анкете укажите:

  • В наименовании “Интернет магазин НАЗВАНИЕ_МАГАЗИНА”. Остальные данные можно не заполнять.
  • В разделе “Пункт выдачи” заполните любой ваш адрес. Он не будет использоваться в будущем.
  • Установите минимальную сумму заявки - 0
  • Выберите любые способы оплаты, это ни на что не повлияет.

После отправки анкеты на модерацию она будет рассмотрена в течение 3 рабочих дней, в порядке очереди. Ответ поступит на указанную почту.

Шаг 2. Авторизация

Доступ к API предоставляется только с помощью API-Key. Для получения ключа необходимо быть зарегистрированным пользователем сайта Sima-Land (Шаг 1):

img.png

Рис.2: Создание API-Key

1. Перейти по адресу: https://www.sima-land.ru/cabinet/token/. Ввести произвольное название для ключа и нажать на кнопку "Создать ключ".

img_1.png

Рис.3: Копирование сгенерированного API-Key

2. Ключ копируется только нажатием на иконку (Рис.3).

Важно! После обновления страницы скопировать ключи не получится. Токен действителен 1 год с даты создания.

3. Ключ необходимо вписать в header запроса: ключ - x-api-key, значение - <полученный токен>.

Шаг 3. Оформление заказа

Оформление заказа юр.лица

Для создания заказа без использования корзины используется запрос POST https://www.sima-land.ru/api/v3/order/checkout-by-products/.

Шаблон для тела запроса:

{
  "items_data": [ // Список товаров
    {
      "item_sid": , // Артикул товара
      "qty":  // Количество товара
    },
    {
      "item_sid": , // Артикул товара
      "qty":  // Количество товара
    }
  ],
  "paymentTypeId": 0, // Тип оплаты (0 - по счету, 4 - согласовать с менеджером)
  "comment": "", // Комментарий к заказу
  "contact_name": "ФИО", // Имя пользователя
  "contact_email": "e-mail", // Адрес жлектронной почты
  "contact_phone": "номер телефона", // Номер телефона
  "person_type": 2, // Тип пользователя (1 - физ. лицо; 2 - юр. лицо; 3 - ИП)
  "counterparty_id": 1001706702, // Идентификатор контрагента
  "manager_action": 1, // Действие менеджера (1 - не указано, 2 - звонок не требуется, 3 - позвонить сейчас)
  "deliveryTypeId": 28, // Согласовать с менеджером
  "settlement_id": 27503892 // id поселения
}

Для оформления заказа с помощью API доступы только:

  • Способ доставки - deliveryTypeId: 28 (Согласовать с менеджером).
  • Способы оплаты - paymentTypeId: 0 (по счету), 4 (согласовать с менеджером).

Получение counterparty_id описано в разделе "Запрос данных юр.лица".

Получение settlement_id описано в разделе "Поселение".

Резервирование заказов

Шаги по оформлению резерва

Алгоритм работы выглядит следующим образом:

  1. Создаете закупку;
  2. Создаете заявки в рамках закупки под каждого конечного покупателя;
  3. Выбираете все активные заявки для их оформления в общий заказ;
  4. Оформляете общий заказ;
  5. Закрываете закупки.

Указанный алгоритм нужно повторять после каждого оформления заказа на отгрузку.

1. Создание закупки

Чтобы создать новую закупку, для оформления общего заказа, используется POST https://www.sima-land.ru/api/v3/jp-purchase/.

Шаблон тела запроса:

{
  "ended_at": "2023-01-01", // Дата окончания закупки
  "user_id": "123456", // Идентификатор пользователя
  "jp_status_id": 1 // Статус закупки (1 - открыта, 2 - закрыта)
}

Получение идентификатора пользователя описано в разделе Запрос данных пользователя.

Пример тела ответа:

{
  "ended_at": "2023-01-01 15:00:00+0500",
  "user_id": 123456,
  "jp_status_id": 1,
  "created_at": "2022-12-14T17:20:42+05:00",
  "updated_at": "2022-12-14T17:20:42+05:00",
  "id": 361769, // Идентификатор закупки
  "request_count_all": 0,
  "request_count_new": 0,
  "request_count_approved": 0,
  "request_count_declined": 0,
  "jp_purchase_selected_subtotal": 0,
  "jp_purchase_selected_markup": 0,
  "jp_purchase_selected_delivery_sum": 0,
  "jp_purchase_selected_orders": [],
  "is_pending_request": false
}

2. Создание заявки

Описание

Для создания заявки используется запрос POST https://www.sima-land.ru/api/v3/order/checkout-jp-request-by-products/

Пример тела запроса:

{
  "items_data": [
      {
          "item_sid": 769795, // Артикул товара
          "qty": 1 // Количество товара
      },
      {
          "item_sid": 2898745,
          "qty": 1
      }
  ],
  "contact_phone": "79999999999", // Ваш телефон
  "contact_name": "Собственный заказ", // Наименование
  "contact_email": "my-email@mail.ru", // Ваш служебный email
  "jp_purchase_id": 361769, // Идентификатор закупки
  "settlement_id": 1686293227 // Идентификатор поселения
}

Пример тела ответа:

{
  "dropshipping_markup": null,
  "is_temperature_limits_agreed": false,
  "manager_id": 3659,
  "is_user_logged": 1,
  "is_office": true,
  "has_item_with_by_the_piece_addition": false,
  "email": "my-email@mail.ru",
  "payment_type_id": 4,
  "user_id": 460292,
  "cart_created_at": "2022-12-14 14:25:24+05",
  "items_count": 2,
  "unit_count": 2,
  "google_cid": "GA1.1.726911562.1661259567",
  "person_type": null,
  "assembly_cost": 0,
  "subtotal": 178.90,
  "discount": 0,
  "total": 191.42,
  "status_id": 1,
  "from_mobile": null,
  "delivery_sum": null,
  "is_remote": false,
  "is_small_wholesale": true,
  "contact_person": "Собственный заказ",
  "comment": "",
  "manager_comment": "",
  "is_reorder_denied": false,
  "is_use_digital_signature": false,
  "manager_action": 1,
  "created_at": "2022-12-14T18:04:29+05:00",
  "updated_at": "2022-12-14T18:04:29+05:00",
  "id": 35083201,
  "is_enqueued": true,
  "payment_id": null,
  "done_info": "В ближайшее время с вами свяжется организатор для подтверждения заявки.",
  "jp_order": {
    "order_id": 35083201,
    "jp_purchase_id": 361769,
    "jp_order_status_id": 1, // Начальный статус заявки
    "markup": 12.52,
    "phone": "79999999999",
    "name": "Собственный заказ",
    "email": "my-email@mail.ru",
    "jp_requests": null,
    "reserved_at": null,
    "created_at": "2022-12-14T18:04:29+05:00",
    "updated_at": "2022-12-14T18:04:29+05:00",
    "email_send_status_id": 1,
    "jp_cancellation_reason_id": null,
    "jp_cancellation_reason_text": null,
    "social_link": null,
    "delivery_sum": 0,
    "jp_delivery_address_id": null,
    "jp_delivery_pickup_id": null,
    "is_confirmed": false,
    "can_confirm": false,
    "comment": null
  }
}

Примечание

После оформления заявки товар будет зарезервирован в течение 5 минут. Для отслеживания процесса используйте GET https://www.sima-land.ru/api/v3/order/<id завявки>/?expand=interests,jp_order.

Возможные действия с заявкой

Подтверждение заявки

Если заказ успешно зарезервирован, он резервируется на 3 дня. Чтобы продлить резерв до 7 дней, необходимо изменить статус заявки. Для изменения статуса необходимо отправить запрос PUT https://www.sima-land.ru/api/v3/jp-order/<id заявки>/ с телом запроса.

Тело запроса:

{
  "jp_order_status_id": 8 // Подтверждена организатором
}

Пример тела ответ:

{
  "order_id": 35083201,
  "jp_purchase_id": 361769,
  "jp_order_status_id": 8, // Новый статус, говорящий о том, что заявка зарезервирована на 7 дней
  "markup": 12.52,
  "phone": "79999999999",
  "name": "Собственный заказ",
  "email": "my-email@mail.ru",
  "jp_requests": null,
  "reserved_at": "2022-12-21 22:00:00",
  "created_at": "2022-12-14 18:04:29+05",
  "updated_at": "2022-12-14T18:29:48+05:00",
  "email_send_status_id": 1,
  "jp_cancellation_reason_id": null,
  "jp_cancellation_reason_text": null,
  "social_link": null,
  "delivery_sum": 0,
  "jp_delivery_address_id": null,
  "jp_delivery_pickup_id": null,
  "is_confirmed": false,
  "can_confirm": false,
  "comment": null
}

Отмена заявки

Для отмены заявки также используется запрос PUT https://www.sima-land.ru/api/v3/jp-order/<id заявки>/.

Тело запроса:

{
  "jp_order_status_id": 2 //Отклонена организатором
}

Пример тела ответа:

{
  "order_id": 35083201,
  "jp_purchase_id": 361769,
  "jp_order_status_id": 2, // Новый статус, говорящий о том, что заявка отменена
  "markup": 12.52,
  "phone": "79999999999",
  "name": "Собственный заказ",
  "email": "my-email@mail.ru",
  "jp_requests": null,
  "reserved_at": "2022-12-21 22:00:00",
  "created_at": "2022-12-14 18:04:29+05",
  "updated_at": "2022-12-14T18:29:48+05",
  "email_send_status_id": 1,
  "jp_cancellation_reason_id": null,
  "jp_cancellation_reason_text": null,
  "social_link": null,
  "delivery_sum": 0,
  "jp_delivery_address_id": null,
  "jp_delivery_pickup_id": null,
  "is_confirmed": false,
  "can_confirm": false,
  "comment": null
}

Редактирование заявки

  • Редактирование заявки невозможно. Вместо этого необходимо отменить старую заявку и создать новую.

3. Выбор активных заявок

Для выбора всех активных зарезервированных заявок используется PUT https://www.sima-land.ru/api/v3/jp-purchase/<id закупки>/.

Тело запроса:

{
    "select_all": true
}

Пример тела ответа:

{
  "id": 361769,
  "user_id": 460292,
  "jp_status_id": 1,
  "ended_at": "2022-11-16 15:00:00+0500",
  "created_at": "2022-12-14 17:20:42+05",
  "updated_at": "2022-12-14 17:20:42+05",
  "request_count_all": 2,
  "request_count_new": 1,
  "request_count_approved": 0,
  "request_count_declined": 1,
  "jp_purchase_selected_subtotal": 178.90,
  "jp_purchase_selected_markup": 12.52,
  "jp_purchase_selected_delivery_sum": null,
  "jp_purchase_selected_orders": [ // Массив заявок, выбранных к оформлению
    {
      "id": 156825395,
      "jp_purchase_id": 361769,
      "order_id": 35086122 // Идентификатор заявки, выбранной к оформлению
    },
    {
      "id": 156825470,
      "jp_purchase_id": 361769,
      "order_id": 35086358
    }
  ],
  "is_pending_request": false
}

4. Оформление выбранных заявок

Для оформления общего заказа из выбранных заявок используется POST https://www.sima-land.ru/api/v3/order/ с телом запроса:

Тело запроса:

{
  "type": "jp-order",
  "jp_requests": "35086122,35086358,35086569", // Перечень выбранных для оформления заявок
  "contact_phone": "79999999999", // Ваш телефон
  "contact_name": "Собственный заказ", // Ваше ФИО
  "jp_purchase_id": 361769, // Идентификатор закупки
  "paymentTypeId": 0, // Вид оплаты. 0 - Безнал.
  "deliveryTypeId": 28, // Тип доставки
  "settlement_id": 1686293227, // Идентификатор поселения для доставки
  "person_type": 1 // Тип пользователя
}

Пример тела ответа:

{
  "dropshipping_markup": null,
  "is_temperature_limits_agreed": false,
  "manager_id": 3659,
  "is_office": true,
  "has_item_with_by_the_piece_addition": false,
  "payment_type_id": 1,
  "user_id": 460292,
  "cart_created_at": "2022-12-14 14:25:24+05",
  "items_count": 3,
  "unit_count": 6,
  "google_cid": "GA1.1.726911562.1661259567",
  "person_type": null,
  "assembly_cost": 0,
  "subtotal": 1652.70,
  "discount": 0,
  "total": 1652.70,
  "status_id": 1,
  "from_mobile": null,
  "delivery_sum": null,
  "is_remote": false,
  "is_small_wholesale": false,
  "contact_person": "Собственный заказ",
  "comment": "",
  "manager_comment": "",
  "is_reorder_denied": false,
  "is_use_digital_signature": false,
  "manager_action": 1,
  "created_at": "2022-12-14T19:17:33+05:00",
  "updated_at": "2022-12-14T19:17:33+05",
  "id": 35086785, // Идентификатор общего заказа
  "is_enqueued": true,
  "payment_id": null,
  "done_info": "Менеджер не будет звонить, чтобы подтвердить заказ — это не требуется. Он свяжется с вами, только если понадобится дополнительная информация."
}

Примечание

  • После оформления общего заказа необходимо закрыть закупку, в рамках которой он оформлялся.
  • Если отправить запрос без тела запроса, то оформится заказ из товаров которые находятся у вас в корзине.

5. Закрытие закупки

Закрытие закупки происходит при отправке запроса PUT https://www.sima-land.ru/api/v3/jp-purchase/361769/ с обязательным телом запроса:

Тело запроса:

{
  "jp_status_id": 2
}

Шаг 4. Получение данных по заказу

Отслеживание статуса доступно по запросу GET https://www.sima-land.ru/api/v3/order/. При отправке вернется информация список заказов пользователя.

Доступные параметры запроса:

Имя По умолчанию Описание
is_current_agent - Фильтр по заказам агента для текущего пользователя
is_current_pickup_point - Фильтр партнерских заказов авторизованного пользователя
success - Фильтр по оплаченным товарам
created_at +created_at Фильтр по дате создания
jp_order_updated_at - Фильтр по дате обновления заявки на резерв
item_id - Фильтр по идентификатору товара
item_sid - Фильтр по артикулу товара
is_jp_request_only - Только заказы оформленные с помощью резерва
is_jp_request_except - Исключить заказы с помощью резерва

Для применения сортировки необходимо передать GET параметр sort. Варианты сортировки списка:

  • total;
  • subtotal;
  • jp_order_status_id;
  • created_at (по умолчанию +created_at);
  • updated_at;
  • jp_order_updated_at.
Пример тела ответа
{
  "id": 4115728,  // Идентификатор заказа
  "user_id": 924682,  // Идентификатор пользователя, сделавшего заказ
  "total": 384.8,  // Общая сумма заказа
  "subtotal": 184.8,  // Сумма заказа без учета скидок и доставки
  "created_at": "2018-02-14 11:00:17+05",  // Дата и время создания заказа
  "discount": 0,  // Сумма скидки на заказ
  "updated_at": "2018-02-14 11:00:17+05",  // Дата и время последнего обновления заказа
  "ad_user_id": null,  // Идентификатор пользователя, связанного с рекламой
  "ad_source": null,  // Источник рекламы
  "ad_channel": null,  // Канал рекламы
  "ad_campaign": null,  // Кампания рекламы
  "shipping_date": null,  // Дата доставки
  "comment": null,  // Комментарий к заказу
  "cart_created_at": "2018-02-14 11:00:16+05",  // Дата и время создания корзины
  "status_id": 16,  // Идентификатор статуса заказа
  "payment_type_id": 4,  // Идентификатор типа оплаты
  "delivery_sum": 0,  // Сумма доставки
  "google_cid": "1557832807.1506595602",  // Идентификатор клиента Google
  "manager_id": null,  // Идентификатор менеджера, ответственного за заказ
  "manager_comment": null,  // Комментарий менеджера к заказу
  "psb_rrn": null,  // Идентификатор транзакции в системе PSB
  "psb_intref": null,  // Внутренний идентификатор транзакции в системе PSB
  "delivery_extra_price_total": null,  // Дополнительная стоимость доставки
  "version": 1,  // Версия заказа
  "is_viewed": 0,  // Флаг, указывающий, был ли заказ просмотрен (0 - нет, 1 - да)
  "items_count": 1,  // Количество позиций в заказе
  "unit_count": 4,  // Количество единиц товара в заказе
  "is_user_logged": 1,  // Флаг, указывающий, авторизован ли пользователь (0 - нет, 1 - да)
  "delivery_project_sid": null,  // Идентификатор проекта доставки
  "delivery_time_period_sid": null,  // Идентификатор временного периода доставки
  "delivery_project_info": null,  // Информация о проекте доставки
  "re_ordering_id": null,  // Идентификатор повторного заказа
  "imported_from": null,  // Источник импорта заказа
  "source": null,  // Источник заказа
  "source_id": null,  // Идентификатор источника заказа
  "credit_status_id": null,  // Идентификатор статуса кредита
  "has_item_with_by_the_piece_addition": false,  // Флаг, указывающий, есть ли товар с добавлением поштучно
  "is_office": true,  // Флаг, указывающий, является ли заказ офисным (true - да, false - нет)
  "email": null,  // Email, указанный при оформлении заказа
  "notification_type_id": null,  // Идентификатор типа уведомления
  "person_type": null,  // Тип лица (физическое или юридическое)
  "certificate_key": null,  // Ключ сертификата
  "is_service": null,  // Флаг, указывающий, является ли заказ услугой
  "certificate_sent_at": null,  // Дата и время отправки сертификата
  "counterparty_id": null,  // Идентификатор контрагента
  "from_mobile": null,  // Флаг, указывающий, был ли заказ сделан с мобильного устройства
  "is_remote": false,  // Флаг, указывающий, является ли заказ удаленным
  "is_fast_delivery": null,  // Флаг, указывающий, является ли доставка быстрой
  "payment_id": null,  // Идентификатор платежа
  "manager_action": 1,  // Действие менеджера (например, // 1 - действие выполнено, 0 - действие не выполнено)
  "is_small_wholesale": false,  // Флаг, указывающий, является ли заказ малым оптом (true - да, false - нет)
  "contact_person": null,  // Контактное лицо для заказа
  "terminal_number": null,  // Номер терминала для оплаты
  "is_use_digital_signature": false,  // Флаг, указывающий, используется ли цифровая подпись (true - да, false - нет)
  "assembly_cost": null,  // Стоимость сборки
  "is_reorder_denied": false,  // Флаг, указывающий, запрещен ли повторный заказ (true - да, false - нет)
  "pin_code": null,  // Пин-код для подтверждения заказа
  "is_pin_code_confirmed": false,  // Флаг, указывающий, подтвержден ли пин-код (true - да, false - нет)
  "notify_before": null,  // Уведомление перед событием
  "is_loyal_discount": false,  // Флаг, указывающий, применяется ли скидка для лояльных клиентов (true - да, false - нет)
  "is_cancellation_requested": false,  // Флаг, указывающий, запрашивалась ли отмена заказа (true - да, false - нет)
  "is_cancellation_allowed": false,  // Флаг, указывающий, разрешена ли отмена заказа (true - да, false - нет)
  "is_enqueued": false,  // Флаг, указывающий, находится ли заказ в очереди (true - да, false - нет)
  "is_temperature_limits_agreed": false,  // Флаг, указывающий, согласованы ли температурные ограничения (true - да, false - нет)
  "dropshipping_markup": null,  // Наценка для дропшиппинга
  "has_jewelry": false,  // Флаг, указывающий, содержит ли заказ ювелирные изделия (true - да, false - нет)
  "yandex_uid": null,  // Идентификатор пользователя Яндекса
  "bonus_sum": null,  // Сумма бонусов, примененных к заказу
  "currency_code": null,  // Код валюты заказа
  "currency_nominal": null,  // Номинал валюты
  "currency_value": null,  // Значение валюты
  "currency_rate": null,  // Курс валюты
  "certificate_sum": null,  // Сумма сертификата
  "delivery_address_id": null,  // Идентификатор адреса доставки
  "pickup_type_id": null,  // Идентификатор типа самовывоза
  "legal_entity_id": null,  // Идентификатор юридического лица
  "phone": null,  // Телефон, указанный при оформлении заказа
  "is_jp_request": true  // Флаг, указывающий, является ли заказ заявкой на резерв (true - да, false - нет)
}

Для получения данных по одному заказу в запросе следует указать id заказа: GET https://www.sima-land.ru/api/v3/order/<id заказа>/.

Отслеживание статуса

Статус заказа отображается в поле status_id.

Описание статусов:

Статус ID Описание
1,2,3,23 Заказ принят в обработку
4 Заключение договора
5 Договор заключен
6 Выставление счета, зайдите через несколько минут
7 Формирование счета
8 Счет отправлен для ознакомления
10 Счет снят, нет подтверждения
12 Счет не оплачен
11 Счет оплачен, сборка заказа
20 Заказ оплачен, передан на сборку
21 Мы уже собираем ваш заказ
13 Заказ собран и готов к отправке
14 Отгружено со склада
15 Груз получен
16 Заказ отменен
19 Деньги возвращены на карту

Дополнительный материал

Выгрузка информации по товарам/товару

Имеется несколько вариантов выгрузки информации товаров:

  • С помощью api/v3;
  • С помощью api/v5;
  • XML фид. Больше подходит, если вы планируете создавать карточки на Yandex Market и MegaMarket. 1. Карточки товаров на этих платформах можно создать автоматически на основе информации из XML фида, который предоставляет "Сима-ленд". Это позволяет массово импортировать товары, обеспечивая единообразие описаний и характеристик. Чтобы запросить XML фид, продавцам необходимо отправить запрос на электронную почту partner@sima-land.ru с указанием следующей информации:
                
                  - Название маркетплейса, для которого требуется фид;
                  - Наименование склада, остатки которого будут передаваться (Екатеринбург / Москва);
                  - Требуемая форма расчета цены, если это применимо;
                  - Перечень категорий товаров для включения в фид;
                  - Прочие требования к товарам, которые должны попасть в фид.
                
              
    img_3.png

Рис.4: Отображение кнопки "Облачного парсера" на странице каталога товаров

  • Сервис "Облачный парсер". Данный способ лучше удобнее использовать для Wildberries и OZON. Для этих маркетплейсов возможна выгрузка товаров через специальный сервис, доступный в личном кабинете "Сима-ленд". После активации опции "Выгружать каталог по кнопке" на страницах сайта появляется виджет "Выгрузить товары" (Рис.4), с помощью которого можно осуществить экспорт данных о продукции. Инструкции по процессу создания карточек через “Облачный парсер”:

Далее рассмотрим подробнее способы выгрузки информации через api:

Использование api/v3

Плюсы v3:

  • более полная информация о товаре
  • есть возможность применить множество разных фильтров на стороне сервера
  • множество прочих сущностей кроме каталога (корзина, заказ, расчет стоимости доставки, …)
  • в одном ответе можно получить всю информацию о товаре

Минусы v3:

  • более долгие ответы API
  • более узкие рамки по количеству запросов
  • непростая реализация многопоточности и постраничной навигации
  • сложная документация

Получения списка товаров доступно по запросу GET https://www.sima-land.ru/api/v3/item/.

  • Товары сортируются по ID (по возрастанию).
  • Стандартная пагинация с параметром page=? отключается при достаточно больших значениях page (page*per-page > 10000).

Получение данных по конкретному товару используются параметры запроса, например по id товара и по sid (артикул). Пример запроса данных по нескольким товаром с помощью артикула: GET https://sima-land.ru/api/v3/item/?sid=9734965,3504349

Так же доступна сортировка при указании параметра sort:

  • name;
  • sid;
  • created;
  • price (по умолчанию -price);
  • date.
Пример тела ответа при статусе 200:
{
  "items": [
    {
      "id": 7321449,
      "sid": 9734965,
      "uid": "161bd861-dd22-11ed-80e2-00155d991915",
      "name": "Полуботинки треккинговые Elkland 170, демисезонные, цвет черный, размер 40",
      "slug": "polubotinki-trekkingovye-elkland-170-demisezonnye-cvet-chernyy-razmer-40",
      "balance": 0,
      "is_disabled": 0,
      "reason_of_disabling": null,
      "minimum_order_quantity": "1.00",
      "price": 4999,
      "price_max": 4999,
      "price_per_square_meter": 0,
      "price_per_linear_meter": 0,
      "currency": "RUB",
      "created_at": "2023-05-04 11:10:12+05",
      "updated_at": "2025-01-17 00:05:44+05",
      "boxtype_id": 227,
      "box_depth": 32,
      "box_height": 11.5,
      "box_width": 21,
      "in_box": 3,
      "in_set": 0,
      "depth": 0,
      "unit_id": 84,
      "nested_unit_id": null,
      "width": 0,
      "height": 0,
      "trademark_id": 18548,
      "country_id": 156,
      "cart_min_diff": "1.00",
      "keep_package": 0,
      "per_package": 1,
      "video_file_name": null,
      "video_cover_file_name": null,
      "video_file_url": false,
      "series_id": null,
      "is_hit": 0,
      "is_licensed": null,
      "is_price_fixed": 0,
      "is_exclusive": 0,
      "is_motley": 0,
      "is_adult": 0,
      "is_protected": 0,
      "offer_id": null,
      "certificate_type_id": 1,
      "has_usb": null,
      "has_battery": null,
      "has_clockwork": null,
      "has_sound": null,
      "has_radiocontrol": null,
      "is_inertial": null,
      "is_on_ac_power": null,
      "has_rus_voice": null,
      "has_rus_pack": null,
      "has_light": null,
      "is_day_offer": null,
      "page_title": null,
      "page_keywords": null,
      "page_description": null,
      "parent_item_id": 500787665,
      "max_qty": 1,
      "min_qty": 1,
      "modifier_id": 91,
      "modifier_value": "40",
      "qty_multiplier": 1,
      "gift_id": null,
      "surface_area": null,
      "linear_meters": null,
      "is_loco": 0,
      "novelted_at": null,
      "is_paid_delivery": 0,
      "package_volume": "7.728",
      "min_age": null,
      "power": null,
      "volume": null,
      "transport_condition_id": null,
      "has_discount": 0,
      "is_gift": 0,
      "is_boxed": 0,
      "product_volume": 10.465,
      "box_volume": 31.395,
      "box_capacity": 3,
      "packing_volume_factor": 0,
      "is_tire_spike": 0,
      "is_tire_run_flat": 0,
      "tire_season_id": 0,
      "tire_diameter_id": 0,
      "tire_width_id": 0,
      "tire_section_height_id": 0,
      "tire_load_index_id": 0,
      "tire_speed_index_id": 0,
      "wheel_lz_id": 0,
      "wheel_width_id": 0,
      "wheel_diameter_id": 0,
      "wheel_dia_id": 0,
      "wheel_pcd_id": 0,
      "wheel_et_id": 0,
      "has_body_drawing": null,
      "has_cord_case": null,
      "has_teapot": null,
      "has_termostat": null,
      "is_imprintable": null,
      "isbn": "",
      "page_count": null,
      "is_add_to_cart_multiple": 0,
      "supply_period": 0,
      "has_action": 0,
      "has_action_discount_system": 0,
      "has_jewelry_action": 0,
      "has_3_pay_2_action": 0,
      "has_best_fabric": 0,
      "has_best_textile": 0,
      "has_number_one_made_in_russia": 0,
      "photoIndexes": [
        "0",
        "1",
        "2",
        "3",
        "4",
        "5",
        "6"
      ],
      "photoVersions": [
        {
            "number": "0",
            "version": "1705649432"
        },
        {
            "number": "1",
            "version": "1705649432"
        },
        {
            "number": "2",
            "version": "1705649432"
        },
        {
            "number": "3",
            "version": "1705649432"
        },
        {
            "number": "4",
            "version": "1705649432"
        },
        {
            "number": "5",
            "version": "1705649432"
        },
        {
            "number": "6",
            "version": "1714133102"
        }
      ],
      "photoUrl": "https://goods-photos.static1-sima-land.com/items/7321449/0/700.jpg?v=1705649432",
      "audio_filename": null,
      "photo_3d_count": null,
      "is_markdown": 0,
      "is_prepay_needed": 0,
      "is_paid_delivery_ekb": false,
      "mean_rating": 5,
      "comments_count": 2,
      "markdown_reason": "",
      "is_wholesale": 0,
      "is_wholesale_conservation": 0,
      "type": 0,
      "is_shock_price": false,
      "vat": 20,
      "is_export_to_s3": false,
      "currencySign": "руб.",
      "isEnough": false,
      "isAddToCartMultiple": false,
      "minQty": 1,
      "qtyRule": "от",
      "qty_rules": "по 1 паре",
      "qty_rules_data": {
        "on": "по 1 паре"
      },
      "custom_qty_rules_data": null,
      "pluralNameFormat": "пары",
      "inBoxPluralNameFormat": "пары",
      "balancePluralNameFormat": "пар",
      "can_buy_by_credit": false,
      "supplier_code": "",
      "weight": 1215,
      "has_special_offer": false,
      "has_day_discount": 0,
      "has_erich_krause": 0,
      "has_tm_gamma_gifts": 0,
      "has_superprice_on_line": 0,
      "has_week_discount": 0,
      "has_3days_discount": 0,
      "has_best_fabric_2018": 0,
      "has_pay_later": 0,
      "has_new_rules": 0,
      "has_item_month": 0,
      "has_batteries_gift": 0,
      "action_urls": [],
      "special_offer_id": 13,
      "has_4_pay_2_action": 0,
      "has_take_installments_action": 0,
      "min_sum_order": null,
      "wholesale_price": 4499,
      "wholesale_price_text": "цена по акции «Опт»",
      "is_part": false,
      "is_remote_store": 0,
      "is_small_wholesale_available": true,
      "is_plant": false,
      "color": "",
      "image_title": "Полуботинки треккинговые Elkland 170, демисезонные, цвет черный, размер 40, 9734965",
      "image_alt": "Полуботинки треккинговые Elkland 170, демисезонные, цвет черный, размер 40, Ботинки",
      "short_name": "",
      "is_free_delivery": true,
      "min_sum_for_free_delivery": 3000,
      "updated_item_at": "2024-04-06 20:36:02.057942+05",
      "img": "https://goods-photos.static1-sima-land.com/items/7321449/0/140.jpg?v=1705649432",
      "nestedUnit": null,
      "date_info": {
        "min_date": "2025-01-28",
        "max_date": null,
        "is_paid": false
      },
      "isEntranceTypeByWeight": true,
      "real_min_qty": 1,
      "is_weighted_goods": false,
      "photos": [
        {
          "url_part": "https://goods-photos.static1-sima-land.com/items/7321449/0/",
          "version": 1705649432,
          "is_stretched": false
        },
        {
          "url_part": "https://goods-photos.static1-sima-land.com/items/7321449/1/",
          "version": 1705649432,
          "is_stretched": false
        },
        {
          "url_part": "https://goods-photos.static1-sima-land.com/items/7321449/2/",
          "version": 1705649432,
          "is_stretched": false
        },
        {
          "url_part": "https://goods-photos.static1-sima-land.com/items/7321449/3/",
          "version": 1705649432,
          "is_stretched": false
        },
        {
          "url_part": "https://goods-photos.static1-sima-land.com/items/7321449/4/",
          "version": 1705649432,
          "is_stretched": false
        },
        {
          "url_part": "https://goods-photos.static1-sima-land.com/items/7321449/5/",
          "version": 1705649432,
          "is_stretched": false
        },
        {
          "url_part": "https://goods-photos.static1-sima-land.com/items/7321449/6/",
          "version": 1714133102,
          "is_stretched": false
        }
      ],
      "country": {
        "id": 156,
        "name": "Китай",
        "full_name": "Китайская Народная Республика",
        "alpha2": "CN"
      },
      "offer": null,
      "discountPercent": 0,
      "hasGift": false,
      "hasGiftAssignee": false,
      "isNovelty": false,
      "itemUrl": "/9734965/polubotinki-trekkingovye-elkland-170-demisezonnye-cvet-chernyy-razmer-40/",
      "price_unit": null,
      "has_volume_discount": false,
      "modifier": {
        "id": 91,
        "name": "Размер",
        "is_picture": 0,
        "priority": 80,
        "has_table_size": true
      },
      "modifiers_count": null,
      "size": null,
      "stuff": "Резина, текстиль, ЭВА",
      "trademark": {
        "id": 18548,
        "sid": "Р00017586",
        "name": "Elkland",
        "description": "",
        "slug": "elkland",
        "photo": null,
        "is_exclusive": 0,
        "enable_category_tree": 0,
        "url": null,
        "is_adult": false,
        "image": "https://cdn2.static1-sima-land.com/trademark/100/"
      },
      "series": null,
      "ecommerce_variant": null,
      "category_id": 22927,
      "loan_category_id": 232,
      "transit_in_settlement": null,
      "is_item_description_hidden": false,
      "is_found_cheaper_enabled": false,
      "wholesale_price_unit": null,
      "wholesale_text": "Рыбалка",
      "arrivalDate": null,
      "is_available_in_giper": false,
      "retail_price": 4999,
      "video_cover_url": null,
      "has_stretched_photo": false,
      "sber_min_payout": 199
    },
    {
      "id": 4453202,
      "sid": 3504349,
      "uid": "c38fb928-3268-11e8-80cb-00155d65762b",
      "name": "Радиатор алюминиевый Royal Thermo Revolution 500, 6 секций",
      "slug": "radiator-alyuminievyy-royal-thermo-revolution-500-6-sekciy",
      "balance": 0,
      "is_disabled": 0,
      "reason_of_disabling": null,
      "minimum_order_quantity": "1.00",
      "price": 6221,
      "price_max": 6221,
      "price_per_square_meter": 0,
      "price_per_linear_meter": 0,
      "currency": "RUB",
      "created_at": "2020-08-06 16:43:02+05",
      "updated_at": "2024-12-10 15:46:19+05",
      "boxtype_id": 271,
      "box_depth": 59.5,
      "box_height": 8,
      "box_width": 48.5,
      "in_box": 1,
      "in_set": 0,
      "depth": 0,
      "unit_id": 91,
      "nested_unit_id": null,
      "width": 0,
      "height": 0,
      "trademark_id": 8439,
      "country_id": 643,
      "cart_min_diff": "1.00",
      "keep_package": 0,
      "per_package": 1,
      "video_file_name": null,
      "video_cover_file_name": null,
      "video_file_url": false,
      "series_id": null,
      "is_hit": 0,
      "is_licensed": null,
      "is_price_fixed": 0,
      "is_exclusive": 0,
      "is_motley": 0,
      "is_adult": 0,
      "is_protected": 0,
      "offer_id": null,
      "certificate_type_id": 2,
      "has_usb": null,
      "has_battery": null,
      "has_clockwork": null,
      "has_sound": null,
      "has_radiocontrol": null,
      "is_inertial": null,
      "is_on_ac_power": null,
      "has_rus_voice": null,
      "has_rus_pack": null,
      "has_light": null,
      "is_day_offer": null,
      "page_title": null,
      "page_keywords": null,
      "page_description": null,
      "parent_item_id": 4453202,
      "max_qty": 1,
      "min_qty": 1,
      "modifier_id": null,
      "modifier_value": null,
      "qty_multiplier": 1,
      "gift_id": null,
      "surface_area": null,
      "linear_meters": null,
      "is_loco": 0,
      "novelted_at": null,
      "is_paid_delivery": 0,
      "package_volume": "23.086",
      "min_age": null,
      "power": null,
      "volume": null,
      "transport_condition_id": null,
      "has_discount": 0,
      "is_gift": 0,
      "is_boxed": 0,
      "product_volume": 23.086,
      "box_volume": 23.086,
      "box_capacity": 1,
      "packing_volume_factor": 0,
      "is_tire_spike": 0,
      "is_tire_run_flat": 0,
      "tire_season_id": 0,
      "tire_diameter_id": 0,
      "tire_width_id": 0,
      "tire_section_height_id": 0,
      "tire_load_index_id": 0,
      "tire_speed_index_id": 0,
      "wheel_lz_id": 0,
      "wheel_width_id": 0,
      "wheel_diameter_id": 0,
      "wheel_dia_id": 0,
      "wheel_pcd_id": 0,
      "wheel_et_id": 0,
      "has_body_drawing": null,
      "has_cord_case": null,
      "has_teapot": null,
      "has_termostat": null,
      "is_imprintable": null,
      "isbn": null,
      "page_count": null,
      "is_add_to_cart_multiple": 0,
      "supply_period": 0,
      "has_action": 0,
      "has_action_discount_system": 0,
      "has_jewelry_action": 0,
      "has_3_pay_2_action": 0,
      "has_best_fabric": 0,
      "has_best_textile": 0,
      "has_number_one_made_in_russia": 0,
      "photoIndexes": [
        "0",
        "1"
      ],
      "photoVersions": [
        {
          "number": "0",
          "version": "1612533973"
        },
        {
          "number": "1",
          "version": "1599236146"
        }
      ],
      "photoUrl": "https://goods-photos.static1-sima-land.com/items/4453202/0/700.jpg?v=1612533973",
      "audio_filename": null,
      "photo_3d_count": null,
      "is_markdown": 0,
      "is_prepay_needed": 0,
      "is_paid_delivery_ekb": false,
      "mean_rating": 0,
      "comments_count": 0,
      "markdown_reason": "",
      "is_wholesale": 0,
      "is_wholesale_conservation": 0,
      "type": 0,
      "is_shock_price": false,
      "vat": 20,
      "is_export_to_s3": false,
      "currencySign": "руб.",
      "isEnough": false,
      "isAddToCartMultiple": false,
      "minQty": 1,
      "qtyRule": "от",
      "qty_rules": "по 1 шт.",
      "qty_rules_data": {
        "on": "по 1 шт."
      },
      "custom_qty_rules_data": null,
      "pluralNameFormat": "шт.",
      "inBoxPluralNameFormat": "шт.",
      "balancePluralNameFormat": "шт.",
      "can_buy_by_credit": false,
      "supplier_code": "",
      "weight": 7840,
      "has_special_offer": false,
      "has_day_discount": 0,
      "has_erich_krause": 0,
      "has_tm_gamma_gifts": 0,
      "has_superprice_on_line": 0,
      "has_week_discount": 0,
      "has_3days_discount": 0,
      "has_best_fabric_2018": 0,
      "has_pay_later": 0,
      "has_new_rules": 0,
      "has_item_month": 0,
      "has_batteries_gift": 0,
      "action_urls": [],
      "special_offer_id": 8,
      "has_4_pay_2_action": 0,
      "has_take_installments_action": 0,
      "min_sum_order": null,
      "wholesale_price": 5982,
      "wholesale_price_text": "цена по акции «Опт»",
      "is_part": false,
      "is_remote_store": 0,
      "is_small_wholesale_available": true,
      "is_plant": false,
      "color": "",
      "image_title": "Радиатор алюминиевый Royal Thermo Revolution 500, 6 секций, 3504349",
      "image_alt": "Радиатор алюминиевый Royal Thermo Revolution 500, 6 секций, Алюминиевые",
      "short_name": "",
      "is_free_delivery": true,
      "min_sum_for_free_delivery": 3000,
      "updated_item_at": "2022-04-11 20:10:03.653673+05",
      "img": "https://goods-photos.static1-sima-land.com/items/4453202/0/140.jpg?v=1612533973",
      "nestedUnit": null,
      "date_info": {
        "min_date": "2025-01-28",
        "max_date": null,
        "is_paid": false
      },
      "isEntranceTypeByWeight": true,
      "real_min_qty": 1,
      "is_weighted_goods": false,
      "photos": [
        {
          "url_part": "https://goods-photos.static1-sima-land.com/items/4453202/0/",
          "version": 1612533973,
          "is_stretched": false
        },
        {
          "url_part": "https://goods-photos.static1-sima-land.com/items/4453202/1/",
          "version": 1599236146,
          "is_stretched": false
        }
      ],
      "country": {
        "id": 643,
        "name": "Россия",
        "full_name": "Российская Федерация",
        "alpha2": "RU"
      },
      "offer": null,
      "discountPercent": 0,
      "hasGift": false,
      "hasGiftAssignee": false,
      "isNovelty": false,
      "itemUrl": "/3504349/radiator-alyuminievyy-royal-thermo-revolution-500-6-sekciy/",
      "price_unit": null,
      "has_volume_discount": false,
      "modifier": null,
      "modifiers_count": null,
      "size": null,
      "stuff": "Алюминий",
      "trademark": {
        "id": 8439,
        "sid": "Р00007576",
        "name": "Royal Thermo",
        "description": "",
        "slug": "royal-thermo",
        "photo": null,
        "is_exclusive": 0,
        "enable_category_tree": 0,
        "url": null,
        "is_adult": false,
        "image": "https://cdn2.static1-sima-land.com/trademark/100/"
      },
      "series": null,
      "ecommerce_variant": null,
      "category_id": 71100,
      "loan_category_id": 310,
      "transit_in_settlement": null,
      "is_item_description_hidden": false,
      "is_found_cheaper_enabled": false,
      "wholesale_price_unit": null,
      "wholesale_text": "Инструменты и сантехника",
      "arrivalDate": null,
      "is_available_in_giper": false,
      "retail_price": 6221,
      "video_cover_url": null,
      "has_stretched_photo": false,
      "sber_min_payout": 248
    }
  ],
  "_links": {
    "self": {
      "href": "https://testben.sima-land.ru/api/v3/item/?sid=9734965%2C3504349&page=1"
    }
  },
  "_meta": {
    "totalCount": 2,
    "pageCount": 1,
    "currentPage": 1,
    "perPage": 50
  }
}

Возможно ограничить выводимые поля параметром fields, пример запроса: https://www.sima-land.ru/api/v3/item/?sid=9734965,3504349&fields=id,sid,name,slug,balance,price,price_max,currency,box_depth,box_height,box_width,in_box,in_set, max_qty,min_qty,photos, trademark,stuff,

Для получения данных на каком складе лежит товар необходимо добавить параметр expand=stocks.

"stocks": [
            {
              "stock_id": 2, /// Склад Екатеринбург
              "balance": 0
            },
            {
              "stock_id": 115, /// Склад Патруши
              "balance": 1
            }
          ]
Доступные параметры запроса:
Имя По умолчанию Описание
id - Товары с определенным идентификатором (можно указывать несколько значений через запятую)
sid - Товары с определенным артикулом (можно указывать несколько значений через запятую)
category_id - Идентификатор основной категории (может быть передано несколько значений через запятую. Например: category_id=1,2,3. В качестве Id категории можно использовать как конечную категорию, так и категории верхнего уровня). Для получения списка всех категорий, к которым относится товар, необходимо воспользоваться GET параметром ?expand=categories. Подробнее о дополнительных полях читайте ниже. При использовании совместно с filter_page_id - игнорируется
country_id - Идентификатор страны (может быть передано несколько значений через запятую)
series_id - Идентификатор серии (может быть передано несколько значений через запятую)
trademark_id - Идентификатор торговой марки (может быть передано несколько значений через запятую)
offer_id - Идентификатор распродажи
gift_id - Идентификатор подарка
has_discount - Товары со скидкой или без
has_price - Товары, у которых цена больше 0 или равна 0
has_balance 1 Показывать только товары, которые есть на складе
stock_ids 1 Показывать только товары, которые есть на складах с переданными идентификаторами
has_photo 1 Показывать только товары с фотографиями
with_adult 0 Показывать товары “для взрослых”: 1 - показывать, 0 - не показывать
is_disabled 0 0 - показывать только активные товары, 1 - показывать только неактивные товары
is_deleted 0 Показывать удаленные товары или нет
is_exclusive - Показывать только “наши разработки”
is_hit - Показывать только хиты продаж
is_novelty - Показывать только новинки
is_loco - Показывать только товары-“локомотив”
is_gift 0 Показывать только товары-подарки
is_adult - Показывать только товары “для взрослых”
is_wish - Показывать только товары в избранном у текущего пользователя
wish_collection_id - Показывать только товары в данной подборке у текущего пользователя
id-greater-than - Параметр для альтернативной пагинации несовместим с page. Использует сортировку по ID
is_markdown 0 Показывать уцененные товары. Возможна передача значений через запятую (0,1)
filter_page_id int Идентификатор подфильтровой страницы
updated_item_at string Показывать товары, дата обновления которых позже указанной в запросе. Дата в формате 2018-07-27
is_remote_store - 0 - Показывать только наши товары, 1 - Показывать только товары партнеров
related_item_to int Связанные товары для указанного товара
is_upsale - Товары допродажи
is_subscribed 0 Показывать только товары на которые подписан
is_waiting 0 Показывать только товары на которые подписан
Описание полей в ответе запроса
Атрибут Тип Описание
id int ID
sid int Идентификатор
uid string Уникальный 36-символьный идентификатор
name string Название
slug string Название для адресной строки
balance int|null Количество на складе (поле не всегда доступно)
is_disabled int Товар отключен. Заполняется из 1С
reason_of_disabling string Причина отключения. Заполняется из 1С
minimum_order_quantity float Минимальное количество в заказе. Выгружается из 1С
price float|null Цена
price_max float Максимальная цена
price_per_square_meter float Цена за кв. м
price_per_linear_meter float Цена за пог. м
currency string Код валюты, в которой выведена цена, например, RUB
created_at string Время создания
updated_at string Время обновления
boxtype_id int Идентификатор типа упаковки
box_depth float Глубина упаковки, см
box_height float Высота упаковки, см
box_width float Ширина упаковки, см
in_box int Количество в боксе
in_set float Количество в наборе
depth int Глубина, см
unit_id int Идентификатор измерения
nested_unit_id int Идентификатор вложенного измерения
width int Ширина, см
height int Высота, см
trademark_id int Идентификатор торговой марки
country_id int Идентификатор страны
cart_min_diff float Минимальное количество для добавления в корзину
keep_package int Сохранять упаковку (влияет на кратность добавления товара в корзину, см. isAddToCartMultiple)
per_package int Количество в упаковке
video_file_name string Название файла видео
video_cover_file_name string Название файла видеообложки
video_file_url string Полный URL до видео
series_id int Идентификатор серии
is_hit int Хит
is_licensed int Лицензионный
is_price_fixed int Фиксированная цена
is_exclusive int Эксклюзивный
is_motley int цвета МИКС
is_adult int Для взрослых
is_protected int Доступен только авторизованному пользователю
offer_id int Идентификатор распродажи
certificate_type_id int Идентификатор типа сертификата
has_usb int Поддерживает usb
has_battery int В комплекте есть батарея
has_clockwork int Есть заводной механизм
has_sound int Есть звук
has_radiocontrol int Есть дистанционное управление
is_inertial int Инерционный
is_on_ac_power int Работает от сети
has_rus_voice int Есть русский голос
has_rus_pack int Есть русскоязычная упаковка
has_light int Есть подсветка
is_day_offer int Дневное спецпредложение? (устаревший атрибут, в настоящее время не используется)
page_title string СЕО-Заголовок
page_keywords string СЕО-ключевые фразы
page_description string СЕО-описание
parent_item_id int Идентификатор группы товаров
max_qty int Максимальное количество товара для заказа
min_qty int Минимальное количество товара для заказа. Рассчитываемое поле
modifier_id int Идентификатор группирующего признака
modifier_value string Значение группирующего признака
qty_multiplier int Множитель количества товара для заказа
gift_id int Идентификатор подарка. @see actualGiftId @deprecated
surface_area float Площадь поверхности, кв. м
linear_meters float Кол-во погонных метров
is_loco int Товар-локомотив (суперцена)
novelted_at string Дата, когда товар стал новинкой
is_paid_delivery int Платная доставка
package_volume float Объем упаковки, куб. дм
min_age int Рекомендуемый возраст
power float Мощность
volume float Объем, л
transport_condition_id int Идентификатор условия транспортировки (устаревший атрибут, в настоящее время не используется)
has_discount int Есть скидка
is_gift int Является подарком
is_boxed int Признак вместимости
product_volume float Объем продукта, л
box_volume float Объем бокса, л
box_capacity int Количество товара, помещяющегося в эталонный бокс
packing_volume_factor float Коэффициент упаковки
has_body_drawing int Наличие рисунка на корпусе
has_cord_case int Есть отсек для шнура
has_teapot int Есть заварочный чайник
has_termostat string Есть терморегулятор
is_imprintable int Возможность нанесения рисунка
isbn string Международный стандартный книжный номер
page_count int Количество страниц
is_add_to_cart_multiple int Признак кратности добавления товара в корзину (см. isAddToCartMultiple)
supply_period int Срок перемещения в РЦ Екатеринбург
has_action int Есть акция
has_action_discount_system int Есть акция “Система скидок”
has_jewelry_action int Есть акция “Бижутерия”
has_3_pay_2_action int Есть акция “3 по цене 2”
has_best_fabric int Лучшая ткань 2016
has_best_textile int Лучшая ткань 2017
has_number_one_made_in_russia int №1 сделано в России
photoIndexes array Список индексов изображений
photoVersions array Список версий изображений
photoUrl string Ссылка на изображение товара
audio_filename string Имя аудиофайла
photo_3d_count int Количество фотографий для формирования 3d изображения
is_markdown int Уценённый товар
is_prepay_needed int Требуется предоплата
is_paid_delivery_ekb bool Платная доставка по Екатеринбургу
mean_rating int Средний рейтинг
comments_count int Количество отзывов
markdown_reason string Причина уценки
is_wholesale int Крупный опт
is_wholesale_conservation int Крупный опт-консервация
type int Тип товара
is_shock_price int Шок-цена
is_recommended bool Рекомендованный
vat float НДС
is_export_to_s3
currencySign string Знак текущей валюты
isEnough bool Достаточно на складе
isAddToCartMultiple bool Кратное добавление в корзину (учитывает все условия кратности: keep_package, is_add_to_cart_multiple)
minQty int Расчетное минимальное кол-во для заказа, складывается из упаковки и минимальных размеров заданных в 1c и в БД
qtyRule string Строка, описывающая правило заказа. По / от
qty_rules string Строка, описывающая правила заказа: от .., по
qty_rules_data object Объект, содержащий правила заказа
custom_qty_rules_data object Объект, содержащий правила заказа для вложенных единиц
pluralNameFormat string Правильное склонение названия единицы измерения для минимального количества в заказе
inBoxPluralNameFormat string Правильное склонение названия единицы измерения для количества в боксе
balancePluralNameFormat string Правильное склонение названия единицы измерения для количества на складе
can_buy_by_credit mixed Есть возможность купить в кредит
supplier_code string Код поставщика
weight int Вес, г
has_special_offer bool Имеется специальное предложение
has_day_discount int Скидка дня
has_erich_krause int Скидки на Erich Krause
has_tm_gamma_gifts int Подарки от ТМ Гамма
has_superprice_on_line int Суперцены на линейки
has_week_discount int Неделя скидок
has_3days_discount int 3 дня суперцен
has_best_fabric_2018 int Лучшая ткань 2018
has_pay_later int Есть акция “Бери сейчас - плати потом”
has_new_rules int Есть акция “Обновлённые правила”
has_item_month int Товар месяца
has_batteries_gift int Есть акция “Батарейка в подарок”
action_urls array Список URL для акций
special_offer_id int Идентификатор специального предложения
has_4_pay_2_action int Есть акция “4 по цене 2”
has_take_installments_action int Есть акция “Бери в рассрочку”
min_sum_order float Минимальная сумма заказа, для данной позиции
wholesale_price float Цена товара по акции “Опт”
wholesale_price_text float Текст стоимости товара по акции “Опт”
is_part bool Является запчастью
is_remote_store int Товар удалённого склада
is_small_wholesale_available bool Есть возможность заказывать товар мелким оптом
is_plant bool Является растением
color string Цвет
image_title string Атрибут title для фото товара
image_alt string Атрибут alt для фото товара
short_name string Краткое название
is_free_delivery bool Бесплатная доставка
min_sum_for_free_delivery float Сумма, при которой будет доступна бесплатная доставка
updated_item_at string Дата обновления товара
img string URL основной картинки
nestedUnit string Вложенная единица измерения
date_info array Информация о датах доставки
isEntranceTypeByWeight bool Осуществляется доставка до двери в зависимости от веса
real_min_qty int Минимального количества товара для заказа без учета “Розничной наценки"
is_weighted_goods bool Весовой товар
photos array Фотографии
country array Страна-производитель
offer array Распродажа
discountPercent int Процент скидки
hasGift boolean Имеет ли подарок
hasGiftAssignee boolean Является ли подарком
isNovelty boolean Новинка
itemUrl string URL-адрес
price_unit float Цена за единицу товара
has_volume_discount boolean Есть скидка за объем
modifier array Тип модификатора
modifiers_count
size string Габариты (глубина × ширина × высота)
stuff string Материалы, строка со списком материалов через запятую. Например: “стекло, PVC, картон”
trademark array Торговая марка
series array Серия
ecommerce_variant string Вариант для ecommerce
category_id int Главная категория
loan_category_id int Идентификатор категории кредитного брокера
transit_in_settlement array Города, в которых доступна доставка товара транзита
is_item_description_hidden bool Скрывается ли описание товара
is_found_cheaper_enabled bool Показать попап “Нашли дешевле”
wholesale_price_unit float Оптовая цена за единицу измерения
wholesale_text
arrivalDate
is_available_in_giper
retail_price
video_cover_url
has_3d_model int 3D модель
is_it_possible_to_add_by_the_piece bool Есть возможность добавлять товар поштучно

Использование api/v5

Плюсы v5:

  • быстрые ответы API
  • широкие лимиты по количеству запросов
  • возможность загрузки в неограниченное количество потоков
  • более понятная документация
  • простая постраничная навигация

Минусы v5:

  • меньше информации о товаре (но есть все необходимое)
  • нет фильтров
  • нет ничего кроме каталога товаров
  • невозможно получить 1 запросом всю информацию о товаре

Для запроса остатков товаров на складе Сима-Ленда используется эндпоинт: https://www.sima-land.ru/api/v5/item.

Доступен параметр номера страницы: p=<Номер страницы>.

Пример тела ответа при статусе

[ { "id": 4574105, "sid": 5180338, "name": "Молд силикон "Зайчики" 3 предмета 1х15,5х8 см", "description": "", "slug": "mold-silikon-zaychiki-3-predmeta-1h15-5h8-cm", "balance": "Достаточно", "price": 186, "box_depth": 15.5, "box_height": 9.5, "box_width": 1.6, "depth": 15.5, "height": 1, "width": 8, "weight": 121, "is_price_fixed": false, "is_adult": false, "is_markdown": false, "trademark_id": 0, "country_id": 156, "unit_id": 91, "nested_unit_id": 0, "agg_photos": [ 0, 1 ], "base_photo_url": "https://goods-photos.static1-sima-land.com/items/4574105/", "minimum_order_quantity": 1, "min_qty": 1, "qty_multiplier": 1, "is_paid_delivery": false, "supply_period": 0, "is_remote_store": false, "parent_item_id": 4574105, "barcodes": [ "2900051803385", "6900051803381" ], "is_exclusive": false, "category_id": 19663, "settlements_balance": [ { "settlement_osm_id": 27503892, "balance": 0 }, { "settlement_osm_id": 1686293227, "balance_text": "Достаточно" } ], "wholesale_price": 162, "price_max": 0, "is_protected": false, "wholesale": { "id": 121, "label": "Опт" }, "vat": 20 }, { "id": 4574105, "sid": 5180338, "name": "Молд силикон "Зайчики" 3 предмета 1х15,5х8 см", "description": "", "slug": "mold-silikon-zaychiki-3-predmeta-1h15-5h8-cm", "balance": "Достаточно", "price": 186, "box_depth": 15.5, "box_height": 9.5, "box_width": 1.6, "depth": 15.5, "height": 1, "width": 8, "weight": 121, "is_price_fixed": false, "is_adult": false, "is_markdown": false, "trademark_id": 0, "country_id": 156, "unit_id": 91, "nested_unit_id": 0, "agg_photos": [ 0, 1 ], "base_photo_url": "https://goods-photos.static1-sima-land.com/items/4574105/", "minimum_order_quantity": 1, "min_qty": 1, "qty_multiplier": 1, "is_paid_delivery": false, "supply_period": 0, "is_remote_store": false, "parent_item_id": 4574105, "barcodes": [ "2900051803385", "6900051803381" ], "is_exclusive": false, "category_id": 19663, "settlements_balance": [ { "settlement_osm_id": 27503892, "balance": 0 }, { "settlement_osm_id": 1686293227, "balance_text": "Достаточно" } ], "wholesale_price": 162, "price_max": 0, "is_protected": false, "wholesale": { "id": 121, "label": "Опт" }, "vat": 20 } ]

Для запроса данных по определенному товару нужно указать id товара: https://www.sima-land.ru/api/v5/item/<id товара>.

Доступен параметр для поиска по артикулу товара by_sid=true. Пример: https://www.sima-land.ru/api/v5/item/<sid товара(артикул)>/?by_sid=true.

Пример тела ответа

{ "id": 4574105, "sid": 5180338, "name": "Молд силикон "Зайчики" 3 предмета 1х15,5х8 см", "description": "", "slug": "mold-silikon-zaychiki-3-predmeta-1h15-5h8-cm", "balance": "Достаточно", "price": 186, "box_depth": 15.5, "box_height": 9.5, "box_width": 1.6, "depth": 15.5, "height": 1, "width": 8, "weight": 121, "is_price_fixed": false, "is_adult": false, "is_markdown": false, "trademark_id": 0, "country_id": 156, "unit_id": 91, "nested_unit_id": 0, "agg_photos": [ 0, 1 ], "base_photo_url": "https://goods-photos.static1-sima-land.com/items/4574105/", "minimum_order_quantity": 1, "min_qty": 1, "qty_multiplier": 1, "is_paid_delivery": false, "supply_period": 0, "is_remote_store": false, "parent_item_id": 4574105, "barcodes": [ "2900051803385", "6900051803381" ], "is_exclusive": false, "category_id": 19663, "settlements_balance": [ { "settlement_osm_id": 27503892, "balance": 0 }, { "settlement_osm_id": 1686293227, "balance_text": "Достаточно" } ], "wholesale_price": 162, "price_max": 0, "is_protected": false, "wholesale": { "id": 121, "label": "Опт" }, "vat": 20 }

Пояснение к полям в теле ответа
Поле Тип Пример Описание
balance* string Достаточно Баланс на складе. В зависимости от разрешения на просмотр баланса, может быть представлен числом или строкой
barcodes [...]
base_photo_url string https://goods-photos.static1-sima-land.com/items/825578/ Базовый url фотографий
box_depth* number($float) 101.2 Глубина упаковки в см.
box_height* number($float) 101.2 Высота упаковки в см.
box_width* number($float) 101.2 Ширина упаковки в см.
category_id* integer($int64) 3 Идентификатор категории
country_id* integer($int64) 300 Идентификатор страны производителя
depth* number($float) 101.2 Глубина в см.
description string От качества посуды зависит не только вкус еды Описание
height* number($float) 101.2 Высота в см.
id* integer($int64) 123456 Идентификатор
is_adult* boolean false Товар 18+
is_disabled* boolean false Товар отключен. Недоступен для приобретения
is_exclusive* boolean false Эксклюзив
is_markdown* boolean false Уцененный товар
is_paid_delivery* boolean false Платная доставка
is_price_fixed* boolean false Фиксированная цена
is_protected* boolean true Доступен только авторизованному пользователю
is_remote_store* boolean false Товар является товаром партнера
isbn string 978-5-9704-3555-7 Номер книги
min_qty* integer($int64) 3 Минимальное количество в заказе
minimum_order_quantity* number($float) 3 УСТАРЕВШЕЕ. Минимальное количество в заказе
name string Скалка деревянная Название
nested_unit_id integer($int64) 3 Идентификатор вложенной единицы измерения
parent_item_id* integer($int64) 11 Идентификатор группы товаров
price* number($float) 99.99 Цена товара в руб.
price_max* number($float) 99.99 Максимальная цена
qty_multiplier* integer($int64) 1 Множитель количества товара
settlements_balance* string($binary) [{"settlement_id":1, "balance": 100, "balance_text":""},{"settlement_id":2, "balance_text":"Достаточно"}] Баланс по городам
sid* integer($int64) 654321 Артикул
slug string skalka-derevyannaya Название товара на транслите для URL
supply_period* integer($int64) 10 Срок перемещения в РЦ Екатеринбург, дней
trademark_id* integer($int64) 100 Идентификатор торговой марки
unit_id integer($int64) 2 Идентификатор единицы измерения
vat* number($float) 20 НДС
weight* number($float) 325 Вес в г.
wholesale* SimalandItemWholesale{...} } Идентификатор оптовой акции

Поселение

Для получения settlement_id города необходимо отправить запрос https://www.sima-land.ru/api/v3/settlement/ с параметром ?name=Название города.

Дополнительные параметры:

id - Фильтр по идентификатору (можно указывать несколько значений через запятую)
name - Фильтр по имени
is_name_filled 0 Исключать записи с пустым полем name
coords - Фильтр по координатам. Принимает два параметра через запятую. (Первое число - latitude от -90 до 90, второе - longitude от -180 до 180).
detect_by_ip - Поиск по IP адресу пользователя
kladr_id - Поиск по коду КЛАДР

Запрос данных пользователя

Данные пользователя запрашиваются с помощью GET https://www.sima-land.ru/api/v3/user/.

Пояснение к полям в теле ответа:
{
  "id": 11111,  // Идентификатор пользователя
  "name": "пользователь",  // Имя
  "email": "",  // Электронная почта
  "phone": "",  // Телефон
  "birth_date": null,  // Дата рождения
  "manager_id": null,  // Идентификатор менеджера
  "is_subscribed_for_newsletter": 0,  // Подписан на новостную рассылку (0 - нет, 1 - да)
  "is_subscribed_for_delivery": 0,  // Подписан на уведомления об отправлениях груза с заказами (0 - нет, 1 - да)
  "is_subscribed_on_order_status": null,  // Подписан на рассылку уведомлений об изменении статуса заказа
  "created_at": "2018-02-14 10:40:12+05",  // Дата и время создания записи
  "updated_at": "2025-02-10 09:47:34+05",  // Дата и время последнего обновления записи
  "has_no_order_sum_restrictions": 0,  // Нет ограничений на сумму заказа (0 - нет, 1 - да)
  "settlement_id": 4319342241,  // Идентификатор населённого пункта
  "settlement_osm_id": 4319342241,  // Идентификатор населённого пункта в OSM
  "is_mature": 0,  // Достиг совершеннолетия (0 - нет, 1 - да)
  "token_push": [],  // Массив токенов для push уведомлений приложения
  "is_cloudparser_enabled": true,  // Показывать виджет Сloudparser (true - да, false - нет)
  "is_subscribed_trigger": 0,  // Подписан на триггерные письма (0 - нет, 1 - да)
  "has_notice_restrictions": 0,  // Имеются ли ограничения на уведомление (0 - нет, 1 - да)
  "jp_organizer_name": "$$Организатор для автотестов$$",  // Имя организатора
  "selected_jp_organizer_id": 5303,  // Идентификатор выбранного организатора СП
  "is_whatsapp": false,  // Есть приложение WhatsApp (true - да, false - нет)
  "is_viber": false,  // Есть приложение Viber (true - да, false - нет)
  "is_telegram": false,  // Есть приложение Telegram (true - да, false - нет)
  "push_messages_enabled": null,  // Флаг возможности отправки push-уведомлений
  "is_push_preffered": true,  // Присылать push уведомления вместо смс (true - да, false - нет)
  "photo_url": "https://user-content.static1-sima-land.com/user/photo/617bbdb9d24c82.83501580.png",  // URL фотографии
  "photo_filename": "617bbdb9d24c82.83501580.png",  // Имя файла фотографии
  "is_wholesale_buyer": false,  // Является ли оптовым покупателем (true - да, false - нет)
  "is_loyal": false,  // Применять условия лояльности без условий (true - да, false - нет)
  "is_export_to_s3": true,  // Экспортировать в S3 (true - да, false - нет)
  "is_subscribed_for_manager": false,  // Подписан на сообщения от менеджера (true - да, false - нет)
  "is_subscribed_to_the_promotions_digest": false,  // Подписан на акции и скидки (true - да, false - нет)
  "is_subscribed_to_article": false,  // Подписан на лучшие статьи сайта (true - да, false - нет)
  "is_mobile_developer": false,  // Является ли мобильным разработчиком (true - да, false - нет)
  "is_bonus_enabled": true,  // Включены ли бонусы (true - да, false - нет)
  "person_type": 1,  // Тип лица (например, 1 - физическое лицо, 2 - юридическое лицо, 3 - ИП)
  "is_subscribed_for_waiting_list": false  // Подписан на лист ожидания (true - да, false - нет)
}

Запрос данных юр.лица

Для получения counterparty_id нужно отправить запрос GET https://www.sima-land.ru/api/v3/counterparty/. В теле ответа передаются данные юр.лица.

Пример тела ответа
{
  "items": [
    {
      "id": 1111111111, // counterparty_id
      "name": "Название", // Наименование юр.лица
      "type": false,
      "person_type": null,
      "is_user_refused": false,
      "inn": "7708737490",
      "organization_payment_id": null, // Тип оплаты организации
      "is_use_digital_signature": false,
      "is_download_certs_allowed": false,
      "refundorm_type": 2,
      "is_show_wholesale_price": false,
      "payment_type_ids": [],
      "month_order_sum": null,
      "sid": null,
      "uuid": "d37bb9a6-e630-4c86-a8af-c60b16f3b072",
      "is_next_order_loyal_discount": false,
      "as_legal_entity": false,
      "buyout_percent": null
    }
  ],
  "_links": {
    "self": {
      "href": "https://www.sima-land.ru/api/v3/counterparty/?page=1"
    }
  },
  "_meta": {
    "totalCount": 2,
    "pageCount": 1,
    "currentPage": 1,
    "perPage": 50
  }
}

Контакты для поддержки

Если у вас возникли вопросы или проблемы, вы можете обратиться в службу поддержки по адресу partner@sima-land.ru.