0

Импорт данных по ценам / остатками товаров и услуг


Базовый URL: https://plat-forma.com/pf_api/api.php

Авторизация:

Авторизация проходит через X-Auth-Token: cGxhdC1mb3JtYWNybTEyMzo

Авторизация по догину - паролю пользователя. 

Методы API

1.  Добавление товарной позиции (POST)

Добавляет новую товарную позицию на склад.

Описать количество данных за 1 обращение

Content-Type application/json
Тело запроса: {
    "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
}
Обязательные поля:  id_sklad_pf - ID Склада Платформа (положительное целое число)
 id_tovar - ID товара Платформа (положительное целое число)
 item_qty - Количество товара (положительное целое число)
Опциональные поля: item_price_retail - Розничная цена (число ≥ 0)
item_price_wholesale - Мелкий опт (число ≥ 0)
is_item_damaged - Товар c повреждениями (0 или 1)
coords - Координаты склада (строка)
id_post - ID учетной системы поставщика (целое число)
item_cost - Себестоимость (число ≥ 0)
item_distributor - Дистрибьютор (строка)
tem_dealer - Дилер (строка)    
item_big_wholesale - Крупный опт (число ≥ 0)   
item_mid_wholesale - Средний опт (число ≥ 0)  
item_price_base - Базовая цена (число ≥ 0)   
party_size - Размер партии (число ≥ 0)
Успешный ответ (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)  curl -X POST "https://plat-forma.com/pf_api/api.php" \
  -H "X-Auth-Token: cGxhdC1mb3JtYWNybTEyMzo" \
  -H "Content-Type: application/json" \
  -d '{
    "id_sklad_pf": 2,
    "id_tovar": 1001,
    "item_qty": 50,
    "item_price_retail": 2999.99,
    "item_price_wholesale": 2500.00,
    "is_item_damaged": 0,
    "coords": "55.638892,37.694845",
    "id_post": 15
  }'
Добавление товара (JS)

const response = await fetch('https://plat-forma.com/pf_api/api.php', {
  method: 'POST',
  headers: {
    'X-Auth-Token': 'cGxhdC1mb3JtYWNybTEyMzo',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    id_sklad_pf: 2,
    id_tovar: 1001,
    item_qty: 50,
    item_price_retail: 2999.99,
    item_price_wholesale: 2500.00,
    is_item_damaged: 0,
    coords: "55.638892,37.694845",
    id_post: 15
  })
});

const result = await response.json();
console.log(result);

Ограничения:
Rate limiting: 1 запрос в 6 секунд с одного IP
Формат данных: JSON для POST, параметры URL для GET 

Описание функционала.

1. Перед загрузкой все данные удаляются 

2. В профиле пользователя проставляется время жизни остатков 

Альтернативный метод импорта через отправку xls на почту import@plat-forma.com

×