Nowa funkcja! WooCommerce Marketplace API w WC Vendors

Prowadzenie sklepu wielodostawczego wiąże się z wieloma kopiowaniem i wklejaniem. Sumy prowizji trafiają do arkusza kalkulacyjnego, nowe aplikacje sprzedawców są przekazywane do czatu zespołowego, a sprzedawcy proszą o eksporty, aby mogli zaktualizować własne narzędzia do zarządzania zapasami lub wysyłką. Każde z tych zadań to osoba ręcznie przenosząca dane. WC Vendors 2.7.3 to zmienia. Dodaje WooCommerce Marketplace API, które pozwala innym aplikacjom bezpiecznie odczytywać i aktualizować Twój marketplace: sprzedawców, zamówienia sprzedawców, prowizje, stawki prowizji i podsumowania sprzedaży. Dodaje również webhooks marketplace i zestaw możliwości, które asystenci AI mogą odkrywać i uruchamiać na Twojej stronie.

W tym artykule wyjaśnimy, co zawiera nowe API, kto może z niego korzystać i co można dzięki niemu zbudować. Następnie krok po kroku przeprowadzimy Cię przez konfigurację, od pierwszych poświadczeń po pierwszy webhook.

Czym jest WooCommerce Marketplace API?

To zestaw adresów internetowych w Twojej witrynie, do których inne oprogramowanie może się odwoływać, aby odczytywać lub zmieniać dane marketplace. Programiści nazywają te adresy punktami końcowymi. Każdy z nich zaczyna się od /wp-json/wcvendors/v1 i są one dostępne w darmowej wtyczce WC Vendors od wersji 2.7.3.

Wydanie składa się z trzech współpracujących ze sobą części.

Punkty końcowe REST dla sprzedawców, zamówień i prowizji

Endpointy obejmują rekordy, na których działa marketplace. Aplikacje mogą listować i odczytywać sprzedawców, aktualizować profil sklepu sprzedawcy i dane wypłat, a także zatwierdzać, odrzucać, aktywować lub dezaktywować sprzedawców. Mogą również odczytywać rekordy prowizji, odczytywać zamówienia sprzedawców, odczytywać i zmieniać stawki prowizji oraz pobierać podsumowanie sprzedaży dla dowolnego zakresu dat.

Webhooks dla zdarzeń marketplace

Webhooks działają w drugą stronę. Zamiast aplikacji pytającej Twoją witrynę o wiadomości, Twoja witryna informuje aplikację w momencie, gdy coś się stanie. WC Vendors dodaje 11 zdarzeń marketplace do webhooków WooCommerce, takich jak nowe zgłoszenie sprzedawcy, zatwierdzenie sprzedawcy, nowa prowizja i nowe zamówienie sprzedawcy.

Możliwości dla agentów AI

WC Vendors rejestruje również 10 możliwości marketplace w WordPress Abilities API. Możliwość to nazwana akcja z jasnym wejściem i wyjściem, którą narzędzia AI mogą znaleźć i uruchomić. Pięć możliwości tylko odczytuje dane, takie jak podsumowanie marketplace. Pozostałe pięć dokonuje zmian, takich jak zatwierdzanie sprzedawcy lub oczekującego produktu, więc dobrze zbudowane narzędzie AI prosi osobę o potwierdzenie najpierw.

To właśnie pozwala asystentowi połączonemu przez Model Context Protocol odpowiadać na pytania typu „Którzy sprzedawcy czekają na zatwierdzenie?” przy użyciu Twoich danych marketplace na żywo.

Dlaczego sklep wielodostawcowy potrzebuje własnego API

WooCommerce ma już REST API dla produktów, zamówień i klientów. Nie wie jednak, że istnieją sprzedawcy. Nie może powiedzieć aplikacji, który sprzedawca jest właścicielem zamówienia, ile prowizji jest należne, ani czy sprzedawca nadal czeka na zatwierdzenie.

API marketplace WooCommerce wypełnia tę lukę. Mówi językiem marketplace, więc aplikacja prosi o „prowizje należne sprzedawcy 42” zamiast składać odpowiedź z surowych danych zamówienia.

Jest również zbudowane dla sklepu z wieloma sprzedawcami. Poświadczenia sprzedawcy docierają tylko do rekordów tego sprzedawcy. Oznacza to, że możesz pozwolić sprzedawcom na podłączenie własnych narzędzi bez ujawniania zamówień, klientów lub zarobków kogokolwiek innego.

Kto może z niego korzystać i co każda osoba widzi

Każde żądanie loguje się za pomocą poświadczeń, a to, co wraca, zależy od tego, do kogo te poświadczenia należą.

• Właściciel sklepu: Każdy użytkownik, który może zarządzać WooCommerce, taki jak Administrator lub Kierownik Sklepu, widzi wszystkich sprzedawców, zamówienia, prowizje i raporty. Tylko właściciel sklepu może zatwierdzać, odrzucać, aktywować lub dezaktywować sprzedawców i zmieniać stawki prowizji.
• Aktywny sprzedawca: Widzi tylko swoje własne rekordy. Żądanie danych innego sprzedawcy zwraca błąd.
• Oczekujący lub nieaktywny sprzedawca: Nie ma dostępu, nawet z ważnymi poświadczeniami.
• Ktoś inny: Nie ma dostępu.

Prywatne dane pozostają prywatne

Pola bankowe i wypłat pojawiają się tylko wtedy, gdy aplikacja odczytuje lub aktualizuje pojedynczego sprzedawcę. Listy sprzedawców i wiadomości webhook nigdy ich nie zawierają, więc jedno żądanie nie może pobrać wszystkich danych bankowych sprzedawców naraz.

Szczegóły klienta w zamówieniach sprzedawców są zgodne z ustawieniami, których już używasz dla pulpitu sprzedawcy. Znajdziesz je w sekcji WC Vendors > Ustawienia > Uprawnienia > Zamówienia, zgodnie z wyjaśnieniami w naszym przewodniku po ustawieniach uprawnień. Jeśli ukryjesz tam adres e-mail lub numer telefonu klienta przed sprzedawcami, API również go ukryje, nawet gdy wywoła go właściciel sklepu.

Wbudowane limity żądań

Każdy użytkownik może wysłać 100 żądań na minutę do każdego punktu końcowego. Przekroczenie limitu zwraca błąd „zbyt wiele żądań” do końca minuty. Limity żądań są wyłączone na stronach ustawionych jako środowisko lokalne lub deweloperskie, więc nie zobaczysz ich na większości stron testowych.

Co możesz dzięki temu zbudować

Oto kilka pomysłów, które wykorzystują tylko to, co jest dostępne w WC Vendors 2.7.3.

• Raporty prowizji dla księgowego: Pobierz wszystkie prowizje ze statusem „należne” dla jednego sprzedawcy przed dniem wypłaty. Jeśli nadal konfigurujesz swoje stawki, nasz przewodnik po sposobach naliczania prowizji sprzedawcom omawia dostępne opcje.
• Natychmiastowe alerty o aplikacjach: Wyślij webhook „Złożono aplikację sprzedawcy” do swojego czatu zespołowego lub CRM. Twój zespół może przejrzeć kandydata i zatwierdzić go za pomocą API, korzystając z tego samego procesu zatwierdzania sprzedawcy co w panelu administratora.
• Integracje należące do sprzedawców: Sprzedawca tworzy własne dane uwierzytelniające i podłącza narzędzie do zarządzania zapasami lub aplikację do wysyłki. Ta aplikacja widzi zamówienia sprzedawcy i nikogo innego.
• Tygodniowe raporty marketplace: Poproś o podsumowanie sprzedaży z ostatniego tygodnia i uzyskaj całkowitą liczbę zamówień, przychody brutto, należne prowizje, zarobki marketplace i swoich 10 najlepszych sprzedawców w jednej odpowiedzi.
• Asystent AI dla administratora marketplace: Poproś asystenta o podsumowanie z zeszłego miesiąca lub listę produktów oczekujących na zatwierdzenie. Nasza siostrzana marka StoreAgent pokazuje, jak połączyć Claude i ChatGPT z Twoim sklepem.

Przed tym wydaniem każde z tych zadań wymagało niestandardowego wtyczki lub ręcznego eksportu. Dzięki WooCommerce Marketplace API są to zaledwie kilka żądań, które może skonfigurować każde narzędzie automatyzacji lub programista.

Jak skonfigurować WooCommerce Marketplace API

Nie ma ustawienia do włączenia. Gdy tylko WC Vendors 2.7.3 będzie aktywny, punkty końcowe będą działać, a każde żądanie będzie wymagało danych uwierzytelniających. Wykonaj poniższe kroki, aby podłączyć swoją pierwszą aplikację.

Krok 1: Zaktualizuj WC Vendors i sprawdź hasła aplikacji

1. Zaktualizuj WC Vendors do wersji 2.7.3 lub nowszej. Jeśli po tym WordPress wyświetli komunikat „Wymagana aktualizacja WC Vendors”, kliknij Uruchom aktualizację.
2. Przejdź do sekcji Użytkownicy > Profil w swoim panelu administracyjnym WordPress i przewiń do sekcji Hasła aplikacji.
3. Jeśli widzisz formularz do dodania nowego hasła, jesteś gotowy. Jeśli w sekcji jest informacja, że wymaga ona HTTPS, najpierw włącz HTTPS dla swojej witryny.
4. Jeśli sekcja jest brakująca, wtyczka zabezpieczeń lub Twój hosting wyłączył Hasła aplikacji. Możesz je włączyć z powrotem lub zamiast tego użyć klucza WooCommerce REST API.

Krok 2: Utwórz dane uwierzytelniające dla właściciela sklepu

API akceptuje dwa rodzaje danych uwierzytelniających, a oba logują się przez HTTPS.

• Hasło aplikacji: W sekcji Użytkownicy > Profil > Hasła aplikacji, wprowadź nazwę aplikacji, utwórz hasło i natychmiast je skopiuj. WordPress wyświetla je tylko raz. Oficjalny przewodnik po hasłach aplikacji wyjaśnia, jak działają.
• Klucz WooCommerce REST API: Przejdź do WooCommerce > Ustawienia > Zaawansowane > REST API i dodaj klucz dla swojego użytkownika. Klucz Odczyt może tylko odczytywać dane. Wybierz Odczyt/Zapis, jeśli aplikacja musi coś zmienić.

Jeśli planujesz korzystać z funkcji AI, utwórz Hasło aplikacji. Klucze WooCommerce REST API nie działają dla tych funkcji.

Krok 3: Pozwól sprzedawcom tworzyć własne dane uwierzytelniające

Sprzedawcy nie potrzebują, abyś tworzył dla nich dane uwierzytelniające. Mogą to zrobić ze swojego własnego panelu.

1. Sprzedawca otwiera swój panel sprzedawcy i przechodzi do Ustawień, a następnie do zakładki API.
2. Klikają Wygeneruj dane uwierzytelniające API.
3. Nowe dane uwierzytelniające pojawiają się raz z przyciskiem Kopiuj i ostrzeżeniem „Zapisz to teraz. Ze względów bezpieczeństwa nie zostanie ono ponownie wyświetlone”.
4. Następnie zakładka wyświetla nazwę danych uwierzytelniających, datę ich utworzenia, datę ostatniego użycia oraz przycisk Generuj ponownie.

Każdy sprzedawca może posiadać jedno dane uwierzytelniające na raz. Ponowne generowanie wymaga potwierdzenia, a następnie natychmiast wyłącza stare, więc każda aplikacja z niego korzystająca musi zostać zaktualizowana. Zakładka API pojawia się tylko wtedy, gdy Hasła aplikacji są dostępne na Twojej stronie.

Krok 4: Wykonaj swoje pierwsze zapytanie

Zaloguj się przy użyciu nazwy użytkownika WordPress i Hasła aplikacji. To zapytanie wyświetla listę pierwszych pięciu sprzedawców:

curl -u "USERNAME:APPLICATION_PASSWORD" \
  "https://your-site.com/wp-json/wcvendors/v1/vendors?per_page=5"

Odpowiedź to lista sprzedawców w formacie JSON. Dwa nagłówki odpowiedzi, X-WP-Total i X-WP-TotalPages, informują o liczbie rekordów i stron, a Ty możesz żądać do 100 rekordów na stronę.

Oto zapytanie, które aplikacja sprzedawcy może wykonać, aby zobaczyć prowizje, które nie zostały jeszcze wypłacone:

curl -u "VENDOR_USERNAME:APPLICATION_PASSWORD" \
  "https://your-site.com/wp-json/wcvendors/v1/commissions?status=due"

Krok 5: Dodaj webhook marketplace

1. Przejdź do WooCommerce > Ustawienia > Zaawansowane > Webhooki i kliknij Dodaj webhook.
2. Wprowadź nazwę i adres URL dostarczenia, pod którym Twoja aplikacja powinna odbierać wiadomość.
3. Otwórz listę rozwijaną Temat i wybierz temat marketplace, na przykład Sprzedawca zatwierdzony lub Prowizja utworzona.
4. Ustaw Status na Aktywny i zapisz.

WooCommerce obsługuje dostawę, podpisywanie i logi dostaw. Jego dokumentacja webhooków wyjaśnia, jak sprawdzić, czy wiadomość rzeczywiście pochodzi z Twojego sklepu.

Krok 6: Połącz agenta AI z umiejętnościami

Umiejętności wymagają WordPressa 6.9 lub nowszego oraz Hasła Aplikacji właściciela sklepu. Aby zobaczyć, co jest dostępne, poproś o listę umiejętności w kategorii wcvendors:

curl -u "OWNER_USERNAME:APPLICATION_PASSWORD" \
  "https://your-site.com/wp-json/wp-abilities/v1/abilities?category=wcvendors"

Większość ludzi nie będzie tego wywoływać ręcznie. Narzędzie AI zgodne z MCP odczytuje tę samą listę i decyduje, którą umiejętność uruchomić. Aby zapoznać się z przykładem od naszych siostrzanych marek, zobacz, jak Advanced Coupons pozwala zarządzać kuponami za pomocą WordPress Abilities API, lub jak Wholesale Suite uruchamia zadania hurtowe z Claude lub ChatGPT.

Chcesz połączyć asystenta AI? Nasz przewodnik krok po kroku, Jak używać umiejętności AI w WC Vendors, pokazuje, jak połączyć Claude lub ChatGPT z Twoim marketplace za pośrednictwem StoreAgent. Wyjaśnia również, co potrafi każda z 10 umiejętności, kto może je uruchomić i jak rozwiązać typowe problemy z konfiguracją.

Każdy punkt końcowy, webhook i umiejętność w skrócie

Punkty końcowe

Wszystkie trasy zaczynają się od /wp-json/wcvendors/v1.

Metoda	Trasa	Co robi	Kto może jej używać
GET	/vendors	Lista sprzedawców	Właściciel sklepu, sprzedawca (własny rekord)
GET, PUT	/vendors/{id}	Odczytaj lub zaktualizuj profil sklepu sprzedawcy i szczegóły wypłat	Właściciel sklepu, sprzedawca (własny rekord)
POST	/vendors/{id}/approve, /deny	Zdecyduj o oczekującej aplikacji	Właściciel sklepu
POST	/vendors/{id}/activate, /deactivate	Zawieszenie lub przywrócenie sprzedawcy	Właściciel sklepu
GET, PUT	/vendors/{id}/commission	Odczytaj lub ustaw własną stawkę prowizji sprzedawcy	Właściciel sklepu (sprzedawcy mogą odczytywać własne)
GET, PUT	/ustawienia/prowizja	Odczytaj lub zmień globalną stawkę prowizji	Właściciel sklepu
GET	/prowizje, /prowizje/{id}	Odczytaj zapisy prowizji	Właściciel sklepu, sprzedawca (własne zapisy)
GET	/zamowienia, /zamowienia/{id}	Odczytaj zamówienia sprzedawcy	Właściciel sklepu, sprzedawca (własne zamówienia)
GET	/raporty/sprzedaz	Podsumowanie sprzedaży dla zakresu dat	Właściciel sklepu, sprzedawca (własna sprzedaż)

Tematy webhooków

• Sprzedawcy: Złożono wniosek o sprzedawcę, Sprzedawca zatwierdzony, Sprzedawca odrzucony, Sprzedawca aktywowany, Sprzedawca zdezaktywowany, Sprzedawca zaktualizowany i Sprzedawca usunięty.
• Prowizje: Prowizja utworzona.
• Zamówienia sprzedawcy: Zamówienie sprzedawcy utworzone, Zamówienie sprzedawcy zaktualizowane i Zamówienie sprzedawcy usunięte.

Uprawnienia

• Odczyt: wyświetl sprzedawców, pobierz sprzedawcę, wyświetl oczekujące produkty, pobierz ustawienia prowizji i pobierz podsumowanie rynku.
• Zapis: zatwierdź sprzedawcę, odrzuć sprzedawcę, zaktualizuj profil sklepu sprzedawcy, zatwierdź produkt i odrzuć produkt.

Żadne uprawnienie nie przesuwa pieniędzy, nie zmienia stawki prowizji, nie zmienia miejsca, gdzie sprzedawca otrzymuje płatność, ani nie usuwa zapisu. Uprawnienia zapisu wysyłają te same e-maile co odpowiadające im przyciski w panelu administracyjnym WordPress, a odrzucony produkt wraca do sprzedawcy jako szkic z dołączonym Twoim powodem.

Najlepsze praktyki dotyczące bezpiecznej integracji rynku

Traktuj API rynku WooCommerce jak każde inne drzwi do Twojego sklepu. Te nawyki zapewniają jego bezpieczeństwo i niezawodność.

• Nadaj każdej aplikacji minimalny potrzebny dostęp. Jeśli aplikacja tylko odczytuje raporty, nadaj jej klucz odczytu zamiast klucza odczytu/zapisu.
• Zaplanuj zmiany poświadczeń sprzedawcy. Sprzedawca posiada jedno poświadczenie, a jego regeneracja odcina każdą aplikację, która używała starego.
• Sprawdź ustawienia klienta przed podłączeniem narzędzia do wysyłki lub księgowości. Jeśli dane klienta wrócą puste, przejrzyj Uprawnienia > Zamówienia i kliknij Zapisz.
• Zachowaj własną kopię wszystkiego, czego możesz potrzebować później. Webhooki „Sprzedawca usunięty” i „Zamówienie sprzedawcy usunięte” wysyłają tylko identyfikator, ponieważ zapis już nie istnieje.
• Monitoruj stan webhooków. WooCommerce nie wysyła ponownie nieudanej dostawy i wyłącza webhook po ponad pięciu nieudanych dostawach.
• Wiedz, które typy prowizji wymagają Pro. Bez WC Vendors Pro API akceptuje tylko prowizję procentową. Nowe stawki dotyczą nowych prowizji, a istniejące zapisy nie ulegają zmianie.
• Wyłącz to, czego nie używasz. Dodanie define( 'WCV_DISABLE_ABILITIES', true ); do wp-config.php usuwa uprawnienia, a define( 'WCV_DISABLE_REST_API', true ); usuwa całe API.

Aby uzyskać szerszą listę kontrolną, przeczytaj nasz przewodnik po bezpieczeństwie marketplace WooCommerce.

Podsumowanie

WC Vendors 2.7.3 daje Twojemu sklepowi coś, czego nigdy wcześniej nie miał: publiczny, udokumentowany sposób na współpracę innych programów ze sprzedawcami, zamówieniami i prowizjami. Interfejs API marketplace WooCommerce przejmuje codzienne zadania, które wcześniej wymagały eksportu i kopiowania oraz wklejania, od uzgadniania prowizji po zatwierdzanie nowych sprzedawców.

Został zbudowany z myślą o ryzyku związanym ze sklepem wielodostawcowym. Sprzedawcy widzą tylko swoje dane, szczegóły wypłat pozostają poza listami i webhookami, a informacje o klientach podlegają tym samym zasadom co panel sprzedawcy. Webhooki aktualizują Twoje inne narzędzia bez konieczności odpytywania, a zdolności pozwalają asystentowi AI obsługiwać rutynowe zadania administracyjne, podczas gdy Ty zachowujesz kontrolę nad każdą zmianą.

Zacznij od małych kroków. Utwórz jeden poświadczenie, podłącz jeden webhook i zobacz, ile pracy ręcznej zniknie. Następnie rozbudowuj w miarę rozwoju Twojego marketplace.

Oto, co omówiliśmy w tym artykule:

• Co to jest interfejs API marketplace WooCommerce
• Dlaczego sklep wielodostawcowy potrzebuje własnego interfejsu API
• Kto może go używać i co każdy użytkownik może zobaczyć
• Co można dzięki niemu zbudować
• Jak skonfigurować interfejs API marketplace WooCommerce
• Każdy punkt końcowy, webhook i zdolność w skrócie
• Najlepsze praktyki dotyczące bezpiecznej integracji marketplace

Często zadawane pytania