reply.by

Интеграция с 1С 8.3

Готовый source-код для сборки .epf-обработки. Программист 1С (или подкованный бухгалтер) собирает интеграцию через Конфигуратор за 10 минут — без необходимости писать код самостоятельно.

Почему source-код, а не готовый .epf

Бинарный .epf создаётся только в 1С Конфигураторе и содержит формы, модули и метаданные в проприетарном формате. Версии файла зависят от платформы (8.3.10 vs 8.3.20 vs 8.3.24) и требуют пересборки. Source-код решает обе проблемы: один и тот же код работает на всех актуальных версиях, а сборка занимает 5–10 минут в Конфигураторе.

Скачать

replyby-integration.bsl
Основной модуль (~200 строк, все процедуры API)
Скачать ↓
replyby-form-managed-form.txt
Описание управляемой формы для ввода токена
Скачать ↓
README.md
Пошаговая инструкция по сборке .epf
Скачать ↓

Быстрый старт (10 минут)

  1. Получите API-токен. Зарегистрируйтесь на тарифе Pro или Agency, войдите в /app/api-keys и создайте ключ. Скопируйте полный токен rk_live_… сейчас — после закрытия страницы он не покажется.
  2. Создайте Константу. В 1С Конфигураторе: Конфигурация → Общие → Константы → Добавить. Имя: ReplyByToken, тип Строка(64). Запишите туда токен из шага 1 (через режим Предприятия → «Все функции»).
  3. Создайте внешнюю обработку. В Конфигураторе: Файл → Новый → Внешняя обработка. Имя «reply.by интеграция».
  4. Вставьте код модуля. Свойства обработки → Модуль объекта (двойной клик). Замените содержимое на код из replyby-integration.bsl.
  5. (Опционально) Добавьте форму. Дерево обработки → Формы → Добавить → Управляемая. Создайте поля и обработчики по описанию из replyby-form-managed-form.txt.
  6. Сохраните. Файл → Сохранить как → replyby-integration.epf.
  7. Подключите к процессу проведения. В подписке на «При проведении» нужного документа (Акт, Счёт, ТТН-2) добавьте вызов ОбщийМодульReplyBy.ОтправитьВReplyBy(ЭтотОбъект.Ссылка);

Что получите

  • Функцию СоздатьИлиОбновитьКонтрагента — upsert по УНП, возвращает ID в reply.by.
  • Функцию СоздатьДокумент — отправляет документ + автоматически планирует напоминания контрагенту.
  • Процедуру ОтметитьДокументВернувшимся — закрывает документ и отменяет напоминания, когда контрагент вернул подписанный экземпляр.
  • Функцию ПолучитьДокументы — список с фильтрами status / counterparty_id (для отчётов прямо в 1С).
  • Функцию ПроверитьСоединение — health-check токена и тарифа.
  • Высокоуровневый ОтправитьВReplyBy(ДокументСсылка) — типовое использование одной строкой из подписки на проведение.

Безопасность

  • Токен НЕ должен попадать в исходный код или в систему контроля версий.
  • Если токен скомпрометирован — отзовите в /app/api-keys и создайте новый, старый перестанет работать немедленно.
  • Для интеграций, которые только читают данные (отчёты), создавайте read-only ключ — он не сможет создавать или менять документы.
  • Базовый URL HTTPS-only в проде: https://reply.apps.newklient.com/api/v1.

Поддержка

Вопросы по интеграции: api@reply.by. Заодно посмотрите общую документацию REST API с примерами curl и описанием эндпоинтов.