Метод получения структуры XML отгрузки через API
Этот эндпоинт предназначен для интеграций и решений, которым необходимо получать структуру XML-файла УПД или ЭТрН, сформированную на основе документа «Отгрузка» в МойСклад.
XML формируется по тем же правилам, что и при экспорте документа через пользовательский интерфейс:
- УПД: Отгрузка → ЭДО → экспорт XML УПД;
- ЭТрН: Отгрузка → ЭДО → Экспортировать XML ЭТрН.
URL и метод
GET https://online.moysklad.ru/api/gov_fns/demand/{uuid}
Где {uuid} — идентификатор отгрузки в формате 8-4-4-4-12 шестнадцатеричных символов.
Некорректный формат приводит к ошибкам.
Тело запроса не используется и игнорируется.
Авторизация
Эндпоинт поддерживает два метода:
Basic
Authorization: Basic <Base64(username:password)>
Bearer
Authorization: Bearer <token>
где <token> — токен, который можно получить:
- на UI МоегоСклада в реестре Токены;
- с помощью JSON API;
- с помощью Vendor API для работы решения.
Заголовки запроса
Authorization: <один из методов авторизации>
Accept-Encoding: gzip
Параметры URL
Параметры опциональны. Их назначение — выбрать тип и версию XML-документа и обеспечить обратную совместимость при появлении новых версий.
decree_type
Префикс типа документа.
| Допустимое значение decree_type | Документ | Примечание |
|---|---|---|
| ON_NSCHFDOPPR | УПД | Значение по умолчанию, если параметр decree_type не передан |
| ON_TRNACLGROT | ЭТрН |
decree_version
Версия схемы XML. Допустимое значение зависит от decree_type.
| decree_type | Допустимое значение decree_version | Примечание |
|---|---|---|
| ON_NSCHFDOPPR | 5.03 | Значение по умолчанию, если параметр decree_version не передан |
| ON_TRNACLGROT | 5.01 |
Использование параметров URL
| decree_type | decree_version | Результат |
|---|---|---|
| не передан / ON_NSCHFDOPPR | не передан / 5.03 |
XML УПД 5.03 |
| ON_TRNACLGROT | 5.01 |
XML ЭТрН 5.01 |
Иное значение или несовместимая пара параметров → 400 Invalid Parameter (code 1014).
Неизвестные параметры игнорируются.
Успешный ответ
HTTP 200 OK
Content-Type: text/xml; charset=windows-1251
Content-Encoding: gzip
Тело ответа содержит структуру XML-файла, сформированную на основании указанной отгрузки.
Это не скачиваемый файл, а XML-документ в теле ответа.
Тип XML определяется параметрами запроса (УПД или ЭТрН).
Ошибки
Формат тела определяется заголовком:
Content-Type: application/json
Тело содержит массив errors с полями error и code.
Основные случаи ошибок
| HTTP | code | Описание |
|---|---|---|
| 401 | 1056 | Ошибка аутентификации |
| 403 | 1064 | Недостаточно прав на печать отгрузки |
| 400 | 1014 | Некорректное значение параметра или несовместимая пара decree_type / decree_version |
| 412 | 1000 | UUID в неверном формате |
| 404 | 1002 | Отгрузка не найдена |
| 405 | 1039 | Метод не поддерживается |
| 5xx | 1999 | Ошибка формирования XML |
Пример:
{
"errors": [
{
"error": "Неверное значение '0.00' параметра фильтрации 'decree_version'",
"code": 1014
}
]
}
Пример запроса и ответа
Пример получения XML файла для УПД
Запрос
curl -X GET \
"https://online.moysklad.ru/api/gov_fns/demand/2d9338b5-ba51-11f0-0a83-0556000001ad" \
-H "Authorization: Bearer <token>" \
-H "Accept-Encoding: gzip"
Эквивалентно явному указанию параметров УПД:
curl -X GET \
"https://online.moysklad.ru/api/gov_fns/demand/2d9338b5-ba51-11f0-0a83-0556000001ad?decree_type=ON_NSCHFDOPPR&decree_version=5.03" \
-H "Authorization: Bearer <token>" \
-H "Accept-Encoding: gzip"
Ответ
HTTP 200 OK
content-type: text/xml;charset=windows-1251
content-encoding: gzip
body:
<?xml version="1.0" encoding="Windows-1251" standalone="yes"?>
<Файл ИдФайл="ON_NSCHFDOPPR___20251127_6df2ba12-aa0b-499a-8031-020340dad7d7_0_1_0_0_0_00" ВерсФорм="5.03" ВерсПрог="МойСклад">
<Документ КНД="1115131" Функция="ДОП" ПоФактХЖ="Документ об отгрузке товаров (выполнении работ), передаче имущественных прав (документ об оказании услуг)" НаимДокОпр="УПД" ДатаИнфПр="27.11.2025" ВремИнфПр="14.33.14" НаимЭконСубСост="ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ "ЛОГНЕКС", ИНН-КПП: 7736570901-773101001">
<СвСчФакт НомерДок="2" ДатаДок="27.11.2025">
<СвПрод СППО="84696461">
<ИдСв>
<СвЮЛУч НаимОрг="ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ "ЛОГНЕКС"" ИННЮЛ="7736570901" КПП="773101001"/>
</ИдСв>
<Адрес>
<АдрРФ Индекс="121205" КодРегион="77" НаимРегион="Москва" Город="г Москва, тер Сколково инновационного центра" Улица="Большой б-р" Дом="42 стр 1" Кварт="1617"/>
</Адрес>
<Контакт>
<ЭлПочта>example@moysklad.ru</ЭлПочта>
</Контакт>
</СвПрод>
<ГрузОт>
<ОнЖе>он же</ОнЖе>
</ГрузОт>
<ГрузПолуч СППО="84696461">
<ИдСв>
<СвЮЛУч НаимОрг="ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ "ЛОГНЕКС"" ИННЮЛ="7736570901" КПП="773101001"/>
</ИдСв>
<Адрес>
<АдрРФ Индекс="121205" КодРегион="77" НаимРегион="Москва" Город="г Москва, тер инновационного центра Сколково" Улица="Большой б-р" Дом="42 стр 1"/>
</Адрес>
<Контакт>
<ЭлПочта>example@moysklad.ru</ЭлПочта>
</Контакт>
</ГрузПолуч>
<ДокПодтвОтгрНом РеквНаимДок="УПД" РеквНомерДок="2" РеквДатаДок="27.11.2025"/>
<СвПокуп СППО="84696461">
<ИдСв>
<СвЮЛУч НаимОрг="ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ "ЛОГНЕКС"" ИННЮЛ="7736570901" КПП="773101001"/>
</ИдСв>
<Адрес>
<АдрРФ Индекс="121205" КодРегион="77" НаимРегион="Москва" Город="г Москва, тер Сколково инновационного центра" Улица="Большой б-р" Дом="42 стр 1" Кварт="1617"/>
</Адрес>
<Контакт>
<ЭлПочта>example@moysklad.ru</ЭлПочта>
</Контакт>
</СвПокуп>
<ДенИзм КодОКВ="643" НаимОКВ="Российский рубль"/>
</СвСчФакт>
<ТаблСчФакт>
<СведТов НомСтр="1" НаимТов="Ara Ботинки, Черный, 46" ОКЕИ_Тов="796" НаимЕдИзм="шт" КолТов="3.0" ЦенаТов="833.33" СтТовБезНДС="2500.00" НалСт="20%" СтТовУчНал="3000.00">
<СвДТ КодПроисх="356" НомерДТ="10131010/170924/3207188/9"/>
<ДопСведТов ПрТовРаб="1" КодТов="186873007">
<КрНаимСтрПр>Индия</КрНаимСтрПр>
<НомСредИдентТов ИдентТрансУпак="123456789123456789"/>
<НомСредИдентТов>
<КИЗ>1234567890123456789</КИЗ>
<КИЗ>1234567891234567</КИЗ>
</НомСредИдентТов>
</ДопСведТов>
<Акциз>
<БезАкциз>без акциза</БезАкциз>
</Акциз>
<СумНал>
<СумНал>500.00</СумНал>
</СумНал>
</СведТов>
<ВсегоОпл СтТовБезНДСВсего="2500.00" СтТовУчНалВсего="3000.00">
<СумНалВсего>
<СумНал>500.00</СумНал>
</СумНалВсего>
</ВсегоОпл>
</ТаблСчФакт>
<СвПродПер>
<СвПер СодОпер="Товары переданы" ДатаПер="27.11.2025">
<БезДокОснПер>1</БезДокОснПер>
</СвПер>
</СвПродПер>
<Подписант СпосПодтПолном="">
<ФИО Фамилия="" Имя=""/>
</Подписант>
</Документ>
</Файл>
Пример получения XML файла для ЭТрН
Запрос
curl -X GET \
"https://online.moysklad.ru/api/gov_fns/demand/9df1e567-6efd-4d61-be7d-238d0a5e18c1?decree_type=ON_TRNACLGROT&decree_version=5.01" \
-H "Authorization: Bearer <token>" \
-H "Accept-Encoding: gzip"
Ответ
HTTP 200 OK
content-type: text/xml;charset=windows-1251
content-encoding: gzip
body:
<?xml version="1.0" encoding="Windows-1251" standalone="yes"?>
<Файл ИдФайл="ON_TRNACLGROT____0_20260907_67fddf20-f729-45fa-9322-29a85b3913b7" ВерсПрог="МойСклад" ВерсФорм="5.01">
<Документ КНД="1110339" ПоФактХЖ="Транспортная накладная, информация грузоотправителя" ДатИнфГО="07.09.2026" ВрИнфГО="08:07:19">
<СодИнфГО СодОпер="Лицом, осуществляющим погрузку груза, при указанных обстоятельствах передан водителю груз с указанными характеристиками" НомерТрН="00002" ДатаТрН="07.09.2026" НомЗак="00002" ДатаЗак="07.09.2026">
<СвГО ГОЭксп="0">
<РекИдентГО>
<ИдСв>
<СвЮЛУч НаимОрг="ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ "ЛОГНЕКС"" ИННЮЛ="7736570901" КПП="773101001"/>
</ИдСв>
<Адрес>
<АдрРФ Индекс="121205" КодРегион="77" Город="г Москва, тер Сколково инновационного центра" Улица="Большой б-р" Дом="42стр1" Кварт="1617"/>
</Адрес>
<Контакт>
<Тлф/>
</Контакт>
</РекИдентГО>
</СвГО>
<СвГП>
<РекИдентГП>
<ИдСв>
<СвЮЛУч НаимОрг="ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ "ЛОГНЕКС"" ИННЮЛ="7736570901" КПП="773101001"/>
</ИдСв>
<Адрес>
<АдрРФ Индекс="121205" КодРегион="77" Город="г Москва, тер Сколково инновационного центра" Улица="Большой б-р" Дом="42стр1" Кварт="1617"/>
</Адрес>
<Контакт>
<Тлф/>
</Контакт>
</РекИдентГП>
<АдресДостГр>
<АдресРФ Индекс="121205" КодРегион="77" Город="г Москва, тер Сколково инновационного центра" Улица="Большой б-р" Дом="42стр1" Кварт="1617"/>
</АдресДостГр>
</СвГП>
<СвГруз>
<ОпГруз НаимГруз="" СостГруз="исправен" СпУпак="00" ВидТар="00" КолМестГр="1">
<Марк>Отсутствует</Марк>
<ПлМасГруз МасБрутЗнач="0"/>
</ОпГруз>
</СвГруз>
<УказГО УкНормПрвз="Отсутствуют">
<СвПА ЛицоПА="Грузоотправитель" СпосПерУкПА="Электронное уведомление перевозчика о переадресовке">
<КонтПА>
<Тлф/>
</КонтПА>
</СвПА>
</УказГО>
<СвПер>
<ИдСв/>
<Контакт>
<Тлф/>
</Контакт>
</СвПер>
<СвВодит>
<Тлф/>
<ФИО Фамилия="" Имя=""/>
</СвВодит>
<СвТС>
<ТС РегНомер="" ТипВлад="1">
<ПарТС Тип="" Марка="" Грузопод="" Вместим=""/>
</ТС>
</СвТС>
<СвПогруз ЗаявПогр="07.09.2026T08:07:19+00:00" НалКоорТочВрЗаяв="0" ФДатВрПриб="" НалКоорТочВрФПогр="0" ФДатВрУбыт="" НалКоорТочВрФУбыт="0" МасБрутОтгр="0" МетОпрМасс="03" КолМестПрием="1">
<ФАдресПогр/>
<СвЛицПогрГр СовпГОП="1">
<ИдентРекГО>
<ИННЮЛ>7736570901</ИННЮЛ>
</ИдентРекГО>
</СвЛицПогрГр>
<ВладИнфр СовпГОВ="1">
<ИдентРекГО>
<ИННЮЛ>7736570901</ИННЮЛ>
</ИдентРекГО>
</ВладИнфр>
</СвПогруз>
</СодИнфГО>
<Подписант СтатПодп="1">
<ФИО Фамилия="Администратор" Имя="Администратор"/>
</Подписант>
</Документ>
</Файл>
Особенности формирования XML структуры
ON_NSCHFDOPPR (УПД)
Структура XML формируется приближенной к требованиям приказа ФНС России от 19.12.2023 N ЕД-7-26/970@ для файла обмена счёта-фактуры в ред. Приказа ФНС РФ от 15.11.2024 N ЕД-7-26/1032@ (соответствует версии схемы 5.03).
Для загрузки структуры XML в другие информационные системы может быть необходимо привести её в полное соответствие требованиям законодательства. Обратите внимание на следующие особенности.
Идентификаторы отправителя и получателя
Указанное значение в структуре XML в атрибуте ИдФайл элемента Файл не содержит идентификаторов участников электронного документооборота
Значение в ответе:
ИдФайл="ON_NSCHFDOPPR___20251127_6df2ba12-aa0b-499a-8031-020340dad7d7_0_1_0_0_0_00"
Требуемые изменения:
ИдФайл="ON_NSCHFDOPPR_|идентификатор получателя|_|идентификатор отправителя|_20251127_6df2ba12-aa0b-499a-8031-020340dad7d7_0_1_0_0_0_00"
Узнать идентификатор участника электронного документооборота можно с помощью инструментов вашей системы электронного документооборота
Элемент "Подписант"
Структура XML, получаемая в ответе, всегда содержит обязательный элемент Подписант — его содержимое заполняется из данных пользователя в аккаунте МоегоСклада. В случае, если для выполнения запроса используется схема авторизации Bearer <token>, где токен был получен через Vendor API — значения в элементе Подписант будут выгружены как пустые строки:
Значение в ответе:
<Подписант СпосПодтПолном="">
<ФИО Фамилия="" Имя=""/>
</Подписант>
Требуемые изменения
<Подписант СпосПодтПолном="6">
<ФИО Фамилия="Иванов" Имя="Иван"/>
</Подписант>
* значение атрибута СпосПодтПолном следует выбирать в соответствии с требованиями законодательства
ON_TRNACLGROT (ЭТрН)
Структура XML формируется по тем же правилам, что и экспорт XML ЭТрН из пользовательского интерфейса Отгрузки. Версия схемы — 5.01 (ВерсФорм="5.01").
Для загрузки структуры XML в другие информационные системы может быть необходимо привести её в полное соответствие требованиям законодательства и оператора ЭДО. Обратите внимание на следующие особенности.
Идентификаторы отправителя и получателя
Указанное значение в структуре XML в атрибуте ИдФайл элемента Файл не содержит идентификаторов перевозчика-получателя, грузополучателя и грузоотправителя.
Значение в ответе:
ИдФайл="ON_TRNACLGROT____0_20220315_9df1e567-6efd-4d61-be7d-238d0a5e18c1"
Требуемые изменения:
ИдФайл="ON_TRNACLGROT_|идентификатор перевозчика-получателя|_|идентификатор грузополучателя|_|идентификатор грузоотправителя|_0_20220315_9df1e567-6efd-4d61-be7d-238d0a5e18c1"
Элемент "Подписант"
Правило заполнения элемента Подписант такое же, как для УПД: при авторизации через Bearer <token>, полученный через Vendor API, значения в элементе Подписант выгружаются как пустые строки.
Список последних изменений
16-09-2026
Добавлено
- Описание API