СмартБилл - Odoo EN

Техническая спецификация
Проект: SmartBill → Интеграция с Odoo
Цель: SmartBill остается юридической бухгалтерской системой для Румынии, в то время как Odoo становится основным операционным ERP для веб-сайтов, маркетинга, продаж, складов, POS, конфигурации и консолидированной управленческой отчетности.

1. Деловой контекст

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

Компания использует Odoo в качестве основного операционного ERP для:

• интеграций веб-сайтов и электронной коммерции,
• интеграций в области маркетинга,
• операций по продажам,
• операций со складами и запасами,
• POS и операционных процессов,
• управленческих панелей и аналитики.

Цель этого проекта - обеспечить синхронизацию всех данных, относящихся к бухгалтерии, созданных в SmartBill, в Odoo без дублирования, чтобы руководство могло видеть консолидированные отчеты по всей бизнес-структуре и в будущем по нескольким складам и компаниям в других европейских странах.

2. Основной принцип

• SmartBill = источник правды для бухгалтерских и юридических/комплаенс данных
• Odoo = источник правды для операционных процессов и консолидированной управленческой отчетности

Интеграция не должна нарушать этот принцип.

3. Требуемая архитектура

Предпочтительная реализация:

SmartBill API → Пользовательский модуль Odoo.sh → Odoo ORM

Пользовательский модуль в Odoo.sh предпочтительнее сценария только Make, потому что модуль может лучше обрабатывать:

• сопоставление полей,
• валидацию,
• предотвращение дублирования,
• логирование,
• повторные попытки,
• будущее обслуживание.

4. Объем проекта

Этап 1 – Обязательный

Первая производственная версия должна синхронизировать следующие сущности из SmartBill в Odoo:

1. Продукты
2. Клиенты / Партнеры
3. Счета-фактуры клиентов
4. Строки счетов-фактур
5. Счета поставщиков / Счета-выписки
6. Платежи
7. Квитанции / ссылки на платежи
8. Рабочие точки / магазины / местоположения, используемые для бухгалтерского учета

Этап 2 – Дополнительный / Следующий этап

1. Движения запасов
2. Более сложная логика склада
3. Дополнительная обратная синхронизация выбранных операционных основных данных из Odoo в SmartBill

5. Основные функциональные требования

5.1 Продукты

Интеграция должна создавать или обновлять продукты в Odoo, используя данные SmartBill.

Типичное сопоставление:

• ID продукта SmartBill → x_smartbill_id
• код / SKU → default_code
• название → name
• категория → categ_id
• единица → uom_id
• цена продажи → list_price
• ставка НДС → taxes_id
• статус активности → active

5.2 Клиенты / Партнеры

Интеграция должна создавать или обновлять партнеров в Odoo, используя данные SmartBill.

Типичное сопоставление:

• ID клиента SmartBill → x_smartbill_id
• компания / полное имя → name
• идентификационный номер налогоплательщика / фискальный код → vat
• номер в торговом реестре → company_registry
• электронная почта → email
• телефон → phone
• страна / город / адрес / почтовый индекс → стандартные поля партнера

5.3 Счета-фактуры клиентов

Счета-фактуры клиентов SmartBill должны синхронизироваться в Odoo как account.move с move_type = out_invoice.

Обязательные данные:

• ID счета-фактуры SmartBill
• Контракт
• серия и номер счета-фактуры
• дата выпуска
• срок оплаты
• клиент
• валюта
• необлагаемая сумма
• сумма налога
• общая сумма
• статус
• заметки / комментарии
• ссылка на рабочую точку / магазин

5.4 Строки счетов-фактур

Каждая строка счета-фактуры должна быть импортирована и связана с правильным счетом-фактурой.

Обязательные данные:

• ID строки SmartBill, если доступно
• продукт
• описание
• количество
• единица
• цена за единицу
• скидка
• ставка НДС
• промежуточный итог
• итоговая сумма

5.5 Счета поставщиков

Счета поставщиков должны быть импортированы в Odoo как account.move с move_type = in_invoice.

5.6 Платежи и квитанции

Платежи должны синхронизироваться в Odoo как account.payment и связываться с соответствующим счетом-фактурой, когда это возможно.

Курсы обмена должны быть импортированы для расчета балансовой стоимости иностранных продуктов.

Решение должно поддерживать логику сверки, чтобы управленческая отчетность в Odoo правильно отражала статус платежей.

6. Предотвращение дублирования и идемпотентность

Это критическое требование.

Интеграция должна предотвращать дублирование, храня идентификаторы SmartBill внутри записей Odoo.

Минимум:

• x_smartbill_id
• x_smartbill_line_id
• x_smartbill_series
• x_smartbill_number
• x_smartbill_company_vat_code

Повторный запуск того же окна синхронизации не должен создавать дублирующие записи.

7. Сопоставление налогов

Ставки НДС SmartBill должны быть сопоставлены с Odoo account.tax.

Разработчик должен реализовать настраиваемый уровень сопоставления налогов:

• НДС SmartBill → налог Odoo

8. Логика синхронизации

Система должна поддерживать:

Полная повторная синхронизация

Ручной повторный импорт для выбранного диапазона дат без создания дубликатов.

9. Логирование и обработка ошибок

Модуль должен включать:

• журналы задач синхронизации,
• журналы ошибок,
• механизм повторных попыток,
• защиту от ограничения скорости,
• видимость администратора внутри Odoo.

Пользователь должен иметь возможность видеть:

• последнюю успешную синхронизацию,
• неудачные записи,
• причину неудачи,
• статус повторной попытки.