Temu API – co można zautomatyzować i komu się to opłaca

Temu API – jak działa dostęp

Z perspektywy sprzedawcy dostęp do API wygląda zwykle tak samo, niezależnie od tego, czy korzystasz z gotowego integratora, czy z własnej aplikacji. W Seller Center, w sekcji aplikacji i usług, autoryzujesz wybraną aplikację, nadajesz jej uprawnienia i generujesz dane dostępowe – token API. Według dokumentacji integracji w serwisie Base każdy rynek ma swój dedykowany token, więc przy sprzedaży do kilku krajów trzeba pilnować, by dane zostały wygenerowane dla właściwego rynku.

Wykres – jak podłączyć aplikację do konta Temu przez API. [#chart:te40b]

Ważny jest zakres uprawnień. Dokumentacja Base wskazuje, że śledzenie przesyłek wymaga osobnego uprawnienia nadanego aplikacji w Seller Center (fulfillment i tracking), a po zmianie uprawnień trzeba wygenerować nowy token i wprowadzić go w ustawieniach integracji. Inne integratory opisują też wybór okresu ważności dostępu przy autoryzacji. W praktyce oznacza to, że ktoś w firmie powinien wiedzieć, jakie aplikacje mają dostęp do konta, z jakimi uprawnieniami i kiedy wygasają ich tokeny.

[#uwaga] Token API daje aplikacji dostęp do danych konta i operacji na zamówieniach. Udostępniaj go tylko zaufanym narzędziom, nie przesyłaj w otwartej korespondencji i odbieraj dostęp aplikacjom, z których już nie korzystasz. Zasady zarządzania dostępem do konta opisujemy w artykule dostęp do konta Temu dla pracownika lub agencji.

Co można zautomatyzować

Najczęściej automatyzowane procesy to te, które powtarzają się przy każdym zamówieniu i są podatne na błędy przy ręcznej obsłudze. Pierwszym jest pobieranie zamówień – zamiast przepisywać dane kupującego i produktów, system pobiera je automatycznie. Według dokumentacji Base zamówienia pobierane są ze statusu oznaczającego zamówienia niewysłane, a zamówienia oczekujące nie powinny być realizowane.

• Pobieranie zamówień – automatyczne zasilanie systemu sprzedaży nowymi zamówieniami.

• Synchronizacja stanów – jedno źródło stanów dla wszystkich kanałów, mniej anulacji z powodu braków.

• Przekazywanie numerów przesyłek – automatyczna aktualizacja zamówienia po nadaniu paczki.

• Generowanie etykiet – np. przez usługi wysyłkowe platformy dostępne w integracji.

• Wystawianie ofert – tworzenie ofert z katalogu produktów w systemie.

• Obsługa zwrotów – pobieranie zgłoszeń i ustawianie statusów rozliczeń.

O tym, jak wygląda to w praktyce na przykładzie jednego z najpopularniejszych systemów, piszemy w artykule BaseLinker i Temu – jak połączyć konto. Wysyłkę i etykiety opisujemy w tekstach wysyłka na Temu i numer przesyłki na Temu.

Ograniczenia, o których warto wiedzieć

API nie zawsze pozwala na wszystko, co można zrobić ręcznie w panelu, a integratory nie zawsze korzystają z wszystkich możliwości API. Dokumentacja Base wymienia funkcje, których jej integracja z Temu obecnie nie obsługuje: przekazywania statusów zamówień z systemu do marketplace, feedu produktowego, usuwania ofert po API, aktualizacji czasu wysyłki z systemu oraz pobierania numerów śledzenia zwrotów. Inny integrator opisuje m.in. brak obsługi dzielenia zamówień na kilka wysyłek.

Część ograniczeń wynika bezpośrednio z API Temu. Dokumentacja Base wskazuje, że przy wysyłce przez usługę wysyłkową platformy podpaczki trzeba utworzyć już przy pierwszym nadaniu – późniejsze dodanie kolejnej etykiety do tego samego zamówienia nie jest możliwe – i zaznacza, że to ograniczenie API Temu, a nie integratora. Etykieta i numer przesyłki nie zawsze są dostępne od razu, bo platforma najpierw potwierdza zakup etykiety u kuriera.

[#wazne] Zanim wybierzesz integrator albo zlecisz budowę własnej integracji, spisz procesy, które chcesz zautomatyzować, i sprawdź w dokumentacji, które z nich są faktycznie obsługiwane. Lista ograniczeń bywa ważniejsza niż lista funkcji.

Typowe błędy zwracane przez API

Przy wystawianiu ofert przez API sprzedawcy często spotykają się z komunikatami błędów, które wynikają z wymagań platformy. Dokumentacja Base opisuje m.in. błąd duplikatu SKU – oferta z tym samym SKU już istnieje lub jest przetwarzana – błąd wyboru kategorii nadrzędnej zamiast końcowej, brak uprawnień konta do wystawiania w danej kategorii, błędy mapowania danych producenta lub osoby odpowiedzialnej w ramach GPSR oraz problemy z przesyłaniem zdjęć i wideo, np. z powodu niedozwolonego typu pliku albo przekroczenia czasu odpowiedzi API.

Większość tych błędów nie jest problemem technicznym, tylko sygnałem, że dane produktu nie spełniają wymagań platformy. Dlatego integracja nie zwalnia z dbałości o katalog: poprawne kategorie, kompletne atrybuty, dane GPSR i właściwe pliki multimedialne. Więcej w artykułach kategorie na Temu i GPSR na Temu.

Wystawianie ofert przez integrację

Jedną z największych korzyści z połączenia przez API jest możliwość wystawiania ofert z jednego katalogu produktów. Zamiast tworzyć każdą ofertę ręcznie w panelu, przygotowujesz dane w systemie – tytuły, opisy, zdjęcia, warianty, atrybuty – i wysyłasz je na Temu. To szczególnie przydatne przy dużym katalogu i przy sprzedaży tych samych produktów w kilku kanałach. Trzeba jednak pamiętać, że Temu ma własne wymagania co do kategorii, atrybutów i danych bezpieczeństwa, więc dane z innego kanału zwykle wymagają uzupełnienia. Zasady wystawiania opisujemy w artykułach jak wystawić produkt na Temu i warianty produktów na Temu.

API przy sprzedaży do kilku krajów

Jeśli sprzedajesz z Polski do kilku rynków UE, integracja musi obsłużyć każdy z nich osobno – z osobnym tokenem, a często także z osobnymi ustawieniami cen, waluty i przewoźników. To częsty punkt, w którym coś przestaje działać: token dla jednego rynku wygasa, a zamówienia z tego kraju przestają trafiać do systemu, podczas gdy pozostałe działają normalnie. Warto więc monitorować przepływ zamówień w podziale na rynki. O obsłudze wielu rynków, walut i kursów w jednym systemie piszemy w artykule sprzedaż zagraniczna z BaseLinkerem.

Etykiety i wysyłka przez API

Integracja może też obsługiwać generowanie etykiet – zarówno przez umowy z własnymi przewoźnikami, jak i przez usługę wysyłkową platformy, jeśli jest dostępna w integracji. Według dokumentacji Base etykieta i numer przesyłki nie zawsze są gotowe od razu, bo Temu najpierw potwierdza zakup etykiety u kuriera, a z usługi wysyłkowej platformy można skorzystać w jednym zamówieniu tylko raz. Dlatego proces pakowania warto zaplanować tak, by liczba paczek była znana przed nadaniem. Szczegóły w artykule etykiety wysyłkowe w Temu Seller Center.

Gotowy integrator czy własna integracja

Dla większości polskich sprzedawców najrozsądniejszym wyborem jest gotowy integrator – system do sprzedaży wielokanałowej albo wtyczka do platformy sklepowej, która ma już zbudowane połączenie z Temu. Własna integracja z API to projekt programistyczny, który wymaga nie tylko zbudowania, ale i utrzymania: API się zmienia, pojawiają się nowe wymagania, a każda zmiana po stronie platformy może zatrzymać przepływ zamówień.

Wykres – kiedy własna integracja ma sens, a kiedy wystarczy gotowy integrator. [#chart:te40]

Własna integracja ma sens przede wszystkim w dużych firmach, które mają własne systemy ERP lub WMS, obsługują bardzo dużą liczbę zamówień albo potrzebują procesów, których gotowe narzędzia nie oferują. Według informacji publikowanych w materiałach sponsorowanych przez Temu platforma deklaruje integracje z różnymi systemami ERP i logistycznymi, a w Polsce popularne są również krajowe systemy do sprzedaży wielokanałowej. Wybór warto oprzeć na tym, gdzie już prowadzisz katalog i obsługujesz zamówienia z innych kanałów.

Komu się to opłaca – prosty rachunek

Decyzja o automatyzacji to w gruncie rzeczy rachunek czasu i błędów. Policz, ile czasu dziennie zajmuje ręczne przepisywanie zamówień, aktualizacja stanów i wpisywanie numerów przesyłek, ile kosztuje ta praca i ile kosztują błędy: wysłany niewłaściwy produkt, sprzedaż towaru, którego już nie ma, opóźnienia przez nieprzekazany tracking. Przy kilku zamówieniach tygodniowo ręczna obsługa może wystarczyć. Przy kilkudziesięciu dziennie automatyzacja zwykle zwraca się szybko – zarówno w czasie, jak i w mniejszej liczbie problemów z wskaźnikami konta.

[#tip] Zanim zdecydujesz się na automatyzację, przez tydzień notuj czas poświęcany na ręczne czynności przy zamówieniach z Temu i liczbę pomyłek. Te dwie liczby wystarczą, żeby ocenić, czy narzędzie się opłaci i które procesy zautomatyzować w pierwszej kolejności.

Automatyzacja a bezpieczeństwo procesów

Automatyzacja przyspiesza pracę, ale może też szybciej powielać błędy. Przykładem są statusy zamówień: dokumentacja Base ostrzega, że jeśli w integracji ustawisz status odpowiadający pełnemu zwrotowi pieniędzy, platforma potraktuje to jako dyspozycję pełnego zwrotu środków – bez dodatkowej ręcznej akceptacji. Dlatego reguły automatyczne, które zmieniają statusy, warto projektować ostrożnie i testować na pojedynczych zamówieniach. O obsłudze zwrotów piszemy w artykule zwroty na Temu po stronie sprzedawcy.

Drugim obszarem ryzyka jest synchronizacja stanów. Jeśli kilka systemów jednocześnie aktualizuje stany na Temu – np. integrator i wtyczka sklepu – mogą się wzajemnie nadpisywać. Zasada jest prosta: jedno źródło stanów i jedno narzędzie, które je wysyła. Wspólny katalog i stany opisujemy w artykule magazyn BaseLinker.

Monitoring integracji

Integracja, która raz zadziałała, nie musi działać zawsze. Tokeny wygasają, uprawnienia się zmieniają, platforma aktualizuje API, a dane produktów przestają spełniać nowe wymagania. Dlatego warto ustalić prosty monitoring: codzienne sprawdzenie, czy zamówienia z Temu trafiają do systemu, czy numery przesyłek wracają do platformy i czy nie pojawiły się błędy synchronizacji. Dobrze jest też zapisać daty wygaśnięcia tokenów i odnawiać je z wyprzedzeniem.

Kto w firmie odpowiada za integrację

Integracja łączy kilka obszarów: sprzedaż, magazyn, wysyłkę i księgowość. Jeśli nikt nie jest za nią odpowiedzialny, problemy wychodzą na jaw dopiero wtedy, gdy kupujący pytają o paczki albo pojawiają się kary za opóźnienia. Dobrze jest wyznaczyć jedną osobę, która zna konfigurację, ma dostęp do ustawień integracji i Seller Center, pilnuje ważności tokenów i jest pierwszym punktem kontaktu przy błędach. Taka osoba powinna też mieć spisane podstawowe informacje: jakie aplikacje mają dostęp do konta, z jakimi uprawnieniami, które statusy są mapowane automatycznie i jak wygląda procedura awaryjna, gdy integracja przestaje działać.

Przykład – od ręcznej obsługi do integracji

[#przyklad] Sprzedawca artykułów domowych obsługiwał zamówienia z Temu ręcznie: przepisywał je do systemu magazynowego, a numery przesyłek wklejał w panelu. Przy kilkudziesięciu zamówieniach dziennie zajmowało to kilka godzin, a raz w tygodniu zdarzała się pomyłka. Po podłączeniu konta do systemu wielokanałowego zamówienia zaczęły trafiać do systemu automatycznie, stany synchronizowały się z innymi kanałami, a tracking wracał do Temu po nadaniu paczki. Okazało się jednak, że trzeba było osobno nadać uprawnienia do śledzenia przesyłek i wygenerować nowy token – bez tego statusy przesyłek się nie aktualizowały. Przykład jest ilustracyjny.

Najczęstsze błędy

• Brak uprawnień do trackingu – paczki są nadane, ale statusy się nie aktualizują.

• Token wygenerowany dla złego rynku – zamówienia z części krajów nie trafiają do systemu.

• Kilka narzędzi aktualizujących stany – wzajemne nadpisywanie i błędne dostępności.

• Automatyczne statusy zwrotów – niezamierzone zwroty pieniędzy.

• Brak monitoringu – wygasły token zatrzymuje przepływ zamówień bez ostrzeżenia.

• Własna integracja bez planu utrzymania – zmiany w API zatrzymują sprzedaż.

Najczęściej zadawane pytania

Czy Temu ma API dla sprzedawców?

Tak. Integratory łączą się z kontem sprzedawcy przez API Temu po autoryzacji aplikacji w Seller Center i wygenerowaniu tokenu. Warunki dostępu do dokumentacji dla deweloperów określa Temu.

Jak podłączyć integrator do konta Temu?

W Seller Center, w sekcji aplikacji i usług, autoryzuj aplikację, nadaj jej uprawnienia i wygeneruj token API, a następnie wprowadź go w ustawieniach integracji. Każdy rynek ma osobny token.

Co można zautomatyzować przez API?

Najczęściej pobieranie zamówień, synchronizację stanów, przekazywanie numerów przesyłek, generowanie etykiet, wystawianie ofert i część obsługi zwrotów. Zakres zależy od integratora.

Czy integracja obsługuje wszystkie funkcje panelu?

Nie zawsze. Dokumentacja Base wymienia np. brak przekazywania statusów do marketplace, usuwania ofert przez API i aktualizacji czasu wysyłki z systemu. Część działań trzeba wykonywać w Seller Center.

Czy opłaca się budować własną integrację?

Zwykle tylko w dużych firmach z własnym ERP lub WMS i dużym wolumenem zamówień. Dla większości sprzedawców gotowy integrator jest szybszy i tańszy w utrzymaniu.

Dlaczego statusy przesyłek nie aktualizują się w systemie?

Najczęściej z powodu braku uprawnień do śledzenia przesyłek. Trzeba je nadać aplikacji w Seller Center, wygenerować nowy token i wprowadzić go w integracji.

Podsumowanie

Temu API pozwala zautomatyzować najbardziej pracochłonne elementy sprzedaży: pobieranie zamówień, synchronizację stanów, przekazywanie numerów przesyłek i wystawianie ofert. Dostęp odbywa się przez autoryzację aplikacji w Seller Center i token generowany osobno dla każdego rynku, z uprawnieniami dopasowanymi do zakresu działań. Dla większości sprzedawców najlepszym wyborem jest gotowy integrator, ale przed wdrożeniem warto sprawdzić listę ograniczeń, zaplanować jedno źródło stanów i wprowadzić prosty monitoring integracji.

Jeśli chcesz podłączyć konto Temu do swoich systemów i uporządkować obsługę zamówień, wdrażamy i obsługujemy konta sprzedawców na Temu. Szczegóły znajdziesz na stronie usługi sprzedaż na Temu.