Создать заявку покупателя
Создает закупочную заявку с позициями, требованиями и данными по доставке.
Запрос
POST /api-gateway/api/v1/<token>/requests HTTP/1.1
Host: services.technokrendel.ru
Content-Type: application/json; charset=utf-8
Accept: application/json
X-Request-Id: a1beec70-23e8-4f10-aed8-a3c30c487036
Idempotency-Key: erp-request-RQ-2026-0412
Тело запроса
{
"externalId": "RQ-2026-0412",
"customer": {
"inn": "7700000000",
"name": "ООО Пример Покупатель"
},
"contact": {
"name": "Иван Петров",
"phone": "+7 900 000-00-00",
"email": "purchase@example.ru"
},
"delivery": {
"city": "Москва",
"address": "ул. Промышленная, 10",
"desiredDate": "2026-05-15"
},
"items": [
{
"lineId": "1",
"name": "Аккумуляторная дрель-шуруповерт",
"quantity": 10,
"unit": "шт",
"comment": "Нужны сертификаты и гарантийные документы"
},
{
"lineId": "2",
"name": "Набор сверл по металлу",
"quantity": 25,
"unit": "компл"
}
],
"comment": "Просьба предложить аналоги, если точная модель недоступна"
}
Успешный ответ
HTTP/1.1 201 Created
Content-Type: application/json; charset=utf-8
X-Request-Id: a1beec70-23e8-4f10-aed8-a3c30c487036
{
"id": "TKR-REQ-000345",
"externalId": "RQ-2026-0412",
"status": "accepted",
"createdAt": "2026-04-28T16:30:00+03:00"
}
Особенности
- Передавайте
Idempotency-Key, чтобы повторный запрос не создал дубль заявки. - Значение
externalIdдолжно быть уникальным в системе-источнике. - Чем точнее заполнены позиции, тем меньше уточнений потребуется при подборе.