Zakres wymienianych danych z Comarch ERP Optima

Wpis opisuje zakres danych wymienianych między xSale a Comarch ERP Optima. Obejmuje dwa kierunki synchronizacji: dane pobierane z Optimy do xSale oraz dane przesyłane z xSale do Optimy.

Dane pobierane z Comarch ERP Optima do xSale

Zakres pobieranych danych zależy od konfiguracji integracji, wybranych grup, magazynów, typów cen i uruchomionych procesów. Z Comarch ERP Optima do xSale mogą być pobierane:

karty towarowe z grup ustalonych w konfiguracji,
stany magazynowe z wybranych magazynów – xSale pobiera stan dostępny, czyli ilość pomniejszoną o rezerwacje,
ceny według typów cen ustawionych w konfiguracji,
opis towaru,
zdjęcia towarów,
kontrahenci z grupy określonej w konfiguracji,
numery listów przewozowych, jeśli proces pobierania listów z ERP do xSale jest wykorzystywany,
opcjonalnie dokumenty RO z Optimy do xSale, jeśli taki proces został wdrożony.

Przy pobieraniu zdjęć integracja analizuje zawartość pliku. Jeśli dwa zdjęcia mają taką samą zawartość, są traktowane jako ten sam plik i pobierane jednokrotnie. Na jednej karcie towaru importowanych jest maksymalnie 20 zdjęć. Zdjęcia są pobierane w kolejności alfabetycznej, z zastosowaniem naturalnego sortowania nazw plików.

Szczegółowe działanie procesów powiązanych opisują osobne wpisy: Pobieranie numeru listu przewozowego z ERP do xSale oraz Import RO do xSale.

Dane przesyłane z xSale do Comarch ERP Optima

Z xSale do Comarch ERP Optima przesyłane są przede wszystkim dane potrzebne do obsługi zamówień. W zależności od konfiguracji mogą to być:

zamówienia,
płatności,
dane kontrahentów,
numery listów przewozowych,
karty towarowe, jeśli konfiguracja dopuszcza tworzenie brakujących towarów przy imporcie zamówienia.

Zamówienia z xSale są zapisywane w Comarch ERP Optima jako dokumenty Rezerwacja odbiorcy (RO). To, czy RO zostanie zapisane w buforze, zatwierdzone lub dalej przetworzone, zależy od ustawień WebService i procesów automatycznych.

Nie zalecamy zmiany kodów towarów w ERP, ponieważ synchronizacja opiera się na kodzie towaru. Zmiana kodu może spowodować utworzenie nowej karty towarowej w xSale, brak dalszej synchronizacji poprzedniego kodu oraz konieczność ręcznej aktualizacji kodu na wcześniej utworzonych ofertach.

Procesy automatyczne mogą obsługiwać kolejne etapy pracy z zamówieniem, na przykład zatwierdzanie RO, generowanie i wydruk WZ, generowanie faktury oraz wysyłkę faktury do klienta. Lista dostępnych procesów znajduje się w osobnym wpisie: Lista procesów automatycznych.

Szczegółowy zakres danych przesyłanych z xSale do Comarch ERP Optima

Poniższa tabela pokazuje odpowiedniki pól z xSale i Comarch ERP Optima dla danych przesyłanych do Optimy. Numery w kolumnach „nr” odnoszą się do oznaczeń widocznych na zrzutach ekranu pod tabelą.

Obszar xSale	Pole xSale	nr	Obszar Optima	Pole Optima	nr	Uwagi
Edycja zamówienia > Formularz zamówienia	Id	1	Edycja Rezerwacji odbiorcy > Atrybuty	Atrybuty	36
Edycja zamówienia > Formularz zamówienia	FGUID	2	Edycja Rezerwacji odbiorcy > Atrybuty	Atrybuty	36
Edycja zamówienia > Formularz zamówienia	Data zakupu	3	Edycja Rezerwacji odbiorcy > Ogólne	Data wystawienia	3
Edycja zamówienia > Formularz zamówienia	Integracja	4	Edycja Rezerwacji odbiorcy > Atrybuty	Atrybuty	36
Edycja zamówienia > Formularz zamówienia	Zewnętrzny nr zamówienia	5	Edycja Rezerwacji odbiorcy > Ogólne	Nr zamówienia	1
Edycja zamówienia > Formularz zamówienia	Miejsce powstawania kosztów	6	Edycja Rezerwacji odbiorcy > Atrybuty	Atrybuty	36	Atrybut związany jest z integracją xSale B2B
Edycja zamówienia > Formularz zamówienia	Zamawiający	7	Edycja Rezerwacji odbiorcy > Atrybuty	Atrybuty	36	Atrybut związany jest z integracją xSale B2B
Edycja zamówienia > Formularz zamówienia	Dostawa	8	Edycja Rezerwacji odbiorcy > Atrybuty	Atrybuty	36
Edycja zamówienia > Formularz zamówienia	Płatność	10	Edycja Rezerwacji odbiorcy > Ogólne	Płatność	4
Edycja zamówienia > Formularz zamówienia	Dokument liczony od brutto	11	Edycja Rezerwacji odbiorcy > Ogólne	Dokum. liczony od	5
Edycja zamówienia > Formularz zamówienia	Rodzaj faktury	12	Edycja Rezerwacji odbiorcy > Atrybuty	Atrybuty	36
Edycja zamówienia > Formularz zamówienia	Uwagi	13	Edycja Rezerwacji odbiorcy > Dodatkowe	Opis/Atrybuty	35
Kontrahenci> Edycja kontrahenta	Kod	–	Edycja Rezerwacji odbiorcy > Ogólne	Kontrahent	37	Pole „Kod” z edycji kontrahenta w xSale = akronimowi kontrahenta z zamówienia xSale tj. to właśnie pole wysyłane jest do ERP jako akronim. Szczegółowy opis.
Edycja zamówienia > Formularz adresu > Odbiorca	Nazwa	14	Edycja Rezerwacji odbiorcy > Kontrahent	Nazwa	21	Pola z xSale „Nazwa”, „Nazwa 2”, „Nazwa 3” są sklejane w jedną nazwę i tak eksportowane są do ERP do odpowiedniego pola. Jeśli po stronie ERP pole nazwa jest ograniczone ilością znaków, nazwa ucinana jest zgodnie z ograniczeniem oraz dalsza część przenoszona jest do kolejnych przeznaczonych na nazwę pól.
Edycja zamówienia > Formularz adresu > Odbiorca	Nazwa 2	15	Edycja Rezerwacji odbiorcy > Kontrahent	Nazwa	21	Pola z xSale „Nazwa”, „Nazwa 2”, „Nazwa 3” są sklejane w jedną nazwę i tak eksportowane są do ERP do odpowiedniego pola. Jeśli po stronie ERP pole nazwa jest ograniczone ilością znaków, nazwa ucinana jest zgodnie z ograniczeniem oraz dalsza część przenoszona jest do kolejnych przeznaczonych na nazwę pól.
Edycja zamówienia > Formularz adresu > Odbiorca	Nazwa 3	16	Edycja Rezerwacji odbiorcy > Kontrahent	Nazwa	21	Pola z xSale „Nazwa”, „Nazwa 2”, „Nazwa 3” są sklejane w jedną nazwę i tak eksportowane są do ERP do odpowiedniego pola. Jeśli po stronie ERP pole nazwa jest ograniczone ilością znaków, nazwa ucinana jest zgodnie z ograniczeniem oraz dalsza część przenoszona jest do kolejnych przeznaczonych na nazwę pól.
Edycja zamówienia > Formularz adresu > Odbiorca	NIP	17	Edycja Rezerwacji odbiorcy > Kontrahent	NIP	22	Jeżeli Kontrahent zostanie znaleziony już w ERP wg ustawionych reguł, a na zamówieniu nie ma numeru NIP to i tak zostanie użyty numer NIP z karty kontrahenta.
Edycja zamówienia > Formularz adresu > Odbiorca	Telefon	18	Edycja Rezerwacji odbiorcy > Kontrahent	Telefon	26
Edycja zamówienia > Formularz adresu > Odbiorca	E-mail	20	Edycja Rezerwacji odbiorcy > Kontrahent	Email	32
Edycja zamówienia > Formularz adresu > Odbiorca	Miasto	21	Edycja Rezerwacji odbiorcy > Kontrahent	Miejscowość	25
Edycja zamówienia > Formularz adresu > Odbiorca	Ulica	22	Edycja Rezerwacji odbiorcy > Kontrahent	Ulica	24
Edycja zamówienia > Formularz adresu > Odbiorca	Numer ulicy	23	Edycja Rezerwacji odbiorcy > Kontrahent	Nr domu	28	W zależności od integracji „nr domu” i „nr lokalu” doklejane są do pola „Ulica”. W takim wypadku skoro nr domu i lokalu znajdują się w jednym polu wraz z ulicą (np. „Szewska 12/2”) to pola „nr domu” i „nr lokalu” zostaną nadpisane pustymi danymi w ERP (aby uniknąć wpisu „Szewska 12/2 12/2”. Pole nr 18 „Nr lokalu” nie jest uzupełniane w ERP. Uwaga: Pole nr 28 „Nr domu:” przyjmuje w ERP maksymalnie 10 znaków.
Edycja zamówienia > Formularz adresu > Odbiorca	Kod pocztowy	24	Edycja Rezerwacji odbiorcy > Kontrahent	Kod pocztowy	30
Edycja zamówienia > Formularz adresu > Odbiorca	Kraj	25	Edycja Rezerwacji odbiorcy > Kontrahent	Kraj	23
Edycja zamówienia > Formularz adresu > Kupujący	Nazwa	26	Edycja Rezerwacji odbiorcy > Kontrahent	Nazwa	11	Pola z xSale „Nazwa”, „Nazwa 2”, „Nazwa 3” są sklejane w jedną nazwę i tak eksportowane są do ERP do odpowiedniego pola. Jeśli po stronie ERP pole nazwa jest ograniczone ilością znaków, nazwa ucinana jest zgodnie z ograniczeniem oraz dalsza część przenoszona jest do kolejnych przeznaczonych na nazwę pól.
Edycja zamówienia > Formularz adresu > Kupujący	Nazwa 2	27	Edycja Rezerwacji odbiorcy > Kontrahent	Nazwa	11	Pola z xSale „Nazwa”, „Nazwa 2”, „Nazwa 3” są sklejane w jedną nazwę i tak eksportowane są do ERP do odpowiedniego pola. Jeśli po stronie ERP pole nazwa jest ograniczone ilością znaków, nazwa ucinana jest zgodnie z ograniczeniem oraz dalsza część przenoszona jest do kolejnych przeznaczonych na nazwę pól.
Edycja zamówienia > Formularz adresu > Kupujący	Nazwa 3	28	Edycja Rezerwacji odbiorcy > Kontrahent	Nazwa	11	Pola z xSale „Nazwa”, „Nazwa 2”, „Nazwa 3” są sklejane w jedną nazwę i tak eksportowane są do ERP do odpowiedniego pola. Jeśli po stronie ERP pole nazwa jest ograniczone ilością znaków, nazwa ucinana jest zgodnie z ograniczeniem oraz dalsza część przenoszona jest do kolejnych przeznaczonych na nazwę pól.
Edycja zamówienia > Formularz adresu > Kupujący	NIP	29	Edycja Rezerwacji odbiorcy > Kontrahent	NIP	12	Jeżeli Kontrahent zostanie znaleziony już w ERP wg ustawionych reguł, a na zamówieniu nie ma numeru NIP to i tak zostanie użyty numer NIP z karty kontrahenta.
Edycja zamówienia > Formularz adresu > Kupujący	Miasto	33	Edycja Rezerwacji odbiorcy > Kontrahent	Miejscowość	15
Edycja zamówienia > Formularz adresu > Kupujący	Ulica	34	Edycja Rezerwacji odbiorcy > Kontrahent	Ulica	14
Edycja zamówienia > Formularz adresu > Kupujący	Numer ulicy	35	Edycja Rezerwacji odbiorcy > Kontrahent	Nr domu	17	W zależności od integracji „nr domu” i „nr lokalu” doklejane są do pola „Ulica”. W takim wypadku jeśli nr domu i lokalu znajdują się w jednym polu wraz z ulicą (np. „Szewska 12/2”) to pola „nr domu” i „nr lokalu” zostaną nadpisane pustymi danymi w ERP (aby uniknąć wpisu „Szewska 12/2 12/2”. Pole nr 18 „Nr lokalu” nie jest uzupełniane w ERP. Uwaga: Pole nr 17 „Nr domu:” przyjmuje w ERP maksymalnie 10 znaków.
Edycja zamówienia > Formularz adresu > Kupujący	Kod pocztowy	36	Edycja Rezerwacji odbiorcy > Kontrahent	Kod pocztowy	19
Edycja zamówienia > Formularz adresu > Kupujący	Kraj	37	Edycja Rezerwacji odbiorcy > Kontrahent	Kraj	13
Edycja zamówienia > Lista przedmiotów zamówienia	Nazwa	38	Edycja Rezerwacji odbiorcy > Ogólne	Nazwa	7
Edycja zamówienia > Lista przedmiotów zamówienia	Kod	39	Edycja Rezerwacji odbiorcy > Ogólne	Kod	6
Edycja zamówienia > Lista przedmiotów zamówienia	Netto	40	Edycja Rezerwacji odbiorcy > Ogólne	Cena	10	Do pola „Cena” przenoszona jest cena netto lub brutto – w zależności od konfiguracji sposobu liczenia dokumentu od netto lub brutto
Edycja zamówienia > Lista przedmiotów zamówienia	Brutto	41	Edycja Rezerwacji odbiorcy > Ogólne	Cena	10	Do pola „Cena” przenoszona jest cena netto lub brutto – w zależności od konfiguracji sposobu liczenia dokumentu od netto lub brutto
Edycja zamówienia > Lista przedmiotów zamówienia	Ilość	42	Edycja Rezerwacji odbiorcy > Ogólne	Ilość	8
Edycja zamówienia > Lista przedmiotów zamówienia	Jednostka	43	Edycja Rezerwacji odbiorcy > Ogólne	Jm	9
Lista zamówień	Login kupującego (Login Marketplace)		Edycja Rezerwacji odbiorcy > Atrybuty	Atrybuty	36	Wartość pola jest synchronizowana do atrybutu na dokumencie w Comarch ERP Optima. Zobacz zrzut w xSale.
Edycja zamówienia > Formularz zamówienia	Punkt odbioru		Edycja Rezerwacji odbiorcy > Atrybuty	Punkt odbioru	36
Edycja zamówienia > Pola dodatkowe	Pola dodatkowe	44	Edycja Rezerwacji odbiorcy > Atrybuty	Kod i wartość jak ustawione w polu dodatkowym	36	Pole dodatkowe będzie przesyłane do Optimy, tylko wtedy, kiedy na edycji ustawienia ma zaznaczoną opcję „W integracji z ERP”

Szczegółowy zakres danych pobieranych z Comarch ERP Optima do xSale

Poniższa tabela pokazuje pola pobierane z Comarch ERP Optima do xSale. Numery w kolumnach „nr” odnoszą się do oznaczeń widocznych na zrzutach ekranu pod tabelą.

Obszar xSale	Pole xSale	nr	Obszar Optima	Pole Optima	nr	Uwagi
Edycja towaru	Nazwa	1	Ogólne > Nazwa, kategorie	Nazwa	1
Edycja towaru	Kod	2	Ogólne > Dane ogólne	Kod	2	Dodawany jest w dwóch miejscach w xSale
Edycja towaru	Kod EAN	3	Ogólne > VAT, EAN, PKWU, CN	EAN	3
Edycja towaru	Rodzaj	4	Ogólne > Dane ogólne	Typ	4	Typ produktu nie jest pobierany z ERP do xSale. Jest ustawiony domyślnie na „Towar”. W xSale jest możliwa późniejsza zmiana typu na „Usługa”.
Edycja towaru	Opis	5	Dodatkowe > Opis, URL	Opis	5
Edycja towaru	Typ ceny	6	Ogólne > VAT, EAN, PKWU, CN	Cena domyślna	6	Nazwa cennika może różnić się w xSale w zależności od konfiguracji.
Edycja towaru	Cena domyślna	7	Ogólne > Ceny	Numer ceny	7	Pobrana zostanie cena z domyślnego cennika na towarze.
Edycja towaru	Jednostka główna	8	Ogólne > Jednostka miary, opakowania	Jedn. Podstawowa	8	xSale najpierw szuka dokładnie takiej samej jednostki. Jeśli jej nie znajdzie, szuka podobnej po nazwie. najpierw szuka `m`, a dopiero potem może dopasować `m2` albo `m3`. Dlatego najlepiej, aby nazwy jednostek w ERP były takie same jak w xSale.
Edycja towaru	VAT	9	Ogólne > VAT, EAN, PKWU, CN	Stawka VAT – sprz.	9
Edycja towaru	Waga w kilogramach	10	Dodatkowe > Parametry	Masa w kg	10
Edycja towaru	Archiwalny	11	Dodatkowe > Parametry	Karta nieaktywna	11	Towar zostanie oznaczony na czerwono i domyślnie ukryty na liście towarów.
Zdjęcia	Zdjęcia	12	Atrybuty > Załączniki	Załączniki	12	Pobierane zą pliki graficzne jpg i png. Nie obsługiwane są linki do zdjęć. Zachowana jest kolejność alfabetyczna (naturalna metoda sortowania). np. 00_VIN_szara_natynk_di 00_VIN0932 00_VIN0932_a 00_VIN0932_box
Stany magazynowe	Ilość	13	Lista zasobów	Ilość dostępna	13	Ilość dostępna to stan, czyli ilość pomniejszona o rezerwacje uwzględniane w Optimie.
Stany magazynowe	Magazyn	14	Zasoby > Zasoby	Magazyn	14	Nazwa magazynu może różnić się w xSale w zależności od konfiguracji. Możliwe jest połączenie wielu magazynów z ERP w jeden.
Cena	Typ ceny	15	Ogólne > Ceny	Numer ceny	15	Można przesłać wszystkie lub wybrane cenniki do xSale.
Cena	Cena	16	Ogólne > Ceny	Cena brutto / Cena netto	16	Pobierana jest cena netto lub brutto w zależności od typu ceny.
Dodaj parametr	Dodaj parametr	17	Atrybuty > Atrybuty	Atrybuty	17	Musi być włączona opcja pobierania atrybutów.
Grupy	Grupy	18	Grupy > Grupy	Grupy	18	Musi być włączona opcja pobierania grup.
Jednostki pomocnicze	Jednostki pomocnicze	20	Jednostki i kody > Pomocnicze jednostki miary	Pomocnicze jednostki miary	20	Pobierana jest nazwa jednostki pomocniczej, licznik, mianownik, przelicznik, JM dla ceny jednostkowej, domyślna.