# Błędy w aplikacji

Komunikaty błędów w Ritevo: co oznacza każdy błąd przy zamówieniach, dokumentach, przesyłkach, magazynie, wiadomościach i integracjach, i co zrobić.

Gdy operacja się nie uda, Ritevo pokazuje krótki komunikat. Poniżej wszystkie komunikaty pogrupowane według obszaru, z wyjaśnieniem, co oznaczają.

### Dane i zapytania

- **Błąd walidacji** (API: "Błąd walidacji" = `VALIDATION_ERROR`) - wysłane dane są niepełne albo mają zły format, na przykład puste wymagane pole albo za długi tekst. Popraw zaznaczone pola i zapisz jeszcze raz.
- **Nieprawidłowe żądanie** (API: "Nieprawidłowe żądanie" = `INVALID_REQUEST`) - zapytania nie da się odczytać, na przykład ma uszkodzoną treść.
- **Nieprawidłowa wartość** (API: "Nieprawidłowa wartość" = `INVALID_ENUM`) - wybrana wartość nie należy do dozwolonej listy.
- **Niewspierany format danych** (API: "Niewspierany format danych" = `UNSUPPORTED_MEDIA_TYPE`) - dane przyszły w formacie, którego Ritevo nie przyjmuje.
- **Nieprawidłowy parametr** (API: "Nieprawidłowy parametr" = `INVALID_PARAMETER`) - parametr zapytania ma złą wartość, na przykład identyfikator w złym formacie.
- **Brakujący parametr** (API: "Brakujący parametr" = `MISSING_PARAMETER`) - w zapytaniu brakuje wymaganego parametru.
- **Błąd wewnętrzny** (API: "Błąd wewnętrzny" = `INTERNAL_ERROR`) - błąd po stronie Ritevo. Spróbuj ponownie za chwilę; jeśli się powtarza, napisz do nas.

### Limity

- **Przekroczono limit** (API: "Przekroczono limit" = `LIMIT_EXCEPTION`) - osiągnięto limit, na przykład liczby integracji, akcji albo elementów w jednej operacji.

### Audyt

- **Nie znaleziono loga audytu** (API: "Nie znaleziono loga audytu" = `AUDIT_LOG_NOT_FOUND`) - wpis historii zmian nie istnieje albo należy do innej firmy.

### Akcje automatyczne

- **Błąd walidacji kroku akcji** (API: "Błąd walidacji kroku akcji" = `ACTION_STEP_VALIDATION`) - krok akcji jest niepełny albo ma niepoprawne ustawienia.
- **Nie znaleziono automatycznej akcji** (API: "Nie znaleziono automatycznej akcji" = `AUTOMATIC_ACTION_NOT_FOUND`) - akcja nie istnieje albo została usunięta.
- **Błąd walidacji warunku** (API: "Błąd walidacji warunku" = `CONDITION_VALIDATION`) - warunek akcji jest niepełny albo ma niepoprawną wartość.
- **Wykryto cykliczną zależność** (API: "Wykryto cykliczną zależność" = `CYCLIC_DEPENDENCY`) - zapisanie akcji spowodowałoby pętlę - akcje uruchamiałyby się nawzajem bez końca. Zmień wyzwalacz albo kroki.

### Integracje

- **Nie znaleziono integracji** (API: "Nie znaleziono integracji" = `INTEGRATION_NOT_FOUND`) - integracja nie istnieje, została usunięta albo należy do innej firmy.
- **Nie znaleziono integracji AI** (API: "Nie znaleziono integracji AI" = `AI_INTEGRATION_NOT_FOUND`) - wskazana integracja AI nie istnieje albo została usunięta.
- **Nieprawidłowy model** (API: "Nieprawidłowy model" = `INVALID_MODEL`) - wybrany model AI nie jest dostępny u tego dostawcy albo na Twoim koncie.
- **Nieprawidłowy token** (API: "Nieprawidłowy token" = `INVALID_TOKEN`) - dostawca AI odrzucił podany klucz API. Sprawdź klucz w panelu dostawcy.

### Dokumenty

- **Dokument rozliczeniowy już istnieje** (API: "Dokument rozliczeniowy już istnieje" = `BILLING_ALREADY_EXISTS`) - dla tego zamówienia jest już taki dokument.
- **Dokument już został przeniesiony** (API: "Dokument już został przeniesiony" = `BILLING_ALREADY_TRANSFERRED`) - dokument został już wysłany do integracji księgowej i nie można go zmienić.
- **Nie znaleziono zewnętrznego transferu** (API: "Nie znaleziono zewnętrznego transferu" = `BILLING_EXTERNAL_TRANSFER_NOT_FOUND`) - nie ma zapisu wysyłki tego dokumentu do integracji księgowej.
- **Dokument ma już korektę** (API: "Dokument ma już korektę" = `BILLING_HAS_CORRECTION`) - do tego dokumentu wystawiono już korektę.
- **Dokument nie ma korekty** (API: "Dokument nie ma korekty" = `BILLING_HAS_NO_CORRECTION`) - operacja wymaga korekty, a dokument jej nie ma.
- **Nie znaleziono pozycji dokumentu** (API: "Nie znaleziono pozycji dokumentu" = `BILLING_LINE_ITEM_NOT_FOUND`) - wskazana pozycja nie istnieje w dokumencie.
- **Nie znaleziono dokumentu rozliczeniowego** (API: "Nie znaleziono dokumentu rozliczeniowego" = `BILLING_NOT_FOUND`) - dokument nie istnieje albo należy do innej firmy.
- **Nie znaleziono dokumentów rozliczeniowych** (API: "Nie znaleziono dokumentów rozliczeniowych" = `BILLINGS_NOT_FOUND`) - nie znaleziono żadnego z wybranych dokumentów.
- **Nie znaleziono ustawień dla typu rozliczenia** (API: "Nie znaleziono ustawień dla typu rozliczenia" = `BILLING_SETTINGS_BY_BILLING_TYPE_NOT_FOUND`) - brakuje ustawień dla tego rodzaju dokumentu, na przykład numeracji dla paragonów.
- **Nie znaleziono ustawień rozliczenia** (API: "Nie znaleziono ustawień rozliczenia" = `BILLING_SETTINGS_NOT_FOUND`) - wskazane ustawienia dokumentów nie istnieją.
- **Błąd referencji ustawień rozliczenia** (API: "Błąd referencji ustawień rozliczenia" = `BILLING_SETTINGS_REFERENCE`) - tych ustawień nie da się usunąć, bo są już na nich wystawione dokumenty.
- **Nie można usunąć domyślnych ustawień** (API: "Nie można usunąć domyślnych ustawień" = `DEFAULT_BILLING_SETTINGS_DELETION`) - domyślnych ustawień dokumentów nie da się usunąć.
- **Podany dokument nie jest wspierany przez tę integrację** (API: "Podany dokument nie jest wspierany przez tę integrację" = `BILLING_TYPE_NOT_SUPPORTED`) - wybrana integracja nie wystawia tego rodzaju dokumentu, na przykład korekty albo paragonu.
- **Stawka podatku nie jest wspierana** (API: "Stawka podatku nie jest wspierana" = `TAX_RATE_NOT_SUPPORTED`) - integracja nie obsługuje stawki VAT z tej pozycji.

### Zamówienia

- **Nie znaleziono zamówień** (API: "Nie znaleziono zamówień" = `ORDERS_NOT_FOUND`) - nie znaleziono żadnego z wybranych zamówień.
- **Nie znaleziono zamówienia** (API: "Nie znaleziono zamówienia" = `ORDER_NOT_FOUND`) - zamówienie nie istnieje albo należy do innej firmy.
- **Nie znaleziono pozycji zamówienia** (API: "Nie znaleziono pozycji zamówienia" = `ORDER_LINE_ITEM_NOT_FOUND`) - wskazana pozycja nie istnieje w zamówieniu.
- **Zamówienie nie jest kompatybilne z wybraną integracją lub metodą wysyłki** (API: "Zamówienie nie jest kompatybilne z wybraną integracją lub metodą wysyłki" = `ORDER_AND_SHIPPING_COMPATIBILITY`) - przesyłki nie da się utworzyć tą integracją, na przykład zamówienie z innego konta Allegro niż to podłączone do Wysyłam z Allegro.

### Przesyłki i paczki

- **Nie znaleziono przesyłki** (API: "Nie znaleziono przesyłki" = `SHIPMENT_NOT_FOUND`) - przesyłka nie istnieje albo należy do innego zamówienia.
- **Ilość w paczce przekracza ilość z zamówienia** (API: "Ilość w paczce przekracza ilość z zamówienia" = `PACKAGE_QUANTITY_EXCEEDED`) - do paczki dodano więcej sztuk, niż jest w zamówieniu.
- **Etykieta nie pasuje do żadnej przesyłki zamówienia** (API: "Etykieta nie pasuje do żadnej przesyłki zamówienia" = `PACKAGE_LABEL_NOT_FOUND`) - zeskanowana etykieta nie należy do przesyłek tego zamówienia.
- **Etykieta została już użyta w innej paczce** (API: "Etykieta została już użyta w innej paczce" = `PACKAGE_LABEL_ALREADY_USED`) - tę etykietę przypisano już do innej paczki.

### Produkty i magazyn

- **Nie znaleziono produktu** (API: "Nie znaleziono produktu" = `PRODUCT_NOT_FOUND`) - produkt nie istnieje albo należy do innej firmy.
- **Produkt o tym SKU już istnieje** (API: "Produkt o tym SKU już istnieje" = `PRODUCT_SKU_ALREADY_EXISTS`) - w magazynie jest już produkt z tym samym SKU.
- **Nie znaleziono stanu magazynowego** (API: "Nie znaleziono stanu magazynowego" = `STOCK_NOT_FOUND`) - dla produktu nie ma zapisanego stanu.
- **Stan magazynowy nie pasuje do produktu** (API: "Stan magazynowy nie pasuje do produktu" = `STOCK_PRODUCT_MISMATCH`) - wskazany stan należy do innego produktu.
- **Nie znaleziono ceny** (API: "Nie znaleziono ceny" = `PRICE_NOT_FOUND`) - dla produktu nie ma zapisanej ceny.
- **Cena już istnieje** (API: "Cena już istnieje" = `PRICE_ALREADY_EXISTS`) - produkt ma już cenę, którą próbujesz dodać.
- **Pozycja nie ma identyfikatora oferty** (API: "Pozycja nie ma identyfikatora oferty" = `EXTERNAL_OFFER_ID_REQUIRED`) - pozycji zamówienia nie da się powiązać z produktem, bo kanał sprzedaży nie przekazał numeru oferty.
- **Oferta jest już powiązana z innym produktem** (API: "Oferta jest już powiązana z innym produktem" = `EXTERNAL_OFFER_ALREADY_ASSIGNED`) - ta oferta jest już przypisana do innego produktu w magazynie.

### Statusy

- **Nie znaleziono statusu** (API: "Nie znaleziono statusu" = `STATUS_NOT_FOUND`) - status nie istnieje albo został usunięty.
- **Błąd operacji na statusie** (API: "Błąd operacji na statusie" = `STATUS_OPERATION`) - tej operacji nie da się wykonać, na przykład usunąć statusu domyślnego albo zastąpić statusu nim samym.

### Wiadomości

- **Nie znaleziono wiadomości** (API: "Nie znaleziono wiadomości" = `MESSAGE_NOT_FOUND`) - wątek nie istnieje albo należy do innej firmy.
- **Nie znaleziono wiadomości** (API: "Nie znaleziono wiadomości" = `MESSAGES_NOT_FOUND`) - nie znaleziono żadnego z wybranych wątków.
- **Błąd operacji na wiadomości** (API: "Błąd operacji na wiadomości" = `MESSAGE_OPERATION`) - tej operacji nie da się wykonać dla tego typu wątku, na przykład zakończyć reklamacji w zwykłej wiadomości.
- **Nie znaleziono szablonu wiadomości** (API: "Nie znaleziono szablonu wiadomości" = `MESSAGE_TEMPLATE_NOT_FOUND`) - szablon nie istnieje albo został usunięty.
- **Integracja nie obsługuje wiadomości** (API: "Integracja nie obsługuje wiadomości" = `MESSAGES_NOT_SUPPORTED`) - ten kanał nie ma wiadomości.
- **Wiadomości tej integracji obsługujesz przez e-mail** (API: "Wiadomości tej integracji obsługujesz przez e-mail" = `MESSAGES_SUPPORTED_BY_EMAIL`) - kupujący piszą e-mailem - obsłużysz ich przez integrację e-mail.
- **Ta integracja nie wspiera odpowiadania na wiadomości** (API: "Ta integracja nie wspiera odpowiadania na wiadomości" = `MESSAGE_REPLY_NOT_SUPPORTED`) - w tym kanale albo typie wątku nie da się odpowiedzieć z Ritevo.
- **Ta integracja nie wspiera dodawania załączników** (API: "Ta integracja nie wspiera dodawania załączników" = `MESSAGE_ATTACHMENT_UPLOAD_NOT_SUPPORTED`) - ten kanał nie przyjmuje załączników w odpowiedziach.
- **Ta integracja nie wspiera pobierania załączników** (API: "Ta integracja nie wspiera pobierania załączników" = `MESSAGE_ATTACHMENT_DOWNLOAD_NOT_SUPPORTED`) - plik otworzysz tylko w panelu kanału sprzedaży.
- **Wiadomość jest za długa** (API: "Wiadomość jest za długa" = `MESSAGE_LENGTH_EXCEEDED`) - odpowiedź przekracza 2000 znaków.

### Inne

- **Błąd zewnętrznego dostawcy** (API: "Błąd zewnętrznego dostawcy" = `EXTERNAL_EXCEPTION`) - kanał sprzedaży, kurier albo inny dostawca odrzucił operację. Treść błędu od dostawcy zobaczysz w komunikacie.
- **Nieoczekiwany błąd** (API: "Nieoczekiwany błąd" = `UNEXPECTED`) - coś poszło nie tak po stronie Ritevo. Spróbuj ponownie; jeśli się powtarza, napisz do nas.

## Błędy w API

Błędy API mają format Problem Details (RFC 9457) i zwracają trzy pola:

- `code` - jeden z kodów błędów opisanych wyżej.
- `title` - krótki tytuł błędu.
- `detail` - zwykle szczegółowy opis tego, co poszło nie tak w danym zapytaniu.


---

Cała pomoc w jednym pliku: https://ritevo.com/llms-full.txt. Mapa pomocy z linkami do wszystkich stron: https://ritevo.com/llms.txt.