REST API DropCat: получение списка документов по UID
GET /getDocumentsByUid
Метод используется для фильтрации ЭПД по УИД.
Формат запроса
Запрос на получение списка документов следует отправлять с помощью метода GET.
/getDocumentsByUid
? [id_type= <тип идентификатора>]
& [org_id= <идентификатор>]
& [document_type= <тип документа>]
& [states= <статус документа>]
& [uid= <УИД документа>
Параметры запроса
| Параметр | Пример значения | Описание | Тип параметра | Тип данных |
|---|---|---|---|---|
| id_type* | gln | Тип идентификатора организации. Принимает значения: gln или fns | query | string |
| org_id* | 2000000009994 | Идентификатор организации-инициатора запроса | query | string |
| uid* |
3c98c6a5-a3ce-45da-9bae-8e42d78ea3ef |
УИД ГИС ЭПД | query | string |
| document_type |
WAYBILL_T1_ON_PTLSSOBTS |
Тип документа. Тип документа может принимать значения: |
query | string |
| states |
|
Статус документа. Параметр может принимать несколько значений, в таком случае статусы указываются через запятую, без пробелов. Например, DRAFT, READ, SENT. Может принимать значения: |
query | string |
* Обязательный параметр.
Формат ответа
Если запрос был обработан без ошибок, API отвечает кодом 200.
Если запрос вызвал ошибку, возвращается подходящий код ответа, а тело ответа содержит описание ошибки.
Curl
curl -X GET --header "Accept: application/json" "https://dapi-preprod.ediweb.ru/edi/api/v1.1/getDocumentsByUid?id_type=gln&org_id=2000000009994&document_type=WAYBILL_T1_ON_PTLSSOBTS &uid=3c98c6a5-a3ce-45da-9bae-8e42d78ea3ef&states=COMPLETED"
URL запроса
https://dapi-preprod.ediweb.ru/edi/api/v1.1/getDocumentsByUid?id_type=gln&org_id=2000000009994&document_type=ETRN_FNS_GO&uid=3c98c6a5-a3ce-45da-9bae-8e42d78ea3ef&states=COMPLETED
Тело ответа
{
"success": true,
"data": {
"titles": [
{
"id": 112477656,
"type": "ETRN_FNS_T1",
"titleName": "Титул грузоотправителя",
"uid": null,
"status": "COMPLETED",
"creationDate": 1776670771753,
"modifyDate": 1776670801353,
"fromOrg": {
"id": 56073,
"name": "Тестовый ГО",
"inn": "9999999999",
"kpp": "391111562"
},
"toOrg": {
"id": 56085,
"name": "Тестовый ГП",
"inn": "8811111118",
"kpp": "717111447"
}
]
}
}
HTTP код ответа
200
Заголовки ответа
{
"connection": "keep-alive",
"content-length": "33",
"content-type": "text/plain; charset=UTF-8",
"date": "Fri, 14 Aug 2026 15:14:07 GMT",
"request_uuid": "8e677a13-efd9-4f68-af4c-35d5ecc82362",
"server": "nginx"
}