REST API DropCat: создание документа

POST /createDocument

Метод предназначен для создания документа на платформе. Документ создается в статусе Черновик (DRAFT), после этого документ можно обновить и удалить.

Формат запроса

Запрос на создание документа следует отправлять с помощью метода POST.

/createDocument
? [id_type= <тип идентификатора>]
& [org_id= <идентификатор>]
& [org_id_sender= <идентификатор>]
& [org_id_receiver= <идентификатор>]
& [document_type= <тип документа>]
& [file_name= <наименование документа>]
& [doc_number= <номер документа>]
& [doc_date= <дата>]

Параметры запроса

Параметр	Пример значения	Описание	Тип параметра	Тип данных
id_type*	gln	Тип идентификатора организации. Принимает значения: gln или fns.	query	string
org_id*	2000000009994	Идентификатор запроса организации-инициатора запроса.	query	string
org_id_sender*	2000000009994	Идентификатор запроса организации-отправителя запроса.	query	string
org_id_receiver*	2000000007705	Идентификатор запроса организации-получателя запроса. Если у файла обмена несколько получателей, необходимо указывать идентификатор первого (основного). Например, для Титула Грузоотправителя ЭТрН необходимо указывать идентификатор Перевозчика, так как в имени файла обмена первым среди идентификаторов получателей указан идентификатор Перевозчика.	query	string
document_type*	WAYBILL_T1_ON_PTLSSOBTS	Тип документа. Тип документа может принимать значения: • FORWARDING_ORDER - Поручение экспедитору • TRANSPORT_IFTMBP - Предварительный запрос на автотранспорт • TRANSPORT_IFTMBC - Ответ на предварительный запрос на автотранспорт • ETRN_FNS_GO - ЭТРН. Титул 1. Титул грузоотправителя • ETRN_FNS_TK_LOAD - ЭТРН. Титул 2. Титул транспортной компании (погрузка) • ETRN_FNS_GP - ЭТРН. Титул 3. Титул грузополучателя • ETRN_FNS_TK_UNLOAD - ЭТРН. Титул 4. Титул транспортной компании(разгрузка) • ETRN_FNS_TK_CHANGE_FINANCE - ЭТРН. Титул 5. Титул Перевозчика об изменении ФС • ETRN_FNS_GO_CHANGE_FINANCE - ЭТРН. Титул 6. Титул Грузоотправителя о подтверждении факта изменения ФС • ETRN_FNS_TK_READDRESS - ЭТРН. Титул 7. Титул переадресовки • ETRN_FNS_TK_CORRECT - ЭТРН. Титул 8. Титул замены водителя(водителей) и (или) транспортного средства • ETRN_FNS_DP_UVUTOCH -ЭТРН. Уведомление об уточнении • ETRN_FNS_UVPERADR - ЭТРН. Уведомление о переадресовке • WAYBILL_T1_ON_PTLSSOBTS - Обстоятельства и особенности рейса (титул 1) • WAYBILL_T2_ON_PTLSPRMO - Результат предсменного, предрейсового медицинского осмотра (титул 2) • WAYBILL_T3_ON_PTLSVIPTS - Выпуск транспортного средства на линию (титул 3) • WAYBILL_T4_ON_PTLSODVZD - Показания одометра (выезд/прием транспортного средства) (титул 4) • WAYBILL_T5_ON_PTLSODPARK - Показания одометра (заезд/сдача транспортного средства) (титул 5) • WAYBILL_T6_ON_PTLSPOSMO - Результат послесменного, послерейсового медицинского осмотра (титул 6) • ORDER_FNS_GO - ЭЗЗ. Титул 1. Титул грузоотправителя • ORDER_FNS_TK - ЭЗЗ. Титул 2. Титул перевозчика • EDI_CONTRL - Нотификация	query	string
file_name*	0402_WAYBILL_T1_ON_PTLSSOBTS.xml	Имя файла c расширением.	query	string
doc_number	MDItMDQJ	Номер документа на платформе в кодировке base64.	query	string
doc_date	2019-04-02	Дата создания документа, формат utc - yyyy-MM-dd. Если в запросе не указано, то обработчик API подставляет текущую дату.	query	date-time

*Обязательный параметр.

В теле запроса передается xml-документ в кодировке base64.

Формат ответа

Если запрос был обработан без ошибок, API отвечает кодом: 200.
Если запрос вызвал ошибку, возвращается подходящий код ответа, а тело ответа содержит описание ошибки.

URL запроса

https://dapi-preprod.ediweb.ru/edi/api/v1.1/createDocument?id_type=gln&org_id=2000000009994&org_id_sender=2000000009994&org_id_receiver=2000000007705&document_type=WAYBILL_T1_ON_PTLSSOBTS&file_name=0402_WAYBILL_T1_ON_PTLSSOBTS.xml&doc_number=MDItMDQJ&doc_date=2019-04-02

Тело ответа

<?xml version="1.0" encoding="windows-1251" standalone="yes"?><Файл ИдФайл="ON_PTLSSOBTS___2IJ92B02C5A435544C7AAA90E7FB5AC4BE2_2IJ92B02C5A435544C7AAA90E7FB5AC4BE2_0_20230908_bb68941f-cbcc-4317-93bb-c15d32faf5bd" ВерсПрог="DropCat" ВерсФорм="5.01"><Документ КНД="1110380" ДатИнфСоб="08.09.2023" ВрИнфСоб="10:59:20" ДатаПЛ="08.09.2023" ПризнНачРейс="2" УИДПЛПред="35572ddf-c967-489a-8f21-076d6ac3de96"><СодИнфСоб УИД_ПЛ="1b90628c-23d0-4b5c-a6e1-22e2edacf7f7" ОбМедОсмПосле="1" ВидПрв="КП" ВидКП="РП" ВидСообщ="Г"><МестОтпр><ГЛН>4680328247002</ГЛН><Адрес><АдрРФ Индекс="352630" КодРегион="23" Район="Белореченский р-н" Город="Белореченск" Улица="Мира ул." Дом="89"/></Адрес></МестОтпр><АдрПункт><ГЛН>4607164990558</ГЛН><Адрес><АдрРФ Индекс="352500" КодРегион="23" Район="Лабинский р-н" Город="Лабинск" Улица="Карла Маркса ул." Дом="190" Кварт="А40"/></Адрес></АдрПункт><СрокПЛ ПЛДень="1" ДатаИспПЛ="17.08.2023"/><СвЛицПЛ ЛицоОфПЛ="С"><ИдСв><СвЮЛУч НаимОрг="Поставщик УПД" ИННЮЛ="7612312312" КПП="123321123" ОГРН="2121212121212"/></ИдСв><Адрес><АдрРФ Индекс="610000" КодРегион="43" Район="Советский" Город="Советск" Улица="ул Ленина" Дом="5" Корпус="1" Кварт="12"/></Адрес><Контакт><Тлф>88008008080</Тлф><ЭлПочта>test@test.ru</ЭлПочта></Контакт></СвЛицПЛ><СвТС><ТС Тип="легковая" Марка="opel" Модель="1" РегНомер="1dd111"/></СвТС><СвВодит><ВодитУд НомВУ="123456" СерВУ="1234" ДатаВыдВУ="31.08.2023"/><ФИО Фамилия="МДК" Имя="Елена"/></СвВодит></СодИнфСоб><ПодпИнфСоб Должн="Дебитор" СпосПодтПолном="6"><ФИО Фамилия="Дебиторов" Имя="Тестовый"/></ПодпИнфСоб></Документ></Файл>

HTTP код ответа

Заголовки ответа

{
  "connection": "keep-alive",
  "content-length": "1982",
  "content-type": "text/plain; charset=UTF-8",
  "date": "Thu, 02 Oct 2023 14:16:14 GMT",
  "doc_id": "103940815",
  "container_id": "103940814", 
  "request_uuid": "0f1ec66f-b5b1-49c2-8932-c2cccbe55137",
  "server": "nginx"
}

19 июня 2026 г.