# Hurtownia Karm

Integracja Hurtowni Karm z Ritevo: pobieranie produktów, cen netto i stanów z oferty hurtowni, interwał synchronizacji i reguły cen.

Integracja z Hurtownią Karm pobiera do Ritevo ofertę hurtowni: produkty, ceny i stany. Nie podajesz żadnych danych logowania - ofertę udostępnia nam hurtownia.

> **Wymagana integracja:** Nie potrzebujesz klucza ani loginu. Wystarczy dodać integrację i wybrać, jak często pobierać ofertę.

Integracji Hurtownia Karm 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 **Hurtownia Karm**.
3. W polu **Nazwa konta** wpisz własną nazwę integracji i kliknij **Utwórz integrację**. W ciągu minuty zaczniemy pierwsze pobieranie oferty.

![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 Hurtownia Karm w sekcji Magazyny i hurtownie](https://ritevo.com/docs/integrations/hurtownia-karm/pl-catalogue.webp)

![Ekran dodawania integracji Hurtownia Karm z polem Nazwa konta i przyciskiem Utwórz integrację](https://ritevo.com/docs/integrations/hurtownia-karm/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**.
- **Interwał synchronizacji** - jak często pobieramy ofertę: **Nigdy**, **LIVE** (co godzinę), **Co 2 godziny** albo **Co 6 godzin**. Domyślnie **Nigdy** - wtedy oferta pobiera się tylko raz, zaraz po dodaniu. Więcej w [Pobieraniu produktów](https://ritevo.com/pl/docs/products/fetching-products#how-often).
- **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 Hurtownia Karm: nazwa konta, interwał synchronizacji LIVE oraz reguły cenowe i reguły stanu](https://ritevo.com/docs/integrations/hurtownia-karm/pl-details.webp)

Pola integracji: `accountName`, `syncInterval` (`NEVER`, `LIVE`, `EVERY_2H`, `EVERY_6H`) i `transformationRules`. Tworzenie: `POST /integrations/warehouses/hurtownia-karm` z `accountName`, zmiana: `PATCH /integrations/warehouses/hurtownia-karm/{id}`.

## Co pobieramy z hurtowni

- **Dane produktu** - nazwa, kod jako SKU, EAN-y (pierwszy jako EAN, kolejne jako dodatkowe EAN-y), opis, zdjęcia, producent, najdokładniejsza kategoria i waga. Wymiarów hurtownia nie podaje. Produkt bez kodu w ofercie pomijamy, bo SKU jest wymagane.
- **Cena** - cena netto ze stawką VAT i walutą z oferty.
- **Stan** - ilość w magazynie o nazwie „Hurtownia Karm”.
- **Aktywny** - produkt jest aktywny tylko wtedy, gdy hurtownia oznacza go jako aktywny, widoczny i dostępny do sprzedaży.

## 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 składa zamówień w hurtowni.
- Nie pobiera wariantów produktów ani ceny brutto.
- 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/hurtownia-karm`, a wspólne dla całego typu (lista, pobranie jednej, usunięcie, przywrócenie) pod `/integrations/warehouses`. Produkty są pod `/integrations/warehouses/products`. 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.