ENPołącz klienta AI z xSale i wskaż organizację. Sama rozmowa z AI nie daje dostępu do danych xSale. Podawaj konkretny cel, daty i identyfikatory. Przykładowe ID zastąp wartościami z własnej bazy.
Jak sformułować polecenie?
Podaj organizację, zakres danych i oczekiwany wynik. Zaznacz, czy chcesz tylko odczytać dane, przygotować plan, czy wykonać sprawdzoną zmianę. Gdy nie znasz ID, najpierw poproś o listę obiektów. Asystent powinien używać dokładnej nazwy organizacji zwróconej przez xSale.
„Pokaż moje organizacje xSale. Następnie dla wybranej organizacji pokaż pięć ostatnich zamówień sprzedaży z linkami do panelu. Tylko odczyt”.
Link do obiektu nie przełącza firmy w panelu xSale. Przed pracą w panelu sprawdź wybraną organizację.
Sprawdzanie zamówień
- „Pokaż pięć zamówień sprzedaży z wybranej organizacji”.
- „Pokaż szczegóły zamówienia o ID 123: status, dostawę, płatność i pozycje”.
- „Sprawdź historię zamówienia o ID 123. Pokaż ostatnie zmiany”.
- „Pokaż statusy, które można przypisać do zamówienia sprzedaży”.
Lista zamówień jest pobierana partiami, do 20 na wywołanie. Pierwsza strona nie jest pełną listą. Do policzenia zamówień lub wartości sprzedaży użyj podsumowania. Nie zlecaj sumowania kolejnych stron ani szczegółów zamówień.
Podsumowanie sprzedaży
„Podsumuj liczbę zamówień sprzedaży i wartość produktów netto oraz brutto za poprzedni miesiąc. Pokaż wyniki osobno dla każdej waluty i sprawdź kompletność sum”.
Możesz wskazać dziś, wczoraj, poprzedni miesiąc lub własny zakres dat. Daty od i do podaj razem, np. od 2026-09-01 do 2026-09-30. Pojedynczy zakres obejmuje maksymalnie 93 dni włącznie. Określenia względne odnoszą się do kalendarza Europe/Warsaw.
„Porównaj wrzesień i sierpień 2026. Pobierz osobne podsumowanie dla każdego miesiąca. Pokaż liczbę zamówień oraz wartości netto i brutto osobno dla każdej waluty”.
Przy ocenie wyniku pamiętaj:
- To podsumowanie zamówień sprzedaży, a nie raport wystawionych faktur lub otrzymanych płatności.
- Wartość produktów nie obejmuje dostawy.
- Waluty nie są przeliczane ani dodawane do jednej wspólnej sumy.
- Zamówienia anulowane nie są automatycznie pomijane. Możesz ograniczyć wynik do jednego wskazanego statusu.
- Brak pozycji, ilości lub ceny może dać niepełną sumę albo
null. FlagiproductValueNetCompleteiproductValueGrossCompletewskazują kompletność odpowiednich wartości. Nie traktuj niepełnej sumy jako pełnej sprzedaży.
Polecenie „Pokaż liczbę zamówień według statusów” daje inny wynik: liczniki obejmują wszystkie typy zamówień i daty zakupu. Nie przejmują filtrów listy i nie zastępują podsumowania sprzedaży.
Sprawdzanie ofert i towarów
- „Znajdź oferty z problemem synchronizacji w wybranym kanale. Pokaż pierwszą stronę wyników”.
- „Pokaż szczegóły oferty o ID 456 i jej kanały sprzedaży”.
- „Odczytaj nazwy i opisy oferty o ID 456 we wszystkich zapisanych językach”.
- „Sprawdź parametry oferty o ID 456 w wybranym kanale sprzedaży”.
- „Sprawdź powiązanie wariantu tej oferty z towarem xSale i porównaj EAN. Wyjaśnij różnice bez zmieniania powiązania”.
- „Pokaż pięć ofert z najwyższą synchronizowaną ceną w tym kanale, dla PLN. Szczegóły pobierz tylko dla tych ofert”.
Ranking cen wymaga wskazania kanału i waluty. Obejmuje cały przefiltrowany zbiór przed podziałem na strony. Szczegóły i logi są pobierane osobno, więc nie stanowią jednej migawki z rankingiem. Brak waluty w logu oznacza PLN, niezależnie od waluty rankingu.
Wyniki opisują dane xSale. Nie potwierdzają, że marketplace pokazuje już taką samą cenę, opis lub stan. Różny EAN sam w sobie nie dowodzi błędnego powiązania towaru.
Przygotowanie i zatwierdzenie zmiany
W zakresie dostępnych narzędzi i uprawnień możesz zmienić status zamówienia, nazwę lub opis oferty w jednym języku, parametry, aktywność kanału oraz galerię zdjęć.
- Wskaż organizację i konkretny obiekt.
- Poproś o odczyt obecnych danych i przygotowanie planu bez zapisu.
- Sprawdź obecną i proponowaną wartość, zakres operacji oraz możliwe usunięcia danych.
- Zleć zapis zaakceptowanego planu.
- Poproś o ponowny odczyt. Jeżeli zmiana uruchomiła synchronizację lub proces automatyczny, sprawdź także jego wynik.
„Dla zamówienia o ID 123 sprawdź dostępne statusy i przygotuj plan zmiany na W realizacji. Pokaż obecny i docelowy status. Na razie niczego nie zapisuj”.
Status musi być właściwy dla zamówienia sprzedaży. Jego zmiana może uruchomić procesy automatyczne. Zgodność typu statusu nie gwarantuje prawa do zapisu.
„Dla oferty o ID 456 odczytaj zapisane języki i przygotuj nowy polski opis na podstawie obecnych danych. Pokaż różnice. Zachowaj inne języki oraz format opisu. Nie zapisuj zmiany”.
Opis HTML i opis blokowy Allegro mają różne formaty. Zdjęcia użyte w opisie muszą mieć właściwe odwołania do galerii. Asystent powinien najpierw odczytać tłumaczenia i galerię.
„Przygotuj plan dezaktywacji wskazanego kanału oferty o ID 456. Pokaż dokładny kanał i jego obecny stan. Nie zapisuj”.
Aktywacja lub dezaktywacja dotyczy jednego kanału, a nie archiwizacji całej oferty.
„Odczytaj definicje i dozwolone wartości parametrów tej oferty w wybranym kanale. Przygotuj plan wskazanej zmiany. Pokaż, co zostanie zmienione lub usunięte. Nie zapisuj”.
Parametry własnej kategorii xSale i parametry kanału mają różne identyfikatory. Zastąpienie pełnego zestawu parametrów własnej kategorii usuwa pominięte wartości; pusta lista usuwa wszystkie parametry tej kategorii. MCP nie udostępnia katalogu definicji własnej kategorii.
Praca ze zdjęciami
- „Odczytaj galerię oferty o ID 456. Pokaż kolejność i identyfikatory zdjęć”.
- „Przygotuj plan przeniesienia wskazanego zdjęcia na pierwszą pozycję. Zachowaj pozostałe zdjęcia i pokaż pełną kolejność. Nie zapisuj”.
- „Przygotuj plan dodania tego pliku PNG do galerii oferty o ID 456. Nie dodawaj go jeszcze do opisu i nie zapisuj”.
Dodanie pliku do galerii nie dodaje go do opisu. Obsługiwane są JPEG i PNG do 20 MiB. Eksport zdjęć zależy od ustawień integracji. Kolejność galerii jest zapisywana kolejno, bez gwarancji transakcji dla całej listy.
Co oznacza plan i wynik zapisu?
Plan nie blokuje edycji przez innych użytkowników i nie jest zgodą na zapis. Jeśli dane zmieniły się od jego przygotowania, potrzebny może być nowy plan. Porównanie tokenu nie zapewnia atomowej kontroli wszystkich równoczesnych zmian.
Przyjęcie operacji przez API nie oznacza zakończenia synchronizacji ani procesów automatycznych. Gdy wynik ma stan outcomeUnknown lub wymaga ponownego odczytu, najpierw sprawdź bieżące dane. Nie ponawiaj automatycznie operacji, zwłaszcza dodania zdjęcia.