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
- dane pobierane z Codarius
- szczegółowy zakres danych zamówień
- zasady obsługi zamówień, płatności i przesyłek
- szczegółowy zakres danych ofert
- zasady aktualizacji ofert i wariantów
- zrzuty xSale
- zrzuty Codarius
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 | 13 | Sprzedaż -> Zamówienia -> Pokaż -> Klient | 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 | 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.

EN












