addons-cm/product_sale_price_from_pricelist
snt 4a4639f13a [DOC] Actualizar documentación a estándares OCA y preparar logo CriptoMart
- Renombrar README.md a README_DEV.md en todos los addons custom
- Crear README.rst siguiendo estructura OCA oficial
- Crear directorios readme/ con fragmentos .rst (DESCRIPTION, INSTALL, CONFIGURE, USAGE, CONTRIBUTORS, CREDITS)
- Actualizar créditos: Criptomart (autor) + Elika Bilbo (financiador)
- Actualizar __manifest__.py con maintainers correctos
- Crear estructura static/description/ para logo en 5 addons
- Agregar documentación de logo (LOGO_INSTRUCTIONS.md, install_logo.sh)
- Actualizar copilot-instructions.md con referencias a OCA_DOCUMENTATION.md
- Crear docs/OCA_DOCUMENTATION.md con guía completa de estructura
- Crear docs/RESUMEN_CAMBIOS_DOCUMENTACION.md con resumen detallado

Addons actualizados:
- website_sale_aplicoop
- product_sale_price_from_pricelist
- product_pricelist_total_margin
- product_price_category_supplier
- account_invoice_triple_discount_readonly
2026-02-21 19:55:57 +01:00
..
i18n product_sale_price_from_pricelist: fix tranlations 2025-07-09 17:57:10 +02:00
migrations [REF] Code quality improvements and structure fixes 2026-02-21 13:51:25 +01:00
models [ADD] product_pricelist_total_margin: New module for additive margin calculation 2026-02-21 16:11:13 +01:00
readme [DOC] Actualizar documentación a estándares OCA y preparar logo CriptoMart 2026-02-21 19:55:57 +01:00
tests [TEST FIX] Resolver errores de tests en addons custom 2026-02-18 18:17:55 +01:00
views [FIX] website_sale_aplicoop: Remove redundant string= attributes and fix OCA linting warnings 2026-02-18 17:54:43 +01:00
__init__.py add product_sale_price_from_pricelist 2025-02-04 21:15:51 +01:00
__manifest__.py [FIX] product_sale_price_from_pricelist: Protect Float computed fields 2026-02-14 18:20:20 +01:00
CHANGELOG.md [FIX] product_sale_price_from_pricelist: Protect Float computed fields 2026-02-14 18:20:20 +01:00
README.rst [DOC] Actualizar documentación a estándares OCA y preparar logo CriptoMart 2026-02-21 19:55:57 +01:00
README_DEV.md [DOC] Actualizar documentación a estándares OCA y preparar logo CriptoMart 2026-02-21 19:55:57 +01:00

====================================
Product Sale Price from Pricelist
====================================

.. |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-AGPL--3-blue.png
    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
    :alt: License: AGPL-3

|badge1| |badge2|

This module automatically calculates and updates product sale prices based on the last purchase price and configurable pricelists.

**Key Features:**

* **Automatic Price Calculation**: Set sale prices based on last purchase price and a configured pricelist
* **Flexible Discount Handling**: Choose how to apply discounts to the cost:

  * Without discounts
  * First discount only
  * Double discount
  * Triple discount
  * Manual update

* **Tax-Aware Pricing**: Automatically includes tax calculations in pricing
* **UoM Conversion**: Handles different purchase and sale units of measure
* **Batch Updates**: Update theoretical prices for multiple products
* **Product Flags**: Mark products for price updates and track status
* **Variant Architecture**: All business logic in product.product for proper pricelist handling

**Table of contents**

.. contents::
   :local:

Installation
============

To install this module, you need to:

#. Ensure dependencies are installed (product, purchase, sale)
#. Update the Apps list
#. Search for "Product Sale Price from Pricelist"
#. Click Install

Configuration
=============

To configure this module, you need to:

**Global Configuration:**

#. Go to Settings → Sales → Automatic Price Configuration
#. Select the pricelist for automatic price calculation
#. Save settings

**Per Product Configuration:**

#. Go to Products → Products
#. Open a product form
#. Configure:

   * **Last purchase price**: Cost at which the product was last purchased
   * **Last purchase price calculation type**: Choose how to apply discounts

     * Without Discounts: Uses base purchase price
     * First Discount: Applies only the first discount
     * Double Discount: Applies first and second discount
     * Triple Discount: Applies first, second, and third discount
     * Manual Update: Price must be set manually

   * **Last purchase price updated**: Mark when prices need review

**Important Notes:**

* Ensure products have taxes configured (required for price calculation)
* Set calculation type to anything except "manual_update" for automatic pricing

Usage
=====

**Automatic Price Updates:**

#. Products are priced automatically when received from purchase orders
#. System updates the **last_purchase_price** field automatically
#. Sale price is calculated from the configured pricelist using the cost price
#. Taxes are automatically applied based on product tax settings

**Manual Price Updates:**

#. Go to Products → Update Theoretical Prices
#. Select products to update
#. System recalculates theoretical prices based on current settings
#. Review and apply changes

**Price Calculation Flow:**

#. Purchase order is received
#. System extracts cost from purchase line (with configured discount handling)
#. Applies configured pricelist rules
#. Calculates taxes
#. Updates theoretical price
#. Optionally auto-updates sale price (list_price)

**Monitoring:**

* Use **Last purchase price updated** flag to track products needing review
* Filter products by calculation type to manage different pricing strategies
* Review **list_price_theoritical** vs **list_price** to see proposed vs actual prices

Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/Criptomart/addons-cm/issues>`_.
In case of trouble, please check there if your issue has already been reported.

Credits
=======

Authors
~~~~~~~

* Criptomart

Funding
~~~~~~~

* Elika Bilbo

Contributors
~~~~~~~~~~~~

* `Criptomart <https://criptomart.net>`_:

  * Main development and implementation
  * Architecture design for product variant handling

Other credits
~~~~~~~~~~~~~

This module integrates with the OCA product ecosystem and follows best practices for:

* Product variant architecture (business logic in product.product)
* Pricelist compatibility
* Tax-aware pricing calculations
* UoM conversions

Maintainers
~~~~~~~~~~~

This module is maintained by Criptomart.

.. image:: https://odoo-community.org/logo.png
   :alt: Odoo Community Association
   :target: https://odoo-community.org

This module is part of the `Criptomart/addons-cm <https://github.com/Criptomart/addons-cm/tree/18.0/product_sale_price_from_pricelist>`_ project on GitHub.