Тема
Статусы заявки
Жизненный цикл
| Статус | Что означает | Как заявка попадает в статус |
|---|---|---|
CREATED | Заявка создана, посылки в ячейке ещё нет | Сразу после POST /order/create |
DELIVERED | Посылка лежит в ячейке, идёт срок хранения | Курьер ввёл код закладки на постомате и положил посылку в ячейку |
COMPLETED | Получатель забрал посылку | Получатель ввёл код получения на постомате |
SUBTRACTED | Посылку изъяли из ячейки без выдачи получателю | Изъятие по коду изъятия на постомате или сотрудником InLog |
COMPLETED и SUBTRACTED — финальные статусы.
Неоплаченный остаток
Если по заявке есть неоплаченный остаток, постомат не выдаст посылку получателю до оплаты — заявка остаётся в статусе DELIVERED.
Где смотреть статус
currentStatus— текущий статус. Добавляется в ответ флагомwithCurrentStatus=trueвGET /order/{id}иGET /order/list.statuses— история статусов заявки. Добавляется флагомwithStatuses=true.
Каждая запись статуса имеет вид:
json
{
"id": "b3v8r0c9u1h2y7x4w5z6a1q2",
"type": "DELIVERED",
"orderId": "gfb0sfr5ahkhu9dns4bja2ly",
"createdAt": "2026-09-29T10:15:00.000Z",
"updatedAt": "2026-09-29T10:15:00.000Z"
}Фильтр status в GET /order/list выбирает заявки по текущему статусу и принимает значения CREATED, DELIVERED, COMPLETED, SUBTRACTED.
Как отслеживать смену статуса
Надёжный способ — периодически запрашивать заявки:
- по одной:
GET /order/{id}?withCurrentStatus=true; - пачкой:
GET /order/list?status=DELIVERED&withCurrentStatus=true— например, чтобы найти заявки, которые ещё не забрали.
Дополнительно InLog может отправлять уведомление о смене статуса на ваш URL. Уведомления приходят не для всех статусов и без гарантии доставки — см. Вебхуки. Используйте их как сигнал «проверь заявку», а источником истины считайте ответ GET /order/{id}.