Интеграция 1С-Битрикс с ЭДО Такском — под ключ

Интеграция 1С-Битрикс с системой ЭДО Такском

Представьте: 150 заказов в сутки, каждому — свой УПД. Менеджер формирует документ в 1С, затем вручную загружает в личный кабинет Такском — тратит 15–20 минут. Итог: 40 часов в неделю уходят на рутину. Ошибки в реквизитах ведут к отказам в 12% случаев, а контрагенты задерживают подписание в среднем на 4 дня. Ситуация усугубляется, если у клиента специфический документооборот (медицинские товары с сериями и сроками годности).

Мы специализируемся на Битрикс более 10 лет, провели 30+ проектов по интеграции ЭДО. Наша типовая реализация — автоматическая отправка УПД из Битрикс через оператора Такском без участия менеджера: статус подписания отслеживается в административной панели. Такой подход сокращает время обработки заказов на 80% и исключает ошибки ручного ввода. При 100 заказах в месяц экономия достигает $3.1k–4.5k в год. Для клиента из сферы B2B-поставок стройматериалов внедрение позволило снизить затраты на документооборот на $11k–16k в год.

С какими проблемами сталкиваются компании

• Ручная выгрузка документов. Менеджер формирует УПД в 1С, затем загружает в личный кабинет Такском — 15–20 минут на один заказ. При 50 заказах в день это 12–17 часов чистой рутины.
• Отсутствие привязки к статусам заказа. Документ не отправляется автоматически при отгрузке — его могут забыть или отправить с опозданием.
• Сложности с контрагентами. Поиск BoxId нового контрагента занимает время, а ошибки в реквизитах ведут к отклонению документов.
• Неполный пакет документов. Для медицинских товаров нужны акты с сериями и сроками годности — стандартный УПД их не содержит.

Наш опыт показывает, что 90% этих проблем решаются грамотной интеграцией Битрикс с Такском через REST API. Получите консультацию по вашему проекту.

Как работает интеграция Такском с Битрикс?

Авторизация происходит по протоколу OAuth 2.0 Client Credentials. Мы кешируем токен на 3500 секунд (чуть меньше времени жизни), чтобы не дергать API при каждом запросе:

class TaxcomClient {
    private string $baseUrl = 'https://edo.taxcom.ru/api/v1';
    private string $accessToken;

    public function __construct(
        private string $clientId,
        private string $clientSecret
    ) {
        $this->accessToken = $this->getAccessToken();
    }

    private function getAccessToken(): string {
        $cached = \Bitrix\Main\Data\Cache::createInstance();
        if ($cached->startDataCache(3500, 'taxcom_token', '/taxcom/')) {
            $response = $this->httpPost('https://auth.taxcom.ru/oauth/token', [
                'grant_type' => 'client_credentials',
                'client_id' => $this->clientId,
                'client_secret' => $this->clientSecret,
                'scope' => 'edo',
            ]);
            $cached->endDataCache(['token' => $response['access_token']]);
            return $response['access_token'];
        }
        $data = $cached->getVars();
        return $data['token'];
    }
}

Создание и отправка документа

После получения токена формируем XML документа и отправляем его в три шага: загрузка файла, подписание, отправка сообщения:

public function sendDocument(\Bitrix\Sale\Order $order): array {
    $xmlContent = $this->generateUPDXml($order);
    // Шаг 1: загрузка файла
    $uploadResponse = $this->apiPost('/documents/upload', [
        'FileName' => "UPD_{$order->getId()}.xml",
        'Content' => base64_encode($xmlContent),
        'ContentType' => 'application/xml',
    ]);
    $fileId = $uploadResponse['FileId'];
    // Шаг 2: подписание (КриптоПро или облачная подпись Такском)
    $signature = $this->signFile($xmlContent);
    // Шаг 3: отправка документа
    return $this->apiPost('/messages/send', [
        'RecipientBoxId' => $this->getRecipientBoxId($order),
        'Documents' => [[
            'FileId' => $fileId,
            'Signature' => base64_encode($signature),
            'DocType' => 'UniversalTransferDocument',
            'Function' => 'ДОП',
        ]],
    ]);
}

Такском поддерживает облачную подпись через сервис «Такском-Крипто» — сертификат хранится на стороне Такском, подписание происходит через API без КриптоПро на сервере. Это упрощает инфраструктуру и снижает затраты по сравнению с покупкой отдельного лицензионного ключа.

Поиск BoxId контрагента

При первом контакте с новым контрагентом система ищет его BoxId по ИНН/КПП:

public function findRecipientBoxId(string $inn, string $kpp = ''): ?string
{
    $response = $this->apiGet('/organizations/search', [
        'inn' => $inn,
        'kpp' => $kpp,
    ]);

    foreach ($response['Organizations'] as $org) {
        if ($org['Inn'] === $inn && ($kpp === '' || $org['Kpp'] === $kpp)) {
            return $org['BoxId'];
        }
    }

    return null;
}

Найденный идентификатор сохраняется в пользовательском поле покупателя (UF_TAXCOM_BOX_ID) — следующий раз отправка происходит без запросов.

Почему стоит выбрать облачную подпись?

Облачная подпись Такском — это альтернатива покупке и настройке КриптоПро. Основные отличия:

Облачная подпись дешевле классической на 40–60% за счёт отсутствия лицензий и обслуживания.

Кейс: ЭДО для медицинского дистрибьютора (из нашей практики)

Дистрибьютор медицинских расходных материалов, ~400 B2B-клиентов, работает с государственными больницами и частными клиниками. Государственные учреждения часто имеют собственных ЭДО-операторов с роумингом, часть работает через Такском напрямую.

Особенность: помимо УПД, для медицинских товаров требуются акты приёмки-передачи с расширенными реквизитами (серия, срок годности, регудостоверение). Стандартный формат УПД не покрывает все поля.

Решение:

Разработан составной документ: УПД + аннотация с расширенными медицинскими реквизитами как дополнительный XML-файл в том же сообщении Такском. Оба файла подписываются одной подписью.

$documents = [
    [
        'FileId' => $updFileId,
        'Signature' => base64_encode($updSignature),
        'DocType' => 'UniversalTransferDocument',
    ],
    [
        'FileId' => $annexFileId,
        'Signature' => base64_encode($annexSignature),
        'DocType' => 'Attachment', // дополнение к основному документу
        'Comment' => 'Медицинские реквизиты товаров',
    ],
];

В Битрикс реквизиты товаров (серия, срок годности) хранятся как свойства позиций заказа. При генерации XML извлекаются из \Bitrix\Sale\BasketItem::getPropertyCollection().

Экономия для клиента составила $11k–16k в год за счёт сокращения ручного труда и штрафов за просроченные документы.

Мониторинг очереди документов

Для контроля документооборота — административный раздел в Битрикс с таблицей отправленных документов:

• Заказ → Документ Такском → Статус → Дата подписания

Данные берутся из таблицы local_taxcom_documents + периодический polling API Такском для обновления статусов (cron каждые 10 минут).

Что входит в работу

1. Настройка аккаунта Такском — получение Client ID/Secret, облачной подписи (если требуется).
2. Разработка PHP-клиента — класс для работы с REST API, кеширование токена, обработка ошибок.
3. Генерация XML — формирование УПД, актов, составных документов на основе данных заказа.
4. Справочник контрагентов — загрузка BoxId, сохранение в пользовательском поле Битрикс.
5. Событийная отправка — привязка к статусам заказа: отгрузка → автоматическая отправка.
6. Мониторинг статусов — административный раздел с таблицей, уведомления об ошибках, автообновление.
7. Документация и обучение — передача кода, инструкция для менеджеров, консультация на этапе запуска.

Сроки и как начать

Базовая интеграция (УПД, облачная подпись, мониторинг) занимает от 3 до 5 недель. Расширенная с составными документами и специфическими форматами — 6–9 недель. Стоимость рассчитывается индивидуально после анализа вашей схемы документооборота. Оценим ваш проект за 2 рабочих дня — свяжитесь с нами, чтобы получить консультацию и точную оценку. Закажите тестовый запуск на одном типе документа.