Доставка, оплата и справочники

Без parent_id Gigma вернёт корневые категории текущего Application. Чтобы получить следующий уровень, передайте ID родителя.

Параметры запроса

• limit (integer, опционально) — максимальное количество элементов, от 1;
• parent_id (integer, опционально) — ID родительской категории.

Ответ

{
	"categories": [
		{
			"id": 12,
			"name": "Аксессуары",
			"photo": "https://api.gigma.ru/storage/uploads/category.jpg",
			"parent": null
		}
	],
	"categoriesCount": 1
}

Ошибки

• 401 — App Token отсутствует или недействителен.

Gigma вернёт бренды текущего Application по убыванию приоритета.

Параметры запроса

• limit (integer, опционально) — максимальное количество элементов, от 1.

Ответ

{
	"brands": [
		{
			"id": 99,
			"name": "Бренд",
			"photo": null,
			"created_at": "2026-08-15T10:00:00+00:00"
		}
	],
	"brandsCount": 1
}

Ошибки

• 401 — App Token отсутствует или недействителен.

Страны — общий системный справочник. Наличие страны в ответе не означает, что в текущем каталоге есть товары с таким значением.

Ответ

{
	"countries": [
		{
			"id": 1,
			"name": "Россия",
			"photo": null,
			"created_at": "2026-08-15T10:00:00+00:00"
		}
	],
	"countriesCount": 1
}

Ошибки

• 401 — App Token отсутствует или недействителен.

Ответ

{
	"deliveryTypes": [
		{
			"id": 1,
			"name": "Самовывоз",
			"price": "0.00",
			"is_active": 1
		},
		{
			"id": 2,
			"name": "Доставка",
			"price": "300.00",
			"is_active": 1
		}
	],
	"deliveryTypesCount": 2
}

Показывайте клиенту только активные элементы. Определяйте способ по ID из ответа и настройкам проекта, а не по названию из примера.

Ошибки

• 401 — App Token отсутствует или недействителен.

Параметры пути

• type_id (integer, обязательный) — ID способа доставки.

Ответ

{
	"deliveryType": {
		"id": 2,
		"name": "Доставка",
		"price": "300.00",
		"is_active": 1
	}
}

Ошибки

• 401 — App Token отсутствует или недействителен;
• 404 — способ доставки не найден.

Параметры пути

• type_id (integer, обязательный) — ID способа доставки.

Ответ

{
	"deliverySubtypes": [
		{
			"id": 2,
			"name": "Курьер",
			"price": "1000.00",
			"is_active": 1
		}
	],
	"deliverySubtypesCount": 1
}

Ошибки

• 401 — App Token отсутствует или недействителен;
• 404 — способ доставки не найден.

Gigma проверяет существование обоих ID, но сейчас не сверяет, что subtype_id относится к type_id. Передавайте только ID из списка подтипов выбранного способа доставки.

Параметры пути

• type_id (integer, обязательный) — ID способа доставки;
• subtype_id (integer, обязательный) — ID подтипа.

Ответ

{
	"deliverySubtype": {
		"id": 2,
		"name": "Курьер",
		"price": "1000.00",
		"is_active": 1
	}
}

Ошибки

• 401 — App Token отсутствует или недействителен;
• 404 — способ или подтип доставки не найден.

Параметры содержат дополнительные варианты подтипа, например конкретные пункты выдачи.

Gigma сейчас не сверяет type_id с родителем subtype_id. Сначала получите подтипы выбранного способа доставки и используйте ID из этого ответа.

Параметры пути

• type_id (integer, обязательный) — ID способа доставки;
• subtype_id (integer, обязательный) — ID подтипа.

Ответ

{
	"deliverySubtypeParams": [
		{
			"id": 7,
			"name": "г Москва, ул Деловая, д 20"
		}
	],
	"deliverySubtypeParamsCount": 1
}

Ошибки

• 401 — App Token отсутствует или недействителен;
• 404 — способ или подтип доставки не найден.

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

Ответ

{
	"paymentTypes": [
		{
			"id": 2,
			"photo": null,
			"name": "Онлайн",
			"description": "Оплата через платёжный сервис"
		}
	],
	"paymentTypesCount": 1
}

Ошибки

• 401 — App Token отсутствует или недействителен.

Список ограничен проектом, но не отдельным Application. Показывайте только магазины, разрешённые для вашего продукта.

Ответ

{
	"shops": [
		{
			"id": 4,
			"photo": null,
			"name": "Центральный",
			"address": "г Москва, ул Деловая, д 20",
			"phone": "+79991234567",
			"schedule": "Пн–Пт, 10:00–18:00"
		}
	],
	"shopsCount": 1
}

Ошибки

• 401 — App Token отсутствует или недействителен.

Сейчас этот маршрут не возвращает выбранный магазин. Gigma проверяет существование id, а затем возвращает первую страницу со slug: shops-info.

Не используйте метод для получения адреса или проверки принадлежности магазина. Берите данные магазинов только из GET /api/counterparty/shops.

Параметры пути

• id (integer, обязательный) — ID магазина; используется только для проверки существования.

Ответ

{
	"page": {
		"id": 103,
		"slug": "shops-info",
		"title": "Информация о магазинах",
		"content": "<p>Справочная информация</p>"
	}
}

Ошибки

• 401 — App Token отсутствует или недействителен;
• 404 — магазин с таким ID не найден.

Параметры запроса

• query (string, обязательный) — поисковая строка от 3 до 1024 символов.

Пример запроса

{
	"query": "Деловая 20, Москва"
}

Ответ

{
	"addresses": [
		{
			"name": "г Москва, ул Деловая, д 20",
			"value": "115477, г Москва, ул Деловая, д 20"
		}
	],
	"addressesCount": 1
}

Сохраняйте в заказе полное значение value. Поле name используйте как краткую подпись.

Ошибки

• 401 — App Token отсутствует или недействителен;
• 422 — строка короче трёх символов или не прошла валидацию.

Передайте нужные наборы через запятую в include. Если параметр не указан, Gigma вернёт все пять наборов.

Параметры запроса

• include (string, опционально) — categories, brands, countries, tags, popular_requests.

Неизвестные значения игнорируются.

Пример запроса

GET /api/counterparty/dictionaries?include=categories,brands,countries HTTP/1.1
Host: api.gigma.ru
Token: <application_token>
Accept: application/json

Ответ

{
	"dictionaries": {
		"categories": [],
		"brands": [],
		"countries": []
	}
}

Учитывайте область данных:

• categories и brands относятся к текущему Application;
• countries — общий системный справочник;
• tags сейчас не ограничены Application;
• popular_requests собираются без фильтра по проекту или Application. Не показывайте их пользователям до появления изолированного контракта.

Запрашивайте только нужные наборы.

Ошибки

• 401 — App Token отсутствует или недействителен.