Другое · 8 мин
Как отправить XML-файл через 1С
Как отправить XML-файл из 1С: способы обмена, подготовка файла, настройка канала, проверка результата и частые ошибки при самостоятельной настройке.
Отправка XML-файла из 1С используется, когда необходимо передать данные контрагенту, в государственную систему, между информационными базами или в сторонний сервис. XML удобен тем, что структура описывается явно, а файл можно проверить ещё до передачи. В 1С:Предприятии есть несколько встроенных и настраиваемых способов передачи, выбор зависит от того, где находится получатель и какой канал связи доступен.
Самостоятельная настройка допустима, если у пользователя есть права на изменение конфигурации или доступа к обменным настройкам, а также понимание того, какой формат файла ожидает получатель. Если получатель предъявляет жёсткие требования к кодировке, подписи или имени файла, их нужно уточнить до начала настройки. Ошибки в этих параметрах часто приводят к тому, что файл уходит, но получатель его не принимает.
Перед началом работы рекомендуется сохранить резервную копию базы или выгрузить тестовый файл в отдельную папку. Это позволит откатить изменения, если настройка обмена затронет общие реквизиты или механизмы обмена данными. Не стоит вносить правки в рабочую базу без предварительной проверки на копии.
Когда отправка XML через 1С подходит
Этот способ подходит для регулярного обмена документами, отчётами, накладными или справочниками, если получатель готов принимать XML по согласованному каналу. Часто используется при взаимодействии с интернет-магазинами, логистическими сервисами, отчётными системами и между разными базами 1С. Если передача нужна разово и вручную, проще выгрузить файл через стандартный интерфейс, чем настраивать автоматическую отправку.
Не подходит отправка XML, если получатель требует только закрытый API с токенами, которые не поддерживаются текущей конфигурацией, или если канал связи полностью заблокирован сетевыми правилами. В таких случаях сначала нужно решить вопрос с доступом, а уже потом настраивать формат файла.
Способы отправки XML из 1С
Файловый обмен подходит, когда стороны имеют доступ к общей сетевой папке или обменному каталогу. 1С может класть готовый XML в указанную папку, а получатель забирает его по расписанию. Этот способ прост в отладке, но требует согласования прав на чтение и запись, а также защиты от случайного удаления файлов.
Отправка по электронной почте удобна, когда получатель не предоставляет общую папку и не принимает HTTP-запросы. В 1С можно прикрепить XML к письму и отправить через настроенный почтовый ящик. Нужно учитывать ограничения почтовых сервисов на размер вложения, возможность блокировки вложений антивирусом и требования к теме письма.
HTTP и веб-сервисы
Передача через HTTP подходит, если у получателя есть приёмный адрес и документация по формату запроса. 1С может сформировать XML и отправить его методом POST или PUT, а затем дождаться ответа. Этот канал быстрее файлового обмена, но требует стабильного интернет-соединения и, возможно, настройки сертификатов безопасности.
Веб-сервисы используются, когда взаимодействие регламентировано WSDL или другим описанием интерфейса. 1С может работать с такими сервисами через встроенные инструменты, но настройка часто сложнее, чем простая отправка файла. Перед подключением уточните у получателя, поддерживает ли он SOAP, REST или только приём файлов по HTTP.
Сравнение вариантов
Подходит для общей папки, прост в отладке, требует согласования прав доступа
Удобен без общей папки, ограничен размером вложений и фильтрами спама
Быстрый канал, требует адреса получателя и часто настройки сертификатов
Подготовка файла и проверка перед отправкой
XML-файл должен быть сформирован корректно: открывающие и закрывающие теги парные, кодировка соответствует ожиданиям получателя, а имя файла не содержит запрещённых символов. Часто используется кодировка UTF-8, но некоторые системы требуют Windows-1251 или файл без BOM. Уточнение этого параметра до отправки сокращает количество возвратов.
Проверьте, что файл не открыт в другой программе и не заблокирован антивирусом. Если 1С не может получить доступ к файлу, отправка завершится ошибкой или файл уйдёт неполным. Также убедитесь, что в файле нет лишних пробелов в начале, если получатель чувствителен к точному содержимому.
Пошаговая настройка отправки
- 1Сформировать или выгрузить XML-файл в 1С
- 2Выбрать канал отправки: папка, почта, HTTP или веб-сервис
- 3Заполнить адрес получателя, учётные данные и параметры подключения
- 4Проверить кодировку и имя файла
- 5Выполнить тестовую отправку и убедиться в доставке
Начните с создания выгрузки в конфигурации: укажите объект данных, период и набор реквизитов, которые должны попасть в XML. После генерации файла откройте его в текстовом редакторе и убедитесь, что структура соответствует образцу от получателя. Если файл сгенерирован программно, проверьте обработку исключений, чтобы ошибка формирования не маскировалась как успешная отправка.
Далее настройте канал: для файлового обмена укажите путь к папке и права доступа, для почты — адрес сервера, порт, логин и пароль, для HTTP — URL и необходимые заголовки. После сохранения настроек запустите отправку тестового файла и дождитесь подтверждения от получателя или записи в журнал обмена.
Контрольные точки
Запись об успешной отправке без ошибок
Ошибка подключения, таймаут или отказ получателя
Файл доставлен и открывается
Файл отсутствует или письмо не доставлено
Подтверждение приёма или обработки XML
Отказ из-за кодировки, схемы или имени файла
Проверка результата и устранение ошибок
Результат считается успешным, когда получатель подтвердил приём файла или в журнале 1С есть запись об успешной передаче без ошибок. Если файл отправлен, но не принят, запросите у получателя отчёт о ошибке: часто проблема кроется в кодировке, отсутствии обязательного реквизита или несоответствии схемы XSD.
При ошибках подключения проверьте доступность адреса получателя, правильность учётных данных и работу сетевых экранов. При ошибках файла проверьте, не занят ли файл другим процессом и соответствует ли его размер ожидаемым значениям. Не повторяйте отправку многократно без анализа причины, чтобы не создать дубликаты у получателя.
Ограничения и риски
Автоматическая отправка XML может быть приостановлена из-за изменений в конфигурации 1С, обновления операционной системы или смены пароля почтового ящика. Периодически проверяйте работу обмена, особенно после обновлений. Если канал используется для передачи конфиденциальных данных, уточните, требуется ли шифрование или электронная подпись.
Не вносите изменения в механизмы обмена в рабочей базе без тестирования на копии. Ошибка в настройке может привести к массовой отправке некорректных файлов или блокировке обмена с контрагентами. Если не уверены в правильности настроек подключения, привлеките специалиста по 1С перед вводом в эксплуатацию.
Сравнение вариантов отправки
Как проверить результат отправки
Что важно запомнить
Выберите канал в зависимости от возможностей получателя, проверьте кодировку и права доступа, сделайте тестовую отправку и контролируйте журнал обмена.
Нужно ли программировать отправку XML в 1С?
Не всегда. Если конфигурация содержит стандартные механизмы выгрузки и обмена, можно настроить отправку через интерфейс без изменения кода. Программирование потребуется, если нужна нестандартная структура файла или интеграция с чужеродным сервисом.
Какую кодировку выбрать для XML?
Часто используется UTF-8, но некоторые системы требуют Windows-1251 или файл без BOM. Точную кодировку и требования к началу файла уточняйте у получателя до первой отправки.
Что делать, если файл уходит, но не принимается?
Остановите автоматическую отправку, запросите у получателя текст ошибки и проверьте кодировку, имя файла, обязательные реквизиты и соответствие схеме. Повторная отправка без исправления причины обычно не помогает.
Можно ли отправлять XML по почте из 1С?
Да, если в конфигурации настроен почтовый ящик и есть возможность прикрепить файл к сообщению. Учитывайте ограничения почтовых сервисов на размер вложения и возможную блокировку XML антивирусом.
Безопасно ли настраивать обмен в рабочей базе?
Начинайте с копии базы или тестовой среды. Прямые изменения в рабочей базе без проверки могут привести к массовой отправке некорректных файлов или нарушению обмена с контрагентами.