Tylko w tym tygodniu: 50% zniżki na pierwsze 3 miesiące Pro i Business przy płatności miesięcznej. Do 25 października 2026. Zobacz cenyW tym tygodniu: Pro i Business 3 miesiące za pół ceny

PL
Zaloguj się Wypróbuj za darmo
Menu
Funkcje
Zobacz funkcje
Zasoby Wszystkie darmowe narzędzia
Poradnik Wszystkie artykuły
Wypróbuj za darmo

Dokumentacja techniczna

Integracja z Kaufland Seller API

Sellgrip działa na twoich własnych kluczach do Kaufland Seller API. Tu widzisz, co robi w twoim sklepie i jakiego endpointu używa na każdym kroku.

Połączenie

Sellgrip działa na twoich własnych kluczach do Kaufland Seller API. Każda zmiana, którą wprowadza Sellgrip, to wywołanie API.

Dostęp Twoje własne klucze do Kaufland Seller API: Client Key i Secret Key z Seller Portalu. Wpisujesz je w panelu Sellgripa.
Uwierzytelnianie Każde żądanie jest podpisywane HMAC kluczem Secret Key.
User agent Sellgrip/1.0.0 (+https://sellgrip.com)
Kanały sprzedaży DE, AT, CZ, SK, PL, FR, IT, ES i NL. Zobacz wszystkie dziewięć krajów.
Waluty Ceny w walucie danego kanału: EUR, CZK lub PLN. Przeliczenia według kursów Europejskiego Banku Centralnego.
Synchronizacja Nowe zamówienie od razu, gdy przyjdzie powiadomienie push z Kauflandu. Wszystkie zamówienia z każdego kanału dla pewności co 15 minut. Magazyny, grupy wysyłkowe i raporty codziennie, drzewo kategorii co tydzień.
Powiadomienia push Sellgrip rejestruje je automatycznie przy połączeniu: order_new, order_unit_new, order_unit_status_changed, return_new, return_status_changed, return_unit_status_changed, item_unit_out_of_stock, item_unit_not_available, item_unit_available, item_unit_deleted.
Zapis Każda zmiana idzie przez API. Sellgrip nie używa plików ORDER-Command.
Klucze API Zaszyfrowane algorytmem AES-256-GCM. Po wpisaniu nie są już wyświetlane, a usuwamy je, gdy tylko odłączysz konto lub je usuniesz.
Lokalizacja danych Tylko w centrach danych w Unii Europejskiej. Przetwarzanie reguluje umowa powierzenia zgodnie z art. 28 RODO.

Zamówienia

Sellgrip odczytuje twoje zamówienia z każdego kanału i każdą zmianę zapisuje z powrotem przez API.

Co robi Sellgrip Kaufland Seller API
Odczyt nowego zamówienia od razu, gdy przyjdzie powiadomienie push z Kauflandu. Odczyt wszystkich zamówień i pozycji zamówień z każdego kanału dla pewności co 15 minut. GET /order-units
GET /orders
Oznaczenie jako wysłane z przewoźnikiem i numerem przesyłki. Przewoźnicy pochodzą z listy Kauflandu. PATCH /order-units/{id}/send
GET /carriers
Kilka paczek na jedną pozycję zamówienia. POST /shipments
Oznaczenie wielu pozycji zamówień jako wysłanych w jednym kroku. PATCH /order-units/{id}/send
Etykiety wysyłkowe GLS. POST /shipping-labels
Anulowanie pojedynczych artykułów ze wszystkimi powodami anulowania, które stosuje Kaufland. PATCH /order-units/{id}/cancel
Częściowy zwrot pieniędzy za pojedyncze artykuły. PATCH /order-units/{id}/refund
Odczyt, tworzenie i zmiana zwrotów. GET /returns
POST /returns
PUT /returns/{id}
Akceptacja, odrzucenie, naprawa lub wyjaśnienie pozycji zwrotów. PATCH /return-units/{id}/accept
PATCH /return-units/{id}/reject
PATCH /return-units/{id}/repair
PATCH /return-units/{id}/clarify
Faktury wgrywasz sam albo wgrywają się automatycznie po wysyłce. POST /order-invoices/{id_order}
Fulfillment by Kaufland: Sellgrip odczytuje też takie pozycje zamówień, zwroty i zgłoszenia oraz je oznacza. Wysyłka, anulowanie, etykiety i decyzje o zwrotach zostają po stronie Kauflandu. GET /order-units
GET /returns
GET /return-units
GET /tickets
fulfillment_type

Oferty

Sellgrip wysyła zmiany ofert pole po polu: do Kauflandu trafia tylko to, co się zmieniło.

Co robi Sellgrip Kaufland Seller API
Tworzenie oferty w każdym stanie produktu, który zna Kaufland. POST /units
Zmiana ceny, stanu magazynowego, czasu realizacji, statusu, magazynu, grupy wysyłkowej i ceny minimalnej. PATCH /units/{id}
POST /units/bulk
Usuwanie oferty. DELETE /units/{id}
Status oferty z powodami podanymi przez Kaufland. POST /units/status
Ta sama zmiana dla tego samego produktu we wszystkich twoich kanałach sprzedaży, z przeliczeniem waluty. PATCH /units/{id}
Reguły cenowe: jako propozycja lub automatycznie, nigdy poniżej twojego progu rentowności. PATCH /units/{id}
Synchronizacja stanów z wgranego pliku CSV lub z feedu https, w odstępach od 15 minut do 24 godzin, z rezerwą dla całego konta lub dla pojedynczych artykułów. PATCH /units/{id}
POST /units/bulk
Magazyny i grupy wysyłkowe, odczytywane codziennie. GET /warehouses
GET /shipping-groups

Dane produktów

Sellgrip zapisuje dane produktów według języka i kanału, a obok pokazuje odpowiedź Kauflandu.

Co robi Sellgrip Kaufland Seller API
Zapis danych produktów według języka i kanału sprzedaży. PUT /product-data
PATCH /product-data
Status i odpowiedź Kauflandu dla każdego EAN, także z raportów invalid-items i product-data-changes. GET /product-data/status/{ean}
Wybór kategorii spośród kategorii Kauflandu. Drzewo kategorii jest odczytywane co tydzień. POST /categories/decide
GET /categories
GET /categories/tree
Obowiązkowe atrybuty są oznaczone. Dodatkowe atrybuty Kauflandu dodajesz według nazwy. GET /attributes/search
GET /attributes/by-name/{name}
Kilka zdjęć na produkt i na kanał sprzedaży. PATCH /product-data
Opcjonalnie: automatyczne przenoszenie wartości niezależnych od języka do twoich pozostałych języków. PATCH /product-data
Import z CSV lub z feedu, co godzinę lub codziennie, z przypisaniem kolumn do atrybutów. Wysyłane są tylko zmienione wiersze. PATCH /product-data
Nowy EAN: najpierw utworzenie danych produktu, potem wystawienie oferty. PUT /product-data
POST /units

Zgłoszenia

Obsługa klienta na Kauflandzie działa przez zgłoszenia. Sellgrip odczytuje je i obsługuje przez API.

Co robi Sellgrip Kaufland Seller API
Odczyt zgłoszeń i wiadomości z powodem i tematem. Załączniki od Kauflandu możesz pobrać. GET /tickets
GET /tickets/{id}
Odpowiedź z załącznikami. POST /tickets/{id}/messages
Otwarcie zgłoszenia z poziomu zamówienia. POST /tickets
Zamknięcie zgłoszenia. PATCH /tickets/{id}/close

Raporty

Te raporty Kauflandu Sellgrip odczytuje raz dziennie:

  • lost-buybox
  • buybox-opportunity
  • price-competitiveness
  • competitors-comparer
  • account-listing
  • invalid-items
  • product-data-changes
  • bookings-new
  • sales-new
  • cancellations

API Sellgripa

Twój sklep, system magazynowy lub ERP wysyła stany i dane produktów do Sellgripa, gdy tylko się zmienią. Sellgrip od razu przekazuje je do Kauflandu; API Sellgripa jest w planie Business.

Co robisz API Sellgripa
Klucz tworzysz w Ustawieniach › Klucze API: tylko właściciel, z potwierdzeniem hasłem. Uprawnienia stock:write i product-data:write, ważny do unieważnienia, 90 dni lub rok. Sellgrip pokazuje klucz tylko raz; każde wywołanie wysyła go w nagłówku. Authorization: Bearer sgk_…
Test klucza: odpowiedź podaje twoje konto i uprawnienia klucza. GET /api/v1/ping
Wysyłka stanów jako JSON lub CSV, do 1000 artykułów na wywołanie. Sellgrip zapisuje je w Kauflandzie przez POST /units/bulk jeszcze przed odpowiedzią i zatrzymuje twoją rezerwę. POST /api/v1/stock
Wysyłka danych produktów według EAN i języka, do 100 artykułów na wywołanie, sprawdzanych tymi samymi regułami co formularz Dane produktów. Pierwsze 20 trafia do Kauflandu przed odpowiedzią, reszta w kolejnych rundach co 15 minut. POST /api/v1/product-data
Stan artykułu: w kolejce, wysłany lub odrzucony z komunikatem Kauflandu, do tego ostatni stan zgłoszony przez Kaufland. GET /api/v1/product-data/{ean}
Odczyt dla asystentów AI: z kluczem z uprawnieniem read Claude Desktop, Claude Code i inni klienci MCP pobierają zadania, zysk, zamówienia, Buy Box i szanse. Dostęp tylko odczytuje. Więcej na stronie Asystenci AI. POST /api/v1/mcp
Klucze API w Sellgrip: klucze z uprawnieniami, ostatnim użyciem i ważnością.Klucze API w Sellgrip: klucze z uprawnieniami, ostatnim użyciem i ważnością.

Obok innego oprogramowania

Jeśli używasz już integratora lub repricera, wybierz jedno źródło dla każdego pola. Tu widzisz, co Sellgrip tylko czyta i kiedy zapisuje.

Tylko odczyt Raporty, księgowania, wypłaty, magazyny, grupy wysyłkowe, kategorie i szanse od Kauflandu. Sellgrip niczego w nich nie zmienia.
Na twoje kliknięcie Wysyłka, anulowanie, zwrot pieniędzy, zwroty, zgłoszenia, kupony rabatowe, oferty i dane produktów. Sellgrip wysyła dopiero, gdy potwierdzisz to w panelu.
Ceny automatycznie Tylko gdy włączysz tryb automatyczny reguł cenowych i ustawisz produkt na Automatycznie. Jeśli cenę zmieniło inne narzędzie albo Smart Pricing, Sellgrip nic nie wysyła i przełącza produkt na Kliknięciem.
Limity cen Nigdy poniżej progu rentowności, najwyżej 5% na zmianę i 15% dziennie, oba do ustawienia. Po trzech błędach z rzędu tryb automatyczny sam się wyłącza.
Stany automatycznie Tylko gdy włączysz synchronizację stanów ze swoją listą lub feedem. Jeśli lista wygląda źle, na przykład za dużo zer albo za dużo zmian naraz, Sellgrip nic nie wysyła.
Dane produktów automatycznie Tylko gdy włączysz feed importu. Sellgrip wysyła wtedy tylko wiersze, które się zmieniły.
Faktury automatycznie Tylko gdy włączysz automatyczne przesyłanie, dla zamówień od tej chwili. Jeśli Kaufland ma już fakturę do zamówienia, od kogokolwiek, Sellgrip żadnej nie przesyła.
API Sellgripa Twój własny system wysyła stany i dane produktów z kluczem, który sam tworzysz. Bez ważnego klucza nic nie przejdzie.
Jedno pole, jedno źródło Jeśli ceny lub stany ustawia już inne narzędzie, zostaw tę automatyzację w Sellgrip wyłączoną. Bez automatyzacji Sellgrip zapisuje tylko na twoje polecenie.
Wyłącznik awaryjny Na dole strony Reguły cenowe. Od razu zatrzymuje reguły cenowe, synchronizację stanów, import danych produktów i zmiany przez API Sellgripa, dopóki go nie zwolnisz. Zmiany wprowadzane samodzielnie w Ofertach, czynności przy zamówieniach i zgłoszeniach oraz automatyczne faktury działają dalej.
Dziennik W Ustawieniach › Dziennik jest wszystko, co twoje konto wysłało do Kauflandu, z czasem i wynikiem. Automatyczne ceny są też w historii reguł cenowych.

Połącz swój sklep na Kauflandzie

Sklep łączysz sam w panelu, dwoma kluczami z Seller Portalu. Potem rusza pierwsza synchronizacja, za darmo w każdym planie.

Załóż darmowe konto Skontaktuj się z nami