Как подключить ЭДО к сайту для автоматической выгрузки заказов

Автоматизация передачи заказов через электронный документооборот (ЭДО) позволяет исключить ручной ввод, ускорить отгрузки и минимизировать ошибки. В этой статье мы разберем, как связать вашу CMS или CRM-систему с провайдером ЭДО через API.

Пошаговая инструкция по интеграции

Шаг 1: Получение API-ключей и доступа к песочнице

Для начала работы вам необходимо выбрать оператора ЭДО (например, Диадок или СБИС) и запросить у техподдержки доступ к API. Вам предоставят:

Идентификатор разработчика (Developer Key);
Адрес тестового сервера (песочницы);
Тестовые учетные записи для проверки отправки документов.

Важно: Никогда не используйте боевые API-ключи в тестовой среде. Храните их в зашифрованном виде в файле конфигурации вашего сервера (например, .env) и не коммитьте в публичные репозитории.

Шаг 2: Настройка интеграционного модуля

Интеграция происходит путем отправки HTTP-запросов с вашего сайта на сервер ЭДО. Для этого пишется скрипт-обработчик или используется готовый SDK. Ниже представлен пример JSON-тела запроса для создания черновика документа:

{
  'order_id': '10294',
  'customer_inn': '7701234567',
  'items': [
    {
      'name': 'Товар 1',
      'quantity': 2,
      'price': 1500.00
    }
  ]
}

Для быстрого сохранения изменений в коде используйте сочетание клавиш Ctrl + S.

Дополнительно: Требования к электронной подписи

Для автоматического подписания документов на сервере вам потребуется КЭП (квалифицированная электронная подпись). Ее можно выпустить на имя организации и установить на сервер через КриптоПро CSP, либо использовать облачную подпись, если ваш оператор ЭДО поддерживает такой функционал.

Шаг 3: Настройка вебхуков для обратной связи

Чтобы сайт узнавал об изменении статуса документа (например, ‘Подписан покупателем’ или ‘Отклонен’), настройте Webhooks. Сервер ЭДО будет отправлять POST-запросы на указанный вами URL-адрес вашего сайта при каждом изменении статуса.

После успешной интеграции и автоматизации заказов вам также может потребоваться Настройка оповещений о поступлении денег в 1С: Инструкция поможет связать оплаты с вашей учетной системой.

Частые ошибки / Устранение неполадок

В процессе интеграции разработчики часто сталкиваются со следующими проблемами:

Ошибка 401 Unauthorized: Неверно передан API-токен или истек срок действия сессии. Проверьте заголовки авторизации (Authorization Header).
Ошибка 422 Unprocessable Entity: Переданы некорректные данные контрагента. Чаще всего проблема в невалидном ИНН или КПП. Перед отправкой запроса валидируйте данные на стороне сайта.
Ошибка подписи (Signature Verification Failed): Возникает, если на сервере не установлен корневой сертификат удостоверяющего центра или истекла лицензия КриптоПро.

Для развития бизнеса и покрытия кассовых разрывов при закупках рекомендуем изучить, как открыть кредитную линию в клиент-банке: инструкция содержит подробный алгоритм действий. Также при расчетах с контрагентами важно вовремя уплачивать налоги, в чем поможет руководство о том, как создать поручение на уплату страховых взносов в банк-клиенте.