Обмен документами через API

Когда это нужно

Когда учёт ведётся не в 1С. Вариантов на практике четыре.

Своя разработка. Компания написала учётную систему под себя — обычно это производство или дистрибуция со специфическими процессами.

Отраслевое решение. Система для конкретной отрасли, где 1С не прижилась.

Складская система. Учёт в 1С, но отгрузками управляет отдельная система, и документы логичнее выпускать из неё.

Зарубежная система. SAP и подобные. Технически задача та же, объём работ больше — это интеграция под конкретный ландшафт, а не установка модуля.

Что умеет интерфейс

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

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

Ограничение одно и оно смысловое: интерфейс даёт доступ к документообороту, но не думает за вашу систему. Что считать документом, когда его создавать, как сопоставлять номенклатуру — это решается на вашей стороне.

Главный вопрос проекта

Где считается подпись.

Вариант первый: подписывает человек на своём рабочем месте. Тогда ключ лежит в токене у него, система формирует документ, а подписание идёт через локальный криптопровайдер. Схема надёжная и полностью соответствует смыслу подписи — подписал тот, кто подписал.

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

Выбирать надо до начала работ: от этого зависит вся архитектура интеграции, и переделать потом дорого.

Как оценивать объём

По сценариям, а не по количеству методов.

Только исходящие. Сформировать, подписать, отправить, узнать статус. Самый быстрый сценарий, обычно неделя-две.

Плюс входящие. Получить, разобрать, сопоставить с номенклатурой, занести в учёт. Здесь появляется сопоставление, и оно всегда дольше, чем кажется.

Плюс контрагенты. Приглашения, статусы подключения, роуминг. Нужно, когда контрагентов сотни и вручную ими управлять нельзя.

Плюс перевозки. Титулы, участники, передача сведений в государственную систему. Самый сложный сценарий из-за числа сторон.

Основная переменная в оценке — не интерфейс оператора, он документирован и стабилен. Переменная — ваша система: есть ли в ней нужные данные, кто её сопровождает, можно ли в неё вообще что-то добавить.

Как мы работаем

Начинаем с разбора: что за система, кто её ведёт, какие сценарии нужны, где будет считаться подпись. По итогам — оценка работ и порядок этапов.

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

Сроки называем после разбора, а не по прайсу: интеграция — единственная из наших работ, где честная оценка невозможна до того, как мы посмотрели на вашу систему.