# Заказы

Операции с заказами

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

> Возвращает список физических заказов текущего пользователя с пагинацией

```json
{"openapi":"3.1.0","info":{"title":"Tribute API","version":"1.0.0"},"tags":[{"name":"Orders","description":"Операции с заказами"}],"servers":[{"url":"https://tribute.tg/api/v1","description":"Tribute API v1"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"Api-Key","description":"API ключ для аутентификации."}},"schemas":{"Order":{"type":"object","required":["id","status","created","fullName","email","phone","telegramID","address","locality","fullAddress","customerNote","items","deliveryCost","currency"],"properties":{"id":{"type":"integer","description":"Уникальный идентификатор заказа"},"status":{"type":"string","description":"Статус заказа","enum":["pending","shipped","delivered","canceled","refunded"]},"created":{"type":"string","format":"date-time","description":"Дата и время создания заказа"},"fullName":{"type":"string","description":"Полное имя получателя"},"email":{"type":"string","format":"email","description":"Email получателя"},"phone":{"type":"string","description":"Телефон получателя"},"telegramID":{"type":"integer","format":"int64","description":"Telegram ID покупателя"},"address":{"type":"object","description":"Адрес доставки","properties":{"countryIso2":{"type":"string","description":"Двухбуквенный код страны ISO"},"countryIso3":{"type":"string","description":"Трёхбуквенный код страны ISO"}}},"locality":{"type":"string","description":"Населенный пункт"},"fullAddress":{"type":"string","description":"Полный адрес доставки"},"customerNote":{"type":"string","description":"Примечание от покупателя"},"items":{"type":"array","description":"Товары в заказе","items":{"$ref":"#/components/schemas/OrderItem"}},"deliveryCost":{"type":"number","format":"float","description":"Стоимость доставки"},"currency":{"type":"string","description":"Валюта заказа"}}},"OrderItem":{"type":"object","required":["id","price","quantity","currency","name","attributes"],"properties":{"id":{"type":"integer","description":"ID варианта товара"},"price":{"type":"number","format":"float","description":"Цена за единицу товара"},"quantity":{"type":"integer","format":"int64","description":"Количество"},"currency":{"type":"string","description":"Валюта товара"},"name":{"type":"string","description":"Название товара"},"attributes":{"type":"object","description":"Атрибуты товара (размер, цвет и т.д.)","additionalProperties":{"type":"string"}}}},"Meta":{"type":"object","required":["total","offset","limit"],"properties":{"total":{"type":"integer","format":"int64","description":"Общее количество записей"},"offset":{"type":"integer","format":"int64","description":"Номер страницы"},"limit":{"type":"integer","format":"int64","description":"Количество записей на странице"}}},"Error":{"type":"object","required":["error","message"],"properties":{"error":{"type":"string","description":"Код ошибки","enum":["error_bad_request","error_not_found","error_not_permitted","no_access"]},"message":{"type":"string","description":"Описание ошибки"}}}}},"paths":{"/physical/orders":{"get":{"summary":"Получить список заказов","description":"Возвращает список физических заказов текущего пользователя с пагинацией","tags":["Orders"],"parameters":[{"name":"lastOrderId","in":"query","description":"ID последнего заказа для курсорной пагинации","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","description":"Фильтр по статусу заказа (можно указать несколько)","required":false,"schema":{"type":"array","items":{"type":"string","enum":["pending","shipped","delivered","canceled","refunded"]}},"style":"form","explode":true},{"name":"limit","in":"query","description":"Количество записей на страницу (максимум 50)","required":false,"schema":{"type":"integer","default":50,"maximum":50}},{"name":"page","in":"query","description":"Номер страницы","required":false,"schema":{"type":"integer","default":1}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"type":"object","properties":{"rows":{"type":"array","items":{"$ref":"#/components/schemas/Order"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"description":"Некорректный запрос (неверный статус)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Неавторизован (неверный API ключ)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Получить детали заказа

> Возвращает подробную информацию о конкретном заказе

```json
{"openapi":"3.1.0","info":{"title":"Tribute API","version":"1.0.0"},"tags":[{"name":"Orders","description":"Операции с заказами"}],"servers":[{"url":"https://tribute.tg/api/v1","description":"Tribute API v1"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"Api-Key","description":"API ключ для аутентификации."}},"schemas":{"Order":{"type":"object","required":["id","status","created","fullName","email","phone","telegramID","address","locality","fullAddress","customerNote","items","deliveryCost","currency"],"properties":{"id":{"type":"integer","description":"Уникальный идентификатор заказа"},"status":{"type":"string","description":"Статус заказа","enum":["pending","shipped","delivered","canceled","refunded"]},"created":{"type":"string","format":"date-time","description":"Дата и время создания заказа"},"fullName":{"type":"string","description":"Полное имя получателя"},"email":{"type":"string","format":"email","description":"Email получателя"},"phone":{"type":"string","description":"Телефон получателя"},"telegramID":{"type":"integer","format":"int64","description":"Telegram ID покупателя"},"address":{"type":"object","description":"Адрес доставки","properties":{"countryIso2":{"type":"string","description":"Двухбуквенный код страны ISO"},"countryIso3":{"type":"string","description":"Трёхбуквенный код страны ISO"}}},"locality":{"type":"string","description":"Населенный пункт"},"fullAddress":{"type":"string","description":"Полный адрес доставки"},"customerNote":{"type":"string","description":"Примечание от покупателя"},"items":{"type":"array","description":"Товары в заказе","items":{"$ref":"#/components/schemas/OrderItem"}},"deliveryCost":{"type":"number","format":"float","description":"Стоимость доставки"},"currency":{"type":"string","description":"Валюта заказа"}}},"OrderItem":{"type":"object","required":["id","price","quantity","currency","name","attributes"],"properties":{"id":{"type":"integer","description":"ID варианта товара"},"price":{"type":"number","format":"float","description":"Цена за единицу товара"},"quantity":{"type":"integer","format":"int64","description":"Количество"},"currency":{"type":"string","description":"Валюта товара"},"name":{"type":"string","description":"Название товара"},"attributes":{"type":"object","description":"Атрибуты товара (размер, цвет и т.д.)","additionalProperties":{"type":"string"}}}},"Error":{"type":"object","required":["error","message"],"properties":{"error":{"type":"string","description":"Код ошибки","enum":["error_bad_request","error_not_found","error_not_permitted","no_access"]},"message":{"type":"string","description":"Описание ошибки"}}}}},"paths":{"/physical/orders/{id}":{"get":{"summary":"Получить детали заказа","description":"Возвращает подробную информацию о конкретном заказе","tags":["Orders"],"parameters":[{"name":"id","in":"path","description":"ID заказа","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Успешный ответ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Order"}}}},"400":{"description":"Некорректный запрос (не указан ID заказа)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Неавторизован (неверный API ключ)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Заказ не найден","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```