Integracje

Comarch Optima

Integracja THTG Integrator z Comarch Optima

Słownik

Wstęp

Integrator posiada aplikację integracyjną o nazwie ThtgEsb, która umożliwia komunikację z systemem Comarch ERP Optima.

Do wymiany danych wykorzystywana jest szyna danych, dzięki czemu serwer z Optimą nie musi być dostępny z zewnątrz.
Aplikacja ThtgEsb musi jednak posiadać dostęp do internetu, aby komunikować się z szyną danych.

ThtgEsb loguje się do Optimy wykorzystując dostępną licencję użytkownika.

Jeżeli liczba dostępnych licencji jest niewystarczająca:

⚠️ Uwaga

Optima nie zwalnia automatycznie licencji przy bezczynności użytkownika.
Licencja zostanie zwolniona dopiero po:

Jeżeli zależy nam na wysokiej niezawodności komunikacji, zaleca się wykupienie osobnej licencji dla ThtgEsb.

Wymagania

Do uruchomienia integracji wymagane są:

⚠️ Uwaga
Integracja nie współpracuje z wersją chmurową Comarch ERP Optima.

Możliwości integracji

Aplikacja ThtgEsb pozwala na integrację w następujących obszarach.

Tworzenie kontrahentów (Integrator → Optima)

Po utworzeniu kontrahenta w Integratorze zostaje on automatycznie wysłany do Optimy.

Kontrahenci są wysyłani:

Jeżeli umowa zawierana jest dla kilku klientów, w Optimie tworzony jest jeden kontrahent zawierający dane wszystkich klientów.

Przed wysłaniem kontrahenta Integrator sprawdza, czy istnieje on już w Optimie.

Weryfikacja odbywa się na podstawie:

Jeżeli kontrahent nie zostanie odnaleziony, Integrator utworzy go automatycznie.

Zasada tworzenia kodów kontrahentów

Przykłady:

⚠️ Uwaga

Kontrahenci muszą posiadać uzupełniony NIP lub PESEL, aby uniknąć tworzenia duplikatów.

Import kontrahentów (Optima → Integrator)

Funkcjonalność umożliwia import kontrahentów z Optimy do Integratora.

(sekcja w trakcie zmian)

Tworzenie faktur kosztowych i sprzedażowych (Integrator → Optima)

Po utworzeniu faktury w Integratorze (w module EOD lub Faktury) może ona zostać automatycznie wysłana do Optimy.

Faktury są przesyłane do rejestru VAT.

Aby integracja działała poprawnie, należy skonfigurować:

Przesyłanie informacji o dekretacji faktur kosztowych

ThtgEsb może działać w dwóch trybach.

Tryb 1

Elementy dekretacji z EOD są traktowane jako osobne pozycje faktury.
Dokument zawiera informacje o kwocie netto i brutto, bez kategorii.

Tryb 2

Elementy dekretacji są przesyłane jako osobne pozycje faktury z przypisanymi kategoriami kosztów.

System próbuje rozdzielić numery kont, np.: 501-432

zostaje rozdzielone na:

⚠️ Uwaga

Plan kont w Optimie i Integratorze musi być identyczny.
Jeżeli konto nie będzie zgodne, element faktury zostanie wysłany bez przypisanych kategorii.

Tworzenie zapisów kasowych i bankowych

Integracja działa w dwóch kierunkach:

ThtgEsb posiada integrację z aplikacjami bankowymi:

Dzięki temu dane mogą być wysyłane bezpośrednio do:

Aplikacje bankowe instalowane są na serwerze klienta.

Integrator umożliwia również import wyciągów bankowych z wielu banków.
Po imporcie w Integratorze mogą one zostać automatycznie przesłane do Optimy.

Procedura integracji

Proces integracji przebiega w następujących etapach:

  1. THTG ustala z klientem zakres integracji.
  2. Klient przekazuje dane dostępowe do serwera oraz VPN (jeżeli jest używany).
  3. Klient tworzy testową bazę danych na podstawie istniejącej spółki w Optimie.
  4. Klient tworzy użytkownika w Optimie dla THTG z dostępem do:
    • bazy testowej
    • baz produkcyjnych
  5. THTG instaluje aplikację i testuje integrację na bazie testowej.
  6. THTG przeprowadza testy integracji z klientem.
  7. Po zakończeniu testów uruchamiana jest integracja dla baz produkcyjnych.

Instalacja aplikacji

  1. Rozpakuj dostarczone archiwum na serwerze z dostępem do Optimy.
  2. Edytuj plik config.json.
  3. Wprowadź dane użytkownika oraz konfigurację spółek.

Parametry konfiguracji

Dla każdej spółki podajemy:

Przykładowa konfiguracja

{
  "optimaUser": "Adam",
  "optimaPassword": "pwd",
  "companies": [
    {
      "name": "Zielona Sp. z o.o.",
      "taxId": "1234567890",
      "accounts": []
    },
    {
      "name": "Czerwona",
      "taxId": "2345678901",
      "accounts": []
    }
  ]
}

Konfiguracja licencji

Domyślnie aplikacja wykorzystuje licencję:

Moduł dostępowy (Kasa/Bank)

Jeżeli używany jest moduł:

Moduł dostępowy (Kasa/Bank Plus)

należy zmienić wartość parametru applicationMode z:

na

Testowanie konfiguracji

W celu weryfikacji poprawności konfiguracji, należy uruchomić aplikację ThtgEsbService.exe z argumentem test, np. .\ThtgEsbService.exe test. W przypadku błędu, aplikacja wyświetli komunikat w konsoli.

Jeżeli konfiguracja zawiera błędy, aplikacja wyświetli odpowiedni komunikat w konsoli.

Włączenie automatycznej synchronizacji danych

W celu uruchomienia automatycznej synchronizacji, należy dodać uruchamianie aplikacji z argumentem invoices do harmonogramu zadań systemu. Zalecana częstotliwość uruchamiania to 5 minut. Poniżej przykład konfiguracji

Formularze kontaktowe

Integracja formularzy WWW z THTG Integrator

THTG Integrator udostępnia API, dzięki któremu zgłoszenia wysyłane przez klientów na stronie internetowej mogą być automatycznie przekazywane do rejestru kontaktów w THTG Integrator.

Dokumentacja API jest przekazywana na etapie wdrożenia systemu przez opiekuna wdrożenia.

Przekazywanie źródeł dotarcia klienta do THTG Integrator

API udostępnia pola umożliwiające przekazanie informacji o źródle dotarcia klienta.

Aby dane te były dostępne, konieczna jest odpowiednia obsługa zbierania informacji o źródle ruchu po stronie strony internetowej (WWW).

Zbieranie źródeł dotarcia klienta w WordPress

Do zbierania informacji o źródle dotarcia klienta można wykorzystać wtyczkę:

HandL UTM Grabber / Tracker

W wersji darmowej plugin umożliwia:

Rejestrowanie źródeł z:

wymaga wersji płatnej wtyczki.

Po zainstalowaniu i skonfigurowaniu pluginu informacje o źródle klienta są dostępne:

Dane te można następnie przekazać do API THTG Integrator razem z formularzem kontaktowym.

Integracja kalendarza z programem Outlook

Dzięki tej funkcjonalności możesz wyświetlać w kalendarzu Outlook wszystkie powiadomienia, które znajdują się w kalendarzu THTG Integrator.

⚠️ Uwaga
Integracja działa jednokierunkowo – wydarzenia są przekazywane z THTG do programu pocztowego, a zmiany w Outlooku nie są synchronizowane z THTG.

Integracja kalendarza z programem Outlook

1. Eksport kalendarza z THTG

  1. Wejdź w Menu boczne → Kalendarz.
  2. Kliknij Eksportuj.

2. Skopiowanie linku kalendarza

Po pojawieniu się okna Eksport kalendarza:

  1. Skopiuj wygenerowany link do kalendarza.

3. Dodanie kalendarza w Outlook

  1. Otwórz Outlook w przeglądarce.
  2. Przejdź do Kalendarza (ikona kalendarza po lewej stronie).
  3. W lewym panelu kliknij Dodaj kalendarz.
  4. W oknie, które się pojawi, wybierz Subskrybuj z sieci Web / Subscribe from web.
  5. Wklej link skopiowany z platformy THTG do kalendarza (np. kończący się na .ics).
  6. Nadaj nazwę kalendarzowi.
  7. Kliknij Importuj. Kalendarz pojawi się w sekcji Inne kalendarze. 📅

Po wykonaniu tych kroków kalendarz THTG zostanie połączony z kalendarzem Outlook, a wszystkie powiadomienia z systemu będą widoczne w Outlooku.

zakladka kalendarz w outlook.jpg

dodawanie kalendarza.jpg

dodawanie kalendarzu z internetu.jpg

6.Jak usunąć ten kalendarz

  1. Wejdź ponownie do Kalendarza.
  2. W lewym panelu znajdź sekcję Inne kalendarze.
  3. Najedź myszką na nazwę dodanego kalendarza.
  4. Kliknij trzy kropki (…) obok nazwy.
  5. Wybierz Usuń.

Po usunięciu kalendarz zniknie i przestanie się aktualizować.

Integracja z MBank - Konta powiernicze

Za pomocą tej funkcjonalności możesz zintegrować swoje konto bankowe z systemem THTG.

Integracja z MBank – Konta powiernicze

Integracja bezpośrednia

Po podpisaniu umowy z MBank na aplikację łączącą zainstaluj aplikację na swoim komputerze. Następnie przekaż do THTG klucz pozwalający na integrację systemu THTG z aplikacją łączącą.
Pracownik THTG wykona dalsze kroki w celu integracji.

Integracja pośrednia

Proszę przesłać do THTG plik MT940. Następnie pracownik THTG wykona dalsze kroki w celu integracji.
Plik powinien zawierać szczegółową informację o kwocie zwolnienia dla każdego konta powierniczego klienta (umowy).

Integracja z Ministerstwem Cyfryzacji - ustawa o jawności cen

Podstawa prawna

Z dniem 11 lipca 2025 r. wchodzi w życie obowiązek publikowania cen mieszkań przez deweloperów na ich stronach internetowych oraz przekazywania tych danych do Ministerstwa Cyfryzacji.
Obowiązek ten wynika z nowelizacji ustawy z dnia 21 maja 2025 r. o jawności cen w sektorze mieszkaniowym (Dz. U. z 2025 r. poz. 758)

Krok 1 – Założenie konta dostawcy danych

Pierwszym etapem jest rejestracja konta dostawcy danych na portalu: dane.gov.pl

Instrukcja procesu dostępna pod adresem: Instrukcja zakładania profilu dostawcy danych

Po rejestracji należy wysłać wiadomość e-mail w celu nadania uprawnień edytora.

Wzór wiadomości

Do: kontakt@dane.gov.pl
Tytuł: Założenie profilu dla dewelopera THTG-BUD Sp. z o. o.

Treść:

Krok 2 – Konfiguracja integracji po stronie THTG Integrator

W trakcie oczekiwania na nadanie uprawnień należy w THTG Integrator:

Ustawienie daty rozpoczęcia publikacji cen dla inwestycji

W każdej inwestycji należy przejść do sekcji:

Daty w inwestycji → uzupełnić pole Rozpoczęcie udostępniania historii

Data ta musi odpowiadać rzeczywistej dacie rozpoczęcia sprzedaży.
Zmiany cen dokonane przed tą datą nie będą publikowane.

Przypomnienie:

Krok 3 – Udostępnienie danych

Poniższy krok wykonaj dla każdej spółki prowadzącej sprzedaż.
Jeżeli jedna osoba jest zgłoszonym edytorem w wielu spółkach, może wysłać wiadomość zbiorczą.

Generowanie linków

W panelu THTG Integrator:

  1. Przejdź do Ustawienia → Organizacja → Spółki.
  2. Dla każdej spółki, w której prowadzona jest sprzedaż, wygeneruj link do udostępniania historii cen:
    • kliknij „3 kropki” → Udostępnij historię cen inwestycji
  3. Skopiuj wygenerowany link.

Zgłoszenie linków do portalu dane.gov.pl

Wygenerowane linki należy zgłosić do Ministerstwa Cyfryzacji, wysyłając e-mail na adres:

kontakt@dane.gov.pl

Wzór wiadomości

Do: kontakt@dane.gov.pl
Tytuł: Wniosek o uruchomienie automatycznego zasilania danych historii cen mieszkań

Treść:

Najczęściej zadawane pytania

Jakie dane są wysyłane?

Udostępniane są pliki z historią cen na dany dzień.

W plikach znajdują się dane o wszystkich typach systemowych z wyjątkiem:

Dane są przekazywane dla produktów w statusach:

Jeżeli produkt znajduje się w innym statusie:

System może nie wysyłać produktów posiadających podpisaną umowę sprzedaży.
W tym celu należy zaznaczyć opcję:

„Nie wysyłaj produktów z podpisaną umową sprzedaży do Ministerstwa Cyfryzacji”.

Zakres udostępnianych danych

Jeżeli cena w danym dniu zmieni się kilkukrotnie, w pliku pojawi się kilka rekordów dla danego produktu.

Z jakiego dnia dane są wysyłane?

Dane generowane są codziennie i pokazują stan na dzień poprzedni.

Przykład:

Czy po uruchomieniu nowej inwestycji muszę ponownie wysyłać link do portalu dane.gov.pl?

Nie.

Kalendarz Google - integracja

Integracja kalendarza Google

Aby dodać kalendarz THTG do swojego kalendarza Google, wykonaj poniższe kroki:

  1. Wejdź w zakładkę Kalendarz w systemie THTG.

  1. Wyeksportuj kalendarz przyciskiem „Eksportuj”.

  1. Wejdź do Kalendarza Google i znajdź opcję dodania nowego kalendarza.

  1. Wybierz pozycję „Dodaj z adresu URL”.

Symfonia THTG API

Instalacja na IIS

Wymagania

Instalacja aplikacji

  1. Wypakuj odpowiednią wersję aplikacji.

  2. Utwórz plik appsettings.local.json na podstawie appsettings.json.

  3. Uzupełnij plik danymi, np.:

{
  "Databases": [
    {
      "Name": "demo",
      "Server": "SERVERSQL",
      "Database": "BAZA_THTG",
      "User": "THTG",
      "Password": "THTG2"
    }
  ],
  "ApiKey": "2Tr5RsPkTGKAxC"
}

Opis pól

  1. Przejdź do Menedżera IIS.

  2. Dodaj nową witrynę, przechodząc do:

  3. Uzupełnij dane witryny

  4. Wejdż w pulę aplikacji, zaznacz aplikację i wybierz Ustawienia zaawansowane

  5. W sekcji Ogólne zmień Włącz aplikacje 32-bitowe z False na True

  6. Zrestartuj pulę i aplikację

Po uruchomieniu należy przekazać THTG następujące informacje:

Pliki do pobrania

Symfonia WebAPI

Słownik

Wstęp

WebAPI jest modułem dodatkowo płatnym.

W przypadku posiadania wielu spółek wymagane jest uruchomienie wielu instancji WebAPI.

Instrukcja instalacji usługi:
https://pomoc.symfonia.pl/Help/api/webapi/2022/123205

Przykład konfiguracji

Wymagania

Możliwości integracji

Integrator posiada następujące możliwości integracji z systemem Symfonia.

Tworzenie kontrahentów [Integrator → Symfonia]

Po utworzeniu kontrahenta w Integratorze jest on automatycznie wysyłany do Symfonii.

Kontrahenci wysyłani są:

W przypadku umowy dla wielu klientów tworzony jest jeden kontrahent w Symfonii, który zawiera dane wszystkich klientów.

Tworzenie faktur kosztowych i sprzedażowych [Integrator → Symfonia]

Po utworzeniu faktury w Integratorze w module EOD lub w module Faktur, może ona zostać automatycznie wysłana do Symfonii do odpowiedniej sekcji systemu.

Faktury są zadekretowane zgodnie z konfiguracją w Integratorze.

Do Symfonii nie są wysyłane pliki PDF faktur.

Procedura integracji

  1. THTG ustala z klientem zakres integracji.
  2. Klient instaluje WebAPI i przekazuje THTG dane do bazy testowej utworzonej na podstawie bazy istniejącej.
  3. THTG wewnętrznie testuje integrację.
  4. THTG testuje integrację wspólnie z klientem.
  5. Klient konfiguruje WebAPI dla pozostałych baz i przekazuje dane do THTG.
  6. THTG uzupełnia konfigurację w Integratorze i uruchamia integrację.

Instrukcja konfiguracji importu faktur XML z programu THTG do Comarch ERP Optima (w Chmurze)

1. Cel konfiguracji

Celem konfiguracji jest umożliwienie przesyłania faktur z programu THTG do Comarch ERP Optima przy pomocy plików XML z wykorzystaniem mechanizmu Pracy Rozproszonej.

Schemat działania integracji:

  1. Program THTG generuje plik XML z fakturą.
  2. Plik zapisywany jest w ustalonym katalogu wymiany.
  3. Comarch ERP Optima importuje plik XML.
  4. W systemie tworzony jest dokument handlowy (np. faktura sprzedaży).

2. Włączenie pracy rozproszonej w Optimie

  1. Uruchomić Comarch ERP Optima.
  2. Przejść do menu: System → Konfiguracja → Firma → Ogólne → Praca rozproszona
  3. Włączyć obsługę pracy rozproszonej oraz ustawić tryb wymiany danych XML.
  4. Zapisać zmiany.

3. Ustawienie katalogu wymiany plików XML

Aby Optima mogła odczytać dokumenty przesyłane z THTG, należy wskazać katalog, w którym będą zapisywane pliki XML.

  1. Przejść do: System → Konfiguracja → Stanowisko → Handel → Parametry

  2. W polu Katalog importu dokumentów XML wskazać folder, np.: C:\Optima_XML\

  3. Zatwierdzić ustawienia.

Od tego momentu pliki XML zapisane w tym katalogu mogą być importowane do systemu.

4. Generowanie pliku XML w programie THTG

Program THTG powinien generować pliki XML zgodne z formatem obsługiwanym przez Comarch ERP Optima.

Każda wystawiona faktura powinna zostać zapisana jako plik XML, np.: faktura_123.xml

Plik powinien zostać zapisany w katalogu wskazanym w konfiguracji Optimy, np.: C:\Optima_XML\

5. Import faktur XML w Comarch ERP Optima

Po zapisaniu pliku XML w katalogu wymiany należy wykonać import dokumentów.

  1. Uruchomić Comarch ERP Optima.
  2. Przejść do: Narzędzia → Praca rozproszona
  3. Wybrać opcję Import.
  4. Wskazać plik XML z katalogu wymiany.
  5. Zatwierdzić import.

Po poprawnym imporcie dokument zostanie dodany do systemu.

6. Weryfikacja poprawności importu

Po zakończeniu importu należy sprawdzić, czy dokument został poprawnie utworzony.

Dokument można znaleźć w: Handel → Faktury sprzedaży lub Rejestry VAT → Rejestr sprzedaży

7. Wymagania dotyczące danych w pliku XML

Aby import przebiegł poprawnie, plik XML musi zawierać m.in.:

Jeżeli w bazie danych nie istnieje wskazany kontrahent lub towar, Optima może utworzyć je automatycznie (jeśli konfiguracja na to pozwala).

8. Najczęstsze problemy

Brak możliwości importu pliku XML

Przyczyną może być:

Dokument nie pojawia się w systemie

Należy sprawdzić:

9. Podsumowanie

Integracja programu THTG z Comarch ERP Optima polega na wymianie danych poprzez pliki XML w mechanizmie Pracy Rozproszonej.

Proces obejmuje:

  1. konfigurację pracy rozproszonej w Optimie,
  2. wskazanie katalogu wymiany plików XML,
  3. generowanie plików XML w programie THTG,
  4. import dokumentów XML do systemu Optima.

Po poprawnej konfiguracji możliwe jest regularne przenoszenie faktur z programu THTG do systemu księgowego.

Instrukcja Video