Inventree Ipn Generator | InvenTree

## inventree-ipn-generator

LavissaWoW

last modified: 21 May 2025

## Introduction

Installing this plugin enables the automatic generation if Internal Part Numbers (IPN) for parts.

## Installation

To automatically install the plugin when running `invoke install`: Add `inventree-ipn-generator` to your plugins.txt file.

Or, install the plugin manually:

    pip install inventree-ipn-generator

For the plugin to be listed as available, you need to enable “Event Integration” in your plugin settings. This setting is located with the Plugin Settings on the settings page.

## Settings

- Active - Enables toggling of plugin without having to disable it
- On Create - If on, the plugin will assign IPNs to newly created parts
- On Change - If on, the plugin will assign IPNs to parts after a change has been made. Enabling this setting will remove the ability to have parts without IPNs.

## Pattern

Part Number patterns follow three basic groups. Literals, Numerics, and characters. When incrementing a part number, the rightmost group that is mutable will be incremented. All groups can be combined in any order.

A pattern cannot consist of only Literals.

For any pattern, only the rightmost non-literal group will be incremented. When this group rolls over its max, the next non-literal group to the left will be incremented. Example: Given the groups (named for demo): L1C1N1C2L2 Incrementing follows this order: C2, N1, C1.

> NOTE: When C1 in the above example rolls over, the plugin will loop back to the first IPN. This will cause duplicate IPNs if your InvenTree allows duplicate IPNs. If your InvenTree does not allow duplicate IPNs, this will cause an error at the moment! This will be addressed in an upcoming update.

### Literals (Immutable)

Anything encased in `()` will be rendered as-is. no change will be made to anything within.

Example: `(A6C)` will always render as “A6C”, regardless of other groups

### Numeric

Numbers that should change over time should be encased in `{}`

- `{5}` respresents a number with max 5 digits
- `{25+}` represents a number 25-99

Example: `{5+}{3}` will result in this range: 5000-9999

### Characters

Characters that change should be encased in `[]`

- `[abc]` represents looping through the letters `a`, `b`, `c` in order.
- `[a-f]` represents looping through the letters from `a` to `f` alphabetaically

These two directives can be combined.

- `[aQc-f]` represents:
- - `a`, `Q`, `c-f`

### Examples

1. `(AB){3}[ab]` -> AB001a, AB001b, AB002a, AB021b, AB032a, etc
2. `{2}[Aq](BD)` -> 01ABD, 01qBD, 02ABD, 02qBD, etc
3. `{1}[a-d]{8+}` -> 1a8, 1a9, 1b8, 1b9, 1c8, 1c9, 1d8, 1d9, 2a8, etc

## Detail section

License: MIT

Status:
Stable
Maintained
Package on PyPI:

    inventree-ipn-generator

#### Issue Tracker

#### Sourcecode on GitHub

LavissaWoW/inventree-ipn-generator

#### Categories

Event

#### Tags

Part IPN Generator