Инструкции Smart-Shop:API интеграция - История изменений

Radmir g в 08:48, 30 апреля 2026

2026-04-30T08:48:11Z

← Предыдущая версия		Версия от 11:48, 30 апреля 2026
Строка 94:		Строка 94:
	<code>{</code>		<code>{</code>

	<code> "products_count": ~~“4824”~~,</code>		<code> "products_count": “2”,</code>

	<code> "stocks": [</code>		<code> "stocks": [</code>
Строка 141:		Строка 141:
	<code>{</code>		<code>{</code>

	<code> "products_count": ~~“4824”~~,</code>		<code> "products_count": “2”,</code>

	<code> "prices": [</code>		<code> "prices": [</code>

Radmir g в 11:08, 20 февраля 2026

2026-02-20T11:08:51Z

← Предыдущая версия		Версия от 14:08, 20 февраля 2026
Строка 50:		Строка 50:
	* Ссылка на сертификат, дата актуальности сертификата и тип сертификатов (может быть несколько);		* Ссылка на сертификат, дата актуальности сертификата и тип сертификатов (может быть несколько);
	* Гарантийный срок;		* Гарантийный срок;
	* Ссылка на youtube (видео обзор товара, если имеется)

	Для синхронизации данных по ETIM нам необходимы следующие данные:		Для синхронизации данных по ETIM нам необходимы следующие данные:
Строка 212:		Строка 211:

	<code> "series" : "ZEN",</code>		<code> "series" : "ZEN",</code>

	~~<code> "youtube_code" : "43aV67g6S5Q",</code>~~

	<code> "catalog_link" : "<nowiki>https://smart-shop.pro/itemcard/%D0%A0%D0%AD%D0%9C%D0%97%20%D0%A2%D0%9C/SQ0117-0076</nowiki>",</code>		<code> "catalog_link" : "<nowiki>https://smart-shop.pro/itemcard/%D0%A0%D0%AD%D0%9C%D0%97%20%D0%A2%D0%9C/SQ0117-0076</nowiki>",</code>
Строка 329:		Строка 326:
	** series – серия		** series – серия
	** catalog_link – ссылка на товар в каталоге		** catalog_link – ссылка на товар в каталоге
	** youtube_code – код youtube видео с обзором товара
	** pictures – массив с картинками		** pictures – массив с картинками
	*** Type – тип		*** Type – тип

Radmir g в 13:02, 29 февраля 2024

2024-02-29T13:02:48Z

← Предыдущая версия		Версия от 16:02, 29 февраля 2024
Строка 8:		Строка 8:
	# Свободный остаток товаров на ваших складах;		# Свободный остаток товаров на ваших складах;
	# Ваш прайс-лист;		# Ваш прайс-лист;
	# Данные о товарах в вашем каталоге и данные об их ETIM характеристиках.		# Данные о товарах в вашем каталоге и данные об их ETIM характеристиках;
	# Данные о товарах в пути		# Данные о товарах в пути;

	В случае наличия готового решения на вашей стороне, просьба отправить обратным письмом информацию о том, как мы можем взаимодействовать с вашим Web API, логин/пароль/токен доступа и контакты IT специалиста, которому мы сможем задавать вопросы, касающиеся Web API.		В случае наличия готового решения на вашей стороне, просьба отправить обратным письмом информацию о том, как мы можем взаимодействовать с вашим Web API, логин/пароль/токен доступа и контакты IT специалиста, которому мы сможем задавать вопросы, касающиеся Web API.
Строка 73:		Строка 73:

	==== Данные о товарах в пути (Ожидаемый приход) ====		==== Данные о товарах в пути (Ожидаемый приход) ====
			Под данными о товарах в пути мы подразумеваем информацию о товарах, которые находятся у вас в производстве или в пути на ваши склады и эти товары вскоре окажутся в свободном остатке.

	Для синхронизации данных о товарах в пути по Web API нам нужны следующие данные:		Для синхронизации данных о товарах в пути по Web API нам нужны следующие данные:

Radmir g в 07:41, 26 июля 2023

2023-07-26T07:41:51Z

Внесённые изменения

Radmir g в 07:37, 26 июля 2023

2023-07-26T07:37:49Z

Внесённые изменения

Radmir g: Новая страница: «=== Общие положения === Контакты IT отдела: automatisation@smart-shop.pro Наша компания не является поставщиком IT-услуг, и мы не можем выделить вам специалиста для создания Web API на вашей стороне. В первую очередь мы заинтересованы в синхронизации следующих данных по Web A...»

2023-07-26T07:30:43Z

Новая страница: «=== Общие положения === Контакты IT отдела: automatisation@smart-shop.pro Наша компания не является поставщиком IT-услуг, и мы не можем выделить вам специалиста для создания Web API на вашей стороне. В первую очередь мы заинтересованы в синхронизации следующих данных по Web A...»

Новая страница

=== Общие положения ===
Контакты IT отдела: automatisation@smart-shop.pro

Наша компания не является поставщиком IT-услуг, и мы не можем выделить вам специалиста для создания Web API на вашей стороне.

В первую очередь мы заинтересованы в синхронизации следующих данных по Web API:

1. Свободный остаток товаров на ваших складах;

2. Ваш прайс-лист;

3. Данные о товарах в вашем каталоге и данные об их ETIM характеристиках.

4. Данные о товарах в пути

В случае наличия готового решения на вашей стороне, просьба отправить обратным письмом информацию о том, как мы можем взаимодействовать с вашим Web API, логин/пароль/токен доступа и контакты IT специалиста, которому мы сможем задавать вопросы, касающиеся Web API.

==== Свободный остаток товаров на ваших складах ====
Для синхронизации остатков по Web API нам нужны следующие данные:

· Артикул;

· Свободный остаток (кол-во товара, которое мы можем заказать прямо сейчас);

· Склад (в случае, если у вас несколько складов);

· Ед. измерения.

Предпочтительный формат выдачи с вашей стороны – JSON или CSV.

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

==== Прайс-листы ====
Для синхронизации прайс-листов по Web API нам нужны следующие данные:

· Артикул;

· Цена без НДС с учетом всех скидок (та цена, по который вы готовы отгрузить нам товар);

· Дата изменения цены.

Предпочтительный формат выдачи с вашей стороны – JSON или CSV.

Синхронизацию прайс-листов мы выполняем один раз в день, в 17 часов вечера.

==== Данные о товарах в вашем каталоге и данные об их ETIM характеристиках ====
В нашей системе мы используем ETIM 7 версии.

Для синхронизации каталога нам необходимы следующие данные:

· Артикул;

· Дата обновления данных по артикулу;

· Описание товара;

· Ед. измерения;

· Серия товара;

· Ссылка на товар в вашем каталоге;

· Ссылка на картинку (может быть несколько);

· Ссылка на сертификат, дата актуальности сертификата и тип сертификатов (может быть несколько);

· Гарантийный срок;

· Ссылка на youtube (видео обзор товара, если имеется)

Для синхронизации данных по ETIM нам необходимы следующие данные:

· Идентификатор класса, в системе ETIM (значение вида EC*)

· Идентификатор свойства в системе ETIM (значение вида EF*)

· Значение свойства в формате ETIM:

o Numeric – числовое обозначение в едином формате без ед. изм.

o Range – диапазон значений в едином формате (например, x…y) без ед. измерения.

o Alphanumeric – значение вида EV*, соответствующее текстовому обозначению

o Boolean – логическое значение в едином формате.

Для нас важно, чтобы API для синхронизации товаров предоставляло возможность получать информацию:

· По всем товарам вашего каталога;

· По товарам вашего каталога, информация по которым менялась за определенный период;

· По определенному артикулу из вашего каталога.

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

Предпочтительный формат выдачи с вашей стороны – JSON.

==== Данные о товарах в пути (Ожидаемый приход) ====
Для синхронизации данных о товарах в пути по Web API нам нужны следующие данные:

· Артикул;

· Кол-во товара, которое должно поступить к вам на склад на дату

· Ожидаемая дата поступления товара

· Склад (в случае, если у вас несколько складов);

· Ед. измерения.

Предпочтительный формат выдачи с вашей стороны – JSON или CSV.

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

=== Best practice или как реализовано у других ===
Непосредственно бэкэнд-реализация полностью зависит от того, как работает ваша система и как устроены ваши бизнес-процессы.

В данном разделе будут приведены примеры ответов API с которыми нам, как клиенту, будет удобно работать.

==== Свободный остаток товаров на ваших складах ====
<code>{</code>

<code> "products_count": “4824”,</code>

<code> "stocks": [</code>

<code> {</code>

<code> "vendor_code": "ZENL1121",</code>

<code> "brand_name":"Dekraft",</code>

<code> "location_name": "Лобня",</code>

<code> "unit": "м",</code>

<code> "quantity": "15.000"</code>

<code> },</code>

<code> {</code>

<code> "vendor_code": "ZENL1121",</code>

<code> "brand_name":"Dekraft",</code>

<code> "location_name ": "Екатеринбург",</code>

<code> "unit_code": "упак",</code>

<code> "quantity": "1000.000"</code>

<code> }</code>

<code> ]</code>

<code>}</code>

* products_count – кол-во товаров в выдаче
* stocks – массив с товарами
** vendor_code – артикул
** brand_name – бренд
** location_name – склад
** unit – ед. измерения товара
** quantity – свободный остаток

===Описание===

===Ограничения===
*Ограничение 1
*Ограничение 2
*Ограничение 3

===Доступы===

[[Категория:Инструкции SS API]]