Skip to content
Мои токены Поддержка
Авторизоваться
Для подтверждения действия введите пароль
Чтобы продолжить, введите пароль для пользователя

Как оформить Заказ

Когда вы берете груз (после Торгов, из поиска или после получения персонального приглашения) вам нужно заполнить следующую информацию в заявке на перевозку:

  • водитель, назначенный на Заказ (опционально, может быть указан позже или не указан вообще);
  • транспортное средство (ТС), закрепленное за Заказом (опционально, может быть указан позже или не указан вообще);
  • ваши реквизиты для оформления сделки.
Взятие груза / Редактирование Заказа
post /v1.2/orders/takeload/{loadId}
Запрос
Модель
{...}

Параметры Заказа

rate_type: enum
[0, 1, 2, 3]

Тип оплаты

  • 0 — Нет
  • 1 — Любая
  • 2 — С НДС
  • 3 — Без НДС
driver_id: guid (nullable)

Id водителя

truck_info_id: guid (nullable)

Id транспортного средства

semitrailer_id: guid (nullable)

Id полуприцепа

Может быть указан только если транспортное средство — тягач

trailer_id: guid (nullable)

Id прицепа

Может быть указан только если указан полуприцеп или транспортное средство — грузовик

requisites_id: guid (nullable)

Id реквизитов

signer_id: guid (nullable)

Id подписанта

is_drop_docs: boolean

Отзывать ли привязанные документы

Используется при редактировании

deal_kind: enum (nullable)
[0, 1, 2, 4, 8, 16, 32, 64]

Тип Заказа

  • 0 — Заказ невозможен
  • 1 — Взятие груза из поиска
  • 2 — Заказ из Торгов
  • 4 — Предложение груза
  • 8 — Из перехвата машин
  • 16 — Односторонний заказ
  • 32 — Предложение груза из встречного предложения
  • 64 — Предложение груза по контракту
taker_note: string

Комментарий перевозчика

}
Пример запроса
curl 'https://api.ati.su/v1.2/orders/takeload/{loadId}' \
-X 'POST' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json' \
--data-raw '{"rate_type":0,"driver_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","truck_info_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","semitrailer_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","trailer_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","requisites_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","signer_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","is_drop_docs":false,"deal_kind":0,"taker_note":"string"}'
Ответ
200 Успешное взятие/редактирование
Модель
{...}
}
Пример
{...}
"load_copy":{...},
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"load_number":"string",
"load_meta":{...},
"load_meta_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"meta_data":"string"
},
"auction_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"updated_at":"1970-01-01T00:00:00.000Z",
"added_at":"1970-01-01T00:00:00.000Z",
"archive_date":"1970-01-01T00:00:00.000Z",
"distance":0,
"distance_type":0,
"platon_roads_length":0,
"toll_roads_length":0,
"travel_time":"?",
"true_price":0,
"true_currency_id":0,
"parent_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"is_unpublished":false,
"firm_id":0,
"contact_id1":0,
"contact_id2":0,
"note":"string",
"first_date":"1970-01-01T00:00:00.000Z",
"last_date":"1970-01-01T00:00:00.000Z",
"date_type":0,
"periodicity_id":0,
"order_number":"string",
"krugoreis":false,
"zimnik":false,
"ferries":false,
"loading":{...},
"fias_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"city_id":0,
"latitude":0.5,
"longitude":0.5,
"street":"string",
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"time_start":"1970-01-01T00:00:00.000Z",
"time_end":"1970-01-01T00:00:00.000Z",
"is_round_the_clock":false,
"large_cities":[...],
0
],
"large_cities_with_distance":[...],
{...}
"city_id":0,
"distance":0.5
}
],
"loading_cargos":[...],
{...}
"cargo_id":0,
"name_id":0,
"name":"string",
"packaging_type":0,
"packaging_quantity":0,
"weight":0.5,
"volume":0.5,
"sizes":{...},
"length":0.5,
"width":0.5,
"height":0.5,
"diameter":0.5,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"string"
}
],
"organization":{...}
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"firm_id":0,
"name":"string",
"ownership":0,
"residency":0,
"inn":"string",
"phone":"string",
"extra_phone":0,
"docs_address":{...},
"postcode":"string",
"city_id":0,
"street_name":"string",
"house_no":"string",
"office_no":"string"
},
"stocks":[...],
{...}
"stock_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address":"string",
"address_city_id":0,
"address_latitude":0.5,
"address_longitude":0.5,
"note":"string",
"work_schedules":[...],
{...}
"stock_schedule_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"day_of_week":0,
"start_time":"?",
"end_time":"?"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"day_of_week":0,
"start_time":"?",
"end_time":"?"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"schedule_summary":"string",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":0,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"ownership_name":"string"
}
},
"extra_points":[...],
{...}
"route_point_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"load_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"city_id":0,
"point_type":0,
"ordinal_id":0,
"distance":0,
"street":"string",
"latitude":0.5,
"longitude":0.5,
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"loading_date_start":"1970-01-01T00:00:00.000Z",
"loading_date_end":"1970-01-01T00:00:00.000Z",
"loading_time_start":null,
"loading_time_end":null,
"is_round_the_clock":false,
"city_name":"string",
"loading_cargos":[...],
{...}
"cargo_id":0,
"name_id":0,
"name":"string",
"packaging_type":0,
"packaging_quantity":0,
"weight":0.5,
"volume":0.5,
"sizes":{...},
"length":0.5,
"width":0.5,
"height":0.5,
"diameter":0.5,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"string"
}
],
"unloading_cargos":[...],
{...}
"cargo_id":0,
"weight":0.5,
"volume":0.5,
"packaging_quantity":0,
"is_defined_by_ttn":false
}
],
"organization":{...}
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"firm_id":0,
"name":"string",
"ownership":0,
"residency":0,
"inn":"string",
"phone":"string",
"extra_phone":0,
"docs_address":{...},
"postcode":"string",
"city_id":0,
"street_name":"string",
"house_no":"string",
"office_no":"string"
},
"stocks":[...],
{...}
"stock_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address":"string",
"address_city_id":0,
"address_latitude":0.5,
"address_longitude":0.5,
"note":"string",
"work_schedules":[...],
{...}
"stock_schedule_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"day_of_week":0,
"start_time":"?",
"end_time":"?"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"day_of_week":0,
"start_time":"?",
"end_time":"?"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"schedule_summary":"string",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":0,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"ownership_name":"string"
}
}
],
"unloading":{...},
"fias_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"city_id":0,
"latitude":0.5,
"longitude":0.5,
"street":"string",
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"time_start":"1970-01-01T00:00:00.000Z",
"time_end":"1970-01-01T00:00:00.000Z",
"is_round_the_clock":false,
"large_cities":[...],
0
],
"large_cities_with_distance":[...],
{...}
"city_id":0,
"distance":0.5
}
],
"loading_cargos":[...],
{...}
"cargo_id":0,
"name_id":0,
"name":"string",
"packaging_type":0,
"packaging_quantity":0,
"weight":0.5,
"volume":0.5,
"sizes":{...},
"length":0.5,
"width":0.5,
"height":0.5,
"diameter":0.5,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"string"
}
],
"organization":{...}
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"firm_id":0,
"name":"string",
"ownership":0,
"residency":0,
"inn":"string",
"phone":"string",
"extra_phone":0,
"docs_address":{...},
"postcode":"string",
"city_id":0,
"street_name":"string",
"house_no":"string",
"office_no":"string"
},
"stocks":[...],
{...}
"stock_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address":"string",
"address_city_id":0,
"address_latitude":0.5,
"address_longitude":0.5,
"note":"string",
"work_schedules":[...],
{...}
"stock_schedule_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"day_of_week":0,
"start_time":"?",
"end_time":"?"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"day_of_week":0,
"start_time":"?",
"end_time":"?"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"schedule_summary":"string",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":0,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"ownership_name":"string"
}
},
"cargo":{...},
"weight":0.5,
"volume":0.5,
"adr":0,
"cargo_type_id":0,
"cargo_type":"string",
"pack_type":0,
"pallet_count":0,
"belt_count":0,
"dogruz_type":0,
"sbor_gruz":false,
"size":{...}
"length":0.5,
"width":0.5,
"height":0.5,
"diameter":0.5,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
}
},
"transport":{...},
"car_type":0,
"car_type_string":"string",
"loading_type":0,
"loading_logical_operator":"string",
"unloading_type":0,
"unloading_logical_operator":"string",
"trucks_quantity":0,
"temperature_from":0,
"temperature_to":0,
"stsepka":false,
"pnevmohod":false,
"koniki":false,
"tir":false,
"cmr":false,
"t1":false,
"san_passport":false,
"is_tracking":false,
"required_capacity":0.5
},
"boards":[...],
{...}
"board_id":"string",
"name":"string",
"color":"string"
}
],
"unload_first_date":"1970-01-01T00:00:00.000Z",
"unload_last_date":"1970-01-01T00:00:00.000Z"
},
"deal":{...}
"deal_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"load_copy_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"load_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"taker_ati_id":"string",
"taker_persistent_user_id":0,
"taker_contact_id":0,
"cargo_owner_ati_id":"string",
"cargo_owner_persistent_user_id":0,
"updated_at":"1970-01-01T00:00:00.000Z",
"end_of_reservation":"1970-01-01T00:00:00.000Z",
"auction_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"status":0,
"counterparty_status":0,
"payment":{...},
"rates":[...],
{...}
"rate":0.5,
"rate_type":0,
"currency":0,
"active":false
}
],
"prepay_percent":0,
"prepay_percent_enabled":false,
"on_unloading":false,
"in_fuel":false,
"pay_days_enabled":false,
"pay_days":0,
"fixed_rate":false,
"torg":false,
"direct_contract":false,
"money_type":0
},
"pay_docs":{...},
"documents_copies":{...},
"checked":false,
"date":"1970-01-01T00:00:00.000Z"
},
"documents_original":{...},
"checked":false,
"date":"1970-01-01T00:00:00.000Z"
},
"documents_original_track":{...},
"transport_company_id":0,
"tracking_url":"string",
"tracking_number":"string",
"sending_date":"1970-01-01T00:00:00.000Z"
},
"payment":{...}
"checked":false,
"date":"1970-01-01T00:00:00.000Z"
}
},
"files":[...],
{...}
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"storage_file_id":"string",
"access":0,
"add_date":"1970-01-01T00:00:00.000Z",
"deal_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"is_counterparty_file":false,
"file_name":"string",
"size":0,
"link":"string",
"source_type":0,
"source_file_type":0,
"file_type":0,
"timeslots_warehouse_ids":[...]
0
]
}
],
"document_templates":[...],
{...}
"organization_address":"string",
"templates":[...]
{...}
"add_date":"1970-01-01T00:00:00.000Z",
"access":0,
"timeslots_warehouse_ids":[...],
0
],
"deal_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"deal_point_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"owner_firm_id":0,
"cargoes_ids_hash":0,
"contact_id":0,
"file_name":"string",
"file_id":"string",
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"size":0,
"link":"string"
}
]
}
],
"is_tracking":false,
"should_show_rate_to_driver":false,
"started_at":"1970-01-01T00:00:00.000Z",
"finished_at":"1970-01-01T00:00:00.000Z",
"denial_reason":"string",
"taker_requisites":{...},
"requisite_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"requisite_firm_name":"string",
"signer_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"own_ship_id":0,
"inn":"string",
"kpp":"string",
"requisite_type_id":0
},
"driver":{...},
"driver_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"parent_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"first_name":"string",
"second_name":"string",
"patronymic":"string",
"phone_number":"string",
"driver_license_number":"string",
"passport_series":"string",
"passport_number":"string",
"passport_issued_by":"string",
"passport_when_issued":"1970-01-01T00:00:00.000Z",
"registration":"string",
"is_attracted_driver":false,
"last_deal_related_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"description":"string",
"attracted_from":"string",
"scans":[...],
{...}
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"owner_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"path":"string",
"name":"string",
"type":0
}
],
"origin":0,
"date_of_birth":"1970-01-01T00:00:00.000Z",
"department_code_in_passport":"string",
"driver_inn":"string",
"in_cargo_owner_black_list":false,
"black_list_reasons":[...]
"string"
]
},
"truck":{...},
"truck_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"parent_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"last_deal_related_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"type":0,
"description":"string",
"brand_id":0,
"model":"string",
"number":"string",
"phone_number":"string",
"is_attracted_truck":false,
"ownership_type":0,
"car_type_id":0,
"capacity":0.5,
"volume":0.5,
"length":0.5,
"width":0.5,
"height":0.5,
"manufacture_year":0,
"vin":"string",
"vrc":"string",
"body_number":"string",
"dimension":0,
"truck_passport_number":"string",
"can_refrigerator":false,
"has_gen_set":false,
"truck_owner_name":"string",
"can_carry_heavy_container":false,
"can_carry_tall_container":false,
"verified":false,
"modification_restricted":false,
"scans":[...],
{...}
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"owner_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"path":"string",
"name":"string",
"type":0
}
],
"origin":0
},
"trailer":{...},
"truck_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"parent_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"last_deal_related_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"type":0,
"description":"string",
"brand_id":0,
"model":"string",
"number":"string",
"phone_number":"string",
"is_attracted_truck":false,
"ownership_type":0,
"car_type_id":0,
"capacity":0.5,
"volume":0.5,
"length":0.5,
"width":0.5,
"height":0.5,
"manufacture_year":0,
"vin":"string",
"vrc":"string",
"body_number":"string",
"dimension":0,
"truck_passport_number":"string",
"can_refrigerator":false,
"has_gen_set":false,
"truck_owner_name":"string",
"can_carry_heavy_container":false,
"can_carry_tall_container":false,
"verified":false,
"modification_restricted":false,
"scans":[...],
{...}
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"owner_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"path":"string",
"name":"string",
"type":0
}
],
"origin":0
},
"semi_trailer":{...},
"truck_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"parent_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"last_deal_related_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"type":0,
"description":"string",
"brand_id":0,
"model":"string",
"number":"string",
"phone_number":"string",
"is_attracted_truck":false,
"ownership_type":0,
"car_type_id":0,
"capacity":0.5,
"volume":0.5,
"length":0.5,
"width":0.5,
"height":0.5,
"manufacture_year":0,
"vin":"string",
"vrc":"string",
"body_number":"string",
"dimension":0,
"truck_passport_number":"string",
"can_refrigerator":false,
"has_gen_set":false,
"truck_owner_name":"string",
"can_carry_heavy_container":false,
"can_carry_tall_container":false,
"verified":false,
"modification_restricted":false,
"scans":[...],
{...}
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"owner_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"path":"string",
"name":"string",
"type":0
}
],
"origin":0
},
"document":{...},
"id":"string",
"old_id":"string",
"editor":"string",
"url":"string",
"old_url":"string",
"name":"string",
"is_signed":false,
"access":0
},
"additional_documents":[...],
{...}
"id":"string",
"is_counterparty_file":false,
"url":"string",
"name":"string",
"is_signed":false,
"document_type":0,
"access":0
}
],
"in_work_status_model":0,
"in_work":{...},
"deal_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"in_work_status":0,
"in_work_date":"1970-01-01T00:00:00.000Z",
"ati_id":"string",
"contact_id":0,
"tracker_phone":0.5
},
"deal_note":"string",
"deal_kind":0,
"points":[...]
{...}
"deal_point_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"ordinal_id":0,
"point_type":0,
"city_id":0,
"lat":0.5,
"lon":0.5,
"address":"string",
"participant_name":"string",
"region_id":0,
"contact_name":"string",
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"stock_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"stock":{...},
"stock_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address":"string",
"address_city_id":0,
"note":"string",
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"schedule_summary":"string",
"stock_type":0,
"timeslots_warehouse_id":0
},
"organization":{...}
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"extra_phone":0,
"contact_persons":[...]
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
]
}
}
]
}
}
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
{...}

Модель ошибки

reason: string

Причина ошибки

error: string

Ключ ошибки

}
Пример
{...}
"reason":"string",
"error":"string"
}

Чтобы получить ID имеющихся у вас водителей и ТС, воспользуйтесь методами, описанными в разделе «Справочники пользователя. Автопарк и водители».

Получить ID ваших реквизитов вам поможет метод получения реквизитов своей фирмы:

Метод получения реквизитов фирмы
get /v1.0/firms/requisites
Запрос
Пример запроса
curl 'https://api.ati.su/v1.0/firms/requisites' \
-X 'GET' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Success
Модель
[{...}]
requisite_id: uuid

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

ati_id: string (nullable)

Код в ATI.SU фирмы

requisite_type_id: int32

Тип реквизита

requisite_name: string (nullable)

Название реквизита

legal_name: string (nullable)

Юридическое именование фирмы

own_ship_id: int32

Идентификатор формы собственности

fio: string (nullable)

ФИО владельца

inn: string (nullable)

ИНН

ogrn: string (nullable)

ОГРН, для реквизитов в валюте (USD и EUR) в этом поле храниться VAT

phone: string (nullable)

Телефон

fax: string (nullable)

Факс

email: string (nullable)

Электронный адрес

kpp: string (nullable)

КПП

rs: string (nullable)

Расчетный счет

ks: string (nullable)

КС

bik: string (nullable)

БИК

bank: string (nullable)

Наименование банка

codes: string (nullable)

Коды

is_read_only: boolean

Реквизиты только для чтения

okpo: string (nullable)

ОКПО

is_vat_payer: boolean

Плательщик НДС

last_use_date: date-time (nullable)

Дата последнего использования в системе

is_active: boolean

Активный реквизит

is_visible: boolean

Будет ли виден реквизит пользователю в будущем
Нужен для одноразовых реквизитов, например, при создании счета с оплатой по банковской карте (там создается реквизит из пары полей)

legal_address_id: uuid

Идентификатор юридического адреса в системе

post_address_id: uuid

Идентификатор почтового адреса в системе

available_in_ati_docs: boolean

Доступно в АТИ Доках

read only
}]
Пример
[...]
{...}
"requisite_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"ati_id":"string",
"requisite_type_id":0,
"requisite_name":"string",
"legal_name":"string",
"own_ship_id":0,
"fio":"string",
"inn":"string",
"ogrn":"string",
"phone":"string",
"fax":"string",
"email":"string",
"kpp":"string",
"rs":"string",
"ks":"string",
"bik":"string",
"bank":"string",
"codes":"string",
"is_read_only":false,
"okpo":"string",
"is_vat_payer":false,
"last_use_date":"1970-01-01T00:00:00.000Z",
"is_active":true,
"is_visible":true,
"legal_address":{...},
"address_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"ati_id":"string",
"country_id":0,
"region_id":0,
"city_id":0,
"city_name":"string",
"post_index":"string",
"street_type_id":0,
"street_name":"string",
"house_no":"string",
"part_no":"string",
"litera":"string",
"office_no":"string",
"post_contact":"string",
"add_date":"1970-01-01T00:00:00.000Z",
"attributes":0,
"send_type_id":0,
"note":"string",
"formatted_text":"string",
"is_post_address":false,
"fias_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"fias_level":0
},
"post_address":{...},
"address_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"ati_id":"string",
"country_id":0,
"region_id":0,
"city_id":0,
"city_name":"string",
"post_index":"string",
"street_type_id":0,
"street_name":"string",
"house_no":"string",
"part_no":"string",
"litera":"string",
"office_no":"string",
"post_contact":"string",
"add_date":"1970-01-01T00:00:00.000Z",
"attributes":0,
"send_type_id":0,
"note":"string",
"formatted_text":"string",
"is_post_address":false,
"fias_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"fias_level":0
},
"legal_address_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"post_address_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"signees":[...],
{...}
"signee_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"requisite_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"full_name":"string",
"position":"string",
"act_upon":"string",
"is_default":false,
"deletion_date":"1970-01-01T00:00:00.000Z",
"full_name_and_position":"string"
}
],
"person_passport":{...}
"series":"string",
"number":"string",
"date_of_issue":"1970-01-01T00:00:00.000Z",
"department_code":"string",
"issued_by":"string",
"registration":"string",
"scan_files":[...]
{...}
"link":"string",
"id":"string",
"size":0,
"name":"string"
}
]
}
}
]
400 Bad Request
Модель
{...}
error: string (nullable)
reason: string (nullable)
}
Пример
{...}
"error":"string",
"reason":"string"
}
401 Unauthorized
Модель
{...}
error: string (nullable)
reason: string (nullable)
}
Пример
{...}
"error":"string",
"reason":"string"
}
402 Client Error
Модель
{...}
error: string (nullable)
reason: string (nullable)
}
Пример
{...}
"error":"string",
"reason":"string"
}
403 Forbidden
Модель
{...}
error: string (nullable)
reason: string (nullable)
}
Пример
{...}
"error":"string",
"reason":"string"
}
404 Not Found
Модель
{...}
error: string (nullable)
reason: string (nullable)
}
Пример
{...}
"error":"string",
"reason":"string"
}
500 Server Error
Модель
{...}
error: string (nullable)
reason: string (nullable)
}
Пример
{...}
"error":"string",
"reason":"string"
}
504 Server Error
Модель
{...}
error: string (nullable)
reason: string (nullable)
}
Пример
{...}
"error":"string",
"reason":"string"
}

После того, как вы заполните данные и возьмете груз, ваша заявка будет отправлена грузовладельцу на рассмотрение. Отследить статус Заказа можно с помощью метода получения статусов Заказа:

Получение статусов Заказов
post /v1.2/orders/get_orders_statuses
Запрос
Модель
[guid]
Пример запроса
curl 'https://api.ati.su/v1.2/orders/get_orders_statuses' \
-X 'POST' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json' \
--data-raw '["3fa85f64-5717-4562-b3fc-2c963f66afa6"]'
Ответ
200 Возвращает объект _Id груза - список статусов связанных Заказов_
Модель
{...}
}
Пример
{...}
"any-key":[...]
{...}
"deal_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"status":0,
"deal_kind":0,
"inwork_status":0,
"tracker_offer_status":0,
"status_change_date_time":"1970-01-01T00:00:00.000Z"
}
]
}

Для получения более детальной информации по Заказу, воспользуйтесь методом получения информации по Заказу:

Получение информации по Заказу
get /v1.2/orders/{dealId}
Запрос
Пример запроса
curl 'https://api.ati.su/v1.2/orders/{dealId}' \
-X 'GET' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Возвращает информацию по Заказу
Модель
{...}
}
Пример
{...}
"load_copy":{...},
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"load_number":"string",
"load_meta":{...},
"load_meta_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"meta_data":"string"
},
"auction_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"updated_at":"1970-01-01T00:00:00.000Z",
"added_at":"1970-01-01T00:00:00.000Z",
"archive_date":"1970-01-01T00:00:00.000Z",
"distance":0,
"distance_type":0,
"platon_roads_length":0,
"toll_roads_length":0,
"travel_time":"?",
"true_price":0,
"true_currency_id":0,
"parent_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"is_unpublished":false,
"firm_id":0,
"contact_id1":0,
"contact_id2":0,
"note":"string",
"first_date":"1970-01-01T00:00:00.000Z",
"last_date":"1970-01-01T00:00:00.000Z",
"date_type":0,
"periodicity_id":0,
"order_number":"string",
"krugoreis":false,
"zimnik":false,
"ferries":false,
"loading":{...},
"fias_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"city_id":0,
"latitude":0.5,
"longitude":0.5,
"street":"string",
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"time_start":"1970-01-01T00:00:00.000Z",
"time_end":"1970-01-01T00:00:00.000Z",
"is_round_the_clock":false,
"large_cities":[...],
0
],
"large_cities_with_distance":[...],
{...}
"city_id":0,
"distance":0.5
}
],
"loading_cargos":[...],
{...}
"cargo_id":0,
"name_id":0,
"name":"string",
"packaging_type":0,
"packaging_quantity":0,
"weight":0.5,
"volume":0.5,
"sizes":{...},
"length":0.5,
"width":0.5,
"height":0.5,
"diameter":0.5,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"string"
}
],
"organization":{...}
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"firm_id":0,
"name":"string",
"ownership":0,
"residency":0,
"inn":"string",
"phone":"string",
"extra_phone":0,
"docs_address":{...},
"postcode":"string",
"city_id":0,
"street_name":"string",
"house_no":"string",
"office_no":"string"
},
"stocks":[...],
{...}
"stock_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address":"string",
"address_city_id":0,
"address_latitude":0.5,
"address_longitude":0.5,
"note":"string",
"work_schedules":[...],
{...}
"stock_schedule_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"day_of_week":0,
"start_time":"?",
"end_time":"?"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"day_of_week":0,
"start_time":"?",
"end_time":"?"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"schedule_summary":"string",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":0,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"ownership_name":"string"
}
},
"extra_points":[...],
{...}
"route_point_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"load_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"city_id":0,
"point_type":0,
"ordinal_id":0,
"distance":0,
"street":"string",
"latitude":0.5,
"longitude":0.5,
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"loading_date_start":"1970-01-01T00:00:00.000Z",
"loading_date_end":"1970-01-01T00:00:00.000Z",
"loading_time_start":null,
"loading_time_end":null,
"is_round_the_clock":false,
"city_name":"string",
"loading_cargos":[...],
{...}
"cargo_id":0,
"name_id":0,
"name":"string",
"packaging_type":0,
"packaging_quantity":0,
"weight":0.5,
"volume":0.5,
"sizes":{...},
"length":0.5,
"width":0.5,
"height":0.5,
"diameter":0.5,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"string"
}
],
"unloading_cargos":[...],
{...}
"cargo_id":0,
"weight":0.5,
"volume":0.5,
"packaging_quantity":0,
"is_defined_by_ttn":false
}
],
"organization":{...}
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"firm_id":0,
"name":"string",
"ownership":0,
"residency":0,
"inn":"string",
"phone":"string",
"extra_phone":0,
"docs_address":{...},
"postcode":"string",
"city_id":0,
"street_name":"string",
"house_no":"string",
"office_no":"string"
},
"stocks":[...],
{...}
"stock_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address":"string",
"address_city_id":0,
"address_latitude":0.5,
"address_longitude":0.5,
"note":"string",
"work_schedules":[...],
{...}
"stock_schedule_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"day_of_week":0,
"start_time":"?",
"end_time":"?"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"day_of_week":0,
"start_time":"?",
"end_time":"?"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"schedule_summary":"string",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":0,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"ownership_name":"string"
}
}
],
"unloading":{...},
"fias_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"city_id":0,
"latitude":0.5,
"longitude":0.5,
"street":"string",
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"time_start":"1970-01-01T00:00:00.000Z",
"time_end":"1970-01-01T00:00:00.000Z",
"is_round_the_clock":false,
"large_cities":[...],
0
],
"large_cities_with_distance":[...],
{...}
"city_id":0,
"distance":0.5
}
],
"loading_cargos":[...],
{...}
"cargo_id":0,
"name_id":0,
"name":"string",
"packaging_type":0,
"packaging_quantity":0,
"weight":0.5,
"volume":0.5,
"sizes":{...},
"length":0.5,
"width":0.5,
"height":0.5,
"diameter":0.5,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"string"
}
],
"organization":{...}
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"firm_id":0,
"name":"string",
"ownership":0,
"residency":0,
"inn":"string",
"phone":"string",
"extra_phone":0,
"docs_address":{...},
"postcode":"string",
"city_id":0,
"street_name":"string",
"house_no":"string",
"office_no":"string"
},
"stocks":[...],
{...}
"stock_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address":"string",
"address_city_id":0,
"address_latitude":0.5,
"address_longitude":0.5,
"note":"string",
"work_schedules":[...],
{...}
"stock_schedule_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"day_of_week":0,
"start_time":"?",
"end_time":"?"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"day_of_week":0,
"start_time":"?",
"end_time":"?"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"schedule_summary":"string",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":0,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"ownership_name":"string"
}
},
"cargo":{...},
"weight":0.5,
"volume":0.5,
"adr":0,
"cargo_type_id":0,
"cargo_type":"string",
"pack_type":0,
"pallet_count":0,
"belt_count":0,
"dogruz_type":0,
"sbor_gruz":false,
"size":{...}
"length":0.5,
"width":0.5,
"height":0.5,
"diameter":0.5,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
}
},
"transport":{...},
"car_type":0,
"car_type_string":"string",
"loading_type":0,
"loading_logical_operator":"string",
"unloading_type":0,
"unloading_logical_operator":"string",
"trucks_quantity":0,
"temperature_from":0,
"temperature_to":0,
"stsepka":false,
"pnevmohod":false,
"koniki":false,
"tir":false,
"cmr":false,
"t1":false,
"san_passport":false,
"is_tracking":false,
"required_capacity":0.5
},
"boards":[...],
{...}
"board_id":"string",
"name":"string",
"color":"string"
}
],
"unload_first_date":"1970-01-01T00:00:00.000Z",
"unload_last_date":"1970-01-01T00:00:00.000Z"
},
"deal":{...}
"deal_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"load_copy_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"load_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"taker_ati_id":"string",
"taker_persistent_user_id":0,
"taker_contact_id":0,
"cargo_owner_ati_id":"string",
"cargo_owner_persistent_user_id":0,
"updated_at":"1970-01-01T00:00:00.000Z",
"end_of_reservation":"1970-01-01T00:00:00.000Z",
"auction_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"status":0,
"counterparty_status":0,
"payment":{...},
"rates":[...],
{...}
"rate":0.5,
"rate_type":0,
"currency":0,
"active":false
}
],
"prepay_percent":0,
"prepay_percent_enabled":false,
"on_unloading":false,
"in_fuel":false,
"pay_days_enabled":false,
"pay_days":0,
"fixed_rate":false,
"torg":false,
"direct_contract":false,
"money_type":0
},
"pay_docs":{...},
"documents_copies":{...},
"checked":false,
"date":"1970-01-01T00:00:00.000Z"
},
"documents_original":{...},
"checked":false,
"date":"1970-01-01T00:00:00.000Z"
},
"documents_original_track":{...},
"transport_company_id":0,
"tracking_url":"string",
"tracking_number":"string",
"sending_date":"1970-01-01T00:00:00.000Z"
},
"payment":{...}
"checked":false,
"date":"1970-01-01T00:00:00.000Z"
}
},
"files":[...],
{...}
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"storage_file_id":"string",
"access":0,
"add_date":"1970-01-01T00:00:00.000Z",
"deal_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"is_counterparty_file":false,
"file_name":"string",
"size":0,
"link":"string",
"source_type":0,
"source_file_type":0,
"file_type":0,
"timeslots_warehouse_ids":[...]
0
]
}
],
"document_templates":[...],
{...}
"organization_address":"string",
"templates":[...]
{...}
"add_date":"1970-01-01T00:00:00.000Z",
"access":0,
"timeslots_warehouse_ids":[...],
0
],
"deal_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"deal_point_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"owner_firm_id":0,
"cargoes_ids_hash":0,
"contact_id":0,
"file_name":"string",
"file_id":"string",
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"size":0,
"link":"string"
}
]
}
],
"is_tracking":false,
"should_show_rate_to_driver":false,
"started_at":"1970-01-01T00:00:00.000Z",
"finished_at":"1970-01-01T00:00:00.000Z",
"denial_reason":"string",
"taker_requisites":{...},
"requisite_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"requisite_firm_name":"string",
"signer_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"own_ship_id":0,
"inn":"string",
"kpp":"string",
"requisite_type_id":0
},
"driver":{...},
"driver_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"parent_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"first_name":"string",
"second_name":"string",
"patronymic":"string",
"phone_number":"string",
"driver_license_number":"string",
"passport_series":"string",
"passport_number":"string",
"passport_issued_by":"string",
"passport_when_issued":"1970-01-01T00:00:00.000Z",
"registration":"string",
"is_attracted_driver":false,
"last_deal_related_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"description":"string",
"attracted_from":"string",
"scans":[...],
{...}
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"owner_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"path":"string",
"name":"string",
"type":0
}
],
"origin":0,
"date_of_birth":"1970-01-01T00:00:00.000Z",
"department_code_in_passport":"string",
"driver_inn":"string",
"in_cargo_owner_black_list":false,
"black_list_reasons":[...]
"string"
]
},
"truck":{...},
"truck_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"parent_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"last_deal_related_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"type":0,
"description":"string",
"brand_id":0,
"model":"string",
"number":"string",
"phone_number":"string",
"is_attracted_truck":false,
"ownership_type":0,
"car_type_id":0,
"capacity":0.5,
"volume":0.5,
"length":0.5,
"width":0.5,
"height":0.5,
"manufacture_year":0,
"vin":"string",
"vrc":"string",
"body_number":"string",
"dimension":0,
"truck_passport_number":"string",
"can_refrigerator":false,
"has_gen_set":false,
"truck_owner_name":"string",
"can_carry_heavy_container":false,
"can_carry_tall_container":false,
"verified":false,
"modification_restricted":false,
"scans":[...],
{...}
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"owner_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"path":"string",
"name":"string",
"type":0
}
],
"origin":0
},
"trailer":{...},
"truck_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"parent_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"last_deal_related_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"type":0,
"description":"string",
"brand_id":0,
"model":"string",
"number":"string",
"phone_number":"string",
"is_attracted_truck":false,
"ownership_type":0,
"car_type_id":0,
"capacity":0.5,
"volume":0.5,
"length":0.5,
"width":0.5,
"height":0.5,
"manufacture_year":0,
"vin":"string",
"vrc":"string",
"body_number":"string",
"dimension":0,
"truck_passport_number":"string",
"can_refrigerator":false,
"has_gen_set":false,
"truck_owner_name":"string",
"can_carry_heavy_container":false,
"can_carry_tall_container":false,
"verified":false,
"modification_restricted":false,
"scans":[...],
{...}
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"owner_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"path":"string",
"name":"string",
"type":0
}
],
"origin":0
},
"semi_trailer":{...},
"truck_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"parent_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"last_deal_related_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"type":0,
"description":"string",
"brand_id":0,
"model":"string",
"number":"string",
"phone_number":"string",
"is_attracted_truck":false,
"ownership_type":0,
"car_type_id":0,
"capacity":0.5,
"volume":0.5,
"length":0.5,
"width":0.5,
"height":0.5,
"manufacture_year":0,
"vin":"string",
"vrc":"string",
"body_number":"string",
"dimension":0,
"truck_passport_number":"string",
"can_refrigerator":false,
"has_gen_set":false,
"truck_owner_name":"string",
"can_carry_heavy_container":false,
"can_carry_tall_container":false,
"verified":false,
"modification_restricted":false,
"scans":[...],
{...}
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"owner_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"path":"string",
"name":"string",
"type":0
}
],
"origin":0
},
"document":{...},
"id":"string",
"old_id":"string",
"editor":"string",
"url":"string",
"old_url":"string",
"name":"string",
"is_signed":false,
"access":0
},
"additional_documents":[...],
{...}
"id":"string",
"is_counterparty_file":false,
"url":"string",
"name":"string",
"is_signed":false,
"document_type":0,
"access":0
}
],
"in_work_status_model":0,
"in_work":{...},
"deal_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"in_work_status":0,
"in_work_date":"1970-01-01T00:00:00.000Z",
"ati_id":"string",
"contact_id":0,
"tracker_phone":0.5
},
"deal_note":"string",
"deal_kind":0,
"points":[...]
{...}
"deal_point_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"ordinal_id":0,
"point_type":0,
"city_id":0,
"lat":0.5,
"lon":0.5,
"address":"string",
"participant_name":"string",
"region_id":0,
"contact_name":"string",
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"stock_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"stock":{...},
"stock_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address":"string",
"address_city_id":0,
"note":"string",
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"schedule_summary":"string",
"stock_type":0,
"timeslots_warehouse_id":0
},
"organization":{...}
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"extra_phone":0,
"contact_persons":[...]
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
]
}
}
]
}
}
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
{...}

Модель ошибки

reason: string

Причина ошибки

error: string

Ключ ошибки

}
Пример
{...}
"reason":"string",
"error":"string"
}

Если грузовладельца устроит ваше предложение, он сможет оформить сделку одним из указанных ниже способов:

  • с использованием сервиса «АТИ-Доки» - документооборот будет вестись через ATI.SU. Грузовладелец сформирует документ на перевозку и отправит его вам на согласование. Узнать ID полученного документа можно с помощью метода получения информации по Заказу - данная информация появится в структуре document. Для того, чтобы одобрить документ с вашей стороны, воспользуйтесь методом одобрения документа. После того, как вы одобрите документ, Заказ будет переведен в исполнение. При необходимости документ на перевозку может быть подписан с помощью электронной цифровой подписи.
Получение информации по Заказу
get /v1.2/orders/{dealId}
Запрос
Пример запроса
curl 'https://api.ati.su/v1.2/orders/{dealId}' \
-X 'GET' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Возвращает информацию по Заказу
Модель
{...}
}
Пример
{...}
"load_copy":{...},
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"load_number":"string",
"load_meta":{...},
"load_meta_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"meta_data":"string"
},
"auction_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"updated_at":"1970-01-01T00:00:00.000Z",
"added_at":"1970-01-01T00:00:00.000Z",
"archive_date":"1970-01-01T00:00:00.000Z",
"distance":0,
"distance_type":0,
"platon_roads_length":0,
"toll_roads_length":0,
"travel_time":"?",
"true_price":0,
"true_currency_id":0,
"parent_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"is_unpublished":false,
"firm_id":0,
"contact_id1":0,
"contact_id2":0,
"note":"string",
"first_date":"1970-01-01T00:00:00.000Z",
"last_date":"1970-01-01T00:00:00.000Z",
"date_type":0,
"periodicity_id":0,
"order_number":"string",
"krugoreis":false,
"zimnik":false,
"ferries":false,
"loading":{...},
"fias_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"city_id":0,
"latitude":0.5,
"longitude":0.5,
"street":"string",
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"time_start":"1970-01-01T00:00:00.000Z",
"time_end":"1970-01-01T00:00:00.000Z",
"is_round_the_clock":false,
"large_cities":[...],
0
],
"large_cities_with_distance":[...],
{...}
"city_id":0,
"distance":0.5
}
],
"loading_cargos":[...],
{...}
"cargo_id":0,
"name_id":0,
"name":"string",
"packaging_type":0,
"packaging_quantity":0,
"weight":0.5,
"volume":0.5,
"sizes":{...},
"length":0.5,
"width":0.5,
"height":0.5,
"diameter":0.5,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"string"
}
],
"organization":{...}
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"firm_id":0,
"name":"string",
"ownership":0,
"residency":0,
"inn":"string",
"phone":"string",
"extra_phone":0,
"docs_address":{...},
"postcode":"string",
"city_id":0,
"street_name":"string",
"house_no":"string",
"office_no":"string"
},
"stocks":[...],
{...}
"stock_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address":"string",
"address_city_id":0,
"address_latitude":0.5,
"address_longitude":0.5,
"note":"string",
"work_schedules":[...],
{...}
"stock_schedule_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"day_of_week":0,
"start_time":"?",
"end_time":"?"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"day_of_week":0,
"start_time":"?",
"end_time":"?"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"schedule_summary":"string",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":0,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"ownership_name":"string"
}
},
"extra_points":[...],
{...}
"route_point_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"load_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"city_id":0,
"point_type":0,
"ordinal_id":0,
"distance":0,
"street":"string",
"latitude":0.5,
"longitude":0.5,
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"loading_date_start":"1970-01-01T00:00:00.000Z",
"loading_date_end":"1970-01-01T00:00:00.000Z",
"loading_time_start":null,
"loading_time_end":null,
"is_round_the_clock":false,
"city_name":"string",
"loading_cargos":[...],
{...}
"cargo_id":0,
"name_id":0,
"name":"string",
"packaging_type":0,
"packaging_quantity":0,
"weight":0.5,
"volume":0.5,
"sizes":{...},
"length":0.5,
"width":0.5,
"height":0.5,
"diameter":0.5,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"string"
}
],
"unloading_cargos":[...],
{...}
"cargo_id":0,
"weight":0.5,
"volume":0.5,
"packaging_quantity":0,
"is_defined_by_ttn":false
}
],
"organization":{...}
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"firm_id":0,
"name":"string",
"ownership":0,
"residency":0,
"inn":"string",
"phone":"string",
"extra_phone":0,
"docs_address":{...},
"postcode":"string",
"city_id":0,
"street_name":"string",
"house_no":"string",
"office_no":"string"
},
"stocks":[...],
{...}
"stock_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address":"string",
"address_city_id":0,
"address_latitude":0.5,
"address_longitude":0.5,
"note":"string",
"work_schedules":[...],
{...}
"stock_schedule_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"day_of_week":0,
"start_time":"?",
"end_time":"?"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"day_of_week":0,
"start_time":"?",
"end_time":"?"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"schedule_summary":"string",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":0,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"ownership_name":"string"
}
}
],
"unloading":{...},
"fias_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"city_id":0,
"latitude":0.5,
"longitude":0.5,
"street":"string",
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"time_start":"1970-01-01T00:00:00.000Z",
"time_end":"1970-01-01T00:00:00.000Z",
"is_round_the_clock":false,
"large_cities":[...],
0
],
"large_cities_with_distance":[...],
{...}
"city_id":0,
"distance":0.5
}
],
"loading_cargos":[...],
{...}
"cargo_id":0,
"name_id":0,
"name":"string",
"packaging_type":0,
"packaging_quantity":0,
"weight":0.5,
"volume":0.5,
"sizes":{...},
"length":0.5,
"width":0.5,
"height":0.5,
"diameter":0.5,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"string"
}
],
"organization":{...}
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"firm_id":0,
"name":"string",
"ownership":0,
"residency":0,
"inn":"string",
"phone":"string",
"extra_phone":0,
"docs_address":{...},
"postcode":"string",
"city_id":0,
"street_name":"string",
"house_no":"string",
"office_no":"string"
},
"stocks":[...],
{...}
"stock_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address":"string",
"address_city_id":0,
"address_latitude":0.5,
"address_longitude":0.5,
"note":"string",
"work_schedules":[...],
{...}
"stock_schedule_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"day_of_week":0,
"start_time":"?",
"end_time":"?"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"day_of_week":0,
"start_time":"?",
"end_time":"?"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"schedule_summary":"string",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":0,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"ownership_name":"string"
}
},
"cargo":{...},
"weight":0.5,
"volume":0.5,
"adr":0,
"cargo_type_id":0,
"cargo_type":"string",
"pack_type":0,
"pallet_count":0,
"belt_count":0,
"dogruz_type":0,
"sbor_gruz":false,
"size":{...}
"length":0.5,
"width":0.5,
"height":0.5,
"diameter":0.5,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
}
},
"transport":{...},
"car_type":0,
"car_type_string":"string",
"loading_type":0,
"loading_logical_operator":"string",
"unloading_type":0,
"unloading_logical_operator":"string",
"trucks_quantity":0,
"temperature_from":0,
"temperature_to":0,
"stsepka":false,
"pnevmohod":false,
"koniki":false,
"tir":false,
"cmr":false,
"t1":false,
"san_passport":false,
"is_tracking":false,
"required_capacity":0.5
},
"boards":[...],
{...}
"board_id":"string",
"name":"string",
"color":"string"
}
],
"unload_first_date":"1970-01-01T00:00:00.000Z",
"unload_last_date":"1970-01-01T00:00:00.000Z"
},
"deal":{...}
"deal_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"load_copy_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"load_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"taker_ati_id":"string",
"taker_persistent_user_id":0,
"taker_contact_id":0,
"cargo_owner_ati_id":"string",
"cargo_owner_persistent_user_id":0,
"updated_at":"1970-01-01T00:00:00.000Z",
"end_of_reservation":"1970-01-01T00:00:00.000Z",
"auction_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"status":0,
"counterparty_status":0,
"payment":{...},
"rates":[...],
{...}
"rate":0.5,
"rate_type":0,
"currency":0,
"active":false
}
],
"prepay_percent":0,
"prepay_percent_enabled":false,
"on_unloading":false,
"in_fuel":false,
"pay_days_enabled":false,
"pay_days":0,
"fixed_rate":false,
"torg":false,
"direct_contract":false,
"money_type":0
},
"pay_docs":{...},
"documents_copies":{...},
"checked":false,
"date":"1970-01-01T00:00:00.000Z"
},
"documents_original":{...},
"checked":false,
"date":"1970-01-01T00:00:00.000Z"
},
"documents_original_track":{...},
"transport_company_id":0,
"tracking_url":"string",
"tracking_number":"string",
"sending_date":"1970-01-01T00:00:00.000Z"
},
"payment":{...}
"checked":false,
"date":"1970-01-01T00:00:00.000Z"
}
},
"files":[...],
{...}
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"storage_file_id":"string",
"access":0,
"add_date":"1970-01-01T00:00:00.000Z",
"deal_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"is_counterparty_file":false,
"file_name":"string",
"size":0,
"link":"string",
"source_type":0,
"source_file_type":0,
"file_type":0,
"timeslots_warehouse_ids":[...]
0
]
}
],
"document_templates":[...],
{...}
"organization_address":"string",
"templates":[...]
{...}
"add_date":"1970-01-01T00:00:00.000Z",
"access":0,
"timeslots_warehouse_ids":[...],
0
],
"deal_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"deal_point_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"owner_firm_id":0,
"cargoes_ids_hash":0,
"contact_id":0,
"file_name":"string",
"file_id":"string",
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"size":0,
"link":"string"
}
]
}
],
"is_tracking":false,
"should_show_rate_to_driver":false,
"started_at":"1970-01-01T00:00:00.000Z",
"finished_at":"1970-01-01T00:00:00.000Z",
"denial_reason":"string",
"taker_requisites":{...},
"requisite_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"requisite_firm_name":"string",
"signer_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"own_ship_id":0,
"inn":"string",
"kpp":"string",
"requisite_type_id":0
},
"driver":{...},
"driver_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"parent_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"first_name":"string",
"second_name":"string",
"patronymic":"string",
"phone_number":"string",
"driver_license_number":"string",
"passport_series":"string",
"passport_number":"string",
"passport_issued_by":"string",
"passport_when_issued":"1970-01-01T00:00:00.000Z",
"registration":"string",
"is_attracted_driver":false,
"last_deal_related_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"description":"string",
"attracted_from":"string",
"scans":[...],
{...}
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"owner_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"path":"string",
"name":"string",
"type":0
}
],
"origin":0,
"date_of_birth":"1970-01-01T00:00:00.000Z",
"department_code_in_passport":"string",
"driver_inn":"string",
"in_cargo_owner_black_list":false,
"black_list_reasons":[...]
"string"
]
},
"truck":{...},
"truck_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"parent_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"last_deal_related_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"type":0,
"description":"string",
"brand_id":0,
"model":"string",
"number":"string",
"phone_number":"string",
"is_attracted_truck":false,
"ownership_type":0,
"car_type_id":0,
"capacity":0.5,
"volume":0.5,
"length":0.5,
"width":0.5,
"height":0.5,
"manufacture_year":0,
"vin":"string",
"vrc":"string",
"body_number":"string",
"dimension":0,
"truck_passport_number":"string",
"can_refrigerator":false,
"has_gen_set":false,
"truck_owner_name":"string",
"can_carry_heavy_container":false,
"can_carry_tall_container":false,
"verified":false,
"modification_restricted":false,
"scans":[...],
{...}
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"owner_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"path":"string",
"name":"string",
"type":0
}
],
"origin":0
},
"trailer":{...},
"truck_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"parent_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"last_deal_related_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"type":0,
"description":"string",
"brand_id":0,
"model":"string",
"number":"string",
"phone_number":"string",
"is_attracted_truck":false,
"ownership_type":0,
"car_type_id":0,
"capacity":0.5,
"volume":0.5,
"length":0.5,
"width":0.5,
"height":0.5,
"manufacture_year":0,
"vin":"string",
"vrc":"string",
"body_number":"string",
"dimension":0,
"truck_passport_number":"string",
"can_refrigerator":false,
"has_gen_set":false,
"truck_owner_name":"string",
"can_carry_heavy_container":false,
"can_carry_tall_container":false,
"verified":false,
"modification_restricted":false,
"scans":[...],
{...}
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"owner_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"path":"string",
"name":"string",
"type":0
}
],
"origin":0
},
"semi_trailer":{...},
"truck_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"parent_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"last_deal_related_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"type":0,
"description":"string",
"brand_id":0,
"model":"string",
"number":"string",
"phone_number":"string",
"is_attracted_truck":false,
"ownership_type":0,
"car_type_id":0,
"capacity":0.5,
"volume":0.5,
"length":0.5,
"width":0.5,
"height":0.5,
"manufacture_year":0,
"vin":"string",
"vrc":"string",
"body_number":"string",
"dimension":0,
"truck_passport_number":"string",
"can_refrigerator":false,
"has_gen_set":false,
"truck_owner_name":"string",
"can_carry_heavy_container":false,
"can_carry_tall_container":false,
"verified":false,
"modification_restricted":false,
"scans":[...],
{...}
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"owner_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"path":"string",
"name":"string",
"type":0
}
],
"origin":0
},
"document":{...},
"id":"string",
"old_id":"string",
"editor":"string",
"url":"string",
"old_url":"string",
"name":"string",
"is_signed":false,
"access":0
},
"additional_documents":[...],
{...}
"id":"string",
"is_counterparty_file":false,
"url":"string",
"name":"string",
"is_signed":false,
"document_type":0,
"access":0
}
],
"in_work_status_model":0,
"in_work":{...},
"deal_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"in_work_status":0,
"in_work_date":"1970-01-01T00:00:00.000Z",
"ati_id":"string",
"contact_id":0,
"tracker_phone":0.5
},
"deal_note":"string",
"deal_kind":0,
"points":[...]
{...}
"deal_point_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"ordinal_id":0,
"point_type":0,
"city_id":0,
"lat":0.5,
"lon":0.5,
"address":"string",
"participant_name":"string",
"region_id":0,
"contact_name":"string",
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"stock_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"stock":{...},
"stock_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address":"string",
"address_city_id":0,
"note":"string",
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"schedule_summary":"string",
"stock_type":0,
"timeslots_warehouse_id":0
},
"organization":{...}
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"extra_phone":0,
"contact_persons":[...]
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
]
}
}
]
}
}
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
{...}

Модель ошибки

reason: string

Причина ошибки

error: string

Ключ ошибки

}
Пример
{...}
"reason":"string",
"error":"string"
}
Одобрить документ
put /documents/{doc_id}/approve/
Запрос
Пример запроса
curl 'https://api.ati.su/documents/{doc_id}/approve/' \
-X 'PUT' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Результат запроса
Модель
{...}

Результат сохранения документа

ok: enum
[true]
result: string

Идентификатор документа

}
Пример
{...}
"ok":true,
"result":"12345676554321"
}
400 Ошибка запроса, документ не может быть одобрен.
Модель
{...}

Сообщение об ошибке

error*: string (nullable)

Код ошибки

reason*: string

Описание ошибки и возможная причина

}
Пример
{...}
"error":"bad_request",
"reason":"Ошибка в запросе"
}

Полная документация API АТИ-Доков.

  • без использования «АТИ-Доков» - как только Заказ будет одобрен грузовладельцем, он будет переведен в исполнение.

Если у назначенного вами на Заказ водителя установлено приложение «АТИ Водитель», отправьте Заказ данному водителю с помощью метода назначения Заказа на водителя:

Назначение заказа на водителя.
put /v1.2/orders/carrier/{dealId}/driver_tracker_points
Запрос
Модель
[{...}]
deal_point_id*: guid
Минимальное количество символов: 1

Id точки из Заказа

time: string

Время

date: string

Дата

time_to: string

Время до (если есть)

date_to: string

Дата до (если есть)

lat: double (nullable)

Широта точки

lon: double (nullable)

Долгота точки

address: string

Адрес

note: string

Примечание (до 1000 символов)

timeslots_warehouse_id: int32 (nullable)

Айди склада из временных окон

}]
Пример запроса
curl 'https://api.ati.su/v1.2/orders/carrier/{dealId}/driver_tracker_points' \
-X 'PUT' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json' \
--data-raw '[{"deal_point_id":"2fb965f2-85e9-4213-90e7-f396e47219e7","time":"10:00","date":"02.01.2019","time_to":"01:00","date_to":"13.02.2019","lat":30.3330562,"lon":59.974006,"address":"гор. Санкт-Петербург","contact_persons":[{"name":"string","phone":"string","ordinal_id":1}],"note":"string","timeslots_warehouse_id":0}]'
Ответ
200 Созданная информация по заказу
Модель
[{...}]
deal_point_id: guid

Id точки из Заказа

ordinal_id: int32

Порядковый номер точки

time: string

Время

date: string

Дата

time_to: string

Время до (если есть)

date_to: string

Дата до (если есть)

lat: double (nullable)

Широта точки

lon: double (nullable)

Долгота точки

address: string

Адрес

city_id: int32

Id города
Значение из словаря городов ATI.SU

region_id: int32

Id региона
Значение из словаря регионов ATI.SU

country_id: int32

Id страны
Значение из словаря стран ATI.SU

point_type: enum
[1, 2, 3, 8]

Тип точки

  • 1 — Загрузка
  • 2 — Разгрузка
note: string

Примечание (до 1000 символов)

timeslots_warehouse_id: int32 (nullable)

Айди склада из временных окон

}]
Пример
[...]
{...}
"deal_point_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"ordinal_id":1,
"time":"10:00",
"date":"2.1.2019",
"time_to":"1:00",
"date_to":"13.2.2019",
"lat":30.3330562,
"lon":59.974006,
"address":"гор. Санкт-Петербург",
"city_id":0,
"region_id":0,
"country_id":0,
"point_type":0,
"contact_persons":[...],
{...}
"name":"string",
"phone":"string",
"ordinal_id":1
}
],
"note":"string",
"timeslots_warehouse_id":0
}
]
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
{...}

Модель ошибки

reason: string

Причина ошибки

error: string

Ключ ошибки

}
Пример
{...}
"reason":"string",
"error":"string"
}

После того, как водитель подтвердит получение Заказа в приложении, вы сможете отслеживать пройденный водителем маршрут и получать историю событий, произошедших в пути следования водителя.

Получение информации о пройденном маршруте АТИ Водителя
get /v1.2/orders/carrier/map_route/by_deal
Запрос
Пример запроса
curl 'https://api.ati.su/v1.2/orders/carrier/map_route/by_deal' \
-X 'GET' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Информация для карты
Модель
[{...}]
}]
Пример
[...]
{...}
"goals":[...],
{...}
"longitude":0.5,
"latitude":0.5,
"events":[...],
{...}
"type":0,
"tag":"string",
"date":"1970-01-01T00:00:00.000Z",
"date_to":"1970-01-01T00:00:00.000Z",
"time":"string",
"time_to":"string",
"location_name":{...}
"country":"string",
"region":"string",
"city":"string",
"address":"string"
}
}
],
"ordinal_id":0,
"trace":false
}
],
"traces":[...]
{...}
"car":{...},
"driver_phone":"string",
"car_status":0
},
"first_action":"1970-01-01T00:00:00.000Z",
"last_action":"1970-01-01T00:00:00.000Z",
"points":[...]
{...}
"longitude":0.5,
"latitude":0.5,
"events":[...],
{...}
"type":0,
"tag":"string",
"date":"1970-01-01T00:00:00.000Z",
"date_to":"1970-01-01T00:00:00.000Z",
"time":"string",
"time_to":"string",
"location_name":{...}
"country":"string",
"region":"string",
"city":"string",
"address":"string"
}
}
],
"location_date":"1970-01-01T00:00:00.000Z",
"is_fake":false,
"is_disabled":false,
"is_no_data":false,
"is_power_saving":false,
"is_empty_run":false,
"is_parking":false
}
]
}
]
}
]
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
{...}

Модель ошибки

reason: string

Причина ошибки

error: string

Ключ ошибки

}
Пример
{...}
"reason":"string",
"error":"string"
}
Получение истории
get /v1.2/orders/carrier/map/history
Запрос
Пример запроса
curl 'https://api.ati.su/v1.2/orders/carrier/map/history' \
-X 'GET' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 История выполнения заказа водителем
Модель
[{...}]
}]
Пример
[...]
{...}
"events":[...]
{...}
"date":"1970-01-01T00:00:00.000Z",
"event":{...},
"type":0,
"tag":"string",
"date":"1970-01-01T00:00:00.000Z",
"date_to":"1970-01-01T00:00:00.000Z",
"time":"string",
"time_to":"string",
"location_name":{...}
"country":"string",
"region":"string",
"city":"string",
"address":"string"
}
},
"longitude":0.5,
"latitude":0.5,
"params":[...]
"string"
]
}
]
}
]
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
{...}

Модель ошибки

reason: string

Причина ошибки

error: string

Ключ ошибки

}
Пример
{...}
"reason":"string",
"error":"string"
}

Подробнее о методах для работы с Заказами с участием приоложения «АТИ Водитель» описано тут.

Заказу, находящемуся в исполнении, могут быть присвоены различные статусы: едет на загрузку, ожидает загрузку, загружается и т. д. Для того, чтобы изменить статусы перевозки, воспользуйтесь методом смены статусов перевозки Заказа. Статусы можете менять как вы, так и грузовладелец.

Смена cтатуса перевозки Заказа
post /v1.2/orders/{dealId}/inwork
Запрос
Модель
{...}
in_work_status: enum
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 100]

Статус перевозки

  • 0 — Нет статуса
  • 1 — Едет на загрузку
  • 2 — Ожидает загрузку
  • 3 — Загружается
  • 4 — Загрузился, едет на выгрузку
  • 5 — Ожидает выгрузку
  • 6 — Выгружается
  • 7 — Выгрузился
  • 8 — Поломка
  • 9 — ДТП
  • 10 — Арест ТС
  • 11 — Контейнер получен на погрузку
  • 12 — Контейнер на погрузке
  • 13 — Погрузка контейнера окончена
  • 14 — Контейнер сдан с погрузки
  • 15 — Контейнер получен на выгрузку
  • 16 — Контейнер на выгрузке
  • 17 — Выгрузка контейнера окончена
  • 18 — Контейнер сдан с выгрузки
  • 19 — Пустой контейнер получен
  • 20 — Пустой контейнер сдан
  • 100 — Заказ завершён
}
Пример запроса
curl 'https://api.ati.su/v1.2/orders/{dealId}/inwork' \
-X 'POST' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json' \
--data-raw '{"in_work_status":0}'
Ответ
200 Успешное изменение статуса
Модель
boolean
Пример
null
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
{...}

Модель ошибки

reason: string

Причина ошибки

error: string

Ключ ошибки

}
Пример
{...}
"reason":"string",
"error":"string"
}

После того, как Заказ будет выполнен, его можно завершить.

Завершение перевозки
put /v1.2/orders/{dealId}/finish
Запрос
Пример запроса
curl 'https://api.ati.su/v1.2/orders/{dealId}/finish' \
-X 'PUT' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Успешное завершение
Модель
null
Пример
null
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
{...}

Модель ошибки

reason: string

Причина ошибки

error: string

Ключ ошибки

}
Пример
{...}
"reason":"string",
"error":"string"
}

Полная документация API Заказов.