Mapowania

Każdy sklep i marketplace ma własne nazwy: własne statusy zamówień, typy płatności, platformy sprzedażowe, sposoby dostawy i kurierów. Mapowanie mówi Complaia, któremu z Twoich statusów, metod płatności, źródeł zamówień i przewoźników odpowiada każda z tych nazw. Na tej samej karcie decydujesz też, który system prowadzi: czy zmiana statusu przechodzi ze sklepu do Complaia, z Complaia do sklepu, czy w ogóle nie przechodzi.

Gdzie to znaleźć: Integracje → Integracje → Lista integracji. Otwórz integrację: mapowania to sekcje na jej karcie

Kiedy z tego korzystasz

• Zaraz po podłączeniu sklepu, marketplace’u albo integratora, zanim przyjdą pierwsze prawdziwe zamówienia.
• Chcesz, żeby zmiany statusu wprowadzone w Complaia pojawiały się w sklepie, albo odwrotnie.
• Pobrane zamówienia mają metodę płatności Inne albo nieoczekiwane źródło zamówienia.
• Chcesz, żeby przy tworzeniu zlecenia logistycznego dla pobranego zamówienia podpowiadał się przewoźnik.
• Chcesz, żeby numery śledzenia pojawiały się na marketplace’ie pod właściwym kurierem.

Najważniejsze pojęcia

Jest pięć rodzajów mapowań. To, które sekcje widzisz, zależy od konektora. Integracje kurierskie nie mają żadnych.

Mapowanie	Co łączy	Konektory
Mapowanie statusów	Status zamówienia w drugim systemie → Twój status zamówienia	Allegro, Apilo, Base, WooCommerce, Shoper, PrestaShop
Mapowanie metod płatności	Typ płatności w drugim systemie → Twoja metoda płatności	Apilo, Base, WooCommerce, Shoper, PrestaShop
Mapowanie źródeł zamówień	Platforma sprzedażowa w integratorze → Twoje źródło zamówień	Apilo, Base
Sposób dostawy z platformy	Sposób dostawy w drugim systemie → Twój sposób wysyłki	Allegro, Apilo, Base, WooCommerce, Shoper, PrestaShop
Mapowanie przewoźników	Twój przewoźnik → kurier z listy marketplace’u	Allegro, Apilo, Base

• Mapowania należą do jednej integracji. Dwa osobno podłączone sklepy mapuje się osobno.
• Dodana para zapisuje się od razu. Nie ma przycisku Zapisz. Przed usunięciem pary pojawia się prośba o potwierdzenie.
• Każdą wartość z drugiego systemu można połączyć tylko raz. Status, typ płatności albo platforma, które mają już parę, znikają z listy. Twoja strona może się powtarzać: dwa statusy sklepu mogą wskazywać na Twój status Nowe.
• Mapowań wstrzymanej integracji nie da się zmieniać. Zamiast formularza dodawania pary sekcje pokazują notkę.

Kto ustala status i płatność zamówienia

Przy każdym marketplace’ie, integratorze i sklepie wybierasz, który system prowadzi. Wybór jest w sekcjach Statusy zamówień i Płatności zamówień na karcie integracji oraz w formularzu przy podłączaniu.

Pole Status zamówienia ustala ma trzy opcje:

Opcja	Co się dzieje
Każdy system osobno	Zmiany statusu nie przechodzą w żadną stronę. Nowe zamówienie zaczyna od Twojego statusu domyślnego.
Drugi system, na przykład Base	Każda zmiana statusu w drugim systemie trafia do Complaia zgodnie z mapowaniem statusów. Nowe zamówienie zaczyna od zmapowanego statusu. Zmiany wprowadzone w Complaia nie są wysyłane.
Complaia ERP (zalecane) — opcja z nazwą Complaia; ERP (enterprise resource planning) to system do zarządzania zasobami firmy	Każda zmiana statusu w Complaia trafia do drugiego systemu zgodnie z mapowaniem statusów. Nowe zamówienie zaczyna od zmapowanego statusu. Późniejsze zmiany wprowadzone w drugim systemie nie są pobierane. Nowa integracja zaczyna od tej opcji.

Płatność wybierasz podobnie:

• W Base pole Płatność zamówienia ustala ma te same trzy opcje. Base to jedyny system, który może przyjmować płatności z Complaia.
• W pozostałych systemach jest to przełącznik Przenoś zmiany płatności z … do Complaia ERP. Gdy jest włączony, każda zmiana zapłaconej kwoty w drugim systemie, na przykład wpłata, trafia do Complaia. Opłacone zamówienie nie wraca do nieopłaconego. Gdy jest wyłączony, płatność zostaje taka, jak w chwili pobrania zamówienia. Nowa integracja zaczyna z włączonym przełącznikiem.

Zawsze gdy status albo płatność ustala drugi system, zadanie w tle Zmiany w pobranych zamówieniach działa z interwałem pobierania zamówień. Sprawdza zamówienia już pobrane i przenosi zmiany. Zobacz Reguły integracji.

Bez mapowania statusów żaden status nie przechodzi w żadną stronę, niezależnie od wybranej opcji.

Co się dzieje bez mapowania

Brakuje	Skutek
Mapowania statusów	Żaden status nie przechodzi. Nowe zamówienie dostaje Twój status domyślny. Status z drugiego systemu nadal widać na zamówieniu jako informację.
Mapowania metod płatności	Zamówienie dostaje jedną z wbudowanych metod płatności, jeśli płatność do niej pasuje, na przykład Pobranie. W przeciwnym razie dostaje Inne. W Base zamówienie dostaje metodę płatności o tej samej nazwie co w Base, a Complaia dodaje ją do Twoich metod płatności.
Mapowania źródeł zamówień	Zamówienie trafia do własnego źródła zamówień integracji, nazwanego tak jak integracja.
Mapowania sposobów dostawy	Przy tworzeniu zlecenia logistycznego Complaia pokazuje tylko tekst sposobu dostawy i nie podpowiada przewoźnika.
Mapowania przewoźników	Allegro dostaje numer śledzenia jako „inny przewoźnik” i samo nie aktualizuje statusu paczki. Base w ogóle nie przyjmuje numeru, bo potrzebuje kuriera. Apilo dostaje numer bez kuriera.

Ekran

Mapowania to sekcje w lewej kolumnie karty integracji:

• Statusy zamówień — wybór, kto ustala status, a pod nim lista Mapowanie statusów. W Allegro, Apilo i Base sekcja ma przycisk Auto-mapuj.
• Płatności zamówień — wybór, kto ustala płatność, a pod nim lista Mapowanie metod płatności. Przycisk Auto-mapuj działa w WooCommerce i Apilo.
• Mapowanie źródeł zamówień — w Apilo i Base. Auto-mapuj działa w Apilo.
• Sposób dostawy z platformy.
• Numery śledzenia — przełącznik Automatyczne wysyłanie numerów śledzenia, a pod nim lista Mapowanie przewoźników.

Każda lista pokazuje już utworzone pary: wartość z drugiego systemu po lewej, Twoją po prawej i ikonę kosza do usuwania pary. Jeśli drugi system nie ma już jakiejś wartości, wiersz o tym informuje. Pod listą są dwa pola i przycisk Dodaj do tworzenia nowej pary.

Listy Twoich statusów, metod płatności, źródeł zamówień i przewoźników mają na dole odnośnik. Otwiera on ekran, na którym dodasz brakującą pozycję. Odnośnik widać tylko wtedy, gdy Twoja rola może zarządzać tą listą.

📷 Zrzut ekranu do dodania: karta integracji sklepu przewinięta do sekcji Statusy zamówień, z wyborem, kto ustala status, i dwiema parami statusów

Typowe zadania

Wybór, kto ustala status i płatność

1. Otwórz integrację i znajdź sekcję Statusy zamówień.
2. W polu Status zamówienia ustala wybierz opcję. Tekst pod polem wyjaśnia, co ona robi.
3. Potwierdź w oknie, które się otworzy:
   • Gdy wybierasz Complaia, okno mówi, że od teraz każda zmiana statusu będzie wysyłana do drugiego systemu.
   • Gdy wybierasz drugi system, okno mówi, ile otwartych, wcześniej pobranych zamówień dostanie teraz od niego status. Zamówienia zrealizowane i anulowane oraz zamówienia, którym status ustawiono ręcznie, zostają bez zmian. Dla tych zmian reguły się nie uruchamiają.
4. W sekcji Płatności zamówień w ten sam sposób ustaw wybór dla płatności albo przełącznik.

Jeśli wybierzesz opcję, która przenosi statusy, a integracja nie ma jeszcze mapowania statusów, ostrzeżenie poprosi o jego dodanie.

Mapowanie statusów zamówień

1. Otwórz integrację i znajdź sekcję Statusy zamówień.
2. W polu Status w integracji wybierz jeden ze statusów drugiego systemu. Lista pochodzi z tego systemu.
3. W polu Status wewnętrzny wybierz swój status zamówienia.
4. Kliknij Dodaj.
5. Powtórz dla każdego statusu, który chcesz wymieniać.

W Allegro, Apilo i Base przycisk Auto-mapuj łączy standardowe statusy drugiego systemu z Twoimi statusami wbudowanymi. Dodaje tylko brakujące pary i zostawia te, które utworzono ręcznie. Twoje własne statusy nie są łączone automatycznie.

Jeśli status ustala Complaia, a część zmian statusu nie dotarła do drugiego systemu, sekcja pokazuje, ile ich jest. Wyślesz je przyciskiem Synchronizacja zamówień z opcją Wyślij statusy do …. Zobacz Integracje → Pobieranie zamówień albo produktów od razu.

Mapowanie metod płatności

1. Otwórz integrację i znajdź sekcję Płatności zamówień.

2. W pierwszym polu wybierz albo wpisz typ płatności z drugiego systemu. To pole jest inne w każdym konektorze:

   Konektor	Pole	Co wpisać
   WooCommerce	Bramka płatności (slug)	Wybierz popularną bramkę z listy albo wpisz klucz bramki w takiej postaci, jakiej używa sklep
   Apilo	Typ płatności Apilo	Wybierz z listy pobranej z Apilo
   Shoper	ID płatności Shoper (payment_id)	Wpisz numer płatności ze sklepu
   PrestaShop	Moduł płatności PrestaShop (nazwa techniczna)	Wybierz popularny moduł, na przykład ps_wirepayment, albo wpisz nazwę techniczną modułu
   Base	Sposób płatności w Base	Wybierz spośród sposobów płatności zamówień już pobranych albo wpisz sposób dokładnie tak, jak widać go w Base

3. W polu Metoda płatności wybierz swoją metodę.

4. Kliknij Dodaj.

W WooCommerce i Apilo przycisk Auto-mapuj łączy typy płatności, których nazwy są identyczne z nazwami Twoich metod płatności. Sprawdź, co połączył, a resztę dodaj ręcznie. W pozostałych konektorach przycisk wyjaśnia, dlaczego nie może niczego dopasować.

Shoper i pobranie

Shoper nie przekazuje Complaia, że zamówienie jest za pobraniem. Complaia rozpoznaje to po nazwie metody płatności. Połącz płatność za pobraniem ze sklepu ze swoją metodą Pobranie.

Mapowanie źródeł zamówień

Integratory zbierają na jednym koncie zamówienia z kilku platform sprzedażowych. To mapowanie decyduje, które z Twoich źródeł zamówień dostają zamówienia z każdej platformy.

1. Otwórz integrację i znajdź sekcję Mapowanie źródeł zamówień.
2. Wybierz platformę:
   • Apilo — w polu Platforma Apilo wybierz z listy pobranej z Apilo.
   • Base — w polu Platforma sprzedażowa w Base wybierz spośród kont sprzedażowych Twojego konta Base. Jeśli lista jest pusta, wpisz numer konta.
3. W polu Źródło zamówienia wybierz swoje źródło.
4. Kliknij Dodaj.

W Apilo przycisk Auto-mapuj łączy każdą platformę, której nazwa jest identyczna z nazwą jednego z Twoich źródeł zamówień.

Mapowanie sposobów dostawy

Zamówienia ze sklepu albo marketplace’u niosą sposób dostawy wybrany przez klienta. To mapowanie zamienia go w podpowiedź przewoźnika przy tworzeniu zlecenia logistycznego dla zamówienia. Nie tworzy ani nie zmienia zleceń logistycznych.

1. Otwórz integrację i znajdź sekcję Sposób dostawy z platformy.
2. W polu Sposób dostawy w … wybierz sposób dostawy z drugiego systemu. Lista wypełnia się sama na podstawie zamówień już pobranych. W Apilo i Base możesz też wpisać dokładny tekst.
3. W polu Nasza wysyłka wybierz, jak to wysyłasz: transport własny, odbiór osobisty, inny przewoźnik, kurier z usługą albo jeden z Twoich przewoźników.
4. Kliknij Dodaj.

Mapowanie kurierów

Marketplace musi wiedzieć, do którego kuriera należy numer śledzenia.

1. Otwórz integrację i znajdź sekcję Numery śledzenia.
2. W polu Nasz przewoźnik wybierz, jak wysyłasz: Transport własny, Inny przewoźnik, podłączony kurier (InPost, DHL, DPD, FedEx) albo jeden z Twoich przewoźników. Opcji Odbiór osobisty nie da się wybrać, bo nie ma numeru śledzenia.
3. W polu Przewoźnik w … wybierz kuriera z listy samego marketplace’u.
4. Kliknij Dodaj.

Każdy z Twoich przewoźników może mieć jedną parę. Kilku Twoich przewoźników może wskazywać tego samego kuriera na marketplace’ie. Para dla jednego z Twoich przewoźników jest używana przy jego przesyłkach. Inny przewoźnik obejmuje pozostałe przesyłki wysłane metodą Inny przewoźnik.

Odsyłanie numerów śledzenia

Dostępne w Allegro, Apilo i Base.

1. Zmapuj kurierów.
2. W sekcji Numery śledzenia włącz Automatyczne wysyłanie numerów śledzenia i potwierdź. To samo ustawienie, pod tą samą nazwą, jest w formularzu połączenia.

Od tej chwili Complaia wysyła numer do integracji, z której przyszło zamówienie, gdy tylko przesyłka zamówienia go dostanie:

Sposób wysyłki	Wysyłany numer
Transport własny	Numer zlecenia logistycznego w Complaia
Podłączony kurier (InPost, DHL, DPD, FedEx)	Numer śledzenia nadany przez kuriera, gdy tylko Complaia go dostanie
Inny przewoźnik albo jeden z Twoich przewoźników	Numer śledzenia wpisany w zleceniu logistycznym
Odbiór osobisty	Nic, bo nic nie jedzie

Pamiętaj też, że:

• Numer jest wysyłany raz. Ponowny zapis albo odświeżenie zlecenia logistycznego nie wysyła go drugi raz.
• Jeśli kurier podaje numer później niż przy nadaniu, numer zostaje wysłany, gdy Complaia dostanie go po raz pierwszy. Kliknij Odśwież status u przewoźnika w zleceniu logistycznym, żeby pobrać go szybciej.
• Ostatnia próba pojawia się w sekcji Ostatnia synchronizacja na karcie integracji, w wierszu wysyłania numerów śledzenia, z numerem zamówienia i przyczyną, jeśli się nie udała.
• Gdy integracja jest wstrzymana, nic nie jest wysyłane. Numery z tego czasu zostaną wysłane po wznowieniu.

Usuwanie mapowania

1. Znajdź parę w jej sekcji.
2. Kliknij ikonę kosza na końcu wiersza.
3. Przeczytaj okno. Mówi, co zmieni się dla nowych zamówień. Potwierdź.

Para zostaje usunięta od razu. Zamówienia już pobrane zachowują swój status, źródło i metodę płatności. Usunięcie ostatniej pary statusów zatrzymuje całą wymianę statusów z tym systemem.

Gdy coś nie działa

Co widzisz	Dlaczego	Co zrobić
Zamiast przycisku Dodaj sekcje pokazują notkę	Integracja jest wstrzymana.	Wznów ją. Zobacz Integracje.
Lista Status w integracji jest pusta	Drugi system nie zwrócił swoich statusów. Dostęp wygasł albo konto, którego używa Complaia, nie może ich odczytać.	Kliknij Test połączenia na karcie połączenia.
Potrzebnego statusu nie ma na liście Status w integracji	Ma już parę.	Znajdź jego wiersz na liście i najpierw go usuń.
Wiersz mówi, że wartości nie ma już w drugim systemie	Status, typ płatności albo kurier zostały tam usunięte.	Usuń parę i dodaj nową.
Statusy nie przechodzą, choć wybrano, kto je ustala	Integracja nie ma mapowania statusów albo status nie ma pary.	Dodaj pary.
Klucz nie może zmieniać statusów w sklepie (ostrzeżenie w sekcji Statusy zamówień)	Klucz WooCommerce albo PrestaShop nie ma uprawnienia do zapisu.	Popraw uprawnienia klucza, a potem kliknij Test połączenia. Zobacz Konektory.
Nie znaleziono źródeł pasujących po nazwie.	Auto-mapuj nie znalazło źródła zamówień o identycznej nazwie.	Dodaj takie źródła w Źródłach zamówień albo połącz je ręcznie.
Nie znaleziono metod pasujących po nazwie.	Auto-mapuj nie znalazło metody płatności o identycznej nazwie.	Połącz je ręcznie.
Zamówienia przychodzą z metodą płatności Inne	Ich typ płatności nie ma pary i nie pasuje do żadnej wbudowanej metody.	Dodaj parę. Zamówienia pobrane od tej chwili dostaną Twoją metodę.
Zamówienia z integratora trafiają do własnego źródła integracji	Platforma sprzedażowa nie ma pary.	Dodaj parę.
Zamówienie za pobraniem z Shopera przychodzi jako zwykłe zamówienie	Jego metoda płatności nie jest rozpoznawana jako pobranie.	Zobacz uwagę o Shoperze w sekcji Mapowanie metod płatności.
Lista Sposób dostawy w … jest pusta	Nie pobrano jeszcze żadnego zamówienia ze sposobem dostawy.	Poczekaj na pierwsze zamówienie. W Apilo i Base możesz wpisać dokładny tekst.
Lista Przewoźnik w … jest pusta	Marketplace nie zwrócił swojej listy kurierów.	Kliknij Test połączenia i otwórz kartę jeszcze raz.
Numer śledzenia widać na Allegro, ale Allegro nie aktualizuje statusu paczki	Przewoźnik nie ma pary, więc numer poszedł jako „inny przewoźnik”.	Zmapuj kuriera.
Numer śledzenia przesyłki kurierskiej jeszcze nie dotarł na marketplace	Kurier nie przekazał jeszcze numeru do Complaia.	Otwórz zlecenie logistyczne i kliknij Odśwież status u przewoźnika.

Uprawnienia

Aby…	Potrzebujesz
Widzieć mapowania i ustawienia integracji	Integracje: Podgląd
Dodawać i usuwać pary, używać przycisku Auto-mapuj, zmieniać, kto ustala status i płatność, przełączać Automatyczne wysyłanie numerów śledzenia	Integracje: Zarządzanie

Zobacz też

• Konektory — który system obsługuje które mapowanie
• Reguły integracji — zmiany w pobranych zamówieniach i reguły statusów
• Statusy zamówień · Źródła zamówień · Metody płatności — Twoja strona każdej pary
• Przewoźnicy — twoi własni przewoźnicy
• Zlecenia logistyczne — skąd biorą się numery śledzenia