==================
Product Origin Text
==================

..
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:todo
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |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 replaces the structured country/state origin fields from ``product_origin``
with a flexible free-text field that can be defined per supplier.

**Problem:**

The standard ``product_origin`` module provides structured fields (country + state) for
product origin. However, suppliers often use creative and varied formats to describe
product origin:

* "Valencia, Spain"
* "Huerta de Ana, Aragón"
* "Organic Farm - Northern Italy"
* "Local producer - Basque Country"
* "Fair Trade - Colombia"

These free-form descriptions don't fit into structured country/state fields.

**Solution:**

This module adds a translatable ``origin_text`` field to ``product.supplierinfo`` that:

* Allows free-form text to describe product origin
* Is stored per supplier (different suppliers may have different origin info)
* Is translatable (can be described differently in each language)
* Is automatically displayed on the product based on the main vendor
  (from ``product_main_seller`` module)

**Features:**

* Free-text ``Origin`` field in supplier info (Purchase tab of product)
* Computed ``Origin`` field in product form (shows main vendor's origin)
* Field is visible in product list view (optional column)
* Full translation support for multiple languages
* Compatible with existing supplier management workflows

**Table of contents**

.. contents::
   :local:

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

This module depends on:

* ``product`` - Base product management
* ``product_main_seller`` - To determine the main vendor for products

To install:

#. Install the required dependencies
#. Install this module through the Odoo Apps menu

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

No configuration is needed. The module works automatically after installation.

The origin text displayed on a product is based on the **main vendor** as determined
by ``product_main_seller`` (the first supplier in the vendors list).

Usage
=====

**To add origin information to a product:**

#. Go to a product form
#. Open the **Purchase** tab
#. In the **Vendors** section, select a supplier line
#. Fill in the **Origin** field with free-form text describing the origin
   (e.g., "Valencia, Huerta de..., Spain")
#. Save the product

**To view origin information:**

* The **Origin** field will be automatically displayed on the product form
  (below the **Main Vendor** field in the Purchase tab)
* The origin shown is from the **main vendor** (first supplier in the list)
* You can also add the Origin column to product list views

**To change the displayed origin:**

* Reorder the vendors list to change which is the main vendor
* The origin text will automatically update to show the new main vendor's origin

**Multi-language support:**

* The origin text is translatable
* Switch to another language and edit the supplier info to provide a translation
* Each language can have a different description of the origin

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

Bugs are tracked on `Criptomart GitLab Issues
<https://git.criptomart.net/criptomart/addons-cm/issues>`_.

In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomed
feedback.

Credits
=======

Contributors
------------

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

  * Development and implementation

Financiers
----------

**Development:**

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

**Funding:**

* `Elika Bilbo <https://elikabilbo.eus>`_

This module was developed by Criptomart with funding from Elika Bilbo.

Maintainers
-----------

This module is maintained by Criptomart.

.. image:: https://criptomart.net/logo.png
   :alt: Criptomart
   :target: https://criptomart.net

This module is part of the `addons-cm <https://git.criptomart.net/criptomart/addons-cm>`_ project.
