Skaner Kontaktów Pro
Kod QR w standardzie vCard na karcie każdego kontaktu oraz skaner kamerą, który po odczycie odnajduje pasujący rekord w bazie albo tworzy nowy — zawsze po wyraźnym potwierdzeniu użytkownika. Moduł zależy wyłącznie od aplikacji Kontakty.
Zapytaj o moduł → +48 516 512 605// METRYKA MODUŁU
- nazwa techniczna
perp_contact_scanner - wydanie Odoo
Odoo 18 i Odoo 19 (Community) - zależności
base, contacts - licencja
OPL-1
Bez edycji Enterprise Odoo. Bez powłoki web_perp. Bez żadnego innego modułu rodziny PERP.
Dwie uzupełniające się funkcje
Skaner Kontaktów Pro rozszerza aplikację Kontakty w Odoo o kod QR na karcie kontaktu oraz o ekran skanera kamerą. Jedno bez drugiego też działa.
Kod QR (vCard) na karcie kontaktu
Na formularzu kontaktu, w zakładce Kontakty nad listą kontaktów podrzędnych, pojawia się kod QR z danymi w standardzie vCard 3.0. Dowolny telefon odczyta go natywnie aparatem i zaproponuje zapis w książce telefonicznej.
- ▸ Renderowany jako wektorowy SVG — ostry przy dowolnym powiększeniu, gotowy do druku
- ▸ Na desktopie powiększa się po najechaniu kursorem, na telefonie widoczny od razu w pełnym rozmiarze
- ▸ Przeliczany na bieżąco — po zmianie danych kontaktu odświeża się automatycznie
- ▸ Pojawia się tylko wtedy, gdy kontakt ma uzupełnioną nazwę
Skaner kamerą
Wbudowany ekran skanera czyta kod QR vCard z wizytówki albo z ekranu innego komputera, a następnie odnajduje pasujący kontakt w bazie albo tworzy nowy. Uruchomienie: aplikacja Skaner Kontaktów Pro, skrót w Kontaktach albo adres /odoo/skaner-kontaktow-pro.
- ▸ Podgląd z kamery z ramką celowniczą, sygnał dźwiękowy i wibracja po odczycie
- ▸ Ten sam kod powtórzony w ciągu 2,5 sekundy jest ignorowany — bez podwójnych odczytów
- ▸ Dotknięcie podglądu wymusza ponowne ustawienie ostrości
- ▸ Bez kamery lub bez zgody na jej użycie zostaje tryb ręcznego wklejenia treści vCard
Cztery klucze, trzy możliwe wyniki
Po odczytaniu karty vCard moduł szuka pasującego kontaktu w bazie w ustalonej kolejności, z normalizacją wartości. Dopiero wynik tego wyszukiwania decyduje, jaki ekran zobaczy użytkownik.
NIP
Klucz podstawowy. Przy porównaniu pomijane są spacje, myślniki, kropki i dwuliterowy prefiks kraju, na przykład PL.
klucz pewnyDrugi klucz w kolejności. Sprawdzany, gdy karta vCard nie zawiera NIP-u albo gdy NIP nie ma odpowiednika w bazie.
klucz pewnyTelefon
Porównywane jest ostatnie dziewięć cyfr numeru, dzięki czemu prefiks kraju nie przeszkadza w dopasowaniu.
wskazówka pomocniczaNazwa
Ostatni krok. Traktowany jako podpowiedź, a nie rozstrzygnięcie — decyzję zawsze podejmuje użytkownik.
wskazówka pomocniczaA · Jedno dopasowanie
Karta znalezionego kontaktu: nazwa, NIP, e-mail, telefon, miasto.
- Otwórz kontakt
- To jednak nowy → utwórz
- Skanuj kolejny
B · Kilka dopasowań
Klikalna lista pasujących rekordów. Kliknięcie pozycji otwiera dany kontakt.
- Wybór z listy
- Żaden z nich → utwórz nowy
- Skanuj kolejny
C · Brak dopasowania
Podgląd danych z karty vCard oraz pole wyboru „Oznacz jako firmę”, domyślnie zaznaczone przy nazwie firmy w kodzie.
- Utwórz kontakt
- Anuluj i skanuj kolejny
Co siedzi pod maską
Rozwiązania, które decydują o tym, że skan działa na wizytówce z małym nadrukiem i na telefonie z zaciętym autofokusem.
NIP w polu NOTE
Standard vCard nie ma pola na numer podatkowy. NIP trafia do pola NOTE w formacie NIP:wartość — karta pozostaje w pełni zgodna ze standardem, a skaner dostaje pewny klucz do deduplikacji.
vCard 3.0 · NOTEDwa silniki dekodowania
Moduł wybiera najlepszy dostępny dekoder: natywny BarcodeDetector przeglądarki, a tam gdzie go nie ma — dołączoną bibliotekę zapasową ZXing.
ZXing 0.21.3 · Apache 2.0Uprawnienia i ślad audytowy
Tworzenie kontaktów wymaga grupy Menedżer kontaktów. Każdy rekord założony przez skaner dostaje wpis w dzienniku kontaktu — ślad zgodny z zasadami RODO/DSGVO.
base.group_partner_managerAgresywny autofokus
Zaraz po starcie kamera kilkukrotnie dociska ostrość. Pomaga telefonom, którym autofokus zacina się na rozmytym zbliżeniu. Dotknięcie podglądu wymusza ostrość w dowolnym momencie.
domyślnie włączoneWybór i pamięć obiektywu
Przy kilku aparatach nad podglądem pojawia się lista wyboru kamery. Wybrany obiektyw jest zapamiętywany na danym urządzeniu i użyty automatycznie przy kolejnym uruchomieniu.
pamięć przeglądarkiZoom sprzętowy
Powiększenie w zakresie od 1.0 do 5.0 działa wyłącznie na kamerach ze sprzętowym zoomem optycznym. Na pozostałych jest celowo ignorowane — cyfrowe przybliżenie rozmywałoby obraz i pogarszało odczyt.
zoom 1.0 – 5.0Czytniki sprzętowe
Tryb klawiatury przechwytuje skany z kolektorów Android oraz czytników USB i Bluetooth w dowolnym miejscu ekranu skanera. Czytnik musi mieć ustawiony sufiks Enter.
HID · min. 8 znakówSkalowalny kod QR
Rozmiar kodu na formularzu kontaktu ustawia się globalnie w zakresie od 80 do 800 pikseli. Po zmianie ustawienia kody odświeżają się automatycznie — pamięć podręczna jest unieważniana przy zapisie.
SVG · 80 – 800 pxBez wysyłania danych na zewnątrz
Dekodowanie kodów odbywa się w przeglądarce, a wyszukiwanie i tworzenie kontaktów na Twoim serwerze Odoo. Dane nie trafiają do usług zewnętrznych.
przetwarzanie lokalneWszystko w jednej sekcji Ustawień
Konfiguracja modułu mieści się w trzech blokach w Ustawieniach Odoo. Wartości domyślne są dobrane pod typowe skanowanie wizytówek telefonem.
UCZCIWIE: ustawienia są globalne dla bazy, nie per użytkownik. Wyjątkiem jest wybrany obiektyw kamery, zapamiętywany osobno na każdym urządzeniu.
Co musi być po Twojej stronie
Moduł jest celowo przenośny. Poza aplikacją Kontakty i połączeniem HTTPS nie wymaga niczego ponad standardową instalację.
- ▸ Odoo 18 lub Odoo 19
- ▸ Wydanie Community
- ▸ Aplikacja Kontakty
- ▸ zależności: base, contacts
- ▸ licencja OPL-1
- ▸ Chrome, Edge, Safari, Firefox
- ▸ kontekst bezpieczny HTTPS
- ▸ zgoda na dostęp do kamery
- ▸ BarcodeDetector lub ZXing
- ▸ bez kamery: tryb ręczny
- ▸ kamera, najlepiej tylna
- ▸ opcjonalnie czytnik HID
- ▸ QR Code, Data Matrix
- ▸ Code 128, EAN-13, EAN-8
- ▸ dopasowanie: QR vCard
Granice zakresu, zanim kupisz
Moduł robi jedną rzecz i robi ją dobrze. Poniżej to, czego nie obejmuje — żeby nie było niespodzianki po wdrożeniu.
✓ Co moduł robi
- Generuje kod QR vCard na karcie każdego kontaktu z nazwą
- Czyta kody QR vCard kamerą, czytnikiem HID albo z ręcznie wklejonej treści
- Odnajduje istniejący kontakt po NIP-ie, e-mailu, telefonie i nazwie
- Tworzy nowy kontakt po wyraźnym potwierdzeniu i z wpisem w dzienniku
- Działa w całości lokalnie: przeglądarka plus Twój serwer Odoo
— Czego moduł nie obejmuje
- Nie rozdziela danych na firmę z kontaktami podrzędnymi — powstaje zawsze jeden rekord, a pole „Oznacz jako firmę” decyduje wyłącznie o jego typie
- Nie czyta wizytówek papierowych bez kodu QR — nie ma w nim rozpoznawania tekstu ani OCR
- Nie obsługuje dowolnych kodów QR: numer telefonu czy adres WWW zostanie odczytany, ale odrzucony jako nieprawidłowy
- Nie oferuje zoomu cyfrowego — na kamerach bez zoomu optycznego ustawienie jest celowo ignorowane
- Nie działa bez HTTPS w części kamerowej: przeglądarki udostępniają aparat wyłącznie w kontekście bezpiecznym
Dwie drogi do tej samej funkcji
Skanowanie wizytówek dostajesz albo jako pojedynczy moduł do istniejącej instalacji Odoo, albo w zakresie systemu PERP Enterprise.
Skaner Kontaktów Pro
Instalacja do Twojej działającej bazy Odoo 18 albo 19, na Twojej infrastrukturze.
- ✓ Paczka ZIP do katalogu addons i restart usługi
- ✓ Bez zależności od pozostałych modułów PERP
- ✓ Licencja OPL-1, aktualizacje w ramach wersji
- ✓ Wycena i faktura po kontakcie mailowym
PERP Enterprise
Komercyjny system ERP z pełnym zakresem funkcjonalnym: finanse i księgowość, magazyn, sprzedaż i CRM, produkcja, projekty, kadry. Skanowanie wizytówek jest częścią tego zakresu.
- ✓ SaaS edition — od 550 zł netto miesięcznie, uruchomienie 1 700 zł
- ✓ Lifetime edition — 5 000 zł netto jednorazowo, wdrożenie w cenie
- ✓ Bez opłat licencyjnych za użytkownika
- ✓ Dane wyłącznie w Unii Europejskiej
Pozostałe moduły w sklepie
Każdy z nich działa samodzielnie i każdy wchodzi w zakres systemu PERP Enterprise.
Zanim zapytasz mailem
Czy moduł działa na Odoo 19?
Tak. Moduł jest utrzymywany w gałęziach 18.0 i 19.0, w obu przypadkach dla wydania Community. Zakres funkcjonalny obu gałęzi jest ten sam.
Czy wymaga powłoki web_perp albo innego modułu PERP?
Nie. Zależności modułu to wyłącznie base i contacts. Instaluje się do czystej bazy Odoo z aplikacją Kontakty i działa bez żadnego innego modułu naszej rodziny.
Czy potrzebuję Odoo Enterprise?
Nie. Moduł działa na wydaniu Community, a więc również na Odoo Pro EXTREME (Edycja PERP) i w systemie PERP Enterprise.
Czy działa na iPhonie?
Tak. Na iOS i w Safari używana jest dołączona biblioteka zapasowa ZXing, ponieważ te przeglądarki nie mają natywnego interfejsu BarcodeDetector. Warunkiem jest połączenie HTTPS.
Czy dane kontaktów opuszczają mój serwer?
Nie. Dekodowanie kodu odbywa się w przeglądarce, a wyszukiwanie i zapis kontaktu na Twoim serwerze Odoo. Moduł nie wysyła danych do usług zewnętrznych.
Kto może tworzyć kontakty ze skanera?
Wyłącznie użytkownicy z uprawnieniem Menedżer kontaktów. Pozostali mogą skanować i otwierać istniejące rekordy, ale zamiast przycisku tworzenia zobaczą komunikat o braku uprawnień.
Dlaczego skaner znalazł kontakt, choć spodziewałem się nowego?
Dopasowanie zaczyna się od NIP-u i e-maila. Jeśli w bazie jest rekord z tym samym numerem albo adresem, zostanie wskazany. W takiej sytuacji wystarczy wybrać „To jednak nowy → utwórz”.
Co jeśli urządzenie nie ma kamery?
Zostaje tryb ręczny: treść karty vCard wkleja się w pole tekstowe na ekranie skanera i klika Sprawdź. Dalsze działanie, czyli dopasowanie i tworzenie kontaktu, jest identyczne jak przy skanowaniu.
Chcesz zobaczyć skaner na swoich danych?
Napisz albo zadzwoń. Podamy wycenę modułu dla Twojej wersji Odoo i pokażemy działanie na instancji demonstracyjnej.
info@nexus-digital.pl → +48 516 512 605 +49 30 577 12 726Nexus Digital, Inh.: Marius Johannes Kuc · Bessemerstraße 51, 12103 Berlin, Niemcy · VAT ID: DE 352550014
Nota prawna: Skaner Kontaktów Pro jest dystrybuowany na licencji OPL-1. Rdzeń systemu PERP Enterprise korzysta z komponentów open source na licencji LGPL-3. Odoo jest znakiem towarowym Odoo S.A.; Nexus Digital nie jest z tą spółką powiązany kapitałowo ani umową partnerską. Treść nie stanowi oferty w rozumieniu Kodeksu cywilnego.
Skaner Kontaktów Pro — perp_contact_scanner · Odoo 18 i 19 Community · licencja OPL-1
Kod QR vCard · skaner kamerą · deduplikacja po NIP-ie · Wsparcie: support@nexus-digital.pl · Strona: odoo.com.pl