УПД в формате XML для ЭДО из МойСклад — инструкция

Приложение Price Hub ЭДО автоматически формирует электронную УПД (универсальный передаточный документ) в формате XML из отгрузки МойСклад по вашим шаблонам. Готовый файл загружается в ЭДО любого оператора: Контур.Диадок, Калуга Астрал, Тензор (Saby / СБИС), СберКорус и другие.

Установить из каталога МойСклад1 000 ₽ в месяц
Установить

Какой формат УПД сейчас действует, как загрузить XML в Диадок и СБИС и почему оператор не принимает файл — читайте в статье «УПД в формате XML».

О приложении

Приложение использует любые данные из МойСклад для формирования электронной УПД в виде XML-файла, который можно загрузить в ЭДО любого оператора.

Вы создаёте шаблон-правило, которое определяет, для кого он действует, откуда брать данные и в какие поля электронной накладной их подставлять.

Список шаблонов

Окно Конструктор.УПД.ЭДО: список шаблонов, итоги за 30 дней и кнопка «Начать настройку»

Редактирование шаблона

Шаблон УПД в МойСклад: привязка шаблона и поля продавца Настройка полей шаблона электронной УПД

Какие поля УПД можно настроить

Любое поле верхнего блока УПД

Поля верхнего блока УПД: продавец, покупатель, грузоотправитель

Любое поле табличной части УПД

Поля табличной части УПД: товары, количество, цена, НДС Дополнительные поля табличной части электронной УПД

Любое поле нижнего блока УПД

Поля нижнего блока УПД: основание передачи, подписанты

Быстрая настройка УПД за 3 минуты

Мастер быстрой настройки проверяет ваш МойСклад и сразу показывает, что поправить: реквизиты, ссылку на УПД, шаблоны, название документа. В конце он формирует пробный УПД на вашей Отгрузке. Инструкцию читать не нужно — ниже те же шаги для справки.

Запустите быструю настройку

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

  1. Откройте МойСклад → «Решения» → «Конструктор.УПД.ЭДО».
  2. Нажмите «Начать настройку →» справа вверху.
  3. На шаге 1 выберите своего оператора ЭДО и нажмите «Далее».
Окно Конструктор.УПД.ЭДО: список шаблонов, итоги за 30 дней и кнопка «Начать настройку»

Выбор оператора нужен для шага 8: там появится инструкция именно для него.

Быстрая настройка УПД, шаг 1: выбор оператора ЭДО

Вернуться к настройке можно в любой момент: «Разделы» → «Быстрая настройка».

Проверьте реквизиты организаций и покупателей

Без ИНН, КПП и адреса оператор ЭДО УПД не примет. Узнаёте вы об этом только при отправке — проверьте карточки заранее.

  1. На шаге 2 дождитесь проверки ваших организаций и покупателей из последних Отгрузок.
  2. Если у карточки статус «Нужно поправить» — нажмите «Открыть в МойСклад» и исправьте то, что указано в блоке «Как поправить».
  3. Сохраните карточку, вернитесь в мастер и нажмите «Проверить снова».
  4. Когда у карточек статус «Всё готово», нажмите «Далее».
Быстрая настройка УПД, шаг 2: проверка реквизитов организаций и покупателей

Мастер проверяет ИНН (10 цифр у организации, 12 у ИП, контрольное число), КПП (9 знаков у организации), полное наименование, юридический адрес по полям (индекс, регион, улица, дом), руководителя и его должность — он подписывает УПД. Банковские реквизиты в УПД не обязательны.

Быстрее всего — кнопка «Заполнить по ИНН» в карточке: МойСклад заполнит полное наименование, КПП и адрес по полям.

Включите ссылку на УПД в Отгрузке

Ссылка на XML появляется в дополнительном поле Отгрузки: скачать УПД можно в один клик, и коллегам тоже. Без поля УПД формируется кнопкой «Сформировать УПД XML» в Отгрузке — ничего настраивать не нужно.

Если тариф МойСклад не поддерживает дополнительные поля, мастер напишет об этом. Ссылку записать не получится — пользуйтесь кнопкой «Сформировать УПД XML».

  1. На шаге 3 выберите «Ссылкой в каждой Отгрузке».
  2. Если подходящего поля нет — создайте его в МойСклад: «Продажи» → «Отгрузки» → шестерёнка → «Дополнительные поля» → «Добавить дополнительное поле». Тип — «Ссылка» (подойдёт и «Строка»), название — например, «УПД для Диадока». Сохраните.
Настройки отгрузок МойСклад: дополнительное поле типа «Ссылка»
  1. Вернитесь в мастер и нажмите «Проверить снова».
  2. В списке «Поле Отгрузки для ссылки на XML» выберите созданное поле и нажмите «Сохранить». Появится статус «Настроено».
Быстрая настройка УПД, шаг 3: поле Отгрузки для ссылки на XML

Ссылка записывается в новые и изменённые Отгрузки за последние 7 дней. В более старой Отгрузке сохраните документ или нажмите «Сформировать УПД XML», затем обновите страницу (F5). Поле можно сменить позже в разделе «Настройки».

Настройки решения: поле Отгрузки для ссылки на XML

Выберите шаблоны

Шаблон говорит приложению, откуда брать каждое поле УПД. Общий шаблон «Шаблон по умолчанию» уже настроен по полям МойСклад — обычно его хватает.

  1. На шаге 4, если у всех покупателей одинаковые требования, выберите «Да, одинаковый» и нажмите «Далее».
  2. Если покупателю нужен свой УПД — выберите «Некоторым нужно своё» и нажмите «+ Новый шаблон».
  3. В поле «Использование шаблона» выберите «Конкретный контрагент» или «Группа контрагентов» (группы создаются в МойСклад).
  4. Поменяйте только то, что у этого покупателя другое, и нажмите «Сохранить».
Быстрая настройка УПД, шаг 4: общий шаблон и шаблоны для покупателей

При формировании УПД приложение ищет шаблон в таком порядке: шаблон контрагента, затем шаблон группы, затем общий («Для всех контрагентов»). Общий шаблон может быть только один. Поэтому персональный шаблон не затрагивает остальных покупателей.

Назовите документ

Шаг 5 задаёт строку «Документ об отгрузке — Наименование»: так документ называется в файле и в окне оператора ЭДО. Обычно хватает стандартной формулировки.

  1. Выберите «Стандартное название» или «Своё название».
  2. Для своего названия впишите текст в поле «Документ об отгрузке — Наименование» (до 255 знаков).
  3. Нажмите «Сохранить». Появится «Сохранено», затем нажмите «Далее».
Быстрая настройка УПД, шаг 5: название документа об отгрузке

Название записывается в общий шаблон. У шаблона покупателя его задают отдельно: шаблон → «Документ об отгрузке — Наименование».

Проверьте Отгрузки и сформируйте пробный УПД

На шаге 6 приложение формирует УПД для 3 последних Отгрузок без сохранения. В МойСклад ничего не меняется.

  1. Нажмите «Проверить 3 последние Отгрузки» (проверка занимает до минуты).
  2. Прочитайте статус каждой Отгрузки: «Готова» — УПД сформируется; «Есть заглушки» — УПД сформируется, но перед отправкой поправьте указанное; «Нужно поправить» — смотрите блок «Что мешает» и «Где поправить».
  3. Нажмите «Далее».
Быстрая настройка УПД, шаг 6: проверка последних Отгрузок

На шаге 7 сформируйте пробный УПД на настоящей Отгрузке. Файл никуда не отправляется и в Отгрузку не записывается.

  1. Выберите Отгрузку в списке.
  2. Нажмите «Сформировать пробный», затем «Скачать XML».
Быстрая настройка УПД, шаг 7: пробный УПД и кнопка «Скачать XML»

Загрузите файл в ЭДО

Приложение готовит XML-файл УПД. Загружать, подписывать и отправлять его вы будете в своём ЭДО: Контур.Диадок, Saby (СБИС), Астрал, СберКорус и другие. Отдельной настройки под оператора не нужно.

  1. На шаге 8 прочитайте инструкцию для вашего оператора.
  2. В ЭДО загрузите скачанный XML как исходящий документ из файла.
  3. Проверьте документ, подпишите и отправьте покупателю.
  4. В мастере нажмите «Готово — к шаблонам».
Быстрая настройка УПД, шаг 8: как загрузить УПД в Контур.Диадок

Покупатель должен быть подключён к ЭДО. Если он работает через другого оператора — включите роуминг у своего оператора.

Быстрый старт вручную

Если мастер не нужен, начните с готового шаблона. После установки в приложении уже есть «Шаблон по умолчанию»: он действует «Для всех контрагентов», и все поля УПД в нём связаны с полями МойСклад. Нажмите у него «Настроить», проверьте поля и нажмите «Сохранить» — затем в отгрузке «Решения» → «Сформировать УПД XML». Через пару минут у вас будет готовая УПД в формате XML.

Как скачать готовый файл УПД XML

Вариант 1. По ссылке в дополнительном поле отгрузки

  1. Перейдите в «Отгрузки» → «Настройки» → «Добавить дополнительное поле» → тип «Ссылка».
  2. В решении откройте «Настройки», в поле «Поле Отгрузки для ссылки на XML» выберите это дополнительное поле и нажмите «Сохранить».
  3. Сохраните отгрузку и обновите страницу (F5) — в поле появится ссылка для скачивания XML. Ссылка записывается в новые и изменённые отгрузки за последние 7 дней; в более старой нажмите «Сформировать УПД XML».
Ссылка для скачивания УПД XML в карточке отгрузки МойСклад

Вариант 2. Кнопка «Решения» в отгрузке

Кнопка «Решения» в отгрузке МойСклад

Выберите «Сформировать УПД XML» — откроется новая вкладка, и файл скачается сам. На этой странице есть кнопки «Скачать ещё раз» и «Открыть отгрузку в МойСклад», а также видно, записана ли ссылка в дополнительное поле отгрузки.

Страница «УПД по документу сформирован»: файл скачан

Вариант 3. В самом приложении

Откройте слева раздел «Генерация»: выберите отгрузку из последних, шаблон — «Автоматически (по привязке)» или конкретный — и нажмите «Сгенерировать XML». Все сформированные файлы собраны в разделе «История», их можно скачать повторно. Банковские реквизиты в УПД берутся из счёта, выбранного в отгрузке; если счёт не выбран, берётся основной.

Источники данных для УПД

В шаблоне поля УПД разбиты на вкладки «Продавец», «Грузоотправитель», «Грузополучатель», «Покупатель», «Документ и основание» и «Табличная часть». У каждого поля два списка: «Источник» — откуда брать данные, и «Поле» — конкретное поле этой карточки. Под списком «Источник» подсказка — где эти данные лежат в МойСклад.

  1. Ручной ввод — любое статичное значение, вписывается в поле «Значение». Удобно, когда контрагент предъявляет индивидуальные требования к данным и не хочется создавать отдельное дополнительное поле.
  2. Организация (ваше юрлицо из отгрузки) — основные и дополнительные поля.
  3. Контрагент — основные и дополнительные поля.
  4. Отгрузка — номер, дата, комментарий, адрес доставки и другие поля, а также дополнительные поля.
  5. Договор — основные и дополнительные поля.
  6. Товар/услуга (на вкладке «Табличная часть») — артикул, код, страна, ГТД, штрихкоды и дополнительные поля карточки товара.
  7. Позиция (на вкладке «Табличная часть», строка отгрузки) — количество, цена, скидка, НДС, сумма по каждой строке.

Поля с плашкой «Обязательное» нужны оператору ЭДО — счётчик «Обязательные поля» вверху шаблона показывает, все ли они настроены. Изменения сохраняются кнопкой «Сохранить» (или «Сохранить шаблон» вверху); кнопка активна, когда в шаблоне есть несохранённые правки.

Шаблоны УПД

Шаблоны автоматической генерации УПД настраиваются на трёх уровнях:

  1. Конкретный контрагент — персональный шаблон для одного контрагента.
  2. Группа контрагентов — шаблон для всех контрагентов определённой группы (группы создаются в МойСклад).
  3. Для всех контрагентов (по умолчанию) — общий шаблон, если не найден более подходящий. Такой шаблон может быть только один.

Приоритет шаблонов

Шаблоны применяются в следующем порядке:

  1. Шаблон контрагента — проверяется первым.
  2. Шаблон группы — если шаблон контрагента не найден.
  3. Общий шаблон — если не подошли предыдущие.

Такой порядок исключает ошибки, когда контрагент одновременно подходит под несколько шаблонов: персональный шаблон всегда главнее группового, а групповой — общего.

Файл XML не скачивается

Если файл не скачивается, значит при формировании УПД произошла ошибка. Вместо скачивания откроется страница разбора: что именно не так, «Где исправить» в МойСклад и ссылки «Открыть» на отгрузку, контрагента, юрлицо и договор. Ссылка «Настроить поле в шаблоне» откроет решение сразу на нужном поле. Исправьте данные и нажмите «Сформировать УПД XML» в отгрузке ещё раз.

До сборки XML приложение проверяет реквизиты сторон: наименование, ИНН (10 или 12 цифр и контрольное число), КПП у юрлица и адрес. Поэтому пустой ИНН или опечатка находятся сразу, а не после отказа в Диадоке или СБИС. ИНН из 12 цифр означает ИП — в УПД он попадёт с ФИО, как требует формат.

Страница разбора ошибки УПД: что не так и где исправить в МойСклад

Ошибки при загрузке УПД в ЭДО

Вариант 1. Поэтапная проверка

  1. Нажмите «+ Новый шаблон».
  2. Поочерёдно заменяйте в нём типовые реквизиты на собственные.
  3. После каждой замены загружайте файл в ЭДО.

Вариант 2. Детальный разбор ошибки

Загрузите XML в ЭДО и получите подробную информацию об ошибке.

Зелёные стрелки — атрибут, красные — значение.

Разбор ошибки УПД в ЭДО: атрибут и значение XML
  • Атрибут (Attribute) — указывает, откуда берутся данные (источник строки).
  • Значение (Value) — сами данные, подставленные из выбранного поля.

Создание дополнительных полей в МойСклад

Как создать пользовательские поля для каждого источника данных.

Источник данных — Организация

Создание дополнительного поля организации в МойСклад

Источник данных — Контрагент

Создание дополнительного поля контрагента в МойСклад

Источник данных — Товар

Создание дополнительного поля товара в МойСклад

Источник данных — Отгрузка

Создание дополнительного поля отгрузки в МойСклад

Источник данных — Договор

Создание дополнительного поля договора в МойСклад

Как получить ссылку на УПД в отгрузке

Добавление дополнительного поля типа «Ссылка» в отгрузках МойСклад Настройки решения: поле Отгрузки для ссылки на XML

Результат

Готовая ссылка на скачивание УПД XML в отгрузке

История формирования и итоги

Раздел «История» показывает сформированные УПД: дату, ID поставки, статус, время и кнопку «Скачать». Записи хранятся 60 дней, записи об ошибках — 10 дней, затем удаляются. В шапке окна плитки «Итоги за 30 дней»: «Шаблоны», «Сформировано XML» и «Ошибки за 10 дней» — каждая открывает свой раздел.

История генераций УПД: записи за 60 дней, статус и кнопка «Скачать»

Пошаговая инструкция: как сформировать УПД XML

  1. Откройте решение — слева список «Шаблоны».
  2. Нажмите «+ Новый шаблон» (или «Настроить» у готового «Шаблона по умолчанию»).
  3. Укажите «Название шаблона».
  4. В поле «Использование шаблона» выберите, с какими контрагентами работает шаблон.
  5. Проверьте поля:
    1. «Продавец», «Грузоотправитель», «Грузополучатель», «Покупатель», «Документ и основание» уже настроены по соответствующим полям МойСклад.
    2. «Табличная часть» уже настроена по соответствующим полям МойСклад.
  6. Скорректируйте источники данных под свои задачи и нажмите «Сохранить».
  7. В отгрузке МойСклад нажмите «Решения» → «Сформировать УПД XML» или скачайте файл по ссылке.
  8. Загрузите файл в ЭДО.
  9. Если ЭДО выдаёт ошибку — определите, какие данные не подошли (см. раздел об ошибках).

Частые вопросы

Почему не скачивается файл УПД?

При формировании возникла ошибка — вместо скачивания откроется страница её разбора: что не так и где исправить в МойСклад. Подробнее.

Какой шаблон применяется, если подходят несколько?

Сначала шаблон контрагента, затем группы, затем общий. Подробнее.

Как выгрузить УПД в формате XML из МойСклад?

В отгрузке нажмите «Решения» → «Сформировать УПД XML» или скачайте файл по ссылке в дополнительном поле отгрузки. Поля УПД заполняются по шаблону из данных организации, контрагента, товаров, отгрузки и договора. Подробнее

Как загрузить УПД XML в Диадок?

Сформируйте XML в МойСклад и загрузите файл в Контур.Диадок как исходящий документ, затем проверьте и подпишите. Если Диадок покажет ошибку, по атрибуту из сообщения найдите поле шаблона, из которого пришло значение. Подробнее

Как загрузить УПД XML в СБИС (Saby)?

Так же, как в Диадок: XML-файл из МойСклад загружается в СБИС как документ из файла. Формат УПД один для всех операторов, отдельной настройки под СБИС не нужно.

Почему оператор ЭДО не принимает УПД?

Чаще всего в документе пустой или неверный реквизит: ИНН, КПП, адрес, номер основания. Часть ошибок приложение находит до формирования и показывает, где исправить. Если ошибку нашёл оператор, по атрибуту из его сообщения найдите поле шаблона. Подробнее

Как изменить название документа в УПД?

На шаге 5 быстрой настройки выберите «Своё название» и впишите текст до 255 знаков в поле «Документ об отгрузке — Наименование». Название запишется в общий шаблон; у шаблона покупателя его задают отдельно. Подробнее

Почему ссылка на УПД не появилась в поле Отгрузки?

Ссылка записывается в новые и изменённые Отгрузки за последние 7 дней. В более старой Отгрузке сохраните документ или нажмите «Сформировать УПД XML», затем обновите страницу (F5). Проверьте и поле: оно выбирается на шаге 3 быстрой настройки. Подробнее

Какой расчётный счёт попадает в УПД?

Тот, что выбран в Отгрузке. Если счёт в Отгрузке не выбран, берётся основной счёт из карточки юрлица или контрагента.

Помощь и поддержка

Price Hub — сделано продавцами для продавцов

Приложения для МойСклад и маркетплейсов — Ozon, Wildberries, Яндекс Маркет, Авито. Мы сами продаём автозапчасти: больше 1500 позиций, каждый день на маркетплейсах. Поэтому делаем то, что экономит время и деньги, и проверяем всё сначала на своём складе.

Сделаем любую интеграцию МойСклад с чем угодно — маркетплейсы, сайты, поставщики, боты, отчёты, любые ваши фантазии. Есть идея? Напишите нам. Если идея классная, сделаем её бесплатно. Нужна доработка под вас — разработка под заказ.

Без колл-центра: вопрос в мессенджере попадает сразу к тем, кто делал приложение.

Другие наши решения для МоегоСкладаВсе приложения →