get.products.list — Перегляд списку: Товари

Призначення

Повертає список записів довідника Товари.

HTTP

• URL: https://api13.arm20.com/
• Метод: POST
• Content-Type: application/json

Авторизація

• Логін/пароль (як в онлайн статистиці): так.
• meta.user_card: обов’язково.

Параметри params

Поле	Тип	Обовʼязково	Опис

| limit | int | ні | Кількість рядків. За замовчуванням 100. Максимум 5000. |

| offset | int | ні | Зсув для пагінації. За замовчуванням 0. |

| q | string | ні | Пошуковий рядок (LIKE). Підтримувані поля залежать від довідника. |

| filters | object | ні | Точні фільтри поле=значення. Дозволені поля залежать від довідника. |

| order_by | string | ні | Поле сортування (якщо підтримується довідником). |

| order_dir | string | ні | Напрям сортування: ASC або DESC. |

| with_total | bool | ні | Якщо true, у відповіді буде total (може бути повільно). |

Що повертає метод

У result.items[] повертаються поля:

Code, Nt, Ss, Nac, Price, Ei, Quant, Dateadded, Sh, Post, PostName, Crit, Cat, CatName, Noskid, C2, Incloud, Dopinf

Примітки

• Повертає товари з таблиці Main з приєднанням назв постачальника (Post.Nt) та категорії (Cat1.Cat1).

• Пошук q виконується по Main.Code та Main.Nt (LIKE).

• Дозволені фільтри: Code, Post, Cat, Noskid, Incloud, C2.

Приклад запиту

Мокап: mockups/dictionaries/products/get.list/request.json

{
  "auth": {
    "login": "<LOGIN>",
    "password": "<PASSWORD>"
  },
  "method": "get.products.list",
  "params": {
    "limit": 50,
    "offset": 0,
    "q": "молоко",
    "filters": {
      "Cat": 0
    },
    "order_by": "Code",
    "order_dir": "ASC",
    "with_total": true
  },
  "meta": {
    "user_card": "<USER_CARD>",
    "client_name": "MyIntegration",
    "client_version": "1.0.0"
  },
  "id": "products-list-001"
}

Приклад відповіді (успіх)

Мокап: mockups/dictionaries/products/get.list/response.ok.json

{
  "ok": true,
  "result": {
    "items": [
      {
        "...": "..."
      }
    ],
    "limit": 50,
    "offset": 0,
    "count": 1,
    "total": 1
  },
  "meta": {
    "api_version": "0.1.0",
    "ts": "2026-01-26T12:00:00+00:00"
  },
  "id": "products-list-001"
}

Типові помилки

• AUTH_REQUIRED / AUTH_FAILED — проблеми з логіном/паролем.
• UNAUTHORIZED — проблема з meta.user_card.
• INVALID_FILTERS / INVALID_FILTER_FIELD — неправильні фільтри.