Files
public/ruodoo_sale_control/README.rst

107 lines
5.5 KiB
ReStructuredText
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
=================================
РуОду — Контроль отгрузки заказов
=================================
.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
:target: https://odoo-community.org/page/development-status
:alt: Beta
.. |badge2| image:: https://img.shields.io/badge/licence-LGPL--3-blue.png
:target: http://www.gnu.org/licenses/lgpl-3.0-standalone.html
:alt: License: LGPL-3
|badge1| |badge2|
Расширение продаж для контроля финансовых условий отгрузки и приёма
закрывающих документов. Заказ подтверждается к отгрузке только при
выполнении условий по балансу клиента; не прошедший проверку заказ
переводится в состояние «Ожидание оплаты».
Порт модуля ``gok_sale`` (Odoo 17) на платформу РуОду (Odoo 19).
**Содержание**
.. contents::
:local:
Возможности
===========
* Контроль отгрузки заказа по выбранному типу:
* *По подтверждению* — отгрузка разрешена всегда
* *По балансу* — долг клиента покрывает сумму заказа
* *По балансу + овердрафт* — с учётом лимита кредита
* Перевод не прошедшего проверку заказа в состояние «Ожидание оплаты»
с записью в чаттер
* Повторная проверка всех ожидающих заказов одним действием
(``validate_all``) — удобно для планировщика
* Активность «Допущено до отгрузки» на подтверждённом заказе
* Подсветка заказов с ценами ниже ранее согласованных для клиента
* Автоматическая генерация артикула (SKU) для новой номенклатуры
* Приём закрывающих документов по счетам (почта, ЭДО, оригинал, скан),
в том числе загрузка скан-копий клиентом из портала
Зависимости
===========
* ``sale_stock`` — заказы на продажу и отгрузка
* ``account`` — счета (``account.move``)
* ``portal`` — загрузка закрывающих документов из портала клиента
Настройка
=========
#. В заказе на продажу выберите *Тип контроля отгрузки* (по умолчанию
«По подтверждению»).
#. Для контроля по балансу заполните на контрагенте лимит кредита и
отслеживайте долг (поля выведены в карточку партнёра).
Использование
=============
#. Оформите заказ на продажу и нажмите «Подтвердить».
#. Если условия выполнены — заказ подтверждается штатно, создаётся
активность «Допущено до отгрузки».
#. Если условия не выполнены — заказ переходит в «Ожидание оплаты».
После поступления оплаты повторно подтвердите заказ вручную или
запустите повторную проверку всех ожидающих заказов.
#. Закрывающие документы регистрируются на счёте (поле «Закрывающий
документ») либо загружаются клиентом из портала счёта — тогда
создаётся запись со скан-копией.
Отличия от исходного модуля
===========================
При портировании исправлены дефекты оригинала:
* контроль баланса ведётся в контексте компании заказа
(``with_company``) без изменения текущей компании среды;
* тип активности задаётся data-записью, а не поиском по названию;
* последовательность SKU поставляется модулем;
* приём документов из портала вынесен на отдельный маршрут
``/my/closing_document`` (только для авторизованных пользователей).
Тестирование
============
Модуль покрыт тестами ``TransactionCase`` (генерация SKU, состояние
«Ожидание оплаты», проверки отгрузки по типам, повторная валидация,
подсветка цен, закрывающие документы). Запуск::
docker compose run --rm odoo odoo -d <db> -i ruodoo_sale_control \
--test-enable --test-tags=/ruodoo_sale_control --stop-after-init
Авторы
======
* MK.Lab, RuOdoo
Модуль сопровождается MK.Lab, RuOdoo.
.. image:: https://ruodoo.ru/logo.png
:alt: MK.Lab, RuOdoo
:target: https://ruodoo.ru
Модуль является частью решения РуОду.