Integracje

⌘K
  1. Strona główna
  2. Integracje
  3. Sklep – Codarius
  4. Zakres integracji Codarius

Zakres integracji Codarius

Integracja z Codarius umożliwia przesyłanie danych ofert, cen i stanów magazynowych oraz pobieranie zamówień i ich płatności. Poniżej opisano zakres wymiany danych i ograniczenia integracji.

W tym artykule znajdziesz

Dane przesyłane z xSale do Codarius

  • Nazwy, opisy, kody produktów i wariantów oraz kody EAN
  • Zdjęcia produktów i przypisanie kategorii
  • Stany magazynowe
  • Ceny produktów
  • Parametry na ofercie
  • Nr listu przewozowego do zamówienia

Dane pobierane z Codarius do xSale

  • Zamówienia
  • Płatności do pobranych zamówień
  • Grupy i parametry

Szczegółowy zakres danych zamówień pobieranych z Codarius

Zamówienia z Codarius są przekazywane do xSale jako „Zamówienie sprzedaży”. Poniżej opisujemy sposób i zakres przesyłanych pól.

Tabela zawiera odpowiedniki pól z xSale i Codarius 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 xSale Pole xSale nr Obszar Codarius Pole Codarius nr
Edycja zamówienia > Formularz zamówienia Data zakupu 1 Sprzedaż -> Zamówienia -> Pokaż Data 2
Edycja zamówienia > Formularz zamówienia Zewnętrzny nr zamówienia 3 Sprzedaż -> Zamówienia -> Pokaż Zamówienie # 1
Edycja zamówienia > Formularz zamówienia Dostawa 4 Sprzedaż -> Zamówienia -> Pokaż -> Przesyłki Przesyłki 4
Edycja zamówienia > Formularz zamówienia Płatność 5 Sprzedaż -> Zamówienia -> Pokaż -> Płatności Płatności 3
           
Zamówienie → Zamawiający → Odbiorca Nazwa 9 Sprzedaż -> Zamówienia -> Pokaż -> Adres dostawy -> Edytuj -> Adres dostawy Imię & Nazwisko 11 & 12
Zamówienie → Zamawiający → Odbiorca Telefon 12 Sprzedaż -> Zamówienia -> Pokaż -> Adres dostawy -> Edytuj -> Adres dostawy Numer telefonu 19
Zamówienie → Zamawiający → Odbiorca E-mail 13 Sprzedaż -> Zamówienia -> Pokaż -> Klient Email 10
Zamówienie → Zamawiający → Odbiorca Miasto 14 Sprzedaż -> Zamówienia -> Pokaż -> Adres dostawy -> Edytuj -> Adres dostawy Miejscowość 17
Zamówienie → Zamawiający → Odbiorca Ulica 15 Sprzedaż -> Zamówienia -> Pokaż -> Adres dostawy -> Edytuj -> Adres dostawy Ulica 14 & 15
Zamówienie → Zamawiający → Odbiorca Kod pocztowy 16 Sprzedaż -> Zamówienia -> Pokaż -> Adres dostawy -> Edytuj -> Adres dostawy Kod pocztowy 18
Zamówienie → Zamawiający → Odbiorca Kraj 17 Sprzedaż -> Zamówienia -> Pokaż -> Adres dostawy -> Edytuj -> Adres dostawy Kraj 16
           
Zamówienie → Zamawiający → Nabywca Nazwa 18 Sprzedaż -> Zamówienia -> Pokaż -> Dane do faktury -> Edytuj -> Dane do faktury Imię & Nazwisko 20 & 21
Zamówienie → Zamawiający → Nabywca NIP 20 Sprzedaż -> Zamówienia -> Pokaż -> Dane do faktury -> Edytuj -> Dane do faktury NIP 23
Zamówienie → Zamawiający → Nabywca Telefon 21 Sprzedaż -> Zamówienia -> Pokaż -> Dane do faktury -> Edytuj -> Dane do faktury Numer telefonu 29
Zamówienie → Zamawiający → Nabywca E-mail 22 Sprzedaż -> Zamówienia -> Pokaż -> Klient Email klienta (wspólny dla odbiorcy i nabywcy)  
Zamówienie → Zamawiający → Nabywca Miasto 23 Sprzedaż -> Zamówienia -> Pokaż -> Dane do faktury -> Edytuj -> Dane do faktury Miasto 28
Zamówienie → Zamawiający → Nabywca Ulica 24 Sprzedaż -> Zamówienia -> Pokaż -> Dane do faktury -> Edytuj -> Dane do faktury Ulica 24 & 25
Zamówienie → Zamawiający → Nabywca Kod pocztowy 25 Sprzedaż -> Zamówienia -> Pokaż -> Dane do faktury -> Edytuj -> Dane do faktury Kod pocztowy 27
Zamówienie → Zamawiający → Nabywca Kraj 26 Sprzedaż -> Zamówienia -> Pokaż -> Dane do faktury -> Edytuj -> Dane do faktury Kraj 26
           
Zamówienie → Pozycje zamówienia Oferta 29 Sprzedaż -> Zamówienia -> Pokaż -> Element Element 5
Zamówienie → Pozycje zamówienia Brutto 28 Sprzedaż -> Zamówienia -> Pokaż -> Cena jednostkowa po zniżce Cena jednostkowa przekazana przez Codarius —
Zamówienie → Pozycje zamówienia Suma 27 Sprzedaż -> Zamówienia -> Pokaż -> Łącznie Łącznie 9
Zamówienie → Pozycje zamówienia Ilość 30 Sprzedaż -> Zamówienia -> Pokaż -> Płatności Ilość 7
Zamówienie → Pozycje zamówienia TRANSPORT 31 Dane zamówienia przekazywane przez Codarius Łączna kwota korekt zamówienia (patrz zasady poniżej) —

Zasady obsługi zamówień, płatności i przesyłek

Dane zamówienia i adresy

Numerem źródłowym jest numer zamówienia Codarius. Data zakupu pochodzi z daty zakończenia składania zamówienia. Pozycje są przekazywane z kodem wariantu, nazwą produktu, ilością i ceną jednostkową traktowaną jako brutto.

Dane odbiorcy pochodzą z adresu dostawy, a dane nabywcy z adresu do faktury. E-mail klienta jest wspólny dla obu adresów. Nazwa zawiera imię i nazwisko; gdy dany adres zawiera NIP, do nazwy dołączana jest również firma. Firma nie jest przekazywana jako osobne pole „Nazwa 2”.

Ceny i koszt dostawy

Integracja pobiera cenę jednostkową przekazaną przez Codarius. Nie przelicza osobno rabatów pozycji, dlatego nie należy zakładać, że cena zawsze odpowiada polu „Cena jednostkowa po zniżce” w panelu sklepu.

Jako wartość dostawy wykorzystywana jest łączna kwota korekt zamówienia przekazana przez Codarius. Nie można utożsamiać jej bezwarunkowo z samym kosztem wysyłki. Przy zamówieniach z rabatami lub dodatkowymi opłatami porównaj ceny pozycji, transport i sumę w obu systemach. W razie rozbieżności przekaż wsparciu xSale numer zamówienia i porównanie kwot.

Płatności

Pobierane są płatności oznaczone w Codarius jako zakończone. Przekazywane są ich kwota, waluta, identyfikator i forma płatności. Data płatności jest ustawiana na moment pobrania przez integrację, a nie na datę transakcji w sklepie. Forma płatności na zamówieniu pochodzi z pierwszej płatności zwróconej przez Codarius.

Punkt dostawy i numer listu

Sposób dostawy i kod punktu odbioru są pobierane z pierwszej przesyłki zamówienia. Punkt zostaje zapisany, jeśli Codarius przekazuje jego kod i dane adresu dostawy. Sama obecność punktu nie oznacza, że każda usługa kurierska jest dostępna do nadawania w xSale.

Numer listu przewozowego jest przekazywany do pierwszej przesyłki istniejącej przy zamówieniu w Codarius. Wymaga to skonfigurowanego przekazywania numerów listów. Jeśli zamówienie nie ma przesyłki w Codarius, integracja nie ma gdzie zapisać numeru.

Integracja nie obsługuje osobnej operacji ustawiania dowolnego statusu zamówienia Codarius po zmianie statusu w xSale. Przekazanie numeru listu jest odrębną operacją.

Szczegółowy zakres danych ofert przesyłanych do Codarius

Obszar xSale Nazwa pola w xSale nr Obszar Codarius Nazwa pola w Codarius nr Uwagi
Oferta -> Edycja -> Opis i nazwa oferty w poszczególnych językach Nazwa (z języka domyślnego wybranego dla integracji) 1 Produkty -> Edycja -> Szczegóły Nazwa 1  
Oferta -> Edycja -> Opis i nazwa oferty w poszczególnych językach Opis (z języka domyślnego wybranego dla integracji)  8 Produkty -> Edycja -> Szczegóły Opis 2  
Oferta -> Edycja -> Zdjęcia produktu Zdjęcia produktu  3 Produkty -> Edycja -> Zdjęcia Zdjęcia 8  
Oferta -> Edycja -> Parametry Parametry  4 Produkty -> Edycja -> Cechy Cechy 7  
Oferta -> Edycja -> Kanały sprzedaży -> Codarius (Edycja) Grupy 7 Produkty -> Edycja -> Kategorie Kategorie 6  
Oferta -> Edycja -> Informacje dodatkowe o ofercie Kod 2 Produkty -> Edycja -> Szczegóły Kod 3  
Oferta -> Edycja -> Moduły – > Codarius Cena 5 Produkty -> Edycja -> Szczegóły Cena 5 * Dla produktu pojedynczego
Oferta -> Edycja -> Moduły – > Codarius Stan magazynowy 6 Produkty -> Edycja -> Szczegóły Dostępny 4 * Dla produktu pojedynczego
Oferta -> Edycja -> Warianty i ceny -> Edytuj Dane wariantu 10 Produkty -> Zarządzaj wariantami -> Wylistuj warianty -> Edycja -> Warianty Warianty 11 * Dla produktu wielowariantowego 
Oferta -> Edycja -> Warianty i ceny -> Edytuj Towar (Kod towaru znajdujący się w nawiasach przez nazwą) 9 Produkty -> Zarządzaj wariantami -> Wylistuj warianty -> Edycja  Kod 9 * Dla produktu wielowariantowego
Oferta -> Edycja -> Warianty i ceny -> Edytuj -> Cena Cena  11 Produkty -> Zarządzaj wariantami -> Wylistuj warianty -> Edycja -> Cena  Cena 10 Cena w xSale jest ustalana według typu ceny wybranego na kanale sprzedaży Codarius.
Oferta -> Edycja -> Warianty i ceny -> Edytuj -> Stany magazynowe Stan magazynowy  12 Produkty -> Zarządzaj wariantami -> Wylistuj warianty -> Edycja -> Zapasy Dostępny 12 Stan pochodzi z magazynów wybranych w konfiguracji integracji. Przy wysyłaniu uwzględniane są również rezerwacje w Codarius, zgodnie z opisem poniżej.

Zasady aktualizacji ofert i wariantów

  • Oferta musi mieć przypisaną kategorię istniejącą w Codarius. Sprawdź ją, jeśli publikacja kończy się błędem kategorii.
  • Gdy brak zapisanego identyfikatora produktu, integracja szuka go po kodzie. Stosuj jednoznaczne kody i nie zmieniaj ich bez sprawdzenia powiązań.
  • Nazwy, opisy i parametry są wysyłane do polskiej wersji językowej sklepu, a dane sprzedażowe do kanału PL_WEB. Nie jest to synchronizacja wszystkich wersji językowych i kanałów Codarius.
  • Aktualizacja produktu ustawia go jako aktywny w Codarius.
  • Przy pełnej synchronizacji warianty są dodawane i aktualizowane po kodzie. Warianty istniejące w sklepie, których nie ma w przesyłanej ofercie xSale, są usuwane. Przed synchronizacją sprawdź komplet wariantów.
  • Przy aktualizacji stanu integracja dodaje do ilości przekazanej z xSale rezerwacje odczytane z Codarius. Stan całkowity w sklepie może więc różnić się od dostępnej ilości.

Nie należy zakładać automatycznego przenoszenia stawek VAT produktów z xSale. W sprawdzonej implementacji integracja nie przypisuje stawki VAT do kategorii podatkowej produktu w Codarius. Sprawdź ustawienia podatkowe po stronie sklepu.

Zrzuty xSale

Zrzuty Codarius

Czego brakuje w tym artykule?