Features

The product import step supports:

• Creating products
• Reusing existing products via search fields
• Shared import state integration
• Automatic product variant handling
• Sequential import chaining
• Product reuse in later import steps

The module depends on:

• import_core
• product

Import step registration

The module registers the following import step:

<record id="generic_import_step_product" model="generic.import.step">
    <field name="name">Products</field>
    <field name="code">product</field>
    <field name="sequence">30</field>
    <field name="required_models">product.template</field>
</record>

This means:

• The dispatcher executes runner:

  generic.import.runner.product

• The step is only available when model:

  • product.template

  is installed.

Configuration

1. Install modules:

   • import_core
   • product
   • import_step_products

2. Open:

   Imports -> Templates

3. Create or edit a template

4. Add import step:

   • Products

5. Configure field mappings for model:

   • product.template

6. Optionally mark fields as:

   • Is search field

Search fields are used to find existing products before creating new ones.

Usage

Product Name,Internal Reference,Sales Price
Test Product,SKU-001,99.90

self.env["product.template"].search([
    ("default_code", "=", value)
], limit=1)

Shared import state

The runner stores records into shared state:

state["product_template"]
state["product"]

The product template is stored using:

state = self._set_state_record(
    state,
    "product_template",
    product_template,
)

The product variant is automatically resolved using:

product_template.product_variant_id

and stored into state:

state = self._set_state_record(
    state,
    "product",
    product,
)

Automatic model-based state keys are also generated by generic.import.runner.base.

Example:

state["product_template"]
state["product_product"]

Using products in later steps

Later import steps may reuse imported products through state links.

Typical use cases:

• Sale order lines
• Subscription lines
• Event registrations
• Custom business flows

Example state link configuration:

source_state_key = product
target_model     = sale.order.line
target_field     = product_id

Technical implementation

The runner inherits:

_inherit = "generic.import.runner.base"

Available helper methods include:

• _get_or_create()
• _get_or_create_from_lines()
• _build_domain()
• _clean_vals()
• _set_state_record()

Single variant behavior

The module currently assumes standard single-variant product usage.

The state key:

• state["product"]

always points to:

product_template.product_variant_id

This simplifies integration with later import steps expecting product.product records.

Dependencies

Python dependencies:

• None

Odoo dependencies:

• import_core
• product

Known issues / Roadmap

Credits

Maintainer

This module is maintained by Oy Tawasta OS Technologies Ltd.