# Powiązanie ofert z produktami Powiązanie oferty z kanału sprzedaży z produktem w magazynie Ritevo: jak to zrobić w zamówieniu, kiedy działa dla kolejnych zamówień i do czego służy. Każda pozycja zamówienia pochodzi z oferty w kanale sprzedaży, na przykład z aukcji na Allegro albo produktu w sklepie. Żeby Ritevo wiedziało, który produkt z Twojego magazynu to jest, wiążesz ofertę z produktem. Robisz to raz - potem działa dla każdego kolejnego zamówienia z tą ofertą. > **Wymagana integracja:** Potrzebujesz integracji z kategorii **Magazyny i hurtownie** z produktami - na przykład [Własnego magazynu](https://ritevo.com/pl/docs/integrations/own-warehouse) - i zamówień z kanału sprzedaży. ## Do czego służy powiązanie - **Asystent pakowania** - rozpoznaje skanowany kod po EAN-ie powiązanego produktu. Pozycja bez powiązania ma oznaczenie **Brak powiązania z magazynem**. - **Odejmowanie stanu** - przyciskiem albo akcją automatyczną odejmujesz stan powiązanego produktu. Pozycja bez powiązania dostaje status **Brak powiązania** i niczego nie zmienia. Więcej: [Odejmowanie stanów po sprzedaży](https://ritevo.com/pl/docs/products/stock-deduction). ## Jak powiązać ofertę z produktem 1. Otwórz zamówienie z tą ofertą. 2. Przy pozycji zamówienia kliknij ikonę łańcucha - po najechaniu pokazuje podpowiedź **Powiąż ofertę z produktem**. 3. W oknie wyszukaj produkt (filtry działają tak samo jak na liście **Produkty**) i kliknij go. 4. Sprawdź podgląd produktu i kliknij **Powiąż**. Jeśli to nie ten produkt, kliknij **Wybierz inny**. ## Jak działa powiązanie - **Raz dla oferty** - powiązanie zapisujemy dla oferty, a nie dla jednego zamówienia. Każde kolejne zamówienie z tą ofertą z tej samej integracji jest od razu powiązane z tym produktem. - **Osobno dla każdej integracji** - ta sama oferta na dwóch kontach (na przykład dwa konta Allegro) to dwie oferty. Każdą wiążesz osobno. - **Jeden produkt dla oferty** - oferta jest powiązana z jednym produktem. Jeden produkt może mieć za to wiele ofert, na przykład z różnych kanałów sprzedaży. - **Zmiana produktu** - kliknij ikonę łańcucha przy pozycji. Zobaczysz obecny produkt - kliknij **Wybierz inny**, wskaż nowy produkt i **Powiąż**, a w pytaniu o nadpisanie wybierz **Nadpisz** (albo **Zostaw**, jeśli się rozmyślisz). Nowy produkt obowiązuje dla tej oferty od teraz; wcześniejsze odjęcia stanu się nie zmieniają. - **Pozycja bez ikony łańcucha** - ikona nie pojawia się, gdy pozycja nie ma identyfikatora oferty. Tak bywa przy pozycji dodanej ręcznie - przy dodawaniu wpisz wtedy pole **Id oferty**. - **Na liście ofert Allegro** - oferty Allegro powiążesz też na liście ofert: w integracji Allegro, w zakładce **Zarządzanie ofertami**, kliknij ikonę łańcucha na karcie oferty. Oferta wystawiona z magazynu jest powiązana od razu. ## Czego jeszcze nie ma - Nie wiąże ofert z produktami automatycznie, na przykład po SKU albo EAN. - Powiązanie usuniesz w aplikacji tylko dla ofert Allegro - przyciskiem **Usuń powiązanie** na karcie oferty w **Zarządzaniu ofertami**. Dla pozostałych kanałów usunięcie jest dostępne przez API. - Nie wiąże jednej oferty z kilkoma produktami (zestawy). ## Powiązania przez API Id oferty (`externalOfferId`) to identyfikator oferty w kanale sprzedaży: weź go z marketplace'u lub sklepu albo z `lineItems[].externalOfferId` zamówienia z tą ofertą. Klucz powiązania to para `externalOfferId` + `integrationId` integracji sprzedażowej (`GET /integrations/marketplaces`, `GET /integrations/shops`); jedna para wskazuje jeden produkt, a jeden produkt może mieć wiele ofert. Utworzenie: `POST /integrations/warehouses/external-offer-assignments` z body `{integrationId, externalOfferId, warehouseProductId}` (id produktu z `GET /integrations/warehouses/products`). `externalOfferId` i `integrationId` nie są weryfikowane: nieznana wartość zapisuje się bez błędu i po prostu nie pasuje do żadnego zamówienia. Skrót dla pozycji zamówienia: `POST /orders/{orderId}/line-items/{lineItemId}/warehouse-link` z body `{warehouseProductId}` - ofertę i integrację bierzemy z pozycji i zamówienia. Odpowiedzi: 201 z powiązaniem (`id`, `integrationId`, `externalOfferId`, `warehouseProductId`, `createdBy`, `createdAt`), 404 - nie ma produktu (przy skrócie także zamówienia albo pozycji), 409 (`EXTERNAL_OFFER_ALREADY_ASSIGNED`) - oferta jest już powiązana (żeby zmienić produkt, najpierw usuń powiązanie), 422 (`EXTERNAL_OFFER_ID_REQUIRED`) - pozycja nie ma `externalOfferId` (tylko przy skrócie). Sprawdzenie wielu ofert naraz: `POST /integrations/warehouses/external-offer-assignments/resolve` z body `{integrationId, externalOfferIds}` (do 1000 id) zwraca `integrationId`, `externalOfferId` i pełny `product` dla powiązanych; oferta nieobecna w odpowiedzi nie jest powiązana. Powiązane produkty jednego zamówienia: `GET /orders/{orderId}/warehouse-products`. Lista powiązań firmy: `GET /integrations/warehouses/external-offer-assignments` (filtry `externalOfferId`, `integrationId`, `warehouseIntegrationId`, łączone przez AND, strona do 5000). Usunięcie: `DELETE /integrations/warehouses/external-offer-assignments/{id}` albo `DELETE /integrations/warehouses/external-offer-assignments?externalOfferId=...&integrationId=...` - brak powiązania to nie błąd (204). --- Cała pomoc w jednym pliku: https://ritevo.com/llms-full.txt. Mapa pomocy z linkami do wszystkich stron: https://ritevo.com/llms.txt.