# Pobieranie zamówień

Jak Ritevo pobiera zamówienia z marketplace'ów i sklepów, jak często to robi i co zrobić, gdy zamówienia nie widać.

Ritevo samo sprawdza Twoje kanały sprzedaży i dopisuje nowe zamówienia do listy. Nie musisz nic importować ani odświeżać.

> **Wymagana integracja:** Potrzebujesz co najmniej jednej integracji typu **marketplace** (np. Allegro) albo **sklep internetowy** (np. Shoper). E-mail i komunikatory to kanały wiadomości, zamówień z nich nie pobieramy.

## Włączanie i wyłączanie pobierania

Pobieranie zamówień ustawiasz **osobno dla każdej integracji**. Po dodaniu nowej integracji jest ono **wyłączone** - dopóki go nie włączysz, z tego kanału nie pobieramy zamówień.

Żeby je włączyć:

1. Wejdź w **Integracje** i otwórz integrację, z której chcesz pobierać zamówienia.
2. Włącz przełącznik **Pobieranie zamówień**.
3. Zapisz zmiany.

![Przełącznik „Pobieranie zamówień" w ustawieniach integracji](https://ritevo.com/docs/orders/pl-fetch-orders-toggle.webp)

Od tej chwili sprawdzamy ten kanał mniej więcej co 10 minut. Pobieranie wyłączysz w każdej chwili tym samym przełącznikiem. Zamówienia pobrane wcześniej zostają w Ritevo, przestają tylko dochodzić nowe z tej integracji.

## Jak często sprawdzamy zamówienia

Każdą integrację sprawdzamy mniej więcej **co 10 minut**. Nowe zamówienie zobaczysz więc na liście najpóźniej kilkanaście minut po jego złożeniu.

Przy pierwszym pobraniu sięgamy **7 dni wstecz**, żeby lista nie startowała pusta. Starszych zamówień nie pobieramy.

## Gdzie zobaczysz pobrane zamówienie

Pobrane zamówienie od razu pojawia się w **tabeli zamówień**. Stamtąd je otwierasz i dalej prowadzisz w Ritevo.

> **Warto wiedzieć:** Wszystkie ceny, które widzisz w Ritevo - w zamówieniach, fakturach, paragonach i korektach - to ceny brutto. Wyjątkiem są produkty w magazynach, których ceny podajemy netto. Cenę netto liczymy z ceny brutto i stawki VAT: netto = brutto ÷ (1 + stawka VAT). Na przykład 123 zł brutto przy stawce 23% to 100 zł netto.

## Usługi dodatkowe

Część kanałów przekazuje usługi, które kupujący dokupił do zamówienia, na przykład pakowanie na prezent, wniesienie czy montaż. Każda usługa pojawia się jako osobna pozycja zamówienia - także gdy kosztuje 0,00 - więc widzisz ją przy obsłudze zamówienia i masz ją na fakturze.

- **Usługa przy produkcie** - zamiast zdjęcia ma ikonkę usługi i podpis **Usługa dodatkowa**, a produkt, z którym ją kupiono, ma znaczek z jej nazwą.
- **Usługa do całego zamówienia** - dotyczy całej paczki, a nie jednego produktu, i ma podpis **Usługa do całego zamówienia**.
- **Asystent pakowania** - usług nie pakujesz jako sztuk; widzisz je jako znaczki przy produkcie albo w osobnej karcie nad listą pozycji.

Gdy kanał nie przekazuje usług, możesz wystawić usługę jako osobną ofertę albo produkt, na przykład **Pakowanie na prezent**. Przyjdzie wtedy jako zwykła pozycja zamówienia - Ritevo nie oznaczy jej jako usługi, bo dostaje ją tak samo jak każdy produkt.

Czy dany kanał przekazuje usługi i które, sprawdzisz na stronie jego integracji, w części o zamówieniach.

Usługa to pozycja z `lineItems[].additionalService.additionalService` = `true`. Pole `additionalService.forLineItemId` wskazuje `id` pozycji produktu, z którym ją kupiono; `null` oznacza usługę do całego zamówienia. Zwykła pozycja ma `additionalService` = `false` i `forLineItemId` = `null`.

## Kto zarządza zamówieniem po pobraniu

To zależy od statusu zamówienia w Ritevo.

**Zamówienie jeszcze niepotwierdzone** (na przykład **Ocz. na płatność** albo **Ocz. na potwierdzenie**): jeśli w kanale sprzedaży coś się zmieni, na przykład klient opłaci zamówienie, Ritevo zaktualizuje je przy kolejnym sprawdzeniu. Nie powstaje drugie zamówienie.

**Zamówienie w statusie Potwierdzono**: od tej chwili zamówieniem zarządza Ritevo. Kolejne zmiany przychodzące z kanału sprzedaży **pomijamy**, żeby nie nadpisywały tego, co masz ustawione u siebie. Pomijamy między innymi:

- zmianę statusu zamówienia po stronie kanału sprzedaży,
- zmianę danych do faktury po stronie kanału sprzedaży,
- list przewozowy wygenerowany po stronie kanału sprzedaży.

Wszystko to prowadzisz już w Ritevo i to dane z Ritevo są obowiązujące.

> **Warto wiedzieć:** Zamówienie, które przyszło do Ritevo od razu jako **Potwierdzono**, jest chronione w ten sam sposób od pierwszej chwili.

## Zamówienia pojawiają się mimo wyłączonego pobierania

To nie błąd. Dzieje się tak, gdy dla integracji masz włączone [pobieranie wiadomości](https://ritevo.com/pl/docs/messages/fetching-messages).

W części integracji wiadomość, dyskusja albo reklamacja odnosi się do konkretnego zamówienia. Gdy taka wiadomość przyjdzie, Ritevo **samo dociąga to jedno zamówienie**, żebyś przy rozmowie z klientem od razu widział, czego ona dotyczy.

Dociągamy wtedy tylko zamówienia powiązane z wiadomościami. Pozostałe zamówienia z tego kanału nadal nie są pobierane, dopóki nie włączysz **Pobieranie zamówień**.

## Nie widzę zamówienia

> **Warto wiedzieć:** Najczęstsza przyczyna: integracja pokazuje **Wymaga ponownego połączenia**. Zwykle oznacza to, że dostęp, którego udzieliłeś Ritevo w kanale sprzedaży, wygasł albo został cofnięty - na przykład po zmianie hasła lub po upływie ważności połączenia. Dopóki nie połączysz integracji ponownie, zamówienia z tego kanału nie są pobierane.

Sprawdź po kolei:

1. Czy integracja jest **Aktywna**.
2. Czy ma włączone **Pobieranie zamówień** - po dodaniu integracji jest ono domyślnie wyłączone.
3. Czy minęło już kilkanaście minut od złożenia zamówienia.
4. Czy zamówienie nie jest starsze niż 7 dni sprzed dodania integracji.

## Statusy zamówienia i płatności przez API

Status zamówienia (`status`) przyjmuje jedną z wartości:

- **Potwierdzono** (API: "Potwierdzono" = `CONFIRMED`; wartość w `status`) - zamówienie przejęte przez Ritevo.
- **Anulowano** (API: "Anulowano" = `CANCELLED`; wartość w `status`) - zamówienie anulowane.
- **Ocz. na płatność** (API: "Ocz. na płatność" = `WAITING_FOR_PAYMENT`; wartość w `status`) - czeka na wpłatę.
- **Ocz. na potwierdzenie** (API: "Ocz. na potwierdzenie" = `WAITING_FOR_CONFIRMATION`; wartość w `status`) - czeka na Twoją decyzję; tu trafia też status sklepu bez mapowania.

Status płatności (`payment.paymentStatus`) jest osobny i Ritevo liczy go z kwot: brak kwoty zapłaconej (`paidAmount` = `null`) daje `WAITING_FOR_PAYMENT`; kwota równa sumie zamówienia daje `PAID`, wyższa `OVERPAID`, niższa `UNDERPAID`. Kwota `0.00` to wpłata zero, a nie brak wpłaty - przy niezerowej sumie daje `UNDERPAID`, przy sumie zero `PAID`.


---

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