Создание автовизита на выдачу контейнера

POST /api/truck-visits

Метод предназначен для создания на выдачу контейнера с терминала.

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

{
  "containerName": "TGBU1234567",
  "requiredContainerParams": {
    "containerIsoCode": "22G1",
    "release": "RELEASE-12345",
    "stockName": "Обычные условия"
  }
}

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

Поле

Тип данных

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

Описание

containerName

string

Номер контейнера (например, TGBU1234567) Заполняется при номерной выдачи

requiredContainerParams

object

Объект с параметрами, требуемыми для выдачи, заполняется при безномерной выдачи

└── containerIsoCode

string

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

└── release

string

релиз

└── stockName

string

Сток(подсток) из которого должен быть выдан контейнер

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

201 Created

{
  "id": 98765,
  "sessionId": 123456,
  "status": "DRAFT",
  "type": "INCOMING",
  "issuanceType": "LOCAL",
  "load": "FULL",
  "release": "RELEASE-12345",
  "container": {
    "name": "TGBU1234567",
    "specification": {
      "id": 1,
      "code": "22G1",
      "description": "20-футовый универсальный контейнер"
    }
  },
  "timeslot": {
    "from": "2025-07-16T09:50:08.073Z",
    "to": "2025-07-16T10:50:08.073Z"
  }
}

Поле

Тип данных

Описание

id

integer

Уникальный идентификатор заявки

sessionId

integer

ID контейнерной сессии, с которой связана заявка

status

string

Текущий статус заявки (DRAFT, CONFIRMED, и т.д.)

type

string

Тип заявки (INCOMING, OUTGOING)

issuanceType

string

Способ выдачи: LOCAL или EXTERNAL

load

string

Тип загрузки: FULL или EMPTY

release

string

Релиз

container.name

string

Номер контейнера

container.specification.id

integer

ID спецификации контейнера

container.specification.code

string

ISO-код спецификации

container.specification.description

string

Человекочитаемое описание

timeslot.from

string (ISO)

Начало выделенного временного интервала для прибытия

timeslot.to

string (ISO)

Конец временного интервала

Ошибки

400 Bad Request — Ошибка валидации

{
  "requestId": "abcd1234",
  "timestamp": "2025-07-16T09:50:08.075Z",
  "status": 400,
  "message": "Некорректные параметры запроса",
  "url": "/api/truck-visits",
  "fieldErrors": [
    "containerName must not be empty",
    "release must be provided"
  ]
}

Причины:

  • Отсутствуют обязательные поля

  • Неверные типы данных

  • Ошибки форматирования

404 Not Found — Объект не найден

{
  "requestId": "efgh5678",
  "timestamp": "2025-07-16T09:50:08.076Z",
  "status": 404,
  "message": "Релиз или контейнер не найден",
  "url": "/api/truck-visits",
  "fieldErrors": []
}

Причины:

  • Неверный release или stockName

  • Контейнер отсутствует в системе