Skip to end of metadata
Go to start of metadata

В этой статье мы создадим Запрос на перевозку от имени Грузовладельца с минимальным набором параметров. Для этого мы будем использовать тестовую среду и интерактивную «песочницу» в качестве инструмента формирования запросов к API.

  1. Зайти в песочницу тестовой среды https://testdev2.logistpro.su/api/docs/ui/index
  2. Ввести и применить ключ (API Key) для компании-Грузовладельца (из статьи Тестовая среда testdev2)

    Для компании-Грузовладельца ТрансДемо1 значение ключа: jn/PYDwYKV7INbTQwZFdpXe4LEuYvBg9fgsIdykDigM=
  3. Авторизоваться, вызвав метод POST /api/v1/account/login от имени пользователя ext.customer.1@logistpro.su

  4. Получить необходимую справочную информацию для создания Запроса на перевозку, вызвав метод GET /api/v1/tender/create

    Для минимального набора обязательных параметров при дальнейшем создании Запроса на перевозку нам понадобятся два идентификатора из полученного ответа:
    • “Corporates”:”Id” - юридическое лицо заказчика перевозки: 4af53a58-45e2-4b78-ba50-25299a5978be (идентификатор ООО «ТК ТрансДемо1»)
    • “Corporates”:”ContactPersons”:”Id” - ответственный сотрудник заказчика: 2e912068-48ba-49df-9656-48583f5b2939 (идентификатор сотрудника ТС1, данный сотрудник будет получать уведомления о ходе торгов на email и его контакты будут показываться участникам торгов для уточнения информации)
  5. Вызвать метод создания запроса POST /api/v1/tender/create

    передав структуры данных с минимально необходимым набором параметров:

    {
        "Cargo": "Продукты питания",
        "CargoWeight": 3.5,
        "CargoVolume": 4.25,
        "Tender": {
            "VatReqs": "None"
        },
        "TransportRequirements": {
            "TransportType": "Auto"
        },
        "PackageDetails": [
            {
                "Type": "Pallets",
                "Number": 33
            }
        ],
        "RoutePoints": [
            {
                "Type": "Loading",
                "Address": "Москва, улица Ленина д.1",
                "ArrivalTime": "2022-03-11T00:00:00.000",
                "LeaveTime": "2022-03-12T00:00:00.000"
            },
            {
                "Type": "Unloading",
                "Address": "Санкт-Петербург, улица Ленина д.1",
                "ArrivalTime": "2022-03-15T00:00:00.000",
                "LeaveTime": "2022-03-16T00:00:00.000"
            }
        ],
        "Customer": {
            "CompanyId": "4af53a58-45e2-4b78-ba50-25299a5978be",
            "ContactId": "2e912068-48ba-49df-9656-48583f5b2939"
        }
    }

    В данной структуре передаются:

    • данные груза: поля “Cargo”, “CargoWeight”, “CargoVolume”
    • требования к участникам торгов: “Tender”:”VatReqs” - значение”None” - нет специальных требований в оплате НДС исполнителем
    • требования к транспорту: “TransportRequirements”:”TransportType”- значение “Auto” - автоперевозка
    • описание упаковки груза: “PackageDetails”, параметры “Type” и “Number” – тип и количество упаковок, соответственно
    • точки маршрута: “RoutePoints” - одна точка погрузки (“Type”:“Loading”) и одна точка выгрузки (“Type”:”Unloading”), адреса этих точек (“Address”), и периоды загрузки/выгрузки - время прибытия на эти точки (“ArrivalTime”) и максимальное время отправления из этих точек (“LeaveTime”)
    • данные заказчика перевозки: “Customer”, параметры CompanyId” и “ContactId”, равные значениям идентификаторов, полученных в пункте 4 настоящей инструкции
  6. Более подробная информация по передаваемым параметрам и требованиям к ним, отображена в Описании к модели данных:
  7. В результате работы метода создания, получаем http-код ответа 200 и идентификатор нового Запроса на перевозку в теле ответа:
  8. Созданный нами Запрос на перевозку можно увидеть:
    1. в пользовательском интерфейсе, указав в браузере url адрес https://testdev2.logistpro.su/Tender/Details/<id>, где <id> - полученный идентификатор Запроса, и при необходимости авторизовавшись пользователем ext.customer.1@logistpro.su


    2. или через API, вызвав метод GET /api/v1/tender/{id}, где {id} - полученный идентификатор Запроса


      В полученном ответе будут все необходимые данные Запроса на перевозку, включая текущий статус торгов, полученные предложения и т.п.
  • No labels