Usługa OCR w Comarch ERP Optima
Wstęp
OCR – Optyczne Rozpoznanie Znaków (ang. Optical Character Recognition) to usługa, która umożliwia wczytywanie faktur do rejestru VAT na podstawie skanów i zdjęć dokumentów. Usługa dostępna w Comarch ERP Optima od wersji 2019.2 (Premiera 31.01.2019), na liście Faktur Zakupu oraz na formularzu wiadomości e-mail od wersji 2022.0.1.Informacje ogólne
Jakie dokumenty rozpoznajemy i jakie dane z dokumentów odczytujemy?
Comarch OCR w programie Comarch ERP Optima umożliwia zaczytanie następujących dokumentów:- Faktur
- wystawionych w walucie PLN, EUR, GBP oraz USD,
- wystawionych w języku polskim i angielskim,
- z pojedynczych plików (jeden plik = jedna faktura) oraz z plików, w których znajduje się wiele faktur (jeden plik = wiele faktur),
- do rejestru VAT zakupu, rejestru VAT sprzedaży oraz na listę Faktur zakupu w module Handel.
- Paragonów
- wystawionych w walucie PLN,
- wystawionych w języku polskim,
- z pojedynczych plików (jeden plik = jeden paragon) oraz z plików, w których znajduje się wiele paragonów (jeden plik = wiele paragonów),
- nie jest możliwe zaczytanie kilku paragonów, jeżeli znajdują się one na jednej stronie,
- do rejestru VAT sprzedaży oraz rejestru VAT zakupu.
- Wydań Zewnętrznych/ Przyjęć Zewnętrznych
- wystawionych w walucie PLN, EUR, GBP oraz USD,
- wystawionych w języku polskim,
- z pojedynczych plików (jeden plik = jeden dokument PZ) oraz z plików, w których znajduje się wiele dokumentów PZ (jeden plik = wiele dokumentów PZ),
- na listę Przyjęć zewnętrznych w module Handel.
- numer NIP oraz prefiks (nazwa i adres kontrahenta pobierane są z bazy GUS),
- numer dokumentu,
- data wystawienia i sprzedaży,
- forma płatności i termin płatności,
- stawki VAT oraz kwoty,
- numer rachunku bankowego,
- pozycje na dokumencie,
- numer KSeF (w przypadku dokumentów zaczytywanych do rejestru VAT).
Jak robić zdjęcia lub skany
Podczas pracy z Comarch OCR aby zmaksymalizować poprawność rozpoznawania danych trzeba zwrócić uwagę na poniższe informacje:- potrzebny jest dobrej jakości skan dokumentu lub zdjęcie dokumentu w formacie jpg, pdf, tiff, png lub jpeg (w przypadku formatu jpeg potrzebna jest wersja Comarch ERP Optima 2020.0),
- skan dokumentu/zdjęcie powinny być wykonane w pionie zgodnie z orientacją tekstu na dokumencie,
- maksymalny rozmiar pliku to 20 MB,
- maksymalna liczba stron w pliku to 200,
- maksymalny rozmiar pojedynczej strony to 5MB, 11,7×16,5 cali co odpowiada formatowi A3 a maksymalna rozdzielczość jednej strony to 20mln pikseli
Zadbaj, aby na generowanym obrazie były wszystkie informacje i nie ulegały obcięciu informacje na marginesie dokumentu (np. NIP, numer faktury).
Uruchomienie usługi
- W menu System/Konfiguracji->Program->OCR znajduje się możliwość wskazania jednego z trzech miejsc przechowywania skanów.
- w Konfiguracji firmy/Ogólne/Parametry w sekcji ‘Sprawdzanie wyst. podobnych kontrahentów’ należy wybrać opcję Blokuj
Sposoby dodawania dokumentów
Na liście faktur w rejestrze VAT oraz na liście Faktur Zakupu w menu Handel, dostępna jest ikona OCR, która umożliwia wskazanie jednego lub wiele dokumentów, które powinny zostać przetworzone. Po pierwszym kliknięciu w przycisk OCR – Dodaj fakturę ze zdjęcia, skanu lub PDF , wyświetlane jest menu dostępnych opcji. Wybór jest zapamiętywany i przy kolejnym kliknięciu wywoływana jest opcja poprzednio wybrana. W menu rozwijanym dostępne są opcje: Wybierz dokumenty z dysku – otwierane jest okno, na którym można wskazać dokumenty zapisane na dysku. Możliwe jest wskazanie wielu dokumentów. Wybierz dokumenty z Obiegu dokumentów – otwierane jest okno, na którym można wskazać skany zapisane w Bibliotece dokumentów, mające zaznaczony parametr Udostępnij dla usługi OCR. Oznacz dokumenty jako zweryfikowane/niezweryfikowane – dokumenty przetworzone przez Comarch OCR, które trafiły na listę dokumentów, powinny zostać zweryfikowane przez Użytkownika pod kątem poprawności zaimportowanych danych. Jeżeli dokument zostanie zweryfikowany przez Użytkownika i jest poprawny, należy zmienić na takim dokumencie wartość atrybutu OCR-> Niezweryfikowany na Zweryfikowany. Można w tym celu wykorzystać przycisk dostępny na formularzu dokumentu lub opcję na liście. Weryfikacja z poziomu formularza została opisana w części Atrybuty opisujące dokument. Sprawdź ilość stron do wykorzystania – funkcja umożliwia sprawdzenie, ile stron pozostało do wykorzystania w ramach pakietu Comarch OCR.Atrybuty opisujące dokument
Na dokumentach wczytanych poprzez usługę OCR, widoczne są atrybuty dokumentu:- NUMER_STRONY – informacja, na której stronie w pliku znajduje się dokument, wykorzystywana w celu poprawnego wyświetlenia pliku, na podstawie którego powstał dokument,
- OBRACANIE i OBRACANIE_ILOŚĆ_STR – atrybuty techniczne, wykorzystywane w celu poprawnego wyświetlenia podglądu skanu. Pojawiają się tylko, jeśli skan wymagał obrócenia widoku.
- OCR – atrybut o formacie lista, który jest dodawany w celu łatwego odnalezienia dokumentów przetworzonych za pomocą usługi Comarch OCR. Przyjmuje wartości Niezweryfikowany/ Zweryfikowany.
Weryfikacja przetworzonych dokumentów
Bezpośrednio po wczytaniu dokumentu na listę dokumentów w programie Comarch ERP Optima, ustawiana jest wartość Niezweryfikowany dla atrybutu OCR. Operator może ustawić status Zweryfikowany, po sprawdzeniu zgodności otrzymanego dokumentu z dokumentem utworzonym przez OCR. Szczególną uwagę podczas weryfikacji zwracamy na dane, które są rozpoznawane:- numer NIP,
- numer dokumentu,
- daty,
- forma płatności i termin płatności,
- stawki VAT oraz kwoty,
- numer rachunku bankowego.
- z poziomu formularza dokumentu, zakładka [Atrybuty]:
- z poziomu formularza dokumentu poprzez przycisk OCR .
- seryjnie, korzystając z opcji Oznacz dokumenty jako zweryfikowane/ Oznacz dokumenty jako niezweryfikowane dostępnej na liście dokumentów w rozwinięciu przycisku OCR:
Powiązanie z modułem Obieg Dokumentów
Jeśli wskazywany jest plik z dysku, wówczas przed dodaniem go na listę dokumentów w Comarch ERP Optima, tworzony jest w tle dokument w module Obieg Dokumentów wraz z podpiętym skanem. W kolejnym kroku, skan ten jest za pomocą usługi OCR wczytywany na listę dokumentów. Na formularzu wczytanego dokumentu, na zakładce [Dokumenty] widoczne jest powiązanie z dokumentem Biblioteki dokumentów, jeśli operator zalogowany jest do modułu Obieg Dokumentów. Na formularzu operatora (Start/Konfiguracja/ Program/ Użytkowe/ Operatorzy), na zakładce [Parametry cd] znajduje się parametr Prawo do udostępniania plików dla usługi OCR. Dla operatorów, którzy w konfiguracji mają zaznaczony ten parametr, na formularzu dokumentu firmowego w sekcji Archiwum plików widoczna jest kolumna Udostępnij dla usługi OCR. Kolumna nie jest dostępna na dokumentach, dla których wskazano Typ: Wspólny. W kolumnie Udostępnij dla usługi OCR można zaznaczyć parametr udostępnienia , który jest widoczny tylko dla plików obsługiwanych przez usługę OCR (obecnie są to pliki o rozszerzeniu *.jpg, *tiff, *png, *jpeg, *.pdf.). Po zaznaczeniu parametru, załącznik będzie dostępny dla funkcji OCR, uruchamianej z poziomu listy dokumentów. Jeśli na liście dokumentów wybrana zostanie opcja OCR – Wybierz dokumenty z Obiegu dokumentów, wówczas pojawi się okno Pliki zapisane w Obiegu dokumentów – Wybierz. Jeśli w Bibliotece dokumentów nie ma żadnego dokumentu spełniającego kryteria, wówczas pojawi się informujący o tym komunikat. Na liście wyboru widoczne będą skany, dla których zaznaczono parametr Udostępnij dla usługi OCR. Jeżeli dla danego katalogu w Bibliotece dokumentów jest założony dla operatora zakaz na podgląd, wówczas pliki powiązane z tym katalogiem nie będą widoczne na liście.Weryfikacja wczytanych skanów
Podczas wczytywania dokumentu weryfikowane są: Dane sprzedawcy Sprawdzana jest zgodność numeru NIP nabywcy na wczytywanej fakturze z numerem NIP z aktualnej pieczątki firmy. Weryfikacja odbywa się według poniższych założeń:- Sprawdzany jest NIP z aktualnej pieczątki. Pieczątki historyczne nie są weryfikowane
- Dodając fakturę zakupu sprawdzany jest NIP nabywcy z NIP w pieczątce
- Dodając fakturę sprzedaży sprawdzany jest NIP sprzedawcy z NIP w pieczątce
- TAK – dokument zostanie dodany na listę dokumentów,
- NIE – dokument nie zostanie dodany na listę dokumentów, w podsumowaniu wyświetlony zostanie komunikat informujący, że dokument nie został dodany ze względu na niezgodność numeru NIP z numerem w pieczątce firmy.
- numer dokumentu
- numer NIP
- kwota netto
- data wystawienia
- parametr nie jest zaznaczony, wówczas w pole Kod na formularzu kontrahenta wstawiany jest numer NIP kontrahenta,
- parametr jest zaznaczony, wówczas pole Kod na formularzu kontrahenta wypełniane jest zgodnie z ustawieniami parametrów autonumeracji.
- Tak, we wszystkich firmach – zostanie ustawiona opcja Blokuj, we wszystkich bazach firmowych,
- Tak, w tej firmie – zostanie ustawiona opcja Blokuj, w firmie, do której operator jest aktualnie zalogowany,
- Nie – nie zostanie dokonana żadna zmiana w parametrach.
Usługa Comarch OCR w Rejestrze VAT
Przetwarzanie dokumentów
Comarch OCR pozwala na przetwarzanie jednocześnie wielu plików. Po kliknięciu w ikonę OCR jest możliwość wskazania dokumentów z dysku lub Obiegu Dokumentów/ BI Point. W momencie rozpoczęcia wczytywania dokumentu pojawi się komunikat informujący użytkownika, do którego rejestru zostanie zapisany dokument. Informacja pojawi się zarówno w przypadku rejestru sprzedaży jak i zakupu. Komunikat pojawia się dla każdego z Operatorów. Wybierając Tak zostanie otwarte okno z możliwością wybrania skanu dokumentu. Jeżeli natomiast Operator wybierze Zapamiętaj odpowiedź i nie pokazuj więcej a następnie Tak wówczas przy kolejnym rozpoznawaniu faktur w rejestrze VAT sprzedaży komunikat nie będzie pojawiał się dla tego Operatora. Po rozpoczęciu przetwarzania dokumentów na ekranie widoczne jest okno, które wyświetla przetwarzane dokumenty. Użytkownik widzi nazwy plików dokumentów, które są aktualnie przetwarzane i czy przetwarzanie zakończyło się poprawnie czy z błędem. Wyniki rozpoznania ikoną dyskietki można zapisać do pliku. Poprawnie przetworzony dokument zostaje zapisany w rejestrze VAT wskazanym na liście. W przypadku wersji Comarch ERP Optima wcześniejszych niż 2020.0 dokument jest zapisywany w podrejestrze ZAKUP lub SPRZEDAŻ. Od wersji 2021.1.1 Comarch ERP Optima podczas dodawania dokumentu za pomocą usługi Comarch OCR weryfikowane są daty na dokumencie. Sprawdzane jest czy data wystawienia jest z bieżącego bądź poprzedniego miesiąca czy z innych miesięcy. Jeżeli data wystawienia jest z innego miesiąca niż bieżący lub poprzedni to przed dodaniem dokumentu pojawi się komunikat ostrzegający o treści: Na dokumencie ‘numer dokumentu’ rozpoznana została data wystawienia ‘data wystawienia’. Domyślnie dokument zostanie zapisany z rozpoznaną datą. Czy chcesz zmienić datę i dodać dokument z datą bieżącą Użytkownik może zdecydować i wybrać:- Tak – dokument zostanie dodany z datą bieżącą. Oznacza to, że dla faktur zakupu zostanie ustawiona bieżąca data wpływu a dla faktur sprzedaży data wystawienia jako data bieżąca.
- Nie – dokument zostanie dodany z datą rozpoznaną.
Blokada zmiany dokumentów jeżeli zatwierdzona deklaracja VAT-7/plik JPK_V7
w Konfiguracji Programu/Użytkowe/Operatorzy. Jeżeli deklaracja VAT-7/VAT-7K/JPK_V7M/JPK_V7K jest zatwierdzona i wybrana jest opcja:- Ostrzegaj – wówczas dokument jest dodawany do rejestru z komunikatem informacyjnym w logu o treści Rozpoznano i dodano dokument ‘numer dokumentu’ z dnia ‘data wystawienia’. ‘nazwa pliku’. Deklaracja VAT-7/JPK_V7 za podany okres została zatwierdzona. Należy ponownie sporządzić deklaracje lub korektę do deklaracji.
- Blokuj – wówczas dokument nie zostanie dodany do rejestru VAT i pojawi się komunikat. Wystąpił błąd przy imporcie składnika. ‘numer dokumentu’. Dokument nie został dodany. Dotyczy deklaracji VAT-7/JPK_V7, która została już zatwierdzona. Administrator zablokował możliwość wprowadzania zmian na takich dokumentach. ‘nazwa pliku’.
- w przypadku faktur sprzedaży kody GTU, procedury i typy dokumentu umieszczone na skanie dokumentu oraz kody umieszczone na karcie kontrahenta w zakładce JPK i z przypisanej do niego kategorii
- kod TP przypisywany jest dla faktur sprzedaży, jeżeli na karcie kontrahenta zaznaczono parametr Kontrahent powiązany
- kod RO przypisywany jest dla faktur sprzedaży, jeżeli na karcie kontrahenta przypisano kategorię z zaznaczonym parametrem Również na fakturze sprzedaży zaznacza się parametr Sprzedaż detaliczna
- kod VAT_RR przypisywany jest dla faktur zakupu, jeżeli na karcie kontrahenta zaznaczono parametr Rolnik
- kod MPP przypisywany jest dla faktur sprzedaży i zakupu jeżeli na karcie kontrahenta w zakładce [JPK] została wybrana Procedura MPP
Automatyczne wczytywanie do Rejestru VAT skanów podpiętych w platformie Comarch BI Point
W Biurze Rachunkowym umożliwiliśmy tworzenie faktur zakupu i sprzedaży w rejestrze VAT na podstawie skanów dokumentów umieszczonych w Comarch BI Point przez klientów Biura Rachunkowego. Skany dokumentów umieszczone w Comarch BI Point zaczytywane są automatycznie do IBARD. Po rozwinięciu listy dostępnej obok przycisku OCR w rejestrze VAT, jeżeli użytkownik wybierze opcję Wybierz dokumenty z Obiegu Dokumentów, przy odpowiedniej konfiguracji program połączy się z IBARD, gdzie przechowywane są pliki wgrywane przez klienta Biura Rachunkowego w Comarch BI Point i pobierze je do Comarch ERP Optima. Pliki zostaną zapisane jako nowe dokumenty w Obiegu Dokumentów i udostępnione dla usługi OCR. Pojawią się od razu na liście plików z Obiegu Dokumentów, które będzie można zaznaczyć do przetworzenia przez usługę OCR. Jeżeli firma połączona jest z Comarch BI Point, ale nie jest połączona z IBARD to pojawi się stosowny komunikat. Należy wpisać login oraz hasło do IBARD. W przypadku prawidłowej autoryzacji wyświetli się lista plików z Obiegu Dokumentów, na której będą już zaimportowane pliki z Comarch BI Point klienta. Jeżeli logowanie nie powiedzie się, wówczas pliki z Comarch BI Point klienta nie zostaną pobrane do Comarch ERP Optima i wyświetli się lista plików z Obiegu Dokumentów, które do tej pory znajdowały się w programie. Po wybraniu dokumentów z listy zostaną one przetworzone przez usługę Comarch OCR i nie będą wyświetlane ponownie. Jeżeli jednak użytkownik usunie fakturę w rejestrze VAT to pojawi się ona automatycznie na liście do ponownego rozpoznania. Funkcjonalność automatycznego wczytywania dokumentów jest dedykowana dla Biur Rachunkowych. W celu poprawnej konfiguracji Comarch ERP Optima –> Comarch BI Point należy w Comarch ERP Optima w Start/Konfiguracja/Program/Biuro Rachunkowe/Parametry wskazać bazę firmową Biura Rachunkowego. Dodatkowo w bazie Biura Rachunkowego należy do listy kontrahentów dodać klienta Biura Rachunkowego. Na karcie tego kontrahenta w zakładce Księgowe w polu Firma z listy należy wskazać bazę firmową tego kontrahenta. W celu poprawnej konfiguracji Comarch BI Point -> Comarch ERP Optima należy zarejestrować konto dla Biura Rachunkowego a po zalogowaniu wybrać pakiet BI Point Manager. Po kliknięciu w poniższą zaznaczoną ikonę należy wybrać Firma i przejść do zakładki Ustawienia. Zaznaczenie parametru Aktywuj dla klientów usługę wysyłania skanów i zdjęć faktur umożliwi klientom Biura Rachunkowego zaczytywanie skanów do Comarch BI Point. Po rozwinięciu i wybraniu Pakiety należy dodać firmy , które będą mogły umieszczać skany dokumentów z rozszerzeniem pdf, jpg, tiff, jpeg, png w Comarch BI Point. Maksymalny rozmiar jednego dokumentu to 5MB. Na oknie dodawania firmy (klienta Biura Rachunkowego) należy wpisać nazwę oraz główny e-mail firmy. Adres ten należy później wpisać w Comarch ERP Optima jako Login Comarch Cloud. Do każdej dodanej firmy należy dodać użytkowników, np. pracowników klienta Biura Rachunkowego, poprzez wybór ikony a następnie wpisanie danych użytkowników/pracowników. Jeden użytkownik może mieć ten sam e-mail, który został podany jako główny dla firmy. Kolejne e-maile użytkowników muszą mieć unikalną nazwę. W momencie automatycznego tworzenia katalogu w IBARD wysyłana jest również automatycznie widomość na adres e-mail klienta Biura Rachunkowego z informacją o założeniu konta w usłudze BI Point. W celu dokończenia rejestracji klient Biura rachunkowego w otrzymanej wiadomości wybiera Potwierdź adres e-mail i zostaje przekierowany na stronę https://sso.comarch.com, gdzie zostaje poproszony o nadanie własnego hasła dostępu do Comarch BI Point. W kolejnym etapie zostaje zalogowany do Comarch BI Point. Po zalogowaniu do Comarch BI Point w celu dodania skanów/zdjęć dokumentów należy otworzyć Repozytorium w rozwijanej gałęzi wybrać Dokumenty a następnie i . Po pojawieniu się poniższego okna klient Biura Rachunkowego może przesłać skany dokumentów, które następnie mogą zostać wczytane do Comarch ERP Optima przez Biuro Rachunkowe.Usługa Comarch OCR na formularzu e-mail
Z poziomu wiadomości email możliwe jest wczytanie do Rejestru VAT dokumentu, który został dołączony do zakładki Załączniki. Wybranie tej opcji uruchomi okno, w którym należy wskazać, do którego Rejestru VAT powinien zostać wczytany dokument. Po utworzeniu zapisu w Rejestrze VAT zostanie automatycznie utworzony dokument w Obiegu dokumentów. Utworzony dokument w Obiegu dokumentów posiada powiązanie zarówno do Rejestru VAT oraz wiadomości email.Usługa Comarch OCR dla Faktur Zakupu i Przyjęć Zewnętrznych
Funkcjonalność wczytywania Faktur Zakupu za pomocą usługi Comarch OCR dostępna jest od wersji 2022.0.1 Comarch ERP Optima. Od wersji 2023.1.1 możliwe jest wczytywanie Przyjęć Zewnętrznych. ZLicencjonowanie i sugerowane ustawienia
W celu skorzystania z możliwości wczytywania skanów poprzez usługę Comarch OCR, konieczne jest posiadanie wykupionego pakietu OCR. Dodatkowo wymagany jest jeden z modułów – Faktury, Handel lub Handel Plus. Moduł Obieg Dokumentów nie jest konieczny do wczytywania Faktur Zakupu na podstawie skanów. Przed rozpoczęciem korzystania z funkcji OCR należy zweryfikować ustawienia w programie:- Blokady operatora, które nie powinny być włączone:
- Formularz pozycji cennika – Dodawanie
- Formularz danych kontrahenta – Dodawanie
- Formularz faktury zakupu – Dodawanie
- Parametry importu towarów z dokumentu PEF/ OCR – Zmiana
- Dla dokumentów walutowych – ustawienia parametrów w menu Start/Konfiguracja/ Firma/ Handel/ Parametry, sekcja Waluty zalecane jest włączenie parametrów Zezwalaj na zmianę waluty oraz VAT na fakturach w walucie lub umożliwienie operatorowi włączenia tych parametrów (brak blokady na formularzu operatora Parametry pracy modułu handlowego – firma – Zmiana).
Weryfikacja wczytywanych skanów Faktur Zakupu i Przyjęć Zewnętrznych
Po wskazaniu skanu do wczytania na listę Faktur Zakupu lub Przyjęć Zewnętrznych, wyświetlane jest okno, w którym prezentowane są informacje na temat procesu wczytywania dokumentów. Na końcu widnieje informacja o aktualności usługi OCR oraz ilości dokumentów dostępnych jeszcze w pakiecie. Podczas wczytywania dokumentu, oprócz danych wymienionych w punkcie ogólnym „Weryfikacja wczytanych skanów”, weryfikowane są: Uprawnienia operatora Jeśli operator ma założoną blokadę na dodawanie Faktur Zakupu, wówczas w podsumowaniu wyświetlony zostanie komunikat: Operator ma zakaz dodawania faktur zakupu. Dokument nie zostanie wczytany na listę. Niezgodności na dokumencie Jeśli na wczytanym dokumencie nie udało się odczytać danych kontrahenta, numeru dokumentu, danych z tabelki VAT lub jeśli suma wartości pozycji nie jest zgodna z wartością dokumentu, wówczas w podsumowaniu zostanie wyświetlony komunikat: Dodano dokument numer_dokumentu z dnia XXXX-XX-XX ale nie udało się rozpoznać wszystkich elementów. Dokument taki należy zweryfikować ze szczególną uwagą przed zatwierdzeniem. Jeśli na dokumencie nieprawidłowo zostały odczytane pozycje, np. nie wszystkie pozycje zostały poprawnie rozpoznane przez usługę OCR lub też wczytane zostały nieprawidłowe wartości, a suma wartości pozycji nie zgadza się z wartością dokumentu, wówczas wartości w tabelce VAT zostaną na nowo wyliczone zgodnie z algorytmami programu. Należy zweryfikować ceny i wartości dokumentu.Ustawienia na formularzu Faktury Zakupu i Przyjęcia Zewnętrznego
Wczytywane Faktury Zakupu i Przyjęcia Zewnętrzne zawsze zapisywane są z parametrem bufor. Wymagana jest weryfikacja przed zapisaniem dokumentu na trwałe. Przy próbie zapisu dokumentu niezweryfikowanego pojawi się komunikat: Dokument jest wprowadzony po rozpoznaniu przez OCR. Zweryfikuj dokument zanim zostanie zatwierdzony. Warto zwrócić uwagę na poniższe ustawienia: Daty na dokumencie Data wystawienia na skanie będzie datą wystawienia na formularzu dokumentu, a data sprzedaży zostanie przeniesiona do pola data zakupu. Data wpływu ustawiona zostanie zgodnie z datą wczytania dokumentu. Magazyn Na dokumencie pobierany jest magazyn domyślny z karty operatora. Jeżeli operator nie ma przypisanego magazynu domyślnego, wówczas ustawiony zostanie magazyn domyślny stanowiska (ustawiony w menu Start/Konfiguracja/ Stanowisko/ Handel/ Parametry). Natomiast jeśli nie został wskazany magazyn operatora ani stanowiska, wówczas ustawiony zostanie magazyn, który został wybrany na liście Faktur Zakupu lub Przyjęć Zewnętrznych. Jeżeli nie ma również tego magazynu, na dokumencie zostanie wskazany magazyn główny. Algorytm netto/brutto Algorytm dokumentu ustawiany jest na podstawie danych zwróconych przez usługę OCR. Na formularzu nowo tworzonego kontrahenta ustawiany jest zawsze algorytm domyślny „od netto”. Kody JPK_V7 Kody JPK_V7 nadawane są automatycznie, zgodnie z mechanizmami działającymi przy dodawaniu Faktur Zakupu. Parametr MPP W tym zakresie działają mechanizmy takie jak przy wystawianiu Faktur Zakupu. Pozycje dokumentu Przy wyszukiwaniu pozycji w pierwszej kolejności weryfikujemy, czy w bazie istnieje produkt o kodzie EAN odczytanym ze skanu. Jeżeli nie ma takiego kodu EAN w bazie, wówczas weryfikujemy po nazwie. Jeżeli w cenniku znajduje się pozycja o wskazanym kodzie EAN lub nazwie, wówczas dodajemy ją na dokument. Jeżeli w bazie nie ma pasującej pozycji, podczas wczytywania dokumentu proponujemy założenie kart towarów/usług. Pojawia się wówczas okno Wybierz parametry dodawanych towarów, na którym widoczne są wszystkie pozycje dokumentu, które nie zostały odnalezione w bazie: Przy pierwszym otwarciu okna pozycje sortowane są zgodnie z kolejnością na wczytywanym skanie. Zmiany sortowania są pamiętane przy kolejnym otwarciu okna. Niezależnie od sortowania na tym oknie, pozycje wczytywane są na formularz Faktury Zakupu zgodnie z kolejnością na wczytywanym skanie. Domyślnie proponowany jest Typ: towar prosty. Istnieje możliwość zmiany w zakresie towar/usługa prosty/złożony. W kolumnie Przypisz towar z bazy można wywołać cennik gdzie wskazujemy, który towar z bazy ma zostać przypisany do produktu nierozpoznanego przez usługę Comarch OCR lub używając ikony zielonego plusa założyć nową kartotekę towarową, która zostanie przypisana do nierozpoznanego produktu. Kartoteka towarowa w tym przypadku zostanie automatycznie uzupełniona o odczytane dane i konieczne do założenia nowej karty cennikowej tj. Kod, Nazwa, Jednostka miary oraz domyślna Stawka VAT dla sprzedaży i zakupu. Jeśli wskazana zostanie kartoteka, mapowanie to jest zapamiętywane i przy kolejnym imporcie zmapowana zostanie ta sama kartoteka, która została wskazana poprzednio. W przypadku oznaczenia kartoteki towarowej jako nieaktywnej, mapowanie zostanie usunięte. W kolumnie Przenieś na dokument możliwe jest określenie, które pozycje mają zostać przeniesione na zaimportowany dokument. Domyślnie w kolumnie dla każdej pozycji ustawiona jest wartości TAK. W sytuacji, gdy w bazie zostanie zidentyfikowany produkt zaczytany przez OCR, ale różni się jednostką miary, wówczas mapowanie w tabelce zostanie utworzone automatycznie, a jedynie należy wskazać przeliczniki dla jednostki miary, która nie jest powiązana z tym produktem. Przeliczniki można ustawić po rozwinięciu przycisku plusa przed nazwą towaru. Na liście dostępne są kolumny:- Rodzaj jednostki – w pierwszym wierszu wyświetlana jest jednostka podstawowa, natomiast w kolejnych – jednostki pomocnicze. Jeśli wskazano towar w kolumnie Przypisz towar z bazy, wówczas pojawia się dodatkowy wiersz i jako podstawowa jednostka prezentowana jest jednostka z karty towaru, a pomocnicza – z pliku.
- Nazwa j.m – nazwa jednostki z pliku lub z karty towaru.
- Licznik/ Mianownik – domyślnie ustawiana jest wartość 1 dla obydwu tych pól. Dla jednostki podstawowej pola nie podlegają edycji. Dla jednostek pomocniczych możemy określić relację do jednostki podstawowej.
- Przelicznik – pole puste dla jednostki podstawowej, natomiast dla jednostek pomocniczych prezentowany jest wynik na podstawie danych wprowadzonych w polach licznik/ mianownik.
- Przypisz j.m. z bazy – dla jednostki z pliku lub jednostki pomocniczej możemy wskazać, do której jednostki z bazy ma być mapowanie. Wybór możliwy jest tylko jeśli jednostki o takiej nazwie nie rozpoznano w bazie. Wybór jest niedostępny dla jednostki podstawowej towaru wskazanego w kolumnie Przypisz towar z bazy.
- jeżeli parametr jest zaznaczony, wówczas pole Kod na formularzu towaru uzupełniane jest zgodnie ze schematem autonumeracji.
- jeżeli parametr jest nie zaznaczony, a w pliku znajduje się informacja o kodzie EAN, wówczas pole Kod uzupełniane jest kodem EAN
- jeżeli parametr nie jest zaznaczony i w pliku nie znajduje się informacja o kodzie EAN, wówczas pole Kod uzupełniane jest fragmentem nazwy produktu (maksymalnie 50 znaków).
Dokumenty walutowe
Poprzez usługę Comarch OCR możliwe jest wczytanie dokumentów w walutach EUR, GBP, USD. Przed wczytaniem Faktury Zakupu na listę, weryfikowane jest ustawienie parametru: Zezwalaj na zmianę waluty, znajdującego się w Konfiguracja/ Firma/ Handel/ Parametry, w sekcji Waluty. Faktura Zakupu może zostać wczytana na listę tylko w przypadku, gdy ten parametr jest zaznaczony. Jeżeli parametr: Zezwalaj na zmianę waluty nie jest zaznaczony, wówczas pojawi się komunikat: Dokument jest wystawiony w walucie. Aby wczytać dokument należy w Konfiguracji/ Firma/ Handel/ Parametry zaznaczyć parametr: Zezwalaj na zmianę waluty dokumentu. Czy chcesz zmienić ustawienia tego parametru? Wybór opcji Tak spowoduje zaznaczenie parametru w Konfiguracji. Jeśli wybierzemy Nie, wówczas dokument nie zostanie wczytany na listę, a w podsumowaniu pojawi się informacja Nie dodano dokumentu numer_dokumentu z dnia XXXX-XX-XX. Nie ustawiono parametru w konfiguracji: Zezwalaj na zmianę waluty dokumentu. Jeśli zaznaczono parametr Zezwalaj na zmianę waluty, a na dokumencie walutowym naliczony jest podatek VAT, wówczas weryfikowane jest ustawienie parametru: VAT na fakturach w walucie. Jeżeli parametr nie jest zaznaczony, wówczas pojawi się komunikat: Dokument jest wystawiony w walucie z naliczonym podatkiem VAT. Aby wczytać dokument należy w Konfiguracji/ Firma/ Handel/ Parametry zaznaczyć parametr: VAT na fakturach w walucie. Czy chcesz zmienić ustawienia tego parametru? Wybór opcji Tak spowoduje zaznaczenie parametru w Konfiguracji. Jeśli wybierzemy Nie, wówczas dokument nie zostanie wczytany na listę, a w podsumowaniu pojawi się informacja Nie dodano dokumentu numer_dokumentu z dnia XXXX-XX-XX. Nie ustawiono parametru w konfiguracji: VAT na fakturach w walucie. Jeśli w menu w Konfiguracja/ Firma/ Handel/ Parametry, w sekcji Waluty zaznaczony jest parametr Płatność VAT w PLN na fakturach krajowych w walucie, wówczas dla dokumentów z naliczonym VATem, płatność rozbijana jest na kwotę netto w walucie oraz wartość VAT w PLN. Jeśli operator ma założoną blokadę Parametry pracy modułu handlowego – firma – Zmiana, wówczas nie pojawią się komunikaty z poziomu, których można zmienić ustawienia parametrów w konfiguracji. Kurs waluty przenoszony jest na dokument Faktury Zakupu z danych dostarczanych przez usługę OCR. Typ kursu waluty ustawiamy jako Kurs średni NBP. Wartości walutowe na dokumencie przeliczane są na PLN po kursie wskazanym na dokumencie. Na podstawie tych wyliczeń uzupełniana jest tabelka VAT na zakładce [Płatności].Okno podglądu wczytanego dokumentu
Na podglądzie formularza Faktury Zakupu lub Przyjęcia Zewnętrznego wczytanego ze skanu poprzez usługę OCR, z lewej strony wyświetlany jest podgląd skanu. Okno można zamknąć, natomiast przy ponownym podniesieniu formularza, będzie ono ponownie widoczne. Zapamiętywane jest ustawienie wielkości okna, natomiast nie ma możliwości jego zamknięcia na stałe. Okno można zamknąć, natomiast ponowne jego otwarcie możliwe jest po naciśnięciu przycisku Podgląd dokumentu z biblioteki , dostępnego na wszystkich zakładkach dokumentu. Jego kliknięcie umożliwia wyświetlenie załącznika w oknie podglądu widocznym z lewej strony formularza dokumentu. Jeśli powiązanych jest kilka dokumentów OBD z kilkoma załącznikami, wówczas po kliknięciu przycisku pojawi się menu z listą dostępnych do wyświetlenia załączników: Wyświetlane mogą być załączniki w formacie PDF, TIFF oraz pliki graficzne (PNG, JPG, BMP). Załączniki w innych formatach, jak np. XLSX, DOCX nie będą dostępne do wyboru. Domyślnie w oknie podglądu wyświetlany jest pierwszy plik z listy. W przypadku kiedy dane nie zostały rozpoznane bądź zostały rozpoznane niepoprawnie prosimy wysyłać zgłoszenie poprzez System Obsługi zgłoszeń wraz z przesłaniem skanu faktury i opisem problemu. W sposób cykliczny i automatyczny udostępniane są rozszerzenia aplikacji Comarch OCR bez konieczności zamykania i ponownego otwierania Comarch ERP Optima.API do usługi Comarch OCR
Usługa | Adres |
---|---|
Comarch OCR – panel do zarządzania | https://www.erp.comarch.pl/OCR/ |
Comarch OCR - API | https://cr.erp.comarch.pl/api/v1/ |
Metody
Tworzenie sesji użytkownika "session" (POST)
Adres: https://cr.erp.comarch.pl/api/v1/session W nagłówku zapytania należy dołączyć następujące dane uwierzytelniające:Klucz | Wartość |
---|---|
authKey | Klucz wygenerowany w panelu do zarządzania Comarch OCR |
authSecret | Sekret wygenerowany w panelu do zarządzania Comarch OCR |
Property | Opis |
---|---|
sessionToken | Token sesji |
{
"sessionToken": "00000000-0000-0000-0000-000000000000""
}
Możliwe kody odpowiedzi HTTP:
Kod | Znaczenie |
---|---|
200 | Poprawnie wygenerowano token sesji. |
400 | Brak wymaganych parametrów w nagłówku żądania lub błędne dane. |
403 | Wymagane jest użycie SSL |
Usuwanie sesji użytkownika "session" (DELETE)
Adres: https://cr.erp.comarch.pl/api/v1/sessionW nagłówku zapytania należy dołączyć następujące wartości:
Klucz | Wartość |
---|---|
authToken | Token sesji |
Kod | Znaczenie |
---|---|
204 | Sesja poprawnie zakończona |
400 | Brak tokenu sesji w nagłówku żądania. |
403 | Wymagane jest użycie SSL |
Property | Opis |
---|---|
File | Plik o rozszerzeniu *.jpg, *.png, *bmp lub *.pdf w postaci binarnej |
Guid | Opcjonalne - GUID |
RecognizeConfiguration.RecognitionLanguage | Opcjonalny - język rozpoznawania dokumentu, 0 - j. polski (jeśli na fakturze zostanie rozpoznany język angielski, rozpoznanie nastąpi jak dla faktur angielskich), 1 - j. niemiecki, 2 - j. francuski, 3 - j. angielski -1 – rozpoznanie na podstawie języka wykrytego na dokumencie (domyślnie - j. polski) |
RecognizeConfiguration.ReturnData | Opcjonalny - informacja czy usługa ma w odpowiedzi odesłać pliki dla przetworzonych dokumentów 0 – bez plików 1 – z plikami (domyślnie – opcja 0) |
RecognizeConfiguration.BarCodeRecognition | Opcjonalny - informacja czy należy rozpoznawać kody kreskowe da dokumentach, 0 - nie rozpoznaje kodów 1 - rozpoznaje kody 2 - łączy strony na podstawie rozpoznanych kodów (domyślnie – opcja 0) |
RecognizeConfiguration.MergingPagesOption | Opcjonalny - informacja czy należy rozpoznawać kody kreskowe da dokumentach, 0 - nie rozpoznaje kodów 1 - rozpoznaje kody 2 - łączy strony na podstawie rozpoznanych kodów (domyślnie – opcja 0) |
RecognizeConfiguration.ReturnDocumentPositions | Opcjonalny – czy na rozpoznanych dokumentach mają być zwrócone poszczególne pozycje z tabeli produktów 0 – bez pozycji 1 – z pozycjami (domyślnie – opcja 0) |
RecognizeConfiguration.PaymentMethodMapping | Opcjonalny – czy na rozpoznanych dokumentach metoda płatności ma być mapowana do standardowych form płatności czy odczytana zgodnie z treścią na dokumencie 0 – bez mapowania 1 – z mapowaniem (domyślnie – opcja 0) |
RecognizeConfiguration.RawRecognitionText | Opcjonalny – informacja czy ma zostać zwrócona oryginalna, niezmieniona treść wykryta na stronie 0 - brak oryginalnej treści 1 - oryginalna treść zostanie zwrócona (domyślnie – opcja 0) |
RecognizeConfiguration.DefaultPaymentForm | Opcjonalny – domyślna forma płatności jaka ma zostać zwrócona w przypadku nie wykrycia formy płatności na dokumencie (np. „gotówka”) (domyślnie – brak) |
RecognizeConfiguration.PagesToRecognize | Opcjonalny – informacja o numerze NIP kontrahenta który wysyła dokument (np. "1234567890") (domyślnie – brak) |
RecognizeConfiguration.DateRange | Opcjonalny – informacja jakie daty na dokumencie mają zostać uwzględnione w rozpoznaniu (np. "1.01.2023-31.12.2023") (domyślnie – brak) |
RecognizeConfiguration.RegisterType | Opcjonalny – typ rejestru, który ma być uwzględniony przy rozpoznaniu 0 – rejestr zakupu 1 – rejestr sprzedaży (domyślnie – rejestr zakupu) |
Klucz | Wartość |
---|---|
authToken | Token sesji |
Parametr | File to recognize |
---|---|
File string($binary) | |
Guid string | |
ErpModule string | |
RecognizeConfiguration.RegisterType integer($int32) | 1 = Purchase 2 = Sale |
RecognizeConfiguration.RecognitionLanguage integer($int32) | 0 = PL 1 = DE 2 = FR 3 = EN -1 = UNSET |
RecognizeConfiguration.ReturnData integer($int32) | 0 = WithoutData 1 = WithData |
RecognizeConfiguration.BarCodeRecognition integer($int32) | 0 = NoRecognition 1 = CodeRecognition 2 = DocumentBundleRecognition |
RecognizeConfiguration.MergingPagesOption integer($int32) | 0 = MergingAlgorithm 1 = FileIsOneDocument |
RecognizeConfiguration.ReturnDocumentPositions integer($int32) | 0 = WithPositions 1 = WithoutPositions |
RecognizeConfiguration.PaymentMethodMapping integer($int32) | 0 = WithoutMapping 1 = WithMapping |
RecognizeConfiguration.RawRecognitionText integer($int32) | 0 = WithoutRawRecognitionText 1 = WithRawRecognitionText |
RecognizeConfiguration.DefaultPaymentForm string | |
RecognizeConfiguration.PagesToRecognize string | |
RecognizeConfiguration.ConfigurationNipNumber string | |
RecognizeConfiguration.DateRange string |
Property | Opis |
---|---|
ExportString | Odpowiedź w formacie JSON |
Message | Komunikat o wyniku przetwarzania dokumentu przez usługę |
Code | Kod odpowiedzi |
Status | Status odpowiedzi |
AdditionalMessage | Dodatkowa informacja o pozostałych dokumentach, gdy w pakiecie pozostało 10 lub mniej dokumentów |
UriToDownload | Adres URL do strony spójnej z kodem odpowiedzi |
{ "invoices": [ { "recognizedElements": { "documentNumber": "string", "kSeFNumber": "string", "dateOfIssue": "string", "dateOfSale": "string", "dueDate": "string", "paymentForm": "string", "bankAccountNumber": "string", "orderNumber": "string", "isCorrection": true, "correctedDocumentNumber": "string", "currency": "string", "currencyExchange": { "rate": 0, "multiplier": 0, "date": "string" }, "language": "string", "carBodyNumber": "string", "isDateInRange": true }, "sellerContractor": { "tin": "string", "companyName": "string", "street": "string", "streetNumber": "string", "apartmentsNumber": "string", "postCode": "string", "postOffice": "string", "city": "string", "voivodeship": "string", "activeVATTaxpayer": true }, "buyerContractor": { "tin": "string", "companyName": "string", "street": "string", "streetNumber": "string", "apartmentsNumber": "string", "postCode": "string", "postOffice": "string", "city": "string", "voivodeship": "string", "activeVATTaxpayer": true }, "vatPositions": [ { "vatRate": 0, "vatRateDecimal": 0, "vatStatus": 0, "subtotal": 0, "vat": 0, "total": 0 } ], "pageProperties": { "firstPageNumber": 0, "documentLength": 0, "pageRotation": 0 }, "pages": [ { "pageNumber": 0, "image": "string", "rawText": "string" } ], "productItems": [ { "name": "string", "unit": "string", "productCode": "string", "ean": "string", "contractNumber": "string", "count": { "value": 0, "status": 0 }, "nettoUnitPrice": { "value": 0, "status": 0 }, "bruttoUnitPrice": { "value": 0, "status": 0 }, "netto": { "value": 0, "status": 0 }, "brutto": { "value": 0, "status": 0 }, "vatRate": { "value": 0, "status": 0 }, "vatAmount": { "value": 0, "status": 0 }, "vatStatus": { "value": 0, "status": 0 }, "discount": { "value": 0, "status": 0 } } ], "attachment": { "canRead": true, "canWrite": true, "canSeek": true, "canTimeout": true, "length": 0, "position": 0, "readTimeout": 0, "writeTimeout": 0 }, "fileUrl": "string", "barcode": { "text": "string", "type": "string" }, "barcodes": [ { "text": "string", "type": "string" } ], "guid": "string" } ], "message": "string", "url": "string", "numberOfPagesLeft": 0, "guid": "string" }Kod 400
{ "httpCode": 0, "internalErrorCode": 0, "message": "string", "url": "string" }Kod 403
{ "httpCode": 0, "internalErrorCode": 0, "message": "string", "url": "string" }Kod 415
{ "httpCode": 0, "internalErrorCode": 0, "message": "string", "url": "string" }Tabela błędów metody "invoice/recognize" w przypadku kodu błędu >= 400
HttpCode | InternalErrorCode | Opis | Dodatkowe informacje |
---|---|---|---|
401 | 101 | Błąd podczas autentykacji użytkownika | |
401 | 102 | Niepoprawny numer klucza | |
503 | 104 | Przerwa techniczna | |
401 | 105 | Token sesji wygasł lub jest niepoprawny | |
401 | 106 | Brak podpisanej klauzuli RODO | Link do formularza z umową w 'Url' |
402 | 107 | Brak wykupionego pakietu przez klienta | |
401 | 108 | Klient został zablokowany ze względu na brak opłaconego pakietu | |
401 | 109 | Brak dostępu do API OCR (autentykacja przez token) | |
401 | 110 | Wykorzystany pakiet dokumentów | Link do sklepu w 'Url' |
401 | 111 | Brak wystarczającej liczby dokumentów w pakiecie | Link do sklepu w 'Url' |
500 | 112-116,199 | Błędy po stronie serwera | |
401 | 117 | Błąd podczas autentykacji użytkownika z wykorzystaniem NIPu | |
503 | 118 | Przerwa serwisowa | |
400 | 119 | Niepoprawny parametr | Nazwa parametru w 'Message' |
401 | 101 | Błąd podczas autentykacji użytkownika | |
401 | 102 | Niepoprawny numer klucza | |
503 | 104 | Przerwa techniczna | |
401 | 105 | Token sesji wygasł lub jest niepoprawny |