1. Home
  2. Docs
  3. Współpraca z ERP
  4. Comarch ERP Optima
  5. Zakres wymienianych danych

Zakres wymienianych danych

Zakres danych przesyłanych z Comarch ERP Optima do xSale:

  • Karty towarowe (według grup ustalonych w konfiguracji)
    • Stany magazynowe (według magazynów ustalonych w konfiguracji)
    • Ceny (według typów cen ustawionych w konfiguracji)
    • Opis
    • Zdjęcia
      • Przy pobieraniu zdjęcia analizujemy zawartość zdjęcia i na tej podstawie generujemy specjalny numer. Gdy dodamy dwa takie same zdjęcia to numery będą takie same i pobierzemy tylko jedno zdjęcie. Dwa zdjęcia uważamy za takie same jeżeli mają takie same „zawartości”.
      • Ilość importowanych zdjęć na jednej karcie towaru jest limitowana do 20.
  • Kontrahenci (według grupy określonej w konfiguracji)
  • Opcjonalnie możliwe jest przesyłanie dokumentów RO z Optimy do xSale np. w celu późniejszego procesowania ich przez xSale. Szczegóły w tym miejscu.

Ogólny zakres danych przesyłanych z xSale do Comarch ERP Optima:

  • Zamówienia
  • Płatności
  • Kontrahenci
  • Karty towarowe
    • Uwaga: Nie jest zalecana zmiana kodów towarów w ERP ponieważ synchronizacja odbywa się po kodzie towaru.
      Zmiana kodu towaru powoduje:
      – utworzenie nowej karty towarowej w xSale na której bez wymuszenia synchronizacji nie pobiorą się stany i ceny
      – brak synchronizacji poprzedniego kodu
      – konieczność zmiany kodu na utworzonych wcześniej ofertach.

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

Zamówienia z xSale są przekazywane do Optima jako „Rezerwacja odbiorcy”. Poniżej opisujemy sposób i zakres przesyłanych pól.

Tabela zawiera odpowiedniki pól z xSale i Optima wraz z nazwami tych pól w danych systemach oraz numer pola, którym oznaczone jest ono na zrzutach w galerii znajdujących się pod tabelą.

Obszar xSalePole xSalenrObszar OptimaPole Optimanr Uwagi
Edycja zamówienia > Formularz zamówieniaId1Edycja Rezerwacji odbiorcy > AtrybutyAtrybuty36
Edycja zamówienia > Formularz zamówieniaFGUID2Edycja Rezerwacji odbiorcy > AtrybutyAtrybuty36
Edycja zamówienia > Formularz zamówieniaData zakupu3Edycja Rezerwacji odbiorcy > OgólneData wystawienia3
Edycja zamówienia > Formularz zamówieniaIntegracja4Edycja Rezerwacji odbiorcy > AtrybutyAtrybuty36
Edycja zamówienia > Formularz zamówieniaZewnętrzny nr zamówienia5Edycja Rezerwacji odbiorcy > OgólneNr zamówienia1
Edycja zamówienia > Formularz zamówieniaMiejsce powstawania kosztów6Edycja Rezerwacji odbiorcy > AtrybutyAtrybuty36Atrybut związany jest z integracją xSale B2B
Edycja zamówienia > Formularz zamówieniaZamawiający7Edycja Rezerwacji odbiorcy > AtrybutyAtrybuty36Atrybut związany jest z integracją xSale B2B
Edycja zamówienia > Formularz zamówieniaDostawa8Edycja Rezerwacji odbiorcy > AtrybutyAtrybuty36
Edycja zamówienia > Formularz zamówieniaPłatność10Edycja Rezerwacji odbiorcy > OgólnePłatność4
Edycja zamówienia > Formularz zamówieniaDokument liczony od brutto11Edycja Rezerwacji odbiorcy > OgólneDokum. liczony od5
Edycja zamówienia > Formularz zamówieniaRodzaj faktury12Edycja Rezerwacji odbiorcy > AtrybutyAtrybuty36
Edycja zamówienia > Formularz zamówieniaUwagi13Edycja Rezerwacji odbiorcy > DodatkoweOpis/Atrybuty35
Kontrahenci> Edycja kontrahentaKodEdycja Rezerwacji odbiorcy > OgólneKontrahent37Pole „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 > OdbiorcaNazwa14Edycja Rezerwacji odbiorcy > KontrahentNazwa21Pola 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 > OdbiorcaNazwa 215Edycja Rezerwacji odbiorcy > KontrahentNazwa21Pola 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 > OdbiorcaNazwa 316Edycja Rezerwacji odbiorcy > KontrahentNazwa21Pola 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 > OdbiorcaNIP17Edycja Rezerwacji odbiorcy > KontrahentNIP22
Edycja zamówienia > Formularz adresu > OdbiorcaTelefon18Edycja Rezerwacji odbiorcy > KontrahentTelefon26
Edycja zamówienia > Formularz adresu > OdbiorcaE-mail20Edycja Rezerwacji odbiorcy > KontrahentEmail32
Edycja zamówienia > Formularz adresu > OdbiorcaMiasto21Edycja Rezerwacji odbiorcy > KontrahentMiejscowość25
Edycja zamówienia > Formularz adresu > OdbiorcaUlica22Edycja Rezerwacji odbiorcy > KontrahentUlica24
Edycja zamówienia > Formularz adresu > OdbiorcaNumer ulicy23Edycja Rezerwacji odbiorcy > KontrahentNr domu28W 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 > OdbiorcaKod pocztowy24Edycja Rezerwacji odbiorcy > KontrahentKod pocztowy30
Edycja zamówienia > Formularz adresu > OdbiorcaKraj25Edycja Rezerwacji odbiorcy > KontrahentKraj23
Edycja zamówienia > Formularz adresu > KupującyNazwa26Edycja Rezerwacji odbiorcy > KontrahentNazwa11Pola 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ącyNazwa 227Edycja Rezerwacji odbiorcy > KontrahentNazwa11Pola 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ącyNazwa 328Edycja Rezerwacji odbiorcy > KontrahentNazwa11Pola 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ącyNIP29Edycja Rezerwacji odbiorcy > KontrahentNIP12
Edycja zamówienia > Formularz adresu > KupującyMiasto33Edycja Rezerwacji odbiorcy > KontrahentMiejscowość15
Edycja zamówienia > Formularz adresu > KupującyUlica34Edycja Rezerwacji odbiorcy > KontrahentUlica14
Edycja zamówienia > Formularz adresu > KupującyNumer ulicy35Edycja Rezerwacji odbiorcy > KontrahentNr domu17W 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ącyKod pocztowy36Edycja Rezerwacji odbiorcy > KontrahentKod pocztowy19
Edycja zamówienia > Formularz adresu > KupującyKraj37Edycja Rezerwacji odbiorcy > KontrahentKraj13
Edycja zamówienia > Lista przedmiotów zamówieniaNazwa38Edycja Rezerwacji odbiorcy > OgólneNazwa7
Edycja zamówienia > Lista przedmiotów zamówieniaKod39Edycja Rezerwacji odbiorcy > OgólneKod6
Edycja zamówienia > Lista przedmiotów zamówieniaNetto40Edycja Rezerwacji odbiorcy > OgólneCena10Do 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ówieniaBrutto41Edycja Rezerwacji odbiorcy > OgólneCena10Do 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ówieniaIlość42Edycja Rezerwacji odbiorcy > OgólneIlość8
Edycja zamówienia > Lista przedmiotów zamówieniaJednostka43Edycja Rezerwacji odbiorcy > OgólneJm9

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

Obszar xSalePole xSalenrObszar OptimaPole OptimanrUwagi
Edycja towaruNazwa1Ogólne > Nazwa, kategorieNazwa1
Edycja towaruKod2Ogólne > Dane ogólneKod2Dodawany jest w dwóch miejscach w xSale
Edycja towaruKod EAN3Ogólne > VAT, EAN, PKWU, CNEAN3
Edycja towaruRodzaj4Ogólne > Dane ogólneTyp4
Edycja towaruOpis5Dodatkowe > Opis, URLOpis5
Edycja towaruTyp ceny6Ogólne > VAT, EAN, PKWU, CNCena domyślna6Nazwa cennika może różnić się w xSale w zależności od konfiguracji. 
Edycja towaruCena domyślna7Ogólne > CenyNumer ceny7Pobrana zostanie cena z domyślnego cennika na towarze.
Edycja towaruJednostka główna8Ogólne > Jednostka miary, opakowaniaJedn. Podstawowa8
Edycja towaruVAT9Ogólne > VAT, EAN, PKWU, CNStawka VAT – sprz.9
Edycja towaruWaga w kilogramach10Dodatkowe > ParametryMasa w kg10
Edycja towaruArchiwalny11Dodatkowe > ParametryKarta nieaktywna11Towar zostanie oznaczony na czerwono i domyślnie ukryty na liście towarów.
ZdjęciaZdjęcia12Atrybuty > ZałącznikiZałączniki12Pobierane zą pliki graficzne jpg i png. Nie obsługiwane są linki do zdjeć.
Stany magazynoweIlość13Zasoby > ZasobyIlości13
Stany magazynoweMagazyn14Zasoby > ZasobyMagazyn14Nazwa 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. 
CenaTyp ceny15Ogólne > CenyNumer ceny15Można przesłać wszystkie lub wybrane cenniki do xSale.
CenaCena16Ogólne > CenyCena brutto / Cena netto16Pobierana jest cena netto lub brutto w zależności od typu ceny.
Dodaj parametrDodaj parametr17Atrybuty > AtrybutyAtrybuty17Musi być włączona opcja pobierania atrybutów.
GrupyGrupy18Grupy > GrupyGrupy18Musi być włączona opcja pobierania grup.
OpisJęzyki19Języki > JęzykiNazwa, Opis19Opcja ta jest możliwa tylko dla licencji Comarch Handel Plus. Pobierana jest nazwa i opis. 
Jednostki pomocniczeJednostki pomocnicze20Jednostki i kody > Pomocnicze jednostki miaryPomocnicze jednostki miary20Pobierana jest nazwa jednostki pomocniczej, licznik, mianownik, przelicznik, JM dla ceny jednostkowej, domyślna.

Uwaga: Pola nie opisane w dokumentacji otrzymują taką wartość jaką domyślnie ustawia API danego systemu.

Zrzuty xSale

Zrzuty Optima