Vetted dla deweloperów

• Dotyczy wersji 0.2.2
• Zaktualizowano 1.10.2026
• 8 min czytania

REST API

Vetted dokłada pola do odpowiedzi WooCommerce REST API dla produktów (/wp-json/wc/v3/products) i wariantów (/wp-json/wc/v3/products/<id>/variations). Te same pola przyjmuje przy zapisie.

Wszystkie wartości wracają jako tekst. Kwoty i daty przy zapisie przechodzą przez wc_format_decimal(), więc daty podawaj z myślnikami, nie z kropkami.

curl -X PUT https://sklep.example/wp-json/wc/v3/products/123 \
  -u ck_klucz:cs_sekret \
  -H 'Content-Type: application/json' \
  -d '{"vetted_wholesale_price":"104.88","vetted_hide_price":"no"}'

Parametr vetted_missing_wholesale=1 na liście produktów zwraca tylko produkty bez ceny hurtowej. Przydaje się do raportu braków przed uruchomieniem hurtu.

curl 'https://sklep.example/wp-json/wc/v3/products?vetted_missing_wholesale=1&per_page=100' \
  -u ck_klucz:cs_sekret

Import i eksport CSV

Vetted dodaje pięć kolumn do importu i eksportu produktów WooCommerce. Działają też dla wariantów. Importer rozpoznaje je po nagłówku albo po identyfikatorze, więc mapowanie nie wymaga klikania. Na ekranie mapowania są w grupie „Vetted: hurt”.

Jeśli w pliku nie ma danej kolumny, wartość w produkcie zostaje bez zmian. W kolumnie ukryj_cene każda wartość inna niż yes albo no zapisze się jako pusta, czyli „Dziedzicz z kategorii”.

W WooCommerceUstawieniaVetted, w sekcji „Wymiana danych”, jest odnośnik „Pobierz szablon CSV”. Plik szablon-produktow.csv ma polskie nagłówki importera WooCommerce, kolumny Vetted i jeden wiersz przykładowy oznaczony do skasowania. Zapisuję go z BOM, żeby Excel poprawnie czytał polskie znaki.

Akcje i filtry

Akcje

E-maile Vetted są podpięte pod cztery pierwsze akcje, więc wychodzą także wtedy, gdy decyzja zapada w kodzie albo w WP-CLI. Na vetted_application_queued wychodzi do klienta e-mail „Vetted: wniosek przyjęty” (identyfikator vetted_application_received, klasa Vetted\Emails\Received, klucz Vetted_Application_Received w WC()->mailer()->get_emails()).

add_action( 'vetted_application_approved', function ( int $user_id ) {
	$nip = get_user_meta( $user_id, '_vetted_nip', true );
	// Przekaż nowego partnera do CRM.
} );

Filtry

Wniosek bez NIP-u, bez odpowiedzi rejestru i firmy z zakończoną działalnością zawsze trafia do kolejki, bez pytania filtra. Zachowanie sprzed 0.2.2, w którym każda firma z aktywnym wpisem w REGON dostaje konto od razu, niezależnie od ustawienia i kodów PKD, przywrócisz tak:

add_filter( 'vetted_autoapprove_on_regon', '__return_true' );

A tak sprawisz, że każdy wniosek czeka na człowieka, nawet gdy ktoś włączy „Automatyczną akceptację”:

add_filter( 'vetted_autoapprove_on_regon', '__return_false' );

Kroki nad formularzem są stałym tekstem w kodzie i obiecują weryfikację „w ciągu 1 dnia roboczego”. Mają dwa warianty, zależnie od ustawienia „Automatyczna akceptacja”, a drugi krok w obu mówi o czasie weryfikacji. Jeśli Twój czas jest inny, zmień je filtrem, a treść e-maila „Vetted: wniosek przyjęty” w jego ustawieniach:

add_filter( 'vetted_wniosek_kroki', function ( array $kroki ) {
	$kroki[1] = 'Sprawdzimy wniosek w ciągu 2 dni roboczych.';
	return $kroki;
} );

Plik produktowy dla porównywarki nie może zawierać cen hurtowych, nawet gdy otworzy go zalogowany partner:

add_filter( 'vetted_may_swap_prices', function ( bool $wolno ) {
	return is_feed() ? false : $wolno;
} );

Funkcje PHP

Te metody są publiczne i statyczne. Przydają się w motywie i w integracjach.

wp eval 'echo \Vetted\Pricing\SortPrice::rebuild();'
wp eval '\Vetted\Decisions::approve( 123 );' --user=admin

Przy decyzji z WP-CLI podaj --user. Bez tego w dzienniku zamiast loginu zapisze się 0.

Gdzie Vetted trzyma dane

Ustawienia leżą w opcjach z przedrostkiem vetted_, a dziennik decyzji w opcji vetted_decision_log. Role to b2b_pending i b2b_customer. W _vetted_decided_by wartość -1 oznacza decyzję automatu.

SKU i integracje ERP

Większość złączy ERP, w tym Subiekt, paruje towary po symbolu. Na liście produktów i w ustawieniach WooCommerce Vetted pokazuje ostrzeżenie, gdy któryś produkt nie ma SKU. Licznik sprawdza do 50 produktów opublikowanych, prywatnych i szkiców. Zapisu nie blokuje.

• Cenę hurtową czytaj i zapisuj przez pola vetted_*, nie przez price.
• Kwoty w polach Vetted są zawsze netto. Na brutto przelicza je sklep, według ustawień podatku i klasy podatkowej produktu.
• Kanał zamówienia odczytasz z metadanej _vetted_channel albo przez OrderChannel::of().
• Zapis przez REST albo CSV aktualizuje pole sortujące, tak jak zapis w panelu.

Szablony

Szablony ładuje wc_get_template(), więc nadpisujesz je w katalogu woocommerce/ motywu.

Shortcode’y to [vetted_rejestracja] i [vetted_materialy]. Podpowiadanie danych z GUS korzysta z akcji AJAX vetted_gus_lookup, chronionej tokenem formularza. Vetted nie dołącza arkuszy stylów. Najważniejsze klasy to b2b-reg, vetted-form, vetted-field, vetted-hidden-price, vetted-materials i vetted-konto.

Jeśli motyw ma pasek postępu do darmowej dostawy oparty na filtrach alpha_prog_dostawy i alpha_prog_suma, Vetted podaje w nich próg i kwotę koszyka brutto dla klienta hurtowego.

Stałe w wp-config.php

• VETTED_GUS_KEY: klucz API rejestru REGON. Ma pierwszeństwo przed polem w ustawieniach.
• VETTED_PRIVATE_DIR: ścieżka chronionego magazynu plików. Katalog nadrzędny musi istnieć i mieć prawo zapisu.

Odinstalowanie

Usunięcie wtyczki domyślnie nie kasuje żadnych danych. Statusy, dane firm i ceny hurtowe zostają w bazie. Jeśli opcja vetted_delete_data_on_uninstall ma wartość yes, przy usuwaniu wtyczki znikną dwie role Vetted. Metadane zostają także wtedy.

wp option update vetted_delete_data_on_uninstall yes

Ostatnia zmiana: 1.10.2026, wersja 0.2.2Zgłoś błąd w tej stronie