# Własny magazyn

Własny magazyn w Ritevo: ręczne dodawanie produktów, cen i stanów, kilka magazynów naraz, reguły cen oraz dodawanie produktów przez API.

Własny magazyn to miejsce na produkty, które prowadzisz sam. Nic nie jest pobierane z zewnątrz - produkty, ceny i stany dodajesz w Ritevo albo przez API.

> **Wymagana integracja:** Nie potrzebujesz żadnego konta zewnętrznego.

Integracji Własny magazyn możesz dodać dowolnie wiele - każda ma własny komplet produktów, na przykład z innymi regułami cen. Każda działa osobno.

Unikalność nie jest sprawdzana, celowo: każde utworzenie integracji tworzy nową, także dla tego samego `externalId`, żeby jedno konto mogło mieć kilka integracji z różnymi danymi albo ustawieniami.

## Podłączenie konta

Zacznij w Ritevo:

1. Wejdź w **Integracje** w lewym panelu i kliknij **Dodaj integrację** w prawym górnym rogu.
2. W sekcji **Magazyny i hurtownie** wybierz kafelek **Własny magazyn**.
3. W polu **Nazwa konta** wpisz nazwę magazynu, na przykład „Magazyn główny”, i kliknij **Utwórz integrację**.

![Lista integracji w Ritevo z zaznaczonym przyciskiem Dodaj integrację w prawym górnym rogu](https://ritevo.com/docs/integrations/pl-integrations-list.webp)

![Ekran Dodaj integrację z zaznaczonym kafelkiem Własny magazyn w sekcji Magazyny i hurtownie](https://ritevo.com/docs/integrations/own-warehouse/pl-catalogue.webp)

![Ekran dodawania integracji Własny magazyn z polem Nazwa konta i przyciskiem Utwórz integrację](https://ritevo.com/docs/integrations/own-warehouse/pl-add.webp)

## Ustawienia integracji

Na stronie integracji znajdziesz poniższe pola. Zmiany zapisujesz przyciskiem **Zaktualizuj integrację**:

- **Nazwa konta** - Twoja własna nazwa integracji. Pod nią widzisz produkty w kolumnie **Integracja** na liście **Produkty**.
- **Reguły transformacji** - **Reguły cenowe** i **Reguły stanu**, które zmieniają każdą cenę i każdy stan tej integracji, na przykład doliczają marżę. Opis: [Pobieranie produktów](https://ritevo.com/pl/docs/products/fetching-products#rules).
- **Dodaj produkt** - przycisk w nagłówku strony. Otwiera formularz nowego produktu z wybraną już tą integracją.

![Szczegóły integracji Własny magazyn: nazwa konta, reguły transformacji oraz przyciski Dodaj produkt i Zaktualizuj integrację](https://ritevo.com/docs/integrations/own-warehouse/pl-details.webp)

Pola integracji: `accountName` i `transformationRules`. Tworzenie: `POST /integrations/warehouses/own` z `accountName`, zmiana: `PATCH /integrations/warehouses/own/{id}`. Własny magazyn nie ma `syncInterval`.

## Dodawanie produktów

Produkt dodajesz w menu **Produkty** albo na stronie integracji:

1. Kliknij **Dodaj produkt** i wybierz ten magazyn, jeśli nie jest już wybrany.
2. Uzupełnij **Dane podstawowe**, **Identyfikatory**, **Opis** i **Wymiary**. **Id zewnętrzne** możesz zostawić puste - jeśli podasz wartość, która już istnieje w tym magazynie, zaktualizujemy tamten produkt zamiast tworzyć nowy.
3. Kliknij **Zapisz produkt**.
4. W produkcie dodaj cenę przyciskiem **Dodaj cenę** i zapisz ją przyciskiem **Zapisz cenę**.
5. Dodaj stan przyciskiem **Dodaj stan** i zapisz przyciskiem **Zapisz stany**. Produkt może mieć kilka stanów, na przykład z różnych półek albo lokalizacji.

> **Warto wiedzieć:** Zapis jest zlecany w tle - zobaczysz komunikat **Zlecono utworzenie produktu** albo **Zlecono aktualizację produktu**, a zmiany pojawią się po chwili. Zdjęć nie da się dodać w aplikacji - podajesz je tylko przez API.

## Usunięcie integracji

**Usuń integrację** wyłącza integrację w Ritevo i zatrzymuje pobieranie. Produkty, ceny i stany zapisane wcześniej zostają na liście **Produkty**. **Przywróć integrację** włącza ją z powrotem.

## Czego integracja nie robi

- Nie importuje produktów z pliku - większe ilości dodasz przez API, do 1000 produktów w jednym zapytaniu.
- Nie zdejmuje ani nie rezerwuje stanów po sprzedaży - stan w Ritevo zmienia tylko pobranie z hurtowni albo Twoja edycja.
- Nie wysyła produktów, cen ani stanów do kanałów sprzedaży.

## Integracja przez API

Endpointy tej integracji są pod `/integrations/warehouses/own`, a wspólne dla całego typu (lista, pobranie jednej, usunięcie, przywrócenie) pod `/integrations/warehouses`. Produkty zapisujesz przez `PUT /integrations/warehouses/{integrationId}/products` (oraz `/prices`, `/stocks`) - szczegóły w [Pobieraniu produktów](https://ritevo.com/pl/docs/products/fetching-products#api). Aktualne ścieżki, pola, typy i kody odpowiedzi są zawsze w Swaggerze: https://api.ritevo.com/api/v1/api-docs.


---

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