Перейти к содержанию

Перемещения

Перемещения товара между складами. Только чтение.

Перемещение · movement

GET /api/movements

Список записей с постраничной выборкой.

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

Параметр Тип Ограничения
limit int диапазон 1..50, по умолчанию 50
offset int по умолчанию 0
dateFrom date формат YYYY-MM-DD
dateTo date формат YYYY-MM-DD
status int значения 0, 1, не передан — вернутся все

Коды ответа

Код Что значит
200 успешный
401 нет доступа: ключ не передан, просрочен или неверен
400 неверный запрос: не хватает параметра или он не того типа

Поля ответа

Поле Тип Значение
meta object Метаданные о выдаче
meta.allCount int Количество всех элементов
meta.count int Размер выданного списка
meta.limit int Максимальное количество элементов в выданном списке. Максимальное количество элементов в списке равно 50.
meta.offset int Отступ в выданном списке
data array (object) Массив JSON объектов, представляющих собой перемещение.
data[].id int Идентификатор документа
data[].type string Тип документа (Значения: movement)
data[].status int Статус документа (0 - Не проведено, 1 - Проведено)
data[].number string Номер документа
data[].date string Дата документа (Формат: ГГГГ-ММ-ДД)
data[].from_stock object Со склада
data[].from_stock.id int Идентификатор склада
data[].from_stock.name string Наименование склада
data[].to_stock object На склад
data[].to_stock.id int Идентификатор склада
data[].to_stock.name string Наименование склада
data[].comment string Комментарий
data[].user object Фактический адрес
data[].user.id int Идентификатор пользователя
data[].user.type string Тип пользователя ('admin' - Администратор, 'user' - Сотрудник)
data[].user.name string Наименование пользователя
data[].created string Дата и время создания документа (Формат: ГГГГ-ММ-ДД ЧЧ:ММ:СС)
data[].edited string Дата и время изменения документа (Формат: ГГГГ-ММ-ДД ЧЧ:ММ:СС)
data[].sum float Общая сумма документа
data[].products array (object) Массив товаров
data[].products.pr_id int Идентификатор товара
data[].products.pr_name string Наименование товара
data[].products.pr_sku string Артикул товара
data[].products.pr_count float Количество товара
data[].products.pr_unit object Ед. измерения
data[].products.pr_unit.name string Наименование ед. измерения
data[].products.pr_unit.code string Код ед. измерения
data[].products.pr_price float Цена товара

Ошибки

ERROR_LIMIT ERROR_OFFSET ERROR_DATEFROM ERROR_DATETO ERROR_STATUS ERROR_USER_ACCESS ERROR_NO_API_KEY

Запрос получения списка перемещений 
Host: app.masterkassa.com

GET /api/movements?limit=10&offset=20&dateFrom=2025-05-12&dateTo=2025-09-12

Authorization: Bearer <ключ>
Ответ получения списка перемещений 
HTTP code: 200

{
  "meta": {
    "allCount": "26",
    "count": 1,
    "limit": 1,
    "offset": 0
  },
  "data": [
    {
      "id": 2,
      "type": "movement",
      "status": "1",
      "number": "1",
      "date": "2023-07-17",
      "from_stock": {
        "id": 1,
        "name": "Склад N1"
      },
      "to_stock": {
        "id": 2,
        "name": "Склад N2"
      },
      "comment": "",
      "user": {
        "type": "admin",
        "id": 1,
        "name": "Петров П. П."
      },
      "created": "2023-07-17 12:58:23",
      "edited": "2023-07-17 12:58:23",
      "sum": 156748,
      "products": [
        {
          "pr_id": 15009,
          "pr_name": "Арматура гладкая А1 6 мм1111",
          "pr_sku": "15009",
          "pr_count": 1,
          "pr_unit": {
            "name": "т",
            "code": "168"
          },
          "pr_price": 47600
        },
        {
          "pr_id": 12,
          "pr_name": "Арматура гладкая А1 8 мм",
          "pr_sku": "00139",
          "pr_count": 1,
          "pr_unit": {
            "name": "т",
            "code": "168"
          },
          "pr_price": 59190
        },
        {
          "pr_id": 16,
          "pr_name": "Арматура гладкая А1  10 мм",
          "pr_sku": "00140",
          "pr_count": 1,
          "pr_unit": {
            "name": "т",
            "code": "168"
          },
          "pr_price": 49958
        }
      ]
    }
  ]
}