Создание автовизита на прием контейнера

POST /api/sessions

Назначение

Метод используется для создания контейнерной сессии, а также связанного с ней автовизита на прием.

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

{
  "issuance": {
    "type": "LOCAL",
    "stationCode": "EXAMPLE_STATION"
  },
  "load": "FULL",
  "release": "RELEASE-12345",
  "container": {
    "name": "TGBU1234567",
    "isoCode": "22G1",
    "weight": {
      "tare": 2500,
      "maxPayload": 28000
    },
    "seals": [
      "SEAL001",
      "SEAL002"
    ]
  }
}

Описание полей запроса

Поле

Тип данных

Обязательное

Описание

issuance

object

✅

Место выдачи контейнера

└── type

string

✅

Тип выпуска: LOCAL - «Местная выдача» или EXTERNAL

└── stationCode

string

✅

Наименование ЖД Станции, на которую будет отгружен контейнер с терминала. Указывается только в случае type = EXTERNAL

load

string

✅

Статус загрузки контейнера: FULL (груженный) или EMPTY(порожний)

release

string

Номер релиза

container

object

✅

Информация о контейнере

└── name

string

✅

Номер контейнера (например, TGBU1234567)

└── isoCode

string

✅

ISO-код контейнера (например, 22G1, 45R1)

└── weight

object

✅

Весовые характеристики контейнера

└── tare

number

✅

Вес тары (кг)

└── maxPayload

number

✅

Максимальная грузоподъемность (кг)

└── seals

array

✅

Список пломб на контейнере (можно указать несколько значений)

Успешный ответ 201 Created

{
  "sessionId": 123456,
  "truckVisitId": 78910
}

Поле

Тип данных

Описание

sessionId

integer

Идентификатор созданной сессии

truckVisitId

integer

Идентификатор входящего автовизита

Ошибки

400 Bad Request

{
  "requestId": "abcd1234",
  "timestamp": "2025-07-16T09:44:55.594Z",
  "status": 400,
  "message": "Некорректные параметры запроса",
  "url": "/api/sessions",
  "fieldErrors": [
    "container.name must not be empty",
    "load must be FULL or EMPTY"
  ]
}

Ошибка валидации — одно или несколько обязательных полей отсутствуют или заполнены неверно.

404 Not Found

{
  "requestId": "efgh5678",
  "timestamp": "2025-07-16T09:44:55.595Z",
  "status": 404,
  "message": "Станция или пропуск не найдены",
  "url": "/api/sessions",
  "fieldErrors": []
}

Ошибка поиска — указанный stationCode или release не зарегистрированы в системе.