# Odejmowanie stanów po sprzedaży Odejmowanie stanów magazynowych po sprzedaży w Ritevo: przycisk w zamówieniu lub akcja automatyczna, brak stanu, stan poniżej zera i wynik przy pozycji. Kiedy coś sprzedasz, Ritevo samo nie zmniejsza stanu produktu w magazynie. Robisz to jednym kliknięciem w zamówieniu albo zlecasz to akcji automatycznej, na przykład po opłaceniu zamówienia. Poniżej wyjaśniamy, jak to zrobić, co się dzieje, gdy towaru jest za mało, i gdzie sprawdzić wynik. > **Wymagana integracja:** Potrzebujesz integracji magazynowej z kategorii **Magazyny i hurtownie**, na przykład [Własnego magazynu](https://ritevo.com/pl/docs/integrations/own-warehouse). Pozycje zamówienia muszą być powiązane z produktami - jak to zrobić, opisuje [Powiązanie ofert z produktami](https://ritevo.com/pl/docs/products/offer-links). ## Jak odjąć stan 1. Otwórz zamówienie, z którego chcesz odjąć stan. 2. Nad listą pozycji zamówienia kliknij przycisk **Odejmij stan magazynowy**. Rozwinie się lista z czterema opcjami. 3. Wybierz, co zrobić, jeśli jakiegoś produktu jest w magazynie za mało. Krótkie wyjaśnienie każdej opcji zobaczysz po najechaniu na ikonę informacji obok niej, a dokładny opis jest niżej. 4. Kliknięcie opcji od razu odejmuje stan - nie ma dodatkowego potwierdzenia. Po kilku sekundach przy każdej pozycji, w kolumnie **Odjęcie stanu**, pojawi się wynik. Żeby odejmować stan automatycznie, dodaj krok **Odejmij stan magazynowy** w [akcji dla zamówień](https://ritevo.com/pl/docs/automations/order-actions#steps) i wybierz w nim jedną z tych samych opcji. Krok działa dokładnie tak samo jak przycisk. ## Jak działa odejmowanie - **Tylko powiązane pozycje** - odejmujemy stan tylko tym pozycjom, które są powiązane z produktem. Pozycja bez powiązania zostaje bez zmian i dostaje status **Brak powiązania**. Jeśli powiążesz ją później i odejmiesz stan jeszcze raz, odejmą się ponownie wszystkie pozycje zamówienia - także te, które już były odjęte. - **Produkt usunięty albo nieaktywny** - takiej pozycji nie odejmujemy. Dostaje status **Pominięto - produkt usunięty** albo **Pominięto - produkt nieaktywny**. - **Każde kliknięcie odejmuje od nowa** - wcześniejsze odjęcia widać w historii pozycji, ale nie blokują kolejnego. Jeśli klikniesz dwa razy albo dwie akcje zrobią to samo, stan zmniejszy się dwa razy. - **Każda pozycja osobno** - w jednym zamówieniu jedna pozycja może się odjąć, a inna nie, na przykład gdy nie jest powiązana albo brakuje jej towaru. Jedyny wyjątek to opcja **Nie odejmuj niczego w zamówieniu**. - **Kilka stanów jednego produktu** - produkt może mieć kilka stanów, na przykład osobny dla każdego magazynu. Odejmujemy najpierw z największego, potem z kolejnych. Przykład: produkt ma dwa stany po 5 sztuk, a zamówienie jest na 10 - oba stany spadają do 0. Stany oznaczone jako usunięte pomijamy całkowicie: nie liczą się do dostępnej ilości i nigdy ich nie zmieniamy. - **Stan poniżej zera** - stan może spaść poniżej zera, jeśli wybierzesz **Odejmij mimo to (stan zejdzie poniżej zera)**. Taki produkt łatwo znajdziesz: na liście **Produkty** w kolumnie **Stan** liczba poniżej zera, na przykład **-1**, jest na czerwono. Nie myl tego z plakietką **Brak stanu** - ona oznacza produkt, który nie ma żadnego stanu. ## Gdy stanu nie wystarczy - **Odejmij mimo to (stan zejdzie poniżej zera)** (API: "Odejmij mimo to (stan zejdzie poniżej zera)" = `DEDUCT_ANYWAY`; wartość w `shortagePolicy`) - odejmujemy całą zamówioną ilość, nawet jeśli towaru jest za mało. Brakująca część zapisuje się jako minus na największym stanie. Przykład: dwa stany po 5 sztuk, zamówienie na 11 - jeden stan ma 0, drugi -1. Jeśli produkt nie ma żadnego stanu, nie ma od czego odjąć - zapisujemy tylko, ile brakowało. - **Odejmij tyle, ile jest (stan zatrzyma się na zerze)** (API: "Odejmij tyle, ile jest (stan zatrzyma się na zerze)" = `STOP_AT_ZERO`; wartość w `shortagePolicy`) - odejmujemy tylko tyle, ile jest w magazynie, a stan zatrzymuje się na 0. Ile zabrakło, zobaczysz w historii pozycji. - **Pomiń pozycję** (API: "Pomiń pozycję" = `SKIP_LINE_ITEM`; wartość w `shortagePolicy`) - pozycja, której brakuje towaru, zostaje bez zmian i dostaje status **Pominięto - za mało stanu**. Pozostałe pozycje odejmują się normalnie. - **Nie odejmuj niczego w zamówieniu** (API: "Nie odejmuj niczego w zamówieniu" = `CANCEL_DEDUCTION`; wartość w `shortagePolicy`) - jeśli choć jednej pozycji brakuje towaru, nie odejmujemy nic w całym zamówieniu. Ta pozycja dostaje status **Pominięto - za mało stanu**, a pozostałe **Anulowano - inna pozycja przerwała odejmowanie**. Przydaje się, gdy zamówienie ma się odjąć w całości albo wcale. > **Warto wiedzieć:** W nowym kroku akcji automatycznej od razu jest wybrane **Odejmij mimo to (stan zejdzie poniżej zera)**. W zamówieniu ta opcja jest pierwsza na liście. ## Wynik przy pozycji Po odjęciu przy każdej pozycji, w kolumnie **Odjęcie stanu**, widać wynik ostatniego odejmowania. Ikona obok otwiera **Historię odejmowania stanu**: wszystkie odejmowania tej pozycji z datą, ile odjęto, ile brakowało i ewentualny błąd. Wynik jest też w audycie zamówień. Co znaczą statusy: - **Odjęto** (API: "Odjęto" = `DEDUCTED`; wartość w `lineItems[].stockDeductions[].status`) - odjęliśmy całą zamówioną ilość. - **Odjęto, brakowało** (API: "Odjęto, brakowało" = `SHORTAGE`; wartość w `lineItems[].stockDeductions[].status`) - odjęliśmy, ale towaru było za mało. Zależnie od wybranej opcji brakująca część poszła na minus albo stan zatrzymał się na 0. - **Pominięto - za mało stanu** (API: "Pominięto - za mało stanu" = `SKIPPED_SHORTAGE`; wartość w `lineItems[].stockDeductions[].status`) - towaru było za mało, więc tej pozycji nie odjęliśmy. - **Brak powiązania** (API: "Brak powiązania" = `NOT_LINKED`; wartość w `lineItems[].stockDeductions[].status`) - pozycja nie jest powiązana z produktem. - **Pominięto - produkt usunięty** (API: "Pominięto - produkt usunięty" = `PRODUCT_DELETED`; wartość w `lineItems[].stockDeductions[].status`) - powiązany produkt jest usunięty. - **Pominięto - produkt nieaktywny** (API: "Pominięto - produkt nieaktywny" = `PRODUCT_INACTIVE`; wartość w `lineItems[].stockDeductions[].status`) - powiązany produkt jest nieaktywny. - **Anulowano - inna pozycja przerwała odejmowanie** (API: "Anulowano - inna pozycja przerwała odejmowanie" = `CANCELLED`; wartość w `lineItems[].stockDeductions[].status`) - tę pozycję dało się odjąć, ale innej zabrakło towaru przy opcji **Nie odejmuj niczego w zamówieniu**, więc w całym zamówieniu nic się nie odjęło. - **Błąd** (API: "Błąd" = `FAILED`; wartość w `lineItems[].stockDeductions[].status`) - odejmowanie się nie udało i nic nie zostało odjęte. Powód zobaczysz w historii pozycji. ## Kiedy stan się zmienia Stan produktu zmienia się tylko przy pozycjach ze statusem **Odjęto** albo **Odjęto, brakowało**. Dla Ritevo to zwykła zmiana stanu - taka sama jak po pobraniu z hurtowni - nawet jeśli liczba wyszła ta sama (na przykład stan już był 0). Czy pozycja powiązana z aktywnym produktem zmieni stan, zależy od wybranej opcji: - **Odejmij mimo to (stan zejdzie poniżej zera)** (API: "Odejmij mimo to (stan zejdzie poniżej zera)" = `DEDUCT_ANYWAY`; wartość w `shortagePolicy`) - zawsze zmienia stan. - **Odejmij tyle, ile jest (stan zatrzyma się na zerze)** (API: "Odejmij tyle, ile jest (stan zatrzyma się na zerze)" = `STOP_AT_ZERO`; wartość w `shortagePolicy`) - zawsze zmienia stan, najwyżej do 0. - **Pomiń pozycję** (API: "Pomiń pozycję" = `SKIP_LINE_ITEM`; wartość w `shortagePolicy`) - zmienia stan tylko wtedy, gdy towaru wystarczy dla tej pozycji. - **Nie odejmuj niczego w zamówieniu** (API: "Nie odejmuj niczego w zamówieniu" = `CANCEL_DEDUCTION`; wartość w `shortagePolicy`) - zmienia stan tylko wtedy, gdy towaru wystarczy dla wszystkich pozycji zamówienia. Stan na pewno się nie zmieni, gdy: - pozycja nie jest powiązana z produktem, - produkt jest usunięty albo nieaktywny, - brakuje towaru, a wybrałeś **Pomiń pozycję**, - choć jednej pozycji brakuje towaru, a wybrałeś **Nie odejmuj niczego w zamówieniu** - wtedy w całym zamówieniu nic się nie zmienia, - odejmowanie skończyło się błędem, - produkt nie ma żadnego stanu, - stan jest oznaczony jako usunięty. > **Warto wiedzieć:** W przygotowaniu są akcje automatyczne dla produktów. Dzięki nim zmianę stanu po odejmowaniu złapiesz akcją i na przykład zaktualizujesz ofertę w sklepie albo na marketplace. ## Czego jeszcze nie ma - Nie rezerwuje towaru - odejmuje stan od razu. - Nie odejmuje pojedynczej pozycji - każde użycie obejmuje całe zamówienie. - Nie oddaje stanu po anulowaniu ani zwrocie zamówienia - stan poprawisz ręcznie w produkcie. - Nie wysyła jeszcze zmienionych stanów do sklepów ani na marketplace. ## Odejmowanie przez API Ręcznie: `POST /orders/{orderId}/warehouse-stock-deduction` z ciałem `{shortagePolicy}` (wymagane), odpowiedź 202 - wynik przychodzi asynchronicznie. W akcji: krok `DEDUCT_WAREHOUSE_STOCK` z tą samą wartością `shortagePolicy` w `enumValue`, a wynik uruchamia wyzwalacz `DEDUCTED_WAREHOUSE_STOCK`. Wartości: **Gdy stanu nie wystarczy** (`shortagePolicy`) - **Odejmij mimo to** = `DEDUCT_ANYWAY` (cała ilość zawsze schodzi ze stanów; czego brakuje, idzie poniżej zera na największym stanie; wynik `DEDUCTED` albo `SHORTAGE`), **Odejmij tyle, ile jest** = `STOP_AT_ZERO` (schodzi tylko to, co jest, stany zatrzymują się na 0, brak tylko zapisany w `shortageQuantity`; wynik `DEDUCTED` albo `SHORTAGE`), **Pomiń pozycję** = `SKIP_LINE_ITEM` (pozycja bez wystarczającego stanu nie zmienia nic i dostaje `SKIPPED_SHORTAGE`, reszta odejmuje się normalnie), **Nie odejmuj niczego w zamówieniu** = `CANCEL_DEDUCTION` (jeśli choć jednej pozycji brakuje stanu, nic w zamówieniu nie jest odejmowane: ona dostaje `SKIPPED_SHORTAGE`, pozostałe `CANCELLED`). Gdy stanu wystarcza, wszystkie cztery działają tak samo (`DEDUCTED`). Produkt usunięty (`deleted`) albo nieaktywny (`active` = `false`) jest zawsze pomijany - pozycja dostaje `PRODUCT_DELETED` albo `PRODUCT_INACTIVE` i niczego nie przerywa. Każde wywołanie odejmuje ponownie, bez sprawdzania wcześniejszych. Stany z `deleted` = `true` są pomijane całkowicie, jakby nie istniały: nie liczą się do dostępnej ilości, nie są blokowane ani zapisywane i nigdy nie schodzą poniżej zera. Pozycję łączy z produktem jej `externalOfferId` w integracji zamówienia (powiązania: `/integrations/warehouses/external-offer-assignments`). Wynik: w `GET /orders/{id}` każda pozycja ma `stockDeductions` - historię wszystkich wykonań, najnowszy wpis na końcu, a aktualny wynik pozycji to ostatni wpis. Pola wpisu: `createdAt`, `status`, `warehouseProductId`, `requestedQuantity` (ilość z pozycji), `deductedQuantity` (ile zdjęto ze stanów dodatnich), `shortageQuantity` (ile brakowało - przy `DEDUCT_ANYWAY` zeszło poniżej zera na największym stanie, przy `STOP_AT_ZERO` tylko odnotowane, przy `SKIPPED_SHORTAGE` brak, przez który pozycję pominięto), `errorType` i `errorMessage` (tylko przy `FAILED`). Pozycja z ilością 0 dostaje `DEDUCTED` z zerami. Produkt bez żadnego stanu przy `DEDUCT_ANYWAY` dostaje `SHORTAGE` bez zmiany stanu. Przy `CANCEL_DEDUCTION` nic nie jest zapisywane: pozycje bez stanu mają `SKIPPED_SHORTAGE`, pozycje, które dałoby się odjąć, mają `CANCELLED`, a `NOT_LINKED`, `PRODUCT_DELETED` i `PRODUCT_INACTIVE` niczego nie przerywają. Stany zapisują tylko pozycje `DEDUCTED` i `SHORTAGE`: zapisywane są wszystkie stany ich produktów (także bez zmiany ilości, na przykład `STOP_AT_ZERO` przy stanie 0) i liczy się to jako zmiana stanu produktu, tak jak przy pobraniu z hurtowni. Wynik jest liczony per pozycja, więc w jednym zamówieniu jedna pozycja może zmienić stan, a inna nie (poza `CANCEL_DEDUCTION`). Przy błędzie całego odejmowania wszystkie pozycje mają `FAILED` z tym samym `errorType` i nic nie jest odjęte. Co dokładnie dzieje się w typowych przypadkach (jeden wynik na pozycję, dopisywany do `lineItems[].stockDeductions[]`): - Pozycja bez powiązania (brak `externalOfferId`, np. pozycja dodana ręcznie, albo oferta niepowiązana z produktem w integracji zamówienia): `NOT_LINKED`, `warehouseProductId` = `null`, ilości 0, żaden stan się nie zmienia. To nie jest błąd i nie przerywa pozostałych pozycji - także przy `CANCEL_DEDUCTION`. - Żadna pozycja nie jest powiązana (albo zamówienie nie ma integracji): odejmowanie i tak się wykonuje - każda pozycja dostaje `NOT_LINKED`, nic się nie zmienia, a wyzwalacz `DEDUCTED_WAREHOUSE_STOCK` i tak startuje, a krok akcji przechodzi dalej jak po sukcesie. - Naprawa braku powiązania: utwórz powiązanie (`POST /integrations/warehouses/external-offer-assignments` albo `POST /orders/{orderId}/line-items/{lineItemId}/warehouse-link`) i uruchom odejmowanie ponownie. Uwaga: ponowne uruchomienie odejmie od nowa także pozycje, które wcześniej dostały `DEDUCTED`/`SHORTAGE` - nie ma odejmowania pojedynczej pozycji. - Produkt usunięty albo nieaktywny: `PRODUCT_DELETED` / `PRODUCT_INACTIVE` z `warehouseProductId`, nic się nie zmienia, nic nie przerywa, niezależnie od `shortagePolicy`. - Produkt powiązany, ale bez żadnego stanu (lub tylko z usuniętymi stanami): przy `DEDUCT_ANYWAY` i `STOP_AT_ZERO` wynik `SHORTAGE` z `deductedQuantity` 0 i `shortageQuantity` = cała ilość, bez zmiany stanu; przy `SKIP_LINE_ITEM` `SKIPPED_SHORTAGE`; przy `CANCEL_DEDUCTION` `SKIPPED_SHORTAGE` i całe zamówienie `CANCELLED`. - Stan usunięty (`deleted` = `true`): nie jest czytany, blokowany ani zapisywany - odejmowanie działa tak, jakby go nie było. Produkt z samymi usuniętymi stanami zachowuje się jak produkt bez stanu. - Ten sam produkt na dwóch pozycjach: pozycje są liczone po kolei na tych samych stanach, więc druga widzi stan już pomniejszony przez pierwszą. - Pozycja z ilością 0 lub ujemną: `DEDUCTED` z zerami, stan bez zmian. - Błąd techniczny całego odejmowania: wszystkie pozycje `FAILED` z `errorType`/`errorMessage`, nic nie jest odjęte; zamówienie ma błąd w audycie, wyzwalacz `DEDUCTED_WAREHOUSE_STOCK` startuje, a krok akcji przechodzi dalej (jak po błędzie przesyłki). - Pozycja usunięta z zamówienia, zanim przyszedł wynik, nie dostaje wpisu; pozycja dodana w tym czasie też nie. - Każde uruchomienie (ręczne lub z akcji) dopisuje dokładnie jeden wpis każdej pozycji, którą zamówienie miało w chwili uruchomienia. --- Cała pomoc w jednym pliku: https://ritevo.com/llms-full.txt. Mapa pomocy z linkami do wszystkich stron: https://ritevo.com/llms.txt.