Выгрузка каталога через API

Главная > Сервисы

API galacentre.ru обеспечивает возможность автоматизированного получения информации о товарах торговой платформы. API построен на концепции REST.

Вся документация по старому API доступна здесь

Вызов ресурсов

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

http://www.galacentre.ru/api/v2/<метод>/<формат_ответа>/?<параметры>

Ключ доступа

Для использования API, необходимо получить ключ авторизации. После этого можно при помощи метода GET выполнять вызов ресурсов для получения необходимой информации или при помощи метода POST отправлять заказы.
Ключ доступа можно самостоятельно получить в разделе «Интеграция».

формат данных <формат_ответа> — это обязательная часть запроса которая влияет на способ представления ответа.
Возможные форматы ответа: csv, xml, json

Методы [GET] sections — возвращает список разделов
[GET] catalog — возвращает список товаров
[POST] order — создаёт заказ из списка товаров

Входные параметры Основные параметры:

key (строка) ключ доступа к API (обязательный).

dateupdate (дата/время в формате Unix Timestamp) При передаче данного параметра отбираются элементы измененные после этой даты. Удобно для получения обновлений товаров.

Параметры для фильтрации:

section (число)
ID раздела каталога, которым ограничивается выборка. Работает так же и при запросе разделов.

ID основных разделов:

14 — Посуда и кухонные принадлежности;
18 — Авто;
20 — Галантерея;
21 — Дача и Сад;
22 — Детство;
23 — Инструменты;
25 — Новогодние товары;
26 — Сантехника и товары для ванной комнаты;
27 — Спорт и отдых;
28 — Подарки;
30 — Хозтовары;
114 — Бытовая химия. Уход и красота. Гигиена;
117 — Товары для животных;
124 — Бытовая техника;
130 — Домашний текстиль;
141 — Канцтовары;
170 — Ароматизаторы;
171 — Туризм и рыбалка;
182 — Мобильные аксессуары и электротехника;

active (число)
При указании active=1 будут выбраны только активные элементы. Работает так же и при запросе разделов.

store (строка) Склад отгрузки. Данным параметром ограничивается выборка до товаров, присутствующих только на выбранном складе.

Возможные значения:

ekb — Екатеринбург;
msk — Москва;
nsk — Новосибирск;

price_from (число)
Минимальная стоимость товаров в выборке

price_to (число)
Максимальная стоимость товаров в выборке

brand (строка)
Бренд товаров в выборке

min (число)
Минимальная партия

Параметры для выборки:

select (список через запятую)
Список выгружаемых параметров товара

Возможные значения:

active — активность товара (Y/N);
date_update — дата последнего обновления в формате UNIX;
articul — артикул товара;
name — название товара;
about — описание товара;
section — раздел;
image — основная фотография товара;
images — дополнительные фотографии товара;
price_base — основная цена;
price_old — старая цена;
price_sp — цена СП;
min — минимальная партия (параметр min=1 для того, чтобы получить товары только с минимальной партией 1 шт.)
box — количество в коробке;
fix — фиксированная цена (1/0);
new — новинка (1/0);
hit — хит продаж (1/0);
brand — бренд товара;
store_ekb — наличие на складе в Екатеринбурге (0 - Нет в наличии, 1 - Мало, 2 - Много);
store_msk — наличие на складе в Москве;
store_nsk — наличие на складе в Новосибирске;
way — дата доставки;
sert — сертификаты;
props — основные свойства товара;
specifications — характеристики товара;
includes — комплектация.
barcode — штрихкод.

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

separator (строка)
Разделитель в CSV выгрузке.

Возможные значения:

semicolon — точка с запятой (по умолчанию);
tab — знак табуляции;

codepage (строка)
Кодировка CSV выгрузки.

Возможные значения:

utf8 — UTF-8 (по умолчанию);
cp1251 — Windows-1251;

jsonincell
Списочные данные в ячейках при выгрузке в CSV будут представлены в виде JSON массива

serialize
Списочные данные в ячейках при выгрузке в CSV будут представлены в виде сериализованного массива

props_slash_separator
Списочные данные в ячейках при выгрузке в CSV будут разделены тремя знаками слеш - ///

withsections
При выгрузке в CSV будут добавлены 3 столбца с разделами - первый, второй, третий уровень

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

Параметры для создания заказа

external_id (строка) Номер заказа в вашем магазине (не обязательный).

items (массив) Массив товаров в заказе, где ключом является артикул товара, а значением - количество товара в заказе (обязательный).

comment (строка) Комментарий к заказу.

Пример для PHP:

<?
$url = "http://www.galacentre.ru/api/v2/order/json/";
$post_data = Array(
	"key" => "XXXX",
	"external_id" => "G12345",
	"comment" => "Заказ для магазина",
	"items" => Array(
		"463-683" => 10,
		"463-681" => 10,
		"463-228" => 10,
	)
);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($post_data));
$output = curl_exec($ch);
curl_close($ch);
print_r (json_decode($output, true));
?>

Параметры ответа при создании заказа:

date (ДД.ММ.ГГГГ) Дата операции

status (SUCCESS успешно / ERROR - ошибка) Статус операции

error_message (текст) Описание ошибки

order (массив) Массив с параметрами созданного заказа:

id: (число) Номер созданного заказа
date: (ДД.ММ.ГГГГ ЧЧ:ММ:СС)Дата и время заказа
price: (число) Стоимость заказа с учетом вашей цены
items_count: (число) Количество товаров в заказе

Примеры использования

Полный список разделов в формате XML http://www.galacentre.ru/api/v2/sections/xml/?key=XXXX

Полный каталог товаров посуды в формате XML http://www.galacentre.ru/api/v2/catalog/xml/?key=XXXX&section=14

Полный каталог инструментов ЕРМАК в формате CSV http://www.galacentre.ru/api/v2/catalog/csv/?key=XXXX&section=23&brand=ermak

Остатки бытовой техники по складу в Екатеринбурге в формате CSV http://www.galacentre.ru/api/v2/catalog/csv/?key=XXXX&section=124&select=id,name,articul,active,store_ekb

Товары FALCO в диапазоне от 1000р. до 1500р. в формате XML http://www.galacentre.ru/api/v2/catalog/xml/?key=XXXX&brand=falco&price_from=1000&price_to=1500

Доски разделочные доступные на складе в Москве в формате JSON http://www.galacentre.ru/api/v2/catalog/json/?key=XXXX&section=1949&store=msk

По вопросам подключения и интеграции

Представьтесь

E-mail

Сообщение

Я принимаю условия «Политики обработки персональных данных» и «Пользовательского соглашения» и даю своё согласие ООО «ГАЛАЦЕНТР» (ИНН 7730228089, ОГРН 1177746126172), место нахождения: 121087, г. Москва, проезд Багратионовский, д.7, корп. 20В, оф.327, тел. +7 (343) 372-03-46 и его уполномоченным представителям на обработку сведений обо мне, содержащих мои персональные данные в соответствии с Федеральным законом «О персональных данных» от 27 июля 2006г. № 152-ФЗ и принятых в соответствии с указанным законом нормативных актов.