Пользовательская инструкция для оформления заказа с помощью 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):
Рис.2: Создание API-Key
1. Перейти по адресу: https://www.sima-land.ru/cabinet/token/. Ввести произвольное название для ключа и нажать на кнопку "Создать ключ".
Рис.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. Создание закупки
Чтобы создать новую закупку, для оформления общего заказа, используется
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
с указанием следующей информации:
- Название маркетплейса, для которого требуется фид; - Наименование склада, остатки которого будут передаваться (Екатеринбург / Москва); - Требуемая форма расчета цены, если это применимо; - Перечень категорий товаров для включения в фид; - Прочие требования к товарам, которые должны попасть в фид.
Рис.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.