# 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.:

- dane kontrahenta,
- numer dokumentu,
- datę wystawienia,
- pozycje towarowe lub usługowe,
- ceny netto/brutto,
- stawki VAT.

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ć:

- niepoprawna struktura pliku XML,
- brak wymaganych danych,
- niezgodny format dokumentu.

---

## Dokument nie pojawia się w systemie

Należy sprawdzić:

- czy plik XML znajduje się w poprawnym katalogu,
- czy wykonano import w module **Praca rozproszona**,
- czy użytkownik pracuje na właściwej bazie danych.

---

# 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](https://pomoc.thtg.io/attachments/37)