Konektory

Konektor to gotowa obsługa jednego zewnętrznego systemu w Complaia. Podłączyć można dziesięć systemów: trzy marketplace’y i integratory, trzy sklepy internetowe i czterech kurierów. Z tej strony dowiesz się, co każdy z nich potrafi, co przygotować przed startem i jak go podłączyć krok po kroku.

Gdzie to znaleźć: Integracje → Integracje → Lista integracji, a potem Nowa integracja

Kiedy z tego korzystasz

• Zamierzasz podłączyć sklep, marketplace albo kuriera i chcesz najpierw zebrać właściwe klucze.
• Chcesz wiedzieć, czy system potrafi konkretną rzecz, na przykład pobrać produkty, odesłać numery śledzenia albo zamówić podjazd kuriera, zanim zaczniesz na tym polegać.
• Połączenie nie działa i chcesz zrozumieć komunikat.

Najważniejsze pojęcia

• Konektor — jeden obsługiwany system, na przykład Shoper albo DHL.
• Integracja — jedno podłączone konto w tym systemie. Ten sam konektor możesz podłączyć więcej niż raz. Każdemu połączeniu nadaj własną nazwę w polu Nazwa integracji.
• Dane połączenia — klucze, tokeny albo hasła, które daje ci drugi system, oraz ustawienia połączenia. Complaia przechowuje sekrety zaszyfrowane. Po zapisaniu już ich nie zobaczysz: pole z sekretem zawsze jest puste.
• Tryb testowy — środowisko do ćwiczeń w drugim systemie. Zamówienia i przesyłki są w nim nieprawdziwe i nic nie jest pobierane z konta. Przełącznik trybu testowego mają Allegro, InPost, DHL, DPD i FedEx. Ustawisz go tylko przy tworzeniu integracji. Żeby przejść od ćwiczeń do prawdziwej pracy, utwórz nową integrację. W DPD i FedEx przełącznik jest włączony zaraz po otwarciu formularza.
• Complaia ERP — nazwa, której wiele ekranów i komunikatów używa dla Complaia, na przykład „zatwierdź dostęp dla Complaia ERP”. ERP (enterprise resource planning) to system do zarządzania zasobami firmy.
• Produkty są tylko dodawane. Pobieranie produktów tworzy te produkty, których Complaia jeszcze nie ma. Produkt, który już masz, zostaje dokładnie taki, jaki był. Stany magazynowe nigdy się nie zmieniają, a zdjęcia nie są importowane.

W skrócie

Systemy, które pobierają zamówienia

Konektor	Pobieranie zamówień	Pobieranie produktów na żądanie	Wymiana statusów zamówień	Pobieranie płatności	Wysyłanie płatności	Wysyłanie numerów śledzenia
Allegro	✓	—	✓	✓	—	✓
Apilo	✓	✓	✓	✓	—	✓
Base (BaseLinker)	✓	✓	✓	✓	✓	✓
WooCommerce	✓	✓	✓	✓	—	—
Shoper	✓	✓	✓	✓	—	—
PrestaShop	✓	✓	✓	✓	—	—

Z jakich mapowań korzysta każdy z nich:

Konektor	Statusy	Typy płatności	Źródła zamówień	Sposoby dostawy	Kurierzy
Allegro	✓	—	—	✓	✓
Apilo	✓	✓	✓	✓	✓
Base	✓	✓	✓	✓	✓
WooCommerce, Shoper, PrestaShop	✓	✓	—	✓	—

Kurierzy

Konektor	Przesyłka i etykieta	Anulowanie etykiety u kuriera	Śledzenie statusu paczki	Zamawianie podjazdu kuriera	Za granicę
InPost	✓	✓	✓	✓	—
DHL	✓	✓	✓	✓	✓
DPD	✓	—	✓	✓	✓
FedEx	✓	✓	✓	✓	✓

To, jak przesyłki są tworzone, etykietowane, anulowane i odbierane przez kuriera, opisuje strona Zlecenia logistyczne.

Ekran

Przycisk Nowa integracja otwiera okno Dodaj integrację.

• Katalog — po jednym kafelku na konektor, z logo, rodzajem i krótkim opisem. Listę zawęzisz polem wyszukiwania albo przyciskami Wszystko, Marketplace i Logistyka. Kliknij kafelek, żeby go wybrać.
• Formularz — po lewej opis konektora i przewodnik. Przewodnik mówi, co się dzieje po utworzeniu integracji, czego integracja nie robi, odpowiada na częste pytania i zawiera sekcję Przygotuj przed połączeniem. Po prawej, pod nagłówkiem Konfiguracja połączenia:
  • Nazwa integracji;
  • pola właściwe dla konektora;
  • Jak często pobierać zamówienia? — w systemach, które pobierają zamówienia;
  • Status zamówienia ustala i ustawienie płatności — przy marketplace’ach, integratorach i sklepach. Zobacz Mapowania → Kto ustala status i płatność zamówienia;
  • opcjonalne pole Opis / notatka;
  • Dla działań ręcznych — ustawienia używane tylko przez przyciski na karcie integracji. Ma je tylko Base.

Odnośnik Jak skonfigurować połączenie na górze formularza przenosi do kroków przygotowania w przewodniku. Wstecz wraca do katalogu. Anuluj zamyka okno. Utwórz integrację zapisuje.

W angielskiej wersji interfejsu część nazw pól zostaje po polsku. Poniżej zaznaczono, gdzie tak jest.

📷 Zrzut ekranu do dodania: okno Dodaj integrację z katalogiem dziesięciu konektorów

Typowe zadania

Podłączanie konektora

1. Kliknij Nowa integracja, a potem kafelek konektora.
2. Wypełnij pole Nazwa integracji. Formularz podpowiada nazwę samego konektora. Jeśli podłączasz ten sam system drugi raz, zmień ją, bo dwie integracje nie mogą mieć tej samej nazwy. Nazwy integracji nie da się później zmienić.
3. Wypełnij pola podane dla tego konektora niżej na tej stronie.
4. Jeśli system pobiera zamówienia, wybierz częstotliwość pobierania: Co 15 minut, Co 30 minut albo Co 60 minut.
5. Przy marketplace’ie, integratorze albo sklepie sprawdź, kto ustala status i płatność zamówienia.
6. Kliknij Utwórz integrację.

Potem Complaia sama:

• Łączy się od razu albo przenosi Cię do drugiego systemu, żeby zatwierdzić dostęp (Allegro oraz WooCommerce przy łączeniu przez sklep). Po nieudanej próbie integracja zostaje na liście ze stanem Błąd, więc możesz ją poprawić.
• Tworzy regułę systemową z pracą w tle: pobieraniem zamówień z wybraną częstotliwością, a u kuriera także codziennym sprawdzaniem statusów i codziennym podjazdem.
• W systemie, który pobiera zamówienia, tworzy źródło zamówień nazwane tak jak integracja.

Zamówienia są pobierane od chwili utworzenia integracji. Starsze pobierzesz przyciskiem Synchronizacja zamówień.

Późniejsza zmiana danych połączenia

1. Otwórz integrację i znajdź po prawej sekcję Dane techniczne. Kliknij Pokaż i potwierdź.
2. W formularzu Dane połączenia zmień to, czego potrzebujesz. Pola z sekretami zawsze są puste. Zostaw takie pole puste, żeby zachować zapisany sekret, albo wpisz nową wartość, żeby go zastąpić.
3. Kliknij Zapisz. Okno wymieni zmienione pola. Potwierdź przyciskiem Zapisz dane. Complaia zapisuje dane i od razu testuje połączenie z nowymi danymi.

Czego tu nie zmienisz:

• Trybu testowego. Widać go tylko jako Włączone albo Wyłączone. Żeby zmienić środowisko, utwórz nową integrację.
• Połączenia z Allegro. Allegro nie ma kluczy do edycji. Zamiast tego użyj przycisku Połącz ponownie na karcie integracji.
• Pola Automatyczne wysyłanie numerów śledzenia. To przełącznik w sekcji Numery śledzenia na karcie integracji.

Ustawianie mapowań potrzebnych konektorowi

Pobieranie zamówień działa od razu po podłączeniu. Statusy, płatności, sposoby dostawy i numery śledzenia działają dobrze dopiero wtedy, gdy na karcie integracji połączysz nazwy z drugiego systemu ze swoimi. Każde mapowanie objaśnia strona Mapowania.

Źródła zamówień

Allegro

Pobiera zamówienia, wymienia statusy zamówień, pobiera płatności i odsyła numery śledzenia. Nie potrzebujesz żadnych kluczy: logujesz się do Allegro i zatwierdzasz dostęp dla Complaia.

Przygotuj: konto Allegro, na którym sprzedajesz. Do testów konto w Allegro Sandbox, czyli środowisku testowym Allegro.

1. W formularzu zostaw wyłączone Środowisko testowe (sandbox), żeby podłączyć prawdziwe konto Allegro. Włącz je tylko dla konta w Allegro Sandbox.
2. Opcjonalnie włącz Automatyczne wysyłanie numerów śledzenia.
3. Wybierz częstotliwość pobierania i to, kto ustala status i płatność zamówienia.
4. Kliknij Utwórz integrację. Przeglądarka przejdzie do Allegro.
5. Zaloguj się na konto Allegro, na którym sprzedajesz, i zatwierdź dostęp. Allegro odeśle Cię na kartę integracji, a podłączone konto pojawi się na karcie połączenia.

Jeśli przeglądarka nie przeszła do Allegro albo zamknięto stronę Allegro, otwórz integrację i kliknij Połącz z Allegro w sekcji Połącz konto Allegro.

Dostęp odnawia się automatycznie co noc, także wtedy, gdy subskrypcja Complaia jest nieaktywna, więc po opłaceniu integracja działa bez ponownego łączenia. Jeśli dostęp kiedyś wygaśnie, sekcja pojawi się znowu, z przyciskiem Połącz ponownie. Zaloguj się wtedy na to samo konto Allegro. Żeby podłączyć inne konto Allegro, dodaj nową integrację.

Pamiętaj też, że:

• Jedno konto Allegro można podłączyć tylko w jednej integracji w firmie. Druga pobierałaby te same zamówienia jeszcze raz.
• Zamówienia z Allegro trafiają do źródła zamówień o nazwie Allegro.
• Allegro nie pobiera produktów i nie oznacza zamówień jako płatnych za pobraniem.
• Żeby numery śledzenia trafiały na Allegro pod właściwego kuriera, zmapuj kurierów.

Apilo

Integrator wielokanałowy. Pobiera zamówienia z platform podpiętych do Twojego konta Apilo, wymienia statusy zamówień, pobiera płatności i odsyła numery śledzenia. Produkty pobierzesz przyciskiem Synchronizacja produktów.

Przygotuj: w Apilo utwórz nową aplikację REST API w Administration → Apilo API keys. Apilo pokaże wtedy adres API, identyfikator klienta, sekret klienta i kod autoryzacyjny. Kod autoryzacyjny działa tylko raz i tylko do godziny, którą Apilo pokazuje obok niego, więc utwórz integrację od razu.

1. Wpisz Kod autoryzacyjny, Client ID i Client Secret.
2. Wpisz Adres API, na przykład https://yourcompany.apilo.com. Musi to być adres w domenie apilo.com.
3. Opcjonalnie włącz Automatyczne wysyłanie numerów śledzenia.
4. Wybierz częstotliwość pobierania i to, kto ustala status i płatność zamówienia.
5. Kliknij Utwórz integrację.

Complaia wymienia jednorazowy kod na dostęp, który potem co noc odnawia się sam. Jeśli dostęp kiedyś wygaśnie, wygeneruj w Apilo nowy kod autoryzacyjny i zapisz go w formularzu Dane połączenia.

Base (BaseLinker)

Integrator wielokanałowy, dawniej BaseLinker. Pobiera zamówienia ze wszystkich marketplace’ów i sklepów podpiętych do Twojego konta Base, wymienia statusy i płatności zamówień w obie strony i odsyła numery śledzenia. Produkty pobierzesz przyciskiem Synchronizacja produktów.

Przygotuj w Base:

1. Przejdź do My account → API i dodaj token API. Ustaw jego uprawnienia na Full i od razu skopiuj token, bo Base pokazuje go tylko raz.
2. Na dole tej samej strony włącz dziennik zdarzeń. Bez niego zmiany płatności i statusów w zamówieniach już pobranych nie docierają do Complaia, nawet przy tokenie z pełnymi uprawnieniami.

Potem w Complaia:

1. Wklej token w pole Token API.
2. Zdecyduj o polu Pobieraj zamówienia niepotwierdzone. Domyślnie jest wyłączone. Niepotwierdzone zamówienie w Base to wciąż szkic: kwoty i adresy mogą się w nim zmienić.
3. Opcjonalnie włącz Automatyczne wysyłanie numerów śledzenia.
4. Wybierz częstotliwość pobierania i to, kto ustala status i płatność zamówienia. Base to jedyny konektor, który może przyjmować płatności z Complaia.
5. Opcjonalnie, w sekcji Dla działań ręcznych, wpisz ID katalogu produktów. Korzysta z niego tylko przycisk Synchronizacja produktów. Zostaw pole puste, żeby użyć pierwszego katalogu na koncie.
6. Kliknij Utwórz integrację.

Jeśli dziennik zdarzeń jest wyłączony, karta integracji pokazuje o tym ostrzeżenie w sekcji Synchronizacja zamówień. Dopóki go nie włączysz, Complaia sprawdza tylko zamówienia potwierdzone w ciągu ostatnich 7 dni.

Base nie przyjmuje numeru śledzenia bez wskazania kuriera, więc zmapuj kurierów, zanim zaczniesz polegać na śledzeniu.

WooCommerce

Twój własny sklep na WordPressie. Pobiera zamówienia, wymienia statusy zamówień i pobiera płatności. Produkty pobierzesz przyciskiem Synchronizacja produktów. W sklepie nie trzeba niczego instalować.

Przygotuj w sklepie: sklep musi mieć adres https://, a w WordPressie Settings → Permalinks musi być ustawione na cokolwiek innego niż Plain.

W polu Sposób łączenia wybierz jeden z dwóch sposobów:

Połącz przez WooCommerce (domyślnie)

1. Wpisz Adres sklepu, zaczynający się od https://.
2. Wybierz częstotliwość pobierania i to, kto ustala status i płatność zamówienia.
3. Kliknij Utwórz integrację. Przeglądarka przejdzie do panelu administracyjnego sklepu.
4. Zaloguj się jako administrator sklepu i zatwierdź dostęp dla Complaia. Klucze same trafią do Complaia, a przeglądarka wróci na kartę integracji.

Jeśli to się nie zakończyło, otwórz integrację i kliknij Połącz z WooCommerce w sekcji Połącz sklep WooCommerce.

Wpisz klucze ręcznie

1. W WooCommerce przejdź do Settings → Advanced → REST API i dodaj klucz. Nadaj mu uprawnienia Read/Write. Read wystarcza do pobierania zamówień, ale wtedy Complaia nie zmieni statusu zamówienia w sklepie.
2. W Complaia wpisz Adres sklepu, Consumer Key (zaczyna się od ck_) i Consumer Secret (zaczyna się od cs_).
3. Wybierz częstotliwość pobierania i to, kto ustala status i płatność zamówienia, a potem kliknij Utwórz integrację.

Shoper

Platforma sklepów w abonamencie. Pobiera zamówienia, wymienia statusy zamówień i pobiera płatności. Produkty pobierzesz przyciskiem Synchronizacja produktów.

Przygotuj w sklepie: osobne konto administratora dla Complaia, w grupie z dostępem do WebAPI. Grupa potrzebuje odczytu zamówień i produktów oraz zapisu zamówień. Bez zapisu zamówienia nadal są pobierane, ale Complaia nie zmieni ich statusu w sklepie.

1. W polu Adres sklepu wpisz adres zaczynający się od https://, bez /webapi na końcu. Użyj adresu, pod którym sklep ostatecznie się otwiera: jeśli example.com przekierowuje na www.example.com, wpisz ten drugi.
2. W polach Login użytkownika API i Hasło użytkownika API wpisz login i hasło tego konta.
3. Wybierz częstotliwość pobierania i to, kto ustala status i płatność zamówienia.
4. Kliknij Utwórz integrację.

Shoper nie przekazuje Complaia, że zamówienie jest za pobraniem. Complaia rozpoznaje to po nazwie metody płatności. Zobacz Mapowania → Mapowanie metod płatności.

PrestaShop

Sklep na Twoim własnym serwerze. Pobiera zamówienia, wymienia statusy zamówień i pobiera płatności. Produkty pobierzesz przyciskiem Synchronizacja produktów.

Przygotuj w sklepie:

1. Przejdź do Advanced Parameters → Webservice i włącz webservice.
2. Dodaj nowy klucz i zostaw go włączonego.
3. W tabeli uprawnień klucza zaznacz dokładnie te pola. Nie nadawaj wszystkich uprawnień, bo klucz mógłby wtedy zmieniać i usuwać dane sklepu.

Zaznacz	Wiersze	Do czego służą
View (GET)	orders, order_details, order_states, customers, addresses, countries, currencies	Pobieranie zamówień. Wymagane
View (GET)	carriers, messages	Sposób dostawy i komentarz klienta na zamówieniu. Bez nich zamówienia przychodzą bez tych informacji
Add (POST)	order_histories	Zmiana statusu zamówienia w sklepie
View (GET)	products, combinations, product_options, product_option_values, taxes, tax_rules	Pobieranie produktów

Potem w Complaia:

1. W polu Adres sklepu wpisz adres zaczynający się od https://, bez /api na końcu.
2. W pole Klucz Webservice (WS key) wklej klucz.
3. Wybierz częstotliwość pobierania i to, kto ustala status i płatność zamówienia.
4. Kliknij Utwórz integrację.

Przy łączeniu i przy teście połączenia Complaia sprawdza uprawnienia klucza. Jeśli brakuje uprawnienia, okno testu je podaje, a sekcja Statusy zamówień na karcie integracji pokazuje ostrzeżenie.

Kurierzy

Po podłączeniu kurier jest dostępny przy tworzeniu zlecenia logistycznego. Samo podłączenie nic nie kosztuje: kurierowi płacisz tylko za utworzone etykiety. To, jak przesyłki są tworzone, etykietowane, anulowane i odbierane przez kuriera, opisuje strona Zlecenia logistyczne.

Każdy formularz kuriera pyta, jak zamawiać podjazd kuriera. Do wyboru są trzy możliwości:

• Ręcznie: zamawiasz podjazd przyciskiem w zleceniu, kiedy skończysz pakować. To wartość początkowa.
• Automatycznie o godzinie odcięcia: raz dziennie, o 15:00, jeśli nie zmienisz godziny, Complaia zamawia jeden podjazd dla przesyłek nadanych tego dnia.
• Wcale: masz stały podjazd w umowie z kurierem, więc Complaia niczego nie zamawia.

Wybór zmienisz później w formularzu Dane połączenia, a godzinę w sekcji Praca w tle na karcie integracji.

Dane nadawcy są wypełniane z danych firmy. Późniejsza zmiana adresu firmy nie aktualizuje integracji, która już istnieje.

Adres na etykiecie i miejsce, z którego kurier odbiera paczki, pochodzą z miejsca nadania zlecenia logistycznego, zwykle magazynu. Zobacz Zlecenia logistyczne. Adres w integracji jest używany tylko wtedy, gdy zlecenie nie ma kompletnego miejsca nadania. Mimo to utrzymuj go kompletnym, żeby takie zlecenie też dało się nadać.

InPost

Paczkomaty i kurier, tylko dla przesyłek w Polsce.

Przygotuj: w Managerze Paczek InPost wygeneruj token API ShipX i zapisz numer organizacji. Formularz ma przycisk Otwórz Manager Paczek.

1. Wpisz Token API ShipX i ID organizacji. Oba pola są wymagane.

2. Przy prawdziwych przesyłkach zostaw wyłączony Tryb testowy (sandbox).

3. Opcjonalnie wpisz Token mapy paczkomatów (GeoWidget):

   • to inny token niż pierwszy, również generowany w Managerze Paczek;
   • musi pochodzić z tego samego środowiska co pierwszy token (testowego albo prawdziwego);
   • w dozwolonych witrynach tokenu wpisz adres swojego panelu Complaia, a nie sklepu.

   Bez tego tokenu mapa paczkomatów nie pokazuje się przy wyborze paczkomatu w zleceniu logistycznym.

4. Wybierz wartości w polach Domyślna usługa i Domyślny rozmiar paczki. Nowe zlecenie zaczyna się od nich, a w każdym zleceniu możesz je zmienić.

5. Wybierz opcję w polu Zamawianie podjazdu kuriera. Jest wymagane.

6. Wypełnij pola Nazwa nadawcy i Telefon nadawcy. Oba są wymagane. E-mail nadawcy jest opcjonalny.

7. Sprawdź adres, spod którego kurier odbiera paczki: Adres odbioru: ulica i numer, Adres odbioru: kod pocztowy, Adres odbioru: miejscowość i Adres odbioru: kraj. Wszystkie cztery pola są wymagane.

8. Kliknij Utwórz integrację.

DHL

DHL Parcel Polska, dla przesyłek krajowych i zagranicznych.

Przygotuj: wiadomość, którą DHL wysyła po włączeniu integracji dla Twojego konta. Zawiera kilka loginów. Complaia potrzebuje pary oznaczonej api v2 i Twojego numeru klienta SAP. Adres e-mail i hasło do serwisu DHL24 tu nie działają.

1. Wpisz Login WebAPI v2 i Hasło WebAPI v2.
2. Wpisz Numer klienta SAP. Mówi on DHL, które konto obciążyć.
3. Przy prawdziwych przesyłkach zostaw wyłączony Tryb testowy (sandbox). Gdy jest włączony, przesyłki trafiają do środowiska testowego DHL: nic nie jedzie i nic nie jest naliczane.
4. Opcjonalnie wybierz Domyślny produkt (opcjonalnie). To usługa podpowiadana przy nadaniu; w każdym zleceniu możesz wybrać inną. Produkt krajowy nie pojedzie za granicę, a zagraniczny nie obsłuży adresu w Polsce.
5. Opcjonalnie wybierz Domyślny rozmiar paczki (opcjonalnie). Jest używany, gdy zlecenie nie podaje własnej klasy rozmiaru. Nie zastępuje prawdziwych wymiarów paczki: zlecenie bez wymiarów zostaje odrzucone, zanim trafi do DHL.
6. Wybierz opcję w polu Zamawianie podjazdu kuriera. Jest wymagane.
7. Sprawdź dane nadawcy. Nazwa nadawcy, Adres nadawcy: ulica i numer, Adres nadawcy: kod pocztowy, Adres nadawcy: miejscowość i Adres nadawcy: kraj są wymagane. Telefon nadawcy (opcjonalnie) i E-mail nadawcy (opcjonalnie) są opcjonalne. Adres jest używany tylko wtedy, gdy zlecenie nie ma kompletnego miejsca nadania.
8. Kliknij Utwórz integrację.

Z Complaia nie da się wysyłać przesyłek DHL do punktów odbioru DHL.

DPD

DPD Polska, dla przesyłek krajowych i zagranicznych na Twojej własnej umowie z DPD.

Przygotuj: od opiekuna konta w DPD klucz dostępu do interfejsu DPD Polska i numer płatnika (FID). To nie są dane, których używasz w serwisie DPD Online. Żeby dostawać statusy paczek, poproś też opiekuna o włączenie usługi InfoServices.

1. Wpisz Klucz dostępu (Basic). Możesz go też wpisać w postaci login:hasło.
2. Wpisz Numer płatnika (FID).
3. Sprawdź Tryb testowy (demo DPD). Po otwarciu formularza jest włączony. Wyłącz go przy prawdziwych przesyłkach. Prawdziwe dane działają tylko z wyłączonym trybem testowym.
4. Opcjonalnie wpisz Kanał InfoServices (opcjonalnie), który przekazało ci DPD. Bez usługi InfoServices nie ma statusów paczek. W trybie testowym statusów też nie ma.
5. Wybierz wartość w polu Domyślna usługa. Usługa tylko krajowa w przesyłce za granicę, albo odwrotnie, pojedzie jako DPD Classic.
6. Opcjonalnie włącz Ubezpieczenie przesyłek. DPD ubezpiecza wtedy każdą przesyłkę na wartość towaru, kwotę podaną w zleceniu albo kwotę pobrania i wycenia to według Twojej umowy.
7. Wybierz opcję w polu Zamawianie podjazdu kuriera i sprawdź pola Nazwa nadawcy, Telefon nadawcy, E-mail nadawcy (opcjonalnie) oraz pola adresu Adres nadawcy: …. W angielskiej wersji interfejsu te nazwy pól też są po polsku. Nazwa, telefon i adres są wymagane.
8. Kliknij Utwórz integrację.

Pamiętaj też, że:

• DPD nie pozwala anulować etykiety. Paczka, której nie przekażesz kurierowi, nie jedzie i nie jest naliczana.
• Gdy Complaia zamawia podjazd, przygotowuje też protokół przekazania dla kuriera. Przy stałym podjeździe protokół powstaje codziennie o godzinie odcięcia.
• Pobranie działa tylko dla przesyłek w Polsce, w PLN.
• Z Complaia nie da się wysyłać przesyłek do punktów DPD Pickup.

FedEx

Przesyłki zagraniczne i krajowe usługi FedEx.

Przygotuj: projekt w serwisie developer.fedex.com z kluczem API i kluczem tajnym oraz numer konta FedEx. Klucze testowe działają tylko z włączonym trybem testowym, a produkcyjne tylko z wyłączonym.

1. Wpisz API Key i Secret Key.
2. Wpisz Numer konta FedEx. Na to konto FedEx nalicza przesyłki.
3. Sprawdź Tryb testowy (sandbox). Po otwarciu formularza jest włączony. Wyłącz go, gdy używasz kluczy produkcyjnych.
4. Wybierz wartości w polach Domyślna usługa i Zamawianie podjazdu kuriera, a potem sprawdź pola Nazwa nadawcy, Telefon nadawcy, E-mail nadawcy (opcjonalnie) oraz pola adresu Adres nadawcy: …. W angielskiej wersji interfejsu te nazwy pól też są po polsku. Nazwa, telefon i adres są wymagane.
5. Kliknij Utwórz integrację.

Pamiętaj też, że:

• Przy przesyłkach za granicę Complaia sama przygotowuje dane celne. Wartość pochodzi z ceny w zamówieniu albo z produktu, a krajem pochodzenia jest kraj nadawcy.
• Pobranie działa tylko dla przesyłek w Polsce, w PLN, i tylko jeśli obejmuje je Twoja umowa z FedEx.

Drukowanie

PrintNode

PrintNode nie jest oferowany przy nowych połączeniach i nie ma go w katalogu. Istniejąca integracja PrintNode nadal działa razem ze swoimi regułami drukowania etykiet.

Gdy coś nie działa

Poniższe komunikaty pojawiają się po kliknięciu Test połączenia, przy zapisie danych połączenia albo gdy uruchomienie zadania się nie uda. Nieudane uruchomienie widać w sekcji Ostatnia synchronizacja na karcie integracji.

Co widzisz	Dlaczego	Co zrobić
Pole „…” jest wymagane.	Wymagane pole formularza jest puste.	Wypełnij je.
Połączenie z Allegro nie jest jeszcze dostępne w Complaia ERP. Skontaktuj się z zespołem Complaia.	Połączenie z Allegro nie jest skonfigurowane na serwerze Complaia.	Wyślij zgłoszenie do wsparcia.
Autoryzacja została odrzucona w Allegro.	Na ekranie zatwierdzania w Allegro kliknięto anulowanie.	Kliknij jeszcze raz Połącz z Allegro i zatwierdź dostęp.
To konto Allegro jest już połączone w integracji „…”.	Jedno konto Allegro może być tylko w jednej integracji.	Użyj tamtej integracji albo zaloguj się na inne konto Allegro.
Ta integracja jest połączona z kontem Allegro „…”, a zalogowano się na inne konto.	Przy ponownym łączeniu użyto innego konta Allegro.	Połącz ponownie na koncie podanym w komunikacie albo dodaj nową integrację dla drugiego konta.
Od powrotu z Allegro minęło ponad 10 minut, więc połączenie nie zostało zapisane.	Powrót z Allegro nie zakończył się na czas.	Kliknij jeszcze raz Połącz z Allegro.
Nie udało się połączyć z Apilo kodem autoryzacji.	Kod został już użyty albo wygasł.	Wygeneruj w Apilo nowy kod autoryzacyjny i zapisz go w formularzu Dane połączenia.
Adres Apilo musi być w domenie apilo.com.	Adres API nie jest adresem Apilo.	Wpisz adres swojego panelu Apilo, na przykład https://yourcompany.apilo.com.
Nieprawidłowy token API Base.	Token wpisano z błędem albo go unieważniono.	Wygeneruj w Base nowy token i zapisz go w formularzu Dane połączenia.
Brak zmapowanego kuriera Base dla tej metody wysyłki.	Nie udało się wysłać numeru śledzenia, bo Base musi znać kuriera.	Zmapuj kurierów.
Sklep nie udostępnia REST API WordPressa.	Sklep używa odnośników typu Plain.	W WordPressie przejdź do Settings → Permalinks, wybierz dowolną inną opcję i zapisz.
WooCommerce odrzucił Consumer Key albo Consumer Secret.	Klucze są błędne albo klucz unieważniono.	Utwórz w sklepie nowy klucz albo użyj Połącz z WooCommerce.
Klucz REST API WooCommerce ma tylko odczyt, więc status nie został wysłany.	Klucz ma tylko uprawnienie do odczytu.	Zmień w WooCommerce uprawnienia klucza na Read/Write.
Shoper odrzucił dane użytkownika WebAPI.	Logowanie się nie udało.	Sprawdź login, hasło, dostęp konta do WebAPI, ograniczenia IP i to, czy plan sklepu obejmuje API.
Użytkownik WebAPI nie ma uprawnień do zamówień.	Login jest poprawny, ale konto nie może odczytywać zamówień.	Zmień uprawnienia konta w sklepie. Ponowne wpisanie hasła nie pomoże.
Adres sklepu przekierowuje wielokrotnie. Podaj docelowy adres sklepu.	Adres przekierowuje na inny, zwykle na wersję z www.	Wpisz adres, pod którym sklep ostatecznie się otwiera.
Adres sklepu … musi zaczynać się od https://.	Wpisano adres http://.	Użyj adresu https://.
PrestaShop odrzucił klucz Webservice.	Klucz jest błędny albo webservice jest wyłączony.	Sprawdź jedno i drugie w Advanced Parameters → Webservice.
Klucz Webservice nie ma uprawnienia, którego potrzebuje Complaia ERP.	W kluczu nie zaznaczono niektórych wierszy.	Zaznacz wiersze z tabeli dla PrestaShop.
Sklep nie udostępnia usługi Webservice pod adresem /api.	Adres jest błędny, na końcu wpisano /api albo w sklepie są wyłączone przyjazne adresy URL.	Popraw adres i włącz w sklepie przyjazne adresy URL.
Test połączenia z InPost nie powiódł się. Sprawdź dane dostępowe.	Błędny token albo numer organizacji, albo token testowy bez trybu testowego.	Sprawdź obie wartości. Token testowy działa tylko z włączonym trybem testowym.
To konto InPost nie ma włączonej obsługi kuriera… (przy nadawaniu)	Twoje konto InPost obejmuje tylko paczkomaty.	Użyj usługi paczkomatowej albo poproś InPost o włączenie kuriera.
Test połączenia z DHL nie powiódł się. Sprawdź dane dostępowe.	Najczęściej wpisano login do serwisu DHL24 zamiast pary api v2.	Wpisz login i hasło api v2 z wiadomości od DHL.
DPD odrzucił klucz dostępu albo numer płatnika.	Błędny klucz albo FID, albo prawdziwe dane przy włączonym trybie testowym.	Sprawdź obie wartości i ustawienie trybu testowego.
FedEx odrzucił klucz API albo Secret Key.	Błędne klucze albo klucze testowe przy wyłączonym trybie testowym.	Sprawdź oba klucze i ustawienie trybu testowego.
Przekroczono limit zapytań do …	Drugi system ogranicza, jak często Complaia może wysyłać do niego zapytania.	Poczekaj. Najbliższe zaplanowane uruchomienie spróbuje ponownie. Jeśli to się powtarza, wybierz dłuższy interwał pobierania.
Synchronizacja produktów przeszła, ale produkty, które już były, się nie zmieniły	Pobieranie produktów tylko dodaje brakujące.	Edytuj produkt w Complaia albo zaktualizuj go z pliku. Zobacz Import produktów.
Potrzebnego konektora nie ma w katalogu	Dostępnych jest tylko dziesięć konektorów opisanych wyżej.	Kliknij Poproś o integrację na liście integracji.

Uprawnienia

Aby…	Potrzebujesz
Otworzyć kartę integracji i zobaczyć jej ustawienia	Integracje: Podgląd
Otworzyć katalog, podłączyć konektor, zmienić dane połączenia, testować, wstrzymywać i usuwać	Integracje: Zarządzanie

Wskazówki i pułapki

• Sprawdź tryb testowy, zanim klikniesz Utwórz integrację. W Allegro, InPost i DHL jest wyłączony, a w DPD i FedEx włączony. Potem nie da się go zmienić.
• Usuń końcówkę z adresu sklepu. Shoper wpisujesz bez /webapi, PrestaShop bez /api.
• Problem z uprawnieniami to nie problem z hasłem. Shoper i PrestaShop osobno informują, że login jest poprawny, ale kontu albo kluczowi brakuje uprawnień. Popraw uprawnienia w sklepie, zamiast ponownie wpisywać sekret.
• Nazwij każde połączenie od konta, do którego należy. Przy dwóch sklepach albo dwóch kontach kurierskich to po nazwie będziesz potem wybierać z list, a nazwy nie da się zmienić.
• Daj Complaia osobne konto albo klucz w sklepie. Jeśli ktoś zmieni wspólne hasło, integracja przestanie działać razem z nim.

Zobacz też

• Integracje — lista, testowanie, wstrzymywanie i usuwanie połączenia
• Reguły integracji — praca w tle i Twoje własne reguły
• Mapowania — statusy, płatności, źródła zamówień, sposoby dostawy i kurierzy
• Zamówienia — tu trafiają pobrane zamówienia
• Import produktów i dopasowania z zamówień — dopasowanie pozycji zamówień do Twoich produktów
• Zlecenia logistyczne — korzystanie z podłączonego kuriera