Условия подключения

Для подключения к системе онлайн-поиска электронных компонентов FreeChips.ru должны выполняться следующие условия:

Единоразовое подключение онлайн-склада поставщика - 10 000 руб. Дальнейшие показы в поиске - БЕСПЛАТНО.

Форматы запроса

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

Поисковая строка передаётся в виде параметра в URL, например http://www.site.ru/script.php?search=LM324.

Форматы ответа

Мы поддерживаем ответ сервера в виде JSON или XML форматирования. Для просмотра подробного описания форматов нажмите на соответвующую закладку.


[
	{
		"id": "123345678",
		"name": "Операционный усилитель LM324ADR",
		"group": "Микросхемы|Операционные усилители",
		"man_pn": "LM324ADRG",
		"manufacturer": "ON Semiconductor",
		"description": "Операционный усилитель широкого применения",
		"case_type": "SO-14",
		"pack_type": "Reel",
		"pack_quant": 2500,
		"stock_quant": 2000,
		"order_quant": 50000,
		"order_days": 14,
		"min_quant": 100,
		"item_url": "http:\/\/ваш_сайт\/catalog\/страница_компонента",
		"item_pdf": "http:\/\/ваш_сайт\/document.pdf",
		"item_image": "http:\/\/ваш_сайт\/image.img",
		"prices": [
			{
				"break": 1,
				"value": 1.3456,
				"currency": "USD"
			},
			{
				"break": 10,
				"value": 1.2222,
				"currency": "USD"
			},
			{
				"break": 100,
				"value": 1.1001,
				"currency": "USD"
			}
		]
	},
	{
		"id": "6675466",
		"name": "Операционный усилитель LM324ADR",
		"group": "Микросхемы|Операционные усилители",
		"man_pn": "LM324ADRG",
		"manufacturer": "ON Semiconductor",
		"description": "Операционный усилитель широкого применения",
		"case_type": "SO-14",
		"pack_type": "Reel",
		"pack_quant": 2500,
		"stock_quant": 2000,
		"order_quant": 50000,
		"order_days": 14,
		"min_quant": 200,
		"mult_quant": 10,
		"item_url": "http:\/\/ваш_сайт\/catalog\/страница_компонента",
		"item_pdf": "http:\/\/ваш_сайт\/document.pdf",
		"item_image": "http:\/\/ваш_сайт\/image.img",
		"prices": [
			{
				"break": 1,
				"value": 1.3456,
				"currency": "USD"
			},
			{
				"break": 10,
				"value": 1.2222,
				"currency": "USD"
			},
			{
				"break": 100,
				"value": 1.1001,
				"currency": "USD"
			}
		]
	}
]

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

  • id - Идентификатор позиции. Уникальное значение в пределах всей вашей базы компонентов. Обязательный. Строка или число. Как правило, в качестве ID используется первичный ключ из базы данных, XML-идентификатор обмена или внутренний артикул.
  • name - Наименование позиции. С большой вероятностью будет использовано в качестве наименования компонента в результатах поиска. Обязательное поле.
  • man_pn - Артикул производителя. Может дублироваться для нескольких позиций. Например, артикул LM324ADR может быть у разных производителей.
  • manufacturer - Наименование производителя. Строка. Не допускается перечислять несколько производителей в одной позиции. В этом случае эти позиции должны выдаваться с разным ID для каждого производителя.
  • group - Название группы компонента. Строка. Может отсутствовать.
  • case_type - Тип корпуса компонента. Строка. Может отсутствовать.
  • pack_type - Тип заводской упаковки. Строка. Может отсутствовать.
  • pack_quant - Количество элементов в одной упаковке. Целое число больше 0. Может отсутствоать.
  • stock_quant - Свободное количество на вашем складе. Целое число больше 0. Любое не числовое значение будет интерпретировано как не заданное и позиция понижена в рейтинге.
  • order_quant - Количество, доступное для заказа с удалённого склада. Целое число больше 0. Любое не числовое значение будет интерпретировано как не заданное и позиция понижена в рейтинге.
  • order_days - Сроки доставки заказа с удалённого склада в днях. Целое число больше 0. Любое не числовое значение будет интерпретировано как не заданное и позиция понижена в рейтинге. Обязательное, если задано поле order_quant.
  • min_quant - Минимальное количество, доступное для заказа. Целое число больше 0. Может отсуствовать, в этом случае его значение будет принято за 1 или как минимальное количество в сетке цен.
  • mult_quant - Кратность заказа компонентов. Целое число больше 0. Может отсуствовать, в этом случае его значение будет принято за 1.
  • item_url - Адрес страницы с детальным описанием компонента на вашем сайте. Может отсутствовать. Если задан, то должен содержать ссылку на страницу именно вашего сайта. Ссылки на сторонние ресурсы игнорируются.
  • item_pdf - Адрес документа с datasheet. На данный момент поддерживаются только ссылки на .pdf. Может отсутствовать.
  • item_image - Ссылка на изображение. Может отсутствовать. Игнорируются все ссылки на сторонние ресурсы.
  • prices - Массив с сеткой цен. Количество записей о ценах не ограничено. В пределах сетки цен не должно быть одинаковых граничных количеств. Описание полей:
    • break - нижнее граничное количество, от которого начинает действовать данная цена. Целое число больше 0. Обязательное поле.
    • currency - валюта, в которой указана цена. На данный момент обрабатываются значения RUB|EUR|USD. Может отсутствовать, в этом случае в качестве валюты будет использована базовая валюта магазина.
    • value - цена в указанной валюте. Число больше 0. 4 знака после запятой. Обязательное.

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <item>
    <id>123345678</id>
    <name>Операционный усилитель LM324ADR</name>
    <group>Микросхемы|Операционные усилители</group>
    <man_pn>LM324ADRG</man_pn>
    <manufacturer>ON Semiconductor</manufacturer>
    <description>Операционный усилитель широкого применения</description>
    <case_type>SO-14</case_type>
    <pack_type>Reel</pack_type>
    <pack_quant>2500</pack_quant>
    <stock_quant>2000</stock_quant>
    <order_quant>50000</order_quant>
    <order_days>14</order_days>
    <min_quant>100</min_quant>
    <item_url>http://ваш_сайт/catalog/страница_компонента</item_url>
    <item_pdf>http://ваш_сайт/document.pdf</item_pdf>
    <item_image>http://ваш_сайт/image.img</item_image>
    <prices>
      <item>
        <break>1</break>
        <value>1.3456</value>
        <currency>USD</currency>
      </item>
      <item>
        <break>10</break>
        <value>1.2222</value>
        <currency>USD</currency>
      </item>
      <item>
        <break>100</break>
        <value>1.1001</value>
        <currency>USD</currency>
      </item>
    </prices>
  </item>
  <item>
    <id>6675466</id>
    <name>Операционный усилитель LM324ADR</name>
    <group>Микросхемы|Операционные усилители</group>
    <man_pn>LM324ADRG</man_pn>
    <manufacturer>ON Semiconductor</manufacturer>
    <description>Операционный усилитель широкого применения</description>
    <case_type>SO-14</case_type>
    <pack_type>Reel</pack_type>
    <pack_quant>2500</pack_quant>
    <stock_quant>2000</stock_quant>
    <order_quant>50000</order_quant>
    <order_days>14</order_days>
    <min_quant>200</min_quant>
    <mult_quant>10</mult_quant>
    <item_url>http://ваш_сайт/catalog/страница_компонента</item_url>
    <item_pdf>http://ваш_сайт/document.pdf</item_pdf>
    <item_image>http://ваш_сайт/image.img</item_image>
    <prices>
      <item>
        <break>1</break>
        <value>1.3456</value>
        <currency>USD</currency>
      </item>
      <item>
        <break>10</break>
        <value>1.2222</value>
        <currency>USD</currency>
      </item>
      <item>
        <break>100</break>
        <value>1.1001</value>
        <currency>USD</currency>
      </item>
    </prices>
  </item>
</response>

В этом случае результаты поиска должны представлять массив XML-данных:

response - обёртка для всего ответа

item - обёртка для каждого найденного элемента

  • id - Идентификатор позиции. Уникальное значение в пределах всей вашей базы компонентов. Обязательный. Строка или число. Как правило, в качестве ID используется первичный ключ из базы данных, XML-идентификатор обмена или внутренний артикул.
  • name - Наименование позиции. С большой вероятностью будет использовано в качестве наименования компонента в результатах поиска. Обязательное поле.
  • man_pn - Артикул производителя. Может дублироваться для нескольких позиций. Например, артикул LM324ADR может быть у разных производителей.
  • manufacturer - Наименование производителя. Строка. Не допускается перечислять несколько производителей в одной позиции. В этом случае эти позиции должны выдаваться с разным ID для каждого производителя.
  • group - Название группы компонента. Строка. Может отсутствовать.
  • case_type - Тип корпуса компонента. Строка. Может отсутствовать.
  • pack_type - Тип заводской упаковки. Строка. Может отсутствовать.
  • pack_quant - Количество элементов в одной упаковке. Целое число больше 0. Может отсутствоать.
  • stock_quant - Свободное количество на вашем складе. Целое число больше 0. Любое не числовое значение будет интерпретировано как не заданное и позиция понижена в рейтинге.
  • order_quant - Количество, доступное для заказа с удалённого склада. Целое число больше 0. Любое не числовое значение будет интерпретировано как не заданное и позиция понижена в рейтинге.
  • order_days - Сроки доставки заказа с удалённого склада в днях. Целое число больше 0. Любое не числовое значение будет интерпретировано как не заданное и позиция понижена в рейтинге. Обязательное, если задано поле order_quant.
  • о
  • min_quant - Минимальное количество, доступное для заказа. Целое число больше 0. Может отсуствовать, в этом случае его значение будет принято за 1 или как минимальное количество в сетке цен.
  • mult_quant - Кратность заказа компонентов. Целое число больше 0. Может отсуствовать, в этом случае его значение будет принято за 1.
  • item_url - Адрес страницы с детальным описанием компонента на вашем сайте. Может отсутствовать. Если задан, то должен содержать ссылку на страницу именно вашего сайта. Ссылки на сторонние ресурсы игнорируются.
  • item_pdf - Адрес документа с datasheet. На данный момент поддерживаются только ссылки на .pdf. Может отсутствовать.
  • item_image - Ссылка на изображение. Может отсутствовать. Игнорируются все ссылки на сторонние ресурсы.
  • prices - Обётрка для ценовых ипредложений. Количество записей о ценах не ограничено. В пределах сетки цен не должно быть одинаковых граничных количеств. Описание полей:
    • item - обёртка для каждого ценового предложения
      • break - нижнее граничное количество, от которого начинает действовать данная цена. Целое число больше 0. Обязательное поле.
      • currency - валюта, в которой указана цена. На данный момент обрабатываются значения RUB|EUR|USD. Может отсутствовать, в этом случае в качестве валюты будет использована базовая валюта магазина.
      • value - цена в указанной валюте. Число больше 0. 4 знака после запятой. Обязательное.

Ранжирование позиций в поисковой выдаче

  1. Соответствие поисковому запросу
  2. Наличие цены
  3. Наличие на складе
  4. Наличие на удалённом складе
  5. Срок поставки с удалённого склада

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

Внимание! Администрация сервиса FreeChips.ru проверяет достоверность предоставляемых поставщиком данных и регистрирует жалобы от клиентов. В случае расхождения информации по складу, выдаваемой в систему, с реальным состоянием склада поставщика, оставляет за собой право в перемещении информации из столбца "На складе" в столбец "Под заказ" до устранения несоответствий.