Базовый URL: https://plat-forma.com/pf_api/api.php
Авторизация проходит через X-Auth-Token: cGxhdC1mb3JtYWNybTEyMzo
Авторизация через логин/пароль пользователя:
Добавляет новую товарную позицию на склад. Если товар с таким ID уже существует на складе — обновляет его количество и цены.
1.1 Одна товарная позиция за одно обращение:
| Content-Type | application/json |
| Тело запроса: |
{ |
| Все поля: |
id_sklad_pf - ID Склада Платформа (положительное целое число) |
| Успешный ответ (200): | { "success": true, "message": "Данные успешно добавлены", "insert_id": 12345 } |
1.2 Массовое добавление товарных позиций (до 1000 за одно обращение):
| Content-Type | application/json |
| Тело запроса: | { "batch": [ { "id_sklad_pf": 1001, "id_tovar": 2001, "item_qty": 505 }, { "id_sklad_pf": 1002, "id_tovar": 2002, "item_qty": 303 } ] } |
| Все поля: |
id_sklad_pf - ID Склада Платформа (положительное целое число) |
| Успешный ответ (200): | { "success": true, "message": "Данные успешно добавлены", "insert_id": 12345 } |
Ошибки:
400 - Невалидные параметры
403 - Неверный токен аутентификации
409 - Дублирующаяся запись
429 - Превышен лимит запросов
500 - Ошибка сервера
2. Добавление товарной позиции (GET)
| Параметры: | ?id_sklad_pf=2&id_tovar=123&item_qty=10 &item_price_retail=100.50&item_price_wholesale=80.00 &is_item_damaged=0&coords=55.638892,37.694845&id_post=5 |
| Ответ | fналогичен POST |
| Добавление товара (cURL) |
Одиночная операция Массовая загрузка |
| Добавление товара (JS) |
const response = await fetch('https://plat-forma.com/pf_api/api.php', { const result = await response.json(); Массовая загрузка: const response = await fetch('https://plat-forma.com/pf_api/api.php', { const result = await response.json(); |
Ограничения:
Формат данных: JSON для POST, параметры URL для GET
Описание функционала.
1. Перед загрузкой все данные удаляются
2. В профиле пользователя проставляется время жизни остатков
Альтернативный метод импорта через отправку xls на почту import@plat-forma.com