Clini.pl
Wszystkie integracje
System zarządzania sprzedażąDostępna

Base.com i Clini.pl

Clini działa w Base.com jak podłączony sklep internetowy. Sprzedawca może utrzymywać katalog i magazyn w swoim dotychczasowym panelu, a sprzedaż, płatność i dostawa pozostają kontrolowane przez Clini.

base.

Najpierw wybierz sposób pracy

Test połączenia potwierdza tylko komunikację. Integracja zaczyna działać dopiero wtedy, gdy każdy wybrany obszar wykona pierwszą poprawną synchronizację.

Base.com prowadzi katalog, ceny i stany

Rekomendowana

Najlepszy wybór, gdy Base.com jest codziennym panelem magazynowym sprzedawcy.

  • Eksport produktów do Clini: włączony
  • Ceny: Base.com → Clini
  • Stany: Base.com → Clini
  • Synchronizacja: najkrótsza dostępna w planie Base.com
  • Opłacone zamówienia: operacyjna kopia do Base.com
  • Płatności, anulowania i refundy: wyłącznie Clini

Clini prowadzi katalog, ceny i stany

Wybierz ten model, gdy dane mają być zmieniane w Clini, a Base.com ma je tylko pobierać.

  • Pobieranie produktów z Clini: włączone
  • Ceny: Clini → Base.com
  • Stany: Clini → Base.com
  • Zmiany produktów w Base.com nie są wysyłane do Clini
  • Zamówienia i realizacja: Clini
  • Płatności, anulowania i refundy: wyłącznie Clini

Jak działa integracja

Integracja wykorzystuje mechanizm „Inny sklep” oraz plik wymiany danych Base.com. Nie wymaga przekazywania hasła do konta Base.com ani instalowania dodatkowego programu. Base.com generuje osobne hasło komunikacyjne, które sprzedawca zapisuje w Clini, a następnie wskazuje adres API Clini jako plik wymiany danych.

To integracja dwukierunkowa. Base.com może pobierać produkty, ceny i stany dostępne w Clini, a także przesyłać aktualizacje cen i stanów oraz dodawać nowe produkty. Nowe lub niekompletne produkty nie omijają reguł platformy: trafiają do szkiców i wymagają uzupełnienia danych kategorii, logistyki oraz GPSR przed publikacją.

Ważne ograniczenie mechanizmu „Inny sklep”: metoda ProductAdd nie przekazuje relacji rodzic–wariant. Przy eksporcie z Base do Clini każdą wersję produktu należy obecnie traktować jako osobną ofertę. Clini nie łączy ich automatycznie po podobnej nazwie, ponieważ mogłoby to połączyć różne towary.

Gdy Base.com prowadzi stan magazynowy, otrzymuje operacyjną kopię opłaconego zamówienia potrzebną do odjęcia stanu i kompletacji. Clini nadal kontroluje zamówienie, płatność, wybraną dostawę, Apaczkę, anulowanie, zwrot oraz refund.

Co jest synchronizowane

Kierunek przy każdym obszarze pokazuje, który system przekazuje dane i które operacje pozostają wyłącznie w Clini.

Produkty i wersje produktu

Base.com może pobierać katalog Clini oraz dodawać nowe pozycje. Eksport Base → Clini nie przenosi grupy wariantów przez ProductAdd, dlatego wersje trafiają jako osobne szkice.

W obie strony

Ceny brutto

Aktualizacje cen są przyjmowane przez ProductsPriceUpdate. Jedno wskazane źródło pozostaje odpowiedzialne za zapis ceny.

W obie strony

Stany magazynowe

Base.com może pobierać dostępność oraz aktualizować stan przez ProductsQuantityUpdate, bez ręcznej edycji każdej oferty.

W obie strony

Opłacone zamówienia

OrdersGet udostępnia wyłącznie zamówienia przypisane sprzedawcy i skierowane operacyjnie do Base.com.

Z Clini

Status i nadanie

OrderUpdate pozwala przekazać wyłącznie status Wysłane albo Dostarczone. Próba zmiany płatności, anulowania lub refundu jest odrzucana.

W obie strony

Płatności i refundy

Stripe, prowizja marketplace, zwrot środków i rozliczenie sprzedawcy nie są przekazywane do sterowania w Base.com.

Tylko Clini

Najwygodniejszy sposób pracy

  1. 1

    Utrzymuj katalog w jednym miejscu

    Wybierz system, który ma być źródłem cen i stanów. Nie aktualizuj tych samych pól jednocześnie w kilku integracjach.

  2. 2

    Publikuj po kontroli w Clini

    Po imporcie sprawdź kategorię, dane bezpieczeństwa, zdjęcia i logistykę. Dopiero kompletna oferta może zostać opublikowana.

  3. 3

    Obsługuj tylko opłacone zamówienia

    Do realizacji trafiają zamówienia po potwierdzeniu płatności. Klient nie jest obciążany ponownie w systemie zewnętrznym.

  4. 4

    Zlecaj wysyłkę bez ponownej wyceny

    Base.com inicjuje proces, a Clini korzysta z wybranej przez klienta usługi, zapisanego adresu i wyceny Apaczki.

Tutorial konfiguracji

Podłączenie Clini jako sklepu w Base.com

Tutorial wideo w przygotowaniu

Konfiguracja krok po kroku

  1. 1

    Rozpocznij w Clini

    W Clini otwórz Produkty → Import i integracje → Base.com, a następnie kliknij „Podłącz”. Na tym ekranie niczego jeszcze nie wpisujesz.

  2. 2

    Dodaj połączenie „Inny sklep”

    W Base.com wybierz Integracje → Dodaj integrację → Sklep → Inny sklep. Nazwa połączenia: Clini.

  3. 3

    Przenieś hasło komunikacyjne

    Skopiuj hasło z Base.com i wklej je w polu „Hasło komunikacyjne” w Clini. Przykład na ekranie jest fikcyjny. Wpisz hasło wygenerowane dla Twojego połączenia.

  4. 4

    Wybierz miejsce zarządzania danymi

    W Clini przejdź do kroku „Źródła danych”. Zalecenie: katalog, ceny i stany — Base.com.

  5. 5

    Ustaw kierunki w Base.com

    W ustawieniach połączenia Base.com włącz eksport produktów, cen i stanów zgodnie z podsumowaniem Clini. Plik wymiany: https://api.clini.pl/api/v1/baselinker

  6. 6

    Sprawdź jeden produkt

    Uruchom kontrolny eksport jednego produktu, a następnie podgląd w Clini. Wybierz produkt z poprawną ceną, stanem i zdjęciem.

  7. 7

    Potwierdź wszystkie obszary

    W Clini otwórz checklistę aktywacji. Nie wpisujesz danych. Sprawdź, czy każdy wymagany obszar ma status „Działa”.

Dostęp i bezpieczeństwo

Base.com nie wymaga klucza API ani hasła do konta. Połączenie „Inny sklep” generuje osobne hasło komunikacyjne, które służy wyłącznie do wymiany danych z Clini.

Hasło komunikacyjne
Wygenerowane dla integracji Clini
Uwierzytelnia wyłącznie połączenie Base.com–Clini. Nie wpisuj hasła logowania do Base.com.
Plik wymiany danych
https://api.clini.pl/api/v1/baselinker
Jest to jedyny adres, z którym Base.com powinien komunikować się w ramach tej integracji.
Produkty
Włącz tylko, jeżeli Base.com ma prowadzić katalog
Pozwala pobierać albo aktualizować oferty zgodnie z wyborem źródła katalogu w Clini.
Ceny i stany
Włącz zgodnie z wybranym źródłem
Nie uruchamiaj równoległego zapisu tych samych danych z innego systemu.
Zamówienia
Tylko opłacone zamówienia Clini
Base.com może służyć do kompletacji i statusów, ale nie przejmuje płatności ani tworzenia przesyłki.

Nie udostępniaj hasła do konta Base.com. Jeśli hasło komunikacyjne wycieknie, wygeneruj nowe i zastąp je w obu panelach.

Checklista pierwszego uruchomienia

Nie uruchamiaj całego katalogu, dopóki produkt kontrolny, cena i stan nie zostaną potwierdzone osobno.

  1. 1Hasło komunikacyjne zostało zapisane
  2. 2Test połączenia zakończył się poprawnie
  3. 3Źródło katalogu jest zgodne w obu panelach
  4. 4Pierwszy produkt dotarł we właściwym kierunku
  5. 5Pierwsza cena została potwierdzona
  6. 6Pierwszy stan został potwierdzony
  7. 7Operacyjna kopia opłaconych zamówień jest zgodna ze źródłem stanu
  8. 8Szkice wymagające danych Clini są widoczne w katalogu

Gdzie znaleźć ustawienia w Base.com

Zrzuty pochodzą z konta testowego i nie zawierają hasła komunikacyjnego ani danych sprzedawcy. Kliknij obraz, aby otworzyć go w pełnym rozmiarze.

Zakładka Produkty w panelu Base.com

Zakładka Produkty

W tym miejscu wybierasz import lub eksport produktów. Na ekranie testowym eksport jest wyłączony.

Zakładka Stany w panelu Base.com

Zakładka Stany

Kierunek musi odpowiadać źródłu stanu wybranemu w Clini. Na ekranie testowym synchronizacja jest wyłączona.

Zakładka Ceny w panelu Base.com

Zakładka Ceny

Kierunek ceny ustaw niezależnie od stanu, zgodnie z wyborem w kreatorze Clini.

Podział odpowiedzialności

Clini odpowiada za

  • płatność Stripe, prowizję i rozliczenie sprzedawcy
  • ostateczną wycenę dostawy oraz wybór usługi przez klienta
  • tworzenie przesyłki w Apaczce i ochronę przed duplikatem
  • zwroty, decyzje reklamacyjne i refundy
  • wymagania publikacji, GPSR i historię zamówienia

Base.com odpowiada za

  • codzienną pracę na katalogu, cenach i stanach
  • kolejkę opłaconych zamówień przypisanych do Base.com
  • zmiany statusów operacyjnych i inicjowanie nadania
  • widoczność numeru śledzenia po utworzeniu przesyłki

Ważne przed uruchomieniem

  • Nie konfiguruj dwóch źródeł stanu dla tego samego sprzedawcy.
  • Nowe produkty nie są automatycznie publikowane bez kompletnych danych Clini.
  • Po zmianie ceny lub stanu sprawdź, czy Base wykonało ProductsPriceUpdate lub ProductsQuantityUpdate. Jeżeli nie, ponów eksport produktu do sklepu Clini.
  • Eksport Base → Clini przez „Inny sklep” nie zachowuje grupy wariantów. Nie próbujemy odtwarzać jej przez podobieństwo nazw.
  • Nie wybieraj w Base.com trybu Custom Marketplace; Clini działa jako integracja sklepu.
  • Base.com nie wycenia dostawy klientowi i nie wykonuje refundów Stripe.

Najczęstsze problemy i następny krok

Hasło zapisane, ale brak testu

WAITING_FOR_TEST

Clini nie potwierdziło jeszcze połączenia.

Co zrobić: W Base.com zapisz integrację i uruchom test połączenia.

Połączenie działa, ale brak danych

WAITING_FOR_FIRST_CALL

Wybrany kierunek nie wykonał jeszcze żadnej synchronizacji.

Co zrobić: Sprawdź ustawienie danego obszaru w Base.com i wyślij jeden produkt kontrolny.

Kierunki danych są sprzeczne

DIRECTION_MISMATCH

Cena lub stan mogą zostać nadpisane albo nieaktualne.

Co zrobić: Porównaj źródła zapisane w Clini z ustawieniami Produktów, Cen i Stanów w Base.com.

Warianty pojawiły się jako osobne szkice

VARIANT_RELATION_MISSING

ProductAdd nie przekazuje relacji rodzic–wariant.

Co zrobić: Nie łącz produktów po nazwie. Uporządkuj szkice w Clini albo importuj je inną metodą zachowującą warianty.

Odrzucono zmianę zamówienia

BASE_ORDER_STATUS_NOT_ALLOWED

Base.com próbowało zmienić płatność, anulowanie albo refund.

Co zrobić: Pozostaw w Base.com wyłącznie mapowanie statusów Wysłane i Dostarczone.

Base.com nie odpowiedziało na czas

PROVIDER_TIMEOUT

Ostatnia synchronizacja mogła być częściowa.

Co zrobić: Nie uruchamiaj konfiguracji ponownie. Użyj bezpiecznego ponowienia tylko dla obszaru oznaczonego błędem.

Najczęstsze pytania

Czy muszę przekazać Clini hasło do Base.com?

Nie. Używane jest wyłącznie techniczne hasło komunikacyjne wygenerowane dla integracji sklepu.

Czy Base.com może dodać nowy produkt?

Tak, ale oferta przechodzi walidację Clini i może pozostać szkicem do czasu uzupełnienia wymaganych danych.

Czy warianty z Base utworzą jedną kartę produktu w Clini?

Nie w obecnym mechanizmie „Inny sklep”. ProductAdd nie przekazuje relacji rodzic–wariant, dlatego wersje produktu trafiają jako osobne szkice. Clini nie łączy ich po nazwie.

Kto tworzy etykietę przewozową?

Przesyłkę i etykietę tworzy Clini przez Apaczkę. Base.com może zainicjować nadanie i otrzymać wynik operacji.

Podłącz Base.com

Konfigurację rozpoczniesz w panelu sprzedawcy. Najpierw możesz wykonać test i podgląd bez publikowania produktów.