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

Остатки

Получение списка остатков (табличное представление)

Метод: GET
URL: https://beta.api.gigma.ru/tables/inventories
Авторизация: Bearer token

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

  • query - поисковая строка
  • owned_by_us - иерархия (принадлежность) склада: свой (true), чужой (false)
  • warehouse_id[] - массив ID складов, на которых хранится продукция. Для получение списка складов см. запрос
  • type_id[] - массив ID типов хранимой продукции. Для получения информации о возможных значениях см. запрос
  • city_id[] - массив ID городов. Для получения информации о возможных значениях см. запрос
  • brand_id[] - массив ID производителей. Для получения информации о возможных значениях см. запрос
  • vat_id[] - ID НДС. Для получения списка значения используйте запрос
  • application_id[] - ID приложения. Для получения списка значения используйте запрос

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

https://beta.api.gigma.ru/tables/inventories?owned_by_us=1&type_id[]=2&city_id[]=2&brand_id[]=16&vat_id[]=1&brand_id[]=17&application_id=23

Ответ

При успешном действии возвращается HTTP код 200. 

{
    "columns": [
        {
            "id": 96,
            "table_id": 13,
            "order": 0,
            "key": "code",
            "has_icon": 0,
            "text": "Код"
        },
        {
            "id": 97,
            "table_id": 13,
            "order": 1,
            "key": "name",
            "has_icon": 1,
            "text": "Наименование"
        },
        {
            "id": 98,
            "table_id": 13,
            "order": 2,
            "key": "warehouse",
            "has_icon": 0,
            "text": "Склад"
        },
        {
            "id": 99,
            "table_id": 13,
            "order": 3,
            "key": "city",
            "has_icon": 0,
            "text": "Город"
        },
        {
            "id": 100,
            "table_id": 13,
            "order": 4,
            "key": "brand",
            "has_icon": 0,
            "text": "Торговая марка"
        },
        {
            "id": 101,
            "table_id": 13,
            "order": 5,
            "key": "vat",
            "has_icon": 0,
            "text": "Ставка НДС"
        },
        {
            "id": 102,
            "table_id": 13,
            "order": 6,
            "key": "unit",
            "has_icon": 0,
            "text": "Ед. изм."
        },
        {
            "id": 103,
            "table_id": 13,
            "order": 7,
            "key": "quantity",
            "has_icon": 0,
            "text": "Кол-во"
        },
        {
            "id": 104,
            "table_id": 13,
            "order": 8,
            "key": "price",
            "has_icon": 0,
            "text": "Цена"
        },
        {
            "id": 105,
            "table_id": 13,
            "order": 9,
            "key": "country",
            "has_icon": 0,
            "text": "Страна"
        }
    ],
    "warehouseNomenclatures": [
        {
            "id": 1,
            "code": "123",
            "name": {
                "icon": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                "value": "BANILA CO Glow Fit Foundation Brush"
            },
            "warehouse": {
                "icon": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                "value": "Петухова"
            },
            "city": "Новосибирск",
            "brand": {
                "icon": "http:\/\/localhost:8000\/\/storage\/uploads\/default_brand.png",
                "value": "BANILA CO"
            },
            "vat": "20.00",
            "unit": "ед",
            "quantity": 5,
            "price": "204500.00",
            "country": "Россия"
        }
    ],
    "pagination": {
        "total": 58,
        "per_page": 1,
        "current_page": 1,
        "last_page": 58,
        "from": 1,
        "to": 1
    }
}

Описание полей ответа

  • columns - массив столбцов
  • pagination - объект с информацией, необходимой для пагинации
  • warehouseNomenclatures - массив объектов типа "Остатки"
  • name - название интеграции
  • avatar - URL-адрес фотографии
  • is_active - статус (false - неактивна; true - активна)

Получение списка остатков

Метод: GET
URL: https://beta.api.gigma.ru/inventories
Авторизация: Bearer token

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

  • query - поисковая строка
  • owned_by_us - иерархия (принадлежность) склада: свой (true), чужой (false)
  • warehouse_id[] - массив ID складов, на которых хранится продукция. Для получение списка складов см. запрос
  • type_id[] - массив ID типов хранимой продукции. Для получения информации о возможных значениях см. запрос
  • city_id[] - массив ID городов. Для получения информации о возможных значениях см. запрос
  • brand_id[] - массив ID производителей. Для получения информации о возможных значениях см. запрос
  • vat_id[] - ID НДС. Для получения списка значения используйте запрос

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

https://beta.api.gigma.ru/inventories?owned_by_us=1&type_id[]=2&city_id[]=2&brand_id[]=16&vat_id[]=1&brand_id[]=17

Ответ

При успешном действии возвращается HTTP код 200. 

{
    "inventories": [
        {
            "id": 65,
            "code": "12345",
            "avatar": {
                "id": 1,
                "name": "logo.svg",
                "type": {
                    "id": 1,
                    "name": "Трудовой договор",
                    "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                    "created_at": "2024-03-27T07:00:46.000000Z"
                },
                "path": "http:\/\/localhost:8000\/storage\/uploads\/yjohncMkjTSnvJ7FH4vksOtDYUy9pO2HDwmNU5Hc.svg",
                "created_at": "2024-04-14T20:04:32.000000Z",
                "updated_at": "2024-04-14T20:04:32.000000Z"
            },
            "warehouse": {
                "id": 2,
                "code": null,
                "name": "Ленина",
                "photo": {
                    "id": 1,
                    "name": "logo.svg",
                    "type": {
                        "id": 1,
                        "name": "Трудовой договор",
                        "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                        "created_at": "2024-03-27T07:00:46.000000Z"
                    },
                    "path": "http:\/\/localhost:8000\/storage\/uploads\/yjohncMkjTSnvJ7FH4vksOtDYUy9pO2HDwmNU5Hc.svg",
                    "created_at": "2024-04-14T20:04:32.000000Z",
                    "updated_at": "2024-04-14T20:04:32.000000Z"
                },
                "owned_by_us": true,
                "address": "Ленина 25",
                "storage_capacity": 100000,
                "storage_unit": {
                    "id": 2,
                    "name": "Кубический метр",
                    "abbreviation": "м³"
                },
                "city": {
                    "id": 2,
                    "name": "Новосибирск",
                    "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                    "created_at": "2024-04-19T09:18:41.000000Z"
                },
                "counterparty": null
            },
            "nomenclature": {
                "id": 75,
                "code": "12323",
                "name": "Товар 1",
                "avatar": {
                    "id": 46,
                    "name": "Typescript_logo_2020.svg.png",
                    "type": {
                        "id": 2,
                        "name": "Аватар",
                        "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                        "created_at": "2024-03-27T07:00:46.000000Z"
                    },
                    "path": "http:\/\/localhost:8000\/storage\/uploads\/lTZordmSio4H6LSsj9CyfKJJlhIOFHeOsr3xv5IX.png",
                    "created_at": "2024-06-19T13:44:23.000000Z",
                    "updated_at": "2024-06-19T13:44:23.000000Z"
                },
                "preview": {
                    "id": 46,
                    "name": "Typescript_logo_2020.svg.png",
                    "type": {
                        "id": 2,
                        "name": "Аватар",
                        "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                        "created_at": "2024-03-27T07:00:46.000000Z"
                    },
                    "path": "http:\/\/localhost:8000\/storage\/uploads\/lTZordmSio4H6LSsj9CyfKJJlhIOFHeOsr3xv5IX.png",
                    "created_at": "2024-06-19T13:44:23.000000Z",
                    "updated_at": "2024-06-19T13:44:23.000000Z"
                },
                "description": "Описание товара",
                "category": {
                    "id": 33,
                    "code": "2",
                    "name": "Уход за кожей лица",
                    "description": "Средства для ухода за кожей лица",
                    "parent": null,
                    "photo": null,
                    "avatar": null,
                    "tags": []
                },
                "specification": "Спецификации товара",
                "country": {
                    "id": 1,
                    "name": "Россия",
                    "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                    "created_at": "2024-04-10T06:59:28.000000Z"
                },
                "type": {
                    "id": 2,
                    "name": "Товар",
                    "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                    "created_at": "2024-07-08T07:01:41.000000Z"
                },
                "kind": {
                    "id": 2,
                    "name": "Товар",
                    "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                    "created_at": "2024-07-08T07:01:41.000000Z"
                },
                "branch": {
                    "id": 15,
                    "code": "1",
                    "avatar": {
                        "id": 759,
                        "name": "СМД 1.png",
                        "type": {
                            "id": 1,
                            "name": "Трудовой договор",
                            "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                            "created_at": "2024-03-27T07:00:46.000000Z"
                        },
                        "path": "http:\/\/localhost:8000\/storage\/uploads\/b9t9B4Y4Fq6dAKvgVW2vhzFJ12ZrgRgvVHdMnfjt.png",
                        "created_at": "2024-08-01T09:12:20.000000Z",
                        "updated_at": "2024-08-01T09:12:20.000000Z"
                    },
                    "title": "Торговля косметикой",
                    "inn": "930800053647",
                    "name": "ИП Дерюгин Дмитрий Александрович",
                    "responsible_user": null,
                    "kpp": "0",
                    "phone_1": "79493675745",
                    "phone_2": null,
                    "email": "4766014@mail.ru",
                    "head": null,
                    "address": "283045, Донецкая Народная респ, г Донецк, ул Профессоров Богославских, д 5а",
                    "legal_address": "283045, Донецкая Народная респ, г Донецк, ул Профессоров Богославских, д 5а",
                    "created_at": "2024-08-01T07:50:59.000000Z"
                },
                "tags": [],
                "photos": [],
                "unit": {
                    "id": 12,
                    "name": "Единица",
                    "abbreviation": "ед"
                },
                "brand": {
                    "id": 16,
                    "name": "Бренд 1",
                    "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                    "created_at": "2024-08-02T08:44:02.000000Z"
                },
                "created_at": "2024-04-19T09:18:41.000000Z",
                "updated_at": "2024-04-19T09:18:41.000000Z"
            },
            "quantity": 500,
            "price": "650.00",
            "discount": null,
            "vat": {
                "id": 1,
                "name": "Без НДС",
                "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                "created_at": "2024-08-12T08:51:40.000000Z"
            },
            "created_at": "2024-04-19T09:18:41.000000Z",
            "updated_at": "2024-04-19T09:18:41.000000Z"
        }
    ],
    "inventoriesCount": 1
}

Описание полей ответа

  • id - первичный ключ
  • code - внутренний код товара
  • warehouse - объект с информацией о складе
  • nomenclature - объект с информацией о номенклатурной позиции
  • quantity - кол-во товара
  • price - стоимость товара
  • discount - скидка
  • markup - наценка
  • created_at - дата/время добавления в систему
  • updated_at - дата/время последнего добавления в системе

Добавление остатков

Метод: POST
URL: https://beta.api.gigma.ru/inventories
Авторизация: Bearer token

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

  • code - код товара в системе
  • warehouse_id - ID склада. Для поиска по складам используйте запрос с параметром query
  • nomenclature_id - ID номенклатурной позиции. Для поиска по номенклатуре используйте запрос с параметром query
  • vat_id - ID НДС. Для получения списка значения используйте запрос
  • quantity - кол-во товара (целочисленное значение)
  • price - стоимость товара (числовой с точностью до двух знаков после запятой)
  • discount - скидка (целочисленное значение)
  • markup - наценка (целочисленное значение)

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

https://beta.api.gigma.ru/inventories 

{
    "code": 1127,
    "warehouse_id": 1,
    "nomenclature_id": 2,
    "vat_id": 1,
    "quantity": 10,
    "price": 100,
    "discount": 50,
    "markup": 10
}

Ответ

При успешном действии возвращается HTTP код 201.

{
    "inventory": {
        "id": 61,
        "code": 1127,
        "warehouse": {
            "id": 1,
            "photo": null,
            "owned_by_us": true,
            "address": "Петухова 155\/1 к4",
            "storage_capacity": 100000,
            "storage_unit": {
                "id": 2,
                "name": "Кубический метр",
                "abbreviation": "м³"
            },
            "city": {
                "id": 2,
                "name": "Новосибирск",
                "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                "created_at": "2024-04-19T09:18:41.000000Z"
            },
            "counterparty": null
        },
        "nomenclature": {
            "id": 2,
            "code": "72926",
            "name": "Tony Moly Soft Touch Air Puff 5P",
            "avatar": null,
            "preview": null,
            "description": "Tony Moly Soft Touch Air Puff 5P - это набор из пяти нежных помпонов для нанесения макияжа. Эти помпоны изготовлены из высококачественных материалов и обеспечивают идеальное нанесение косметики на кожу. ",
            "category": {
                "id": 14,
                "code": "123123",
                "name": "Тестовая 1",
                "description": "<p>Тестовое <strong>описание<\/strong><\/p>",
                "parent": null,
                "photo": {
                    "id": 199,
                    "name": "1687828420_sneg-top-p-avatarka-elektronika-pinterest-4.jpg",
                    "type": {
                        "id": 1,
                        "name": "Трудовой договор",
                        "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                        "created_at": "2024-03-27T07:00:46.000000Z"
                    },
                    "path": "http:\/\/localhost:8000\/storage\/uploads\/AIOmZpG52qm4FmDt0SWpUKXqtwsmjfZkkYVrvyXQ.jpg",
                    "created_at": "2024-07-09T09:59:39.000000Z",
                    "updated_at": "2024-07-09T09:59:39.000000Z"
                },
                "avatar": {
                    "id": 197,
                    "name": "1687828420_sneg-top-p-avatarka-elektronika-pinterest-4.jpg",
                    "type": {
                        "id": 2,
                        "name": "Аватар",
                        "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                        "created_at": "2024-03-27T07:00:46.000000Z"
                    },
                    "path": "http:\/\/localhost:8000\/storage\/uploads\/Cphy2sN5FyeqU7akn03Nwq1nx48hrSKDlSVBi8jf.jpg",
                    "created_at": "2024-07-09T09:59:22.000000Z",
                    "updated_at": "2024-07-09T09:59:22.000000Z"
                },
                "tags": [
                    {
                        "id": 4,
                        "name": "Хит лета",
                        "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                        "created_at": "2024-04-10T07:03:08.000000Z"
                    }
                ]
            },
            "specification": null,
            "type": {
                "id": 2,
                "name": "Товар",
                "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                "created_at": "2024-07-08T07:01:41.000000Z"
            },
            "kind": {
                "id": 2,
                "name": "Товар",
                "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                "created_at": "2024-07-08T07:01:41.000000Z"
            },
            "branch": {
                "id": 1,
                "code": "12334",
                "avatar": {
                    "id": 40,
                    "name": "organic-cosmetics_icon-icons.com_49218.png",
                    "type": {
                        "id": 1,
                        "name": "Трудовой договор",
                        "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                        "created_at": "2024-03-27T07:00:46.000000Z"
                    },
                    "path": "http:\/\/localhost:8000\/storage\/uploads\/organic-cosmetics_icon-icons.com_49218.png",
                    "created_at": "2024-06-17T16:05:02.000000Z",
                    "updated_at": "2024-06-17T16:05:02.000000Z"
                },
                "title": "Продажа косметики1123",
                "inn": "5403057658",
                "name": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"АЙТЕКО\"",
                "responsible_user": {
                    "id": 2,
                    "first_name": "Алексей",
                    "last_name": "Жуков",
                    "middle_name": "Игоревич",
                    "name": "Жуков Алексей"
                },
                "kpp": "540301001",
                "phone_1": "79139121349",
                "phone_2": "71231231231",
                "email": "2141349@mail.ru",
                "head": "Снегирёв Алексей Игоревич",
                "address": "630073, Новосибирская область, город Новосибирск, Новогодняя ул., д. 20\/1, кв. 26",
                "legal_address": "630073, Новосибирская область, город Новосибирск, Новогодняя ул., д. 20\/1, кв. 26",
                "created_at": "2024-03-27T07:26:29.000000Z"
            },
            "tags": [],
            "photos": [
                {
                    "id": 14,
                    "name": "full_covericious_glow_fit_foundation_spf25_pa__23_peanut.jpg",
                    "type": {
                        "id": 1,
                        "name": "Трудовой договор",
                        "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                        "created_at": "2024-03-27T07:00:46.000000Z"
                    },
                    "path": "http:\/\/localhost:8000\/storage\/uploads\/full_covericious_glow_fit_foundation_spf25_pa__23_peanut.jpg",
                    "created_at": "2024-04-14T20:04:32.000000Z",
                    "updated_at": "2024-04-14T20:04:32.000000Z"
                }
            ],
            "created_at": "2024-04-10T07:03:08.000000Z",
            "updated_at": "2024-04-10T07:03:08.000000Z"
        },
        "quantity": 10,
        "price": 100,
        "discount": 50,
        "vat": {
            "id": 1,
            "name": "Без НДС",
            "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
            "created_at": "2024-08-12T08:51:40.000000Z"
        },
        "created_at": "2024-07-15T10:38:02.000000Z",
        "updated_at": "2024-07-15T10:38:02.000000Z"
    }
}

Описание полей ответа

  • id - первичный ключ
  • code - внутренний код товара
  • warehouse - объект с информацией о складе
  • nomenclature - объект с информацией о номенклатурной позиции
  • quantity - кол-во товара
  • price - стоимость товара
  • discount - скидка
  • markup - наценка
  • created_at - дата/время добавления в систему
  • updated_at - дата/время последнего добавления в системе

Обновление остатков

Метод: PUT
URL: https://beta.api.gigma.ru/inventories/{id}
Авторизация: Bearer token

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

  • code - код товара в системе
  • warehouse_id - ID склада. Для поиска по складам используйте запрос с параметром query
  • nomenclature_id - ID номенклатурной позиции. Для поиска по номенклатуре используйте запрос с параметром query
  • vat_id - ID НДС. Для получения списка значения используйте запрос
  • quantity - кол-во товара (целочисленное значение)
  • price - стоимость товара (числовой с точностью до двух знаков после запятой)
  • discount - скидка (целочисленное значение)
  • markup - наценка (целочисленное значение)

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

https://beta.api.gigma.ru/inventories/61 

{
    "code": 1127,
    "nomenclature_id": 2,
    "vat_id": 1,
    "quantity": 10,
    "price": 100,
    "discount": 50,
    "markup": 10
}

Ответ

При успешном действии возвращается HTTP код 200.

{
    "inventory": {
        "id": 61,
        "code": 1127,
        "warehouse": {
            "id": 1,
            "photo": null,
            "owned_by_us": true,
            "address": "Петухова 155\/1 к4",
            "storage_capacity": 100000,
            "storage_unit": {
                "id": 2,
                "name": "Кубический метр",
                "abbreviation": "м³"
            },
            "city": {
                "id": 2,
                "name": "Новосибирск",
                "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                "created_at": "2024-04-19T09:18:41.000000Z"
            },
            "counterparty": null
        },
        "nomenclature": {
            "id": 2,
            "code": "72926",
            "name": "Tony Moly Soft Touch Air Puff 5P",
            "avatar": null,
            "preview": null,
            "description": "Tony Moly Soft Touch Air Puff 5P - это набор из пяти нежных помпонов для нанесения макияжа. Эти помпоны изготовлены из высококачественных материалов и обеспечивают идеальное нанесение косметики на кожу. ",
            "category": {
                "id": 14,
                "code": "123123",
                "name": "Тестовая 1",
                "description": "<p>Тестовое <strong>описание<\/strong><\/p>",
                "parent": null,
                "photo": {
                    "id": 199,
                    "name": "1687828420_sneg-top-p-avatarka-elektronika-pinterest-4.jpg",
                    "type": {
                        "id": 1,
                        "name": "Трудовой договор",
                        "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                        "created_at": "2024-03-27T07:00:46.000000Z"
                    },
                    "path": "http:\/\/localhost:8000\/storage\/uploads\/AIOmZpG52qm4FmDt0SWpUKXqtwsmjfZkkYVrvyXQ.jpg",
                    "created_at": "2024-07-09T09:59:39.000000Z",
                    "updated_at": "2024-07-09T09:59:39.000000Z"
                },
                "avatar": {
                    "id": 197,
                    "name": "1687828420_sneg-top-p-avatarka-elektronika-pinterest-4.jpg",
                    "type": {
                        "id": 2,
                        "name": "Аватар",
                        "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                        "created_at": "2024-03-27T07:00:46.000000Z"
                    },
                    "path": "http:\/\/localhost:8000\/storage\/uploads\/Cphy2sN5FyeqU7akn03Nwq1nx48hrSKDlSVBi8jf.jpg",
                    "created_at": "2024-07-09T09:59:22.000000Z",
                    "updated_at": "2024-07-09T09:59:22.000000Z"
                },
                "tags": [
                    {
                        "id": 4,
                        "name": "Хит лета",
                        "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                        "created_at": "2024-04-10T07:03:08.000000Z"
                    }
                ]
            },
            "specification": null,
            "type": {
                "id": 2,
                "name": "Товар",
                "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                "created_at": "2024-07-08T07:01:41.000000Z"
            },
            "kind": {
                "id": 2,
                "name": "Товар",
                "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                "created_at": "2024-07-08T07:01:41.000000Z"
            },
            "branch": {
                "id": 1,
                "code": "12334",
                "avatar": {
                    "id": 40,
                    "name": "organic-cosmetics_icon-icons.com_49218.png",
                    "type": {
                        "id": 1,
                        "name": "Трудовой договор",
                        "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                        "created_at": "2024-03-27T07:00:46.000000Z"
                    },
                    "path": "http:\/\/localhost:8000\/storage\/uploads\/organic-cosmetics_icon-icons.com_49218.png",
                    "created_at": "2024-06-17T16:05:02.000000Z",
                    "updated_at": "2024-06-17T16:05:02.000000Z"
                },
                "title": "Продажа косметики1123",
                "inn": "5403057658",
                "name": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"АЙТЕКО\"",
                "responsible_user": {
                    "id": 2,
                    "first_name": "Алексей",
                    "last_name": "Жуков",
                    "middle_name": "Игоревич",
                    "name": "Жуков Алексей"
                },
                "kpp": "540301001",
                "phone_1": "79139121349",
                "phone_2": "71231231231",
                "email": "2141349@mail.ru",
                "head": "Снегирёв Алексей Игоревич",
                "address": "630073, Новосибирская область, город Новосибирск, Новогодняя ул., д. 20\/1, кв. 26",
                "legal_address": "630073, Новосибирская область, город Новосибирск, Новогодняя ул., д. 20\/1, кв. 26",
                "created_at": "2024-03-27T07:26:29.000000Z"
            },
            "tags": [],
            "photos": [
                {
                    "id": 14,
                    "name": "full_covericious_glow_fit_foundation_spf25_pa__23_peanut.jpg",
                    "type": {
                        "id": 1,
                        "name": "Трудовой договор",
                        "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                        "created_at": "2024-03-27T07:00:46.000000Z"
                    },
                    "path": "http:\/\/localhost:8000\/storage\/uploads\/full_covericious_glow_fit_foundation_spf25_pa__23_peanut.jpg",
                    "created_at": "2024-04-14T20:04:32.000000Z",
                    "updated_at": "2024-04-14T20:04:32.000000Z"
                }
            ],
            "created_at": "2024-04-10T07:03:08.000000Z",
            "updated_at": "2024-04-10T07:03:08.000000Z"
        },
        "quantity": 10,
        "price": 100,
        "discount": 50,
        "vat": {
            "id": 1,
            "name": "Без НДС",
            "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
            "created_at": "2024-08-12T08:51:40.000000Z"
        },
        "created_at": "2024-07-15T10:38:02.000000Z",
        "updated_at": "2024-07-15T10:38:02.000000Z"
    }
}

Описание полей ответа

Возвращаемые поля аналогичны запросу.

Получение выбранных остатков

Метод: GET
URL: https://beta.api.gigma.ru/inventories/{id}
Авторизация: Bearer token

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

Параметры не передаются.

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

https://beta.api.gigma.ru/inventories/71

Ответ

При успешном действии возвращается HTTP код 200. 

{
    "inventory": {
        "id": 1,
        "code": "123",
        "warehouse": {
            "id": 1,
            "photo": null,
            "owned_by_us": true,
            "address": "Петухова 155\/1 к4",
            "storage_capacity": 100000,
            "storage_unit": {
                "id": 2,
                "name": "Кубический метр",
                "abbreviation": "м³"
            },
            "city": {
                "id": 2,
                "name": "Новосибирск",
                "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                "created_at": "2024-04-19T09:18:41.000000Z"
            },
            "counterparty": null
        },
        "nomenclature": {
            "id": 1,
            "code": "72925",
            "name": "BANILA CO Glow Fit Foundation Brush",
            "avatar": null,
            "preview": null,
            "description": "<!DOCTYPE HTML>\n<html lang=\"en\">\n  <head>\n  <meta charset=\"utf-8\">\n  <meta name=\"description\" content=\"A page for exploring basic HTML documents\">\n  <title>Basic HTML document<\/title>\n  <\/head>\n  <body>\n    <h1>Page content<\/h1>\n    <p>The main page content appears inside the <b>body<\/b> tag. HTML contains several elements that allow you to properly structure and format your content, which we'll cover later.<\/p>\n  <\/body>\n<\/html>",
            "category": {
                "id": 29,
                "code": "423234234",
                "name": "Новая категория2",
                "description": "<p>Новая категория<\/p>",
                "parent": null,
                "photo": {
                    "id": 201,
                    "name": "maxresdefault.jpg",
                    "type": {
                        "id": 1,
                        "name": "Трудовой договор",
                        "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                        "created_at": "2024-03-27T07:00:46.000000Z"
                    },
                    "path": "http:\/\/localhost:8000\/storage\/uploads\/BQkFOnPzUO962QOKLrwwC6cgRgPbcyb72zJkU84N.jpg",
                    "created_at": "2024-07-09T10:02:41.000000Z",
                    "updated_at": "2024-07-09T10:02:41.000000Z"
                },
                "avatar": {
                    "id": 200,
                    "name": "maxresdefault.jpg",
                    "type": {
                        "id": 2,
                        "name": "Аватар",
                        "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                        "created_at": "2024-03-27T07:00:46.000000Z"
                    },
                    "path": "http:\/\/localhost:8000\/storage\/uploads\/oeIC8oaoC0b75dyCBEESk5vdnCjJZd89lNvkn8ce.jpg",
                    "created_at": "2024-07-09T10:01:54.000000Z",
                    "updated_at": "2024-07-09T10:01:54.000000Z"
                },
                "tags": [
                    {
                        "id": 6,
                        "name": "Философский камень",
                        "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                        "created_at": "2024-04-10T07:03:08.000000Z"
                    },
                    {
                        "id": 5,
                        "name": "Вечная молодость",
                        "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                        "created_at": "2024-04-10T07:03:08.000000Z"
                    },
                    {
                        "id": 4,
                        "name": "Хит лета",
                        "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                        "created_at": "2024-04-10T07:03:08.000000Z"
                    }
                ]
            },
            "specification": null,
            "type": {
                "id": 2,
                "name": "Товар",
                "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                "created_at": "2024-07-08T07:01:41.000000Z"
            },
            "kind": {
                "id": 2,
                "name": "Товар",
                "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                "created_at": "2024-07-08T07:01:41.000000Z"
            },
            "branch": {
                "id": 1,
                "code": "12334",
                "avatar": {
                    "id": 40,
                    "name": "organic-cosmetics_icon-icons.com_49218.png",
                    "type": {
                        "id": 1,
                        "name": "Трудовой договор",
                        "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                        "created_at": "2024-03-27T07:00:46.000000Z"
                    },
                    "path": "http:\/\/localhost:8000\/storage\/uploads\/organic-cosmetics_icon-icons.com_49218.png",
                    "created_at": "2024-06-17T16:05:02.000000Z",
                    "updated_at": "2024-06-17T16:05:02.000000Z"
                },
                "title": "Продажа косметики1123",
                "inn": "5403057658",
                "name": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"АЙТЕКО\"",
                "responsible_user": {
                    "id": 2,
                    "first_name": "Алексей",
                    "last_name": "Жуков",
                    "middle_name": "Игоревич",
                    "name": "Жуков Алексей"
                },
                "kpp": "540301001",
                "phone_1": "79139121349",
                "phone_2": "71231231231",
                "email": "2141349@mail.ru",
                "head": "Снегирёв Алексей Игоревич",
                "address": "630073, Новосибирская область, город Новосибирск, Новогодняя ул., д. 20\/1, кв. 26",
                "legal_address": "630073, Новосибирская область, город Новосибирск, Новогодняя ул., д. 20\/1, кв. 26",
                "created_at": "2024-03-27T07:26:29.000000Z"
            },
            "tags": [],
            "photos": [
                {
                    "id": 18,
                    "name": "image_2024-05-21_14-24-32.png",
                    "type": {
                        "id": 3,
                        "name": "Документ к заказу",
                        "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
                        "created_at": "2024-03-27T07:00:46.000000Z"
                    },
                    "path": "http:\/\/localhost:8000\/storage\/uploads\/image_2024-05-21_14-24-32.png",
                    "created_at": "2024-04-14T20:04:32.000000Z",
                    "updated_at": "2024-04-14T20:04:32.000000Z"
                }
            ],
            "created_at": "2024-04-10T07:03:08.000000Z",
            "updated_at": "2024-04-10T07:03:08.000000Z"
        },
        "quantity": 5,
        "price": "204500.00",
        "discount": 0,
        "vat": {
            "id": 1,
            "name": "Без НДС",
            "avatar": "http:\/\/localhost:8000\/storage\/uploads\/default.svg",
            "created_at": "2024-08-12T08:51:40.000000Z"
        },
        "created_at": "2024-04-10T07:03:08.000000Z",
        "updated_at": "2024-04-10T07:03:08.000000Z"
    }
}

Описание полей ответа

Возвращаемые поля аналогичны запросу.

Получение истории изменений

Метод: GET
URL: https://beta.api.gigma.ru/inventories/{id}/history
Авторизация: Bearer token

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

Параметры не передаются.

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

https://beta.api.gigma.ru/inventories/7/history

Ответ

При успешном действии возвращается HTTP код 200. 

{
    "histories": [
        {
            "id": 283,
            "icon": "check",
            "color": "primary",
            "title": "Создание",
            "description": "Создание: Полищук Артём",
            "datetime": "15.07.2024 05:46"
        },
        {
            "id": 284,
            "icon": "edit",
            "color": "success",
            "title": "Редактирование",
            "description": "Редактирование: Полищук Артём",
            "datetime": "15.07.2024 07:06"
        }
    ],
    "historiesCount": 2
}

Описание полей ответа
  • id - первичный ключ
  • icon - иконка
  • color - цвет
  • title - заголовок
  • description - описание
  • datetime - дата выполнения действия

Раздел "Экспорт/Импорт"

Импорт файла с перечнем остатков

Метод: POST
URL: https://beta.api.gigma.ru/inventories/upload
Авторизация: Bearer token

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

  • file - файл в разрешении ".xmr". Формат файла: https://disk.yandex.com/d/MJ8iDXPuGeijfA

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

https://beta.api.gigma.ru/inventories/upload
Content-Type: multipart/form-data file => FILE

Ответ

{
    "message": "Import successful"
}
Описание полей ответа
  • message - информационное поле