Mapowania płatności pozwalają powiązać nazwy płatności zwracane przez sklep lub marketplace z odpowiednią formą płatności w xSale. Dzięki temu zamówienia trafiają do xSale z prawidłową formą płatności, a w razie potrzeby te same dane mogą zostać dalej wykorzystane przy przekazywaniu płatności do ERP.
Po dodaniu nowej płatności w sklepie, marketplace lub po zmianie jej nazwy warto od razu sprawdzić mapowania w integracji. Brak mapowania najczęściej oznacza, że zamówienie nie otrzyma w xSale takiego przypisania, jakiego oczekujesz.
W tym artykule znajdziesz
- gdzie dodać mapowanie płatności w xSale v2
- jak uzupełnić formularz krok po kroku
- co oznaczają pola w mapowaniu płatności
- jak edytować i usuwać wpisy
- jak wygląda to w interfejsie xSale v1
Gdzie dodać mapowanie płatności w xSale v2
Przejdź do sekcji Integracje, otwórz wybraną integrację, a następnie wejdź do zakładki Mapowania dostaw i płatności. W tej części znajdziesz osobny formularz dla Mapowań płatności.

Jak dodać mapowanie
- Przejdź do zakładki Integracje i otwórz listę wszystkich integracji.
- Kliknij wybraną integrację ze sklepem lub marketplace.
- Przejdź do zakładki Mapowania dostaw i płatności.
- Uzupełnij pola formularza w sekcji Mapowania płatności. Opis poszczególnych pól znajdziesz poniżej.
- Po wprowadzeniu danych kliknij + Dodaj. Wpis zostanie zapisany na liście pod formularzem.
- Powtórz operację dla każdej formy płatności, którą chcesz obsłużyć osobno.
Jeśli korzystasz z kilku płatności w jednym kanale sprzedaży, warto przejść po kolei przez wszystkie nazwy zwracane przez sklep lub marketplace i sprawdzić, czy każda z nich ma swoje mapowanie.
Opis pól
- Forma płatności w e-commerce – wpisz nazwę formy płatności zwracaną przez sklep lub marketplace. Zwróć uwagę na wielkość liter, spacje i zapis nazwy – powinna być zgodna z wartością zwracaną przez dane źródło zamówienia. Dodając osobny wpis z symbolem * w tym polu, możesz ustalić mapowanie dla pozostałych płatności, które nie są jeszcze oddzielnie uwzględnione na liście.
Przykład:
W sklepie została dodana nowa forma płatności, a w xSale nie ma jeszcze dla niej osobnego mapowania. Jeśli masz wpis z symbolem *, xSale może użyć ustawień z tego wiersza jako mapowania domyślnego. - Waluta – możesz rozdzielić mapowania tej samej płatności według waluty. To przydaje się wtedy, gdy jedna nazwa płatności występuje w kilku walutach i chcesz inaczej obsłużyć ją dalej w ERP. Jeśli pozostawisz to pole puste, mapowanie nie będzie rozróżniało waluty, a jedynie samą nazwę płatności.
Przykład:
Jeśli sprzedajesz na kilku rynkach i chcesz, aby płatności o tej samej nazwie trafiały do różnych rejestrów, możesz dodać dwa wpisy z tą samą nazwą w polu Forma płatności w e-commerce, ale z różnymi walutami, np. PLN i CZK. - Forma płatności w xSale – wybierz formę płatności utworzoną wcześniej w xSale. Wskazana forma będzie widoczna na zamówieniu w xSale i może być dalej wykorzystywana w integracji z ERP.
- Rejestr – podaj nazwę lub akronim rejestru z ERP, na którym ma zostać wykonany zapis kasowy lub bankowy. Uzupełnij to pole, jeśli dla tej płatności przewidujesz tworzenie zapisów w ERP, np. na kasie albo banku.
- Dokument – wskaż typ dokumentu, który ma zostać utworzony po przekazaniu płatności do ERP, jeśli Twoja integracja korzysta z tego ustawienia.
Jeśli potrzebujesz praktycznych przykładów dla konkretnych integracji, zobacz też wpis Przykłady mapowań w różnych integracjach.
| Ważne
Nie możesz zapisać dwóch takich samych mapowań dla tej samej nazwy płatności i tej samej waluty. Jeśli chcesz rozdzielić obsługę jednej płatności, użyj do tego pola Waluta albo zmień sam sposób mapowania. W praktyce często dodaje się też osobny wpis z symbolem * w polu E-commerce, aby wskazać domyślne mapowanie dla płatności, które nie zostały jeszcze rozpisane osobno. |
Edycja i usuwanie mapowań
Jeśli w sklepie lub marketplace zmieniła się nazwa płatności albo przestała być używana, zaktualizuj odpowiedni wpis na liście mapowań.
Aby zmienić istniejące mapowanie, odszukaj je na liście i kliknij ikonę ołówka w kolumnie Działania. Po edycji zatwierdź zmiany. Jeśli wpis nie jest już potrzebny, możesz go usunąć, klikając ikonę kosza.
Warto przejrzeć mapowania zawsze po zmianach po stronie sklepu, marketplace albo ERP, szczególnie gdy pojawia się nowa metoda płatności.
Mapowania płatności w interfejsie xSale v1
Aby wprowadzić mapowania płatności dla integracji opartych o interfejs xSale v1, przejdź do zakładki Konfiguracja -> Ogólne -> Integracje. Przy integracji, którą chcesz edytować, kliknij przycisk Edycja mapowań.

Następnie uzupełnij dane w formularzu w sekcji Mapowanie form płatności.

- Sklep – wpisz nazwę płatności ze sklepu lub platformy sprzedażowej. Również tutaj znaczenie ma zgodność nazwy.
- ERP – podaj nazwę formy płatności utworzoną w xSale. Jeśli korzystasz z ERP, powinna to być taka nazwa, jaka ma być używana dalej w Twojej konfiguracji.
- Rejestr – uzupełnij pole wtedy, gdy dla tej płatności mają powstawać zapisy kasowe lub bankowe w ERP. W v1 podaje się rejestr i typ operacji w formacie REJESTR;TYP OPERACJI, np. KASA;KP.
Tak samo jak w starszej wersji wpisu, również tutaj możesz wykorzystać symbol * jako domyślne mapowanie dla płatności, które nie zostały dodane osobno.
| Ważne
Jeśli generujesz listy przewozowe w xSale, dla pobrań pamiętaj o wpisaniu odpowiedniej formy płatności także w konfiguracji kuriera, w polu Formy płatności przesyłek COD. W przeciwnym razie na etykiecie może nie zostać oznaczone pobranie. |