Dane celne WooCommerce: kod HS, pochodzenie i opis produktu
Dokumentacja deweloperska opisuje pola HS, pochodzenia i opisu celnego w WooCommerce. Sprawdź, jaki zakres wersji potwierdzają źródła i czego pola nie załatwią.

Dokumentacja deweloperska WooCommerce opisuje trzy pola celne produktu: kod HS, kraj pochodzenia i krótki opis. Potwierdzenie dotyczy dokumentacji i kodu rozwojowego, a dostępność tych pól w stabilnym wydaniu nie jest tu potwierdzona. Rejestr wydań wymienia 11.2.1 jako wersję stabilną, podczas gdy plik wtyczki w gałęzi trunk podaje 11.4.0-dev (dokumentacja pól celnych, rejestr wydań, plik wtyczki w trunk). Same pola nie ustalają należności celnych ani nie tworzą etykiet. Warto je uzupełnić przed sezonem zakupowym, ale osobno sprawdzić klasyfikację towarów, wartość przesyłki i sposób przygotowania dokumentów.
W skrócie
- Kod HS klasyfikuje towar. WooCommerce przyjmuje kod złożony z 6 do 14 cyfr, również z dodatkowymi cyframi stosowanymi w danym kraju.
- Kraj pochodzenia oznacza miejsce, w którym towar został wyprodukowany lub uzyskał pochodzenie według właściwych reguł. Nie musi to być kraj magazynu ani nadania paczki.
- Opis celny to krótki tekst o towarze, ograniczony w WooCommerce do 35 znaków.
- Pola nie wyliczają cła i nie generują etykiet. Nie zastępują też ustalenia wartości celnej ani wymaganych dokumentów.
Jakie dane celne WooCommerce można dodać do produktu?
Oficjalna dokumentacja WooCommerce opisuje trzy opcjonalne pola celne. W klasycznym edytorze produktu znajdują się w Product data → Shipping → Customs. Wskazanie tej ścieżki odnosi się do interfejsu opisanego w dokumentacji deweloperskiej, a nie do potwierdzonej dostępności w stabilnej wersji. Ich dostępność zależy od typu produktu i widocznej karty wysyłki.
| Pole | Co wpisujesz | Na co uważać |
|---|---|---|
| Commodity code (HS code) | Kod HS, od 6 do 14 cyfr | Zachowaj zera na początku. WooCommerce usuwa spacje i znaki interpunkcyjne podczas zapisu. |
| Country of origin | Dwuliterowy kod kraju, np. BR | Wpisz kraj pochodzenia towaru, nie automatycznie kraj wysyłki. |
| Customs description | Krótki opis produktu | Limit wynosi 35 znaków. Wpisz rzeczową nazwę towaru, a nie tekst reklamowy. |
Opis może zawierać litery, cyfry, spacje i typową interpunkcję. Dokumentacja podaje przykład kodu 0901.21.0010, który po zapisaniu przyjmuje postać 0901210010. Format z kropkami może być czytelniejszy dla osoby edytującej, ale zera wiodące trzeba zachować.
Kod HS: klasyfikacja produktu
HS to skrót od Harmonized System, czyli zharmonizowanego systemu klasyfikacji towarów. WooCommerce przechowuje kod, ale go nie dobiera. Kod musi odpowiadać konkretnemu produktowi i wymaganiom kraju, do którego wysyłasz paczkę. W niektórych przypadkach sześć cyfr HS nie wystarczy, bo kraj lub obszar celny stosuje dłuższą, bardziej szczegółową podpozycję.
W UE towary zgłaszane do odprawy klasyfikuje się według Nomenklatury scalonej lub nomenklatury opartej na niej. Klasyfikacja wpływa na stawkę cła albo stosowane środki pozataryfowe, jak wyjaśnia system klasyfikacji celnej Komisji Europejskiej. Dlatego nie kopiuj kodu z podobnego produktu bez sprawdzenia jego materiału, funkcji i przeznaczenia.
Kraj pochodzenia produktu
Kraj pochodzenia opisuje celne „obywatelstwo ekonomiczne” produktu, czyli kraj, w którym uznaje się go za wyprodukowany lub wytworzony. Nie jest to z definicji adres sklepu, kraj dostawcy ani miejsce, z którego kurier odbiera przesyłkę. Gdy produkcja obejmuje kilka państw, samo pole w WooCommerce nie rozstrzyga, który kraj należy wskazać. Unijne objaśnienie reguł pochodzenia rozróżnia pochodzenie niepreferencyjne i preferencyjne oraz wskazuje, że pochodzenie, klasyfikacja taryfowa i wartość celna wpływają na traktowanie taryfowe.
Przykład: jeżeli produkt jest przechowywany w Polsce, ale jego pochodzenie celne ustalono jako inne państwo, kraj magazynu sam w sobie nie uzasadnia wpisania Polski jako kraju pochodzenia. Przy produktach składanych lub przetwarzanych w kilku miejscach sprawdź reguły właściwe dla danej trasy i towaru.
Opis celny
Opis celny powinien pomóc rozpoznać zawartość paczki. Przy limicie 35 znaków wybierz zwięzłe, konkretne określenie, np. „bawełniana koszulka” zamiast „świetny wybór na każdą okazję”. Nie zakładaj, że opis marketingowy produktu będzie wystarczający do dokumentacji celnej.
Opis, kod HS i pochodzenie to wartości zapisane przy produkcie. Przy tworzeniu przesyłki mogą być potrzebne też inne dane. Przykładowo dokumentacja WooCommerce Shipping wymienia w sekcji Customs opis, numer HS, wartość i wagę jednostkową oraz kraj pochodzenia; usługa jest dostępna dla sklepów z siedzibą w USA, w tym na terytoriach USA, rozliczających się w dolarach amerykańskich. To osobne informacje używane w procesie przygotowania wysyłki.
Czego te pola nie załatwią?
Trzy pola w katalogu porządkują informacje o towarze, lecz nie stanowią kompletnej odprawy. WooCommerce wprost zaznacza, że dane celne produktu nie obliczają należności i nie wytwarzają etykiet. Wartość celna jest odrębnym elementem: według Komisji Europejskiej wpływa na traktowanie taryfowe razem z klasyfikacją i pochodzeniem.
| Potrzeba | Czy załatwi ją samo pole produktu? | Co trzeba zrobić osobno |
|---|---|---|
| Klasyfikacja i zapis kodu HS | Nie ustala poprawnego kodu, pozwala go przechować | Zweryfikować kod dla konkretnego produktu i rynku docelowego |
| Kraj pochodzenia | Przechowuje wskazaną wartość | Ustalić pochodzenie według reguł celnych, szczególnie przy produkcji w kilku krajach |
| Opis towaru | Przechowuje krótki opis | Sprawdzić, czy opis spełnia wymagania przewoźnika i kraju przeznaczenia |
| Wartość celna, cło i podatki | Nie wylicza ich | Ustalić wartość i należności dla danej przesyłki oraz trasy |
| Etykieta i dokumenty przesyłki | Nie tworzy ich na podstawie samych pól | Skorzystać z odpowiedniego procesu przewoźnika lub narzędzia wysyłkowego i uzupełnić wymagane dane |
Szczegóły zależą od kierunku wysyłki i narzędzi, z których korzysta sklep. Przykładowo WooCommerce Shipping ma osobny ekran przygotowania etykiety, w którym uzupełnia się informacje celne i dane produktu. Sam fakt, że w katalogu istnieje kod HS, nie oznacza zatem, że wszystkie pozostałe elementy przesyłki są gotowe.
Jak uzupełnić pola przed sprzedażą za granicę
- Podziel produkty na grupy, które mają różne cechy celne. Warianty o innym materiale, przeznaczeniu lub kraju pochodzenia mogą wymagać osobnego sprawdzenia.
- Zweryfikuj kod HS dla danego towaru i rynku. W razie potrzeby sprawdź dłuższą podpozycję krajową. Nie wpisuj kodu wyłącznie dlatego, że pasuje do nazwy podobnego produktu.
- Ustal kraj pochodzenia. Oprzyj go na informacjach o produkcji i właściwych regułach. Adres magazynu potraktuj jako informację o wysyłce, a nie automatyczny zamiennik pochodzenia.
- Napisz krótki, konkretny opis celny. Sprawdź limit 35 znaków i usuń promocyjne sformułowania.
- Uzupełnij produkt w edytorze. Dokumentacja deweloperska opisuje ścieżkę w klasycznym edytorze
Product data → Shipping → Customs, ale nie potwierdza jej dostępności w stabilnym wydaniu. Na dzień weryfikacji, 25 października 2026 r., rejestr wydań wskazuje WooCommerce 11.2.1 jako wersję stabilną. Plik wtyczki w gałęzitrunkpodaje wersję 11.4.0-dev i minimum WordPress 7.0, co opisuje tę gałąź rozwojową, a nie wymagania konkretnego wydania stabilnego (dokumentacja pól celnych, plik wtyczki w gałęzi trunk, rejestr wydań). - Sprawdź warianty i import CSV. Wartości wariantu mogą dziedziczyć dane produktu nadrzędnego albo je nadpisywać. Przy imporcie CSV pamiętaj, że pusta komórka w mapowanej kolumnie czyści wartość, a pominięcie kolumny pozostawia dane bez zmian. Ustaw kolumnę z kodem jako tekst, by arkusz nie usunął zer na początku.
- Przed nadaniem sprawdź dane przesyłki. Potwierdź wartość, wagę, wymagany opis oraz dokumenty dla konkretnego przewoźnika i kraju docelowego.
FAQ
Czy WooCommerce automatycznie dobiera kod HS?
Nie. Pole przechowuje kod podany przez właściciela sklepu. Kod trzeba wcześniej ustalić dla produktu i właściwego rynku.
Czy kraj pochodzenia to kraj, z którego wysyłam paczkę?
Nie musi nim być. Pochodzenie celne dotyczy miejsca, w którym towar został wyprodukowany lub uzyskał pochodzenie według właściwych reguł. Kraj nadania i kraj pochodzenia mogą się różnić.
Ile znaków może mieć opis celny w WooCommerce?
Limit pola wynosi 35 znaków. Z tego powodu najlepiej wpisać zwięzłą nazwę opisującą sam towar.
Czy uzupełnienie danych celnych wygeneruje etykietę?
Nie. Dokumentacja WooCommerce zaznacza, że pola celne produktu nie tworzą etykiet. Etykieta wymaga osobnego procesu wysyłkowego i danych konkretnej przesyłki.
Czy pusta komórka w CSV zostawi dotychczasowy kod HS?
Jeśli kolumna celna jest zmapowana, pusta komórka czyści wartość. Aby pozostawić dotychczasowe dane, pomiń daną kolumnę w pliku. Przed edycją ustaw komórki kodów jako tekst, aby arkusz nie obciął zer wiodących.
Co dalej
Jeśli chcesz uzupełniać dane w większej liczbie produktów, zobacz jak eksportować i aktualizować pola własne produktów przez CSV w WooCommerce.
