Статусы по номеру накладной

Данный эндпоинт для отслеживания этапов обработки заказа и доставки груза, который предоставляет информацию о текущем состоянии накладной.

Метод запроса: GET

https://gateway.spark-dev.team/cabinet/api/invoice-status/<invoice_number>

Пример запроса для получения статусов накладной с номером накладной SP00078479:

https://gateway.spark-dev.team/cabinet/api/invoice-status/SP00078479

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

{
    "data": {
        "invoice_number": "SP00078479",
        "status_history": [
            {
                "status_name": "Заказ создан",
                "status_code": 201,
                "state": "waiting",
                "date": null
            },
            {
                "status_name": "Забирается курьером",
                "status_code": 202,
                "state": "waiting",
                "date": null
            },
            {
                "status_name": "Обработка груза на складе",
                "status_code": 225,
                "state": "waiting",
                "date": null
            },
            {
                "status_name": "Груз в пути",
                "status_code": 206,
                "state": "waiting",
                "date": null
            },
            {
                "status_name": "Доставляется курьером",
                "status_code": 210,
                "state": "waiting",
                "date": null
            }
        ]
    }
}

Пример ответа (отмененная накладная):

{
    "data": {
        "invoice_number": "SP00300369",
        "client_sla_date": "23.08.2024",
        "cash_sum": null,
        "status_history": [
            {
                "status_name": "Заказ создан",
                "status_code": 201,
                "state": "completed",
                "date": "17.08.2024",
                "predict_date": "17.08.2024"
            },
            {
                "status_name": "Забор груза отменен",
                "status_code": 204,
                "state": "canceled",
                "date": "17.08.2024",
                "predict_date": null
            },
            {
                "status_name": "Груз забран у отправителя",
                "status_code": 203,
                "state": "waiting",
                "date": null,
                "predict_date": "18.08.2024"
            },
            {
                "status_name": "Груз обработан и ожидает отправку",
                "status_code": 205,
                "state": "waiting",
                "date": null,
                "predict_date": "20.08.2024"
            },
            {
                "status_name": "Груз в пути",
                "status_code": 206,
                "state": "waiting",
                "date": null,
                "predict_date": "22.08.2024"
            },
            {
                "status_name": "Груз в городе назначения",
                "status_code": 208,
                "state": "waiting",
                "date": null,
                "predict_date": "22.08.2024"
            },
            {
                "status_name": "Доставляется курьером",
                "status_code": 210,
                "state": "waiting",
                "date": null,
                "predict_date": "23.08.2024"
            },
            {
                "status_name": "Доставлен",
                "status_code": 211,
                "state": "waiting",
                "date": null,
                "predict_date": "23.08.2024"
            }
        ]
    }
}

Пример ответа (доставленная накладная):

{
    "data": {
        "invoice_number": "SP00234720",
        "client_sla_date": "08.01.2024",
        "cash_sum": null,
        "status_history": [
            {
                "status_name": "Заказ создан",
                "status_code": 201,
                "state": "completed",
                "date": "01.01.2024",
                "predict_date": "01.01.2024"
            },
            {
                "status_name": "Груз забран у отправителя",
                "status_code": 203,
                "state": "completed",
                "date": "03.01.2024",
                "predict_date": "03.01.2024"
            },
            {
                "status_name": "Груз обработан и ожидает отправку",
                "status_code": 205,
                "state": "completed",
                "date": "03.01.2024",
                "predict_date": "04.01.2024"
            },
            {
                "status_name": "Груз в пути",
                "status_code": 206,
                "state": "completed",
                "date": "03.01.2024",
                "predict_date": "05.01.2024"
            },
            {
                "status_name": "Груз в городе назначения",
                "status_code": 208,
                "state": "completed",
                "date": "04.01.2024",
                "predict_date": "05.01.2024"
            },
            {
                "status_name": "Доставляется курьером",
                "status_code": 210,
                "state": "completed",
                "date": "08.01.2024",
                "predict_date": "08.01.2024"
            },
            {
                "status_name": "Доставлен",
                "status_code": 211,
                "state": "completed",
                "date": "08.01.2024",
                "predict_date": "08.01.2024"
            }
        ]
    }
}

Статусы:

Код	Наименование	Описание
201	Заказ создан	Статус приходит после создания заказа
202	Забирается курьером	Статус приходит, когда назначили курьера на забор груза
203	Груз забран у отправителя	Статус приходит, когда курьер забрал груз у отправителя
204	Забор груза отменен	Статус приходит, когда заказ отменили
225	Обработка груза на складе	Статус приходит, когда курьер привез груз на склад
205	Груз обработан и ожидает отправку	Статус приходит, когда груз обработали на складе и подготовили для отправки
206	Груз в пути	Статус приходит, когда груз отправили на доставку в город назначения
208	Груз в городе назначения	Статус приходит, когда груз прибыл в город назначения
210	Доставляется курьером	Статус приходит, когда груз выдан на доставку курьеру
211	Доставлен	Статус приходит, когда груз доставлен