Создание заявки

Процесс создания заявки

Данные для формы

Request

  • HTTP Method: GET
  • Content Type: application/json
  • URL: https://api.skladbot.ru/v1/requests/form-data

Header Parameters

PropertyDescription
Authorizationstring
API-ключ.

Примеры ответа

{
    "requestTypes": [
        {
            "id": 1,
            "name": "Приёмка на склад",
            "code": "warehouse_acceptance",
            "settings": {
                "hide_for_customers": false,
                "upload_cis": false,
                "comment": null
            },
            "fields": [
                {
                    "field": "product_arrival_date",
                    "name": "Примерная дата прихода",
                    "required": false,
                    "marketplace": null,
                    "params": null
                },
                {
                    "field": "marketplace_warehouse",
                    "name": "Склад МП",
                    "required": true,
                    "marketplace": null,
                    "params": null
                }
            ]
        }
    ],
    "customers": [
        { "text": "ООО Альфа", "value": 1 }
    ],
    "utils": {
        "marketplaces": [
            { "text": "Wildberries", "value": 1 },
            { "text": "Ozon", "value": 2 }
        ],
        "marketplaceWarehouses": [
            { "text": "МСК Коледино", "value": 10, "marketplace": 1, "customer": null, "is_active": 1 }
        ],
        "warehouses": [
            { "text": "Основной склад", "value": 1 }
        ],
        "productNomenclatures": [
            { "text": "Пакет 30x40 (5.50)", "value": 3 }
        ],
        "serviceNomenclatures": [
            { "text": "Перемаркировка (120.00)", "value": 7 }
        ]
    }
}

Создать заявку

Request

  • HTTP Method: POST
  • Content Type: application/json
  • URL: https://api.skladbot.ru/v1/requests

Header Parameters

PropertyDescription
Authorizationstring
API-ключ.

Request Body Raw Schema: application/json

PropertyDescription
customer_id
required		Integer
ID клиента
request_type_id
required		Integer
ID типа заявки. Должны быть настроены этапы
prev_request_id
optional		Integer
ID предыдущей заявки. Штрихкоды товаров наследуются
comment
optional		String
Комментарий. Максимум 500 символов
products
required		Array
Список товаров. Минимум один элемент
products.*.product_data_id
required		Integer
ID товара из product_data
products.*.amount
optional		Numeric
Количество. Обязательность зависит от настроек типа заявки
products.*.barcode
optional		String
Штрихкод. Игнорируется если is_main_barcode = true
products.*.is_main_barcode
optional		Boolean
Если true — штрихкод не сохраняется
products.*.services
optional		Array
ID услуг из service_nomenclatures
products.*.packages
optional		Array
ID упаковок из product_nomenclatures
products.*.comment
optional		String
Комментарий к позиции. Максимум 255 символов
fields.*
optional		Object
Динамические поля формы. Ключи — коды полей из requestTypes[].fields, каждое содержит ключ value. Обязательность определяется настройками типа заявки

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

{
    "customer_id": 1,
    "request_type_id": 1,
    "prev_request_id": null,
    "comment": "Доп. комментарий",
    "products": [
        {
            "product_data_id": 42,
            "amount": 10,
            "barcode": "4607088001234",
            "is_main_barcode": false,
            "services": [7],
            "packages": [3],
            "comment": "Хрупкое"
        }
    ],
    "fields": {
        "product_arrival_date": { "value": "2026-06-01" },
        "marketplace": { "value": 1 },
        "marketplace_warehouse": { "value": 10 }
    }
}

Примеры ответа

{
    "data": {
        "id": 123,
        "delivery_number": "1-123",
        "customer_id": 1,
        "request_type_id": 1,
        "created_at": "2026-06-01T10:00:00.000000Z"
    }
}