Krótka odpowiedź
Z naszych wdrożeń wynika, że Comarch ERP Optima nie ma natywnego API do integracji z innymi programami. Publicznej dokumentacji ani ceny API Optimy w materiałach Comarch nie znaleźliśmy, a nawet opis struktury plików XML do importu i eksportu dokumentów udostępnia wyłącznie Autoryzowanym Partnerom Comarch. W naszych wdrożeniach integracje z Optimą budują partnerzy Comarch na obiektach COM albo bezpośrednio na bazie SQL. Sam operator wczyta kontrahentów i cennik z Excela, dokumenty z pliku XML, jeśli ktoś go przygotuje, i dokumenty z plików JPK do rejestru VAT, a faktury z KSeF Optima od wersji 2026.4.1 pobiera w tle.
| Dane | Droga w Optimie | Kto to zrobi | Na co uważać |
|---|---|---|---|
| Kontrahenci i cennik | Import z arkusza Excel (Narzędzia, Importy, Słowników z pliku) | Operator | Dla kontrahentów wymagane kolumny Kod, Nazwa, NIP |
| Dokumenty handlowe i magazynowe (FS, FZ, ZD, PZ, WZ, MM i inne) | Import i eksport pliku XML z listy dokumentów | Operator wczytuje plik; strukturę pliku zna Autoryzowany Partner Comarch | Struktura XML tylko dla Autoryzowanych Partnerów Comarch |
| Dokumenty z innych programów do rejestru VAT | Import plików JPK_VAT i JPK_V7 | Operator | Uproszczenia przy imporcie, dokumenty trzeba sprawdzić |
| Faktury z KSeF | Pobieranie w tle od wersji 2026.4.1 | Program sam | Szczegóły i ograniczenia niżej |
| Odczyt i zapis z własnej aplikacji | Integracja przez obiekty COM albo bazę SQL | Partner Comarch lub wykonawca integracji | Wiedza z naszych wdrożeń, Comarch tego publicznie nie opisuje |
Źródła: pomoc Comarch ERP Optima 2027: import i eksport XML, import z arkusza Excel, import do rejestrów VAT, faktury z KSeF (stan na 29 października 2026 r.).
Zamówienia przychodzą mailem, ceny dla stałych klientów są w Optimie, a stan magazynu ktoś sprawdza w trzecim oknie. Operator przepisuje to samo kilka razy dziennie i w końcu pyta szefa, czy nie da się tego połączyć.
Pierwsze, co wtedy wpisuje się w Google, to „czy Optima ma API”. Odpowiedź jest krótsza, niż się wydaje, ale nie zamyka sprawy: Optimę da się połączyć z innym programem, tylko inną drogą niż przez publiczne API.
Co zrobisz w samej Optimie, bez programisty
Kontrahenci i cennik z Excela
Kontrahentów i cennik wczytasz z arkusza MS Excel z menu Narzędzia, Importy, Słowników z pliku (Kontrahenci albo Cennik). Dla kontrahentów wymagane są trzy kolumny: Kod, Nazwa, NIP (pomoc Comarch, biuletyn OPT009).
Dokumenty w pliku XML
Import i eksport do pliku XML działa m.in. dla faktur sprzedaży i zakupu (FS, FZ), zamówień u dostawcy (ZD), przyjęć i wydań zewnętrznych (PZ, WZ) oraz przesunięć międzymagazynowych (MM). Import uruchamiasz z listy dokumentów: Funkcje dodatkowe, Import dokumentów. Program może przy tym założyć brakujące karty kontrahentów i towarów, bo te parametry są domyślnie zaznaczone. Do dokumentów magazynowych potrzebna jest licencja na moduł Handel albo Handel Plus (pomoc Comarch).
Dokumenty z innych programów do rejestru VAT
Funkcja Import do rej. VAT wczytuje pliki JPK_VAT i JPK_V7, także wygenerowane w programach innych producentów (pomoc Comarch).
Faktury z KSeF
Od wersji 2026.4.1 Optima pobiera faktury z KSeF sama, w tle, całymi paczkami, bez działań użytkownika (pomoc Comarch). Co dzieje się z nimi dalej i gdzie kończą się możliwości wbudowanego importu, opisujemy osobno: jak przenieść faktury z KSeF do Optimy.
Gdzie ta droga się kończy
- Plik XML musi ktoś przygotować. Opis struktury plików XML dla importu i eksportu dokumentów jest dostępny wyłącznie dla Autoryzowanych Partnerów Comarch. Żeby Twój sklep, arkusz czy inny program zapisał plik, który Optima przyjmie, potrzebny jest ktoś, kto tę strukturę zna.
- Faktur z Excela pomoc Comarch nie opisuje. W pomocy Comarch import z arkusza dotyczy m.in. kontrahentów i cennika. Importu faktur z Excela ani z CSV producent nie opisuje.
- Import z JPK jest uproszczony. Pliki JPK nie mają wszystkich informacji z dokumentu, więc Optima przyjmuje uproszczenia, m.in. co do formy płatności, waluty, stawki VAT i opisu. Comarch zaleca sprawdzenie dokumentów po imporcie.
- Dokumenty zaimportowane do Handlu jako zatwierdzone nie przechodzą same do rejestru VAT (pomoc Comarch).
- Każda z tych dróg to plik. Ktoś go przygotowuje i wczytuje. Jeśli dane mają płynąć między programami codziennie, w obie strony, potrzebna jest integracja.
Jak łączymy Optimę z własną aplikacją
W naszych wdrożeniach integracje z Optimą budują partnerzy Comarch na obiektach COM albo bezpośrednio na bazie SQL. Nazwę „API Comarch ERP Optima” znaleźliśmy w materiałach Comarch tylko w nocie do wersji 2027.0.1, przy wysyłce faktur do KSeF; dokumentacji takiego API w materiałach Comarch nie znaleźliśmy. Tak to wygląda w projekcie, który prowadzimy:
Odczyt z bazy SQL
Aplikacja czyta z bazy Optimy ceny z cennika klienta (cenę stałą klienta albo jego poziom cennika) kontem tylko do odczytu. Połączenie idzie szyfrowanym tunelem VPN.
Twoja aplikacja
Na naszym serwerze działają reguły, panel i ewentualnie model AI: odczyt maili, dopasowanie towarów, przygotowanie dokumentu.
Akceptacja na start
Na start operator przegląda przygotowany dokument w panelu i zatwierdza go albo poprawia, zanim trafi do Optimy. Celem jest pełna automatyzacja.
Zapis przez integratora Optimy
Zapis dokumentu do Optimy przygotowuje zewnętrzny integrator Optimy; ten element jest w przygotowaniu, a testy zapisu mają iść na osobnej bazie testowej.
Cena: integracja z ERP od 8 000 zł netto, wdrożenie z integracją ERP trwa 2–4 tygodnie. Pierwsza wersja na kopii danych powstaje w 1–2 dni. Koszty bieżące: serwer 300–500 zł miesięcznie i opłata za korzystanie z modelu AI, u naszych klientów 100–2 000 zł miesięcznie, zależnie od rodzaju i liczby zadań.
Dla jakich firm to ma sens
Firmy, które mają w Optimie handel i magazyn, a obok niej maile z zamówieniami, arkusze i drugi program, z którego ktoś codziennie przepisuje dane.
Nie ma sensu, gdy Optima służy tylko do księgowania, a dane wpływają do niej z KSeF i nikt ich nie przepisuje.
Czego to nie załatwi
- Nie zastąpi partnera Comarch. Licencje, aktualizacje i konfiguracja Optimy zostają u niego.
- Nie zadziała bez dostępu do bazy. Potrzebne jest konto SQL do odczytu i zgoda na połączenie z serwerem Optimy.
- Optima w chmurze to osobny przypadek. Comarch nie opisuje publicznie, jak podłączyć zewnętrzny program do Optimy w chmurze. To ustalamy w każdym przypadku osobno.
Najczęstsze pytania
Czy Comarch Optima ma API?
Z naszych wdrożeń wynika, że Optima nie ma natywnego API do integracji. Publicznej dokumentacji ani ceny API Optimy nie znaleźliśmy; nazwę „API Comarch ERP Optima” znaleźliśmy tylko w nocie do wersji 2027.0.1, przy wysyłce faktur do KSeF. W naszych wdrożeniach integracje budują partnerzy Comarch na obiektach COM albo bezpośrednio na bazie SQL.
Jak zaimportować dane z Excela do Optimy?
Kontrahentów i cennik wczytasz z menu Narzędzia, Importy, Słowników z pliku. Dla kontrahentów arkusz musi mieć kolumny Kod, Nazwa i NIP. Importu faktur z Excela pomoc Comarch nie opisuje.
Gdzie znaleźć strukturę pliku XML do importu dokumentów do Optimy?
Opis struktury plików XML dla importu i eksportu dokumentów Comarch udostępnia wyłącznie Autoryzowanym Partnerom Comarch.
Czy Optima sama pobiera faktury z KSeF?
Tak. Od wersji 2026.4.1 pobiera je w tle, całymi paczkami, bez działań użytkownika.
Ile kosztuje integracja Optimy z innym programem?
U nas integracja z ERP kosztuje od 8 000 zł netto, a pierwsza wersja na kopii danych powstaje w 1–2 dni. Koszty bieżące to serwer 300–500 zł miesięcznie i opłata za korzystanie z modelu AI, u naszych klientów 100–2 000 zł miesięcznie, zależnie od rodzaju i liczby zadań.
Czy integracja może coś zepsuć w Optimie?
Odczyt idzie kontem tylko do odczytu, na start zapis po akceptacji człowieka, przez interfejs integratora Optimy, a testy na osobnej bazie testowej.
Robimy to teraz
Oferty z maili i ceny z Optimy dla firmy handlowej z branży materiałów budowlanych
Odczyt cen z cennika klienta z bazy SQL Optimy kontem tylko do odczytu przez tunel VPN. Zapis ofert do Optimy przez interfejs zewnętrznego integratora jest w przygotowaniu.
Jeśli w Twojej firmie ktoś przepisuje dane do Optimy
Pokaż nam, co i skąd przepisuje. Umów bezpłatną rozmowę.
Umów bezpłatną rozmowęComarch ERP Optima jest znakiem towarowym Comarch S.A. MALINSKI.AI nie jest partnerem Comarch.