Przewoźnicy

Stockly → Operations → Shipping → Carriers pokazuje każdego przewoźnika, jakiego zna instalacja, z dwóch źródeł dzielących jeden rejestr:

• Module — zgłosił go moduł wysyłkowy. Zachowanie, czasem automatyczne zamawianie przesyłek; tutaj tylko do odczytu, ponieważ zmienia się go w tamtym module.
• Own entry — wiersz założony na tej stronie: taryfa przewoźnika (limity, usługi, progi wagowe) bez modułu za plecami. To postać stosowana dla każdego przewoźnika, którym sklep wysyła, ale nie ma z nim integracji, czyli dla większości.

Kolumny: Carrier, Source, Default max weight, Max parcels, Requires, Books shipments, Rules using it.

Pokazane limity to wartości domyślne przewoźnika. Reguła pakowania może nadpisać każdy z nich.

Dodawanie i edycja własnego przewoźnika

Add carrier pyta najpierw o dane ogólne. Tak jak w formularzu produktu, części zależne od zapisanego wiersza odblokowują się po pierwszym zapisie, jako zakładki na stronie przewoźnika. Na liście nazwa własnego wpisu otwiera stronę przewoźnika.

Strona otwiera się w trybie podglądu, wyświetlając wartości, a nie formularz. Edit w nagłówku przełącza bieżącą zakładkę w edycję; Save zapisuje całego przewoźnika, Cancel odrzuca szkic. Tytuły zakładek niosą liczniki wierszy, np. Services (3).

General — tożsamość i limity:

• Technical name — klucz, który zapisują reguły pakowania (małe litery, cyfry, -, _). Po pierwszym zapisie zablokowany: zmiana nazwy po cichu osierociłaby każdą wskazującą go regułę.
• Limity — maksymalna waga paczki, liczba paczek na przesyłkę, długość i obwód. Puste = brak limitu.
• Volumetric divisor — cm³/kg dla wagi objętościowej; 5000 dla większości europejskich sieci paczkowych. Puste = ten przewoźnik nie liczy po objętości.

Services — produkty przewoźnika (np. paket, kleinpaket, sperrgut), oferowane pakującemu per paczka na ekranie pakowania. Pierwszy jest wstępnie wybrany; strzałki ustawiają kolejność.

Weight brackets — progi cenowe przewoźnika jako przedziały: każdy wiersz mówi „do X kg”, ostatni jest otwarty (∞). Przedział przypisany do usługi dotyczy tylko tej usługi. Ceny są opcjonalne: przedział bez ceny nadal opisuje, gdzie taryfa skacze, i to wystarcza do podpowiedzi. Planer paczek ostrzega, gdy pudło siedzi tuż nad progiem („Parcel 2: 20.4 kg — 0.4 kg above the 20 kg price break”) oraz gdy jedno pudło więcej zmieściłoby wszystkie paczki pod progiem. Podpowiedź jest wyłącznie tekstowa; sam podział nigdy się nie zmienia, ponieważ bez cen podział przedstawiony jako lepszy byłby zgadywaniem. Reguła pakowania z niższą maksymalną wagą wycina z podpowiedzi progi powyżej niej.

Surcharges — to, co przewoźnik dolicza do ceny bazowej. Jedna dopłata to jedna nazwa techniczna; wiersze o tej samej nazwie są jej progami, a każdy podaje górną granicę na jednej osi, wagi paczki albo wartości zamówienia, wraz z kwotą obowiązującą w tym przedziale. Obie granice puste = dopłata bezwarunkowa. Per wiersz:

• Type — kwota stała, procent ceny bazowej albo procent wartości zamówienia.
• Charged — raz na paczkę (paliwowa, energetyczna) albo raz na zamówienie (pobranie, ubezpieczenie).
• Condition — zawsze albo tylko przy pobraniu.

Realne cenniki mają dokładnie tę strukturę. Opłata paliwowa zależna od wagi to trzy wiersze fuel: 33.9 % do 20 kg, 39.7 % do 31.5 kg, 42.2 % otwarty. Ubezpieczenie progowane od wartości zamówienia to wiersze insurance z granicami wartości. Gdy procent paliwowej zmieni się za miesiąc, zmienia się jedną liczbę, a nie całą macierz cen.

Przykład, DHL Paket dla sklepu niemieckiego: maks. waga 31.5, długość 120, obwód 360, dzielnik 5000, usługi paket / kleinpaket / sperrgut, przedziały do 10, do 20, otwarty.

Szacunek kosztu wysyłki

Gdy progi wagowe mają ceny, panel paczek pokazuje, ile kosztowałby bieżący szkic: kwotę przy każdej paczce i sumę netto w pasku podsumowania, przeliczaną na bieżąco przy wpisywaniu wag i przenoszeniu pozycji. Po najechaniu na sumę widać rozbicie: cena bazowa plus każda dopłata z nazwy.

Szacunek to wyłącznie zastosowana taryfa sklepu: kwoty netto w walucie, w jakiej je wpisano, bez VAT, bez przeliczeń. Tam, gdzie taryfa nie zna odpowiedzi, panel wyświetla tariff incomplete, zamiast szacować: paczka cięższa niż każdy wyceniony przedział albo dopłata od wartości przy zamówieniu bez wyceny. Ceny pozostają opcjonalne: przewoźnik bez nich nie pokazuje szacunku, a wszystko inne działa jak dotąd.

Systemy zewnętrzne zadają to samo pytanie przez API: POST /api/_action/p2lab-stockly/shipping/rates/quote z orderId i szkicem parcels (weightKg, service) zwraca wycenione rozbicie.

Gdy moduł i wiersz dzielą nazwę

Wygrywa moduł, celowo. To jest ścieżka rozwoju: najpierw powstaje wiersz dhl, rok później zostaje zainstalowany moduł DHL, a każda reguła pakowania działa dalej, ponieważ od tej chwili na nazwę odpowiada moduł. Formularz edycji ostrzega, gdy wiersz jest przykryty.

Dwie kolumny, które decydują, ile pracy wymaga zamówienie

Requires — czego przewoźnik musi się dowiedzieć:

• weight per parcel — zamiast równego szacunku otwiera się ekran przypisywania pozycji. Szacunek zwykle przechodzi, ale tam, gdzie obowiązują dopłaty za nadwagę, kosztuje realne pieniądze.
• contents declaration
• nothing beyond a parcel count

Books shipments — czy moduł można poprosić o przesyłki automatycznie. Tam, gdzie stoi No, paczka i tak istnieje i się drukuje; kod śledzenia przychodzi ręcznie albo z systemu zewnętrznego. Własny wiersz zawsze mówi No, ponieważ jest taryfą, a nie integracją.

Skasowany wiersz, odinstalowany moduł

Reguła wskazująca przewoźnika, którego już nie ma, czy to skasowany wiersz, czy odinstalowany moduł, działa dalej. Spada na przewoźnika zastępczego: bez limitów, bez zastrzeżeń. Odinstalowanie gdzie indziej nie może zepsuć wysyłki tutaj; okno kasowania podaje przed potwierdzeniem, ilu reguł to dotknie. Wiersz nieaktywny zachowuje się jak skasowany, dopóki nie zostanie włączony z powrotem.