Statusy zamówień z marketplace — mapowanie w obie strony

Statusy jadą w obie strony i każda ma własne pułapki.

Krok po kroku — zmapowanie statusów nowego kanału

1. Wejdź w Integracje → Integracje → Moje integracje i otwórz połączenie.
2. Przejdź na etap Zamówienia i rozwiń sekcję Mapowanie statusów.
3. Zdobądź listę statusów kanału. Przy pustej tabeli masz do wyboru dwa przyciski:
   • Pobierz statusy — ściąga katalog z marketplace'u. Działa tylko dla części konektorów; reszta odpowie „Ta integracja nie udostępnia listy statusów — dodaj status ręcznie".
   • Dodaj status zewnętrzny — wpisujesz status sam. W oknie podaj Klucz statusu (marketplace) — surową wartość, np. 21 albo CANCELLED — oraz Nazwa wyświetlana. Zapisz przyciskiem Dodaj. To panel wysuwany z prawej, nie okno.
4. Gdy statusy zewnętrzne już są, kliknij Dodaj mapowanie.
5. W oknie Dodaj mapowanie statusu wybierz Status zewnętrzny (ten z marketplace'u) i Status wewnętrzny (twój). Oba pola są wymagane.
6. Zapisz. System poprosi o kod w oknie Wymagana weryfikacja 2FA (Potwierdzenie 2FA przy zmianach uprawnień).
7. Powtórz dla każdego statusu. Zacznij od tych, które zmieniają obsługę: anulowanie, zwrot, wysłane.
8. Przejrzyj gotową listę i poszukaj znacznika Push wyłączony: niejednoznaczne mapowanie. Znaczy on, że dwa statusy zewnętrzne wskazują na ten sam status wewnętrzny i wypychanie dla niego jest wyłączone — usuń nadmiarowe mapowanie.
9. Wróć do tej tabeli po kilku dniach pracy kanału i zmapuj to, co system zdążył sobie założyć. Gdy statusy zewnętrzne już istnieją, przycisk pobierania nazywa się Odśwież statusy.

Mapowanie usuwa się ikoną kosza przy wierszu; system pyta „Czy na pewno chcesz usunąć to mapowanie statusu?" i potwierdzasz przyciskiem Usuń.

Do nas: status marketplace → status wewnętrzny

Marketplace przysyła swój klucz statusu. System szuka go w tabeli mapowań i podstawia twój status.

Co się dzieje z kluczem, którego nie ma w tabeli:

System sam go zakłada i sam mapuje na status o nazwie default. Import nie zostaje przerwany i nikt nie dostaje powiadomienia.

To rozwiązanie ma sens — nowy status u marketplace'u nie zatrzyma sprzedaży. Ale ma skutek uboczny, który trzeba znać: status „anulowane" z nowego kanału wyląduje w default razem ze wszystkim innym, dopóki ktoś tego nie zmapuje.

Praktyka: po podłączeniu nowego kanału wróć do tabeli mapowań po kilku dniach i zmapuj to, co system zdążył sobie założyć.

Jeśli twój status wewnętrzny zostanie skasowany, mapowanie nie wybucha — zamówienia lecą do default, a w logu pojawia się ostrzeżenie.

Od nas: status wewnętrzny → status marketplace

Kierunek wypychania jest bardziej rygorystyczny:

• brak mapowania → nic nie jest wysyłane, ostrzeżenie w logu,
• więcej niż jedno mapowanie na ten sam status wewnętrzny → wypychanie jest pomijane w całości, z błędem w logu.

Ta druga sytuacja jest podstępna: dodanie „drugiego wariantu na wszelki wypadek" nie poszerza mapowania, tylko wyłącza je dla tego statusu.

Status po naszej stronie zapisuje się dopiero po udanym wypchnięciu. Jeśli marketplace odmówi, zamówienie nie dostanie fałszywej informacji, że wszystko poszło.

Pobranie listy statusów z marketplace

Jest przycisk pobierający katalog statusów wprost z kanału. Działa tylko dla części konektorów — reszta zwróci informację, że nie obsługuje tej operacji, i statusy trzeba wpisać ręcznie.

Operacja jest bezpieczna: niczego nie kasuje, tylko dokłada brakujące pozycje.

Gdzie to jest

Wyłącznie na etapie Zamówienia w konfiguracji połączenia, w sekcji Mapowanie statusów. Nie ma dla tego osobnego ekranu w menu. Zapis wymaga potwierdzenia 2FA (Potwierdzenie 2FA przy zmianach uprawnień).

To nie są statusy przesyłek

Statusy kurierskie to zupełnie osobny mechanizm, z własnymi słownikami (Słowniki statusów — zewnętrzne, wewnętrzne i mapowanie). Nie myl tych dwóch tabel.