📦 API Документация сервиса заказов

⚠️ Важно! Перед началом работы с сервисом, необходимо обратиться к закрепленному сотруднику, который зарегистрирует вас в системе.

🔐 В качестве авторизации в сервисе используется пара email/password.

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

POST https://api.kakchasy.ru/api/login

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

# Запрос на получение токена
postman request POST 'https://api.kakchasy.ru/api/login' \
  --header 'Content-Type: application/json' \
  --body '{
    "email": "email@yandex.ru",
    "password": "yourpass"
}'

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

{
    "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJmcmVzaCI6ZmFsc2UsImlhdCI6MTc3MTM5MzYwOSwianRpIjoiZTNjODZhMDgtMThiOC00NDIyLTlmYjAtYWQ1OTg1Yjc3ZWIyIiwidHlwZSI6ImFjY2VzcyIsInN1YiI6IjIiLCJuYmYiOjE3NzEzOTM2MDksImNzcmYiOiI4YjVjYTNmNy04Y2M5LTRiNWEtOTc4MC0xMjg5YzA4ZjQ4MGUiLCJleHAiOjE3NzE0ODAwMDl9.97Qimotv4pxLeLuhh4i8_59yvdenltjqRKtw-jbUDCg",
    "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJmcmVzaCI6ZmFsc2UsImlhdCI6MTc3MTM5MzYwOSwianRpIjoiOWFhNDZlZjItMzZhZi00OTQzLTg5Y2YtYzZhYzJiNWU5MTU3IiwidHlwZSI6InJlZnJlc2giLCJzdWIiOjIsIm5iZiI6MTc3MTM5MzYwOSwiY3NyZiI6ImFmMTNkNDc3LTcxODYtNDRiMC1iZjFkLTViMTI0OGMxMGNmOSIsImV4cCI6MTc3Mzk4NTYwOX0.BcjV75GHowM1q6sij4IlVX9pPc2rbkhwU7Byj-szvR4"
}
📌 Примечание: Полученный access_token используется при вызове всех последующих методов. Токен передается в заголовке Authorization: Bearer <token>

🛒 Методы работы с заказами

1. Создать заявку на покупку

POST https://api.kakchasy.ru/api/orders order_type_id: 1 
# Создание заявки на покупку
postman request POST 'https://api.kakchasy.ru/api/orders' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...' \
  --body '{
    "order_type_id": 1,
    "order_date": "2026-02-18",
    "covname": "БИЗНЕС ГИФТС ООО",
    "cov_inn": "9715206895",
    "est_date": "2026-02-28",
    "items": [
        {
            "articul": "1745-005",
            "film_name": "КРАСАВИЦА | КРАСАВИЦА",
            "good_name": "КРАСАВИЦА _ Варежки",
            "good_um": "шт.",
            "good_cnt": 30,
            "good_price": 100.0,
            "good_summa": 3000.0
        }
    ]
}'

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

{
    "msg": "Заявка на покупку создана",
    "order_id": 52
}

2. Создать заявку на доставку

POST https://api.kakchasy.ru/api/orders order_type_id: 2 
# Создание заявки на доставку
postman request POST 'https://api.kakchasy.ru/api/orders' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...' \
  --body '{
    "order_type_id": 2,
    "order_date": "2026-02-15",
    "est_date": "2026-02-22",
    "items": [
        {
            "articul": "1710-013",
            "film_name": "МАТЕРИАЛИСТКА | MATERIALISTS",
            "good_name": "МАТЕРИАЛИСТКА _ HG-25435.231, Бейсболка LIBERTY SANDWICH, 6 клиньев, сэндвич",
            "good_cnt": 1,
            "category": "киносети",
            "counterparty": "Частное лицо",
            "town_name": "Красноярск",
            "adr": "660092, г. Красноярск, ул. Шевченко, д. 80, кв 118",
            "contact_fio": "Мирошникова Ирина Алексеевна",
            "contact_info": "89659052380",
            "note": "Примечание к заказу"
        }
    ]
}'

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

{
    "msg": "Заявка на отправку создана",
    "order_id": 53
}

3. Отменить заявку

DELETE https://api.kakchasy.ru/api/orders/<order_id> 
# Отмена заказа по ID
postman request DELETE 'https://api.kakchasy.ru/api/orders/52' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...' \
  --body ''

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

{
    "msg": "Заказ успешно отменён"
}

4. Получить список заказов

GET https://api.kakchasy.ru/api/orders 
# Получение списка всех заказов
postman request 'https://api.kakchasy.ru/api/orders' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'

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

[
    {
        "id": 51,
        "order_date": "2026-02-18",
        "est_date": "2026-02-28",
        "covname": "БИЗНЕС ГИФТС ООО",
        "cov_inn": "9715206895",
        "type": "Заказ поставщику",
        "status": "Создан",
        "vat": null
    },
    {
        "id": 57,
        "order_date": "2026-02-15",
        "est_date": "2026-02-22",
        "covname": null,
        "cov_inn": null,
        "type": "Заявка на отправку",
        "status": "Создан",
        "vat": null
    },
    {
        "id": 56,
        "order_date": "2026-02-15",
        "est_date": "2026-02-22",
        "covname": null,
        "cov_inn": null,
        "type": "Заявка на отправку",
        "status": "Отменён",
        "vat": null
    }
]

5. Получить информацию о заказе

GET https://api.kakchasy.ru/api/orders/<order_id> 
# Получение детальной информации по конкретному заказу
postman request 'https://api.kakchasy.ru/api/orders/6' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'

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

{
    "id": 6,
    "order_date": "2026-02-15",
    "est_date": "2026-02-22",
    "covname": null,
    "vat": null,
    "status": "Отменён",
    "items": [
        {
            "articul": "1710-013",
            "film_name": "МАТЕРИАЛИСТКА | MATERIALISTS",
            "good_name": "МАТЕРИАЛИСТКА _ HG-25435.231, Бейсболка LIBERTY SANDWICH, 6 клиньев, сэндвич",
            "good_cnt": 1,
            "good_price": 0.0,
            "good_summa": 0.0,
            "good_um": null,
            "category": "киносети",
            "town_name": null,
            "adr": "660092, г. Красноярск, ул. Шевченко, д. 80, кв 118",
            "contact_fio": "Мирошникова Ирина Алексеевна",
            "contact_info": "89659052380",
            "note": "Примечание к заказу"
        }
    ]
}

📋 Сводная таблица методов

Метод Endpoint Описание Тип
POST /api/login Авторизация и получение токена Публичный
POST /api/orders Создание заявки на покупку (type_id=1) Приватный
POST /api/orders Создание заявки на доставку (type_id=2) Приватный
DELETE /api/orders/{id} Отмена заказа Приватный
GET /api/orders Получение списка заказов Приватный
GET /api/orders/{id} Получение детальной информации о заказе Приватный

📌 Важно: Во всех запросах, кроме /api/login, требуется передавать access_token в заголовке Authorization: Bearer <ваш_токен>.

🔗 Базовый URL API: https://api.kakchasy.ru