Документация API ТДЛФ

НЕ ИСПОЛЬЗУЕТСЯ!!!!!!

Версия 1.0 | Последнее обновление:

Общие положения

Здесь будет общая информация о системе, авторизации и основных принципах работы API.

Сервис обмена

Базовый URL

https://api.tdlf.ru/v1/

Формат запросов

Все запросы должны содержать заголовок:

Content-Type: application/json

Архитектура системы

Для работы с API необходимо предварительно настроить подсистему обмена данными, включающую:

Настройки обмена

Система должна предоставлять интерфейс для управления параметрами обмена:

Настройки создания УПД:

Настройки Товары:

Настройки Цены:

Настройки Остатки:

Журналирование

Система ведет следующие журналы операций:

Журнал Назначение Хранение
Журнал ошибок Фиксация всех ошибок при обмене 30 дней
Журнал документов Архив переданных/полученных документов 6 месяцев
История выгрузок История переданных/полученных выгрузок 6 месяцев
Журнал УПД История УПД и их изменений 6 месяцев
Журнал Загружаемая номенклатура Хранение товаров поставщика 6 месяцев
Журнал Загружаемые остатки товаров Хранение остатков товаров поставщика 6 месяцев

Правила выгрузки заказов

Настройки фильтрации для выгрузки заказов поставщикам:

Дополнительные параметры:

Статусы документов

Система отслеживает жизненный цикл документов:

  1. Новый (ожидает выгрузки)
  2. В очереди на обработку
  3. Выгружен (с отметкой времени)
  4. Ошибка выгрузки
  5. Повторно поставлен в очередь

Заказы

Получение заказов поставщику

При обращении к сервису система выполняет:

  1. Выгрузку заказов поставщику согласно настройкам фильтрации
  2. Запись результатов операции в журнал:
    • Журнал документов
    • История выгрузок
    • Ошибки обработки (возможно стоит объеденить с предыдущим)

Обработка ответов от сервиса

После получения ответа от сервиса система:

Важно!

Все операции с сервисом фиксируются в следующих журналах:

Сборки заказов

Архитектура подсистемы сборок. Добавляется в подсистему продажи

В связи с отсутствием типовых решений в УТ11, необходимо реализовать специализированную систему управления сборками, интегрированная с сервисом и включающая:

📝 Документы сборок

  • Создание/редактирование сборок
  • Ссылка к заказам поставщику
  • История изменений

🔄 Управление статусами

  • Отслеживание этапов сборки

📦 Группировка по назначениям

  • Назначение это и есть Заказ клиента
  • Планирование отгрузок
  • Контроль сроков

Создание документа сборки

Работа с сервисом позволяет:

  1. Автоматически создавать сборки
  2. Группировать сборки по назначениям (заказам клиентов)
  3. Синхронизировать данные между системами

Обновление статусов сборки

📊 Виды статусов:

Новый
Передан в работу
Взят в работу
Собран

Система предоставляет менеджерам информацию о текущем этапе сборки каждого заказа.

Интеграция с подсистемой продаж

Все сборки автоматически отображаются в подсистеме продаж с возможностью:

Отгрузки

Обработка входящих отгрузок (документов)

Сервис позволяет автоматизировать процесс обработки отгрузок от контрагентов:

Необходимо добавить и вести список входящих документов - "Отгрузка товаров и услуг"

Добавить в подсистему Закупки

1

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

На основании входящих данных формируется документ "Отгрузка товаров и услуг"

2

Сопоставление с заказом

Автоматический поиск соответствующего Заказа поставщика

3

Проведение документа

Хранение ссылки на документ

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

Алгоритм обработки:

  1. Поиск исходного Заказа поставщика по:
    • ID документа
    • Номеру заказа
  2. Создание документа на основании:
    • Настроек обработки входящих документов
    • Алгоритм вычитания товаров из табличной части необходимо согласовать с контрагентом, в зависимости от того, какие данные они могут у себя хранить (по ID строки или назначению)
  3. На форму добавить кнопку - создать документ приобретения.

Обновление документа отгрузки

Механизм сравнения версий:

Поле Старая версия Новая версия Статус
Количество 50 45 Изменено
Цена 1500.00 1500.00 Без изменений

Система автоматически выделяет цветом все измененные поля и добавляет флаг "Исправлено" для ручной проверки.

🔍 Режим сравнения документов

Визуальное отображение различий между текущей и новой версиями документа:

Товары

Загрузка товаров

Включить в подсистему НСИ, Загружаемая номенклатура.

Алгоритм обработки:

  1. Получение данных из сервиса
  2. Создание/обновление записей в справочнике Загружаемая номенклатура
  3. Создание/обновление записей в справочнике товаров Партнера в соответствии с настройками.
  4. Соответствие номенклатуры (по артикулу).
  5. Преобразование номенклатуры с справочником номенклатура информационной базы:
    • Сопоставление с существующими позициями (реквизиты из настроек)
    • Обработка особых реквизитов:
      • НДС - ставка и метод расчета
      • Штрихкоды - валидация и нормализация

Внимание: Критичные параметры

Особое внимание при обработке товаров уделяется:

Цены

Механизм работы с ценами

Система получает актуальные ценовые данные из сервиса и обрабатывает их согласно заданным настройкам

Остатки товаров

Механизм обработки остатков

Система получает актуальные данные об остатках и корректирует их в соответствии с настройками:

📥

Получение данных

Загрузка остатков из внешней системы

→
📝

Запись в журнал

Фиксация в "Загружаемые остатки товаров"

→
🔍

Сравнение

Анализ расхождений с текущими остатками

→
📊

Корректировка

Формирование документов инвентаризации

Загрузка остатков

Алгоритм обработки:

  1. Получение текущих остатков по складам организации
  2. Запись в журнал Загружаемы остатки товаров
  3. Сравнение с полученными данными:
    • Выявление позиций с расхождениями
    • Проверка по правилам из настроек
  4. Формирование документов инвентаризации:
    • Только для позиций с отклонениями
    • С указанием фактического количества
  5. Проведение документов и обновление остатков

Контроль корректности

Система гарантирует точность остатков за счет: