Generator Kodów Pro — kody EAN-13 i UPC-A nadawane automatycznie
Moduł nadaje produktom poprawne i unikalne kody kreskowe: nowemu produktowi w chwili zapisu, całemu katalogowi jednym kreatorem. Cyfra kontrolna GS1 liczona jest zawsze automatycznie, a unikalność sprawdzana w całej bazie — nie tylko w obrębie firmy, jak w standardzie Odoo.
Pobierz moduł → Co potrafi// SZYBKIE FAKTY
- ▸ Nazwa techniczna: perp_barcode_generator
- ▸ Wersje: 19.0.1.0.0 /
18.0.1.10.0 - ▸ Odoo 18.0 lub 19.0 (Community / Pro EXTREME)
- ▸ Zależności: base, product, stock
- ▸ Formaty: EAN-13, UPC-A
- ▸ Numeracja: losowa lub sekwencyjna
- ▸ Licencja: OPL-1
- ▸ Cena: 0 zł
Trzy tryby pracy — jeden moduł
Ten sam mechanizm generowania działa w tle przy zapisie produktu, na żądanie z formularza i masowo z listy. Ustawienia są wspólne dla wszystkich trzech trybów.
Automatycznie przy tworzeniu
Nowy produkt bez wpisanego kodu otrzymuje go w chwili zapisu. Nic nie trzeba klikać.
- ▸ Własna wartość ma pierwszeństwo — moduł nie nadpisuje ręcznie wpisanego kodu
- ▸ Przy produktach z wariantami kod trafia na właściwy wariant
- ▸ Funkcję można wyłączyć w Ustawieniach
Przycisk „Generuj kod"
Na formularzu produktu, obok pola Kod kreskowy. Jedno kliknięcie, jeden kod.
- ▸ Widoczny tylko wtedy, gdy pole kodu jest puste
- ▸ Nadaje kod zgodny z bieżącymi ustawieniami modułu
- ▸ Nie podmienia istniejącej wartości przez przypadek
Kreator masowy
Lista Produkty lub Warianty produktów → Działania → Generuj kody kreskowe (PERP).
- ▸ Zakres: zaznaczone rekordy albo wszystkie produkty w bazie
- ▸ Tryb: tylko produkty bez kodu albo nadpisanie istniejących
- ▸ Po zakończeniu powiadomienie z liczbą nadanych kodów
Trzy typowe ustawienia kreatora
Kombinacja pól Zakres, Tryb i Format decyduje o tym, co zrobi kreator. Poniżej ustawienia, po które sięga się najczęściej.
Uzupełnienie braków w całym katalogu
Kody trafiają wyłącznie tam, gdzie ich brakuje. Istniejące pozostają nietknięte.
Tryb: Tylko produkty bez kodu
Regeneracja wybranych pozycji
Zaznaczone produkty dostają nowe kody. Operacja nieodwracalna — patrz ostrzeżenie niżej.
Tryb: Nadpisz istniejące
Grupa eksportowa w UPC-A
Jednorazowe wymuszenie formatu innego niż domyślny, bez zmiany ustawień globalnych.
Format: UPC-A
Co dokładnie jest generowane
Ostatnia cyfra kodu EAN-13 i UPC-A jest wyliczana z pozostałych według algorytmu GS1 — czytniki używają jej do wykrywania błędów odczytu. Moduł liczy ją zawsze automatycznie.
Numeracja losowa
Kod wypełniany losowymi cyframi. Przy ewentualnej kolizji moduł próbuje ponownie. Ustawienie domyślne.
Numeracja sekwencyjna
Kolejne kody pochodzą z deterministycznej sekwencji Odoo perp.barcode.generator. Wygodne, gdy potrzebna jest uporządkowana, rosnąca numeracja.
Prefiks
Opcjonalny prefiks cyfrowy poprzedza część generowaną — na przykład zakres zarezerwowany na produkty własne. Tylko cyfry, maksymalnie 10 znaków, musi zostawić miejsce na co najmniej jedną generowaną cyfrę.
Cztery parametry, jeden ekran
Ustawienia → Generator Kodów Pro. Obowiązują globalnie i dotyczą zarówno generowania automatycznego, jak i kreatora — chyba że w kreatorze wybierzesz nadpisanie formatu.
Po zmianie ustawień kliknij Zapisz. Konfiguracja wymaga dostępu do Ustawień (administrator); samo generowanie kodów — prawa zapisu produktów (zwykły użytkownik wewnętrzny).
Unikalność kodu i dwie rzeczy, o których trzeba wiedzieć
✓ Kontrola unikalności
- Przed nadaniem kodu moduł sprawdza, czy nie jest on już używany przez inny wariant produktu ani przez opakowanie (product.packaging)
- Kontrola działa w obrębie całej bazy — bardziej rygorystycznie niż natywne ograniczenie Odoo, które obowiązuje w obrębie firmy
- Dzięki temu operacje masowe nie zatrzymują się w połowie z powodu konfliktu
- W obrębie jednej operacji moduł pilnuje też, by dwa świeżo wygenerowane kody nie były identyczne
⚠️ Zanim uruchomisz nadpisywanie
- Nadpisania nie da się cofnąć. Wydrukowane etykiety i kody dostawców przestaną się zgadzać
- Po regeneracji kodów trzeba ponownie wydrukować etykiety
- Przed operacją masową na produkcji — kopia zapasowa bazy i próba na instancji testowej
- Tylko jeden moduł generujący naraz. Jeżeli wcześniej używałeś innego modułu nadającego kody przy zapisie produktu, odinstaluj go przed instalacją tego. Dwa moduły nadpisujące tworzenie produktu działają na siebie
Cztery kroki przez interfejs Odoo
Moduły bazowe product i stock instalują się automatycznie jako zależności.
Wgraj moduł
ZIP do katalogu dodatków (/mnt/extra-addons) albo Aplikacje → Importuj moduł.
Odśwież listę
Aplikacje → Zaktualizuj listę aplikacji.
Zainstaluj
Wyszukaj „Generator Kodów Pro" i kliknij Instaluj.
Skonfiguruj
Ustawienia → Generator Kodów Pro. Od tej chwili nowe produkty dostają kody automatycznie.
docker compose restart web
Informacje techniczne
Pole Kod kreskowy na szablonie produktu jest w Odoo polem wyliczanym (proxy na wariant) — fizycznie kod zapisywany jest na wariancie. Moduł obsługuje to przezroczyście.
- ▸ perp_barcode_generator
- ▸ 19.0.1.0.0
- ▸
18.0.1.10.0 - ▸ Licencja OPL-1
- ▸ Zależności: base, product, stock
- ▸ perp_barcode_generator.autogen
- ▸ perp_barcode_generator.format
- ▸ perp_barcode_generator.method
- ▸ perp_barcode_generator.prefix
- ▸ sekwencja: perp.barcode.generator
- ▸ prefiks kodu: perp_
- ▸ klasy OWL: Perp...
- ▸ CSS: o_perp_
- ▸ zapis kodu: product.product
- ▸ kontrola: product.packaging
Co moduł robi, a czego nie robi
Generator Kodów Pro robi jedną rzecz: nadaje poprawne i unikalne kody. Reszta łańcucha — drukowanie, skanowanie, rejestracja puli GS1 — leży poza nim.
✓ Moduł obejmuje
- Generowanie kodów EAN-13 i UPC-A z poprawną cyfrą kontrolną GS1
- Automatyczne nadanie kodu przy tworzeniu produktu
- Nadanie pojedyncze z formularza produktu
- Kreator masowy dla zaznaczonych pozycji lub całego katalogu
- Numerację losową i sekwencyjną oraz opcjonalny prefiks cyfrowy
- Kontrolę unikalności w obrębie całej bazy, z uwzględnieniem opakowań
— Moduł nie obejmuje
- Rejestracji puli numerów w GS1. Kody powstają lokalnie w Twojej bazie. Do sprzedaży przez sieci handlowe potrzebna jest własna, wykupiona pula GS1 — moduł jej nie załatwia
- Projektowania i drukowania etykiet. To osobna funkcja Odoo
- Skanowania kodów. Odczyt kamerą to zadanie osobnego modułu
- Formatów innych niż EAN-13 i UPC-A — bez Code 128, QR i GS1-128
- Nadawania kodów opakowaniom — są uwzględniane w kontroli kolizji, ale kreator ich nie numeruje
- Cofania nadpisanych kodów — odzyskanie wymaga kopii zapasowej bazy
Dalsze ogniwa łańcucha
Nadany kod trzeba jeszcze odczytać na magazynie i użyć w produkcji. Poniżej rozwiązania, które robią te dwie rzeczy.
Zanim zgłosisz problem
Nie widzę przycisku „Generuj kod" na formularzu produktu.
Przycisk pojawia się tylko wtedy, gdy pole kodu jest puste. Produkt ma już kod — jeśli chcesz go zmienić, użyj kreatora w trybie nadpisywania.
W menu Działania nie ma pozycji „Generuj kody kreskowe (PERP)".
Odśwież stronę. Upewnij się, że moduł jest zainstalowany, a użytkownik ma prawo zapisu produktów.
Nowe produkty nie dostają kodów automatycznie.
Sprawdź, czy w Ustawieniach włączona jest opcja Automatyczne generowanie. Sprawdź też, czy kod nie został wpisany ręcznie — własna wartość ma pierwszeństwo i moduł jej nie nadpisuje.
Dostaję komunikat „Pula numeracji dla wybranego formatu/prefiksu została wyczerpana".
Prefiks jest za długi albo numeracja sekwencyjna przekroczyła dostępną liczbę cyfr. Skróć prefiks lub zmień format bądź metodę numeracji.
Moduł zgłasza nieprawidłowy prefiks.
Prefiks może zawierać wyłącznie cyfry, ma maksymalnie 10 znaków i musi zostawić miejsce na co najmniej jedną generowaną cyfrę.
Przypadkowo nadpisałem kody. Da się cofnąć?
Nie. Operacja jest nieodwracalna — dane trzeba przywrócić z kopii zapasowej bazy. Dlatego kreator wyświetla czerwone ostrzeżenie przy wyborze trybu nadpisywania.
Czy odinstalowanie modułu usunie nadane kody?
Nie. Kody pozostają na produktach jako zwykłe wartości pola Kod kreskowy. Dotyczy to również odinstalowania innego, wcześniej używanego modułu generującego.
Czy moduł wymaga pozostałych rozwiązań z rodziny PERP?
Nie. Generator Kodów Pro należy do rodziny Odoo Pro EXTREME (Edycja PERP), ale działa samodzielnie — zależy wyłącznie od standardowych modułów product i stock.
Pobierz i zainstaluj — bez opłat
Generator Kodów Pro jest darmowy. Jeśli potrzebujesz pomocy przy wdrożeniu, rozbudowy o własny format kodu albo pakietu wsparcia — napisz lub zadzwoń.
Pobierz moduł → Napisz do nasInh.: Marius Johannes Kuc
Bessemerstraße 51, 12103 Berlin, Niemcy
VAT ID: DE
Nota prawna: Generator Kodów Pro jest rozpowszechniany na licencji OPL-1. Odoo Community, na którym moduł działa, jest rozwijane na licencji LGPL-3 przez Odoo S.A.; Nexus Digital nie jest powiązana kapitałowo ani umową partnerską z Odoo S.A. Nazwy Odoo, EAN i UPC oraz standardy GS1 należą do ich właścicieli. Treść tej strony ma charakter informacyjny i nie stanowi oferty w rozumieniu Kodeksu cywilnego.
Generator Kodów Pro — perp_barcode_generator · Odoo 19.0.1.0.0 /
EAN-13 · UPC-A · cyfra kontrolna GS1 · generowanie masowe · Odoo Pro EXTREME (Edycja PERP)